@sanity/workbench-cli 1.2.0 → 1.3.0

package/dist/actions/deploy/buildExposes.js

@@ -0,0 +1,56 @@
+/**
+ * The interface records deploy sends: the app view (only when `exposesAppView`),
+ * every view, and every service.
+ * @internal
+ */ export function buildExposes(exposes, { appName, appTitle, exposesAppView, version }) {
+    const toRecord = (prefix, decl)=>({
+            moduleId: `${prefix}/${decl.name}`,
+            name: decl.name,
+            title: decl.title ?? decl.name,
+            type: decl.type,
+            version
+        });
+    const records = [];
+    if (exposesAppView) {
+        records.push({
+            moduleId: 'App',
+            name: appName,
+            title: appTitle,
+            type: 'app',
+            version
+        });
+    }
+    for (const view of exposes.views ?? [])records.push(toRecord('views', view));
+    for (const service of exposes.services ?? [])records.push(toRecord('services', service));
+    return records;
+}
+function summarizeExposeGroup(heading, items) {
+    const label = (item)=>item.title === item.name ? item.name : `${item.title} (${item.name})`;
+    return `${heading}:\n${items.map((item)=>`  ${label(item)}: ${item.src}`).join('\n')}`;
+}
+/**
+ * The deploy summary of an app's exposes: the structured records (for `--json`)
+ * and one report line per non-empty group (for the human report).
+ * @internal
+ */ export function summarizeExposes({ services, views }) {
+    const toExpose = (decl)=>({
+            name: decl.name,
+            src: decl.src,
+            title: decl.title ?? decl.name,
+            type: decl.type
+        });
+    const viewExposes = (views ?? []).map((view)=>toExpose(view));
+    const serviceExposes = (services ?? []).map((service)=>toExpose(service));
+    const lines = [];
+    if (viewExposes.length > 0) lines.push(summarizeExposeGroup('Views', viewExposes));
+    if (serviceExposes.length > 0) lines.push(summarizeExposeGroup('Services', serviceExposes));
+    return {
+        exposes: [
+            ...viewExposes,
+            ...serviceExposes
+        ],
+        lines
+    };
+}
+
+//# sourceMappingURL=buildExposes.js.map

package/dist/actions/deploy/buildExposes.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/actions/deploy/buildExposes.ts"],"sourcesContent":["import {type WorkbenchExposes} from '../../resolveWorkbenchApp.js'\n\n/**\n * An interface as Brett stores it: the declared `type` (validated server-side,\n * not here) and the remote-relative `moduleId` the workbench loads it by — the\n * host prepends the app's own id.\n * @internal\n */\nexport interface BrettInterface {\n  moduleId: string\n  name: string\n  title: string\n  type: string\n  version: string\n}\n\ninterface BuildExposesContext {\n  appName: string\n  appTitle: string\n  /** Whether the build exposes the app view (`./App`) — apps with an `entry`, and every studio. */\n  exposesAppView: boolean\n  version: string\n}\n\n/**\n * The interface records deploy sends: the app view (only when `exposesAppView`),\n * every view, and every service.\n * @internal\n */\nexport function buildExposes(\n  exposes: WorkbenchExposes,\n  {appName, appTitle, exposesAppView, version}: BuildExposesContext,\n): BrettInterface[] {\n  const toRecord = (\n    prefix: string,\n    decl: {name: string; title?: string; type: string},\n  ): BrettInterface => ({\n    moduleId: `${prefix}/${decl.name}`,\n    name: decl.name,\n    title: decl.title ?? decl.name,\n    type: decl.type,\n    version,\n  })\n\n  const records: BrettInterface[] = []\n  if (exposesAppView) {\n    records.push({moduleId: 'App', name: appName, title: appTitle, type: 'app', version})\n  }\n  for (const view of exposes.views ?? []) records.push(toRecord('views', view))\n  for (const service of exposes.services ?? []) records.push(toRecord('services', service))\n  return records\n}\n\n/** A view or service as the deploy report and `--json` output surface it. */\nexport interface DeployedExpose {\n  name: string\n  src: string\n  title: string\n  type: string\n}\n\nfunction summarizeExposeGroup(heading: string, items: readonly DeployedExpose[]): string {\n  const label = (item: DeployedExpose) =>\n    item.title === item.name ? item.name : `${item.title} (${item.name})`\n  return `${heading}:\\n${items.map((item) => `  ${label(item)}: ${item.src}`).join('\\n')}`\n}\n\n/**\n * The deploy summary of an app's exposes: the structured records (for `--json`)\n * and one report line per non-empty group (for the human report).\n * @internal\n */\nexport function summarizeExposes({services, views}: WorkbenchExposes): {\n  exposes: DeployedExpose[]\n  lines: string[]\n} {\n  const toExpose = (decl: {\n    name: string\n    src: string\n    title?: string\n    type: string\n  }): DeployedExpose => ({\n    name: decl.name,\n    src: decl.src,\n    title: decl.title ?? decl.name,\n    type: decl.type,\n  })\n  const viewExposes = (views ?? []).map((view) => toExpose(view))\n  const serviceExposes = (services ?? []).map((service) => toExpose(service))\n\n  const lines: string[] = []\n  if (viewExposes.length > 0) lines.push(summarizeExposeGroup('Views', viewExposes))\n  if (serviceExposes.length > 0) lines.push(summarizeExposeGroup('Services', serviceExposes))\n  return {exposes: [...viewExposes, ...serviceExposes], lines}\n}\n"],"names":["buildExposes","exposes","appName","appTitle","exposesAppView","version","toRecord","prefix","decl","moduleId","name","title","type","records","push","view","views","service","services","summarizeExposeGroup","heading","items","label","item","map","src","join","summarizeExposes","toExpose","viewExposes","serviceExposes","lines","length"],"mappings":"AAwBA;;;;CAIC,GACD,OAAO,SAASA,aACdC,OAAyB,EACzB,EAACC,OAAO,EAAEC,QAAQ,EAAEC,cAAc,EAAEC,OAAO,EAAsB;IAEjE,MAAMC,WAAW,CACfC,QACAC,OACoB,CAAA;YACpBC,UAAU,GAAGF,OAAO,CAAC,EAAEC,KAAKE,IAAI,EAAE;YAClCA,MAAMF,KAAKE,IAAI;YACfC,OAAOH,KAAKG,KAAK,IAAIH,KAAKE,IAAI;YAC9BE,MAAMJ,KAAKI,IAAI;YACfP;QACF,CAAA;IAEA,MAAMQ,UAA4B,EAAE;IACpC,IAAIT,gBAAgB;QAClBS,QAAQC,IAAI,CAAC;YAACL,UAAU;YAAOC,MAAMR;YAASS,OAAOR;YAAUS,MAAM;YAAOP;QAAO;IACrF;IACA,KAAK,MAAMU,QAAQd,QAAQe,KAAK,IAAI,EAAE,CAAEH,QAAQC,IAAI,CAACR,SAAS,SAASS;IACvE,KAAK,MAAME,WAAWhB,QAAQiB,QAAQ,IAAI,EAAE,CAAEL,QAAQC,IAAI,CAACR,SAAS,YAAYW;IAChF,OAAOJ;AACT;AAUA,SAASM,qBAAqBC,OAAe,EAAEC,KAAgC;IAC7E,MAAMC,QAAQ,CAACC,OACbA,KAAKZ,KAAK,KAAKY,KAAKb,IAAI,GAAGa,KAAKb,IAAI,GAAG,GAAGa,KAAKZ,KAAK,CAAC,EAAE,EAAEY,KAAKb,IAAI,CAAC,CAAC,CAAC;IACvE,OAAO,GAAGU,QAAQ,GAAG,EAAEC,MAAMG,GAAG,CAAC,CAACD,OAAS,CAAC,EAAE,EAAED,MAAMC,MAAM,EAAE,EAAEA,KAAKE,GAAG,EAAE,EAAEC,IAAI,CAAC,OAAO;AAC1F;AAEA;;;;CAIC,GACD,OAAO,SAASC,iBAAiB,EAACT,QAAQ,EAAEF,KAAK,EAAmB;IAIlE,MAAMY,WAAW,CAACpB,OAKK,CAAA;YACrBE,MAAMF,KAAKE,IAAI;YACfe,KAAKjB,KAAKiB,GAAG;YACbd,OAAOH,KAAKG,KAAK,IAAIH,KAAKE,IAAI;YAC9BE,MAAMJ,KAAKI,IAAI;QACjB,CAAA;IACA,MAAMiB,cAAc,AAACb,CAAAA,SAAS,EAAE,AAAD,EAAGQ,GAAG,CAAC,CAACT,OAASa,SAASb;IACzD,MAAMe,iBAAiB,AAACZ,CAAAA,YAAY,EAAE,AAAD,EAAGM,GAAG,CAAC,CAACP,UAAYW,SAASX;IAElE,MAAMc,QAAkB,EAAE;IAC1B,IAAIF,YAAYG,MAAM,GAAG,GAAGD,MAAMjB,IAAI,CAACK,qBAAqB,SAASU;IACrE,IAAIC,eAAeE,MAAM,GAAG,GAAGD,MAAMjB,IAAI,CAACK,qBAAqB,YAAYW;IAC3E,OAAO;QAAC7B,SAAS;eAAI4B;eAAgBC;SAAe;QAAEC;IAAK;AAC7D"}

package/dist/actions/deploy/{deployInstallationConfig.js → deployConfig.js}

@@ -5,8 +5,7 @@ import { createGzip } from 'node:zlib';
 import { getGlobalCliClient, subdebug } from '@sanity/cli-core';
 import FormData from 'form-data';
 import { pack } from 'tar-fs';
-// Brett's app-registry endpoints live behind the experimental `vX` version.
-const INSTALLATIONS_API_VERSION = 'vX';
+import { APP_WORKBENCH_API_VERSION } from './apiVersion.js';
 const debug = subdebug('deploy');
 /**
  * The org's active installation for an app type, or `undefined` when none is
@@ -20,7 +19,7 @@ const debug = subdebug('deploy');
             }
         default:
             {
-                throw new Error(`Cannot create installation config for unknown app type: ${options.appType}`);
+                throw new Error(`Cannot create config for unknown app type: ${options.appType}`);
             }
     }
 }
@@ -28,7 +27,7 @@ const debug = subdebug('deploy');
  * A report heading and item list for a config; a media library's `fields` are
  * one of potentially many shapes.
  * @internal
- */ export function summarizeInstallationConfig(config) {
+ */ export function summarizeConfig(config) {
     switch(config.appType){
         case 'media-library':
             {
@@ -37,7 +36,7 @@ const debug = subdebug('deploy');
             }
         default:
             {
-                throw new Error(`Cannot create installation config for unknown app type: ${config.appType}`);
+                throw new Error(`Cannot create config for unknown app type: ${config.appType}`);
             }
     }
 }
@@ -46,7 +45,7 @@ const debug = subdebug('deploy');
  * snapshot. `installationId` is resolved by the caller so `--dry-run` never
  * reaches this mutating step.
  * @internal
- */ export async function deployInstallationConfig(options) {
+ */ export async function deployConfig(options) {
     const { appType, installationId, output, sourceDir, version } = options;
     const tarball = pack(dirname(sourceDir), {
         entries: [
@@ -60,7 +59,7 @@ const debug = subdebug('deploy');
         filename: 'installation-config.tar.gz'
     });
     const client = await getGlobalCliClient({
-        apiVersion: INSTALLATIONS_API_VERSION,
+        apiVersion: APP_WORKBENCH_API_VERSION,
         requireUser: true
     });
     await client.request({
@@ -69,12 +68,12 @@ const debug = subdebug('deploy');
         method: 'POST',
         uri: `/installations/${installationId}/configs`
     });
-    debug('Deployed installation config for app type: %s', appType);
-    output.log(`\n🚀 ${styleText('bold', 'Success!')} Installation config deployed`);
+    debug('Deployed config for app type: %s', appType);
+    output.log(`\n🚀 ${styleText('bold', 'Success!')} Config deployed`);
 }
 /** The org's active singleton installation, matched on its slug. */ async function resolveSingletonInstallationId(organizationId, slug) {
     const client = await getGlobalCliClient({
-        apiVersion: INSTALLATIONS_API_VERSION,
+        apiVersion: APP_WORKBENCH_API_VERSION,
         requireUser: true
     });
     // `limit=none` returns every installation in one response, no pagination.
@@ -88,4 +87,4 @@ const debug = subdebug('deploy');
     return data.find((item)=>item.application?.slug === slug)?.id;
 }
 
-//# sourceMappingURL=deployInstallationConfig.js.map
+//# sourceMappingURL=deployConfig.js.map

package/dist/actions/deploy/deployConfig.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/actions/deploy/deployConfig.ts"],"sourcesContent":["import {basename, dirname} from 'node:path'\nimport {PassThrough} from 'node:stream'\nimport {styleText} from 'node:util'\nimport {createGzip} from 'node:zlib'\n\nimport {getGlobalCliClient, type Output, subdebug} from '@sanity/cli-core'\nimport FormData from 'form-data'\nimport {pack} from 'tar-fs'\n\nimport {APP_WORKBENCH_API_VERSION} from './apiVersion.js'\n\nconst debug = subdebug('deploy')\n\ninterface InstallationListItem {\n  id: string\n\n  application?: {slug?: string}\n}\n\n/**\n * The org's active installation for an app type, or `undefined` when none is\n * installed. Read-only, so `--dry-run` can report deployability.\n * @internal\n */\nexport async function resolveInstallationId(options: {\n  appType: string\n  organizationId: string\n}): Promise<string | undefined> {\n  switch (options.appType) {\n    case 'media-library': {\n      return resolveSingletonInstallationId(options.organizationId, 'media-library')\n    }\n    default: {\n      throw new Error(`Cannot create config for unknown app type: ${options.appType}`)\n    }\n  }\n}\n\n/**\n * A report heading and item list for a config; a media library's `fields` are\n * one of potentially many shapes.\n * @internal\n */\nexport function summarizeConfig(config: {\n  appType: string\n  fields: {name: string; title: string}[]\n}): string {\n  switch (config.appType) {\n    case 'media-library': {\n      const items = config.fields.map((field) => `  ${field.title} (${field.name})`).join('\\n')\n      return `Media library fields:\\n${items}`\n    }\n    default: {\n      throw new Error(`Cannot create config for unknown app type: ${config.appType}`)\n    }\n  }\n}\n\n/**\n * Upload the built module-federation remote to the installation as its config\n * snapshot. `installationId` is resolved by the caller so `--dry-run` never\n * reaches this mutating step.\n * @internal\n */\nexport async function deployConfig(options: {\n  appType: string\n  installationId: string\n  output: Output\n  sourceDir: string\n  version: string\n}): Promise<void> {\n  const {appType, installationId, output, sourceDir, version} = options\n  const tarball = pack(dirname(sourceDir), {entries: [basename(sourceDir)]}).pipe(createGzip())\n  const formData = new FormData()\n  formData.append('version', version)\n  formData.append('tarball', tarball, {\n    contentType: 'application/gzip',\n    filename: 'installation-config.tar.gz',\n  })\n\n  const client = await getGlobalCliClient({\n    apiVersion: APP_WORKBENCH_API_VERSION,\n    requireUser: true,\n  })\n  await client.request({\n    body: formData.pipe(new PassThrough()),\n    headers: formData.getHeaders(),\n    method: 'POST',\n    uri: `/installations/${installationId}/configs`,\n  })\n\n  debug('Deployed config for app type: %s', appType)\n  output.log(`\\n🚀 ${styleText('bold', 'Success!')} Config deployed`)\n}\n\n/** The org's active singleton installation, matched on its slug. */\nasync function resolveSingletonInstallationId(\n  organizationId: string,\n  slug: string,\n): Promise<string | undefined> {\n  const client = await getGlobalCliClient({\n    apiVersion: APP_WORKBENCH_API_VERSION,\n    requireUser: true,\n  })\n  // `limit=none` returns every installation in one response, no pagination.\n  const {data}: {data: InstallationListItem[]} = await client.request({\n    query: {limit: 'none', organizationId},\n    uri: '/installations',\n  })\n  return data.find((item) => item.application?.slug === slug)?.id\n}\n"],"names":["basename","dirname","PassThrough","styleText","createGzip","getGlobalCliClient","subdebug","FormData","pack","APP_WORKBENCH_API_VERSION","debug","resolveInstallationId","options","appType","resolveSingletonInstallationId","organizationId","Error","summarizeConfig","config","items","fields","map","field","title","name","join","deployConfig","installationId","output","sourceDir","version","tarball","entries","pipe","formData","append","contentType","filename","client","apiVersion","requireUser","request","body","headers","getHeaders","method","uri","log","slug","data","query","limit","find","item","application","id"],"mappings":"AAAA,SAAQA,QAAQ,EAAEC,OAAO,QAAO,YAAW;AAC3C,SAAQC,WAAW,QAAO,cAAa;AACvC,SAAQC,SAAS,QAAO,YAAW;AACnC,SAAQC,UAAU,QAAO,YAAW;AAEpC,SAAQC,kBAAkB,EAAeC,QAAQ,QAAO,mBAAkB;AAC1E,OAAOC,cAAc,YAAW;AAChC,SAAQC,IAAI,QAAO,SAAQ;AAE3B,SAAQC,yBAAyB,QAAO,kBAAiB;AAEzD,MAAMC,QAAQJ,SAAS;AAQvB;;;;CAIC,GACD,OAAO,eAAeK,sBAAsBC,OAG3C;IACC,OAAQA,QAAQC,OAAO;QACrB,KAAK;YAAiB;gBACpB,OAAOC,+BAA+BF,QAAQG,cAAc,EAAE;YAChE;QACA;YAAS;gBACP,MAAM,IAAIC,MAAM,CAAC,2CAA2C,EAAEJ,QAAQC,OAAO,EAAE;YACjF;IACF;AACF;AAEA;;;;CAIC,GACD,OAAO,SAASI,gBAAgBC,MAG/B;IACC,OAAQA,OAAOL,OAAO;QACpB,KAAK;YAAiB;gBACpB,MAAMM,QAAQD,OAAOE,MAAM,CAACC,GAAG,CAAC,CAACC,QAAU,CAAC,EAAE,EAAEA,MAAMC,KAAK,CAAC,EAAE,EAAED,MAAME,IAAI,CAAC,CAAC,CAAC,EAAEC,IAAI,CAAC;gBACpF,OAAO,CAAC,uBAAuB,EAAEN,OAAO;YAC1C;QACA;YAAS;gBACP,MAAM,IAAIH,MAAM,CAAC,2CAA2C,EAAEE,OAAOL,OAAO,EAAE;YAChF;IACF;AACF;AAEA;;;;;CAKC,GACD,OAAO,eAAea,aAAad,OAMlC;IACC,MAAM,EAACC,OAAO,EAAEc,cAAc,EAAEC,MAAM,EAAEC,SAAS,EAAEC,OAAO,EAAC,GAAGlB;IAC9D,MAAMmB,UAAUvB,KAAKP,QAAQ4B,YAAY;QAACG,SAAS;YAAChC,SAAS6B;SAAW;IAAA,GAAGI,IAAI,CAAC7B;IAChF,MAAM8B,WAAW,IAAI3B;IACrB2B,SAASC,MAAM,CAAC,WAAWL;IAC3BI,SAASC,MAAM,CAAC,WAAWJ,SAAS;QAClCK,aAAa;QACbC,UAAU;IACZ;IAEA,MAAMC,SAAS,MAAMjC,mBAAmB;QACtCkC,YAAY9B;QACZ+B,aAAa;IACf;IACA,MAAMF,OAAOG,OAAO,CAAC;QACnBC,MAAMR,SAASD,IAAI,CAAC,IAAI/B;QACxByC,SAAST,SAASU,UAAU;QAC5BC,QAAQ;QACRC,KAAK,CAAC,eAAe,EAAEnB,eAAe,QAAQ,CAAC;IACjD;IAEAjB,MAAM,oCAAoCG;IAC1Ce,OAAOmB,GAAG,CAAC,CAAC,KAAK,EAAE5C,UAAU,QAAQ,YAAY,gBAAgB,CAAC;AACpE;AAEA,kEAAkE,GAClE,eAAeW,+BACbC,cAAsB,EACtBiC,IAAY;IAEZ,MAAMV,SAAS,MAAMjC,mBAAmB;QACtCkC,YAAY9B;QACZ+B,aAAa;IACf;IACA,0EAA0E;IAC1E,MAAM,EAACS,IAAI,EAAC,GAAmC,MAAMX,OAAOG,OAAO,CAAC;QAClES,OAAO;YAACC,OAAO;YAAQpC;QAAc;QACrC+B,KAAK;IACP;IACA,OAAOG,KAAKG,IAAI,CAAC,CAACC,OAASA,KAAKC,WAAW,EAAEN,SAASA,OAAOO;AAC/D"}

package/dist/actions/deploy/deployWorkbenchApp.js

@@ -0,0 +1,185 @@
+import { basename, dirname } from 'node:path';
+import { PassThrough } from 'node:stream';
+import { createGzip } from 'node:zlib';
+import { exitCodes, getGlobalCliClient } from '@sanity/cli-core';
+import { spinner } from '@sanity/cli-core/ux';
+import FormData from 'form-data';
+import { pack } from 'tar-fs';
+import { APP_WORKBENCH_API_VERSION } from './apiVersion.js';
+export async function getApplication(applicationId) {
+    const client = await getGlobalCliClient({
+        apiVersion: APP_WORKBENCH_API_VERSION,
+        requireUser: true
+    });
+    try {
+        return await client.request({
+            uri: `/applications/${applicationId}`
+        });
+    } catch (err) {
+        if (err?.statusCode === 404) return null;
+        throw err;
+    }
+}
+/** Create an application and its first deployment in one call. */ export async function createApplication(options) {
+    const { interfaces, isSingleton, organizationId, projectId, slug, tarball, title, type, version, workspaces } = options;
+    const formData = new FormData();
+    formData.append('type', type);
+    formData.append('title', title);
+    formData.append('organizationId', organizationId);
+    formData.append('slug', slug);
+    if (isSingleton !== undefined) formData.append('isSingleton', String(isSingleton));
+    // Studio config is set once, at create — it's immutable on redeploy.
+    if (projectId) appendJson(formData, 'config', {
+        studio: {
+            projectId
+        }
+    });
+    appendDeploymentParts(formData, {
+        interfaces,
+        tarball,
+        version,
+        workspaces
+    });
+    return request(`/applications`, formData);
+}
+/** Deploy a new active version to an existing application. */ export async function createDeployment(options) {
+    const { applicationId, interfaces, isAutoUpdating, tarball, version, workspaces } = options;
+    const formData = new FormData();
+    formData.append('isAutoUpdating', isAutoUpdating.toString());
+    appendDeploymentParts(formData, {
+        interfaces,
+        tarball,
+        version,
+        workspaces
+    });
+    return request(`/applications/${applicationId}/deployments`, formData);
+}
+function appendDeploymentParts(formData, { interfaces, tarball, version, workspaces }) {
+    formData.append('version', version);
+    appendJson(formData, 'interfaces', interfaces);
+    // Studio-only — the server rejects a workspaces part on non-studio types.
+    if (workspaces?.length) appendJson(formData, 'workspaces', workspaces);
+    formData.append('tarball', tarball, {
+        contentType: 'application/gzip',
+        filename: 'app.tar.gz'
+    });
+}
+/** Structured parts must arrive as JSON so the server parses them. */ function appendJson(formData, name, value) {
+    formData.append(name, JSON.stringify(value), {
+        contentType: 'application/json'
+    });
+}
+async function request(uri, formData) {
+    const client = await getGlobalCliClient({
+        apiVersion: APP_WORKBENCH_API_VERSION,
+        requireUser: true
+    });
+    return client.request({
+        body: formData.pipe(new PassThrough()),
+        headers: formData.getHeaders(),
+        method: 'POST',
+        uri
+    });
+}
+/**
+ * Deploy a workbench coreApp through Brett: redeploy when `appId` is set,
+ * otherwise create the application at `slug`. Returns the application id for the
+ * shell to report.
+ * @internal
+ */ export async function deployCoreApp(options) {
+    const { appId, interfaces, isAutoUpdating, isSingleton, organizationId, slug, sourceDir, title, version } = options;
+    const tarball = pack(dirname(sourceDir), {
+        entries: [
+            basename(sourceDir)
+        ]
+    }).pipe(createGzip());
+    const spin = spinner('Deploying...').start();
+    try {
+        if (appId) {
+            await createDeployment({
+                applicationId: appId,
+                interfaces,
+                isAutoUpdating,
+                tarball,
+                version
+            });
+            spin.succeed();
+            return {
+                applicationId: appId
+            };
+        }
+        const { id } = await createApplication({
+            interfaces,
+            isSingleton,
+            organizationId,
+            slug,
+            tarball,
+            title,
+            type: 'coreApp',
+            version
+        });
+        spin.succeed();
+        return {
+            applicationId: id
+        };
+    } catch (error) {
+        spin.clear();
+        throw error;
+    }
+}
+/**
+ * Deploy a workbench studio through Brett: redeploy when `appId` is set,
+ * otherwise create the studio at `studioHost`. Returns the application id for
+ * the shell to report; a missing `studioHost` on create is a usage error.
+ * @internal
+ */ export async function deployStudio(options) {
+    const { appId, interfaces, isAutoUpdating, organizationId, output, projectId, sourceDir, studioHost, title, version, workspaces } = options;
+    const tarball = pack(dirname(sourceDir), {
+        entries: [
+            basename(sourceDir)
+        ]
+    }).pipe(createGzip());
+    const spin = spinner('Deploying to sanity.studio').start();
+    try {
+        if (appId) {
+            await createDeployment({
+                applicationId: appId,
+                interfaces,
+                isAutoUpdating,
+                tarball,
+                version,
+                workspaces
+            });
+            spin.succeed();
+            return {
+                applicationId: appId
+            };
+        }
+        if (!studioHost) {
+            spin.fail();
+            return output.error('No studio hostname configured. Set `studioHost` in sanity.cli.ts to create a studio.', {
+                exit: exitCodes.USAGE_ERROR
+            });
+        }
+        const application = await createApplication({
+            interfaces,
+            organizationId,
+            projectId,
+            slug: studioHost,
+            tarball,
+            title,
+            type: 'studio',
+            version,
+            workspaces
+        });
+        spin.succeed();
+        return {
+            applicationId: application.id
+        };
+    } catch (error) {
+        spin.fail();
+        throw error;
+    }
+}
+
+//# sourceMappingURL=deployWorkbenchApp.js.map

package/dist/actions/deploy/deployWorkbenchApp.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/actions/deploy/deployWorkbenchApp.ts"],"sourcesContent":["import {basename, dirname} from 'node:path'\nimport {PassThrough} from 'node:stream'\nimport {createGzip, type Gzip} from 'node:zlib'\n\nimport {exitCodes, getGlobalCliClient, type Output} from '@sanity/cli-core'\nimport {spinner} from '@sanity/cli-core/ux'\nimport FormData from 'form-data'\nimport {pack} from 'tar-fs'\n\nimport {APP_WORKBENCH_API_VERSION} from './apiVersion.js'\nimport {type BrettInterface} from './buildExposes.js'\n\nexport type ApplicationType = 'coreApp' | 'studio'\n\nexport interface Application {\n  id: string\n  organizationId: string\n  slug: string | null\n  title: string\n  type: ApplicationType\n}\n\n/** A studio workspace as Brett stores it. */\nexport interface BrettWorkspace {\n  dataset: string\n  projectId: string\n\n  basePath?: string\n  icon?: string\n  name?: string\n  subtitle?: string\n  title?: string\n}\n\nexport async function getApplication(applicationId: string): Promise<Application | null> {\n  const client = await getGlobalCliClient({\n    apiVersion: APP_WORKBENCH_API_VERSION,\n    requireUser: true,\n  })\n  try {\n    return await client.request({uri: `/applications/${applicationId}`})\n  } catch (err) {\n    if ((err as {statusCode?: number})?.statusCode === 404) return null\n    throw err\n  }\n}\n\n/** Create an application and its first deployment in one call. */\nexport async function createApplication(options: {\n  interfaces: readonly BrettInterface[]\n  isSingleton?: boolean\n  organizationId: string\n  projectId?: string\n  slug: string\n  tarball: Gzip\n  title: string\n  type: ApplicationType\n  version: string\n  workspaces?: readonly BrettWorkspace[]\n}): Promise<Application> {\n  const {\n    interfaces,\n    isSingleton,\n    organizationId,\n    projectId,\n    slug,\n    tarball,\n    title,\n    type,\n    version,\n    workspaces,\n  } = options\n  const formData = new FormData()\n  formData.append('type', type)\n  formData.append('title', title)\n  formData.append('organizationId', organizationId)\n  formData.append('slug', slug)\n  if (isSingleton !== undefined) formData.append('isSingleton', String(isSingleton))\n  // Studio config is set once, at create — it's immutable on redeploy.\n  if (projectId) appendJson(formData, 'config', {studio: {projectId}})\n  appendDeploymentParts(formData, {interfaces, tarball, version, workspaces})\n  return request(`/applications`, formData)\n}\n\n/** Deploy a new active version to an existing application. */\nexport async function createDeployment(options: {\n  applicationId: string\n  interfaces: readonly BrettInterface[]\n  isAutoUpdating: boolean\n  tarball: Gzip\n  version: string\n  workspaces?: readonly BrettWorkspace[]\n}): Promise<{id: string}> {\n  const {applicationId, interfaces, isAutoUpdating, tarball, version, workspaces} = options\n  const formData = new FormData()\n  formData.append('isAutoUpdating', isAutoUpdating.toString())\n  appendDeploymentParts(formData, {interfaces, tarball, version, workspaces})\n  return request(`/applications/${applicationId}/deployments`, formData)\n}\n\nfunction appendDeploymentParts(\n  formData: FormData,\n  {\n    interfaces,\n    tarball,\n    version,\n    workspaces,\n  }: {\n    interfaces: readonly BrettInterface[]\n    tarball: Gzip\n    version: string\n    workspaces?: readonly BrettWorkspace[]\n  },\n): void {\n  formData.append('version', version)\n  appendJson(formData, 'interfaces', interfaces)\n  // Studio-only — the server rejects a workspaces part on non-studio types.\n  if (workspaces?.length) appendJson(formData, 'workspaces', workspaces)\n  formData.append('tarball', tarball, {contentType: 'application/gzip', filename: 'app.tar.gz'})\n}\n\n/** Structured parts must arrive as JSON so the server parses them. */\nfunction appendJson(formData: FormData, name: string, value: unknown): void {\n  formData.append(name, JSON.stringify(value), {contentType: 'application/json'})\n}\n\nasync function request<T>(uri: string, formData: FormData): Promise<T> {\n  const client = await getGlobalCliClient({\n    apiVersion: APP_WORKBENCH_API_VERSION,\n    requireUser: true,\n  })\n  return client.request({\n    body: formData.pipe(new PassThrough()),\n    headers: formData.getHeaders(),\n    method: 'POST',\n    uri,\n  })\n}\n\n/**\n * Deploy a workbench coreApp through Brett: redeploy when `appId` is set,\n * otherwise create the application at `slug`. Returns the application id for the\n * shell to report.\n * @internal\n */\nexport async function deployCoreApp(options: {\n  appId: string | undefined\n  interfaces: readonly BrettInterface[]\n  isAutoUpdating: boolean\n  isSingleton?: boolean\n  organizationId: string\n  slug: string\n  sourceDir: string\n  title: string\n  version: string\n}): Promise<{applicationId: string}> {\n  const {\n    appId,\n    interfaces,\n    isAutoUpdating,\n    isSingleton,\n    organizationId,\n    slug,\n    sourceDir,\n    title,\n    version,\n  } = options\n  const tarball = pack(dirname(sourceDir), {entries: [basename(sourceDir)]}).pipe(createGzip())\n\n  const spin = spinner('Deploying...').start()\n  try {\n    if (appId) {\n      await createDeployment({applicationId: appId, interfaces, isAutoUpdating, tarball, version})\n      spin.succeed()\n      return {applicationId: appId}\n    }\n\n    const {id} = await createApplication({\n      interfaces,\n      isSingleton,\n      organizationId,\n      slug,\n      tarball,\n      title,\n      type: 'coreApp',\n      version,\n    })\n    spin.succeed()\n    return {applicationId: id}\n  } catch (error) {\n    spin.clear()\n    throw error\n  }\n}\n\n/**\n * Deploy a workbench studio through Brett: redeploy when `appId` is set,\n * otherwise create the studio at `studioHost`. Returns the application id for\n * the shell to report; a missing `studioHost` on create is a usage error.\n * @internal\n */\nexport async function deployStudio(options: {\n  appId: string | undefined\n  interfaces: readonly BrettInterface[]\n  isAutoUpdating: boolean\n  organizationId: string\n  output: Output\n  projectId: string | undefined\n  sourceDir: string\n  studioHost: string | undefined\n  title: string\n  version: string\n  workspaces: readonly BrettWorkspace[]\n}): Promise<{applicationId: string}> {\n  const {\n    appId,\n    interfaces,\n    isAutoUpdating,\n    organizationId,\n    output,\n    projectId,\n    sourceDir,\n    studioHost,\n    title,\n    version,\n    workspaces,\n  } = options\n  const tarball = pack(dirname(sourceDir), {entries: [basename(sourceDir)]}).pipe(createGzip())\n\n  const spin = spinner('Deploying to sanity.studio').start()\n  try {\n    if (appId) {\n      await createDeployment({\n        applicationId: appId,\n        interfaces,\n        isAutoUpdating,\n        tarball,\n        version,\n        workspaces,\n      })\n      spin.succeed()\n      return {applicationId: appId}\n    }\n\n    if (!studioHost) {\n      spin.fail()\n      return output.error(\n        'No studio hostname configured. Set `studioHost` in sanity.cli.ts to create a studio.',\n        {exit: exitCodes.USAGE_ERROR},\n      )\n    }\n\n    const application = await createApplication({\n      interfaces,\n      organizationId,\n      projectId,\n      slug: studioHost,\n      tarball,\n      title,\n      type: 'studio',\n      version,\n      workspaces,\n    })\n    spin.succeed()\n    return {applicationId: application.id}\n  } catch (error) {\n    spin.fail()\n    throw error\n  }\n}\n"],"names":["basename","dirname","PassThrough","createGzip","exitCodes","getGlobalCliClient","spinner","FormData","pack","APP_WORKBENCH_API_VERSION","getApplication","applicationId","client","apiVersion","requireUser","request","uri","err","statusCode","createApplication","options","interfaces","isSingleton","organizationId","projectId","slug","tarball","title","type","version","workspaces","formData","append","undefined","String","appendJson","studio","appendDeploymentParts","createDeployment","isAutoUpdating","toString","length","contentType","filename","name","value","JSON","stringify","body","pipe","headers","getHeaders","method","deployCoreApp","appId","sourceDir","entries","spin","start","succeed","id","error","clear","deployStudio","output","studioHost","fail","exit","USAGE_ERROR","application"],"mappings":"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"}

package/dist/actions/deploy/getWorkbench.js

@@ -7,14 +7,14 @@ import { buildViewDeploymentPayload } from './viewDeployment.js';
 export function getWorkbench(cliConfig) {
     const app = resolveWorkbenchApp(cliConfig);
     if (!app) return null;
-    const { entry, installationConfig, isSingleton, services, views } = app;
+    const { config, entry, isSingleton, services, views } = app;
     return {
         ...app,
-        deploySingletonInstallationConfig: isSingleton && !!installationConfig,
+        deploySingletonConfig: !!isSingleton && !!config,
         hasInterfaces: !!entry || views.length > 0 || services.length > 0,
         assertDeployable () {
-            if (!entry && views.length === 0 && services.length === 0 && !installationConfig) {
-                throw new Error('Nothing to deploy: the app declares no entry, views, services or installation config. ' + 'Add at least one to the app config.');
+            if (!entry && views.length === 0 && services.length === 0 && !config) {
+                throw new Error('Nothing to deploy: the app declares no entry, views, services or config. ' + 'Add at least one to the app config.');
             }
         },
         buildViewDeploymentPayload (applicationId) {

package/dist/actions/deploy/getWorkbench.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/actions/deploy/getWorkbench.ts"],"sourcesContent":["// The deploy command's view of a workbench app: the resolved interfaces plus\n// the deploy-time guards that need the app's declarations. `sanity deploy` calls\n// `getWorkbench(config)` once and either gets `null` (plain project — normal\n// deploy) or an object it asks to validate the app before shipping.\n\nimport {type CliConfig} from '@sanity/cli-core'\n\nimport {type ResolvedWorkbenchApp, resolveWorkbenchApp} from '../../resolveWorkbenchApp.js'\nimport {buildViewDeploymentPayload, type ViewDeploymentPayload} from './viewDeployment.js'\n\ninterface DeployableWorkbenchApp extends ResolvedWorkbenchApp {\n  /**\n   * Throws when the app exposes nothing (no entry, view, service, or config) —\n   * the remote would have nothing to load. Gated before any prompt or API call.\n   */\n  assertDeployable(): void\n  /**\n   * Validates the app's declared views into the application-service payload.\n   * Throws when a view declaration is malformed.\n   */\n  buildViewDeploymentPayload(applicationId: string): ViewDeploymentPayload\n  /**\n   * A singleton (the Media Library) that carries an installation config — deploy\n   * persists the config to the org's installation. Independent of the interfaces,\n   * which register regardless; non-singletons never carry a config.\n   */\n  deploySingletonInstallationConfig: boolean\n  /** Declares something to host as an application — an entry, view, or service. */\n  hasInterfaces: boolean\n}\n\nexport function getWorkbench(\n  cliConfig: CliConfig | null | undefined,\n): DeployableWorkbenchApp | null {\n  const app = resolveWorkbenchApp(cliConfig)\n  if (!app) return null\n\n  const {entry, installationConfig, isSingleton, services, views} = app\n\n  return {\n    ...app,\n\n    deploySingletonInstallationConfig: isSingleton && !!installationConfig,\n    hasInterfaces: !!entry || views.length > 0 || services.length > 0,\n\n    assertDeployable() {\n      if (!entry && views.length === 0 && services.length === 0 && !installationConfig) {\n        throw new Error(\n          'Nothing to deploy: the app declares no entry, views, services or installation config. ' +\n            'Add at least one to the app config.',\n        )\n      }\n    },\n\n    buildViewDeploymentPayload(applicationId) {\n      return buildViewDeploymentPayload({applicationId, views})\n    },\n  }\n}\n"],"names":["resolveWorkbenchApp","buildViewDeploymentPayload","getWorkbench","cliConfig","app","entry","installationConfig","isSingleton","services","views","deploySingletonInstallationConfig","hasInterfaces","length","assertDeployable","Error","applicationId"],"mappings":"AAAA,6EAA6E;AAC7E,iFAAiF;AACjF,6EAA6E;AAC7E,oEAAoE;AAIpE,SAAmCA,mBAAmB,QAAO,+BAA8B;AAC3F,SAAQC,0BAA0B,QAAmC,sBAAqB;AAuB1F,OAAO,SAASC,aACdC,SAAuC;IAEvC,MAAMC,MAAMJ,oBAAoBG;IAChC,IAAI,CAACC,KAAK,OAAO;IAEjB,MAAM,EAACC,KAAK,EAAEC,kBAAkB,EAAEC,WAAW,EAAEC,QAAQ,EAAEC,KAAK,EAAC,GAAGL;IAElE,OAAO;QACL,GAAGA,GAAG;QAENM,mCAAmCH,eAAe,CAAC,CAACD;QACpDK,eAAe,CAAC,CAACN,SAASI,MAAMG,MAAM,GAAG,KAAKJ,SAASI,MAAM,GAAG;QAEhEC;YACE,IAAI,CAACR,SAASI,MAAMG,MAAM,KAAK,KAAKJ,SAASI,MAAM,KAAK,KAAK,CAACN,oBAAoB;gBAChF,MAAM,IAAIQ,MACR,2FACE;YAEN;QACF;QAEAb,4BAA2Bc,aAAa;YACtC,OAAOd,2BAA2B;gBAACc;gBAAeN;YAAK;QACzD;IACF;AACF"}
+{"version":3,"sources":["../../../src/actions/deploy/getWorkbench.ts"],"sourcesContent":["// The deploy command's view of a workbench app: the resolved interfaces plus\n// the deploy-time guards that need the app's declarations. `sanity deploy` calls\n// `getWorkbench(config)` once and either gets `null` (plain project — normal\n// deploy) or an object it asks to validate the app before shipping.\n\nimport {type CliConfig} from '@sanity/cli-core'\n\nimport {type ResolvedWorkbenchApp, resolveWorkbenchApp} from '../../resolveWorkbenchApp.js'\nimport {buildViewDeploymentPayload, type ViewDeploymentPayload} from './viewDeployment.js'\n\ninterface DeployableWorkbenchApp extends ResolvedWorkbenchApp {\n  /**\n   * Throws when the app exposes nothing (no entry, view, service, or config) —\n   * the remote would have nothing to load. Gated before any prompt or API call.\n   */\n  assertDeployable(): void\n  /**\n   * Validates the app's declared views into the application-service payload.\n   * Throws when a view declaration is malformed.\n   */\n  buildViewDeploymentPayload(applicationId: string): ViewDeploymentPayload\n  /**\n   * A singleton (the Media Library) that carries an config — deploy\n   * persists the config to the org's installation. Independent of the interfaces,\n   * which register regardless; non-singletons never carry a config.\n   */\n  deploySingletonConfig: boolean\n  /** Declares something to host as an application — an entry, view, or service. */\n  hasInterfaces: boolean\n}\n\nexport function getWorkbench(\n  cliConfig: CliConfig | null | undefined,\n): DeployableWorkbenchApp | null {\n  const app = resolveWorkbenchApp(cliConfig)\n  if (!app) return null\n\n  const {config, entry, isSingleton, services, views} = app\n\n  return {\n    ...app,\n\n    deploySingletonConfig: !!isSingleton && !!config,\n    hasInterfaces: !!entry || views.length > 0 || services.length > 0,\n\n    assertDeployable() {\n      if (!entry && views.length === 0 && services.length === 0 && !config) {\n        throw new Error(\n          'Nothing to deploy: the app declares no entry, views, services or config. ' +\n            'Add at least one to the app config.',\n        )\n      }\n    },\n\n    buildViewDeploymentPayload(applicationId) {\n      return buildViewDeploymentPayload({applicationId, views})\n    },\n  }\n}\n"],"names":["resolveWorkbenchApp","buildViewDeploymentPayload","getWorkbench","cliConfig","app","config","entry","isSingleton","services","views","deploySingletonConfig","hasInterfaces","length","assertDeployable","Error","applicationId"],"mappings":"AAAA,6EAA6E;AAC7E,iFAAiF;AACjF,6EAA6E;AAC7E,oEAAoE;AAIpE,SAAmCA,mBAAmB,QAAO,+BAA8B;AAC3F,SAAQC,0BAA0B,QAAmC,sBAAqB;AAuB1F,OAAO,SAASC,aACdC,SAAuC;IAEvC,MAAMC,MAAMJ,oBAAoBG;IAChC,IAAI,CAACC,KAAK,OAAO;IAEjB,MAAM,EAACC,MAAM,EAAEC,KAAK,EAAEC,WAAW,EAAEC,QAAQ,EAAEC,KAAK,EAAC,GAAGL;IAEtD,OAAO;QACL,GAAGA,GAAG;QAENM,uBAAuB,CAAC,CAACH,eAAe,CAAC,CAACF;QAC1CM,eAAe,CAAC,CAACL,SAASG,MAAMG,MAAM,GAAG,KAAKJ,SAASI,MAAM,GAAG;QAEhEC;YACE,IAAI,CAACP,SAASG,MAAMG,MAAM,KAAK,KAAKJ,SAASI,MAAM,KAAK,KAAK,CAACP,QAAQ;gBACpE,MAAM,IAAIS,MACR,8EACE;YAEN;QACF;QAEAb,4BAA2Bc,aAAa;YACtC,OAAOd,2BAA2B;gBAACc;gBAAeN;YAAK;QACzD;IACF;AACF"}

package/dist/actions/dev/deriveInterfaces.js

@@ -1,11 +1,15 @@
-import { isWorkbenchApp, readInstallationConfig } from '../../defineApp.js';
+import { hash } from 'node:crypto';
+import { MEDIA_LIBRARY_CONFIG_CONTRACT_VERSION, SERVICE_CONTRACT_VERSION, VIEW_CONTRACT_VERSION } from '../../contract.js';
+import { isWorkbenchApp, readConfig } from '../../defineApp.js';
 /**
  * Map a workbench app's declarations to the interface records forwarded on its
  * registry entry: `views` → panels, `services` → workers, `entry` → the
  * navigable `app` view (`entry_point` is the raw `src`, not a resolved URL).
  * `undefined` for a non-branded app; a studio that declares `entry` is rejected
- * (studio app views are not implemented yet). The installation config is not an
- * interface — see {@link deriveInstallationConfigs}.
+ * (studio app views are not implemented yet). The config is not an
+ * interface — see {@link deriveConfigs}. `version` is the contract version the
+ * interface's generated module exports, known before the module runs; the app
+ * view has no versioned contract, so it carries none.
  */ export function deriveInterfaces(app, options) {
     if (!isWorkbenchApp(app)) return undefined;
     if (!options.isApp && app.entry !== undefined) {
@@ -15,12 +19,14 @@ import { isWorkbenchApp, readInstallationConfig } from '../../defineApp.js';
         ...app.views?.map((view)=>({
                 entry_point: view.src,
                 interface_type: view.type,
-                name: view.name
+                name: view.name,
+                version: VIEW_CONTRACT_VERSION
             })) ?? [],
         ...app.services?.map((service)=>({
                 entry_point: service.src,
                 interface_type: service.type,
-                name: service.name
+                name: service.name,
+                version: SERVICE_CONTRACT_VERSION
             })) ?? [],
         ...app.entry === undefined ? [] : [
             {
@@ -36,7 +42,7 @@ import { isWorkbenchApp, readInstallationConfig } from '../../defineApp.js';
  * per app type — the projection the exposes-set id keys on, so the generic HMR
  * tracker owns none of the per-type shape. Throws on an app type it can't
  * handle, so a new config family has to register its shape here.
- */ export function deriveInstallationConfigEntries(config) {
+ */ export function deriveConfigEntries(config) {
     switch(config.appType){
         case 'media-library':
             {
@@ -47,7 +53,7 @@ import { isWorkbenchApp, readInstallationConfig } from '../../defineApp.js';
             }
         default:
             {
-                throw new Error(`Cannot derive entries for unknown installation config appType: ${config.appType}`);
+                throw new Error(`Cannot derive entries for unknown config appType: ${config.appType}`);
             }
     }
 }
@@ -55,21 +61,29 @@ import { isWorkbenchApp, readInstallationConfig } from '../../defineApp.js';
  * The fields' schema *values* can't serialize — the workbench loads them from
  * the federation module. `src` stays on so the exposes-set id keys on it and a
  * repoint rebuilds. `appType` routes the config to the singleton (no app id to
- * key on).
- */ export function deriveInstallationConfigs(app) {
+ * key on). `id` is a content hash of the entry — it fills the
+ * installation-config id slot deployed apps get from the applications API,
+ * and the workbench keys change detection on it. `version` is the config
+ * contract version the generated module exports, known before the module runs.
+ */ export function deriveConfigs(app) {
     if (!isWorkbenchApp(app)) return [];
-    const installationConfig = readInstallationConfig(app);
-    if (!installationConfig) return [];
+    const config = readConfig(app);
+    if (!config) return [];
+    const entry = {
+        appType: config.appType,
+        fields: config.fields.map((field)=>({
+                name: field.name,
+                public: field.public,
+                src: field.src,
+                title: field.title
+            })),
+        moduleName: app.name,
+        version: MEDIA_LIBRARY_CONFIG_CONTRACT_VERSION
+    };
     return [
         {
-            appType: installationConfig.appType,
-            fields: installationConfig.fields.map((field)=>({
-                    name: field.name,
-                    public: field.public,
-                    src: field.src,
-                    title: field.title
-                })),
-            moduleName: app.name
+            ...entry,
+            id: hash('sha1', JSON.stringify(entry))
         }
     ];
 }

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

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/actions/dev/deriveInterfaces.ts"],"sourcesContent":["import {type CliConfig} from '@sanity/cli-core'\n\nimport {isWorkbenchApp, readInstallationConfig} from '../../defineApp.js'\nimport {type DevServerManifest} from './registry.js'\n\n/** One forwarded interface record on the dev-server registry entry. */\nexport type DevServerInterface = NonNullable<DevServerManifest['interfaces']>[number]\n\n/** One forwarded installation config on the dev-server registry entry. */\nexport type DevServerConfig = NonNullable<DevServerManifest['installationConfigs']>[number]\n\n/**\n * Map a workbench app's declarations to the interface records forwarded on its\n * registry entry: `views` → panels, `services` → workers, `entry` → the\n * navigable `app` view (`entry_point` is the raw `src`, not a resolved URL).\n * `undefined` for a non-branded app; a studio that declares `entry` is rejected\n * (studio app views are not implemented yet). The installation config is not an\n * interface — see {@link deriveInstallationConfigs}.\n */\nexport function deriveInterfaces(\n  app: CliConfig['app'],\n  options: {isApp: boolean},\n): DevServerInterface[] | undefined {\n  if (!isWorkbenchApp(app)) return undefined\n\n  if (!options.isApp && app.entry !== undefined) {\n    throw new Error('App views for studios are not implemented yet')\n  }\n\n  return [\n    ...(app.views?.map((view) => ({\n      entry_point: view.src,\n      interface_type: view.type,\n      name: view.name,\n    })) ?? []),\n    ...(app.services?.map((service) => ({\n      entry_point: service.src,\n      interface_type: service.type,\n      name: service.name,\n    })) ?? []),\n    ...(app.entry === undefined\n      ? []\n      : [{entry_point: app.entry, interface_type: 'app' as const, name: app.name}]),\n  ]\n}\n\n/**\n * The named source files a config's generated module is built from, dispatched\n * per app type — the projection the exposes-set id keys on, so the generic HMR\n * tracker owns none of the per-type shape. Throws on an app type it can't\n * handle, so a new config family has to register its shape here.\n */\nexport function deriveInstallationConfigEntries(\n  config: DevServerConfig,\n): {name: string; src: string}[] {\n  switch (config.appType) {\n    case 'media-library': {\n      return config.fields.map((field) => ({name: field.name, src: field.src}))\n    }\n    default: {\n      throw new Error(\n        `Cannot derive entries for unknown installation config appType: ${config.appType}`,\n      )\n    }\n  }\n}\n\n/**\n * The fields' schema *values* can't serialize — the workbench loads them from\n * the federation module. `src` stays on so the exposes-set id keys on it and a\n * repoint rebuilds. `appType` routes the config to the singleton (no app id to\n * key on).\n */\nexport function deriveInstallationConfigs(app: CliConfig['app']): DevServerConfig[] {\n  if (!isWorkbenchApp(app)) return []\n  const installationConfig = readInstallationConfig(app)\n  if (!installationConfig) return []\n  return [\n    {\n      appType: installationConfig.appType,\n      fields: installationConfig.fields.map((field) => ({\n        name: field.name,\n        public: field.public,\n        src: field.src,\n        title: field.title,\n      })),\n      moduleName: app.name,\n    },\n  ]\n}\n"],"names":["isWorkbenchApp","readInstallationConfig","deriveInterfaces","app","options","undefined","isApp","entry","Error","views","map","view","entry_point","src","interface_type","type","name","services","service","deriveInstallationConfigEntries","config","appType","fields","field","deriveInstallationConfigs","installationConfig","public","title","moduleName"],"mappings":"AAEA,SAAQA,cAAc,EAAEC,sBAAsB,QAAO,qBAAoB;AASzE;;;;;;;CAOC,GACD,OAAO,SAASC,iBACdC,GAAqB,EACrBC,OAAyB;IAEzB,IAAI,CAACJ,eAAeG,MAAM,OAAOE;IAEjC,IAAI,CAACD,QAAQE,KAAK,IAAIH,IAAII,KAAK,KAAKF,WAAW;QAC7C,MAAM,IAAIG,MAAM;IAClB;IAEA,OAAO;WACDL,IAAIM,KAAK,EAAEC,IAAI,CAACC,OAAU,CAAA;gBAC5BC,aAAaD,KAAKE,GAAG;gBACrBC,gBAAgBH,KAAKI,IAAI;gBACzBC,MAAML,KAAKK,IAAI;YACjB,CAAA,MAAO,EAAE;WACLb,IAAIc,QAAQ,EAAEP,IAAI,CAACQ,UAAa,CAAA;gBAClCN,aAAaM,QAAQL,GAAG;gBACxBC,gBAAgBI,QAAQH,IAAI;gBAC5BC,MAAME,QAAQF,IAAI;YACpB,CAAA,MAAO,EAAE;WACLb,IAAII,KAAK,KAAKF,YACd,EAAE,GACF;YAAC;gBAACO,aAAaT,IAAII,KAAK;gBAAEO,gBAAgB;gBAAgBE,MAAMb,IAAIa,IAAI;YAAA;SAAE;KAC/E;AACH;AAEA;;;;;CAKC,GACD,OAAO,SAASG,gCACdC,MAAuB;IAEvB,OAAQA,OAAOC,OAAO;QACpB,KAAK;YAAiB;gBACpB,OAAOD,OAAOE,MAAM,CAACZ,GAAG,CAAC,CAACa,QAAW,CAAA;wBAACP,MAAMO,MAAMP,IAAI;wBAAEH,KAAKU,MAAMV,GAAG;oBAAA,CAAA;YACxE;QACA;YAAS;gBACP,MAAM,IAAIL,MACR,CAAC,+DAA+D,EAAEY,OAAOC,OAAO,EAAE;YAEtF;IACF;AACF;AAEA;;;;;CAKC,GACD,OAAO,SAASG,0BAA0BrB,GAAqB;IAC7D,IAAI,CAACH,eAAeG,MAAM,OAAO,EAAE;IACnC,MAAMsB,qBAAqBxB,uBAAuBE;IAClD,IAAI,CAACsB,oBAAoB,OAAO,EAAE;IAClC,OAAO;QACL;YACEJ,SAASI,mBAAmBJ,OAAO;YACnCC,QAAQG,mBAAmBH,MAAM,CAACZ,GAAG,CAAC,CAACa,QAAW,CAAA;oBAChDP,MAAMO,MAAMP,IAAI;oBAChBU,QAAQH,MAAMG,MAAM;oBACpBb,KAAKU,MAAMV,GAAG;oBACdc,OAAOJ,MAAMI,KAAK;gBACpB,CAAA;YACAC,YAAYzB,IAAIa,IAAI;QACtB;KACD;AACH"}
+{"version":3,"sources":["../../../src/actions/dev/deriveInterfaces.ts"],"sourcesContent":["import {hash} from 'node:crypto'\n\nimport {type CliConfig} from '@sanity/cli-core'\n\nimport {\n  MEDIA_LIBRARY_CONFIG_CONTRACT_VERSION,\n  SERVICE_CONTRACT_VERSION,\n  VIEW_CONTRACT_VERSION,\n} from '../../contract.js'\nimport {isWorkbenchApp, readConfig} from '../../defineApp.js'\nimport {type DevServerManifest} from './registry.js'\n\n/** One forwarded interface record on the dev-server registry entry. */\nexport type DevServerInterface = NonNullable<DevServerManifest['interfaces']>[number]\n\n/** One forwarded config on the dev-server registry entry. */\nexport type DevServerConfig = NonNullable<DevServerManifest['configs']>[number]\n\n/**\n * Map a workbench app's declarations to the interface records forwarded on its\n * registry entry: `views` → panels, `services` → workers, `entry` → the\n * navigable `app` view (`entry_point` is the raw `src`, not a resolved URL).\n * `undefined` for a non-branded app; a studio that declares `entry` is rejected\n * (studio app views are not implemented yet). The config is not an\n * interface — see {@link deriveConfigs}. `version` is the contract version the\n * interface's generated module exports, known before the module runs; the app\n * view has no versioned contract, so it carries none.\n */\nexport function deriveInterfaces(\n  app: CliConfig['app'],\n  options: {isApp: boolean},\n): DevServerInterface[] | undefined {\n  if (!isWorkbenchApp(app)) return undefined\n\n  if (!options.isApp && app.entry !== undefined) {\n    throw new Error('App views for studios are not implemented yet')\n  }\n\n  return [\n    ...(app.views?.map((view) => ({\n      entry_point: view.src,\n      interface_type: view.type,\n      name: view.name,\n      version: VIEW_CONTRACT_VERSION,\n    })) ?? []),\n    ...(app.services?.map((service) => ({\n      entry_point: service.src,\n      interface_type: service.type,\n      name: service.name,\n      version: SERVICE_CONTRACT_VERSION,\n    })) ?? []),\n    ...(app.entry === undefined\n      ? []\n      : [{entry_point: app.entry, interface_type: 'app' as const, name: app.name}]),\n  ]\n}\n\n/**\n * The named source files a config's generated module is built from, dispatched\n * per app type — the projection the exposes-set id keys on, so the generic HMR\n * tracker owns none of the per-type shape. Throws on an app type it can't\n * handle, so a new config family has to register its shape here.\n */\nexport function deriveConfigEntries(config: DevServerConfig): {name: string; src: string}[] {\n  switch (config.appType) {\n    case 'media-library': {\n      return config.fields.map((field) => ({name: field.name, src: field.src}))\n    }\n    default: {\n      throw new Error(`Cannot derive entries for unknown config appType: ${config.appType}`)\n    }\n  }\n}\n\n/**\n * The fields' schema *values* can't serialize — the workbench loads them from\n * the federation module. `src` stays on so the exposes-set id keys on it and a\n * repoint rebuilds. `appType` routes the config to the singleton (no app id to\n * key on). `id` is a content hash of the entry — it fills the\n * installation-config id slot deployed apps get from the applications API,\n * and the workbench keys change detection on it. `version` is the config\n * contract version the generated module exports, known before the module runs.\n */\nexport function deriveConfigs(app: CliConfig['app']): DevServerConfig[] {\n  if (!isWorkbenchApp(app)) return []\n  const config = readConfig(app)\n  if (!config) return []\n  const entry = {\n    appType: config.appType,\n    fields: config.fields.map((field) => ({\n      name: field.name,\n      public: field.public,\n      src: field.src,\n      title: field.title,\n    })),\n    moduleName: app.name,\n    version: MEDIA_LIBRARY_CONFIG_CONTRACT_VERSION,\n  }\n  return [{...entry, id: hash('sha1', JSON.stringify(entry))}]\n}\n"],"names":["hash","MEDIA_LIBRARY_CONFIG_CONTRACT_VERSION","SERVICE_CONTRACT_VERSION","VIEW_CONTRACT_VERSION","isWorkbenchApp","readConfig","deriveInterfaces","app","options","undefined","isApp","entry","Error","views","map","view","entry_point","src","interface_type","type","name","version","services","service","deriveConfigEntries","config","appType","fields","field","deriveConfigs","public","title","moduleName","id","JSON","stringify"],"mappings":"AAAA,SAAQA,IAAI,QAAO,cAAa;AAIhC,SACEC,qCAAqC,EACrCC,wBAAwB,EACxBC,qBAAqB,QAChB,oBAAmB;AAC1B,SAAQC,cAAc,EAAEC,UAAU,QAAO,qBAAoB;AAS7D;;;;;;;;;CASC,GACD,OAAO,SAASC,iBACdC,GAAqB,EACrBC,OAAyB;IAEzB,IAAI,CAACJ,eAAeG,MAAM,OAAOE;IAEjC,IAAI,CAACD,QAAQE,KAAK,IAAIH,IAAII,KAAK,KAAKF,WAAW;QAC7C,MAAM,IAAIG,MAAM;IAClB;IAEA,OAAO;WACDL,IAAIM,KAAK,EAAEC,IAAI,CAACC,OAAU,CAAA;gBAC5BC,aAAaD,KAAKE,GAAG;gBACrBC,gBAAgBH,KAAKI,IAAI;gBACzBC,MAAML,KAAKK,IAAI;gBACfC,SAASlB;YACX,CAAA,MAAO,EAAE;WACLI,IAAIe,QAAQ,EAAER,IAAI,CAACS,UAAa,CAAA;gBAClCP,aAAaO,QAAQN,GAAG;gBACxBC,gBAAgBK,QAAQJ,IAAI;gBAC5BC,MAAMG,QAAQH,IAAI;gBAClBC,SAASnB;YACX,CAAA,MAAO,EAAE;WACLK,IAAII,KAAK,KAAKF,YACd,EAAE,GACF;YAAC;gBAACO,aAAaT,IAAII,KAAK;gBAAEO,gBAAgB;gBAAgBE,MAAMb,IAAIa,IAAI;YAAA;SAAE;KAC/E;AACH;AAEA;;;;;CAKC,GACD,OAAO,SAASI,oBAAoBC,MAAuB;IACzD,OAAQA,OAAOC,OAAO;QACpB,KAAK;YAAiB;gBACpB,OAAOD,OAAOE,MAAM,CAACb,GAAG,CAAC,CAACc,QAAW,CAAA;wBAACR,MAAMQ,MAAMR,IAAI;wBAAEH,KAAKW,MAAMX,GAAG;oBAAA,CAAA;YACxE;QACA;YAAS;gBACP,MAAM,IAAIL,MAAM,CAAC,kDAAkD,EAAEa,OAAOC,OAAO,EAAE;YACvF;IACF;AACF;AAEA;;;;;;;;CAQC,GACD,OAAO,SAASG,cAActB,GAAqB;IACjD,IAAI,CAACH,eAAeG,MAAM,OAAO,EAAE;IACnC,MAAMkB,SAASpB,WAAWE;IAC1B,IAAI,CAACkB,QAAQ,OAAO,EAAE;IACtB,MAAMd,QAAQ;QACZe,SAASD,OAAOC,OAAO;QACvBC,QAAQF,OAAOE,MAAM,CAACb,GAAG,CAAC,CAACc,QAAW,CAAA;gBACpCR,MAAMQ,MAAMR,IAAI;gBAChBU,QAAQF,MAAME,MAAM;gBACpBb,KAAKW,MAAMX,GAAG;gBACdc,OAAOH,MAAMG,KAAK;YACpB,CAAA;QACAC,YAAYzB,IAAIa,IAAI;QACpBC,SAASpB;IACX;IACA,OAAO;QAAC;YAAC,GAAGU,KAAK;YAAEsB,IAAIjC,KAAK,QAAQkC,KAAKC,SAAS,CAACxB;QAAO;KAAE;AAC9D"}

package/dist/actions/dev/exposesSetId.js

@@ -1,23 +1,23 @@
-import { deriveInstallationConfigEntries } from './deriveInterfaces.js';
+import { deriveConfigEntries } from './deriveInterfaces.js';
 /**
  * Order-independent id of an app's exposed-module set. Keys each interface by
- * its type, name, and source file, and each installation config by its module
+ * its type, name, and source file, and each config by its module
  * identity plus one key per entry (a named source file), so the id changes on
  * any rebuild-worthy edit — add, remove, rename, repoint, or gaining/losing the
  * config module — while reordering and HMR content edits keep it stable.
- */ export function exposesSetId({ installationConfigs, interfaces }) {
+ */ export function exposesSetId({ configs, interfaces }) {
     const keys = [
         ...(interfaces ?? []).map((iface)=>[
                 iface.interface_type,
                 iface.name,
                 iface.entry_point
             ].join('::')),
-        ...(installationConfigs ?? []).flatMap((config)=>[
+        ...(configs ?? []).flatMap((config)=>[
                 [
                     'config',
                     config.appType
                 ].join('::'),
-                ...deriveInstallationConfigEntries(config).map((entry)=>[
+                ...deriveConfigEntries(config).map((entry)=>[
                         'config',
                         config.appType,
                         entry.name,
@@ -42,7 +42,7 @@ import { deriveInstallationConfigEntries } from './deriveInterfaces.js';
 }
 const serverKey = (server)=>`${server.id ?? ''}@${server.host ?? ''}:${server.port}`;
 const serverExposesId = (server)=>exposesSetId({
-        installationConfigs: server.installationConfigs,
+        configs: server.configs,
         interfaces: server.interfaces
     });
 /**

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

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/actions/dev/exposesSetId.ts"],"sourcesContent":["import {\n  deriveInstallationConfigEntries,\n  type DevServerConfig,\n  type DevServerInterface,\n} from './deriveInterfaces.js'\nimport {type DevServerManifest} from './registry.js'\n\ninterface ExposeSet {\n  installationConfigs?: 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 installation 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({installationConfigs, interfaces}: ExposeSet): string {\n  const keys = [\n    ...(interfaces ?? []).map((iface) =>\n      [iface.interface_type, iface.name, iface.entry_point].join('::'),\n    ),\n    ...(installationConfigs ?? []).flatMap((config) => [\n      ['config', config.appType].join('::'),\n      ...deriveInstallationConfigEntries(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({installationConfigs: server.installationConfigs, 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":["deriveInstallationConfigEntries","exposesSetId","installationConfigs","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,+BAA+B,QAG1B,wBAAuB;AAQ9B;;;;;;CAMC,GACD,OAAO,SAASC,aAAa,EAACC,mBAAmB,EAAEC,UAAU,EAAY;IACvE,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,uBAAuB,EAAE,AAAD,EAAGS,OAAO,CAAC,CAACC,SAAW;gBACjD;oBAAC;oBAAUA,OAAOC,OAAO;iBAAC,CAACH,IAAI,CAAC;mBAC7BV,gCAAgCY,QAAQP,GAAG,CAAC,CAACS,QAC9C;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,qBAAqBuB,OAAOvB,mBAAmB;QAAEC,YAAYsB,OAAOtB,UAAU;IAAA;AAE9F;;;;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) =>\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"}