@sanity/workbench-cli 1.3.0 → 1.5.0

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

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/actions/dev/exposesSetId.ts"],"sourcesContent":["import {\n  deriveConfigEntries,\n  type DevServerConfig,\n  type DevServerInterface,\n} from './deriveInterfaces.js'\nimport {type DevServerManifest} from './registry.js'\n\ninterface ExposeSet {\n  configs?: readonly DevServerConfig[] | undefined\n  interfaces?: readonly DevServerInterface[] | undefined\n}\n\n/**\n * Order-independent id of an app's exposed-module set. Keys each interface by\n * its type, name, and source file, and each config by its module\n * identity plus one key per entry (a named source file), so the id changes on\n * any rebuild-worthy edit — add, remove, rename, repoint, or gaining/losing the\n * config module — while reordering and HMR content edits keep it stable.\n */\nexport function exposesSetId({configs, interfaces}: ExposeSet): string {\n  const keys = [\n    ...(interfaces ?? []).map((iface) =>\n      [iface.interface_type, iface.name, iface.entry_point].join('::'),\n    ),\n    ...(configs ?? []).flatMap((config) => [\n      ['config', config.appType].join('::'),\n      ...deriveConfigEntries(config).map((entry) =>\n        ['config', config.appType, entry.name, entry.src].join('::'),\n      ),\n    ]),\n  ]\n  if (keys.length === 0) return ''\n  return keys.toSorted().join('|')\n}\n\n/**\n * `changed`/`commit` are split so the caller commits only after the rebuild that\n * depends on the new set succeeds — a thrown rebuild retries on the next save.\n */\nexport function trackExposesSet(initial: ExposeSet): {\n  changed: (next: ExposeSet) => boolean\n  commit: (next: ExposeSet) => void\n} {\n  let lastId = exposesSetId(initial)\n  return {\n    changed: (next) => exposesSetId(next) !== lastId,\n    commit: (next) => {\n      lastId = exposesSetId(next)\n    },\n  }\n}\n\nconst serverKey = (server: DevServerManifest): string =>\n  `${server.id ?? ''}@${server.host ?? ''}:${server.port}`\n\nconst serverExposesId = (server: DevServerManifest): string =>\n  exposesSetId({configs: server.configs, interfaces: server.interfaces})\n\n/**\n * Multi-app counterpart to {@link trackExposesSet}: true when a *known* app's\n * set changed — its remote was rebuilt, so the workbench must full-reload to\n * drop the stale remote-entry. A new/removed app isn't a rebuild.\n */\nexport function createExposesTracker(): {\n  hasChanged: (servers: readonly DevServerManifest[]) => boolean\n} {\n  let known = new Map<string, string>()\n  return {\n    hasChanged(servers) {\n      const rebuilt = servers.some((server) => {\n        const key = serverKey(server)\n        return known.has(key) && known.get(key) !== serverExposesId(server)\n      })\n      known = new Map(servers.map((server) => [serverKey(server), serverExposesId(server)]))\n      return rebuilt\n    },\n  }\n}\n"],"names":["deriveConfigEntries","exposesSetId","configs","interfaces","keys","map","iface","interface_type","name","entry_point","join","flatMap","config","appType","entry","src","length","toSorted","trackExposesSet","initial","lastId","changed","next","commit","serverKey","server","id","host","port","serverExposesId","createExposesTracker","known","Map","hasChanged","servers","rebuilt","some","key","has","get"],"mappings":"AAAA,SACEA,mBAAmB,QAGd,wBAAuB;AAQ9B;;;;;;CAMC,GACD,OAAO,SAASC,aAAa,EAACC,OAAO,EAAEC,UAAU,EAAY;IAC3D,MAAMC,OAAO;WACR,AAACD,CAAAA,cAAc,EAAE,AAAD,EAAGE,GAAG,CAAC,CAACC,QACzB;gBAACA,MAAMC,cAAc;gBAAED,MAAME,IAAI;gBAAEF,MAAMG,WAAW;aAAC,CAACC,IAAI,CAAC;WAE1D,AAACR,CAAAA,WAAW,EAAE,AAAD,EAAGS,OAAO,CAAC,CAACC,SAAW;gBACrC;oBAAC;oBAAUA,OAAOC,OAAO;iBAAC,CAACH,IAAI,CAAC;mBAC7BV,oBAAoBY,QAAQP,GAAG,CAAC,CAACS,QAClC;wBAAC;wBAAUF,OAAOC,OAAO;wBAAEC,MAAMN,IAAI;wBAAEM,MAAMC,GAAG;qBAAC,CAACL,IAAI,CAAC;aAE1D;KACF;IACD,IAAIN,KAAKY,MAAM,KAAK,GAAG,OAAO;IAC9B,OAAOZ,KAAKa,QAAQ,GAAGP,IAAI,CAAC;AAC9B;AAEA;;;CAGC,GACD,OAAO,SAASQ,gBAAgBC,OAAkB;IAIhD,IAAIC,SAASnB,aAAakB;IAC1B,OAAO;QACLE,SAAS,CAACC,OAASrB,aAAaqB,UAAUF;QAC1CG,QAAQ,CAACD;YACPF,SAASnB,aAAaqB;QACxB;IACF;AACF;AAEA,MAAME,YAAY,CAACC,SACjB,GAAGA,OAAOC,EAAE,IAAI,GAAG,CAAC,EAAED,OAAOE,IAAI,IAAI,GAAG,CAAC,EAAEF,OAAOG,IAAI,EAAE;AAE1D,MAAMC,kBAAkB,CAACJ,SACvBxB,aAAa;QAACC,SAASuB,OAAOvB,OAAO;QAAEC,YAAYsB,OAAOtB,UAAU;IAAA;AAEtE;;;;CAIC,GACD,OAAO,SAAS2B;IAGd,IAAIC,QAAQ,IAAIC;IAChB,OAAO;QACLC,YAAWC,OAAO;YAChB,MAAMC,UAAUD,QAAQE,IAAI,CAAC,CAACX;gBAC5B,MAAMY,MAAMb,UAAUC;gBACtB,OAAOM,MAAMO,GAAG,CAACD,QAAQN,MAAMQ,GAAG,CAACF,SAASR,gBAAgBJ;YAC9D;YACAM,QAAQ,IAAIC,IAAIE,QAAQ7B,GAAG,CAAC,CAACoB,SAAW;oBAACD,UAAUC;oBAASI,gBAAgBJ;iBAAQ;YACpF,OAAOU;QACT;IACF;AACF"}
+{"version":3,"sources":["../../../src/actions/dev/exposesSetId.ts"],"sourcesContent":["import {\n  deriveConfigEntries,\n  type DevServerConfig,\n  type DevServerInterface,\n} from './deriveInterfaces.js'\nimport {type DevServerManifest} from './registry.js'\n\ninterface ExposeSet {\n  configs?: readonly DevServerConfig[] | undefined\n  interfaces?: readonly DevServerInterface[] | undefined\n}\n\n/**\n * Order-independent id of an app's exposed-module set. Keys each interface by\n * its type, name, and source file, and each config by its module\n * identity plus one key per entry (a named source file), so the id changes on\n * any rebuild-worthy edit — add, remove, rename, repoint, or gaining/losing the\n * config module — while reordering and HMR content edits keep it stable.\n */\nexport function exposesSetId({configs, interfaces}: ExposeSet): string {\n  const keys = [\n    ...(interfaces ?? []).map((iface) => [iface.type, iface.name, iface.src].join('::')),\n    ...(configs ?? []).flatMap((config) => [\n      ['config', config.appType].join('::'),\n      ...deriveConfigEntries(config).map((entry) =>\n        ['config', config.appType, entry.name, entry.src].join('::'),\n      ),\n    ]),\n  ]\n  if (keys.length === 0) return ''\n  return keys.toSorted().join('|')\n}\n\n/**\n * `changed`/`commit` are split so the caller commits only after the rebuild that\n * depends on the new set succeeds — a thrown rebuild retries on the next save.\n */\nexport function trackExposesSet(initial: ExposeSet): {\n  changed: (next: ExposeSet) => boolean\n  commit: (next: ExposeSet) => void\n} {\n  let lastId = exposesSetId(initial)\n  return {\n    changed: (next) => exposesSetId(next) !== lastId,\n    commit: (next) => {\n      lastId = exposesSetId(next)\n    },\n  }\n}\n\nconst serverKey = (server: DevServerManifest): string =>\n  `${server.id ?? ''}@${server.host ?? ''}:${server.port}`\n\nconst serverExposesId = (server: DevServerManifest): string =>\n  exposesSetId({configs: server.configs, interfaces: server.interfaces})\n\n/**\n * Multi-app counterpart to {@link trackExposesSet}: true when a *known* app's\n * set changed — its remote was rebuilt, so the workbench must full-reload to\n * drop the stale remote-entry. A new/removed app isn't a rebuild.\n */\nexport function createExposesTracker(): {\n  hasChanged: (servers: readonly DevServerManifest[]) => boolean\n} {\n  let known = new Map<string, string>()\n  return {\n    hasChanged(servers) {\n      const rebuilt = servers.some((server) => {\n        const key = serverKey(server)\n        return known.has(key) && known.get(key) !== serverExposesId(server)\n      })\n      known = new Map(servers.map((server) => [serverKey(server), serverExposesId(server)]))\n      return rebuilt\n    },\n  }\n}\n"],"names":["deriveConfigEntries","exposesSetId","configs","interfaces","keys","map","iface","type","name","src","join","flatMap","config","appType","entry","length","toSorted","trackExposesSet","initial","lastId","changed","next","commit","serverKey","server","id","host","port","serverExposesId","createExposesTracker","known","Map","hasChanged","servers","rebuilt","some","key","has","get"],"mappings":"AAAA,SACEA,mBAAmB,QAGd,wBAAuB;AAQ9B;;;;;;CAMC,GACD,OAAO,SAASC,aAAa,EAACC,OAAO,EAAEC,UAAU,EAAY;IAC3D,MAAMC,OAAO;WACR,AAACD,CAAAA,cAAc,EAAE,AAAD,EAAGE,GAAG,CAAC,CAACC,QAAU;gBAACA,MAAMC,IAAI;gBAAED,MAAME,IAAI;gBAAEF,MAAMG,GAAG;aAAC,CAACC,IAAI,CAAC;WAC3E,AAACR,CAAAA,WAAW,EAAE,AAAD,EAAGS,OAAO,CAAC,CAACC,SAAW;gBACrC;oBAAC;oBAAUA,OAAOC,OAAO;iBAAC,CAACH,IAAI,CAAC;mBAC7BV,oBAAoBY,QAAQP,GAAG,CAAC,CAACS,QAClC;wBAAC;wBAAUF,OAAOC,OAAO;wBAAEC,MAAMN,IAAI;wBAAEM,MAAML,GAAG;qBAAC,CAACC,IAAI,CAAC;aAE1D;KACF;IACD,IAAIN,KAAKW,MAAM,KAAK,GAAG,OAAO;IAC9B,OAAOX,KAAKY,QAAQ,GAAGN,IAAI,CAAC;AAC9B;AAEA;;;CAGC,GACD,OAAO,SAASO,gBAAgBC,OAAkB;IAIhD,IAAIC,SAASlB,aAAaiB;IAC1B,OAAO;QACLE,SAAS,CAACC,OAASpB,aAAaoB,UAAUF;QAC1CG,QAAQ,CAACD;YACPF,SAASlB,aAAaoB;QACxB;IACF;AACF;AAEA,MAAME,YAAY,CAACC,SACjB,GAAGA,OAAOC,EAAE,IAAI,GAAG,CAAC,EAAED,OAAOE,IAAI,IAAI,GAAG,CAAC,EAAEF,OAAOG,IAAI,EAAE;AAE1D,MAAMC,kBAAkB,CAACJ,SACvBvB,aAAa;QAACC,SAASsB,OAAOtB,OAAO;QAAEC,YAAYqB,OAAOrB,UAAU;IAAA;AAEtE;;;;CAIC,GACD,OAAO,SAAS0B;IAGd,IAAIC,QAAQ,IAAIC;IAChB,OAAO;QACLC,YAAWC,OAAO;YAChB,MAAMC,UAAUD,QAAQE,IAAI,CAAC,CAACX;gBAC5B,MAAMY,MAAMb,UAAUC;gBACtB,OAAOM,MAAMO,GAAG,CAACD,QAAQN,MAAMQ,GAAG,CAACF,SAASR,gBAAgBJ;YAC9D;YACAM,QAAQ,IAAIC,IAAIE,QAAQ5B,GAAG,CAAC,CAACmB,SAAW;oBAACD,UAAUC;oBAASI,gBAAgBJ;iBAAQ;YACpF,OAAOU;QACT;IACF;AACF"}

package/dist/actions/dev/registry.js

@@ -2,6 +2,7 @@ import { existsSync, mkdirSync, readdirSync, readFileSync, unlinkSync, watch, wr
 import { join } from 'node:path';
 import { coreAppManifestSchema, getSanityDataDir, studioManifestSchema, subdebug } from '@sanity/cli-core';
 import { z } from 'zod/mini';
+import { AppInterfaceMetadataSchema } from '../../contract.js';
 import { canonicalizeWatchDir } from './canonicalizeWatchDir.js';
 import { getProcessStartTime, isOurProcess } from './processLiveness.js';
 const devDebug = subdebug('dev');
@@ -14,6 +15,34 @@ const devDebug = subdebug('dev');
  */ function ownStartedAt() {
     return (getProcessStartTime(process.pid) ?? new Date()).toISOString();
 }
+const interfaceBaseFields = {
+    /** CLI-minted for a local interface; a deployed one gets its id from Brett. */ id: z.string(),
+    moduleId: z.string(),
+    name: z.string(),
+    /** Raw source vite serves; a deployed interface carries only the `moduleId`. */ src: z.string(),
+    title: z.string(),
+    version: z.optional(z.string())
+};
+/**
+ * A forwarded interface, discriminated on `type`. Kept outside the manifest so
+ * the workbench renders local panels and runs workers without a deploy.
+ */ const devServerInterfaceSchema = z.discriminatedUnion('type', [
+    z.object({
+        ...interfaceBaseFields,
+        metadata: z.nullable(AppInterfaceMetadataSchema),
+        type: z.literal('app')
+    }),
+    z.object({
+        ...interfaceBaseFields,
+        metadata: z.null(),
+        type: z.literal('panel')
+    }),
+    z.object({
+        ...interfaceBaseFields,
+        metadata: z.null(),
+        type: z.literal('worker')
+    })
+]);
 const devServerManifestSchema = z.object({
     /**
    * Field schema *values* load from the federation module; each field's `src`
@@ -40,23 +69,7 @@ const devServerManifestSchema = z.object({
     }))),
     host: z.string(),
     id: z.optional(z.string()),
-    /**
-   * Interfaces the app exposes, mapped from the declared `views` (dock panels,
-   * `interface_type: "panel"`) and `services` (background workers,
-   * `interface_type: "worker"`). A service is just an interface, so both live
-   * in this one list. Carried separately from the manifest — interfaces live in
-   * the application service, not the manifest — so the workbench can render
-   * local panels and run local workers without a deploy. `entry_point` is the
-   * declared `src`. Lenient by design; the workbench is the authority on the
-   * interface shape.
-   */ interfaces: z.optional(z.array(z.object({
-        entry_point: z.string(),
-        interface_type: z.string(),
-        name: z.string(),
-        // Contract version the interface's generated module exports; the app
-        // view has no versioned contract and carries none.
-        version: z.optional(z.number())
-    }))),
+    interfaces: z.optional(z.array(devServerInterfaceSchema)),
     /**
    * Inlined manifest — either a {@link StudioManifest} or {@link CoreAppManifest},
    * validated against the shared cli-core schemas. The registry stores and

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 {canonicalizeWatchDir} from './canonicalizeWatchDir.js'\nimport {getProcessStartTime, isOurProcess} from './processLiveness.js'\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 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        // Config contract version the generated module exports, so the\n        // workbench knows what it can resolve before loading the module.\n        version: z.number(),\n      }),\n    ),\n  ),\n  host: z.string(),\n  id: z.optional(z.string()),\n  /**\n   * Interfaces the app exposes, mapped from the declared `views` (dock panels,\n   * `interface_type: \"panel\"`) and `services` (background workers,\n   * `interface_type: \"worker\"`). A service is just an interface, so both live\n   * in this one list. Carried separately from the manifest — interfaces live in\n   * the application service, not the manifest — so the workbench can render\n   * local panels and run local workers without a deploy. `entry_point` is the\n   * declared `src`. Lenient by design; the workbench is the authority on the\n   * interface shape.\n   */\n  interfaces: z.optional(\n    z.array(\n      z.object({\n        entry_point: z.string(),\n        interface_type: z.string(),\n        name: z.string(),\n        // Contract version the interface's generated module exports; the app\n        // view has no versioned contract and carries none.\n        version: z.optional(z.number()),\n      }),\n    ),\n  ),\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\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  return {\n    release() {\n      released = true\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    return {\n      release() {\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","canonicalizeWatchDir","getProcessStartTime","isOurProcess","devDebug","REGISTRY_VERSION","ownStartedAt","process","pid","Date","toISOString","devServerManifestSchema","object","configs","optional","array","appType","string","fields","name","public","boolean","src","title","id","moduleName","version","number","host","interfaces","entry_point","interface_type","manifest","union","manifestUpdatedAt","port","projectId","startedAt","type","enum","literal","workDir","getRegistryDir","registerDevServer","registryDir","recursive","current","filePath","JSON","stringify","released","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","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} from '../../contract.js'\nimport {canonicalizeWatchDir} from './canonicalizeWatchDir.js'\nimport {getProcessStartTime, isOurProcess} from './processLiveness.js'\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        // Config contract version the generated module exports, so the\n        // workbench knows what it can resolve before loading the module.\n        version: z.number(),\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\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  return {\n    release() {\n      released = true\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    return {\n      release() {\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","number","host","interfaces","manifest","union","manifestUpdatedAt","port","projectId","startedAt","enum","workDir","getRegistryDir","registerDevServer","registryDir","recursive","current","filePath","JSON","stringify","released","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","updatePort","err","Error","message","String","isNodeError","code","existing"],"mappings":"AAAA,SACEA,UAAU,EACVC,SAAS,EACTC,WAAW,EACXC,YAAY,EACZC,UAAU,EACVC,KAAK,EACLC,aAAa,QACR,UAAS;AAChB,SAAQC,IAAI,QAAO,YAAW;AAE9B,SACEC,qBAAqB,EACrBC,gBAAgB,EAChBC,oBAAoB,EACpBC,QAAQ,QACH,mBAAkB;AACzB,SAAQC,CAAC,QAAO,WAAU;AAE1B,SAAQC,0BAA0B,QAAO,oBAAmB;AAC5D,SAAQC,oBAAoB,QAAO,4BAA2B;AAC9D,SAAQC,mBAAmB,EAAEC,YAAY,QAAO,uBAAsB;AAEtE,MAAMC,WAAWN,SAAS;AAE1B,iEAAiE,GACjE,MAAMO,mBAAmB;AAEzB;;;;;CAKC,GACD,SAASC;IACP,OAAO,AAACJ,CAAAA,oBAAoBK,QAAQC,GAAG,KAAK,IAAIC,MAAK,EAAGC,WAAW;AACrE;AAEA,MAAMC,sBAAsB;IAC1B,6EAA6E,GAC7EC,IAAIb,EAAEc,MAAM;IACZC,UAAUf,EAAEc,MAAM;IAClBE,MAAMhB,EAAEc,MAAM;IACd,8EAA8E,GAC9EG,KAAKjB,EAAEc,MAAM;IACbI,OAAOlB,EAAEc,MAAM;IACfK,SAASnB,EAAEoB,QAAQ,CAACpB,EAAEc,MAAM;AAC9B;AAEA;;;CAGC,GACD,MAAMO,2BAA2BrB,EAAEsB,kBAAkB,CAAC,QAAQ;IAC5DtB,EAAEuB,MAAM,CAAC;QACP,GAAGX,mBAAmB;QACtBY,UAAUxB,EAAEyB,QAAQ,CAACxB;QACrByB,MAAM1B,EAAE2B,OAAO,CAAC;IAClB;IACA3B,EAAEuB,MAAM,CAAC;QAAC,GAAGX,mBAAmB;QAAEY,UAAUxB,EAAE4B,IAAI;QAAIF,MAAM1B,EAAE2B,OAAO,CAAC;IAAQ;IAC9E3B,EAAEuB,MAAM,CAAC;QAAC,GAAGX,mBAAmB;QAAEY,UAAUxB,EAAE4B,IAAI;QAAIF,MAAM1B,EAAE2B,OAAO,CAAC;IAAS;CAChF;AAED,MAAME,0BAA0B7B,EAAEuB,MAAM,CAAC;IACvC;;;;GAIC,GACDO,SAAS9B,EAAEoB,QAAQ,CACjBpB,EAAE+B,KAAK,CACL/B,EAAEuB,MAAM,CAAC;QACP,gEAAgE;QAChES,SAAShC,EAAEoB,QAAQ,CAACpB,EAAEc,MAAM;QAC5BmB,QAAQjC,EAAE+B,KAAK,CACb/B,EAAEuB,MAAM,CAAC;YACPP,MAAMhB,EAAEc,MAAM;YACdoB,QAAQlC,EAAEoB,QAAQ,CAACpB,EAAEmC,OAAO;YAC5BlB,KAAKjB,EAAEc,MAAM;YACbI,OAAOlB,EAAEc,MAAM;QACjB;QAEF,oEAAoE;QACpE,uBAAuB;QACvBD,IAAIb,EAAEc,MAAM;QACZ,wEAAwE;QACxE,kDAAkD;QAClDsB,YAAYpC,EAAEoB,QAAQ,CAACpB,EAAEc,MAAM;QAC/B,+DAA+D;QAC/D,iEAAiE;QACjEK,SAASnB,EAAEqC,MAAM;IACnB;IAGJC,MAAMtC,EAAEc,MAAM;IACdD,IAAIb,EAAEoB,QAAQ,CAACpB,EAAEc,MAAM;IACvByB,YAAYvC,EAAEoB,QAAQ,CAACpB,EAAE+B,KAAK,CAACV;IAC/B;;;;GAIC,GACDmB,UAAUxC,EAAEoB,QAAQ,CAACpB,EAAEyC,KAAK,CAAC;QAAC3C;QAAsBF;KAAsB;IAC1E;;;;GAIC,GACD8C,mBAAmB1C,EAAEoB,QAAQ,CAACpB,EAAEc,MAAM;IACtCL,KAAKT,EAAEqC,MAAM;IACbM,MAAM3C,EAAEqC,MAAM;IACdO,WAAW5C,EAAEoB,QAAQ,CAACpB,EAAEc,MAAM;IAC9B+B,WAAW7C,EAAEc,MAAM;IACnBY,MAAM1B,EAAE8C,IAAI,CAAC;QAAC;QAAW;KAAS;IAClC3B,SAASnB,EAAE2B,OAAO,CAACrB;IACnByC,SAAS/C,EAAEc,MAAM;AACnB;AAUA;;;CAGC,GACD,SAASkC;IACP,OAAOrD,KAAKE,oBAAoB;AAClC;AAaA;;;;;CAKC,GACD,OAAO,SAASoD,kBACdT,QAAkE;IAElE,MAAMU,cAAcF;IACpB3D,UAAU6D,aAAa;QAACC,WAAW;IAAI;IAEvC,IAAIC,UAA6B;QAC/B,GAAGZ,QAAQ;QACX/B,KAAKD,QAAQC,GAAG;QAChBoC,WAAWtC;QACXY,SAASb;IACX;IAEA,MAAM+C,WAAW1D,KAAKuD,aAAa,GAAG1C,QAAQC,GAAG,CAAC,KAAK,CAAC;IACxDf,cAAc2D,UAAUC,KAAKC,SAAS,CAACH,SAAS,MAAM;IAEtD,qEAAqE;IACrE,wEAAwE;IACxE,wEAAwE;IACxE,IAAII,WAAW;IAEf,OAAO;QACLC;YACED,WAAW;YACX,IAAI;gBACFhE,WAAW6D;YACb,EAAE,OAAM;YACN,sCAAsC;YACxC;QACF;QACAK,QAAOC,KAAK;YACV,IAAIH,UAAU;YACdJ,UAAU;gBAAC,GAAGA,OAAO;gBAAE,GAAGO,KAAK;YAAA;YAC/BjE,cAAc2D,UAAUC,KAAKC,SAAS,CAACH,SAAS,MAAM;QACxD;IACF;AACF;AAEA;;;CAGC,GACD,OAAO,SAASQ;IACd,MAAMV,cAAcF;IAEpB,IAAI,CAAC5D,WAAW8D,cAAc;QAC5B,OAAO,EAAE;IACX;IAEA,MAAMW,QAAQvE,YAAY4D,aAAaY,MAAM,CAAC,CAACC,IAAMA,EAAEC,QAAQ,CAAC;IAChE,MAAMC,UAA+B,EAAE;IAEvC,KAAK,MAAMC,QAAQL,MAAO;QACxB,MAAMR,WAAW1D,KAAKuD,aAAagB;QACnC,IAAIC;QACJ,IAAI;YACFA,MAAMb,KAAKc,KAAK,CAAC7E,aAAa8D,UAAU;QAC1C,EAAE,OAAM;YACN;QACF;QAEA,MAAM,EAACgB,IAAI,EAAEC,OAAO,EAAC,GAAGzC,wBAAwB0C,SAAS,CAACJ;QAC1D,IAAI,CAACG,SAAS;QAEd,IAAIlE,aAAaiE,KAAK5D,GAAG,EAAE4D,KAAKxB,SAAS,GAAG;YAC1CoB,QAAQO,IAAI,CAACH;QACf,OAAO;YACL,IAAI;gBACF7E,WAAW6D;YACb,EAAE,OAAM;YACN,0DAA0D;YAC5D;QACF;IACF;IAEA,OAAOY;AACT;AAMA;;;;;;CAMC,GACD,OAAO,SAASQ,cAAcC,QAAgD;IAC5E,MAAMxB,cAAcF;IACpB3D,UAAU6D,aAAa;QAACC,WAAW;IAAI;IAEvC,4EAA4E;IAC5E,+CAA+C;IAC/C,MAAMwB,WAAWzE,qBAAqBgD;IAEtC,IAAI0B;IAEJ,MAAMC,SAAS;QACbC,aAAaF;QACbA,gBAAgBG,WAAW;YACzBL,SAASd;QACX,GAAG;IACL;IAEA,MAAMoB,UAAUvF,MAAMkF,UAAUE;IAEhC,OAAO;QACLI;YACEH,aAAaF;YACbI,QAAQC,KAAK;QACf;IACF;AACF;AAEA,gFAAgF;AAChF,2EAA2E;AAC3E,+EAA+E;AAE/E,MAAMC,sBAAsBlF,EAAEuB,MAAM,CAAC;IACnCe,MAAMtC,EAAEc,MAAM;IACdL,KAAKT,EAAEqC,MAAM;IACbM,MAAM3C,EAAEqC,MAAM;IACdQ,WAAW7C,EAAEc,MAAM;IACnBK,SAASnB,EAAE2B,OAAO,CAACrB;AACrB;AAEA;;;CAGC,GACD,OAAO,SAAS6E;IACd,MAAMC,WAAWzF,KAAKqD,kBAAkB;IAExC,IAAIqC;IACJ,IAAI;QACFA,WAAW9F,aAAa6F,UAAU;IACpC,EAAE,OAAM;QACN,2DAA2D;QAC3D,OAAOE;IACT;IAEA,0EAA0E;IAC1E,2EAA2E;IAC3E,wEAAwE;IACxE,wEAAwE;IACxE,MAAMjB,OAAOkB,kBAAkBF;IAC/BhF,SAAS,2BAA2BgE;IACpC,IAAIA,QAAQjE,aAAaiE,KAAK5D,GAAG,EAAE4D,KAAKxB,SAAS,GAAG;QAClDxC,SAAS,mDAAmDgE,KAAK5D,GAAG,EAAE4D,KAAK1B,IAAI;QAC/E,OAAO0B;IACT;IAEAmB,mBAAmBJ;IACnB,OAAOE;AACT;AAEA,SAASC,kBAAkBF,QAAgB;IACzC,IAAI;QACF,MAAM,EAAChB,IAAI,EAAEC,OAAO,EAAC,GAAGY,oBAAoBX,SAAS,CAACjB,KAAKc,KAAK,CAACiB;QACjE,OAAOf,UAAUD,OAAOiB;IAC1B,EAAE,OAAM;QACN,OAAOA;IACT;AACF;AAEA,SAASE,mBAAmBJ,QAAgB;IAC1C,IAAI;QACF/E,SAAS;QACTb,WAAW4F;QACX/E,SAAS;IACX,EAAE,OAAM;IACN,iDAAiD;IACnD;AACF;AASA;;;;;;;;;;;CAWC,GACD,OAAO,SAASoF,qBACdC,IAAkC,EAClCC,UAAU,CAAC;IAEX,MAAMzC,cAAcF;IACpB3D,UAAU6D,aAAa;QAACC,WAAW;IAAI;IAEvC,MAAMiC,WAAWzF,KAAKuD,aAAa;IACnC,MAAML,YAAYtC;IAClB,MAAMqF,WAAW;QACftD,MAAMoD,KAAKpD,IAAI;QACf7B,KAAKD,QAAQC,GAAG;QAChBkC,MAAM+C,KAAK/C,IAAI;QACfE;QACA1B,SAASb;IACX;IAEAD,SAAS,kCAAkC+E;IAE3C,IAAI;QACF1F,cAAc0F,UAAU9B,KAAKC,SAAS,CAACqC,WAAW;YAACC,MAAM;QAAI;QAC7DxF,SAAS;QACT,OAAO;YACLoD;gBACE,IAAI;oBACFjE,WAAW4F;gBACb,EAAE,OAAM;gBACN,qBAAqB;gBACvB;YACF;YACAU,YAAWnD,IAAY;gBACrBjD,cAAc0F,UAAU9B,KAAKC,SAAS,CAAC;oBAAC,GAAGqC,QAAQ;oBAAEjD;gBAAI;YAC3D;QACF;IACF,EAAE,OAAOoD,KAAc;QACrB1F,SACE,wCACA0F,eAAeC,QAAQD,IAAIE,OAAO,GAAGC,OAAOH;QAE9C,IAAI,CAACI,YAAYJ,QAAQA,IAAIK,IAAI,KAAK,UAAU,OAAOd;QAEvD,mDAAmD;QACnD,MAAMe,WAAWlB;QACjB,IAAIkB,UAAU,OAAOf;QAErB,6FAA6F;QAC7F,IAAIK,WAAW,GAAG,OAAOL;QACzB,OAAOG,qBAAqBC,MAAMC,UAAU;IAC9C;AACF;AAEA,SAASQ,YAAYJ,GAAY;IAC/B,OAAOA,eAAeC,SAAS,UAAUD;AAC3C"}

package/dist/actions/undeploy/workbenchUndeployAdapter.js

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

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

@@ -0,0 +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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"}

package/dist/contract.js

@@ -15,6 +15,38 @@ import { z } from 'zod/mini';
         'panel'
     ]
 };
+/**
+ * The `app` interface's dock-placement metadata. Interface metadata is
+ * discriminated on `type`; `app` is the only type with a shape so far.
+ * @internal
+ */ export const AppInterfaceMetadataSchema = z.object({
+    group: z.optional(z.string()),
+    priority: z.optional(z.number())
+});
+/**
+ * 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.
+ * @internal
+ */ export function interfaceModuleId(type, name) {
+    switch(type){
+        case 'app':
+            {
+                return 'App';
+            }
+        case 'panel':
+            {
+                return `views/${name}`;
+            }
+        case 'worker':
+            {
+                return `services/${name}`;
+            }
+        default:
+            {
+                throw new Error(`Cannot derive a moduleId for unknown interface type: ${type}`);
+            }
+    }
+}
 // Shared `name` + `src`; `kind` only tailors the validation message.
 function extensionDeclarationFields(kind) {
     const pattern = /^[a-zA-Z0-9_-]+$/;

package/dist/contract.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/contract.ts"],"sourcesContent":["import {z} from 'zod/mini'\n\n// Shared module-federation extension contract: interface (view/service) and\n// config declaration schemas, plus the versions the build stamps.\n// `zod/mini` keeps the bundle small.\n\n/** @internal */\nexport const VIEW_CONTRACT_VERSION = 1\n\n/** @internal */\nexport const SERVICE_CONTRACT_VERSION = 1\n\n/** @internal */\nexport const MEDIA_LIBRARY_CONFIG_CONTRACT_VERSION = 1\n\n/**\n * A view component. The return is opaque so the runtime helpers carry no React\n * dependency — the generated artifact renders it with the app's own React.\n * @public\n */\nexport type ViewComponent<TProps> = (props: TProps) => unknown\n\n/** @public */\nexport interface ViewComponentBaseProps<TView> {\n  view: TView\n}\n\n/**\n * Component slots each interface type exposes, in render order. Source of truth\n * for {@link InterfaceType} and the build; add a type by registering it here.\n * @internal\n */\nexport const VIEW_COMPONENTS = {\n  panel: ['title', 'panel'],\n} as const satisfies Record<string, readonly string[]>\n\n/** @public */\nexport type InterfaceType = keyof typeof VIEW_COMPONENTS\n\n/** @public */\nexport type ServiceType = 'worker'\n\n// Shared `name` + `src`; `kind` only tailors the validation message.\nfunction extensionDeclarationFields(kind: 'Field' | 'Service' | 'View') {\n  const pattern = /^[a-zA-Z0-9_-]+$/\n  return {\n    name: z.string().check(z.regex(pattern, `${kind} \\`name\\` must match ${pattern}`)),\n    src: z.string(),\n  }\n}\n\n// Every interface (view, service) shares `name` + `src` + an optional display\n// `title` that defaults to `name` on deploy.\nfunction interfaceDeclarationFields(kind: 'Service' | 'View') {\n  return {...extensionDeclarationFields(kind), title: z.optional(z.string())}\n}\n\nconst PanelViewSchema = z.object({\n  type: z.literal('panel'),\n  ...interfaceDeclarationFields('View'),\n})\n\n/** @internal */\nexport const InterfaceDeclarationSchema = z.discriminatedUnion('type', [PanelViewSchema])\n\nconst WorkerServiceSchema = z.object({\n  type: z.literal('worker'),\n  ...interfaceDeclarationFields('Service'),\n})\n\n/** @internal */\nexport const ServiceDeclarationSchema = z.discriminatedUnion('type', [WorkerServiceSchema])\n\nconst MediaLibraryFieldSchema = z.object({\n  ...extensionDeclarationFields('Field'),\n  public: z.optional(z.boolean()),\n  title: z.string(),\n})\n\n/**\n * Stamped where the config crosses a boundary so the authoring model doesn't carry a constant discriminator.\n * @internal\n */\nexport const INSTALLATION_CONFIG_TYPE = 'installation_config'\n\n// `appType` is stamped by `unstable_defineMediaLibrary`, never authored.\nconst MediaLibraryConfigSchema = z.object({\n  appType: z.literal('media-library'),\n  fields: z\n    .array(MediaLibraryFieldSchema)\n    .check(\n      z.refine(\n        (fields) => new Set(fields.map((field) => field.name)).size === fields.length,\n        'Field `name` must be unique within a media library',\n      ),\n    ),\n})\n\n/**\n * An app's optional config, keyed by `appType`; deploys as a versioned snapshot, not an interface.\n * @internal\n */\nexport const ConfigSchema = z.discriminatedUnion('appType', [MediaLibraryConfigSchema])\n"],"names":["z","VIEW_CONTRACT_VERSION","SERVICE_CONTRACT_VERSION","MEDIA_LIBRARY_CONFIG_CONTRACT_VERSION","VIEW_COMPONENTS","panel","extensionDeclarationFields","kind","pattern","name","string","check","regex","src","interfaceDeclarationFields","title","optional","PanelViewSchema","object","type","literal","InterfaceDeclarationSchema","discriminatedUnion","WorkerServiceSchema","ServiceDeclarationSchema","MediaLibraryFieldSchema","public","boolean","INSTALLATION_CONFIG_TYPE","MediaLibraryConfigSchema","appType","fields","array","refine","Set","map","field","size","length","ConfigSchema"],"mappings":"AAAA,SAAQA,CAAC,QAAO,WAAU;AAE1B,4EAA4E;AAC5E,kEAAkE;AAClE,qCAAqC;AAErC,cAAc,GACd,OAAO,MAAMC,wBAAwB,EAAC;AAEtC,cAAc,GACd,OAAO,MAAMC,2BAA2B,EAAC;AAEzC,cAAc,GACd,OAAO,MAAMC,wCAAwC,EAAC;AActD;;;;CAIC,GACD,OAAO,MAAMC,kBAAkB;IAC7BC,OAAO;QAAC;QAAS;KAAQ;AAC3B,EAAsD;AAQtD,qEAAqE;AACrE,SAASC,2BAA2BC,IAAkC;IACpE,MAAMC,UAAU;IAChB,OAAO;QACLC,MAAMT,EAAEU,MAAM,GAAGC,KAAK,CAACX,EAAEY,KAAK,CAACJ,SAAS,GAAGD,KAAK,qBAAqB,EAAEC,SAAS;QAChFK,KAAKb,EAAEU,MAAM;IACf;AACF;AAEA,8EAA8E;AAC9E,6CAA6C;AAC7C,SAASI,2BAA2BP,IAAwB;IAC1D,OAAO;QAAC,GAAGD,2BAA2BC,KAAK;QAAEQ,OAAOf,EAAEgB,QAAQ,CAAChB,EAAEU,MAAM;IAAG;AAC5E;AAEA,MAAMO,kBAAkBjB,EAAEkB,MAAM,CAAC;IAC/BC,MAAMnB,EAAEoB,OAAO,CAAC;IAChB,GAAGN,2BAA2B,OAAO;AACvC;AAEA,cAAc,GACd,OAAO,MAAMO,6BAA6BrB,EAAEsB,kBAAkB,CAAC,QAAQ;IAACL;CAAgB,EAAC;AAEzF,MAAMM,sBAAsBvB,EAAEkB,MAAM,CAAC;IACnCC,MAAMnB,EAAEoB,OAAO,CAAC;IAChB,GAAGN,2BAA2B,UAAU;AAC1C;AAEA,cAAc,GACd,OAAO,MAAMU,2BAA2BxB,EAAEsB,kBAAkB,CAAC,QAAQ;IAACC;CAAoB,EAAC;AAE3F,MAAME,0BAA0BzB,EAAEkB,MAAM,CAAC;IACvC,GAAGZ,2BAA2B,QAAQ;IACtCoB,QAAQ1B,EAAEgB,QAAQ,CAAChB,EAAE2B,OAAO;IAC5BZ,OAAOf,EAAEU,MAAM;AACjB;AAEA;;;CAGC,GACD,OAAO,MAAMkB,2BAA2B,sBAAqB;AAE7D,yEAAyE;AACzE,MAAMC,2BAA2B7B,EAAEkB,MAAM,CAAC;IACxCY,SAAS9B,EAAEoB,OAAO,CAAC;IACnBW,QAAQ/B,EACLgC,KAAK,CAACP,yBACNd,KAAK,CACJX,EAAEiC,MAAM,CACN,CAACF,SAAW,IAAIG,IAAIH,OAAOI,GAAG,CAAC,CAACC,QAAUA,MAAM3B,IAAI,GAAG4B,IAAI,KAAKN,OAAOO,MAAM,EAC7E;AAGR;AAEA;;;CAGC,GACD,OAAO,MAAMC,eAAevC,EAAEsB,kBAAkB,CAAC,WAAW;IAACO;CAAyB,EAAC"}
+{"version":3,"sources":["../src/contract.ts"],"sourcesContent":["import {z} from 'zod/mini'\n\n// Shared module-federation extension contract: interface (view/service) and\n// config declaration schemas, plus the versions the build stamps.\n// `zod/mini` keeps the bundle small.\n\n/** @internal */\nexport const VIEW_CONTRACT_VERSION = 1\n\n/** @internal */\nexport const SERVICE_CONTRACT_VERSION = 1\n\n/** @internal */\nexport const MEDIA_LIBRARY_CONFIG_CONTRACT_VERSION = 1\n\n/**\n * A view component. The return is opaque so the runtime helpers carry no React\n * dependency — the generated artifact renders it with the app's own React.\n * @public\n */\nexport type ViewComponent<TProps> = (props: TProps) => unknown\n\n/** @public */\nexport interface ViewComponentBaseProps<TView> {\n  view: TView\n}\n\n/**\n * Component slots each interface type exposes, in render order. Source of truth\n * for {@link InterfaceType} and the build; add a type by registering it here.\n * @internal\n */\nexport const VIEW_COMPONENTS = {\n  panel: ['title', 'panel'],\n} as const satisfies Record<string, readonly string[]>\n\n/** @public */\nexport type InterfaceType = keyof typeof VIEW_COMPONENTS\n\n/** @public */\nexport type ServiceType = 'worker'\n\n/**\n * The `app` interface's dock-placement metadata. Interface metadata is\n * discriminated on `type`; `app` is the only type with a shape so far.\n * @internal\n */\nexport const AppInterfaceMetadataSchema = z.object({\n  group: z.optional(z.string()),\n  priority: z.optional(z.number()),\n})\n\n/** @internal */\nexport type AppInterfaceMetadata = z.infer<typeof AppInterfaceMetadataSchema>\n\n/**\n * The module-federation id a build exposes an interface at. Dev stamps the same\n * id a deploy would, so the workbench loads a local interface like a deployed one.\n * @internal\n */\nexport function interfaceModuleId(type: string, name: string): string {\n  switch (type) {\n    case 'app': {\n      return 'App'\n    }\n    case 'panel': {\n      return `views/${name}`\n    }\n    case 'worker': {\n      return `services/${name}`\n    }\n    default: {\n      throw new Error(`Cannot derive a moduleId for unknown interface type: ${type}`)\n    }\n  }\n}\n\n// Shared `name` + `src`; `kind` only tailors the validation message.\nfunction extensionDeclarationFields(kind: 'Field' | 'Service' | 'View') {\n  const pattern = /^[a-zA-Z0-9_-]+$/\n  return {\n    name: z.string().check(z.regex(pattern, `${kind} \\`name\\` must match ${pattern}`)),\n    src: z.string(),\n  }\n}\n\n// Every interface (view, service) shares `name` + `src` + an optional display\n// `title` that defaults to `name` on deploy.\nfunction interfaceDeclarationFields(kind: 'Service' | 'View') {\n  return {...extensionDeclarationFields(kind), title: z.optional(z.string())}\n}\n\nconst PanelViewSchema = z.object({\n  type: z.literal('panel'),\n  ...interfaceDeclarationFields('View'),\n})\n\n/** @internal */\nexport const InterfaceDeclarationSchema = z.discriminatedUnion('type', [PanelViewSchema])\n\nconst WorkerServiceSchema = z.object({\n  type: z.literal('worker'),\n  ...interfaceDeclarationFields('Service'),\n})\n\n/** @internal */\nexport const ServiceDeclarationSchema = z.discriminatedUnion('type', [WorkerServiceSchema])\n\nconst MediaLibraryFieldSchema = z.object({\n  ...extensionDeclarationFields('Field'),\n  public: z.optional(z.boolean()),\n  title: z.string(),\n})\n\n/**\n * Stamped where the config crosses a boundary so the authoring model doesn't carry a constant discriminator.\n * @internal\n */\nexport const INSTALLATION_CONFIG_TYPE = 'installation_config'\n\n// `appType` is stamped by `unstable_defineMediaLibrary`, never authored.\nconst MediaLibraryConfigSchema = z.object({\n  appType: z.literal('media-library'),\n  fields: z\n    .array(MediaLibraryFieldSchema)\n    .check(\n      z.refine(\n        (fields) => new Set(fields.map((field) => field.name)).size === fields.length,\n        'Field `name` must be unique within a media library',\n      ),\n    ),\n})\n\n/**\n * An app's optional config, keyed by `appType`; deploys as a versioned snapshot, not an interface.\n * @internal\n */\nexport const ConfigSchema = z.discriminatedUnion('appType', [MediaLibraryConfigSchema])\n"],"names":["z","VIEW_CONTRACT_VERSION","SERVICE_CONTRACT_VERSION","MEDIA_LIBRARY_CONFIG_CONTRACT_VERSION","VIEW_COMPONENTS","panel","AppInterfaceMetadataSchema","object","group","optional","string","priority","number","interfaceModuleId","type","name","Error","extensionDeclarationFields","kind","pattern","check","regex","src","interfaceDeclarationFields","title","PanelViewSchema","literal","InterfaceDeclarationSchema","discriminatedUnion","WorkerServiceSchema","ServiceDeclarationSchema","MediaLibraryFieldSchema","public","boolean","INSTALLATION_CONFIG_TYPE","MediaLibraryConfigSchema","appType","fields","array","refine","Set","map","field","size","length","ConfigSchema"],"mappings":"AAAA,SAAQA,CAAC,QAAO,WAAU;AAE1B,4EAA4E;AAC5E,kEAAkE;AAClE,qCAAqC;AAErC,cAAc,GACd,OAAO,MAAMC,wBAAwB,EAAC;AAEtC,cAAc,GACd,OAAO,MAAMC,2BAA2B,EAAC;AAEzC,cAAc,GACd,OAAO,MAAMC,wCAAwC,EAAC;AActD;;;;CAIC,GACD,OAAO,MAAMC,kBAAkB;IAC7BC,OAAO;QAAC;QAAS;KAAQ;AAC3B,EAAsD;AAQtD;;;;CAIC,GACD,OAAO,MAAMC,6BAA6BN,EAAEO,MAAM,CAAC;IACjDC,OAAOR,EAAES,QAAQ,CAACT,EAAEU,MAAM;IAC1BC,UAAUX,EAAES,QAAQ,CAACT,EAAEY,MAAM;AAC/B,GAAE;AAKF;;;;CAIC,GACD,OAAO,SAASC,kBAAkBC,IAAY,EAAEC,IAAY;IAC1D,OAAQD;QACN,KAAK;YAAO;gBACV,OAAO;YACT;QACA,KAAK;YAAS;gBACZ,OAAO,CAAC,MAAM,EAAEC,MAAM;YACxB;QACA,KAAK;YAAU;gBACb,OAAO,CAAC,SAAS,EAAEA,MAAM;YAC3B;QACA;YAAS;gBACP,MAAM,IAAIC,MAAM,CAAC,qDAAqD,EAAEF,MAAM;YAChF;IACF;AACF;AAEA,qEAAqE;AACrE,SAASG,2BAA2BC,IAAkC;IACpE,MAAMC,UAAU;IAChB,OAAO;QACLJ,MAAMf,EAAEU,MAAM,GAAGU,KAAK,CAACpB,EAAEqB,KAAK,CAACF,SAAS,GAAGD,KAAK,qBAAqB,EAAEC,SAAS;QAChFG,KAAKtB,EAAEU,MAAM;IACf;AACF;AAEA,8EAA8E;AAC9E,6CAA6C;AAC7C,SAASa,2BAA2BL,IAAwB;IAC1D,OAAO;QAAC,GAAGD,2BAA2BC,KAAK;QAAEM,OAAOxB,EAAES,QAAQ,CAACT,EAAEU,MAAM;IAAG;AAC5E;AAEA,MAAMe,kBAAkBzB,EAAEO,MAAM,CAAC;IAC/BO,MAAMd,EAAE0B,OAAO,CAAC;IAChB,GAAGH,2BAA2B,OAAO;AACvC;AAEA,cAAc,GACd,OAAO,MAAMI,6BAA6B3B,EAAE4B,kBAAkB,CAAC,QAAQ;IAACH;CAAgB,EAAC;AAEzF,MAAMI,sBAAsB7B,EAAEO,MAAM,CAAC;IACnCO,MAAMd,EAAE0B,OAAO,CAAC;IAChB,GAAGH,2BAA2B,UAAU;AAC1C;AAEA,cAAc,GACd,OAAO,MAAMO,2BAA2B9B,EAAE4B,kBAAkB,CAAC,QAAQ;IAACC;CAAoB,EAAC;AAE3F,MAAME,0BAA0B/B,EAAEO,MAAM,CAAC;IACvC,GAAGU,2BAA2B,QAAQ;IACtCe,QAAQhC,EAAES,QAAQ,CAACT,EAAEiC,OAAO;IAC5BT,OAAOxB,EAAEU,MAAM;AACjB;AAEA;;;CAGC,GACD,OAAO,MAAMwB,2BAA2B,sBAAqB;AAE7D,yEAAyE;AACzE,MAAMC,2BAA2BnC,EAAEO,MAAM,CAAC;IACxC6B,SAASpC,EAAE0B,OAAO,CAAC;IACnBW,QAAQrC,EACLsC,KAAK,CAACP,yBACNX,KAAK,CACJpB,EAAEuC,MAAM,CACN,CAACF,SAAW,IAAIG,IAAIH,OAAOI,GAAG,CAAC,CAACC,QAAUA,MAAM3B,IAAI,GAAG4B,IAAI,KAAKN,OAAOO,MAAM,EAC7E;AAGR;AAEA;;;CAGC,GACD,OAAO,MAAMC,eAAe7C,EAAE4B,kBAAkB,CAAC,WAAW;IAACO;CAAyB,EAAC"}

package/dist/defineApp.js

@@ -1,6 +1,15 @@
 import { z } from 'zod/mini';
 import { ConfigSchema, InterfaceDeclarationSchema, ServiceDeclarationSchema } from './contract.js';
 /** Allowed characters for an app `name`. */ const APP_NAME_PATTERN = /^[a-zA-Z0-9_-]+$/;
+/**
+ * Dashboard visibility values. Mirrors `APP_VISIBILITIES` in `@sanity/cli-core`
+ * (which can't be imported here — pulling the barrel into this lean module bloats
+ * the config-load path). Kept in sync by a type test in `defineApp.test.ts`.
+ */ const APP_VISIBILITIES = [
+    'default',
+    'unlisted',
+    'disabled'
+];
 /**
  * Internal application discriminator. Sanity-owned singleton apps only;
  * validated by the schema but excluded from the public `DefineAppInput` type.
@@ -63,7 +72,8 @@ import { ConfigSchema, InterfaceDeclarationSchema, ServiceDeclarationSchema } fr
      * Views the app exposes (e.g. dock panels). Metadata only — built into
      * render artifacts and persisted to the application service on deploy, not
      * into the app manifest. View `name`s must be unique within the app.
-     */ views: z.optional(z.array(InterfaceDeclarationSchema).check(z.refine((views)=>new Set(views.map((view)=>view.name)).size === views.length, 'View `name` must be unique within an app')))
+     */ views: z.optional(z.array(InterfaceDeclarationSchema).check(z.refine((views)=>new Set(views.map((view)=>view.name)).size === views.length, 'View `name` must be unique within an app'))),
+    /** Dashboard visibility of the app. Defaults to `default` when omitted. */ visibility: z.optional(z.enum(APP_VISIBILITIES))
 }).check(// Studio app views are not implemented yet. A studio that declares `entry`
 // (the SDK app-view entrypoint) is rejected here rather than silently
 // generating one; studios keep navigating via their existing render path.

package/dist/defineApp.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/defineApp.ts"],"sourcesContent":["import {z} from 'zod/mini'\n\nimport {ConfigSchema, InterfaceDeclarationSchema, ServiceDeclarationSchema} from './contract.js'\n\n/** Allowed characters for an app `name`. */\nconst APP_NAME_PATTERN = /^[a-zA-Z0-9_-]+$/\n\n/**\n * Internal application discriminator. Sanity-owned singleton apps only;\n * validated by the schema but excluded from the public `DefineAppInput` type.\n */\nconst ApplicationType = z.enum(['coreApp', 'studio', 'canvas', 'dashboard', 'media-library'])\n\n/** Dock groups an app can place itself into. */\nconst DockGroupSchema = z.enum(['dock.system', 'dock.applications', 'dock.user'])\n\n/**\n * Dock group identifier. The API does not block a user app from declaring a\n * reserved group (e.g. `dock.system`); priority conventions keep Sanity-owned\n * apps ahead.\n * @public\n */\nexport type DockGroup = z.output<typeof DockGroupSchema>\n\n/**\n * Runtime-validation schema for `unstable_defineApp`. Validates the full shape\n * including the internal `applicationType`; the user-facing `DefineAppInput`\n * type below omits that field.\n * @internal\n */\nexport const DefineAppInputSchema = z\n  .object({\n    /**\n     * Internal — Sanity-owned singleton apps only. Validated here but excluded\n     * from the public `DefineAppInput` type.\n     * @internal\n     */\n    applicationType: z.optional(ApplicationType),\n    /**\n     * Deployed as a versioned snapshot on the app's org installation, not the\n     * application service. Singletons only. Internal, so excluded from the public\n     * `DefineAppInput` and set via `@ts-expect-error` like `applicationType`.\n     * @internal\n     */\n    config: z.optional(ConfigSchema),\n    /**\n     * App entrypoint module. Defaults to `./src/App.tsx` when omitted. The build\n     * derives the app's navigable `app` view from it. SDK apps only — setting it\n     * on a studio is rejected (studio app views are not yet implemented).\n     */\n    entry: z.optional(z.string()),\n    /** Dock group to render in. Defaults to `dock.applications` when omitted. */\n    group: z.optional(DockGroupSchema),\n    /** Optional icon override (path to an SVG). Wins over manifest/studio icon. */\n    icon: z.optional(z.string()),\n    /**\n     * Sanity-owned app deployed once, installed per org; excluded from the public `DefineAppInput`.\n     * @internal\n     */\n    isSingleton: z.optional(z.boolean()),\n    /** Unique app identifier — must match `APP_NAME_PATTERN`. */\n    name: z.string().check(z.regex(APP_NAME_PATTERN, 'App `name` must match /^[a-zA-Z0-9_-]+$/')),\n    /** Organization that owns the app — the workbench runs and deploys against it. */\n    organizationId: z.string(\n      \"App `organizationId` is required — pass the owning organization's ID to `unstable_defineApp`\",\n    ),\n    /** Sort position within the group, ascending. Defaults to `100` when omitted. */\n    priority: z.optional(z.number()),\n    /**\n     * Background services the app runs (e.g. a `worker` emitting dock badges).\n     * Metadata only — built into worker artifacts and persisted to the\n     * application service on deploy, not into the app manifest. Service `name`s\n     * must be unique within the app.\n     */\n    services: z.optional(\n      z\n        .array(ServiceDeclarationSchema)\n        .check(\n          z.refine(\n            (services) => new Set(services.map((service) => service.name)).size === services.length,\n            'Service `name` must be unique within an app',\n          ),\n        ),\n    ),\n    /**\n     * Hostname the application is created at on first deploy. Generated when\n     * omitted; redeploys target `deployment.appId` and ignore it. SDK apps\n     * only — studios use `studioHost` in sanity.cli.ts.\n     */\n    slug: z.optional(z.string()),\n    /** User-facing app title. Wins over studio.config.ts title on merge. */\n    title: z.string(),\n    /**\n     * Views the app exposes (e.g. dock panels). Metadata only — built into\n     * render artifacts and persisted to the application service on deploy, not\n     * into the app manifest. View `name`s must be unique within the app.\n     */\n    views: z.optional(\n      z\n        .array(InterfaceDeclarationSchema)\n        .check(\n          z.refine(\n            (views) => new Set(views.map((view) => view.name)).size === views.length,\n            'View `name` must be unique within an app',\n          ),\n        ),\n    ),\n  })\n  .check(\n    // Studio app views are not implemented yet. A studio that declares `entry`\n    // (the SDK app-view entrypoint) is rejected here rather than silently\n    // generating one; studios keep navigating via their existing render path.\n    z.refine((input) => !(input.applicationType === 'studio' && input.entry !== undefined), {\n      error: 'App views for studios are not implemented yet',\n      path: ['entry'],\n    }),\n  )\n  .check(\n    // An config belongs to a Sanity-owned singleton (the Media\n    // Library). A non-singleton declaring one is rejected — see\n    // {@link readConfig} for the runtime guard.\n    z.refine((input) => !(input.config && !input.isSingleton), {\n      error: '`config` is only supported for singleton apps',\n      path: ['config'],\n    }),\n  )\n\n/**\n * User-facing input for `unstable_defineApp`. Excludes the internal\n * `applicationType`, `isSingleton`, and `config` — validated by the\n * schema but not part of the public surface (Sanity-owned apps set them via\n * `@ts-expect-error`).\n * @public\n */\nexport type DefineAppInput = Omit<\n  z.output<typeof DefineAppInputSchema>,\n  'applicationType' | 'config' | 'isSingleton'\n>\n\n/**\n * Nominal brand the CLI discriminates on to enable the workbench build/deploy\n * codepath. Registered via `Symbol.for` so the marker survives module-realm\n * boundaries — `@sanity/cli-core` re-derives the same global symbol with\n * `Symbol.for` rather than importing it, so it stays internal to this module.\n */\nconst WORKBENCH_APP: unique symbol = Symbol.for('sanity.workbench.defineApp')\n\n/**\n * The branded result of `unstable_defineApp`. Carries the same fields as the\n * input plus the internal brand — users only ever see `DefineAppInput`.\n * @public\n */\nexport interface DefineAppResult extends DefineAppInput {\n  readonly [WORKBENCH_APP]: true\n}\n\n/**\n * A branded app as the CLI reads it — the full schema shape, including the\n * internal fields `DefineAppInput` omits. Schema-derived so the narrowing\n * can't drift from what the schema validates.\n * @public\n */\nexport type WorkbenchApp = DefineAppResult & z.output<typeof DefineAppInputSchema>\n\n/**\n * Whether `app` is a branded `unstable_defineApp(...)` result — the sole\n * workbench opt-in.\n * @public\n */\nexport function isWorkbenchApp(app: unknown): app is WorkbenchApp {\n  return typeof app === 'object' && app !== null && WORKBENCH_APP in app\n}\n\n/**\n * The app's config, or `undefined` when it declares none. Throws\n * when a non-singleton declares one — configs belong to Sanity-owned singletons,\n * so build/dev/deploy all read it through here to reject the combination\n * consistently.\n * @internal\n */\nexport function readConfig(app: WorkbenchApp): WorkbenchApp['config'] | undefined {\n  if (app.config && !app.isSingleton) {\n    throw new Error('`config` is only supported for singleton apps')\n  }\n  return app.config\n}\n\n/**\n * Declare a Sanity Workbench application. Identity at runtime — returns the same\n * object reference, tagged with the workbench brand. Field validation (the\n * `name` pattern etc.) runs at build time in the CLI via `DefineAppInputSchema`;\n * this helper stays a thin, pure identity wrapper.\n * @public\n */\nexport function unstable_defineApp(input: DefineAppInput): DefineAppResult {\n  return Object.defineProperty(input, WORKBENCH_APP, {\n    configurable: false,\n    enumerable: false,\n    value: true,\n    writable: false,\n  }) as DefineAppResult\n}\n\n/**\n * One custom field a media library exposes. `src` default-exports a `defineField(...)` schema type.\n * @public\n */\nexport interface MediaLibraryField {\n  /** Unique within the media library. */\n  name: string\n  src: string\n  title: string\n\n  /** Readable outside the owning organization. */\n  public?: boolean\n}\n\n/**\n * Sanity-owned singleton, so authors don't name or title the app — only `organizationId` is required.\n * @public\n */\nexport interface DefineMediaLibraryInput {\n  /** Organization that owns the media library — the CLI runs and deploys against it. */\n  organizationId: string\n\n  fields?: MediaLibraryField[]\n}\n\n/**\n * Declare the Sanity Media Library as a workbench app — a singleton whose `fields` become its config.\n * @public\n */\nexport function unstable_defineMediaLibrary(input: DefineMediaLibraryInput): DefineAppResult {\n  return unstable_defineApp({\n    // @ts-expect-error -- `applicationType`/`isSingleton`/`config` are internal, excluded from `DefineAppInput`; Sanity-owned apps set them\n    applicationType: 'media-library',\n    config: input.fields?.length ? {appType: 'media-library', fields: input.fields} : undefined,\n    isSingleton: true,\n    name: 'media-library',\n    organizationId: input.organizationId,\n    title: 'Media Library',\n  })\n}\n"],"names":["z","ConfigSchema","InterfaceDeclarationSchema","ServiceDeclarationSchema","APP_NAME_PATTERN","ApplicationType","enum","DockGroupSchema","DefineAppInputSchema","object","applicationType","optional","config","entry","string","group","icon","isSingleton","boolean","name","check","regex","organizationId","priority","number","services","array","refine","Set","map","service","size","length","slug","title","views","view","input","undefined","error","path","WORKBENCH_APP","Symbol","for","isWorkbenchApp","app","readConfig","Error","unstable_defineApp","Object","defineProperty","configurable","enumerable","value","writable","unstable_defineMediaLibrary","fields","appType"],"mappings":"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"}
+{"version":3,"sources":["../src/defineApp.ts"],"sourcesContent":["import {z} from 'zod/mini'\n\nimport {ConfigSchema, InterfaceDeclarationSchema, ServiceDeclarationSchema} from './contract.js'\n\n/** Allowed characters for an app `name`. */\nconst APP_NAME_PATTERN = /^[a-zA-Z0-9_-]+$/\n\n/**\n * Dashboard visibility values. Mirrors `APP_VISIBILITIES` in `@sanity/cli-core`\n * (which can't be imported here — pulling the barrel into this lean module bloats\n * the config-load path). Kept in sync by a type test in `defineApp.test.ts`.\n */\nconst APP_VISIBILITIES = ['default', 'unlisted', 'disabled'] as const\n\n/**\n * Internal application discriminator. Sanity-owned singleton apps only;\n * validated by the schema but excluded from the public `DefineAppInput` type.\n */\nconst ApplicationType = z.enum(['coreApp', 'studio', 'canvas', 'dashboard', 'media-library'])\n\n/** Dock groups an app can place itself into. */\nconst DockGroupSchema = z.enum(['dock.system', 'dock.applications', 'dock.user'])\n\n/**\n * Dock group identifier. The API does not block a user app from declaring a\n * reserved group (e.g. `dock.system`); priority conventions keep Sanity-owned\n * apps ahead.\n * @public\n */\nexport type DockGroup = z.output<typeof DockGroupSchema>\n\n/**\n * Runtime-validation schema for `unstable_defineApp`. Validates the full shape\n * including the internal `applicationType`; the user-facing `DefineAppInput`\n * type below omits that field.\n * @internal\n */\nexport const DefineAppInputSchema = z\n  .object({\n    /**\n     * Internal — Sanity-owned singleton apps only. Validated here but excluded\n     * from the public `DefineAppInput` type.\n     * @internal\n     */\n    applicationType: z.optional(ApplicationType),\n    /**\n     * Deployed as a versioned snapshot on the app's org installation, not the\n     * application service. Singletons only. Internal, so excluded from the public\n     * `DefineAppInput` and set via `@ts-expect-error` like `applicationType`.\n     * @internal\n     */\n    config: z.optional(ConfigSchema),\n    /**\n     * App entrypoint module. Defaults to `./src/App.tsx` when omitted. The build\n     * derives the app's navigable `app` view from it. SDK apps only — setting it\n     * on a studio is rejected (studio app views are not yet implemented).\n     */\n    entry: z.optional(z.string()),\n    /** Dock group to render in. Defaults to `dock.applications` when omitted. */\n    group: z.optional(DockGroupSchema),\n    /** Optional icon override (path to an SVG). Wins over manifest/studio icon. */\n    icon: z.optional(z.string()),\n    /**\n     * Sanity-owned app deployed once, installed per org; excluded from the public `DefineAppInput`.\n     * @internal\n     */\n    isSingleton: z.optional(z.boolean()),\n    /** Unique app identifier — must match `APP_NAME_PATTERN`. */\n    name: z.string().check(z.regex(APP_NAME_PATTERN, 'App `name` must match /^[a-zA-Z0-9_-]+$/')),\n    /** Organization that owns the app — the workbench runs and deploys against it. */\n    organizationId: z.string(\n      \"App `organizationId` is required — pass the owning organization's ID to `unstable_defineApp`\",\n    ),\n    /** Sort position within the group, ascending. Defaults to `100` when omitted. */\n    priority: z.optional(z.number()),\n    /**\n     * Background services the app runs (e.g. a `worker` emitting dock badges).\n     * Metadata only — built into worker artifacts and persisted to the\n     * application service on deploy, not into the app manifest. Service `name`s\n     * must be unique within the app.\n     */\n    services: z.optional(\n      z\n        .array(ServiceDeclarationSchema)\n        .check(\n          z.refine(\n            (services) => new Set(services.map((service) => service.name)).size === services.length,\n            'Service `name` must be unique within an app',\n          ),\n        ),\n    ),\n    /**\n     * Hostname the application is created at on first deploy. Generated when\n     * omitted; redeploys target `deployment.appId` and ignore it. SDK apps\n     * only — studios use `studioHost` in sanity.cli.ts.\n     */\n    slug: z.optional(z.string()),\n    /** User-facing app title. Wins over studio.config.ts title on merge. */\n    title: z.string(),\n    /**\n     * Views the app exposes (e.g. dock panels). Metadata only — built into\n     * render artifacts and persisted to the application service on deploy, not\n     * into the app manifest. View `name`s must be unique within the app.\n     */\n    views: z.optional(\n      z\n        .array(InterfaceDeclarationSchema)\n        .check(\n          z.refine(\n            (views) => new Set(views.map((view) => view.name)).size === views.length,\n            'View `name` must be unique within an app',\n          ),\n        ),\n    ),\n    /** Dashboard visibility of the app. Defaults to `default` when omitted. */\n    visibility: z.optional(z.enum(APP_VISIBILITIES)),\n  })\n  .check(\n    // Studio app views are not implemented yet. A studio that declares `entry`\n    // (the SDK app-view entrypoint) is rejected here rather than silently\n    // generating one; studios keep navigating via their existing render path.\n    z.refine((input) => !(input.applicationType === 'studio' && input.entry !== undefined), {\n      error: 'App views for studios are not implemented yet',\n      path: ['entry'],\n    }),\n  )\n  .check(\n    // An config belongs to a Sanity-owned singleton (the Media\n    // Library). A non-singleton declaring one is rejected — see\n    // {@link readConfig} for the runtime guard.\n    z.refine((input) => !(input.config && !input.isSingleton), {\n      error: '`config` is only supported for singleton apps',\n      path: ['config'],\n    }),\n  )\n\n/**\n * User-facing input for `unstable_defineApp`. Excludes the internal\n * `applicationType`, `isSingleton`, and `config` — validated by the\n * schema but not part of the public surface (Sanity-owned apps set them via\n * `@ts-expect-error`).\n * @public\n */\nexport type DefineAppInput = Omit<\n  z.output<typeof DefineAppInputSchema>,\n  'applicationType' | 'config' | 'isSingleton'\n>\n\n/**\n * Nominal brand the CLI discriminates on to enable the workbench build/deploy\n * codepath. Registered via `Symbol.for` so the marker survives module-realm\n * boundaries — `@sanity/cli-core` re-derives the same global symbol with\n * `Symbol.for` rather than importing it, so it stays internal to this module.\n */\nconst WORKBENCH_APP: unique symbol = Symbol.for('sanity.workbench.defineApp')\n\n/**\n * The branded result of `unstable_defineApp`. Carries the same fields as the\n * input plus the internal brand — users only ever see `DefineAppInput`.\n * @public\n */\nexport interface DefineAppResult extends DefineAppInput {\n  readonly [WORKBENCH_APP]: true\n}\n\n/**\n * A branded app as the CLI reads it — the full schema shape, including the\n * internal fields `DefineAppInput` omits. Schema-derived so the narrowing\n * can't drift from what the schema validates.\n * @public\n */\nexport type WorkbenchApp = DefineAppResult & z.output<typeof DefineAppInputSchema>\n\n/**\n * Whether `app` is a branded `unstable_defineApp(...)` result — the sole\n * workbench opt-in.\n * @public\n */\nexport function isWorkbenchApp(app: unknown): app is WorkbenchApp {\n  return typeof app === 'object' && app !== null && WORKBENCH_APP in app\n}\n\n/**\n * The app's config, or `undefined` when it declares none. Throws\n * when a non-singleton declares one — configs belong to Sanity-owned singletons,\n * so build/dev/deploy all read it through here to reject the combination\n * consistently.\n * @internal\n */\nexport function readConfig(app: WorkbenchApp): WorkbenchApp['config'] | undefined {\n  if (app.config && !app.isSingleton) {\n    throw new Error('`config` is only supported for singleton apps')\n  }\n  return app.config\n}\n\n/**\n * Declare a Sanity Workbench application. Identity at runtime — returns the same\n * object reference, tagged with the workbench brand. Field validation (the\n * `name` pattern etc.) runs at build time in the CLI via `DefineAppInputSchema`;\n * this helper stays a thin, pure identity wrapper.\n * @public\n */\nexport function unstable_defineApp(input: DefineAppInput): DefineAppResult {\n  return Object.defineProperty(input, WORKBENCH_APP, {\n    configurable: false,\n    enumerable: false,\n    value: true,\n    writable: false,\n  }) as DefineAppResult\n}\n\n/**\n * One custom field a media library exposes. `src` default-exports a `defineField(...)` schema type.\n * @public\n */\nexport interface MediaLibraryField {\n  /** Unique within the media library. */\n  name: string\n  src: string\n  title: string\n\n  /** Readable outside the owning organization. */\n  public?: boolean\n}\n\n/**\n * Sanity-owned singleton, so authors don't name or title the app — only `organizationId` is required.\n * @public\n */\nexport interface DefineMediaLibraryInput {\n  /** Organization that owns the media library — the CLI runs and deploys against it. */\n  organizationId: string\n\n  fields?: MediaLibraryField[]\n}\n\n/**\n * Declare the Sanity Media Library as a workbench app — a singleton whose `fields` become its config.\n * @public\n */\nexport function unstable_defineMediaLibrary(input: DefineMediaLibraryInput): DefineAppResult {\n  return unstable_defineApp({\n    // @ts-expect-error -- `applicationType`/`isSingleton`/`config` are internal, excluded from `DefineAppInput`; Sanity-owned apps set them\n    applicationType: 'media-library',\n    config: input.fields?.length ? {appType: 'media-library', fields: input.fields} : undefined,\n    isSingleton: true,\n    name: 'media-library',\n    organizationId: input.organizationId,\n    title: 'Media Library',\n  })\n}\n"],"names":["z","ConfigSchema","InterfaceDeclarationSchema","ServiceDeclarationSchema","APP_NAME_PATTERN","APP_VISIBILITIES","ApplicationType","enum","DockGroupSchema","DefineAppInputSchema","object","applicationType","optional","config","entry","string","group","icon","isSingleton","boolean","name","check","regex","organizationId","priority","number","services","array","refine","Set","map","service","size","length","slug","title","views","view","visibility","input","undefined","error","path","WORKBENCH_APP","Symbol","for","isWorkbenchApp","app","readConfig","Error","unstable_defineApp","Object","defineProperty","configurable","enumerable","value","writable","unstable_defineMediaLibrary","fields","appType"],"mappings":"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"}

package/dist/defineView.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/defineView.ts"],"sourcesContent":["import {\n  type InterfaceType,\n  VIEW_CONTRACT_VERSION,\n  type ViewComponent,\n  type ViewComponentBaseProps,\n} from './contract.js'\n\n/**\n * Props a panel component receives: its interface record, minus the\n * service-assigned `id`/`deployment_id` a local dev server can't provide. Mirrors\n * the `panel` record the workbench host renders from (the wire format owned by\n * `@sanity/workbench`); drift is guarded by the stamped contract version.\n * @public\n */\nexport type PanelViewProps = ViewComponentBaseProps<{\n  entry_point: string\n  interface_type: 'panel'\n  name: string\n}>\n\n/**\n * The component slots a `panel` view exposes — each its own module-federation\n * island, typed with the panel props.\n * @public\n */\nexport interface PanelViewComponents {\n  panel: ViewComponent<PanelViewProps>\n  title: ViewComponent<PanelViewProps>\n}\n\n/**\n * A panel's view-component slot — the module-federation expose for one island.\n * @public\n */\nexport type PanelComponent = keyof PanelViewComponents\n\n/**\n * The components each interface type exposes, keyed by type.\n * @public\n */\nexport interface ViewComponentsByType {\n  panel: PanelViewComponents\n}\n\n/**\n * The result of `unstable_defineView`: the author's component(s), the view type,\n * and the internal contract version the build artifact targets.\n * @public\n */\nexport interface DefinedView<TType extends InterfaceType = InterfaceType> {\n  readonly components: ViewComponentsByType[TType]\n  readonly type: TType\n  /** @internal */\n  readonly version: typeof VIEW_CONTRACT_VERSION\n}\n\n/**\n * Define a Sanity Workbench view. The first argument narrows the component shape\n * and the props each component receives — `\"panel\"` yields a `{title, panel}`\n * record whose components are typed with the panel props.\n *\n * Returns the component(s) tagged with their type and the contract version, for\n * the CLI build to generate render artifacts from. Used as the default export of\n * a view's `src` file.\n * @public\n */\nexport function unstable_defineView<TType extends InterfaceType>(\n  type: TType,\n  components: ViewComponentsByType[TType],\n): DefinedView<TType> {\n  return {components, type, version: VIEW_CONTRACT_VERSION}\n}\n"],"names":["VIEW_CONTRACT_VERSION","unstable_defineView","type","components","version"],"mappings":"AAAA,SAEEA,qBAAqB,QAGhB,gBAAe;AAmDtB;;;;;;;;;CASC,GACD,OAAO,SAASC,oBACdC,IAAW,EACXC,UAAuC;IAEvC,OAAO;QAACA;QAAYD;QAAME,SAASJ;IAAqB;AAC1D"}
+{"version":3,"sources":["../src/defineView.ts"],"sourcesContent":["import {\n  type InterfaceType,\n  VIEW_CONTRACT_VERSION,\n  type ViewComponent,\n  type ViewComponentBaseProps,\n} from './contract.js'\n\n/**\n * Props a panel component receives: its interface record, minus the\n * service-assigned `id`/`deployment_id` a local dev server can't provide. Mirrors\n * the `panel` record the workbench host renders from (the wire format owned by\n * `@sanity/workbench`); drift is guarded by the stamped contract version.\n * @public\n */\nexport type PanelViewProps = ViewComponentBaseProps<{\n  name: string\n  src: string\n  title: string\n  type: 'panel'\n}>\n\n/**\n * The component slots a `panel` view exposes — each its own module-federation\n * island, typed with the panel props.\n * @public\n */\nexport interface PanelViewComponents {\n  panel: ViewComponent<PanelViewProps>\n  title: ViewComponent<PanelViewProps>\n}\n\n/**\n * A panel's view-component slot — the module-federation expose for one island.\n * @public\n */\nexport type PanelComponent = keyof PanelViewComponents\n\n/**\n * The components each interface type exposes, keyed by type.\n * @public\n */\nexport interface ViewComponentsByType {\n  panel: PanelViewComponents\n}\n\n/**\n * The result of `unstable_defineView`: the author's component(s), the view type,\n * and the internal contract version the build artifact targets.\n * @public\n */\nexport interface DefinedView<TType extends InterfaceType = InterfaceType> {\n  readonly components: ViewComponentsByType[TType]\n  readonly type: TType\n  /** @internal */\n  readonly version: typeof VIEW_CONTRACT_VERSION\n}\n\n/**\n * Define a Sanity Workbench view. The first argument narrows the component shape\n * and the props each component receives — `\"panel\"` yields a `{title, panel}`\n * record whose components are typed with the panel props.\n *\n * Returns the component(s) tagged with their type and the contract version, for\n * the CLI build to generate render artifacts from. Used as the default export of\n * a view's `src` file.\n * @public\n */\nexport function unstable_defineView<TType extends InterfaceType>(\n  type: TType,\n  components: ViewComponentsByType[TType],\n): DefinedView<TType> {\n  return {components, type, version: VIEW_CONTRACT_VERSION}\n}\n"],"names":["VIEW_CONTRACT_VERSION","unstable_defineView","type","components","version"],"mappings":"AAAA,SAEEA,qBAAqB,QAGhB,gBAAe;AAoDtB;;;;;;;;;CASC,GACD,OAAO,SAASC,oBACdC,IAAW,EACXC,UAAuC;IAEvC,OAAO;QAACA;QAAYD;QAAME,SAASJ;IAAqB;AAC1D"}

package/dist/resolveWorkbenchApp.js

@@ -18,7 +18,8 @@ import { isWorkbenchApp, readConfig } from './defineApp.js';
         name: app.name,
         services: app.services ?? [],
         slug: app.slug,
-        views: app.views ?? []
+        views: app.views ?? [],
+        visibility: app.visibility
     };
 }
 

package/dist/resolveWorkbenchApp.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/resolveWorkbenchApp.ts"],"sourcesContent":["// Package-internal shared resolver: turn a CLI config's branded\n// `unstable_defineApp` app into its declared interfaces, or `null` for a plain\n// project. The build and deploy accessors (actions/build, actions/deploy) each\n// build their command-specific view on top of this one brand-check +\n// extraction, so the discrimination lives in exactly one place.\n\nimport {type CliConfig} from '@sanity/cli-core'\n\nimport {type DefineAppInput, isWorkbenchApp, readConfig, type WorkbenchApp} from './defineApp.js'\n\n/**\n * Bundled so adding a declaration family touches this type and the artifact\n * expanders, not every hop of build/dev plumbing in between.\n * @internal\n */\nexport interface WorkbenchExposes {\n  config?: WorkbenchApp['config']\n  services?: DefineAppInput['services']\n  views?: DefineAppInput['views']\n}\n\n/** @public */\nexport interface ResolvedWorkbenchApp {\n  /** The app's unique `name` from `unstable_defineApp`. */\n  readonly name: string\n  /** Background worker services the app declares. */\n  readonly services: NonNullable<DefineAppInput['services']>\n\n  /** Dock panel views the app declares. */\n  readonly views: NonNullable<DefineAppInput['views']>\n\n  /** Resolved app kind — `studio` or one of the SDK app types. */\n  readonly applicationType?: string\n  /** Deploys on its own path, separate from the interfaces. */\n  readonly config?: WorkbenchApp['config']\n  /** SDK app-view entrypoint, when declared. */\n  readonly entry?: string\n  /** Explicit singleton flag (a Sanity-owned app); `undefined` when the app doesn't set it. */\n  readonly isSingleton?: boolean\n  /** Hostname the application is created at on first deploy. */\n  readonly slug?: string\n}\n\n/**\n * Resolve the workbench app for a CLI config, or `null` for a plain project.\n * @public\n */\nexport function resolveWorkbenchApp(\n  cliConfig: CliConfig | null | undefined,\n): ResolvedWorkbenchApp | null {\n  const app = cliConfig?.app\n  if (!isWorkbenchApp(app)) return null\n\n  return {\n    applicationType: app.applicationType,\n    config: readConfig(app),\n    entry: app.entry,\n    isSingleton: app.isSingleton,\n    name: app.name,\n    services: app.services ?? [],\n    slug: app.slug,\n    views: app.views ?? [],\n  }\n}\n"],"names":["isWorkbenchApp","readConfig","resolveWorkbenchApp","cliConfig","app","applicationType","config","entry","isSingleton","name","services","slug","views"],"mappings":"AAAA,gEAAgE;AAChE,+EAA+E;AAC/E,+EAA+E;AAC/E,qEAAqE;AACrE,gEAAgE;AAIhE,SAA6BA,cAAc,EAAEC,UAAU,QAA0B,iBAAgB;AAmCjG;;;CAGC,GACD,OAAO,SAASC,oBACdC,SAAuC;IAEvC,MAAMC,MAAMD,WAAWC;IACvB,IAAI,CAACJ,eAAeI,MAAM,OAAO;IAEjC,OAAO;QACLC,iBAAiBD,IAAIC,eAAe;QACpCC,QAAQL,WAAWG;QACnBG,OAAOH,IAAIG,KAAK;QAChBC,aAAaJ,IAAII,WAAW;QAC5BC,MAAML,IAAIK,IAAI;QACdC,UAAUN,IAAIM,QAAQ,IAAI,EAAE;QAC5BC,MAAMP,IAAIO,IAAI;QACdC,OAAOR,IAAIQ,KAAK,IAAI,EAAE;IACxB;AACF"}
+{"version":3,"sources":["../src/resolveWorkbenchApp.ts"],"sourcesContent":["// Package-internal shared resolver: turn a CLI config's branded\n// `unstable_defineApp` app into its declared interfaces, or `null` for a plain\n// project. The build and deploy accessors (actions/build, actions/deploy) each\n// build their command-specific view on top of this one brand-check +\n// extraction, so the discrimination lives in exactly one place.\n\nimport {type AppVisibility, type CliConfig} from '@sanity/cli-core'\n\nimport {type DefineAppInput, isWorkbenchApp, readConfig, type WorkbenchApp} from './defineApp.js'\n\n/**\n * Bundled so adding a declaration family touches this type and the artifact\n * expanders, not every hop of build/dev plumbing in between.\n * @internal\n */\nexport interface WorkbenchExposes {\n  config?: WorkbenchApp['config']\n  services?: DefineAppInput['services']\n  views?: DefineAppInput['views']\n}\n\n/** @public */\nexport interface ResolvedWorkbenchApp {\n  /** The app's unique `name` from `unstable_defineApp`. */\n  readonly name: string\n  /** Background worker services the app declares. */\n  readonly services: NonNullable<DefineAppInput['services']>\n\n  /** Dock panel views the app declares. */\n  readonly views: NonNullable<DefineAppInput['views']>\n\n  /** Resolved app kind — `studio` or one of the SDK app types. */\n  readonly applicationType?: string\n  /** Deploys on its own path, separate from the interfaces. */\n  readonly config?: WorkbenchApp['config']\n  /** SDK app-view entrypoint, when declared. */\n  readonly entry?: string\n  /** Explicit singleton flag (a Sanity-owned app); `undefined` when the app doesn't set it. */\n  readonly isSingleton?: boolean\n  /** Hostname the application is created at on first deploy. */\n  readonly slug?: string\n  /** Dashboard visibility declared by the app; `undefined` when unset. */\n  readonly visibility?: AppVisibility\n}\n\n/**\n * Resolve the workbench app for a CLI config, or `null` for a plain project.\n * @public\n */\nexport function resolveWorkbenchApp(\n  cliConfig: CliConfig | null | undefined,\n): ResolvedWorkbenchApp | null {\n  const app = cliConfig?.app\n  if (!isWorkbenchApp(app)) return null\n\n  return {\n    applicationType: app.applicationType,\n    config: readConfig(app),\n    entry: app.entry,\n    isSingleton: app.isSingleton,\n    name: app.name,\n    services: app.services ?? [],\n    slug: app.slug,\n    views: app.views ?? [],\n    visibility: app.visibility,\n  }\n}\n"],"names":["isWorkbenchApp","readConfig","resolveWorkbenchApp","cliConfig","app","applicationType","config","entry","isSingleton","name","services","slug","views","visibility"],"mappings":"AAAA,gEAAgE;AAChE,+EAA+E;AAC/E,+EAA+E;AAC/E,qEAAqE;AACrE,gEAAgE;AAIhE,SAA6BA,cAAc,EAAEC,UAAU,QAA0B,iBAAgB;AAqCjG;;;CAGC,GACD,OAAO,SAASC,oBACdC,SAAuC;IAEvC,MAAMC,MAAMD,WAAWC;IACvB,IAAI,CAACJ,eAAeI,MAAM,OAAO;IAEjC,OAAO;QACLC,iBAAiBD,IAAIC,eAAe;QACpCC,QAAQL,WAAWG;QACnBG,OAAOH,IAAIG,KAAK;QAChBC,aAAaJ,IAAII,WAAW;QAC5BC,MAAML,IAAIK,IAAI;QACdC,UAAUN,IAAIM,QAAQ,IAAI,EAAE;QAC5BC,MAAMP,IAAIO,IAAI;QACdC,OAAOR,IAAIQ,KAAK,IAAI,EAAE;QACtBC,YAAYT,IAAIS,UAAU;IAC5B;AACF"}

package/dist/services/apiVersion.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/services/apiVersion.ts"],"sourcesContent":["// The app endpoints (applications + installations) live behind the\n// experimental `vX` version; a dated version returns 501.\nexport const APP_WORKBENCH_API_VERSION = 'vX'\n"],"names":["APP_WORKBENCH_API_VERSION"],"mappings":"AAAA,mEAAmE;AACnE,0DAA0D;AAC1D,OAAO,MAAMA,4BAA4B,KAAI"}