@sanity/workbench-cli 1.8.0 → 1.10.0

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

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/actions/dev/registry.ts"],"sourcesContent":["import {\n  existsSync,\n  mkdirSync,\n  readdirSync,\n  readFileSync,\n  unlinkSync,\n  watch,\n  writeFileSync,\n} from 'node:fs'\nimport {join} from 'node:path'\n\nimport {\n  coreAppManifestSchema,\n  getSanityDataDir,\n  studioManifestSchema,\n  subdebug,\n} from '@sanity/cli-core'\nimport {z} from 'zod/mini'\n\nimport {AppInterfaceMetadataSchema} from '../../contract.js'\nimport {canonicalizeWatchDir} from './canonicalizeWatchDir.js'\nimport {getProcessStartTime, isOurProcess} from './processLiveness.js'\n\n/**\n * The dev-server registry: how a running `sanity dev` / `sanity start` process\n * advertises itself so the workbench on this machine can find and load it.\n *\n * Two kinds of file under `~/.sanity/dev-servers/` do the coordinating:\n *\n *   - `<pid>.json` — one per running app/studio server, holding where it's served\n *     plus its inlined manifest and interfaces. The workbench reads these to\n *     discover and render local apps. Written by `registerDevServer`, watched by\n *     `watchRegistry`.\n *   - `workbench.lock` — a single machine-wide lock, so only one workbench shell\n *     runs at a time and later `dev`s register into it instead of starting their\n *     own. Managed by `acquireWorkbenchLock` / `readWorkbenchLock`.\n *\n * Both files belong to the process that created them and must not outlive it.\n * Three things keep that true: an explicit `release()` on clean shutdown, an\n * `exit` backstop for abrupt exits (`unlinkOnProcessExit`), and a dead-pid prune\n * on read (`isOurProcess`) that clears whatever a crashed process left behind.\n */\n\nconst devDebug = subdebug('dev')\n\n/** Bump when the manifest/lock shape changes in a breaking way. */\nconst REGISTRY_VERSION = 1\n\n/**\n * The current process's start time as reported by the OS, for the `startedAt`\n * that `isOurProcess` checks on re-read. Falls back to now when the OS time is\n * unavailable — `new Date()` alone records the write time, which drifts from\n * process start by enough to look stale and get pruned right after writing.\n */\nfunction ownStartedAt(): string {\n  return (getProcessStartTime(process.pid) ?? new Date()).toISOString()\n}\n\nconst interfaceBaseFields = {\n  /** CLI-minted for a local interface; a deployed one gets its id from Brett. */\n  id: z.string(),\n  moduleId: z.string(),\n  name: z.string(),\n  /** Raw source vite serves; a deployed interface carries only the `moduleId`. */\n  src: z.string(),\n  title: z.string(),\n  version: z.optional(z.string()),\n}\n\n/**\n * A forwarded interface, discriminated on `type`. Kept outside the manifest so\n * the workbench renders local panels and runs workers without a deploy.\n */\nconst devServerInterfaceSchema = z.discriminatedUnion('type', [\n  z.object({\n    ...interfaceBaseFields,\n    metadata: z.nullable(AppInterfaceMetadataSchema),\n    type: z.literal('app'),\n  }),\n  z.object({...interfaceBaseFields, metadata: z.null(), type: z.literal('panel')}),\n  z.object({...interfaceBaseFields, metadata: z.null(), type: z.literal('worker')}),\n])\n\nconst devServerManifestSchema = z.object({\n  /**\n   * Field schema *values* load from the federation module; each field's `src`\n   * rides along so a repoint bumps the exposes-set id and forces a rebuild.\n   * Lenient — the workbench is the authority.\n   */\n  configs: z.optional(\n    z.array(\n      z.object({\n        // Identifies the owning app when it has no app id (singletons).\n        appType: z.optional(z.string()),\n        fields: z.array(\n          z.object({\n            name: z.string(),\n            public: z.optional(z.boolean()),\n            src: z.string(),\n            title: z.string(),\n          }),\n        ),\n        // Content hash of the config — the workbench's change-detection key\n        // (see deriveConfigs).\n        id: z.string(),\n        // The app's `unstable_defineApp` name — the module-federation alias the\n        // workbench loads this config's live values from.\n        moduleName: z.optional(z.string()),\n        // The version the workbench federates this config's module under —\n        // a string, like the one Brett returns on a deployed `activeConfig`.\n        version: z.string(),\n      }),\n    ),\n  ),\n  host: z.string(),\n  id: z.optional(z.string()),\n  interfaces: z.optional(z.array(devServerInterfaceSchema)),\n  /**\n   * Inlined manifest — either a {@link StudioManifest} or {@link CoreAppManifest},\n   * validated against the shared cli-core schemas. The registry stores and\n   * rebroadcasts it; the CLI is what extracts and writes it.\n   */\n  manifest: z.optional(z.union([studioManifestSchema, coreAppManifestSchema])),\n  /**\n   * ISO timestamp of the most recent successful manifest extraction. Bumped\n   * on every regeneration so re-writing this registry entry triggers the\n   * workbench `watchRegistry` watcher and forces a rebroadcast to clients.\n   */\n  manifestUpdatedAt: z.optional(z.string()),\n  pid: z.number(),\n  port: z.number(),\n  projectId: z.optional(z.string()),\n  startedAt: z.string(),\n  type: z.enum(['coreApp', 'studio']),\n  version: z.literal(REGISTRY_VERSION),\n  workDir: z.string(),\n})\n/**\n * A manifest describing a running dev server process (studio or app).\n * Stored as `~/.sanity/dev-servers/<pid>.json`.\n *\n * The workbench singleton is tracked separately via the lock file — see\n * `acquireWorkbenchLock` and `readWorkbenchLock` below.\n */\nexport type DevServerManifest = z.infer<typeof devServerManifestSchema>\n\n/**\n * Path to the dev server registry directory. Lives under the shared Sanity\n * config directory to stay consistent with other CLI paths.\n */\nfunction getRegistryDir(): string {\n  return join(getSanityDataDir(), 'dev-servers')\n}\n\n// One shared `exit` listener drives every registered cleanup, so N locks/entries\n// don't each add a listener and trip Node's MaxListeners warning.\nconst exitCleanups = new Set<() => void>()\nlet exitListenerInstalled = false\n\nfunction runExitCleanups(): void {\n  for (const cleanup of exitCleanups) cleanup()\n}\n\n/** Exercise the exit backstop in tests without terminating the process; not part\n * of the package's public surface. */\nexport const runRegistryExitCleanupForTesting = runExitCleanups\n\n/**\n * Delete a registry file synchronously on process exit, as a backstop for abrupt\n * termination. Vite installs its own SIGTERM handler that calls `process.exit()`,\n * which can outrun the async server teardown and leave the lock or registry entry\n * behind — a stray dev-server that lingers until the dead-pid prune clears it. The\n * `exit` event only runs synchronous work, hence `unlinkSync`. `ownedByUs` guards\n * the shared lock so a successor that reacquired it isn't wiped. Returns a\n * detacher to call after a clean release.\n */\nfunction unlinkOnProcessExit(filePath: string, ownedByUs: () => boolean): () => void {\n  const cleanup = () => {\n    if (!ownedByUs()) return\n    try {\n      unlinkSync(filePath)\n    } catch {\n      // The file may already have been removed during shutdown.\n    }\n  }\n  exitCleanups.add(cleanup)\n\n  if (!exitListenerInstalled) {\n    exitListenerInstalled = true\n    process.once('exit', runExitCleanups)\n  }\n\n  return () => exitCleanups.delete(cleanup)\n}\n\ninterface DevServerRegistration {\n  /** Remove the registry entry. */\n  release: () => void\n  /**\n   * Rewrite the registry entry with partial updates merged in. Also bumps the\n   * file's mtime, which fires `watchRegistry` in any workbench process and\n   * triggers a rebroadcast to connected clients.\n   */\n  update: (patch: Partial<Omit<DevServerManifest, 'pid' | 'startedAt' | 'version'>>) => void\n}\n\n/**\n * Write a manifest file for the current process and return a handle with a\n * `release` function that removes it plus an `update` function for patching\n * fields post-registration. Uses synchronous I/O so the file exists before\n * any signal handler could fire.\n */\nexport function registerDevServer(\n  manifest: Omit<DevServerManifest, 'pid' | 'startedAt' | 'version'>,\n): DevServerRegistration {\n  const registryDir = getRegistryDir()\n  mkdirSync(registryDir, {recursive: true})\n\n  let current: DevServerManifest = {\n    ...manifest,\n    pid: process.pid,\n    startedAt: ownStartedAt(),\n    version: REGISTRY_VERSION,\n  }\n\n  const filePath = join(registryDir, `${process.pid}.json`)\n  writeFileSync(filePath, JSON.stringify(current, null, 2))\n\n  // Guard against late updates from background tasks (e.g. the initial\n  // manifest extraction) landing after `release()` has deleted the file —\n  // without this, the update would re-create the registry entry and leak.\n  let released = false\n\n  // The file is pid-named, so it's always ours to remove on exit.\n  const detachExitCleanup = unlinkOnProcessExit(filePath, () => !released)\n\n  return {\n    release() {\n      released = true\n      detachExitCleanup()\n      try {\n        unlinkSync(filePath)\n      } catch {\n        // ENOENT is fine — already cleaned up\n      }\n    },\n    update(patch) {\n      if (released) return\n      current = {...current, ...patch}\n      writeFileSync(filePath, JSON.stringify(current, null, 2))\n    },\n  }\n}\n\n/**\n * Read all manifest files from the registry, prune stale entries (dead PIDs),\n * and return the live ones.\n */\nexport function getRegisteredServers(): DevServerManifest[] {\n  const registryDir = getRegistryDir()\n\n  if (!existsSync(registryDir)) {\n    return []\n  }\n\n  const files = readdirSync(registryDir).filter((f) => f.endsWith('.json'))\n  const servers: DevServerManifest[] = []\n\n  for (const file of files) {\n    const filePath = join(registryDir, file)\n    let raw: unknown\n    try {\n      raw = JSON.parse(readFileSync(filePath, 'utf8'))\n    } catch {\n      continue\n    }\n\n    const {data, success} = devServerManifestSchema.safeParse(raw)\n    if (!success) continue\n\n    if (isOurProcess(data.pid, data.startedAt)) {\n      servers.push(data)\n    } else {\n      try {\n        unlinkSync(filePath)\n      } catch {\n        // Ignore — another process may have already cleaned it up\n      }\n    }\n  }\n\n  return servers\n}\n\ninterface RegistryWatcher {\n  close(): void\n}\n\n/**\n * Watch the registry directory for changes and invoke the callback with the\n * current list of live servers whenever a change is detected.\n *\n * Uses `fs.watch` with a debounce to coalesce rapid file changes (e.g. a\n * server starting and writing its manifest triggers multiple FS events).\n */\nexport function watchRegistry(callback: (servers: DevServerManifest[]) => void): RegistryWatcher {\n  const registryDir = getRegistryDir()\n  mkdirSync(registryDir, {recursive: true})\n\n  // Canonicalize to the real long path so `fs.watch` doesn't abort on Windows\n  // short-path dirs. See `canonicalizeWatchDir`.\n  const watchDir = canonicalizeWatchDir(registryDir)\n\n  let debounceTimer: ReturnType<typeof setTimeout> | undefined\n\n  const notify = () => {\n    clearTimeout(debounceTimer)\n    debounceTimer = setTimeout(() => {\n      callback(getRegisteredServers())\n    }, 50)\n  }\n\n  const watcher = watch(watchDir, notify)\n\n  return {\n    close() {\n      clearTimeout(debounceTimer)\n      watcher.close()\n    },\n  }\n}\n\n// The workbench singleton lock — \"one workbench per machine\". Lives in the same\n// registry dir and shares the liveness/prune model: a stale lock left by a\n// crashed process is pruned on read so the next acquire isn't blocked forever.\n\nconst workbenchLockSchema = z.object({\n  host: z.string(),\n  pid: z.number(),\n  port: z.number(),\n  startedAt: z.string(),\n  version: z.literal(REGISTRY_VERSION),\n})\n\n/**\n * Read the workbench lock file and return its contents if the holding\n * process is still alive. Prunes stale locks from crashed processes.\n */\nexport function readWorkbenchLock(): z.infer<typeof workbenchLockSchema> | undefined {\n  const lockPath = join(getRegistryDir(), 'workbench.lock')\n\n  let contents: string\n  try {\n    contents = readFileSync(lockPath, 'utf8')\n  } catch {\n    // File doesn't exist — nothing to prune, nothing to return\n    return undefined\n  }\n\n  // Past this point the file exists. Anything that isn't a live, valid lock\n  // (unparsable JSON, schema mismatch, dead/reused PID) is stale and must be\n  // pruned — otherwise the next `acquireWorkbenchLock` call is blocked by\n  // EEXIST forever and `sanity dev` silently no-ops the workbench server.\n  const data = parseLockContents(contents)\n  devDebug('Read workbench lock: %o', data)\n  if (data && isOurProcess(data.pid, data.startedAt)) {\n    devDebug('Workbench process is alive at pid %d on port %d', data.pid, data.port)\n    return data\n  }\n\n  pruneWorkbenchLock(lockPath)\n  return undefined\n}\n\nfunction parseLockContents(contents: string): z.infer<typeof workbenchLockSchema> | undefined {\n  try {\n    const {data, success} = workbenchLockSchema.safeParse(JSON.parse(contents))\n    return success ? data : undefined\n  } catch {\n    return undefined\n  }\n}\n\nfunction pruneWorkbenchLock(lockPath: string): void {\n  try {\n    devDebug('Removing stale workbench lock')\n    unlinkSync(lockPath)\n    devDebug('Stale workbench lock removed')\n  } catch {\n    // Another process may have already cleaned it up\n  }\n}\n\ninterface WorkbenchLock {\n  /** Release the lock file. */\n  release: () => void\n  /** Update the lock with the actual port after the server starts listening. */\n  updatePort: (port: number) => void\n}\n\n/**\n * Attempt to acquire an exclusive lock for the workbench process.\n * Uses `O_EXCL` (the `wx` flag) which is atomic at the OS level — only one\n * process can create the file.\n *\n * The lock stores `{pid, host, port}` so other processes can find the\n * running workbench. Call `updatePort` after the Vite server starts to\n * write the actual port (Vite may pick a different one).\n *\n * @returns A {@link WorkbenchLock} if acquired, or `undefined` if another\n *          live process already holds it.\n */\nexport function acquireWorkbenchLock(\n  info: {host: string; port: number},\n  retries = 1,\n): WorkbenchLock | undefined {\n  const registryDir = getRegistryDir()\n  mkdirSync(registryDir, {recursive: true})\n\n  const lockPath = join(registryDir, 'workbench.lock')\n  const startedAt = ownStartedAt()\n  const lockData = {\n    host: info.host,\n    pid: process.pid,\n    port: info.port,\n    startedAt,\n    version: REGISTRY_VERSION,\n  }\n\n  devDebug('Acquiring workbench lock at %s', lockPath)\n\n  try {\n    writeFileSync(lockPath, JSON.stringify(lockData), {flag: 'wx'})\n    devDebug('Workbench lock acquired')\n\n    let released = false\n    // Only wipe the lock on exit if it's still ours — a successor that reacquired\n    // it after our own release must not be clobbered.\n    const detachExitCleanup = unlinkOnProcessExit(lockPath, () => {\n      if (released) return false\n      try {\n        const disk = parseLockContents(readFileSync(lockPath, 'utf8'))\n        return disk?.pid === process.pid && disk.startedAt === startedAt\n      } catch {\n        return false\n      }\n    })\n\n    return {\n      release() {\n        released = true\n        detachExitCleanup()\n        try {\n          unlinkSync(lockPath)\n        } catch {\n          // Already cleaned up\n        }\n      },\n      updatePort(port: number) {\n        writeFileSync(lockPath, JSON.stringify({...lockData, port}))\n      },\n    }\n  } catch (err: unknown) {\n    devDebug(\n      'Failed to acquire workbench lock: %s',\n      err instanceof Error ? err.message : String(err),\n    )\n    if (!isNodeError(err) || err.code !== 'EEXIST') return undefined\n\n    // Lock exists — check if the holder is still alive\n    const existing = readWorkbenchLock()\n    if (existing) return undefined\n\n    // Stale lock was pruned by readWorkbenchLock — retry (with guard against infinite recursion)\n    if (retries <= 0) return undefined\n    return acquireWorkbenchLock(info, retries - 1)\n  }\n}\n\nfunction isNodeError(err: unknown): err is NodeJS.ErrnoException {\n  return err instanceof Error && 'code' in err\n}\n"],"names":["existsSync","mkdirSync","readdirSync","readFileSync","unlinkSync","watch","writeFileSync","join","coreAppManifestSchema","getSanityDataDir","studioManifestSchema","subdebug","z","AppInterfaceMetadataSchema","canonicalizeWatchDir","getProcessStartTime","isOurProcess","devDebug","REGISTRY_VERSION","ownStartedAt","process","pid","Date","toISOString","interfaceBaseFields","id","string","moduleId","name","src","title","version","optional","devServerInterfaceSchema","discriminatedUnion","object","metadata","nullable","type","literal","null","devServerManifestSchema","configs","array","appType","fields","public","boolean","moduleName","host","interfaces","manifest","union","manifestUpdatedAt","number","port","projectId","startedAt","enum","workDir","getRegistryDir","exitCleanups","Set","exitListenerInstalled","runExitCleanups","cleanup","runRegistryExitCleanupForTesting","unlinkOnProcessExit","filePath","ownedByUs","add","once","delete","registerDevServer","registryDir","recursive","current","JSON","stringify","released","detachExitCleanup","release","update","patch","getRegisteredServers","files","filter","f","endsWith","servers","file","raw","parse","data","success","safeParse","push","watchRegistry","callback","watchDir","debounceTimer","notify","clearTimeout","setTimeout","watcher","close","workbenchLockSchema","readWorkbenchLock","lockPath","contents","undefined","parseLockContents","pruneWorkbenchLock","acquireWorkbenchLock","info","retries","lockData","flag","disk","updatePort","err","Error","message","String","isNodeError","code","existing"],"mappings":"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"}
+{"version":3,"sources":["../../../src/actions/dev/registry.ts"],"sourcesContent":["import {\n  existsSync,\n  mkdirSync,\n  readdirSync,\n  readFileSync,\n  unlinkSync,\n  watch,\n  writeFileSync,\n} from 'node:fs'\nimport {join} from 'node:path'\n\nimport {\n  coreAppManifestSchema,\n  getSanityDataDir,\n  studioManifestSchema,\n  subdebug,\n} from '@sanity/cli-core'\nimport {z} from 'zod/mini'\n\nimport {AppInterfaceMetadataSchema, TileInterfaceMetadataSchema} from '../../contract.js'\nimport {canonicalizeWatchDir} from './canonicalizeWatchDir.js'\nimport {getProcessStartTime, isOurProcess} from './processLiveness.js'\n\n/**\n * The dev-server registry: how a running `sanity dev` / `sanity start` process\n * advertises itself so the workbench on this machine can find and load it.\n *\n * Two kinds of file under `~/.sanity/dev-servers/` do the coordinating:\n *\n *   - `<pid>.json` — one per running app/studio server, holding where it's served\n *     plus its inlined manifest and interfaces. The workbench reads these to\n *     discover and render local apps. Written by `registerDevServer`, watched by\n *     `watchRegistry`.\n *   - `workbench.lock` — a single machine-wide lock, so only one workbench shell\n *     runs at a time and later `dev`s register into it instead of starting their\n *     own. Managed by `acquireWorkbenchLock` / `readWorkbenchLock`.\n *\n * Both files belong to the process that created them and must not outlive it.\n * Three things keep that true: an explicit `release()` on clean shutdown, an\n * `exit` backstop for abrupt exits (`unlinkOnProcessExit`), and a dead-pid prune\n * on read (`isOurProcess`) that clears whatever a crashed process left behind.\n */\n\nconst devDebug = subdebug('dev')\n\n/** Bump when the manifest/lock shape changes in a breaking way. */\nconst REGISTRY_VERSION = 1\n\n/**\n * The current process's start time as reported by the OS, for the `startedAt`\n * that `isOurProcess` checks on re-read. Falls back to now when the OS time is\n * unavailable — `new Date()` alone records the write time, which drifts from\n * process start by enough to look stale and get pruned right after writing.\n */\nfunction ownStartedAt(): string {\n  return (getProcessStartTime(process.pid) ?? new Date()).toISOString()\n}\n\nconst interfaceBaseFields = {\n  /** CLI-minted for a local interface; a deployed one gets its id from Brett. */\n  id: z.string(),\n  moduleId: z.string(),\n  name: z.string(),\n  /** Raw source vite serves; a deployed interface carries only the `moduleId`. */\n  src: z.string(),\n  title: z.string(),\n  version: z.optional(z.string()),\n}\n\n/**\n * A forwarded interface, discriminated on `type`. Kept outside the manifest so\n * the workbench renders local panels and runs workers without a deploy.\n */\nconst devServerInterfaceSchema = z.discriminatedUnion('type', [\n  z.object({\n    ...interfaceBaseFields,\n    metadata: z.nullable(AppInterfaceMetadataSchema),\n    type: z.literal('app'),\n  }),\n  z.object({...interfaceBaseFields, metadata: z.null(), type: z.literal('panel')}),\n  z.object({...interfaceBaseFields, metadata: z.null(), type: z.literal('asset_source')}),\n  z.object({\n    ...interfaceBaseFields,\n    metadata: TileInterfaceMetadataSchema,\n    type: z.literal('tile'),\n  }),\n  z.object({...interfaceBaseFields, metadata: z.null(), type: z.literal('worker')}),\n])\n\nconst devServerManifestSchema = z.object({\n  /**\n   * Field schema *values* load from the federation module; each field's `src`\n   * rides along so a repoint bumps the exposes-set id and forces a rebuild.\n   * Lenient — the workbench is the authority.\n   */\n  configs: z.optional(\n    z.array(\n      z.object({\n        // Identifies the owning app when it has no app id (singletons).\n        appType: z.optional(z.string()),\n        fields: z.array(\n          z.object({\n            name: z.string(),\n            public: z.optional(z.boolean()),\n            src: z.string(),\n            title: z.string(),\n          }),\n        ),\n        // Content hash of the config — the workbench's change-detection key\n        // (see deriveConfigs).\n        id: z.string(),\n        // The app's `unstable_defineApp` slug — the module-federation alias the\n        // workbench loads this config's live values from.\n        moduleName: z.optional(z.string()),\n        // The version the workbench federates this config's module under —\n        // a string, like the one Brett returns on a deployed `activeConfig`.\n        version: z.string(),\n      }),\n    ),\n  ),\n  host: z.string(),\n  id: z.optional(z.string()),\n  interfaces: z.optional(z.array(devServerInterfaceSchema)),\n  /**\n   * Inlined manifest — either a {@link StudioManifest} or {@link CoreAppManifest},\n   * validated against the shared cli-core schemas. The registry stores and\n   * rebroadcasts it; the CLI is what extracts and writes it.\n   */\n  manifest: z.optional(z.union([studioManifestSchema, coreAppManifestSchema])),\n  /**\n   * ISO timestamp of the most recent successful manifest extraction. Bumped\n   * on every regeneration so re-writing this registry entry triggers the\n   * workbench `watchRegistry` watcher and forces a rebroadcast to clients.\n   */\n  manifestUpdatedAt: z.optional(z.string()),\n  pid: z.number(),\n  port: z.number(),\n  projectId: z.optional(z.string()),\n  startedAt: z.string(),\n  type: z.enum(['coreApp', 'studio']),\n  version: z.literal(REGISTRY_VERSION),\n  workDir: z.string(),\n})\n/**\n * A manifest describing a running dev server process (studio or app).\n * Stored as `~/.sanity/dev-servers/<pid>.json`.\n *\n * The workbench singleton is tracked separately via the lock file — see\n * `acquireWorkbenchLock` and `readWorkbenchLock` below.\n */\nexport type DevServerManifest = z.infer<typeof devServerManifestSchema>\n\n/**\n * Path to the dev server registry directory. Lives under the shared Sanity\n * config directory to stay consistent with other CLI paths.\n */\nfunction getRegistryDir(): string {\n  return join(getSanityDataDir(), 'dev-servers')\n}\n\n// One shared `exit` listener drives every registered cleanup, so N locks/entries\n// don't each add a listener and trip Node's MaxListeners warning.\nconst exitCleanups = new Set<() => void>()\nlet exitListenerInstalled = false\n\nfunction runExitCleanups(): void {\n  for (const cleanup of exitCleanups) cleanup()\n}\n\n/** Exercise the exit backstop in tests without terminating the process; not part\n * of the package's public surface. */\nexport const runRegistryExitCleanupForTesting = runExitCleanups\n\n/**\n * Delete a registry file synchronously on process exit, as a backstop for abrupt\n * termination. Vite installs its own SIGTERM handler that calls `process.exit()`,\n * which can outrun the async server teardown and leave the lock or registry entry\n * behind — a stray dev-server that lingers until the dead-pid prune clears it. The\n * `exit` event only runs synchronous work, hence `unlinkSync`. `ownedByUs` guards\n * the shared lock so a successor that reacquired it isn't wiped. Returns a\n * detacher to call after a clean release.\n */\nfunction unlinkOnProcessExit(filePath: string, ownedByUs: () => boolean): () => void {\n  const cleanup = () => {\n    if (!ownedByUs()) return\n    try {\n      unlinkSync(filePath)\n    } catch {\n      // The file may already have been removed during shutdown.\n    }\n  }\n  exitCleanups.add(cleanup)\n\n  if (!exitListenerInstalled) {\n    exitListenerInstalled = true\n    process.once('exit', runExitCleanups)\n  }\n\n  return () => exitCleanups.delete(cleanup)\n}\n\ninterface DevServerRegistration {\n  /** Remove the registry entry. */\n  release: () => void\n  /**\n   * Rewrite the registry entry with partial updates merged in. Also bumps the\n   * file's mtime, which fires `watchRegistry` in any workbench process and\n   * triggers a rebroadcast to connected clients.\n   */\n  update: (patch: Partial<Omit<DevServerManifest, 'pid' | 'startedAt' | 'version'>>) => void\n}\n\n/**\n * Write a manifest file for the current process and return a handle with a\n * `release` function that removes it plus an `update` function for patching\n * fields post-registration. Uses synchronous I/O so the file exists before\n * any signal handler could fire.\n */\nexport function registerDevServer(\n  manifest: Omit<DevServerManifest, 'pid' | 'startedAt' | 'version'>,\n): DevServerRegistration {\n  const registryDir = getRegistryDir()\n  mkdirSync(registryDir, {recursive: true})\n\n  let current: DevServerManifest = {\n    ...manifest,\n    pid: process.pid,\n    startedAt: ownStartedAt(),\n    version: REGISTRY_VERSION,\n  }\n\n  const filePath = join(registryDir, `${process.pid}.json`)\n  writeFileSync(filePath, JSON.stringify(current, null, 2))\n\n  // Guard against late updates from background tasks (e.g. the initial\n  // manifest extraction) landing after `release()` has deleted the file —\n  // without this, the update would re-create the registry entry and leak.\n  let released = false\n\n  // The file is pid-named, so it's always ours to remove on exit.\n  const detachExitCleanup = unlinkOnProcessExit(filePath, () => !released)\n\n  return {\n    release() {\n      released = true\n      detachExitCleanup()\n      try {\n        unlinkSync(filePath)\n      } catch {\n        // ENOENT is fine — already cleaned up\n      }\n    },\n    update(patch) {\n      if (released) return\n      current = {...current, ...patch}\n      writeFileSync(filePath, JSON.stringify(current, null, 2))\n    },\n  }\n}\n\n/**\n * Read all manifest files from the registry, prune stale entries (dead PIDs),\n * and return the live ones.\n */\nexport function getRegisteredServers(): DevServerManifest[] {\n  const registryDir = getRegistryDir()\n\n  if (!existsSync(registryDir)) {\n    return []\n  }\n\n  const files = readdirSync(registryDir).filter((f) => f.endsWith('.json'))\n  const servers: DevServerManifest[] = []\n\n  for (const file of files) {\n    const filePath = join(registryDir, file)\n    let raw: unknown\n    try {\n      raw = JSON.parse(readFileSync(filePath, 'utf8'))\n    } catch {\n      continue\n    }\n\n    const {data, success} = devServerManifestSchema.safeParse(raw)\n    if (!success) continue\n\n    if (isOurProcess(data.pid, data.startedAt)) {\n      servers.push(data)\n    } else {\n      try {\n        unlinkSync(filePath)\n      } catch {\n        // Ignore — another process may have already cleaned it up\n      }\n    }\n  }\n\n  return servers\n}\n\ninterface RegistryWatcher {\n  close(): void\n}\n\n/**\n * Watch the registry directory for changes and invoke the callback with the\n * current list of live servers whenever a change is detected.\n *\n * Uses `fs.watch` with a debounce to coalesce rapid file changes (e.g. a\n * server starting and writing its manifest triggers multiple FS events).\n */\nexport function watchRegistry(callback: (servers: DevServerManifest[]) => void): RegistryWatcher {\n  const registryDir = getRegistryDir()\n  mkdirSync(registryDir, {recursive: true})\n\n  // Canonicalize to the real long path so `fs.watch` doesn't abort on Windows\n  // short-path dirs. See `canonicalizeWatchDir`.\n  const watchDir = canonicalizeWatchDir(registryDir)\n\n  let debounceTimer: ReturnType<typeof setTimeout> | undefined\n\n  const notify = () => {\n    clearTimeout(debounceTimer)\n    debounceTimer = setTimeout(() => {\n      callback(getRegisteredServers())\n    }, 50)\n  }\n\n  const watcher = watch(watchDir, notify)\n\n  return {\n    close() {\n      clearTimeout(debounceTimer)\n      watcher.close()\n    },\n  }\n}\n\n// The workbench singleton lock — \"one workbench per machine\". Lives in the same\n// registry dir and shares the liveness/prune model: a stale lock left by a\n// crashed process is pruned on read so the next acquire isn't blocked forever.\n\nconst workbenchLockSchema = z.object({\n  host: z.string(),\n  pid: z.number(),\n  port: z.number(),\n  startedAt: z.string(),\n  version: z.literal(REGISTRY_VERSION),\n})\n\n/**\n * Read the workbench lock file and return its contents if the holding\n * process is still alive. Prunes stale locks from crashed processes.\n */\nexport function readWorkbenchLock(): z.infer<typeof workbenchLockSchema> | undefined {\n  const lockPath = join(getRegistryDir(), 'workbench.lock')\n\n  let contents: string\n  try {\n    contents = readFileSync(lockPath, 'utf8')\n  } catch {\n    // File doesn't exist — nothing to prune, nothing to return\n    return undefined\n  }\n\n  // Past this point the file exists. Anything that isn't a live, valid lock\n  // (unparsable JSON, schema mismatch, dead/reused PID) is stale and must be\n  // pruned — otherwise the next `acquireWorkbenchLock` call is blocked by\n  // EEXIST forever and `sanity dev` silently no-ops the workbench server.\n  const data = parseLockContents(contents)\n  devDebug('Read workbench lock: %o', data)\n  if (data && isOurProcess(data.pid, data.startedAt)) {\n    devDebug('Workbench process is alive at pid %d on port %d', data.pid, data.port)\n    return data\n  }\n\n  pruneWorkbenchLock(lockPath)\n  return undefined\n}\n\nfunction parseLockContents(contents: string): z.infer<typeof workbenchLockSchema> | undefined {\n  try {\n    const {data, success} = workbenchLockSchema.safeParse(JSON.parse(contents))\n    return success ? data : undefined\n  } catch {\n    return undefined\n  }\n}\n\nfunction pruneWorkbenchLock(lockPath: string): void {\n  try {\n    devDebug('Removing stale workbench lock')\n    unlinkSync(lockPath)\n    devDebug('Stale workbench lock removed')\n  } catch {\n    // Another process may have already cleaned it up\n  }\n}\n\ninterface WorkbenchLock {\n  /** Release the lock file. */\n  release: () => void\n  /** Update the lock with the actual port after the server starts listening. */\n  updatePort: (port: number) => void\n}\n\n/**\n * Attempt to acquire an exclusive lock for the workbench process.\n * Uses `O_EXCL` (the `wx` flag) which is atomic at the OS level — only one\n * process can create the file.\n *\n * The lock stores `{pid, host, port}` so other processes can find the\n * running workbench. Call `updatePort` after the Vite server starts to\n * write the actual port (Vite may pick a different one).\n *\n * @returns A {@link WorkbenchLock} if acquired, or `undefined` if another\n *          live process already holds it.\n */\nexport function acquireWorkbenchLock(\n  info: {host: string; port: number},\n  retries = 1,\n): WorkbenchLock | undefined {\n  const registryDir = getRegistryDir()\n  mkdirSync(registryDir, {recursive: true})\n\n  const lockPath = join(registryDir, 'workbench.lock')\n  const startedAt = ownStartedAt()\n  const lockData = {\n    host: info.host,\n    pid: process.pid,\n    port: info.port,\n    startedAt,\n    version: REGISTRY_VERSION,\n  }\n\n  devDebug('Acquiring workbench lock at %s', lockPath)\n\n  try {\n    writeFileSync(lockPath, JSON.stringify(lockData), {flag: 'wx'})\n    devDebug('Workbench lock acquired')\n\n    let released = false\n    // Only wipe the lock on exit if it's still ours — a successor that reacquired\n    // it after our own release must not be clobbered.\n    const detachExitCleanup = unlinkOnProcessExit(lockPath, () => {\n      if (released) return false\n      try {\n        const disk = parseLockContents(readFileSync(lockPath, 'utf8'))\n        return disk?.pid === process.pid && disk.startedAt === startedAt\n      } catch {\n        return false\n      }\n    })\n\n    return {\n      release() {\n        released = true\n        detachExitCleanup()\n        try {\n          unlinkSync(lockPath)\n        } catch {\n          // Already cleaned up\n        }\n      },\n      updatePort(port: number) {\n        writeFileSync(lockPath, JSON.stringify({...lockData, port}))\n      },\n    }\n  } catch (err: unknown) {\n    devDebug(\n      'Failed to acquire workbench lock: %s',\n      err instanceof Error ? err.message : String(err),\n    )\n    if (!isNodeError(err) || err.code !== 'EEXIST') return undefined\n\n    // Lock exists — check if the holder is still alive\n    const existing = readWorkbenchLock()\n    if (existing) return undefined\n\n    // Stale lock was pruned by readWorkbenchLock — retry (with guard against infinite recursion)\n    if (retries <= 0) return undefined\n    return acquireWorkbenchLock(info, retries - 1)\n  }\n}\n\nfunction isNodeError(err: unknown): err is NodeJS.ErrnoException {\n  return err instanceof Error && 'code' in err\n}\n"],"names":["existsSync","mkdirSync","readdirSync","readFileSync","unlinkSync","watch","writeFileSync","join","coreAppManifestSchema","getSanityDataDir","studioManifestSchema","subdebug","z","AppInterfaceMetadataSchema","TileInterfaceMetadataSchema","canonicalizeWatchDir","getProcessStartTime","isOurProcess","devDebug","REGISTRY_VERSION","ownStartedAt","process","pid","Date","toISOString","interfaceBaseFields","id","string","moduleId","name","src","title","version","optional","devServerInterfaceSchema","discriminatedUnion","object","metadata","nullable","type","literal","null","devServerManifestSchema","configs","array","appType","fields","public","boolean","moduleName","host","interfaces","manifest","union","manifestUpdatedAt","number","port","projectId","startedAt","enum","workDir","getRegistryDir","exitCleanups","Set","exitListenerInstalled","runExitCleanups","cleanup","runRegistryExitCleanupForTesting","unlinkOnProcessExit","filePath","ownedByUs","add","once","delete","registerDevServer","registryDir","recursive","current","JSON","stringify","released","detachExitCleanup","release","update","patch","getRegisteredServers","files","filter","f","endsWith","servers","file","raw","parse","data","success","safeParse","push","watchRegistry","callback","watchDir","debounceTimer","notify","clearTimeout","setTimeout","watcher","close","workbenchLockSchema","readWorkbenchLock","lockPath","contents","undefined","parseLockContents","pruneWorkbenchLock","acquireWorkbenchLock","info","retries","lockData","flag","disk","updatePort","err","Error","message","String","isNodeError","code","existing"],"mappings":"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"}

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

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/actions/dev/startDevManifestWatcher.ts"],"sourcesContent":["import {watch} from 'node:fs'\nimport {basename, dirname} from 'node:path'\n\nimport {findProjectRoot, type Output, subdebug} from '@sanity/cli-core'\n\nimport {canonicalizeWatchDir} from './canonicalizeWatchDir.js'\nimport {type DevServerConfig, type DevServerInterface} from './deriveInterfaces.js'\n\nconst devDebug = subdebug('dev')\n\n/**\n * Debounce window between config file events and the next manifest\n * regeneration. Coalesces rapid saves (e.g. editor auto-save) and\n * atomic-rename bursts emitted by tools like VS Code.\n */\nconst DEBOUNCE_MS = 250\n\ninterface DevManifestWatcher {\n  close: () => Promise<void>\n}\n\n/** Subset of registry fields the watcher is allowed to update. */\ninterface ManifestPatch<T> {\n  manifest: T | undefined\n  manifestUpdatedAt: string\n\n  /** Same re-derive-don't-omit contract as `interfaces`. */\n  configs?: DevServerConfig[] | undefined\n  /**\n   * Workbench interfaces (views/services/app view) re-derived from the config\n   * on each change, so editing `views`/`services`/`entry` in `sanity.cli.ts`\n   * re-syncs live like `title`/`icon`. `undefined` only for\n   * non-branded configs — the registry patch is a shallow merge, so extractors\n   * must re-derive rather than omit, or the registered set gets wiped.\n   */\n  interfaces?: DevServerInterface[] | undefined\n}\n\ninterface StartDevManifestWatcherOptions<T> {\n  /**\n   * Run the project-specific extraction and resolve to the manifest patch, which\n   * the watcher stamps with `manifestUpdatedAt` before forwarding. Receives the\n   * resolved config path (`sanity.config.ts` for studios, `sanity.cli.ts` for\n   * core-apps) and the working directory.\n   */\n  extract: (params: {\n    configPath: string\n    workDir: string\n  }) => Promise<Omit<ManifestPatch<T>, 'manifestUpdatedAt'>>\n  output: Output\n  /**\n   * Called after every successful extraction with the inlined manifest +\n   * interfaces. Awaited, so an interface-set change can rebuild the federation\n   * remote before the registry is patched (which is what reloads the workbench).\n   */\n  update: (patch: ManifestPatch<T>) => Promise<void> | void\n  workDir: string\n\n  /**\n   * Extra config filenames (basenames in the project root directory) that also\n   * trigger a regeneration. Studios resolve their project root via\n   * `sanity.config.*` but declare workbench interfaces in `sanity.cli.*`, so\n   * their watcher needs to react to both files.\n   */\n  extraWatchFilenames?: readonly string[]\n}\n\n/**\n * Generate the project manifest once and then keep it in sync with the\n * project's config file (`sanity.config.(ts|js)` for studios,\n * `sanity.cli.(ts|js)` for core-apps) on disk. The initial generation runs\n * fire-and-forget so it doesn't block dev-server startup; subsequent\n * file-system events are coalesced behind it, so the extractor never has\n * overlapping writes to its shared output directory. Each successful\n * regeneration inlines the new manifest into the registry via the `update`\n * callback, so any running workbench rebroadcasts to its clients.\n *\n * Errors during extraction are logged as warnings and do not crash the dev\n * server — the previously extracted manifest (if any) stays in the\n * registry.\n */\nexport async function startDevManifestWatcher<T>({\n  extract,\n  extraWatchFilenames,\n  output,\n  update,\n  workDir,\n}: StartDevManifestWatcherOptions<T>): Promise<DevManifestWatcher> {\n  const projectRoot = await findProjectRoot(workDir)\n  const configPath = projectRoot.path\n\n  let running = false\n  let pending = false\n  let closed = false\n\n  const regenerate = async () => {\n    if (closed) return\n    if (running) {\n      pending = true\n      return\n    }\n    running = true\n    try {\n      const {configs, interfaces, manifest} = await extract({configPath, workDir})\n      if (closed) return\n      await update({\n        configs,\n        interfaces,\n        manifest,\n        manifestUpdatedAt: new Date().toISOString(),\n      })\n    } catch (err) {\n      // Extractors print their own spinner failure; log the reason here so\n      // the user sees what went wrong alongside the spinner indicator.\n      devDebug('Manifest regeneration failed: %O', err)\n      output.warn(\n        `Could not extract manifest for workbench: ${err instanceof Error ? err.message : String(err)}`,\n      )\n    } finally {\n      running = false\n      if (pending && !closed) {\n        pending = false\n        void regenerate()\n      }\n    }\n  }\n\n  // Route the initial extraction through `regenerate` too, so file-system\n  // events arriving before it finishes get coalesced rather than racing it\n  // for the shared output directory.\n  void regenerate()\n\n  // Watch the config file's parent directory and filter by filename.\n  // Watching the file itself is unreliable across editors that perform\n  // atomic-save (delete + rename) — the watcher loses its target once the\n  // inode changes. Directory watches survive those transitions.\n  // Canonicalize to the real long path so `fs.watch` doesn't abort on Windows\n  // short-path dirs. See `canonicalizeWatchDir`.\n  const configDir = canonicalizeWatchDir(dirname(configPath))\n  const watchFilenames = new Set([basename(configPath), ...(extraWatchFilenames ?? [])])\n\n  let debounceTimer: ReturnType<typeof setTimeout> | undefined\n\n  const onEvent = (_event: string, filename: Buffer | string | null) => {\n    if (!filename) return\n    const name = typeof filename === 'string' ? filename : filename.toString('utf8')\n    if (!watchFilenames.has(name)) return\n    clearTimeout(debounceTimer)\n    debounceTimer = setTimeout(() => {\n      void regenerate()\n    }, DEBOUNCE_MS)\n  }\n\n  const watcher = watch(configDir, onEvent)\n\n  watcher.on('error', (err) => {\n    devDebug('Config watcher error: %O', err)\n    output.warn(`Manifest watcher error: ${err instanceof Error ? err.message : String(err)}`)\n  })\n\n  return {\n    // Idempotent — a repeat close (e.g. a signal handler racing an explicit\n    // close) is a no-op, so we never clear an already-cleared timer or\n    // double-close the underlying watcher.\n    close: async () => {\n      if (closed) return\n      closed = true\n      clearTimeout(debounceTimer)\n      watcher.close()\n    },\n  }\n}\n"],"names":["watch","basename","dirname","findProjectRoot","subdebug","canonicalizeWatchDir","devDebug","DEBOUNCE_MS","startDevManifestWatcher","extract","extraWatchFilenames","output","update","workDir","projectRoot","configPath","path","running","pending","closed","regenerate","configs","interfaces","manifest","manifestUpdatedAt","Date","toISOString","err","warn","Error","message","String","configDir","watchFilenames","Set","debounceTimer","onEvent","_event","filename","name","toString","has","clearTimeout","setTimeout","watcher","on","close"],"mappings":"AAAA,SAAQA,KAAK,QAAO,UAAS;AAC7B,SAAQC,QAAQ,EAAEC,OAAO,QAAO,YAAW;AAE3C,SAAQC,eAAe,EAAeC,QAAQ,QAAO,mBAAkB;AAEvE,SAAQC,oBAAoB,QAAO,4BAA2B;AAG9D,MAAMC,WAAWF,SAAS;AAE1B;;;;CAIC,GACD,MAAMG,cAAc;AAoDpB;;;;;;;;;;;;;CAaC,GACD,OAAO,eAAeC,wBAA2B,EAC/CC,OAAO,EACPC,mBAAmB,EACnBC,MAAM,EACNC,MAAM,EACNC,OAAO,EAC2B;IAClC,MAAMC,cAAc,MAAMX,gBAAgBU;IAC1C,MAAME,aAAaD,YAAYE,IAAI;IAEnC,IAAIC,UAAU;IACd,IAAIC,UAAU;IACd,IAAIC,SAAS;IAEb,MAAMC,aAAa;QACjB,IAAID,QAAQ;QACZ,IAAIF,SAAS;YACXC,UAAU;YACV;QACF;QACAD,UAAU;QACV,IAAI;YACF,MAAM,EAACI,OAAO,EAAEC,UAAU,EAAEC,QAAQ,EAAC,GAAG,MAAMd,QAAQ;gBAACM;gBAAYF;YAAO;YAC1E,IAAIM,QAAQ;YACZ,MAAMP,OAAO;gBACXS;gBACAC;gBACAC;gBACAC,mBAAmB,IAAIC,OAAOC,WAAW;YAC3C;QACF,EAAE,OAAOC,KAAK;YACZ,qEAAqE;YACrE,iEAAiE;YACjErB,SAAS,oCAAoCqB;YAC7ChB,OAAOiB,IAAI,CACT,CAAC,0CAA0C,EAAED,eAAeE,QAAQF,IAAIG,OAAO,GAAGC,OAAOJ,MAAM;QAEnG,SAAU;YACRV,UAAU;YACV,IAAIC,WAAW,CAACC,QAAQ;gBACtBD,UAAU;gBACV,KAAKE;YACP;QACF;IACF;IAEA,wEAAwE;IACxE,yEAAyE;IACzE,mCAAmC;IACnC,KAAKA;IAEL,mEAAmE;IACnE,qEAAqE;IACrE,wEAAwE;IACxE,8DAA8D;IAC9D,4EAA4E;IAC5E,+CAA+C;IAC/C,MAAMY,YAAY3B,qBAAqBH,QAAQa;IAC/C,MAAMkB,iBAAiB,IAAIC,IAAI;QAACjC,SAASc;WAAiBL,uBAAuB,EAAE;KAAE;IAErF,IAAIyB;IAEJ,MAAMC,UAAU,CAACC,QAAgBC;QAC/B,IAAI,CAACA,UAAU;QACf,MAAMC,OAAO,OAAOD,aAAa,WAAWA,WAAWA,SAASE,QAAQ,CAAC;QACzE,IAAI,CAACP,eAAeQ,GAAG,CAACF,OAAO;QAC/BG,aAAaP;QACbA,gBAAgBQ,WAAW;YACzB,KAAKvB;QACP,GAAGb;IACL;IAEA,MAAMqC,UAAU5C,MAAMgC,WAAWI;IAEjCQ,QAAQC,EAAE,CAAC,SAAS,CAAClB;QACnBrB,SAAS,4BAA4BqB;QACrChB,OAAOiB,IAAI,CAAC,CAAC,wBAAwB,EAAED,eAAeE,QAAQF,IAAIG,OAAO,GAAGC,OAAOJ,MAAM;IAC3F;IAEA,OAAO;QACL,wEAAwE;QACxE,mEAAmE;QACnE,uCAAuC;QACvCmB,OAAO;YACL,IAAI3B,QAAQ;YACZA,SAAS;YACTuB,aAAaP;YACbS,QAAQE,KAAK;QACf;IACF;AACF"}
+{"version":3,"sources":["../../../src/actions/dev/startDevManifestWatcher.ts"],"sourcesContent":["import {watch} from 'node:fs'\nimport {basename, dirname} from 'node:path'\n\nimport {findProjectRoot, type Output, subdebug} from '@sanity/cli-core'\n\nimport {canonicalizeWatchDir} from './canonicalizeWatchDir.js'\nimport {type DevServerConfig, type DevServerInterface} from './deriveConfigs.js'\n\nconst devDebug = subdebug('dev')\n\n/**\n * Debounce window between config file events and the next manifest\n * regeneration. Coalesces rapid saves (e.g. editor auto-save) and\n * atomic-rename bursts emitted by tools like VS Code.\n */\nconst DEBOUNCE_MS = 250\n\ninterface DevManifestWatcher {\n  close: () => Promise<void>\n}\n\n/** Subset of registry fields the watcher is allowed to update. */\ninterface ManifestPatch<T> {\n  manifest: T | undefined\n  manifestUpdatedAt: string\n\n  /** Same re-derive-don't-omit contract as `interfaces`. */\n  configs?: DevServerConfig[] | undefined\n  /**\n   * Workbench interfaces (views/services/app view) re-derived from the config\n   * on each change, so editing `views`/`services`/`entry` in `sanity.cli.ts`\n   * re-syncs live like `title`/`icon`. `undefined` only for\n   * non-branded configs — the registry patch is a shallow merge, so extractors\n   * must re-derive rather than omit, or the registered set gets wiped.\n   */\n  interfaces?: DevServerInterface[] | undefined\n}\n\ninterface StartDevManifestWatcherOptions<T> {\n  /**\n   * Run the project-specific extraction and resolve to the manifest patch, which\n   * the watcher stamps with `manifestUpdatedAt` before forwarding. Receives the\n   * resolved config path (`sanity.config.ts` for studios, `sanity.cli.ts` for\n   * core-apps) and the working directory.\n   */\n  extract: (params: {\n    configPath: string\n    workDir: string\n  }) => Promise<Omit<ManifestPatch<T>, 'manifestUpdatedAt'>>\n  output: Output\n  /**\n   * Called after every successful extraction with the inlined manifest +\n   * interfaces. Awaited, so an interface-set change can rebuild the federation\n   * remote before the registry is patched (which is what reloads the workbench).\n   */\n  update: (patch: ManifestPatch<T>) => Promise<void> | void\n  workDir: string\n\n  /**\n   * Extra config filenames (basenames in the project root directory) that also\n   * trigger a regeneration. Studios resolve their project root via\n   * `sanity.config.*` but declare workbench interfaces in `sanity.cli.*`, so\n   * their watcher needs to react to both files.\n   */\n  extraWatchFilenames?: readonly string[]\n}\n\n/**\n * Generate the project manifest once and then keep it in sync with the\n * project's config file (`sanity.config.(ts|js)` for studios,\n * `sanity.cli.(ts|js)` for core-apps) on disk. The initial generation runs\n * fire-and-forget so it doesn't block dev-server startup; subsequent\n * file-system events are coalesced behind it, so the extractor never has\n * overlapping writes to its shared output directory. Each successful\n * regeneration inlines the new manifest into the registry via the `update`\n * callback, so any running workbench rebroadcasts to its clients.\n *\n * Errors during extraction are logged as warnings and do not crash the dev\n * server — the previously extracted manifest (if any) stays in the\n * registry.\n */\nexport async function startDevManifestWatcher<T>({\n  extract,\n  extraWatchFilenames,\n  output,\n  update,\n  workDir,\n}: StartDevManifestWatcherOptions<T>): Promise<DevManifestWatcher> {\n  const projectRoot = await findProjectRoot(workDir)\n  const configPath = projectRoot.path\n\n  let running = false\n  let pending = false\n  let closed = false\n\n  const regenerate = async () => {\n    if (closed) return\n    if (running) {\n      pending = true\n      return\n    }\n    running = true\n    try {\n      const {configs, interfaces, manifest} = await extract({configPath, workDir})\n      if (closed) return\n      await update({\n        configs,\n        interfaces,\n        manifest,\n        manifestUpdatedAt: new Date().toISOString(),\n      })\n    } catch (err) {\n      // Extractors print their own spinner failure; log the reason here so\n      // the user sees what went wrong alongside the spinner indicator.\n      devDebug('Manifest regeneration failed: %O', err)\n      output.warn(\n        `Could not extract manifest for workbench: ${err instanceof Error ? err.message : String(err)}`,\n      )\n    } finally {\n      running = false\n      if (pending && !closed) {\n        pending = false\n        void regenerate()\n      }\n    }\n  }\n\n  // Route the initial extraction through `regenerate` too, so file-system\n  // events arriving before it finishes get coalesced rather than racing it\n  // for the shared output directory.\n  void regenerate()\n\n  // Watch the config file's parent directory and filter by filename.\n  // Watching the file itself is unreliable across editors that perform\n  // atomic-save (delete + rename) — the watcher loses its target once the\n  // inode changes. Directory watches survive those transitions.\n  // Canonicalize to the real long path so `fs.watch` doesn't abort on Windows\n  // short-path dirs. See `canonicalizeWatchDir`.\n  const configDir = canonicalizeWatchDir(dirname(configPath))\n  const watchFilenames = new Set([basename(configPath), ...(extraWatchFilenames ?? [])])\n\n  let debounceTimer: ReturnType<typeof setTimeout> | undefined\n\n  const onEvent = (_event: string, filename: Buffer | string | null) => {\n    if (!filename) return\n    const name = typeof filename === 'string' ? filename : filename.toString('utf8')\n    if (!watchFilenames.has(name)) return\n    clearTimeout(debounceTimer)\n    debounceTimer = setTimeout(() => {\n      void regenerate()\n    }, DEBOUNCE_MS)\n  }\n\n  const watcher = watch(configDir, onEvent)\n\n  watcher.on('error', (err) => {\n    devDebug('Config watcher error: %O', err)\n    output.warn(`Manifest watcher error: ${err instanceof Error ? err.message : String(err)}`)\n  })\n\n  return {\n    // Idempotent — a repeat close (e.g. a signal handler racing an explicit\n    // close) is a no-op, so we never clear an already-cleared timer or\n    // double-close the underlying watcher.\n    close: async () => {\n      if (closed) return\n      closed = true\n      clearTimeout(debounceTimer)\n      watcher.close()\n    },\n  }\n}\n"],"names":["watch","basename","dirname","findProjectRoot","subdebug","canonicalizeWatchDir","devDebug","DEBOUNCE_MS","startDevManifestWatcher","extract","extraWatchFilenames","output","update","workDir","projectRoot","configPath","path","running","pending","closed","regenerate","configs","interfaces","manifest","manifestUpdatedAt","Date","toISOString","err","warn","Error","message","String","configDir","watchFilenames","Set","debounceTimer","onEvent","_event","filename","name","toString","has","clearTimeout","setTimeout","watcher","on","close"],"mappings":"AAAA,SAAQA,KAAK,QAAO,UAAS;AAC7B,SAAQC,QAAQ,EAAEC,OAAO,QAAO,YAAW;AAE3C,SAAQC,eAAe,EAAeC,QAAQ,QAAO,mBAAkB;AAEvE,SAAQC,oBAAoB,QAAO,4BAA2B;AAG9D,MAAMC,WAAWF,SAAS;AAE1B;;;;CAIC,GACD,MAAMG,cAAc;AAoDpB;;;;;;;;;;;;;CAaC,GACD,OAAO,eAAeC,wBAA2B,EAC/CC,OAAO,EACPC,mBAAmB,EACnBC,MAAM,EACNC,MAAM,EACNC,OAAO,EAC2B;IAClC,MAAMC,cAAc,MAAMX,gBAAgBU;IAC1C,MAAME,aAAaD,YAAYE,IAAI;IAEnC,IAAIC,UAAU;IACd,IAAIC,UAAU;IACd,IAAIC,SAAS;IAEb,MAAMC,aAAa;QACjB,IAAID,QAAQ;QACZ,IAAIF,SAAS;YACXC,UAAU;YACV;QACF;QACAD,UAAU;QACV,IAAI;YACF,MAAM,EAACI,OAAO,EAAEC,UAAU,EAAEC,QAAQ,EAAC,GAAG,MAAMd,QAAQ;gBAACM;gBAAYF;YAAO;YAC1E,IAAIM,QAAQ;YACZ,MAAMP,OAAO;gBACXS;gBACAC;gBACAC;gBACAC,mBAAmB,IAAIC,OAAOC,WAAW;YAC3C;QACF,EAAE,OAAOC,KAAK;YACZ,qEAAqE;YACrE,iEAAiE;YACjErB,SAAS,oCAAoCqB;YAC7ChB,OAAOiB,IAAI,CACT,CAAC,0CAA0C,EAAED,eAAeE,QAAQF,IAAIG,OAAO,GAAGC,OAAOJ,MAAM;QAEnG,SAAU;YACRV,UAAU;YACV,IAAIC,WAAW,CAACC,QAAQ;gBACtBD,UAAU;gBACV,KAAKE;YACP;QACF;IACF;IAEA,wEAAwE;IACxE,yEAAyE;IACzE,mCAAmC;IACnC,KAAKA;IAEL,mEAAmE;IACnE,qEAAqE;IACrE,wEAAwE;IACxE,8DAA8D;IAC9D,4EAA4E;IAC5E,+CAA+C;IAC/C,MAAMY,YAAY3B,qBAAqBH,QAAQa;IAC/C,MAAMkB,iBAAiB,IAAIC,IAAI;QAACjC,SAASc;WAAiBL,uBAAuB,EAAE;KAAE;IAErF,IAAIyB;IAEJ,MAAMC,UAAU,CAACC,QAAgBC;QAC/B,IAAI,CAACA,UAAU;QACf,MAAMC,OAAO,OAAOD,aAAa,WAAWA,WAAWA,SAASE,QAAQ,CAAC;QACzE,IAAI,CAACP,eAAeQ,GAAG,CAACF,OAAO;QAC/BG,aAAaP;QACbA,gBAAgBQ,WAAW;YACzB,KAAKvB;QACP,GAAGb;IACL;IAEA,MAAMqC,UAAU5C,MAAMgC,WAAWI;IAEjCQ,QAAQC,EAAE,CAAC,SAAS,CAAClB;QACnBrB,SAAS,4BAA4BqB;QACrChB,OAAOiB,IAAI,CAAC,CAAC,wBAAwB,EAAED,eAAeE,QAAQF,IAAIG,OAAO,GAAGC,OAAOJ,MAAM;IAC3F;IAEA,OAAO;QACL,wEAAwE;QACxE,mEAAmE;QACnE,uCAAuC;QACvCmB,OAAO;YACL,IAAI3B,QAAQ;YACZA,SAAS;YACTuB,aAAaP;YACbS,QAAQE,KAAK;QACf;IACF;AACF"}

package/dist/actions/dev/startDevServerRegistration.js

@@ -1,7 +1,8 @@
 import { getCliConfigUncached } from '@sanity/cli-core';
 import { resolveAppId } from '../../appId.js';
+import { deriveInterfaces } from '../../deriveInterfaces.js';
 import { formatWorkbenchAppErrors, validateWorkbenchApp } from '../../validateWorkbenchApp.js';
-import { deriveConfigs, deriveInterfaces } from './deriveInterfaces.js';
+import { deriveConfigs } from './deriveConfigs.js';
 import { trackExposesSet } from './exposesSetId.js';
 import { registerDevServer } from './registry.js';
 import { startDevManifestWatcher } from './startDevManifestWatcher.js';

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

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/actions/dev/startDevServerRegistration.ts"],"sourcesContent":["import {type CliConfig, getCliConfigUncached, type Output} from '@sanity/cli-core'\nimport {type ViteDevServer} from 'vite'\n\nimport {resolveAppId} from '../../appId.js'\nimport {formatWorkbenchAppErrors, validateWorkbenchApp} from '../../validateWorkbenchApp.js'\nimport {deriveConfigs, deriveInterfaces} from './deriveInterfaces.js'\nimport {trackExposesSet} from './exposesSetId.js'\nimport {type DevServerManifest, registerDevServer} from './registry.js'\nimport {startDevManifestWatcher} from './startDevManifestWatcher.js'\n\ninterface DevServerRegistrationOptions {\n  cliConfig: CliConfig\n  /**\n   * Extract the project manifest to inline into the registry. The caller owns the\n   * studio-vs-app split (manifest formats are CLI-domain); registration re-derives\n   * the interface set alongside it.\n   */\n  extractManifest: (params: {\n    configPath: string\n    workDir: string\n  }) => Promise<DevServerManifest['manifest']>\n  isApp: boolean\n  output: Output\n  server: ViteDevServer\n  workDir: string\n\n  /**\n   * Rebuild the app's federation remote when its interface set changes, awaited\n   * *before* the registry patch — the patch reloads the workbench page, which must\n   * re-fetch a remote that already exposes the new interface. Resolves with the\n   * recreated server so the entry gets its actual address (non-strict ports may\n   * shift it); must reject if the restart produces no server, so the set stays\n   * uncommitted and the next save retries instead of advertising a dead port.\n   */\n  onInterfaceSetChange?: () => Promise<ViteDevServer>\n}\n\ninterface DevServerRegistrationHandle {\n  close: () => Promise<void>\n}\n\n/**\n * Log any config validation errors without aborting. Unlike build and deploy,\n * dev stays up on an invalid config so the author sees the errors and fixes them\n * live on the next save.\n */\nfunction reportConfigErrors(app: CliConfig['app'], output: Output): void {\n  const errors = validateWorkbenchApp(app)\n  if (errors.length === 0) return\n  // `output.error` exits the process; `warn` keeps the dev server alive.\n  output.warn(formatWorkbenchAppErrors(errors))\n}\n\n/** The address the server actually bound — the live socket, which can differ from the configured port under non-strict ports. */\nfunction serverAddress(server: ViteDevServer) {\n  const resolvedHost = server.config.server.host\n  const addr = server.httpServer?.address()\n  return {\n    host: typeof resolvedHost === 'string' ? resolvedHost : 'localhost',\n    port: typeof addr === 'object' && addr ? addr.port : server.config.server.port,\n  }\n}\n\n/**\n * Register the dev server in the registry and watch its config for manifest +\n * interface changes. The workbench reads the entry to locate and render the\n * server; the watcher keeps it current as `sanity.cli.ts` is edited.\n */\nexport async function startDevServerRegistration(\n  options: DevServerRegistrationOptions,\n): Promise<DevServerRegistrationHandle> {\n  const {cliConfig, extractManifest, isApp, onInterfaceSetChange, output, server, workDir} = options\n\n  const {host: appHost, port: appPort} = serverAddress(server)\n\n  reportConfigErrors(cliConfig.app, output)\n\n  // Forwarded alongside (not inside) the manifest so the workbench renders local\n  // panels/workers and reads the configs without a deploy.\n  const interfaces = deriveInterfaces(cliConfig.app, {isApp})\n  const configs = await deriveConfigs(cliConfig.app)\n\n  const registration = registerDevServer({\n    configs,\n    host: appHost,\n    // Keyed by where it's served (not the deployment id), so a running app can't\n    // collide with its deployed twin — on the configured port, not the bound one,\n    // to match `__SANITY_APP_ID__`, compiled before any non-strict shift.\n    id: resolveAppId({host: appHost, port: server.config.server.port ?? appPort}),\n    interfaces,\n    port: appPort,\n    projectId: cliConfig?.api?.projectId,\n    type: isApp ? 'coreApp' : 'studio',\n    workDir,\n  })\n\n  const exposesSet = trackExposesSet({configs, interfaces})\n\n  const watcher = await startDevManifestWatcher({\n    // Re-derive every pass (don't omit): the registry patch is a shallow merge,\n    // so omitting would wipe the registered set.\n    extract: async (params) => {\n      const app = (await getCliConfigUncached(params.workDir)).app\n      reportConfigErrors(app, output)\n      return {\n        configs: await deriveConfigs(app),\n        interfaces: deriveInterfaces(app, {isApp}),\n        manifest: await extractManifest(params),\n      }\n    },\n    // A studio's root resolves to `sanity.config.*` but its interfaces live in\n    // `sanity.cli.*` — watch that too. Apps already root at `sanity.cli.*`.\n    extraWatchFilenames: isApp ? undefined : ['sanity.cli.js', 'sanity.cli.ts'],\n    output,\n    update: async (patch) => {\n      if (\n        !exposesSet.changed({\n          configs: patch.configs,\n          interfaces: patch.interfaces,\n        })\n      ) {\n        registration.update(patch)\n        return\n      }\n      // Rebuild the remote *before* patching the registry — the patch reloads the\n      // page, which must re-fetch a remote that already exposes the new interface.\n      const rebuiltServer = await onInterfaceSetChange?.()\n      // Commit only after a successful rebuild, so a thrown one retries next pass.\n      exposesSet.commit({\n        configs: patch.configs,\n        interfaces: patch.interfaces,\n      })\n      // The recreated server can bind a different port (non-strict ports).\n      registration.update(rebuiltServer ? {...patch, ...serverAddress(rebuiltServer)} : patch)\n    },\n    workDir,\n  })\n\n  return {\n    close: async () => {\n      registration.release()\n      await watcher.close()\n    },\n  }\n}\n"],"names":["getCliConfigUncached","resolveAppId","formatWorkbenchAppErrors","validateWorkbenchApp","deriveConfigs","deriveInterfaces","trackExposesSet","registerDevServer","startDevManifestWatcher","reportConfigErrors","app","output","errors","length","warn","serverAddress","server","resolvedHost","config","host","addr","httpServer","address","port","startDevServerRegistration","options","cliConfig","extractManifest","isApp","onInterfaceSetChange","workDir","appHost","appPort","interfaces","configs","registration","id","projectId","api","type","exposesSet","watcher","extract","params","manifest","extraWatchFilenames","undefined","update","patch","changed","rebuiltServer","commit","close","release"],"mappings":"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"}
+{"version":3,"sources":["../../../src/actions/dev/startDevServerRegistration.ts"],"sourcesContent":["import {type CliConfig, getCliConfigUncached, type Output} from '@sanity/cli-core'\nimport {type ViteDevServer} from 'vite'\n\nimport {resolveAppId} from '../../appId.js'\nimport {deriveInterfaces} from '../../deriveInterfaces.js'\nimport {formatWorkbenchAppErrors, validateWorkbenchApp} from '../../validateWorkbenchApp.js'\nimport {deriveConfigs} from './deriveConfigs.js'\nimport {trackExposesSet} from './exposesSetId.js'\nimport {type DevServerManifest, registerDevServer} from './registry.js'\nimport {startDevManifestWatcher} from './startDevManifestWatcher.js'\n\ninterface DevServerRegistrationOptions {\n  cliConfig: CliConfig\n  /**\n   * Extract the project manifest to inline into the registry. The caller owns the\n   * studio-vs-app split (manifest formats are CLI-domain); registration re-derives\n   * the interface set alongside it.\n   */\n  extractManifest: (params: {\n    configPath: string\n    workDir: string\n  }) => Promise<DevServerManifest['manifest']>\n  isApp: boolean\n  output: Output\n  server: ViteDevServer\n  workDir: string\n\n  /**\n   * Rebuild the app's federation remote when its interface set changes, awaited\n   * *before* the registry patch — the patch reloads the workbench page, which must\n   * re-fetch a remote that already exposes the new interface. Resolves with the\n   * recreated server so the entry gets its actual address (non-strict ports may\n   * shift it); must reject if the restart produces no server, so the set stays\n   * uncommitted and the next save retries instead of advertising a dead port.\n   */\n  onInterfaceSetChange?: () => Promise<ViteDevServer>\n}\n\ninterface DevServerRegistrationHandle {\n  close: () => Promise<void>\n}\n\n/**\n * Log any config validation errors without aborting. Unlike build and deploy,\n * dev stays up on an invalid config so the author sees the errors and fixes them\n * live on the next save.\n */\nfunction reportConfigErrors(app: CliConfig['app'], output: Output): void {\n  const errors = validateWorkbenchApp(app)\n  if (errors.length === 0) return\n  // `output.error` exits the process; `warn` keeps the dev server alive.\n  output.warn(formatWorkbenchAppErrors(errors))\n}\n\n/** The address the server actually bound — the live socket, which can differ from the configured port under non-strict ports. */\nfunction serverAddress(server: ViteDevServer) {\n  const resolvedHost = server.config.server.host\n  const addr = server.httpServer?.address()\n  return {\n    host: typeof resolvedHost === 'string' ? resolvedHost : 'localhost',\n    port: typeof addr === 'object' && addr ? addr.port : server.config.server.port,\n  }\n}\n\n/**\n * Register the dev server in the registry and watch its config for manifest +\n * interface changes. The workbench reads the entry to locate and render the\n * server; the watcher keeps it current as `sanity.cli.ts` is edited.\n */\nexport async function startDevServerRegistration(\n  options: DevServerRegistrationOptions,\n): Promise<DevServerRegistrationHandle> {\n  const {cliConfig, extractManifest, isApp, onInterfaceSetChange, output, server, workDir} = options\n\n  const {host: appHost, port: appPort} = serverAddress(server)\n\n  reportConfigErrors(cliConfig.app, output)\n\n  // Forwarded alongside (not inside) the manifest so the workbench renders local\n  // panels/workers and reads the configs without a deploy.\n  const interfaces = deriveInterfaces(cliConfig.app, {isApp})\n  const configs = await deriveConfigs(cliConfig.app)\n\n  const registration = registerDevServer({\n    configs,\n    host: appHost,\n    // Keyed by where it's served (not the deployment id), so a running app can't\n    // collide with its deployed twin — on the configured port, not the bound one,\n    // to match `__SANITY_APP_ID__`, compiled before any non-strict shift.\n    id: resolveAppId({host: appHost, port: server.config.server.port ?? appPort}),\n    interfaces,\n    port: appPort,\n    projectId: cliConfig?.api?.projectId,\n    type: isApp ? 'coreApp' : 'studio',\n    workDir,\n  })\n\n  const exposesSet = trackExposesSet({configs, interfaces})\n\n  const watcher = await startDevManifestWatcher({\n    // Re-derive every pass (don't omit): the registry patch is a shallow merge,\n    // so omitting would wipe the registered set.\n    extract: async (params) => {\n      const app = (await getCliConfigUncached(params.workDir)).app\n      reportConfigErrors(app, output)\n      return {\n        configs: await deriveConfigs(app),\n        interfaces: deriveInterfaces(app, {isApp}),\n        manifest: await extractManifest(params),\n      }\n    },\n    // A studio's root resolves to `sanity.config.*` but its interfaces live in\n    // `sanity.cli.*` — watch that too. Apps already root at `sanity.cli.*`.\n    extraWatchFilenames: isApp ? undefined : ['sanity.cli.js', 'sanity.cli.ts'],\n    output,\n    update: async (patch) => {\n      if (\n        !exposesSet.changed({\n          configs: patch.configs,\n          interfaces: patch.interfaces,\n        })\n      ) {\n        registration.update(patch)\n        return\n      }\n      // Rebuild the remote *before* patching the registry — the patch reloads the\n      // page, which must re-fetch a remote that already exposes the new interface.\n      const rebuiltServer = await onInterfaceSetChange?.()\n      // Commit only after a successful rebuild, so a thrown one retries next pass.\n      exposesSet.commit({\n        configs: patch.configs,\n        interfaces: patch.interfaces,\n      })\n      // The recreated server can bind a different port (non-strict ports).\n      registration.update(rebuiltServer ? {...patch, ...serverAddress(rebuiltServer)} : patch)\n    },\n    workDir,\n  })\n\n  return {\n    close: async () => {\n      registration.release()\n      await watcher.close()\n    },\n  }\n}\n"],"names":["getCliConfigUncached","resolveAppId","deriveInterfaces","formatWorkbenchAppErrors","validateWorkbenchApp","deriveConfigs","trackExposesSet","registerDevServer","startDevManifestWatcher","reportConfigErrors","app","output","errors","length","warn","serverAddress","server","resolvedHost","config","host","addr","httpServer","address","port","startDevServerRegistration","options","cliConfig","extractManifest","isApp","onInterfaceSetChange","workDir","appHost","appPort","interfaces","configs","registration","id","projectId","api","type","exposesSet","watcher","extract","params","manifest","extraWatchFilenames","undefined","update","patch","changed","rebuiltServer","commit","close","release"],"mappings":"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"}

package/dist/actions/init/cliConfig.js

@@ -2,14 +2,13 @@
 // consumed by the CLI's `init` scaffolding. The branded `unstable_defineApp`
 // result is the sole workbench (module-federation) opt-in, so its config shape
 // is workbench's to own; the CLI keeps the non-workbench templates and the
-// `%placeholder%` substitution. `%name%`/`%title%`/etc. are filled in by the
+// `%placeholder%` substitution. `%slug%`/`%title%`/etc. are filled in by the
 // CLI's template processor.
 /** App scaffold — `entry` auto-declares the navigable app view. */ export const workbenchAppConfigTemplate = `
 import {defineCliConfig, unstable_defineApp} from 'sanity/cli'
 
 export default defineCliConfig({
   app: unstable_defineApp({
-    name: '%name%',
     title: '%title%',
     slug: '%slug%',
     organizationId: '%organizationId%',
@@ -18,7 +17,7 @@ export default defineCliConfig({
 })
 `;
 /**
- * Studio scaffold — brands with name/title only, no `entry` (studio app views
+ * Studio scaffold — brands with slug/title only, no `entry` (studio app views
  * aren't implemented yet).
  */ export const workbenchStudioConfigTemplate = `
 import {defineCliConfig, unstable_defineApp} from 'sanity/cli'
@@ -29,7 +28,6 @@ export default defineCliConfig({
     dataset: '%dataset%'
   },
   app: unstable_defineApp({
-    name: '%name%',
     title: '%title%',
     slug: '%slug%',
     organizationId: '%organizationId%',

package/dist/actions/init/cliConfig.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/actions/init/cliConfig.ts"],"sourcesContent":["// `sanity.cli.ts` templates for workbench (`unstable_defineApp`) projects,\n// consumed by the CLI's `init` scaffolding. The branded `unstable_defineApp`\n// result is the sole workbench (module-federation) opt-in, so its config shape\n// is workbench's to own; the CLI keeps the non-workbench templates and the\n// `%placeholder%` substitution. `%name%`/`%title%`/etc. are filled in by the\n// CLI's template processor.\n\n/** App scaffold — `entry` auto-declares the navigable app view. */\nexport const workbenchAppConfigTemplate = `\nimport {defineCliConfig, unstable_defineApp} from 'sanity/cli'\n\nexport default defineCliConfig({\n  app: unstable_defineApp({\n    name: '%name%',\n    title: '%title%',\n    slug: '%slug%',\n    organizationId: '%organizationId%',\n    entry: '%entry%',\n  }),\n})\n`\n\n/**\n * Studio scaffold — brands with name/title only, no `entry` (studio app views\n * aren't implemented yet).\n */\nexport const workbenchStudioConfigTemplate = `\nimport {defineCliConfig, unstable_defineApp} from 'sanity/cli'\n\nexport default defineCliConfig({\n  api: {\n    projectId: '%projectId%',\n    dataset: '%dataset%'\n  },\n  app: unstable_defineApp({\n    name: '%name%',\n    title: '%title%',\n    slug: '%slug%',\n    organizationId: '%organizationId%',\n  }),\n  deployment: {\n    /**\n     * Enable auto-updates for studios.\n     * Learn more at https://www.sanity.io/docs/studio/latest-version-of-sanity#k47faf43faf56\n     */\n    autoUpdates: __BOOL__autoUpdates__,\n  },\n})\n`\n"],"names":["workbenchAppConfigTemplate","workbenchStudioConfigTemplate"],"mappings":"AAAA,2EAA2E;AAC3E,6EAA6E;AAC7E,+EAA+E;AAC/E,2EAA2E;AAC3E,6EAA6E;AAC7E,4BAA4B;AAE5B,iEAAiE,GACjE,OAAO,MAAMA,6BAA6B,CAAC;;;;;;;;;;;;AAY3C,CAAC,CAAA;AAED;;;CAGC,GACD,OAAO,MAAMC,gCAAgC,CAAC;;;;;;;;;;;;;;;;;;;;;;AAsB9C,CAAC,CAAA"}
+{"version":3,"sources":["../../../src/actions/init/cliConfig.ts"],"sourcesContent":["// `sanity.cli.ts` templates for workbench (`unstable_defineApp`) projects,\n// consumed by the CLI's `init` scaffolding. The branded `unstable_defineApp`\n// result is the sole workbench (module-federation) opt-in, so its config shape\n// is workbench's to own; the CLI keeps the non-workbench templates and the\n// `%placeholder%` substitution. `%slug%`/`%title%`/etc. are filled in by the\n// CLI's template processor.\n\n/** App scaffold — `entry` auto-declares the navigable app view. */\nexport const workbenchAppConfigTemplate = `\nimport {defineCliConfig, unstable_defineApp} from 'sanity/cli'\n\nexport default defineCliConfig({\n  app: unstable_defineApp({\n    title: '%title%',\n    slug: '%slug%',\n    organizationId: '%organizationId%',\n    entry: '%entry%',\n  }),\n})\n`\n\n/**\n * Studio scaffold — brands with slug/title only, no `entry` (studio app views\n * aren't implemented yet).\n */\nexport const workbenchStudioConfigTemplate = `\nimport {defineCliConfig, unstable_defineApp} from 'sanity/cli'\n\nexport default defineCliConfig({\n  api: {\n    projectId: '%projectId%',\n    dataset: '%dataset%'\n  },\n  app: unstable_defineApp({\n    title: '%title%',\n    slug: '%slug%',\n    organizationId: '%organizationId%',\n  }),\n  deployment: {\n    /**\n     * Enable auto-updates for studios.\n     * Learn more at https://www.sanity.io/docs/studio/latest-version-of-sanity#k47faf43faf56\n     */\n    autoUpdates: __BOOL__autoUpdates__,\n  },\n})\n`\n"],"names":["workbenchAppConfigTemplate","workbenchStudioConfigTemplate"],"mappings":"AAAA,2EAA2E;AAC3E,6EAA6E;AAC7E,+EAA+E;AAC/E,2EAA2E;AAC3E,6EAA6E;AAC7E,4BAA4B;AAE5B,iEAAiE,GACjE,OAAO,MAAMA,6BAA6B,CAAC;;;;;;;;;;;AAW3C,CAAC,CAAA;AAED;;;CAGC,GACD,OAAO,MAAMC,gCAAgC,CAAC;;;;;;;;;;;;;;;;;;;;;AAqB9C,CAAC,CAAA"}

package/dist/actions/preview/startWorkbenchPreview.js

@@ -3,9 +3,10 @@ import path from 'node:path';
 import { styleText } from 'node:util';
 import { findProjectRoot } from '@sanity/cli-core';
 import { buildAppId, SANITY_APP_ID_FILE } from '../../appId.js';
+import { deriveInterfaces } from '../../deriveInterfaces.js';
 import { resolveWorkbenchApp } from '../../resolveWorkbenchApp.js';
 import { createServerLifecycle, toDisplayHost } from '../../util/serverOrchestration.js';
-import { deriveConfigs, deriveInterfaces } from '../dev/deriveInterfaces.js';
+import { deriveConfigs } from '../dev/deriveConfigs.js';
 import { registerDevServer } from '../dev/registry.js';
 import { startWorkbenchDevServer } from '../dev/startWorkbenchDevServer.js';
 import { serveBuiltApplication } from './serveBuiltApplication.js';

package/dist/actions/preview/startWorkbenchPreview.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/actions/preview/startWorkbenchPreview.ts"],"sourcesContent":["import {readFile} from 'node:fs/promises'\nimport path from 'node:path'\nimport {styleText} from 'node:util'\n\nimport {type CliConfig, findProjectRoot, type Output} from '@sanity/cli-core'\n\nimport {buildAppId, SANITY_APP_ID_FILE} from '../../appId.js'\nimport {resolveWorkbenchApp} from '../../resolveWorkbenchApp.js'\nimport {createServerLifecycle, toDisplayHost} from '../../util/serverOrchestration.js'\nimport {deriveConfigs, deriveInterfaces} from '../dev/deriveInterfaces.js'\nimport {type DevServerManifest, registerDevServer} from '../dev/registry.js'\nimport {startWorkbenchDevServer} from '../dev/startWorkbenchDevServer.js'\nimport {serveBuiltApplication} from './serveBuiltApplication.js'\n\nexport interface StartWorkbenchPreviewOptions {\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\n  httpPort: number\n  isApp: boolean\n  /** The built `dist` directory to serve as the federation remote. */\n  outDir: string\n  output: Output\n  reactStrictMode: boolean\n  workDir: string\n}\n\n/**\n * `sanity start` for a workbench app: serve a production build the way dev serves\n * a live one. The same singleton workbench shell renders it and the same registry\n * advertises it — only the remote differs, static files from the build output\n * instead of a live Vite dev server. There's no config watcher or rebuild: a\n * build is fixed, so nothing re-syncs.\n *\n * A running workbench claims the configured port, so the built remote binds the\n * next one. Without one the remote takes the configured port and announces its\n * own URL.\n */\nexport async function startWorkbenchPreview(\n  options: StartWorkbenchPreviewOptions,\n): Promise<{close: () => Promise<void>}> {\n  const {\n    cacheDir,\n    checkForDeprecatedAppId,\n    cliConfig,\n    extractManifest,\n    httpHost,\n    httpPort,\n    isApp,\n    outDir,\n    output,\n    reactStrictMode,\n    workDir,\n  } = options\n\n  const {close, closers, installSignalHandlers} = createServerLifecycle()\n\n  const workbench = await startWorkbenchDevServer({\n    cacheDir,\n    cliConfig,\n    httpHost,\n    httpPort,\n    mode: 'preview',\n    output,\n    reactStrictMode,\n    workDir,\n  })\n  closers.push(workbench.close)\n\n  const remotePort = workbench.workbenchAvailable ? workbench.workbenchPort + 1 : httpPort\n\n  const remote = await serveBuiltApplication({\n    cacheDir,\n    httpHost,\n    httpPort: remotePort,\n    outDir,\n    workDir,\n  }).catch(async (err) => {\n    await close()\n    throw err\n  })\n  closers.push(remote.close)\n\n  try {\n    // Callers provide CLI-only validation and manifest extraction to keep them\n    // out of workbench-cli.\n    checkForDeprecatedAppId()\n    const configPath = (await findProjectRoot(workDir)).path\n    const workbench = resolveWorkbenchApp(cliConfig)\n    // Read the id the build inlined so start matches it even for a deploy build\n    // (which carries the API id, not the shape hash); fall back for older builds.\n    const inlinedId = await readInlinedAppId(outDir)\n    const configs = await deriveConfigs(cliConfig.app)\n    // `start` serves a build, so it advertises the build's inlined id (matching\n    // the bundle's `__SANITY_APP_ID__`), not the dev host-port.\n    const id = workbench\n      ? (inlinedId ?? (await buildAppId(workbench)))\n      : `${remote.host}-${remote.port}`\n    const registration = registerDevServer({\n      configs,\n      host: remote.host,\n      id,\n      interfaces: deriveInterfaces(cliConfig.app, {isApp}),\n      manifest: await extractManifest({configPath, workDir}),\n      manifestUpdatedAt: new Date().toISOString(),\n      port: remote.port,\n      projectId: cliConfig?.api?.projectId,\n      type: isApp ? 'coreApp' : 'studio',\n      workDir,\n    })\n    closers.push(async () => registration.release())\n  } catch (err) {\n    await close()\n    throw err\n  }\n\n  if (workbench.workbenchAvailable) {\n    const workbenchUrl = `http://${toDisplayHost(workbench.httpHost)}:${workbench.workbenchPort}`\n    output.log(\n      `Workbench preview server started at ${styleText(['blue', 'underline'], workbenchUrl)} (serving build on port ${remote.port})`,\n    )\n  } else {\n    const remoteUrl = `http://${toDisplayHost(remote.host)}:${remote.port}`\n    output.log(`Serving build at ${styleText(['blue', 'underline'], remoteUrl)}`)\n  }\n\n  installSignalHandlers()\n\n  return {close}\n}\n\n/** The id the build inlined into its bundle, or undefined when absent. */\nasync function readInlinedAppId(outDir: string): Promise<string | undefined> {\n  try {\n    return (await readFile(path.join(outDir, SANITY_APP_ID_FILE), 'utf8')).trim() || undefined\n  } catch {\n    return undefined\n  }\n}\n"],"names":["readFile","path","styleText","findProjectRoot","buildAppId","SANITY_APP_ID_FILE","resolveWorkbenchApp","createServerLifecycle","toDisplayHost","deriveConfigs","deriveInterfaces","registerDevServer","startWorkbenchDevServer","serveBuiltApplication","startWorkbenchPreview","options","cacheDir","checkForDeprecatedAppId","cliConfig","extractManifest","httpHost","httpPort","isApp","outDir","output","reactStrictMode","workDir","close","closers","installSignalHandlers","workbench","mode","push","remotePort","workbenchAvailable","workbenchPort","remote","catch","err","configPath","inlinedId","readInlinedAppId","configs","app","id","host","port","registration","interfaces","manifest","manifestUpdatedAt","Date","toISOString","projectId","api","type","release","workbenchUrl","log","remoteUrl","join","trim","undefined"],"mappings":"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"}
+{"version":3,"sources":["../../../src/actions/preview/startWorkbenchPreview.ts"],"sourcesContent":["import {readFile} from 'node:fs/promises'\nimport path from 'node:path'\nimport {styleText} from 'node:util'\n\nimport {type CliConfig, findProjectRoot, type Output} from '@sanity/cli-core'\n\nimport {buildAppId, SANITY_APP_ID_FILE} from '../../appId.js'\nimport {deriveInterfaces} from '../../deriveInterfaces.js'\nimport {resolveWorkbenchApp} from '../../resolveWorkbenchApp.js'\nimport {createServerLifecycle, toDisplayHost} from '../../util/serverOrchestration.js'\nimport {deriveConfigs} from '../dev/deriveConfigs.js'\nimport {type DevServerManifest, registerDevServer} from '../dev/registry.js'\nimport {startWorkbenchDevServer} from '../dev/startWorkbenchDevServer.js'\nimport {serveBuiltApplication} from './serveBuiltApplication.js'\n\nexport interface StartWorkbenchPreviewOptions {\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\n  httpPort: number\n  isApp: boolean\n  /** The built `dist` directory to serve as the federation remote. */\n  outDir: string\n  output: Output\n  reactStrictMode: boolean\n  workDir: string\n}\n\n/**\n * `sanity start` for a workbench app: serve a production build the way dev serves\n * a live one. The same singleton workbench shell renders it and the same registry\n * advertises it — only the remote differs, static files from the build output\n * instead of a live Vite dev server. There's no config watcher or rebuild: a\n * build is fixed, so nothing re-syncs.\n *\n * A running workbench claims the configured port, so the built remote binds the\n * next one. Without one the remote takes the configured port and announces its\n * own URL.\n */\nexport async function startWorkbenchPreview(\n  options: StartWorkbenchPreviewOptions,\n): Promise<{close: () => Promise<void>}> {\n  const {\n    cacheDir,\n    checkForDeprecatedAppId,\n    cliConfig,\n    extractManifest,\n    httpHost,\n    httpPort,\n    isApp,\n    outDir,\n    output,\n    reactStrictMode,\n    workDir,\n  } = options\n\n  const {close, closers, installSignalHandlers} = createServerLifecycle()\n\n  const workbench = await startWorkbenchDevServer({\n    cacheDir,\n    cliConfig,\n    httpHost,\n    httpPort,\n    mode: 'preview',\n    output,\n    reactStrictMode,\n    workDir,\n  })\n  closers.push(workbench.close)\n\n  const remotePort = workbench.workbenchAvailable ? workbench.workbenchPort + 1 : httpPort\n\n  const remote = await serveBuiltApplication({\n    cacheDir,\n    httpHost,\n    httpPort: remotePort,\n    outDir,\n    workDir,\n  }).catch(async (err) => {\n    await close()\n    throw err\n  })\n  closers.push(remote.close)\n\n  try {\n    // Callers provide CLI-only validation and manifest extraction to keep them\n    // out of workbench-cli.\n    checkForDeprecatedAppId()\n    const configPath = (await findProjectRoot(workDir)).path\n    const workbench = resolveWorkbenchApp(cliConfig)\n    // Read the id the build inlined so start matches it even for a deploy build\n    // (which carries the API id, not the shape hash); fall back for older builds.\n    const inlinedId = await readInlinedAppId(outDir)\n    const configs = await deriveConfigs(cliConfig.app)\n    // `start` serves a build, so it advertises the build's inlined id (matching\n    // the bundle's `__SANITY_APP_ID__`), not the dev host-port.\n    const id = workbench\n      ? (inlinedId ?? (await buildAppId(workbench)))\n      : `${remote.host}-${remote.port}`\n    const registration = registerDevServer({\n      configs,\n      host: remote.host,\n      id,\n      interfaces: deriveInterfaces(cliConfig.app, {isApp}),\n      manifest: await extractManifest({configPath, workDir}),\n      manifestUpdatedAt: new Date().toISOString(),\n      port: remote.port,\n      projectId: cliConfig?.api?.projectId,\n      type: isApp ? 'coreApp' : 'studio',\n      workDir,\n    })\n    closers.push(async () => registration.release())\n  } catch (err) {\n    await close()\n    throw err\n  }\n\n  if (workbench.workbenchAvailable) {\n    const workbenchUrl = `http://${toDisplayHost(workbench.httpHost)}:${workbench.workbenchPort}`\n    output.log(\n      `Workbench preview server started at ${styleText(['blue', 'underline'], workbenchUrl)} (serving build on port ${remote.port})`,\n    )\n  } else {\n    const remoteUrl = `http://${toDisplayHost(remote.host)}:${remote.port}`\n    output.log(`Serving build at ${styleText(['blue', 'underline'], remoteUrl)}`)\n  }\n\n  installSignalHandlers()\n\n  return {close}\n}\n\n/** The id the build inlined into its bundle, or undefined when absent. */\nasync function readInlinedAppId(outDir: string): Promise<string | undefined> {\n  try {\n    return (await readFile(path.join(outDir, SANITY_APP_ID_FILE), 'utf8')).trim() || undefined\n  } catch {\n    return undefined\n  }\n}\n"],"names":["readFile","path","styleText","findProjectRoot","buildAppId","SANITY_APP_ID_FILE","deriveInterfaces","resolveWorkbenchApp","createServerLifecycle","toDisplayHost","deriveConfigs","registerDevServer","startWorkbenchDevServer","serveBuiltApplication","startWorkbenchPreview","options","cacheDir","checkForDeprecatedAppId","cliConfig","extractManifest","httpHost","httpPort","isApp","outDir","output","reactStrictMode","workDir","close","closers","installSignalHandlers","workbench","mode","push","remotePort","workbenchAvailable","workbenchPort","remote","catch","err","configPath","inlinedId","readInlinedAppId","configs","app","id","host","port","registration","interfaces","manifest","manifestUpdatedAt","Date","toISOString","projectId","api","type","release","workbenchUrl","log","remoteUrl","join","trim","undefined"],"mappings":"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"}

package/dist/actions/undeploy/workbenchUndeployAdapter.js

@@ -1,7 +1,7 @@
 import { deleteApplication, getApplication, getApplicationUrl, getWorkbenchUrl } from '../../services/applications.js';
 import { deleteConfig, listConfigs } from '../../services/installations.js';
-import { summarizeExposes } from '../deploy/buildExposes.js';
 import { resolveInstallationId, summarizeConfig } from '../deploy/deployConfig.js';
+import { summarizeInterfaces } from '../deploy/summarizeInterfaces.js';
 /**
  * The undeploy adapter for workbench apps, mirroring what a workbench deploy
  * creates: apps that expose interfaces delete their Brett application (the
@@ -58,7 +58,7 @@ async function resolveApplicationTarget({ appId, type, workbench }) {
             type: 'none'
         };
     }
-    const { exposes, lines } = summarizeExposes(workbench);
+    const { exposes, lines } = summarizeInterfaces(workbench);
     return {
         target: {
             activeDeployment: null,
@@ -138,7 +138,7 @@ async function resolveConfigTarget({ organizationId, workbench }) {
                 summary: config ? [
                     summarizeConfig(config)
                 ] : undefined,
-                title: workbench.name,
+                title: workbench.slug,
                 type: 'coreApp',
                 url: getWorkbenchUrl(organizationId)
             },

package/dist/actions/undeploy/workbenchUndeployAdapter.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/actions/undeploy/workbenchUndeployAdapter.ts"],"sourcesContent":["import {\n  type UndeployAdapter,\n  type UndeployApplicationTarget,\n  type UndeployConfigTarget,\n  type UndeployTargetResolution,\n} from '@sanity/cli-core/undeploy'\n\nimport {\n  deleteApplication,\n  getApplication,\n  getApplicationUrl,\n  getWorkbenchUrl,\n} from '../../services/applications.js'\nimport {deleteConfig, listConfigs} from '../../services/installations.js'\nimport {type DeployedExpose, summarizeExposes} from '../deploy/buildExposes.js'\nimport {resolveInstallationId, summarizeConfig} from '../deploy/deployConfig.js'\nimport {type DeployableWorkbenchApp} from '../deploy/getWorkbench.js'\n\n/** The workbench extension of the shared target; serializes into `--json` as-is. */\nexport type WorkbenchUndeployTarget =\n  | (UndeployApplicationTarget & {\n      /** Interfaces (views and services) registered by the application. */\n      interfaces: DeployedExpose[]\n    })\n  | (UndeployConfigTarget & {\n      /** The deployed config snapshots an undeploy deletes. */\n      configs: {\n        createdAt: string | null\n        deployedBy: string | null\n        id: string\n      }[]\n    })\n\n/**\n * The undeploy adapter for workbench apps, mirroring what a workbench deploy\n * creates: apps that expose interfaces delete their Brett application (the\n * server soft-deletes its deployments and refuses singletons with active\n * installations); a singleton without interfaces — the media library — deletes\n * its installation's config snapshots instead.\n */\nexport function createWorkbenchUndeployAdapter(options: {\n  appId: string | undefined\n  organizationId: string | undefined\n  type: 'coreApp' | 'studio'\n  workbench: DeployableWorkbenchApp\n}): UndeployAdapter<WorkbenchUndeployTarget> {\n  const {appId, organizationId, type, workbench} = options\n  // Keyed on singleton-ness, not on a locally declared config, so an undeploy\n  // still reaches the server's config snapshots after the fields are removed\n  // from sanity.cli.ts.\n  const configOnly = !!workbench.isSingleton && !workbench.hasInterfaces\n  // Workbench-internal, so kept off the reported target; resolveTarget stashes it for the delete.\n  let installationId: string | undefined\n\n  return {\n    resolveTarget: async () => {\n      if (!configOnly) return resolveApplicationTarget({appId, type, workbench})\n      const resolved = await resolveConfigTarget({organizationId, workbench})\n      installationId = resolved.installationId\n      return resolved.resolution\n    },\n    type,\n    async undeploy(target) {\n      if (target.deletes === 'config') {\n        if (!installationId) throw new Error('No installation resolved for the config undeploy')\n        for (const snapshot of target.configs) {\n          await deleteConfig(installationId, snapshot.id)\n        }\n        return\n      }\n      await deleteApplication(target.id)\n    },\n  }\n}\n\nasync function resolveApplicationTarget({\n  appId,\n  type,\n  workbench,\n}: {\n  appId: string | undefined\n  type: 'coreApp' | 'studio'\n  workbench: DeployableWorkbenchApp\n}): Promise<UndeployTargetResolution<WorkbenchUndeployTarget>> {\n  if (!appId) {\n    return {\n      message: 'No `deployment.appId` configured',\n      solution: 'Add `deployment.appId` to sanity.cli.ts',\n      type: 'none',\n    }\n  }\n\n  const application = await getApplication(appId)\n  if (!application) {\n    return {message: 'Application with the given ID does not exist', type: 'none'}\n  }\n\n  const {exposes, lines} = summarizeExposes(workbench)\n  return {\n    target: {\n      activeDeployment: null,\n      appHost: application.slug,\n      createdAt: null,\n      deletes: 'application',\n      id: application.id,\n      interfaces: exposes,\n      organizationId: application.organizationId,\n      projectId: null,\n      summary: [\n        ...lines,\n        ...(workbench.isSingleton === undefined ? [] : [`Singleton: ${workbench.isSingleton}`]),\n      ],\n      title: application.title,\n      type,\n      url: getApplicationUrl({...application, type}),\n    },\n    type: 'found',\n  }\n}\n\nasync function resolveConfigTarget({\n  organizationId,\n  workbench,\n}: {\n  organizationId: string | undefined\n  workbench: DeployableWorkbenchApp\n}): Promise<{\n  installationId?: string\n  resolution: UndeployTargetResolution<WorkbenchUndeployTarget>\n}> {\n  const config = workbench.config\n  const appType = config?.appType ?? workbench.applicationType\n  if (!appType) throw new Error('The app declares no app type to resolve its installation')\n  if (!organizationId) {\n    throw new Error(\n      'sanity.cli.ts does not contain an organization identifier (\"app.organizationId\"), which is required to resolve the installation',\n    )\n  }\n\n  const installationId = await resolveInstallationId({appType, organizationId})\n  if (!installationId) {\n    return {\n      resolution: {\n        message: `No active \"${appType}\" installation for organization \"${organizationId}\"`,\n        type: 'none',\n      },\n    }\n  }\n\n  const configs = await listConfigs(installationId)\n  if (configs.length === 0) {\n    return {\n      installationId,\n      resolution: {\n        message: `No deployed config for the \"${appType}\" installation`,\n        type: 'none',\n      },\n    }\n  }\n\n  // At most one snapshot is active (served); the rest are deactivated history.\n  const active = configs.find((snapshot) => snapshot.isActive)\n  return {\n    installationId,\n    resolution: {\n      target: {\n        activeDeployment: active\n          ? {deployedAt: active.createdAt ?? '', deployedBy: active.deployedBy ?? ''}\n          : null,\n        appHost: null,\n        configs: configs.map((snapshot) => ({\n          createdAt: snapshot.createdAt ?? null,\n          deployedBy: snapshot.deployedBy ?? null,\n          id: snapshot.id,\n        })),\n        createdAt: configs.at(-1)?.createdAt ?? null,\n        deletes: 'config',\n        id: null,\n        organizationId,\n        projectId: null,\n        summary: config ? [summarizeConfig(config)] : undefined,\n        title: workbench.name,\n        type: 'coreApp',\n        url: getWorkbenchUrl(organizationId),\n      },\n      type: 'found',\n    },\n  }\n}\n"],"names":["deleteApplication","getApplication","getApplicationUrl","getWorkbenchUrl","deleteConfig","listConfigs","summarizeExposes","resolveInstallationId","summarizeConfig","createWorkbenchUndeployAdapter","options","appId","organizationId","type","workbench","configOnly","isSingleton","hasInterfaces","installationId","resolveTarget","resolveApplicationTarget","resolved","resolveConfigTarget","resolution","undeploy","target","deletes","Error","snapshot","configs","id","message","solution","application","exposes","lines","activeDeployment","appHost","slug","createdAt","interfaces","projectId","summary","undefined","title","url","config","appType","applicationType","length","active","find","isActive","deployedAt","deployedBy","map","at","name"],"mappings":"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"}
+{"version":3,"sources":["../../../src/actions/undeploy/workbenchUndeployAdapter.ts"],"sourcesContent":["import {\n  type UndeployAdapter,\n  type UndeployApplicationTarget,\n  type UndeployConfigTarget,\n  type UndeployTargetResolution,\n} from '@sanity/cli-core/undeploy'\n\nimport {\n  deleteApplication,\n  getApplication,\n  getApplicationUrl,\n  getWorkbenchUrl,\n} from '../../services/applications.js'\nimport {deleteConfig, listConfigs} from '../../services/installations.js'\nimport {resolveInstallationId, summarizeConfig} from '../deploy/deployConfig.js'\nimport {type DeployableWorkbenchApp} from '../deploy/getWorkbench.js'\nimport {type DeployedExpose, summarizeInterfaces} from '../deploy/summarizeInterfaces.js'\n\n/** The workbench extension of the shared target; serializes into `--json` as-is. */\nexport type WorkbenchUndeployTarget =\n  | (UndeployApplicationTarget & {\n      /** Interfaces (views and services) registered by the application. */\n      interfaces: DeployedExpose[]\n    })\n  | (UndeployConfigTarget & {\n      /** The deployed config snapshots an undeploy deletes. */\n      configs: {\n        createdAt: string | null\n        deployedBy: string | null\n        id: string\n      }[]\n    })\n\n/**\n * The undeploy adapter for workbench apps, mirroring what a workbench deploy\n * creates: apps that expose interfaces delete their Brett application (the\n * server soft-deletes its deployments and refuses singletons with active\n * installations); a singleton without interfaces — the media library — deletes\n * its installation's config snapshots instead.\n */\nexport function createWorkbenchUndeployAdapter(options: {\n  appId: string | undefined\n  organizationId: string | undefined\n  type: 'coreApp' | 'studio'\n  workbench: DeployableWorkbenchApp\n}): UndeployAdapter<WorkbenchUndeployTarget> {\n  const {appId, organizationId, type, workbench} = options\n  // Keyed on singleton-ness, not on a locally declared config, so an undeploy\n  // still reaches the server's config snapshots after the fields are removed\n  // from sanity.cli.ts.\n  const configOnly = !!workbench.isSingleton && !workbench.hasInterfaces\n  // Workbench-internal, so kept off the reported target; resolveTarget stashes it for the delete.\n  let installationId: string | undefined\n\n  return {\n    resolveTarget: async () => {\n      if (!configOnly) return resolveApplicationTarget({appId, type, workbench})\n      const resolved = await resolveConfigTarget({organizationId, workbench})\n      installationId = resolved.installationId\n      return resolved.resolution\n    },\n    type,\n    async undeploy(target) {\n      if (target.deletes === 'config') {\n        if (!installationId) throw new Error('No installation resolved for the config undeploy')\n        for (const snapshot of target.configs) {\n          await deleteConfig(installationId, snapshot.id)\n        }\n        return\n      }\n      await deleteApplication(target.id)\n    },\n  }\n}\n\nasync function resolveApplicationTarget({\n  appId,\n  type,\n  workbench,\n}: {\n  appId: string | undefined\n  type: 'coreApp' | 'studio'\n  workbench: DeployableWorkbenchApp\n}): Promise<UndeployTargetResolution<WorkbenchUndeployTarget>> {\n  if (!appId) {\n    return {\n      message: 'No `deployment.appId` configured',\n      solution: 'Add `deployment.appId` to sanity.cli.ts',\n      type: 'none',\n    }\n  }\n\n  const application = await getApplication(appId)\n  if (!application) {\n    return {message: 'Application with the given ID does not exist', type: 'none'}\n  }\n\n  const {exposes, lines} = summarizeInterfaces(workbench)\n  return {\n    target: {\n      activeDeployment: null,\n      appHost: application.slug,\n      createdAt: null,\n      deletes: 'application',\n      id: application.id,\n      interfaces: exposes,\n      organizationId: application.organizationId,\n      projectId: null,\n      summary: [\n        ...lines,\n        ...(workbench.isSingleton === undefined ? [] : [`Singleton: ${workbench.isSingleton}`]),\n      ],\n      title: application.title,\n      type,\n      url: getApplicationUrl({...application, type}),\n    },\n    type: 'found',\n  }\n}\n\nasync function resolveConfigTarget({\n  organizationId,\n  workbench,\n}: {\n  organizationId: string | undefined\n  workbench: DeployableWorkbenchApp\n}): Promise<{\n  installationId?: string\n  resolution: UndeployTargetResolution<WorkbenchUndeployTarget>\n}> {\n  const config = workbench.config\n  const appType = config?.appType ?? workbench.applicationType\n  if (!appType) throw new Error('The app declares no app type to resolve its installation')\n  if (!organizationId) {\n    throw new Error(\n      'sanity.cli.ts does not contain an organization identifier (\"app.organizationId\"), which is required to resolve the installation',\n    )\n  }\n\n  const installationId = await resolveInstallationId({appType, organizationId})\n  if (!installationId) {\n    return {\n      resolution: {\n        message: `No active \"${appType}\" installation for organization \"${organizationId}\"`,\n        type: 'none',\n      },\n    }\n  }\n\n  const configs = await listConfigs(installationId)\n  if (configs.length === 0) {\n    return {\n      installationId,\n      resolution: {\n        message: `No deployed config for the \"${appType}\" installation`,\n        type: 'none',\n      },\n    }\n  }\n\n  // At most one snapshot is active (served); the rest are deactivated history.\n  const active = configs.find((snapshot) => snapshot.isActive)\n  return {\n    installationId,\n    resolution: {\n      target: {\n        activeDeployment: active\n          ? {deployedAt: active.createdAt ?? '', deployedBy: active.deployedBy ?? ''}\n          : null,\n        appHost: null,\n        configs: configs.map((snapshot) => ({\n          createdAt: snapshot.createdAt ?? null,\n          deployedBy: snapshot.deployedBy ?? null,\n          id: snapshot.id,\n        })),\n        createdAt: configs.at(-1)?.createdAt ?? null,\n        deletes: 'config',\n        id: null,\n        organizationId,\n        projectId: null,\n        summary: config ? [summarizeConfig(config)] : undefined,\n        title: workbench.slug,\n        type: 'coreApp',\n        url: getWorkbenchUrl(organizationId),\n      },\n      type: 'found',\n    },\n  }\n}\n"],"names":["deleteApplication","getApplication","getApplicationUrl","getWorkbenchUrl","deleteConfig","listConfigs","resolveInstallationId","summarizeConfig","summarizeInterfaces","createWorkbenchUndeployAdapter","options","appId","organizationId","type","workbench","configOnly","isSingleton","hasInterfaces","installationId","resolveTarget","resolveApplicationTarget","resolved","resolveConfigTarget","resolution","undeploy","target","deletes","Error","snapshot","configs","id","message","solution","application","exposes","lines","activeDeployment","appHost","slug","createdAt","interfaces","projectId","summary","undefined","title","url","config","appType","applicationType","length","active","find","isActive","deployedAt","deployedBy","map","at"],"mappings":"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"}

package/dist/appId.js

@@ -26,9 +26,9 @@
     const shape = JSON.stringify({
         config: app.config ?? null,
         entry: app.entry ?? null,
-        name: app.name,
         organizationId: app.organizationId,
         services: canonical(app.services),
+        slug: app.slug,
         views: canonical(app.views)
     });
     // eslint-disable-next-line n/no-unsupported-features/node-builtins -- the Web Crypto global is available on our Node target and in the browser

package/dist/appId.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/appId.ts"],"sourcesContent":["import {type ResolvedWorkbenchApp} from './resolveWorkbenchApp.js'\n\n/**\n * File the build writes into its output, carrying the id compiled into the\n * bundle. `sanity start` serves a build without recompiling, so it reads this\n * instead of recomputing — a deploy inlines the API id, not the shape hash.\n */\nexport const SANITY_APP_ID_FILE = 'sanity-app-id.txt'\n\n/**\n * The dev id for a workbench app — the address the server bound. `sanity dev`\n * keys on where the app is served so a running app can't collide with its\n * deployed twin. Sync and dependency-free: it's re-exported from the package's\n * browser-facing entry, so it must not pull in `node:crypto`.\n */\nexport function resolveAppId(source: {host: string; port: number}): string {\n  return `${source.host}-${source.port}`\n}\n\n/**\n * The `build`/`start` id — a hash of the app's declared shape (its identity, not\n * its code), so the bundle inlined by `sanity build` and the registry entry\n * advertised by `sanity start` resolve to the same id. Hashed with the Web Crypto\n * API rather than `node:crypto` for parity with `resolveAppId`'s browser-safe\n * home. `sanity deploy` resolves its own id from the applications API.\n */\nexport async function buildAppId(app: ResolvedWorkbenchApp): Promise<string> {\n  const canonical = (\n    interfaces: ReadonlyArray<{name: string; src: string; type: string}> | undefined,\n  ): Array<[string, string, string]> =>\n    (interfaces ?? []).map((i): [string, string, string] => [i.type, i.name, i.src]).toSorted()\n  const shape = JSON.stringify({\n    config: app.config ?? null,\n    entry: app.entry ?? null,\n    name: app.name,\n    organizationId: app.organizationId,\n    services: canonical(app.services),\n    views: canonical(app.views),\n  })\n  // eslint-disable-next-line n/no-unsupported-features/node-builtins -- the Web Crypto global is available on our Node target and in the browser\n  const digest = await globalThis.crypto.subtle.digest('SHA-256', new TextEncoder().encode(shape))\n  return Array.from(new Uint8Array(digest), (byte) => byte.toString(16).padStart(2, '0')).join('')\n}\n"],"names":["SANITY_APP_ID_FILE","resolveAppId","source","host","port","buildAppId","app","canonical","interfaces","map","i","type","name","src","toSorted","shape","JSON","stringify","config","entry","organizationId","services","views","digest","globalThis","crypto","subtle","TextEncoder","encode","Array","from","Uint8Array","byte","toString","padStart","join"],"mappings":"AAEA;;;;CAIC,GACD,OAAO,MAAMA,qBAAqB,oBAAmB;AAErD;;;;;CAKC,GACD,OAAO,SAASC,aAAaC,MAAoC;IAC/D,OAAO,GAAGA,OAAOC,IAAI,CAAC,CAAC,EAAED,OAAOE,IAAI,EAAE;AACxC;AAEA;;;;;;CAMC,GACD,OAAO,eAAeC,WAAWC,GAAyB;IACxD,MAAMC,YAAY,CAChBC,aAEA,AAACA,CAAAA,cAAc,EAAE,AAAD,EAAGC,GAAG,CAAC,CAACC,IAAgC;gBAACA,EAAEC,IAAI;gBAAED,EAAEE,IAAI;gBAAEF,EAAEG,GAAG;aAAC,EAAEC,QAAQ;IAC3F,MAAMC,QAAQC,KAAKC,SAAS,CAAC;QAC3BC,QAAQZ,IAAIY,MAAM,IAAI;QACtBC,OAAOb,IAAIa,KAAK,IAAI;QACpBP,MAAMN,IAAIM,IAAI;QACdQ,gBAAgBd,IAAIc,cAAc;QAClCC,UAAUd,UAAUD,IAAIe,QAAQ;QAChCC,OAAOf,UAAUD,IAAIgB,KAAK;IAC5B;IACA,+IAA+I;IAC/I,MAAMC,SAAS,MAAMC,WAAWC,MAAM,CAACC,MAAM,CAACH,MAAM,CAAC,WAAW,IAAII,cAAcC,MAAM,CAACb;IACzF,OAAOc,MAAMC,IAAI,CAAC,IAAIC,WAAWR,SAAS,CAACS,OAASA,KAAKC,QAAQ,CAAC,IAAIC,QAAQ,CAAC,GAAG,MAAMC,IAAI,CAAC;AAC/F"}
+{"version":3,"sources":["../src/appId.ts"],"sourcesContent":["import {type ResolvedWorkbenchApp} from './resolveWorkbenchApp.js'\n\n/**\n * File the build writes into its output, carrying the id compiled into the\n * bundle. `sanity start` serves a build without recompiling, so it reads this\n * instead of recomputing — a deploy inlines the API id, not the shape hash.\n */\nexport const SANITY_APP_ID_FILE = 'sanity-app-id.txt'\n\n/**\n * The dev id for a workbench app — the address the server bound. `sanity dev`\n * keys on where the app is served so a running app can't collide with its\n * deployed twin. Sync and dependency-free: it's re-exported from the package's\n * browser-facing entry, so it must not pull in `node:crypto`.\n */\nexport function resolveAppId(source: {host: string; port: number}): string {\n  return `${source.host}-${source.port}`\n}\n\n/**\n * The `build`/`start` id — a hash of the app's declared shape (its identity, not\n * its code), so the bundle inlined by `sanity build` and the registry entry\n * advertised by `sanity start` resolve to the same id. Hashed with the Web Crypto\n * API rather than `node:crypto` for parity with `resolveAppId`'s browser-safe\n * home. `sanity deploy` resolves its own id from the applications API.\n */\nexport async function buildAppId(app: ResolvedWorkbenchApp): Promise<string> {\n  const canonical = (\n    interfaces: ReadonlyArray<{name: string; src: string; type: string}> | undefined,\n  ): Array<[string, string, string]> =>\n    (interfaces ?? []).map((i): [string, string, string] => [i.type, i.name, i.src]).toSorted()\n  const shape = JSON.stringify({\n    config: app.config ?? null,\n    entry: app.entry ?? null,\n    organizationId: app.organizationId,\n    services: canonical(app.services),\n    slug: app.slug,\n    views: canonical(app.views),\n  })\n  // eslint-disable-next-line n/no-unsupported-features/node-builtins -- the Web Crypto global is available on our Node target and in the browser\n  const digest = await globalThis.crypto.subtle.digest('SHA-256', new TextEncoder().encode(shape))\n  return Array.from(new Uint8Array(digest), (byte) => byte.toString(16).padStart(2, '0')).join('')\n}\n"],"names":["SANITY_APP_ID_FILE","resolveAppId","source","host","port","buildAppId","app","canonical","interfaces","map","i","type","name","src","toSorted","shape","JSON","stringify","config","entry","organizationId","services","slug","views","digest","globalThis","crypto","subtle","TextEncoder","encode","Array","from","Uint8Array","byte","toString","padStart","join"],"mappings":"AAEA;;;;CAIC,GACD,OAAO,MAAMA,qBAAqB,oBAAmB;AAErD;;;;;CAKC,GACD,OAAO,SAASC,aAAaC,MAAoC;IAC/D,OAAO,GAAGA,OAAOC,IAAI,CAAC,CAAC,EAAED,OAAOE,IAAI,EAAE;AACxC;AAEA;;;;;;CAMC,GACD,OAAO,eAAeC,WAAWC,GAAyB;IACxD,MAAMC,YAAY,CAChBC,aAEA,AAACA,CAAAA,cAAc,EAAE,AAAD,EAAGC,GAAG,CAAC,CAACC,IAAgC;gBAACA,EAAEC,IAAI;gBAAED,EAAEE,IAAI;gBAAEF,EAAEG,GAAG;aAAC,EAAEC,QAAQ;IAC3F,MAAMC,QAAQC,KAAKC,SAAS,CAAC;QAC3BC,QAAQZ,IAAIY,MAAM,IAAI;QACtBC,OAAOb,IAAIa,KAAK,IAAI;QACpBC,gBAAgBd,IAAIc,cAAc;QAClCC,UAAUd,UAAUD,IAAIe,QAAQ;QAChCC,MAAMhB,IAAIgB,IAAI;QACdC,OAAOhB,UAAUD,IAAIiB,KAAK;IAC5B;IACA,+IAA+I;IAC/I,MAAMC,SAAS,MAAMC,WAAWC,MAAM,CAACC,MAAM,CAACH,MAAM,CAAC,WAAW,IAAII,cAAcC,MAAM,CAACd;IACzF,OAAOe,MAAMC,IAAI,CAAC,IAAIC,WAAWR,SAAS,CAACS,OAASA,KAAKC,QAAQ,CAAC,IAAIC,QAAQ,CAAC,GAAG,MAAMC,IAAI,CAAC;AAC/F"}

package/dist/appSlug.js

@@ -0,0 +1,7 @@
+/** Mirrors brett's `STUDIO_APP_HOST_PATTERN`, which rejects anything else on create. */ export const APP_SLUG_PATTERN = /^[a-z][a-z0-9-]*[a-z0-9]$/;
+export function toAppSlug(value) {
+    const slug = value.toLowerCase().normalize('NFKD').replaceAll(/\p{M}/gu, '').replaceAll(/[^a-z0-9]+/g, '-').replaceAll(/^-|-$/g, '');
+    return APP_SLUG_PATTERN.test(slug) ? slug : null;
+}
+
+//# sourceMappingURL=appSlug.js.map

package/dist/appSlug.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/appSlug.ts"],"sourcesContent":["/** Mirrors brett's `STUDIO_APP_HOST_PATTERN`, which rejects anything else on create. */\nexport const APP_SLUG_PATTERN = /^[a-z][a-z0-9-]*[a-z0-9]$/\n\nexport function toAppSlug(value: string): string | null {\n  const slug = value\n    .toLowerCase()\n    .normalize('NFKD')\n    .replaceAll(/\\p{M}/gu, '')\n    .replaceAll(/[^a-z0-9]+/g, '-')\n    .replaceAll(/^-|-$/g, '')\n  return APP_SLUG_PATTERN.test(slug) ? slug : null\n}\n"],"names":["APP_SLUG_PATTERN","toAppSlug","value","slug","toLowerCase","normalize","replaceAll","test"],"mappings":"AAAA,sFAAsF,GACtF,OAAO,MAAMA,mBAAmB,4BAA2B;AAE3D,OAAO,SAASC,UAAUC,KAAa;IACrC,MAAMC,OAAOD,MACVE,WAAW,GACXC,SAAS,CAAC,QACVC,UAAU,CAAC,WAAW,IACtBA,UAAU,CAAC,eAAe,KAC1BA,UAAU,CAAC,UAAU;IACxB,OAAON,iBAAiBO,IAAI,CAACJ,QAAQA,OAAO;AAC9C"}

package/dist/contract.js

@@ -10,11 +10,28 @@ import { z } from 'zod/mini';
  * for {@link InterfaceType} and the build; add a type by registering it here.
  * @internal
  */ export const VIEW_COMPONENTS = {
+    asset_source: [
+        'asset_source'
+    ],
     panel: [
         'title',
         'panel'
+    ],
+    tile: [
+        'tile'
     ]
 };
+/**
+ * A tile's footprint family — the shape it occupies on the dashboard. Modelled
+ * on iOS WidgetKit families, not a linear scale: `banner` is full-width and
+ * shallow, which a `small`→`large` magnitude can't express. The host maps a
+ * family to a layout slot; the component reads it to render per footprint.
+ * @public
+ */ export const TileSizeSchema = z.enum([
+    'small',
+    'large',
+    'banner'
+]);
 /**
  * The `app` interface's dock-placement metadata. Interface metadata is
  * discriminated on `type`; `app` is the only type with a shape so far.
@@ -23,6 +40,31 @@ import { z } from 'zod/mini';
     group: z.optional(z.string()),
     priority: z.optional(z.number())
 });
+/**
+ * A tile's interface metadata: its footprint `size` and an optional `priority`
+ * the dashboard sorts on, ascending. Both are authored as top-level view fields
+ * (see {@link InterfaceDeclarationSchema}) but stored on the record as metadata.
+ * Mirrors `app`'s dock metadata; tile is the first view type to carry any.
+ * @internal
+ */ export const TileInterfaceMetadataSchema = z.object({
+    priority: z.optional(z.number()),
+    size: TileSizeSchema
+});
+/**
+ * The contract version each interface type advertises, so the host can check it
+ * renders/runs what it expects.
+ * @internal
+ */ const INTERFACE_CONTRACT_VERSIONS = {
+    app: undefined,
+    asset_source: VIEW_CONTRACT_VERSION,
+    panel: VIEW_CONTRACT_VERSION,
+    tile: VIEW_CONTRACT_VERSION,
+    worker: SERVICE_CONTRACT_VERSION
+};
+/** @internal */ export function interfaceContractVersion(type) {
+    const version = INTERFACE_CONTRACT_VERSIONS[type];
+    return version === undefined ? undefined : String(version);
+}
 /**
  * The module-federation id a build exposes an interface at. Dev stamps the same
  * id a deploy would, so the workbench loads a local interface like a deployed one.
@@ -33,7 +75,9 @@ import { z } from 'zod/mini';
             {
                 return 'App';
             }
+        case 'asset_source':
         case 'panel':
+        case 'tile':
             {
                 return `views/${name}`;
             }
@@ -55,20 +99,32 @@ function extensionDeclarationFields(kind) {
         src: z.string()
     };
 }
-// Every interface (view, service) shares `name` + `src` + an optional display
-// `title` that defaults to `name` on deploy.
+// Every interface (view, service) shares `name` + `src` + a display `title`,
+// which Brett requires on the record each becomes.
 function interfaceDeclarationFields(kind) {
     return {
         ...extensionDeclarationFields(kind),
-        title: z.optional(z.string())
+        title: z.string(`${kind} \`title\` is required`)
     };
 }
 const PanelViewSchema = z.object({
     type: z.literal('panel'),
     ...interfaceDeclarationFields('View')
 });
+const AssetSourceViewSchema = z.object({
+    type: z.literal('asset_source'),
+    ...interfaceDeclarationFields('View')
+});
+const TileViewSchema = z.object({
+    type: z.literal('tile'),
+    ...interfaceDeclarationFields('View'),
+    /** Sort position within its layout track, ascending. Optional. */ priority: z.optional(z.number()),
+    /** Footprint family the dashboard lays the tile out by. */ size: TileSizeSchema
+});
 /** @internal */ export const InterfaceDeclarationSchema = z.discriminatedUnion('type', [
-    PanelViewSchema
+    PanelViewSchema,
+    AssetSourceViewSchema,
+    TileViewSchema
 ]);
 const WorkerServiceSchema = z.object({
     type: z.literal('worker'),