@sanity/workbench-cli 1.2.0 → 1.3.0

package/dist/_exports/build.d.ts

@@ -4,14 +4,14 @@ import { z } from "zod/mini";
 
 /**
  * User-facing input for `unstable_defineApp`. Excludes the internal
- * `applicationType`, `isSingleton`, and `installationConfig` — validated by the
+ * `applicationType`, `isSingleton`, and `config` — validated by the
  * schema but not part of the public surface (Sanity-owned apps set them via
  * `@ts-expect-error`).
  * @public
  */
 declare type DefineAppInput = Omit<
   z.output<typeof DefineAppInputSchema>,
-  "applicationType" | "installationConfig" | "isSingleton"
+  "applicationType" | "config" | "isSingleton"
 >;
 
 /**
@@ -31,16 +31,7 @@ declare const DefineAppInputSchema: z.ZodMiniObject<
         dashboard: "dashboard";
       }>
     >;
-    entry: z.ZodMiniOptional<z.ZodMiniString<string>>;
-    group: z.ZodMiniOptional<
-      z.ZodMiniEnum<{
-        "dock.system": "dock.system";
-        "dock.applications": "dock.applications";
-        "dock.user": "dock.user";
-      }>
-    >;
-    icon: z.ZodMiniOptional<z.ZodMiniString<string>>;
-    installationConfig: z.ZodMiniOptional<
+    config: z.ZodMiniOptional<
       z.ZodMiniDiscriminatedUnion<
         [
           z.ZodMiniObject<
@@ -64,6 +55,15 @@ declare const DefineAppInputSchema: z.ZodMiniObject<
         "appType"
       >
     >;
+    entry: z.ZodMiniOptional<z.ZodMiniString<string>>;
+    group: z.ZodMiniOptional<
+      z.ZodMiniEnum<{
+        "dock.system": "dock.system";
+        "dock.applications": "dock.applications";
+        "dock.user": "dock.user";
+      }>
+    >;
+    icon: z.ZodMiniOptional<z.ZodMiniString<string>>;
     isSingleton: z.ZodMiniOptional<z.ZodMiniBoolean<boolean>>;
     name: z.ZodMiniString<string>;
     organizationId: z.ZodMiniString<string>;
@@ -74,6 +74,7 @@ declare const DefineAppInputSchema: z.ZodMiniObject<
           [
             z.ZodMiniObject<
               {
+                title: z.ZodMiniOptional<z.ZodMiniString<string>>;
                 name: z.ZodMiniString<string>;
                 src: z.ZodMiniString<string>;
                 type: z.ZodMiniLiteral<"worker">;
@@ -85,6 +86,7 @@ declare const DefineAppInputSchema: z.ZodMiniObject<
         >
       >
     >;
+    slug: z.ZodMiniOptional<z.ZodMiniString<string>>;
     title: z.ZodMiniString<string>;
     views: z.ZodMiniOptional<
       z.ZodMiniArray<
@@ -92,6 +94,7 @@ declare const DefineAppInputSchema: z.ZodMiniObject<
           [
             z.ZodMiniObject<
               {
+                title: z.ZodMiniOptional<z.ZodMiniString<string>>;
                 name: z.ZodMiniString<string>;
                 src: z.ZodMiniString<string>;
                 type: z.ZodMiniLiteral<"panel">;
@@ -118,8 +121,6 @@ declare interface DefineAppResult extends DefineAppInput {
 
 /** @public */
 declare interface ResolvedWorkbenchApp {
-  /** A Sanity-owned singleton (e.g. the Media Library) — deploys its config, not an application. */
-  readonly isSingleton: boolean;
   /** The app's unique `name` from `unstable_defineApp`. */
   readonly name: string;
   /** Background worker services the app declares. */
@@ -128,10 +129,14 @@ declare interface ResolvedWorkbenchApp {
   readonly views: NonNullable<DefineAppInput["views"]>;
   /** Resolved app kind — `studio` or one of the SDK app types. */
   readonly applicationType?: string;
+  /** Deploys on its own path, separate from the interfaces. */
+  readonly config?: WorkbenchApp["config"];
   /** SDK app-view entrypoint, when declared. */
   readonly entry?: string;
-  /** Deploys on its own path, separate from the interfaces. */
-  readonly installationConfig?: WorkbenchApp["installationConfig"];
+  /** Explicit singleton flag (a Sanity-owned app); `undefined` when the app doesn't set it. */
+  readonly isSingleton?: boolean;
+  /** Hostname the application is created at on first deploy. */
+  readonly slug?: string;
 }
 
 /**
@@ -165,7 +170,7 @@ declare type WorkbenchApp = DefineAppResult &
  * @internal
  */
 export declare interface WorkbenchExposes {
-  installationConfig?: WorkbenchApp["installationConfig"];
+  config?: WorkbenchApp["config"];
   services?: DefineAppInput["services"];
   views?: DefineAppInput["views"];
 }

package/dist/_exports/deploy.d.ts

@@ -2,6 +2,59 @@ import { CliConfig } from "@sanity/cli-core";
 import { Output } from "@sanity/cli-core";
 import { z } from "zod/mini";
 
+export declare interface Application {
+  id: string;
+  organizationId: string;
+  slug: string | null;
+  title: string;
+  type: ApplicationType;
+}
+
+declare type ApplicationType = "coreApp" | "studio";
+
+/**
+ * An interface as Brett stores it: the declared `type` (validated server-side,
+ * not here) and the remote-relative `moduleId` the workbench loads it by — the
+ * host prepends the app's own id.
+ * @internal
+ */
+export declare interface BrettInterface {
+  moduleId: string;
+  name: string;
+  title: string;
+  type: string;
+  version: string;
+}
+
+/** A studio workspace as Brett stores it. */
+export declare interface BrettWorkspace {
+  dataset: string;
+  projectId: string;
+  basePath?: string;
+  icon?: string;
+  name?: string;
+  subtitle?: string;
+  title?: string;
+}
+
+/**
+ * The interface records deploy sends: the app view (only when `exposesAppView`),
+ * every view, and every service.
+ * @internal
+ */
+export declare function buildExposes(
+  exposes: WorkbenchExposes,
+  { appName, appTitle, exposesAppView, version }: BuildExposesContext,
+): BrettInterface[];
+
+declare interface BuildExposesContext {
+  appName: string;
+  appTitle: string;
+  /** Whether the build exposes the app view (`./App`) — apps with an `entry`, and every studio. */
+  exposesAppView: boolean;
+  version: string;
+}
+
 /**
  * Throws unless `sourceDir` is a directory holding a federation build.
  * Workbench builds emit a module-federation remote instead of a static SPA,
@@ -12,14 +65,14 @@ export declare function checkBuiltOutput(sourceDir: string): Promise<void>;
 
 /**
  * User-facing input for `unstable_defineApp`. Excludes the internal
- * `applicationType`, `isSingleton`, and `installationConfig` — validated by the
+ * `applicationType`, `isSingleton`, and `config` — validated by the
  * schema but not part of the public surface (Sanity-owned apps set them via
  * `@ts-expect-error`).
  * @public
  */
 declare type DefineAppInput = Omit<
   z.output<typeof DefineAppInputSchema>,
-  "applicationType" | "installationConfig" | "isSingleton"
+  "applicationType" | "config" | "isSingleton"
 >;
 
 /**
@@ -39,16 +92,7 @@ declare const DefineAppInputSchema: z.ZodMiniObject<
         dashboard: "dashboard";
       }>
     >;
-    entry: z.ZodMiniOptional<z.ZodMiniString<string>>;
-    group: z.ZodMiniOptional<
-      z.ZodMiniEnum<{
-        "dock.system": "dock.system";
-        "dock.applications": "dock.applications";
-        "dock.user": "dock.user";
-      }>
-    >;
-    icon: z.ZodMiniOptional<z.ZodMiniString<string>>;
-    installationConfig: z.ZodMiniOptional<
+    config: z.ZodMiniOptional<
       z.ZodMiniDiscriminatedUnion<
         [
           z.ZodMiniObject<
@@ -72,6 +116,15 @@ declare const DefineAppInputSchema: z.ZodMiniObject<
         "appType"
       >
     >;
+    entry: z.ZodMiniOptional<z.ZodMiniString<string>>;
+    group: z.ZodMiniOptional<
+      z.ZodMiniEnum<{
+        "dock.system": "dock.system";
+        "dock.applications": "dock.applications";
+        "dock.user": "dock.user";
+      }>
+    >;
+    icon: z.ZodMiniOptional<z.ZodMiniString<string>>;
     isSingleton: z.ZodMiniOptional<z.ZodMiniBoolean<boolean>>;
     name: z.ZodMiniString<string>;
     organizationId: z.ZodMiniString<string>;
@@ -82,6 +135,7 @@ declare const DefineAppInputSchema: z.ZodMiniObject<
           [
             z.ZodMiniObject<
               {
+                title: z.ZodMiniOptional<z.ZodMiniString<string>>;
                 name: z.ZodMiniString<string>;
                 src: z.ZodMiniString<string>;
                 type: z.ZodMiniLiteral<"worker">;
@@ -93,6 +147,7 @@ declare const DefineAppInputSchema: z.ZodMiniObject<
         >
       >
     >;
+    slug: z.ZodMiniOptional<z.ZodMiniString<string>>;
     title: z.ZodMiniString<string>;
     views: z.ZodMiniOptional<
       z.ZodMiniArray<
@@ -100,6 +155,7 @@ declare const DefineAppInputSchema: z.ZodMiniObject<
           [
             z.ZodMiniObject<
               {
+                title: z.ZodMiniOptional<z.ZodMiniString<string>>;
                 name: z.ZodMiniString<string>;
                 src: z.ZodMiniString<string>;
                 type: z.ZodMiniLiteral<"panel">;
@@ -136,11 +192,11 @@ declare interface DeployableWorkbenchApp extends ResolvedWorkbenchApp {
    */
   buildViewDeploymentPayload(applicationId: string): ViewDeploymentPayload;
   /**
-   * A singleton (the Media Library) that carries an installation config — deploy
+   * A singleton (the Media Library) that carries an config — deploy
    * persists the config to the org's installation. Independent of the interfaces,
    * which register regardless; non-singletons never carry a config.
    */
-  deploySingletonInstallationConfig: boolean;
+  deploySingletonConfig: boolean;
   /** Declares something to host as an application — an entry, view, or service. */
   hasInterfaces: boolean;
 }
@@ -151,7 +207,7 @@ declare interface DeployableWorkbenchApp extends ResolvedWorkbenchApp {
  * reaches this mutating step.
  * @internal
  */
-export declare function deployInstallationConfig(options: {
+export declare function deployConfig(options: {
   appType: string;
   installationId: string;
   output: Output;
@@ -159,14 +215,66 @@ export declare function deployInstallationConfig(options: {
   version: string;
 }): Promise<void>;
 
+/**
+ * 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 declare function deployCoreApp(options: {
+  appId: string | undefined;
+  interfaces: readonly BrettInterface[];
+  isAutoUpdating: boolean;
+  isSingleton?: boolean;
+  organizationId: string;
+  slug: string;
+  sourceDir: string;
+  title: string;
+  version: string;
+}): Promise<{
+  applicationId: string;
+}>;
+
+/** A view or service as the deploy report and `--json` output surface it. */
+export declare interface DeployedExpose {
+  name: string;
+  src: string;
+  title: string;
+  type: string;
+}
+
+/**
+ * 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 declare function deployStudio(options: {
+  appId: string | undefined;
+  interfaces: readonly BrettInterface[];
+  isAutoUpdating: boolean;
+  organizationId: string;
+  output: Output;
+  projectId: string | undefined;
+  sourceDir: string;
+  studioHost: string | undefined;
+  title: string;
+  version: string;
+  workspaces: readonly BrettWorkspace[];
+}): Promise<{
+  applicationId: string;
+}>;
+
+export declare function getApplication(
+  applicationId: string,
+): Promise<Application | null>;
+
 export declare function getWorkbench(
   cliConfig: CliConfig | null | undefined,
 ): DeployableWorkbenchApp | null;
 
 /** @public */
 declare interface ResolvedWorkbenchApp {
-  /** A Sanity-owned singleton (e.g. the Media Library) — deploys its config, not an application. */
-  readonly isSingleton: boolean;
   /** The app's unique `name` from `unstable_defineApp`. */
   readonly name: string;
   /** Background worker services the app declares. */
@@ -175,10 +283,14 @@ declare interface ResolvedWorkbenchApp {
   readonly views: NonNullable<DefineAppInput["views"]>;
   /** Resolved app kind — `studio` or one of the SDK app types. */
   readonly applicationType?: string;
+  /** Deploys on its own path, separate from the interfaces. */
+  readonly config?: WorkbenchApp["config"];
   /** SDK app-view entrypoint, when declared. */
   readonly entry?: string;
-  /** Deploys on its own path, separate from the interfaces. */
-  readonly installationConfig?: WorkbenchApp["installationConfig"];
+  /** Explicit singleton flag (a Sanity-owned app); `undefined` when the app doesn't set it. */
+  readonly isSingleton?: boolean;
+  /** Hostname the application is created at on first deploy. */
+  readonly slug?: string;
 }
 
 /**
@@ -196,7 +308,7 @@ export declare function resolveInstallationId(options: {
  * one of potentially many shapes.
  * @internal
  */
-export declare function summarizeInstallationConfig(config: {
+export declare function summarizeConfig(config: {
   appType: string;
   fields: {
     name: string;
@@ -204,6 +316,19 @@ export declare function summarizeInstallationConfig(config: {
   }[];
 }): string;
 
+/**
+ * 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 declare function summarizeExposes({
+  services,
+  views,
+}: WorkbenchExposes): {
+  exposes: DeployedExpose[];
+  lines: string[];
+};
+
 declare type ViewDeploymentPayload = z.infer<
   typeof viewDeploymentPayloadSchema
 >;
@@ -251,4 +376,15 @@ declare const WORKBENCH_APP: unique symbol;
 declare type WorkbenchApp = DefineAppResult &
   z.output<typeof DefineAppInputSchema>;
 
+/**
+ * Bundled so adding a declaration family touches this type and the artifact
+ * expanders, not every hop of build/dev plumbing in between.
+ * @internal
+ */
+declare interface WorkbenchExposes {
+  config?: WorkbenchApp["config"];
+  services?: DefineAppInput["services"];
+  views?: DefineAppInput["views"];
+}
+
 export {};

package/dist/_exports/deploy.js

@@ -1,5 +1,7 @@
+export { buildExposes, summarizeExposes } from '../actions/deploy/buildExposes.js';
 export { checkBuiltOutput } from '../actions/deploy/checkBuiltOutput.js';
-export { deployInstallationConfig, resolveInstallationId, summarizeInstallationConfig } from '../actions/deploy/deployInstallationConfig.js';
+export { deployConfig, resolveInstallationId, summarizeConfig } from '../actions/deploy/deployConfig.js';
+export { deployCoreApp, deployStudio, getApplication } from '../actions/deploy/deployWorkbenchApp.js';
 export { getWorkbench } from '../actions/deploy/getWorkbench.js';
 
 //# sourceMappingURL=deploy.js.map

package/dist/_exports/deploy.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/_exports/deploy.ts"],"sourcesContent":["export {checkBuiltOutput} from '../actions/deploy/checkBuiltOutput.js'\nexport {\n  deployInstallationConfig,\n  resolveInstallationId,\n  summarizeInstallationConfig,\n} from '../actions/deploy/deployInstallationConfig.js'\nexport {getWorkbench} from '../actions/deploy/getWorkbench.js'\n"],"names":["checkBuiltOutput","deployInstallationConfig","resolveInstallationId","summarizeInstallationConfig","getWorkbench"],"mappings":"AAAA,SAAQA,gBAAgB,QAAO,wCAAuC;AACtE,SACEC,wBAAwB,EACxBC,qBAAqB,EACrBC,2BAA2B,QACtB,gDAA+C;AACtD,SAAQC,YAAY,QAAO,oCAAmC"}
+{"version":3,"sources":["../../src/_exports/deploy.ts"],"sourcesContent":["export {\n  type BrettInterface,\n  buildExposes,\n  type DeployedExpose,\n  summarizeExposes,\n} from '../actions/deploy/buildExposes.js'\nexport {checkBuiltOutput} from '../actions/deploy/checkBuiltOutput.js'\nexport {\n  deployConfig,\n  resolveInstallationId,\n  summarizeConfig,\n} from '../actions/deploy/deployConfig.js'\nexport {\n  type Application,\n  type BrettWorkspace,\n  deployCoreApp,\n  deployStudio,\n  getApplication,\n} from '../actions/deploy/deployWorkbenchApp.js'\nexport {getWorkbench} from '../actions/deploy/getWorkbench.js'\n"],"names":["buildExposes","summarizeExposes","checkBuiltOutput","deployConfig","resolveInstallationId","summarizeConfig","deployCoreApp","deployStudio","getApplication","getWorkbench"],"mappings":"AAAA,SAEEA,YAAY,EAEZC,gBAAgB,QACX,oCAAmC;AAC1C,SAAQC,gBAAgB,QAAO,wCAAuC;AACtE,SACEC,YAAY,EACZC,qBAAqB,EACrBC,eAAe,QACV,oCAAmC;AAC1C,SAGEC,aAAa,EACbC,YAAY,EACZC,cAAc,QACT,0CAAyC;AAChD,SAAQC,YAAY,QAAO,oCAAmC"}

package/dist/_exports/dev.d.ts

@@ -30,9 +30,7 @@ declare type DevServerManifest = z.infer<typeof devServerManifestSchema>;
 
 declare const devServerManifestSchema: z.ZodMiniObject<
   {
-    host: z.ZodMiniString<string>;
-    id: z.ZodMiniOptional<z.ZodMiniString<string>>;
-    installationConfigs: z.ZodMiniOptional<
+    configs: z.ZodMiniOptional<
       z.ZodMiniArray<
         z.ZodMiniObject<
           {
@@ -48,12 +46,16 @@ declare const devServerManifestSchema: z.ZodMiniObject<
                 z.core.$strip
               >
             >;
+            id: z.ZodMiniString<string>;
             moduleName: z.ZodMiniOptional<z.ZodMiniString<string>>;
+            version: z.ZodMiniNumber<number>;
           },
           z.core.$strip
         >
       >
     >;
+    host: z.ZodMiniString<string>;
+    id: z.ZodMiniOptional<z.ZodMiniString<string>>;
     interfaces: z.ZodMiniOptional<
       z.ZodMiniArray<
         z.ZodMiniObject<
@@ -61,6 +63,7 @@ declare const devServerManifestSchema: z.ZodMiniObject<
             entry_point: z.ZodMiniString<string>;
             interface_type: z.ZodMiniString<string>;
             name: z.ZodMiniString<string>;
+            version: z.ZodMiniOptional<z.ZodMiniNumber<number>>;
           },
           z.core.$strip
         >

package/dist/_exports/index.d.ts

@@ -2,14 +2,14 @@ import { z } from "zod/mini";
 
 /**
  * User-facing input for `unstable_defineApp`. Excludes the internal
- * `applicationType`, `isSingleton`, and `installationConfig` — validated by the
+ * `applicationType`, `isSingleton`, and `config` — validated by the
  * schema but not part of the public surface (Sanity-owned apps set them via
  * `@ts-expect-error`).
  * @public
  */
 export declare type DefineAppInput = Omit<
   z.output<typeof DefineAppInputSchema>,
-  "applicationType" | "installationConfig" | "isSingleton"
+  "applicationType" | "config" | "isSingleton"
 >;
 
 /**
@@ -29,16 +29,7 @@ declare const DefineAppInputSchema: z.ZodMiniObject<
         dashboard: "dashboard";
       }>
     >;
-    entry: z.ZodMiniOptional<z.ZodMiniString<string>>;
-    group: z.ZodMiniOptional<
-      z.ZodMiniEnum<{
-        "dock.system": "dock.system";
-        "dock.applications": "dock.applications";
-        "dock.user": "dock.user";
-      }>
-    >;
-    icon: z.ZodMiniOptional<z.ZodMiniString<string>>;
-    installationConfig: z.ZodMiniOptional<
+    config: z.ZodMiniOptional<
       z.ZodMiniDiscriminatedUnion<
         [
           z.ZodMiniObject<
@@ -62,6 +53,15 @@ declare const DefineAppInputSchema: z.ZodMiniObject<
         "appType"
       >
     >;
+    entry: z.ZodMiniOptional<z.ZodMiniString<string>>;
+    group: z.ZodMiniOptional<
+      z.ZodMiniEnum<{
+        "dock.system": "dock.system";
+        "dock.applications": "dock.applications";
+        "dock.user": "dock.user";
+      }>
+    >;
+    icon: z.ZodMiniOptional<z.ZodMiniString<string>>;
     isSingleton: z.ZodMiniOptional<z.ZodMiniBoolean<boolean>>;
     name: z.ZodMiniString<string>;
     organizationId: z.ZodMiniString<string>;
@@ -72,6 +72,7 @@ declare const DefineAppInputSchema: z.ZodMiniObject<
           [
             z.ZodMiniObject<
               {
+                title: z.ZodMiniOptional<z.ZodMiniString<string>>;
                 name: z.ZodMiniString<string>;
                 src: z.ZodMiniString<string>;
                 type: z.ZodMiniLiteral<"worker">;
@@ -83,6 +84,7 @@ declare const DefineAppInputSchema: z.ZodMiniObject<
         >
       >
     >;
+    slug: z.ZodMiniOptional<z.ZodMiniString<string>>;
     title: z.ZodMiniString<string>;
     views: z.ZodMiniOptional<
       z.ZodMiniArray<
@@ -90,6 +92,7 @@ declare const DefineAppInputSchema: z.ZodMiniObject<
           [
             z.ZodMiniObject<
               {
+                title: z.ZodMiniOptional<z.ZodMiniString<string>>;
                 name: z.ZodMiniString<string>;
                 src: z.ZodMiniString<string>;
                 type: z.ZodMiniLiteral<"panel">;
@@ -269,7 +272,7 @@ export declare function unstable_defineApp(
 ): DefineAppResult;
 
 /**
- * Declare the Sanity Media Library as a workbench app — a singleton whose `fields` become its installation config.
+ * Declare the Sanity Media Library as a workbench app — a singleton whose `fields` become its config.
  * @public
  */
 export declare function unstable_defineMediaLibrary(

package/dist/actions/build/artifact.js

@@ -1,4 +1,4 @@
-import { installationConfigArtifacts } from './configs/artifact.js';
+import { configArtifacts } from './configs/artifact.js';
 import { serviceArtifacts } from './services/artifact.js';
 import { viewArtifacts } from './views/artifact.js';
 /**
@@ -23,7 +23,7 @@ import { viewArtifacts } from './views/artifact.js';
     return [
         ...viewArtifacts(exposes.views ?? []),
         ...serviceArtifacts(exposes.services ?? []),
-        ...installationConfigArtifacts(exposes.installationConfig)
+        ...configArtifacts(exposes.config)
     ];
 }
 

package/dist/actions/build/artifact.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/actions/build/artifact.ts"],"sourcesContent":["import {type WorkbenchExposes} from '../../resolveWorkbenchApp.js'\nimport {installationConfigArtifacts} from './configs/artifact.js'\nimport {serviceArtifacts} from './services/artifact.js'\nimport {viewArtifacts} from './views/artifact.js'\n\n/**\n * What a {@link GeneratedArtifact.source} builder receives from the build — the\n * one thing it can't compute on its own, since only the build knows where the\n * runtime dir sits relative to the app's `src`.\n */\ninterface ArtifactContext {\n  /** Import specifier for an app `src` file, relative to this artifact. */\n  resolveImport: (src: string) => string\n}\n\n/**\n * One file the federation build generates into the runtime dir for a declared\n * interface. Each interface type — views, services — expands its declarations\n * into a flat list of these; the build then writes them and maps the ones the\n * host loads directly into the module-federation manifest.\n *\n * Adding an interface type is adding a builder that returns\n * `GeneratedArtifact[]` — the write loop and the expose mapping never change.\n */\nexport interface GeneratedArtifact {\n  /** Path relative to the federation runtime dir, e.g. `views/feed/panel.js`. */\n  path: string\n  /** Build the file's contents. */\n  source: (context: ArtifactContext) => string\n\n  /**\n   * Module-federation expose key when the host loads this artifact directly —\n   * a view component `./views/feed/panel`, a service loader `./services/unread`.\n   * Omitted for a file the host never loads on its own, like a worker bundle\n   * (reached through its sibling loader).\n   */\n  expose?: string\n}\n\n/**\n * Map the artifacts the host loads directly (those with an `expose`) to their\n * runtime-dir paths, for the module-federation `exposes` field. `toExposePath`\n * turns a runtime-relative artifact path into the value federation wants — the\n * caller owns the runtime-dir location and any entry resolution.\n */\nexport function artifactExposes(\n  artifacts: readonly GeneratedArtifact[],\n  toExposePath: (artifactPath: string) => string,\n): Record<string, string> {\n  const exposes: Record<string, string> = {}\n  for (const artifact of artifacts) {\n    if (artifact.expose) {\n      exposes[artifact.expose] = toExposePath(artifact.path)\n    }\n  }\n  return exposes\n}\n\n/**\n * Expand what the app exposes into the flat artifact set the federation build\n * writes — the single place that composes the per-type expanders, so the expose\n * mapping and the file writing read from one expansion.\n */\nexport function workbenchArtifacts(exposes: WorkbenchExposes): GeneratedArtifact[] {\n  return [\n    ...viewArtifacts(exposes.views ?? []),\n    ...serviceArtifacts(exposes.services ?? []),\n    ...installationConfigArtifacts(exposes.installationConfig),\n  ]\n}\n"],"names":["installationConfigArtifacts","serviceArtifacts","viewArtifacts","artifactExposes","artifacts","toExposePath","exposes","artifact","expose","path","workbenchArtifacts","views","services","installationConfig"],"mappings":"AACA,SAAQA,2BAA2B,QAAO,wBAAuB;AACjE,SAAQC,gBAAgB,QAAO,yBAAwB;AACvD,SAAQC,aAAa,QAAO,sBAAqB;AAoCjD;;;;;CAKC,GACD,OAAO,SAASC,gBACdC,SAAuC,EACvCC,YAA8C;IAE9C,MAAMC,UAAkC,CAAC;IACzC,KAAK,MAAMC,YAAYH,UAAW;QAChC,IAAIG,SAASC,MAAM,EAAE;YACnBF,OAAO,CAACC,SAASC,MAAM,CAAC,GAAGH,aAAaE,SAASE,IAAI;QACvD;IACF;IACA,OAAOH;AACT;AAEA;;;;CAIC,GACD,OAAO,SAASI,mBAAmBJ,OAAyB;IAC1D,OAAO;WACFJ,cAAcI,QAAQK,KAAK,IAAI,EAAE;WACjCV,iBAAiBK,QAAQM,QAAQ,IAAI,EAAE;WACvCZ,4BAA4BM,QAAQO,kBAAkB;KAC1D;AACH"}
+{"version":3,"sources":["../../../src/actions/build/artifact.ts"],"sourcesContent":["import {type WorkbenchExposes} from '../../resolveWorkbenchApp.js'\nimport {configArtifacts} from './configs/artifact.js'\nimport {serviceArtifacts} from './services/artifact.js'\nimport {viewArtifacts} from './views/artifact.js'\n\n/**\n * What a {@link GeneratedArtifact.source} builder receives from the build — the\n * one thing it can't compute on its own, since only the build knows where the\n * runtime dir sits relative to the app's `src`.\n */\ninterface ArtifactContext {\n  /** Import specifier for an app `src` file, relative to this artifact. */\n  resolveImport: (src: string) => string\n}\n\n/**\n * One file the federation build generates into the runtime dir for a declared\n * interface. Each interface type — views, services — expands its declarations\n * into a flat list of these; the build then writes them and maps the ones the\n * host loads directly into the module-federation manifest.\n *\n * Adding an interface type is adding a builder that returns\n * `GeneratedArtifact[]` — the write loop and the expose mapping never change.\n */\nexport interface GeneratedArtifact {\n  /** Path relative to the federation runtime dir, e.g. `views/feed/panel.js`. */\n  path: string\n  /** Build the file's contents. */\n  source: (context: ArtifactContext) => string\n\n  /**\n   * Module-federation expose key when the host loads this artifact directly —\n   * a view component `./views/feed/panel`, a service loader `./services/unread`.\n   * Omitted for a file the host never loads on its own, like a worker bundle\n   * (reached through its sibling loader).\n   */\n  expose?: string\n}\n\n/**\n * Map the artifacts the host loads directly (those with an `expose`) to their\n * runtime-dir paths, for the module-federation `exposes` field. `toExposePath`\n * turns a runtime-relative artifact path into the value federation wants — the\n * caller owns the runtime-dir location and any entry resolution.\n */\nexport function artifactExposes(\n  artifacts: readonly GeneratedArtifact[],\n  toExposePath: (artifactPath: string) => string,\n): Record<string, string> {\n  const exposes: Record<string, string> = {}\n  for (const artifact of artifacts) {\n    if (artifact.expose) {\n      exposes[artifact.expose] = toExposePath(artifact.path)\n    }\n  }\n  return exposes\n}\n\n/**\n * Expand what the app exposes into the flat artifact set the federation build\n * writes — the single place that composes the per-type expanders, so the expose\n * mapping and the file writing read from one expansion.\n */\nexport function workbenchArtifacts(exposes: WorkbenchExposes): GeneratedArtifact[] {\n  return [\n    ...viewArtifacts(exposes.views ?? []),\n    ...serviceArtifacts(exposes.services ?? []),\n    ...configArtifacts(exposes.config),\n  ]\n}\n"],"names":["configArtifacts","serviceArtifacts","viewArtifacts","artifactExposes","artifacts","toExposePath","exposes","artifact","expose","path","workbenchArtifacts","views","services","config"],"mappings":"AACA,SAAQA,eAAe,QAAO,wBAAuB;AACrD,SAAQC,gBAAgB,QAAO,yBAAwB;AACvD,SAAQC,aAAa,QAAO,sBAAqB;AAoCjD;;;;;CAKC,GACD,OAAO,SAASC,gBACdC,SAAuC,EACvCC,YAA8C;IAE9C,MAAMC,UAAkC,CAAC;IACzC,KAAK,MAAMC,YAAYH,UAAW;QAChC,IAAIG,SAASC,MAAM,EAAE;YACnBF,OAAO,CAACC,SAASC,MAAM,CAAC,GAAGH,aAAaE,SAASE,IAAI;QACvD;IACF;IACA,OAAOH;AACT;AAEA;;;;CAIC,GACD,OAAO,SAASI,mBAAmBJ,OAAyB;IAC1D,OAAO;WACFJ,cAAcI,QAAQK,KAAK,IAAI,EAAE;WACjCV,iBAAiBK,QAAQM,QAAQ,IAAI,EAAE;WACvCZ,gBAAgBM,QAAQO,MAAM;KAClC;AACH"}

package/dist/actions/build/configs/artifact.js

@@ -1,12 +1,12 @@
-import { INSTALLATION_CONFIG_TYPE, MEDIA_LIBRARY_INSTALLATION_CONFIG_CONTRACT_VERSION } from '../../../contract.js';
+import { INSTALLATION_CONFIG_TYPE, MEDIA_LIBRARY_CONFIG_CONTRACT_VERSION } from '../../../contract.js';
 const CONFIGS_DIR_NAME = 'configs';
-/** Expand the installation config into one federation module aggregating all fields, so the host imports one live config value. */ export function installationConfigArtifacts(config) {
+/** Expand the config into one federation module aggregating all fields, so the host imports one live config value. */ export function configArtifacts(config) {
     if (!config) return [];
     return [
         {
             expose: `./${CONFIGS_DIR_NAME}/${INSTALLATION_CONFIG_TYPE}`,
             path: `${CONFIGS_DIR_NAME}/${INSTALLATION_CONFIG_TYPE}.js`,
-            source: ({ resolveImport })=>mediaLibraryInstallationConfigSource({
+            source: ({ resolveImport })=>mediaLibraryConfigSource({
                     config,
                     resolveImport
                 })
@@ -17,7 +17,7 @@ const CONFIGS_DIR_NAME = 'configs';
  * Emits `export const config`: each field's serializable `{name, title, public}`
  * plus its live `defineField` value, the one thing the wire can't carry.
  * `appType` stays off the module — the host assigns it from the wire record.
- */ function mediaLibraryInstallationConfigSource(input) {
+ */ function mediaLibraryConfigSource(input) {
     const { config, resolveImport } = input;
     const imports = config.fields.map((field, index)=>`import field_${index} from ${JSON.stringify(resolveImport(field.src))}`).join('\n');
     const entries = config.fields.map((field, index)=>`    {name: ${JSON.stringify(field.name)}, title: ${JSON.stringify(field.title)}, ` + `public: ${JSON.stringify(Boolean(field.public))}, config: field_${index}},`).join('\n');
@@ -27,7 +27,7 @@ const CONFIGS_DIR_NAME = 'configs';
 ${imports}
 
 export const type = ${JSON.stringify(INSTALLATION_CONFIG_TYPE)}
-export const version = ${MEDIA_LIBRARY_INSTALLATION_CONFIG_CONTRACT_VERSION}
+export const version = ${MEDIA_LIBRARY_CONFIG_CONTRACT_VERSION}
 export const config = {
   fields: [
 ${entries}

package/dist/actions/build/configs/artifact.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../src/actions/build/configs/artifact.ts"],"sourcesContent":["import {\n  INSTALLATION_CONFIG_TYPE,\n  MEDIA_LIBRARY_INSTALLATION_CONFIG_CONTRACT_VERSION,\n} from '../../../contract.js'\nimport {type GeneratedArtifact} from '../artifact.js'\n\nconst CONFIGS_DIR_NAME = 'configs'\n\n/**\n * The installation config to generate a module for.\n * @internal\n */\nexport interface ConfigArtifact {\n  fields: {name: string; public?: boolean; src: string; title: string}[]\n}\n\n/** Expand the installation config into one federation module aggregating all fields, so the host imports one live config value. */\nexport function installationConfigArtifacts(\n  config: ConfigArtifact | undefined,\n): GeneratedArtifact[] {\n  if (!config) return []\n  return [\n    {\n      expose: `./${CONFIGS_DIR_NAME}/${INSTALLATION_CONFIG_TYPE}`,\n      path: `${CONFIGS_DIR_NAME}/${INSTALLATION_CONFIG_TYPE}.js`,\n      source: ({resolveImport}) => mediaLibraryInstallationConfigSource({config, resolveImport}),\n    },\n  ]\n}\n\n/**\n * Emits `export const config`: each field's serializable `{name, title, public}`\n * plus its live `defineField` value, the one thing the wire can't carry.\n * `appType` stays off the module — the host assigns it from the wire record.\n */\nfunction mediaLibraryInstallationConfigSource(input: {\n  config: ConfigArtifact\n  resolveImport: (src: string) => string\n}): string {\n  const {config, resolveImport} = input\n  const imports = config.fields\n    .map((field, index) => `import field_${index} from ${JSON.stringify(resolveImport(field.src))}`)\n    .join('\\n')\n  const entries = config.fields\n    .map(\n      (field, index) =>\n        `    {name: ${JSON.stringify(field.name)}, title: ${JSON.stringify(field.title)}, ` +\n        `public: ${JSON.stringify(Boolean(field.public))}, config: field_${index}},`,\n    )\n    .join('\\n')\n  return `\\\n// This file is auto-generated on 'sanity build' / 'sanity dev'\n// Modifications to this file are automatically discarded\n${imports}\n\nexport const type = ${JSON.stringify(INSTALLATION_CONFIG_TYPE)}\nexport const version = ${MEDIA_LIBRARY_INSTALLATION_CONFIG_CONTRACT_VERSION}\nexport const config = {\n  fields: [\n${entries}\n  ],\n}\n\nif (import.meta.hot) {\n  // A config is data, not a rendered island with a live root to remount —\n  // self-accept so a field edit swaps the module in place; the host re-reads it.\n  import.meta.hot.accept()\n}\n`\n}\n"],"names":["INSTALLATION_CONFIG_TYPE","MEDIA_LIBRARY_INSTALLATION_CONFIG_CONTRACT_VERSION","CONFIGS_DIR_NAME","installationConfigArtifacts","config","expose","path","source","resolveImport","mediaLibraryInstallationConfigSource","input","imports","fields","map","field","index","JSON","stringify","src","join","entries","name","title","Boolean","public"],"mappings":"AAAA,SACEA,wBAAwB,EACxBC,kDAAkD,QAC7C,uBAAsB;AAG7B,MAAMC,mBAAmB;AAUzB,iIAAiI,GACjI,OAAO,SAASC,4BACdC,MAAkC;IAElC,IAAI,CAACA,QAAQ,OAAO,EAAE;IACtB,OAAO;QACL;YACEC,QAAQ,CAAC,EAAE,EAAEH,iBAAiB,CAAC,EAAEF,0BAA0B;YAC3DM,MAAM,GAAGJ,iBAAiB,CAAC,EAAEF,yBAAyB,GAAG,CAAC;YAC1DO,QAAQ,CAAC,EAACC,aAAa,EAAC,GAAKC,qCAAqC;oBAACL;oBAAQI;gBAAa;QAC1F;KACD;AACH;AAEA;;;;CAIC,GACD,SAASC,qCAAqCC,KAG7C;IACC,MAAM,EAACN,MAAM,EAAEI,aAAa,EAAC,GAAGE;IAChC,MAAMC,UAAUP,OAAOQ,MAAM,CAC1BC,GAAG,CAAC,CAACC,OAAOC,QAAU,CAAC,aAAa,EAAEA,MAAM,MAAM,EAAEC,KAAKC,SAAS,CAACT,cAAcM,MAAMI,GAAG,IAAI,EAC9FC,IAAI,CAAC;IACR,MAAMC,UAAUhB,OAAOQ,MAAM,CAC1BC,GAAG,CACF,CAACC,OAAOC,QACN,CAAC,WAAW,EAAEC,KAAKC,SAAS,CAACH,MAAMO,IAAI,EAAE,SAAS,EAAEL,KAAKC,SAAS,CAACH,MAAMQ,KAAK,EAAE,EAAE,CAAC,GACnF,CAAC,QAAQ,EAAEN,KAAKC,SAAS,CAACM,QAAQT,MAAMU,MAAM,GAAG,gBAAgB,EAAET,MAAM,EAAE,CAAC,EAE/EI,IAAI,CAAC;IACR,OAAO,CAAC;;;AAGV,EAAER,QAAQ;;oBAEU,EAAEK,KAAKC,SAAS,CAACjB,0BAA0B;uBACxC,EAAEC,mDAAmD;;;AAG5E,EAAEmB,QAAQ;;;;;;;;;AASV,CAAC;AACD"}
+{"version":3,"sources":["../../../../src/actions/build/configs/artifact.ts"],"sourcesContent":["import {INSTALLATION_CONFIG_TYPE, MEDIA_LIBRARY_CONFIG_CONTRACT_VERSION} from '../../../contract.js'\nimport {type GeneratedArtifact} from '../artifact.js'\n\nconst CONFIGS_DIR_NAME = 'configs'\n\n/**\n * The config to generate a module for.\n * @internal\n */\nexport interface ConfigArtifact {\n  fields: {name: string; public?: boolean; src: string; title: string}[]\n}\n\n/** Expand the config into one federation module aggregating all fields, so the host imports one live config value. */\nexport function configArtifacts(config: ConfigArtifact | undefined): GeneratedArtifact[] {\n  if (!config) return []\n  return [\n    {\n      expose: `./${CONFIGS_DIR_NAME}/${INSTALLATION_CONFIG_TYPE}`,\n      path: `${CONFIGS_DIR_NAME}/${INSTALLATION_CONFIG_TYPE}.js`,\n      source: ({resolveImport}) => mediaLibraryConfigSource({config, resolveImport}),\n    },\n  ]\n}\n\n/**\n * Emits `export const config`: each field's serializable `{name, title, public}`\n * plus its live `defineField` value, the one thing the wire can't carry.\n * `appType` stays off the module — the host assigns it from the wire record.\n */\nfunction mediaLibraryConfigSource(input: {\n  config: ConfigArtifact\n  resolveImport: (src: string) => string\n}): string {\n  const {config, resolveImport} = input\n  const imports = config.fields\n    .map((field, index) => `import field_${index} from ${JSON.stringify(resolveImport(field.src))}`)\n    .join('\\n')\n  const entries = config.fields\n    .map(\n      (field, index) =>\n        `    {name: ${JSON.stringify(field.name)}, title: ${JSON.stringify(field.title)}, ` +\n        `public: ${JSON.stringify(Boolean(field.public))}, config: field_${index}},`,\n    )\n    .join('\\n')\n  return `\\\n// This file is auto-generated on 'sanity build' / 'sanity dev'\n// Modifications to this file are automatically discarded\n${imports}\n\nexport const type = ${JSON.stringify(INSTALLATION_CONFIG_TYPE)}\nexport const version = ${MEDIA_LIBRARY_CONFIG_CONTRACT_VERSION}\nexport const config = {\n  fields: [\n${entries}\n  ],\n}\n\nif (import.meta.hot) {\n  // A config is data, not a rendered island with a live root to remount —\n  // self-accept so a field edit swaps the module in place; the host re-reads it.\n  import.meta.hot.accept()\n}\n`\n}\n"],"names":["INSTALLATION_CONFIG_TYPE","MEDIA_LIBRARY_CONFIG_CONTRACT_VERSION","CONFIGS_DIR_NAME","configArtifacts","config","expose","path","source","resolveImport","mediaLibraryConfigSource","input","imports","fields","map","field","index","JSON","stringify","src","join","entries","name","title","Boolean","public"],"mappings":"AAAA,SAAQA,wBAAwB,EAAEC,qCAAqC,QAAO,uBAAsB;AAGpG,MAAMC,mBAAmB;AAUzB,oHAAoH,GACpH,OAAO,SAASC,gBAAgBC,MAAkC;IAChE,IAAI,CAACA,QAAQ,OAAO,EAAE;IACtB,OAAO;QACL;YACEC,QAAQ,CAAC,EAAE,EAAEH,iBAAiB,CAAC,EAAEF,0BAA0B;YAC3DM,MAAM,GAAGJ,iBAAiB,CAAC,EAAEF,yBAAyB,GAAG,CAAC;YAC1DO,QAAQ,CAAC,EAACC,aAAa,EAAC,GAAKC,yBAAyB;oBAACL;oBAAQI;gBAAa;QAC9E;KACD;AACH;AAEA;;;;CAIC,GACD,SAASC,yBAAyBC,KAGjC;IACC,MAAM,EAACN,MAAM,EAAEI,aAAa,EAAC,GAAGE;IAChC,MAAMC,UAAUP,OAAOQ,MAAM,CAC1BC,GAAG,CAAC,CAACC,OAAOC,QAAU,CAAC,aAAa,EAAEA,MAAM,MAAM,EAAEC,KAAKC,SAAS,CAACT,cAAcM,MAAMI,GAAG,IAAI,EAC9FC,IAAI,CAAC;IACR,MAAMC,UAAUhB,OAAOQ,MAAM,CAC1BC,GAAG,CACF,CAACC,OAAOC,QACN,CAAC,WAAW,EAAEC,KAAKC,SAAS,CAACH,MAAMO,IAAI,EAAE,SAAS,EAAEL,KAAKC,SAAS,CAACH,MAAMQ,KAAK,EAAE,EAAE,CAAC,GACnF,CAAC,QAAQ,EAAEN,KAAKC,SAAS,CAACM,QAAQT,MAAMU,MAAM,GAAG,gBAAgB,EAAET,MAAM,EAAE,CAAC,EAE/EI,IAAI,CAAC;IACR,OAAO,CAAC;;;AAGV,EAAER,QAAQ;;oBAEU,EAAEK,KAAKC,SAAS,CAACjB,0BAA0B;uBACxC,EAAEC,sCAAsC;;;AAG/D,EAAEmB,QAAQ;;;;;;;;;AASV,CAAC;AACD"}

package/dist/actions/deploy/apiVersion.js

@@ -0,0 +1,5 @@
+// The app endpoints (applications + installations) live behind the
+// experimental `vX` version; a dated version returns 501.
+export const APP_WORKBENCH_API_VERSION = 'vX';
+
+//# sourceMappingURL=apiVersion.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/actions/deploy/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"}