@sanity/runtime-cli 17.13.1-next.g13a83b0 → 17.13.1-next.g5faa770

package/README.md

@@ -90,7 +90,7 @@ EXAMPLES
   $ sanity-run blueprints add function --name my-function --fn-type document-create --fn-type document-update --lang js
 ```
 
-_See code: [src/commands/blueprints/add.ts](https://github.com/sanity-io/runtime-cli/blob/v17.13.1-next.g13a83b0/src/commands/blueprints/add.ts)_
+_See code: [src/commands/blueprints/add.ts](https://github.com/sanity-io/runtime-cli/blob/v17.13.1-next.g5faa770/src/commands/blueprints/add.ts)_
 
 ## `sanity-run blueprints config`
 
@@ -127,7 +127,7 @@ EXAMPLES
   $ sanity-run blueprints config --edit --project-id <projectId> --stack <name-or-id>
 ```
 
-_See code: [src/commands/blueprints/config.ts](https://github.com/sanity-io/runtime-cli/blob/v17.13.1-next.g13a83b0/src/commands/blueprints/config.ts)_
+_See code: [src/commands/blueprints/config.ts](https://github.com/sanity-io/runtime-cli/blob/v17.13.1-next.g5faa770/src/commands/blueprints/config.ts)_
 
 ## `sanity-run blueprints deploy`
 
@@ -183,7 +183,7 @@ EXAMPLES
   $ sanity-run blueprints deploy --new-stack-name <new-name>
 ```
 
-_See code: [src/commands/blueprints/deploy.ts](https://github.com/sanity-io/runtime-cli/blob/v17.13.1-next.g13a83b0/src/commands/blueprints/deploy.ts)_
+_See code: [src/commands/blueprints/deploy.ts](https://github.com/sanity-io/runtime-cli/blob/v17.13.1-next.g5faa770/src/commands/blueprints/deploy.ts)_
 
 ## `sanity-run blueprints destroy`
 
@@ -221,7 +221,7 @@ EXAMPLES
   $ sanity-run blueprints destroy --stack <name-or-id> --project-id <projectId> --force --no-wait
 ```
 
-_See code: [src/commands/blueprints/destroy.ts](https://github.com/sanity-io/runtime-cli/blob/v17.13.1-next.g13a83b0/src/commands/blueprints/destroy.ts)_
+_See code: [src/commands/blueprints/destroy.ts](https://github.com/sanity-io/runtime-cli/blob/v17.13.1-next.g5faa770/src/commands/blueprints/destroy.ts)_
 
 ## `sanity-run blueprints doctor`
 
@@ -253,7 +253,7 @@ EXAMPLES
   $ sanity-run blueprints doctor --fix
 ```
 
-_See code: [src/commands/blueprints/doctor.ts](https://github.com/sanity-io/runtime-cli/blob/v17.13.1-next.g13a83b0/src/commands/blueprints/doctor.ts)_
+_See code: [src/commands/blueprints/doctor.ts](https://github.com/sanity-io/runtime-cli/blob/v17.13.1-next.g5faa770/src/commands/blueprints/doctor.ts)_
 
 ## `sanity-run blueprints info`
 
@@ -291,7 +291,7 @@ EXAMPLES
   $ sanity-run blueprints info --organization-id <orgId> --stack <name-or-id>
 ```
 
-_See code: [src/commands/blueprints/info.ts](https://github.com/sanity-io/runtime-cli/blob/v17.13.1-next.g13a83b0/src/commands/blueprints/info.ts)_
+_See code: [src/commands/blueprints/info.ts](https://github.com/sanity-io/runtime-cli/blob/v17.13.1-next.g5faa770/src/commands/blueprints/info.ts)_
 
 ## `sanity-run blueprints init [DIR]`
 
@@ -355,7 +355,7 @@ EXAMPLES
   $ sanity-run blueprints init old-stack --type <json|js|ts> --project-id <projectId> --stack-id <existingStackId>
 ```
 
-_See code: [src/commands/blueprints/init.ts](https://github.com/sanity-io/runtime-cli/blob/v17.13.1-next.g13a83b0/src/commands/blueprints/init.ts)_
+_See code: [src/commands/blueprints/init.ts](https://github.com/sanity-io/runtime-cli/blob/v17.13.1-next.g5faa770/src/commands/blueprints/init.ts)_
 
 ## `sanity-run blueprints logs`
 
@@ -401,7 +401,7 @@ EXAMPLES
   $ sanity-run blueprints logs --before 2026-05-01T00:00:00Z
 ```
 
-_See code: [src/commands/blueprints/logs.ts](https://github.com/sanity-io/runtime-cli/blob/v17.13.1-next.g13a83b0/src/commands/blueprints/logs.ts)_
+_See code: [src/commands/blueprints/logs.ts](https://github.com/sanity-io/runtime-cli/blob/v17.13.1-next.g5faa770/src/commands/blueprints/logs.ts)_
 
 ## `sanity-run blueprints mint-deploy-token`
 
@@ -446,7 +446,7 @@ EXAMPLES
   $ sanity-run blueprints mint-deploy-token --organization-id <orgId>
 ```
 
-_See code: [src/commands/blueprints/mint-deploy-token.ts](https://github.com/sanity-io/runtime-cli/blob/v17.13.1-next.g13a83b0/src/commands/blueprints/mint-deploy-token.ts)_
+_See code: [src/commands/blueprints/mint-deploy-token.ts](https://github.com/sanity-io/runtime-cli/blob/v17.13.1-next.g5faa770/src/commands/blueprints/mint-deploy-token.ts)_
 
 ## `sanity-run blueprints plan`
 
@@ -479,7 +479,7 @@ EXAMPLES
   $ sanity-run blueprints plan --organization-id <orgId> --stack <name-or-id>
 ```
 
-_See code: [src/commands/blueprints/plan.ts](https://github.com/sanity-io/runtime-cli/blob/v17.13.1-next.g13a83b0/src/commands/blueprints/plan.ts)_
+_See code: [src/commands/blueprints/plan.ts](https://github.com/sanity-io/runtime-cli/blob/v17.13.1-next.g5faa770/src/commands/blueprints/plan.ts)_
 
 ## `sanity-run blueprints promote`
 
@@ -515,7 +515,7 @@ EXAMPLES
   $ sanity-run blueprints promote --new-stack-name <new-name>
 ```
 
-_See code: [src/commands/blueprints/promote.ts](https://github.com/sanity-io/runtime-cli/blob/v17.13.1-next.g13a83b0/src/commands/blueprints/promote.ts)_
+_See code: [src/commands/blueprints/promote.ts](https://github.com/sanity-io/runtime-cli/blob/v17.13.1-next.g5faa770/src/commands/blueprints/promote.ts)_
 
 ## `sanity-run blueprints stacks`
 
@@ -556,7 +556,7 @@ EXAMPLES
   $ sanity-run blueprints stacks --organization-id <organizationId> --include-projects
 ```
 
-_See code: [src/commands/blueprints/stacks.ts](https://github.com/sanity-io/runtime-cli/blob/v17.13.1-next.g13a83b0/src/commands/blueprints/stacks.ts)_
+_See code: [src/commands/blueprints/stacks.ts](https://github.com/sanity-io/runtime-cli/blob/v17.13.1-next.g5faa770/src/commands/blueprints/stacks.ts)_
 
 ## `sanity-run functions add`
 
@@ -608,7 +608,7 @@ EXAMPLES
   $ sanity-run functions add --name my-function --type document-create --type document-update --lang js
 ```
 
-_See code: [src/commands/functions/add.ts](https://github.com/sanity-io/runtime-cli/blob/v17.13.1-next.g13a83b0/src/commands/functions/add.ts)_
+_See code: [src/commands/functions/add.ts](https://github.com/sanity-io/runtime-cli/blob/v17.13.1-next.g5faa770/src/commands/functions/add.ts)_
 
 ## `sanity-run functions dev`
 
@@ -643,7 +643,7 @@ EXAMPLES
   $ sanity-run functions dev --timeout 60
 ```
 
-_See code: [src/commands/functions/dev.ts](https://github.com/sanity-io/runtime-cli/blob/v17.13.1-next.g13a83b0/src/commands/functions/dev.ts)_
+_See code: [src/commands/functions/dev.ts](https://github.com/sanity-io/runtime-cli/blob/v17.13.1-next.g5faa770/src/commands/functions/dev.ts)_
 
 ## `sanity-run functions env add NAME KEY VALUE`
 
@@ -676,7 +676,7 @@ EXAMPLES
   $ sanity-run functions env add --stack <name-or-id> MyFunction API_URL https://api.example.com/
 ```
 
-_See code: [src/commands/functions/env/add.ts](https://github.com/sanity-io/runtime-cli/blob/v17.13.1-next.g13a83b0/src/commands/functions/env/add.ts)_
+_See code: [src/commands/functions/env/add.ts](https://github.com/sanity-io/runtime-cli/blob/v17.13.1-next.g5faa770/src/commands/functions/env/add.ts)_
 
 ## `sanity-run functions env list NAME`
 
@@ -706,7 +706,7 @@ EXAMPLES
   $ sanity-run functions env list --stack <name-or-id> MyFunction
 ```
 
-_See code: [src/commands/functions/env/list.ts](https://github.com/sanity-io/runtime-cli/blob/v17.13.1-next.g13a83b0/src/commands/functions/env/list.ts)_
+_See code: [src/commands/functions/env/list.ts](https://github.com/sanity-io/runtime-cli/blob/v17.13.1-next.g5faa770/src/commands/functions/env/list.ts)_
 
 ## `sanity-run functions env remove NAME KEY`
 
@@ -738,7 +738,7 @@ EXAMPLES
   $ sanity-run functions env remove --stack <name-or-id> MyFunction API_URL
 ```
 
-_See code: [src/commands/functions/env/remove.ts](https://github.com/sanity-io/runtime-cli/blob/v17.13.1-next.g13a83b0/src/commands/functions/env/remove.ts)_
+_See code: [src/commands/functions/env/remove.ts](https://github.com/sanity-io/runtime-cli/blob/v17.13.1-next.g5faa770/src/commands/functions/env/remove.ts)_
 
 ## `sanity-run functions logs [NAME]`
 
@@ -778,7 +778,7 @@ EXAMPLES
   $ sanity-run functions logs <name> --delete
 ```
 
-_See code: [src/commands/functions/logs.ts](https://github.com/sanity-io/runtime-cli/blob/v17.13.1-next.g13a83b0/src/commands/functions/logs.ts)_
+_See code: [src/commands/functions/logs.ts](https://github.com/sanity-io/runtime-cli/blob/v17.13.1-next.g5faa770/src/commands/functions/logs.ts)_
 
 ## `sanity-run functions test [NAME]`
 
@@ -836,7 +836,7 @@ EXAMPLES
   $ sanity-run functions test <name> --event update --data-before '{ "title": "before" }' --data-after '{ "title": "after" }'
 ```
 
-_See code: [src/commands/functions/test.ts](https://github.com/sanity-io/runtime-cli/blob/v17.13.1-next.g13a83b0/src/commands/functions/test.ts)_
+_See code: [src/commands/functions/test.ts](https://github.com/sanity-io/runtime-cli/blob/v17.13.1-next.g5faa770/src/commands/functions/test.ts)_
 
 ## `sanity-run help [COMMAND]`
 

package/dist/actions/blueprints/pre-deploy.js

@@ -1,9 +1,9 @@
 import { SANITY_FUNCTION_PREFIX } from '../../constants.js';
 import { resolveDeployedResources } from '../../utils/blueprints/resolve-deployed-resources.js';
+import { BUNDLE_SPECS, prepareBundleAsset, } from '../../utils/bundles/prepare-asset.js';
 import { CODE_OPERATION_UNCONFIRMED, EXIT_OPERATION_UNCONFIRMED } from '../../utils/exit-codes.js';
 import { prepareAsset as prepareFunctionAsset } from '../../utils/functions/prepare-asset.js';
 import { runCommand } from '../../utils/package-manager.js';
-import { prepareStudioAsset } from '../../utils/studios/prepare-asset.js';
 import { setupLogPolling } from './logs-polling.js';
 import { getOperationStateInfo } from './operations-state.js';
 import { processAssets } from './process-assets.js';
@@ -13,9 +13,9 @@ import { updateStack } from './stacks.js';
  */
 const preDeployConfigs = [
     {
-        resourceType: 'sanity.studio',
+        resourceType: (type) => type in BUNDLE_SPECS,
         async prepareAsset(options) {
-            return prepareStudioAsset({
+            return prepareBundleAsset({
                 resource: options.resource,
                 blueprintFileDir: options.blueprintFileDir,
             });

package/dist/actions/blueprints/stacks.d.ts

@@ -1,6 +1,6 @@
 import type { Blueprint } from '@sanity/blueprints-parser';
 import type { Logger } from '../../utils/logger.js';
-import type { AuthParams, ScopeType, Stack, StackMutation, StackSummary } from '../../utils/types.js';
+import type { AuthParams, ScopeType, Stack, StackMutation, StackSummary, UpdatedStack } from '../../utils/types.js';
 export declare const stacksUrl: string;
 type ListStacksResponse = {
     ok: true;
@@ -46,10 +46,7 @@ export declare function createEmptyStack({ token, scopeType, scopeId, name, logg
 type UpdateStackResponse = {
     ok: true;
     error: null;
-    stack: Stack & {
-        operationId: string;
-        changeCount?: number;
-    };
+    stack: UpdatedStack;
 } | {
     ok: false;
     error: string;

package/dist/constants.d.ts

@@ -13,6 +13,8 @@ export declare const SANITY_PROJECT_CORS = "sanity.project.cors";
 export declare const SANITY_PROJECT_DATASET = "sanity.project.dataset";
 export declare const SANITY_PROJECT_WEBHOOK = "sanity.project.webhook";
 export declare const SANITY_STUDIO = "sanity.studio";
+export declare const SANITY_APPLICATION = "sanity.application";
+export declare const SANITY_INSTALLATION_CONFIG = "sanity.installation.config";
 export declare const EVENT_DOCUMENT_PUBLISH = "document-publish";
 export declare const EVENT_DOCUMENT_CREATE = "document-create";
 export declare const EVENT_DOCUMENT_UPDATE = "document-update";

package/dist/constants.js

@@ -12,6 +12,8 @@ export const SANITY_PROJECT_CORS = 'sanity.project.cors';
 export const SANITY_PROJECT_DATASET = 'sanity.project.dataset';
 export const SANITY_PROJECT_WEBHOOK = 'sanity.project.webhook';
 export const SANITY_STUDIO = 'sanity.studio';
+export const SANITY_APPLICATION = 'sanity.application';
+export const SANITY_INSTALLATION_CONFIG = 'sanity.installation.config';
 export const EVENT_DOCUMENT_PUBLISH = 'document-publish';
 export const EVENT_DOCUMENT_CREATE = 'document-create';
 export const EVENT_DOCUMENT_UPDATE = 'document-update';

package/dist/cores/blueprints/deploy.js

@@ -6,6 +6,7 @@ import { checkUserPermission } from '../../actions/sanity/access.js';
 import { getClientMetadata } from '../../utils/blueprints/deploy-metadata.js';
 import { extractDurableConfig } from '../../utils/blueprints/extract-durable-config.js';
 import { createHintCollector } from '../../utils/blueprints/hints.js';
+import { stampInstallationConfigVersion } from '../../utils/blueprints/stamp-installation-config-version.js';
 import { createWaitFor } from '../../utils/blueprints/wait-for.js';
 import { formatStudioUrls } from '../../utils/display/blueprints-formatting.js';
 import { check, niceId, severe } from '../../utils/display/presenters.js';
@@ -42,6 +43,7 @@ export async function blueprintDeployCore(options) {
         }
         const resources = [...blueprint.resources];
         await extractDurableConfig(resources, blueprintFileDir);
+        await stampInstallationConfigVersion(resources, blueprintFileDir);
         let spinner;
         const preDeployResult = await preDeploy({
             scopeType,

package/dist/cores/blueprints/plan.js

@@ -2,6 +2,7 @@ import { dirname } from 'node:path';
 import { planStack, resolveStackIdByNameOrId } from '../../actions/blueprints/stacks.js';
 import { extractDurableConfig } from '../../utils/blueprints/extract-durable-config.js';
 import { createHintCollector } from '../../utils/blueprints/hints.js';
+import { stampInstallationConfigVersion } from '../../utils/blueprints/stamp-installation-config-version.js';
 import { formatDeploymentPlan, formatResourceTree, hasActionableChanges, } from '../../utils/display/blueprints-formatting.js';
 import { runCommand } from '../../utils/package-manager.js';
 import { styleText } from '../../utils/style-text.js';
@@ -12,6 +13,7 @@ export async function blueprintPlanCore(options) {
     const { scopeType, scopeId, stackId: blueprintStackId, parsedBlueprint, resources, fileInfo, } = blueprint;
     log(`${styleText(['bold', 'blueBright'], 'Local Blueprint')} ${styleText('dim', `(${fileInfo.fileName})`)}`);
     await extractDurableConfig(resources, dirname(fileInfo.blueprintFilePath));
+    await stampInstallationConfigVersion(resources, dirname(fileInfo.blueprintFilePath));
     log(formatResourceTree(resources));
     if (!token || !scopeType || !scopeId) {
         log(styleText('dim', 'Unable to retrieve live Stack deployment for comparison'));

package/dist/utils/blueprints/stamp-installation-config-version.d.ts

@@ -0,0 +1,9 @@
+import type { BlueprintResource } from '@sanity/blueprints';
+/**
+ * Stamps the installed `sanity` version onto each media-library config resource
+ * before pre-deploy. The version is a label Brett stores on the config snapshot,
+ * mirroring what `sanity deploy` sends for a media-library config; it is not what
+ * the runtime loads. Other installation config types are left alone: the
+ * media-library tie to the `sanity` package is specific to it.
+ */
+export declare const stampInstallationConfigVersion: (resources: BlueprintResource[], blueprintFileDir: string) => Promise<void>;

package/dist/utils/blueprints/stamp-installation-config-version.js

@@ -0,0 +1,28 @@
+import { resolve } from 'node:path';
+import { getLocalPackageVersion } from '@sanity/cli-core/package-manager';
+import { SANITY_INSTALLATION_CONFIG } from '../../constants.js';
+/**
+ * Stamps the installed `sanity` version onto each media-library config resource
+ * before pre-deploy. The version is a label Brett stores on the config snapshot,
+ * mirroring what `sanity deploy` sends for a media-library config; it is not what
+ * the runtime loads. Other installation config types are left alone: the
+ * media-library tie to the `sanity` package is specific to it.
+ */
+export const stampInstallationConfigVersion = async (resources, blueprintFileDir) => {
+    for (const resource of resources) {
+        if (resource.type !== SANITY_INSTALLATION_CONFIG)
+            continue;
+        const config = resource;
+        if (config.appType !== 'media-library')
+            continue;
+        // Update values not included in the blueprint.
+        if (config.version !== undefined)
+            continue;
+        const workDir = resolve(blueprintFileDir, config.root);
+        const version = await getLocalPackageVersion('sanity', workDir);
+        if (!version) {
+            throw new Error(`Unable to determine the installed 'sanity' version for installation config resource '${config.name}'; is 'sanity' installed in '${config.root}'?`);
+        }
+        config.version = version;
+    }
+};

package/dist/utils/bundles/prepare-asset.d.ts

@@ -0,0 +1,38 @@
+import { type BuildStudioEventListener } from '@sanity/cli-build/_internal/build';
+import type { Output } from '@sanity/cli-core';
+import type { AssetPrepResult } from '../types.js';
+import type { BlueprintApplicationResource, BlueprintInstallationConfigResource, BlueprintStudioResource } from './types.js';
+export type BundleResource = BlueprintStudioResource | BlueprintApplicationResource | BlueprintInstallationConfigResource;
+type BuildContext<R extends BundleResource> = {
+    resource: R;
+    appId: string | undefined;
+    workDir: string;
+    outDir: string;
+    output: Output;
+    eventListener: Partial<BuildStudioEventListener>;
+};
+type BuildResult = {
+    mismatchedPackages?: string[];
+};
+export declare const BUNDLE_SPECS: {
+    'sanity.studio': {
+        requiresAppId: true;
+        build: typeof buildStudioBundle;
+    };
+    'sanity.application': {
+        requiresAppId: true;
+        build: typeof buildApplicationBundle;
+    };
+    'sanity.installation.config': {
+        requiresAppId: false;
+        build: typeof buildInstallationConfigBundle;
+    };
+};
+export declare function prepareBundleAsset<R extends BundleResource>({ blueprintFileDir, resource, }: {
+    blueprintFileDir: string;
+    resource: R;
+}): Promise<AssetPrepResult>;
+declare function buildStudioBundle({ resource, appId, workDir, outDir, output, eventListener, }: BuildContext<BlueprintStudioResource>): Promise<BuildResult>;
+declare function buildApplicationBundle({ resource, appId, workDir, outDir, output, eventListener, }: BuildContext<BlueprintApplicationResource>): Promise<BuildResult>;
+declare function buildInstallationConfigBundle({ resource, workDir, outDir, output, eventListener, }: BuildContext<BlueprintInstallationConfigResource>): Promise<BuildResult>;
+export {};

package/dist/utils/bundles/prepare-asset.js

@@ -0,0 +1,271 @@
+import { createWriteStream } from 'node:fs';
+import { mkdtemp, readFile, rm, stat } from 'node:fs/promises';
+import { tmpdir } from 'node:os';
+import path, { basename, dirname, join } from 'node:path';
+import { pipeline } from 'node:stream/promises';
+import { createGzip } from 'node:zlib';
+import { buildApp, buildStudio, compareDependencyVersions, } from '@sanity/cli-build/_internal/build';
+import { getLocalPackageVersion } from '@sanity/cli-core';
+import { pack } from 'tar-fs';
+export const BUNDLE_SPECS = {
+    'sanity.studio': { requiresAppId: true, build: buildStudioBundle },
+    'sanity.application': { requiresAppId: true, build: buildApplicationBundle },
+    'sanity.installation.config': { requiresAppId: false, build: buildInstallationConfigBundle },
+};
+export async function prepareBundleAsset({ blueprintFileDir, resource, }) {
+    // The lookup can't prove it yields the spec matching this R, so it's asserted once here.
+    const spec = BUNDLE_SPECS[resource.type];
+    const appId = getAppId(resource);
+    if (spec.requiresAppId && !appId) {
+        return {
+            success: false,
+            async cleanup() { },
+            error: `Unable to determine appId for ${resource.type} resource '${resource.name}'`,
+        };
+    }
+    let cleanup = async () => { };
+    const assetPath = String(resource.root);
+    const workDir = path.resolve(blueprintFileDir, assetPath);
+    // Defence in depth alongside blueprints-node's own check: an absolute path or one
+    // that climbs above the blueprint dir would bundle files outside the project.
+    if (path.isAbsolute(assetPath) || path.relative(blueprintFileDir, workDir).startsWith('..')) {
+        return {
+            success: false,
+            cleanup,
+            error: `Property 'root' on resource with type '${resource.type}' must be under the blueprint directory`,
+        };
+    }
+    try {
+        const workDirStat = await stat(workDir);
+        if (!workDirStat.isDirectory()) {
+            return {
+                success: false,
+                cleanup,
+                error: `Property 'root' on resource with type '${resource.type}' must be a directory`,
+            };
+        }
+    }
+    catch (error) {
+        const msg = error instanceof Error ? error.message : String(error);
+        return {
+            success: false,
+            cleanup,
+            error: `Unable to read given 'root' on resource with type '${resource.type}': ${msg}`,
+        };
+    }
+    try {
+        const outDir = await mkdtemp(join(tmpdir(), `bundle-`));
+        const outFile = `${outDir}.tar.gz`;
+        cleanup = async () => {
+            await rm(outDir, { force: true, recursive: true });
+            await rm(outFile, { force: true });
+        };
+        let mismatchedPackages;
+        try {
+            ;
+            ({ mismatchedPackages } = await spec.build({
+                resource,
+                appId,
+                workDir,
+                outDir,
+                output: createSilentOutput(),
+                eventListener,
+            }));
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            return {
+                success: false,
+                cleanup,
+                error: message,
+            };
+        }
+        await pipeline(pack(dirname(outDir), { entries: [basename(outDir)] }), createGzip(), createWriteStream(outFile));
+        const buffer = await readFile(outFile);
+        return {
+            success: true,
+            cleanup,
+            outputBuffer: buffer,
+            fileExtension: 'tar.gz',
+            assetParameter: 'root',
+            metadata: {
+                sanityVersion: await getInstalledSanityVersion(workDir),
+                mismatchedPackages,
+                assetBytes: buffer.length,
+            },
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            cleanup,
+            error: error instanceof Error ? error.message : String(error),
+        };
+    }
+}
+async function buildStudioBundle({ resource, appId, workDir, outDir, output, eventListener, }) {
+    let mismatchedPackages;
+    await buildStudio({
+        appId,
+        autoUpdatesEnabled: resource.autoUpdates.enabled,
+        checkAppId() { },
+        async compareDependencyVersions(packages) {
+            const result = await compareDependencyVersions(packages, workDir, { appId });
+            mismatchedPackages = result.mismatched.map((m) => m.pkg);
+            return result;
+        },
+        determineBasePath() {
+            return resource.basePath ?? '/';
+        },
+        // a studio is a standalone app, not a workbench module-federation app
+        isApp: false,
+        isBlueprints: true,
+        isWorkbenchApp: false,
+        minify: resource.minify ?? true,
+        outDir,
+        output,
+        reactCompiler: resource.reactCompiler || false,
+        schemaExtraction: undefined,
+        sourceMap: resource.sourceMap ?? false,
+        stats: false,
+        unattendedMode: true,
+        // TODO pass in vite config from the studio resource
+        vite: undefined,
+        workDir,
+        eventListener,
+    });
+    return { mismatchedPackages };
+}
+async function buildApplicationBundle({ resource, appId, workDir, outDir, output, eventListener, }) {
+    const views = resource.views ?? [];
+    const [window, extraWindow] = views.filter((v) => v.type === 'app');
+    if (extraWindow) {
+        throw new Error(`Application resource '${resource.name}' declares more than one window view; at most one is allowed`);
+    }
+    await buildApp({
+        ...sharedBuildAppOptions({ appId, workDir, outDir, output, eventListener }),
+        appId,
+        appTitle: resource.title,
+        entry: window?.src,
+        workbenchAppId: appId,
+        exposes: {
+            views: views.map(toWorkbenchView),
+            webWorkers: resource.webWorkers,
+        },
+    });
+    // a workbench app never auto-updates, so no dependency mismatches are compared
+    return {};
+}
+async function buildInstallationConfigBundle({ resource, workDir, outDir, output, eventListener, }) {
+    await buildApp({
+        ...sharedBuildAppOptions({ appId: undefined, workDir, outDir, output, eventListener }),
+        appId: undefined,
+        appTitle: undefined,
+        entry: undefined,
+        workbenchAppId: undefined,
+        exposes: { config: { appType: resource.appType, fields: resource.fields } },
+    });
+    return {};
+}
+// Options a workbench build (application or installation config) always sets the
+// same way; each caller adds only what differs (identity, entry, exposes).
+function sharedBuildAppOptions({ appId, workDir, outDir, output, eventListener, }) {
+    return {
+        autoUpdatesEnabled: false,
+        checkAppId() { },
+        async compareDependencyVersions(packages) {
+            return compareDependencyVersions(packages, workDir, { appId });
+        },
+        determineBasePath() {
+            return '/';
+        },
+        isWorkbenchApp: true,
+        isBlueprints: true,
+        minify: true,
+        outDir,
+        output,
+        reactCompiler: false,
+        schemaExtraction: undefined,
+        sourceMap: false,
+        stats: false,
+        unattendedMode: true,
+        vite: undefined,
+        workDir,
+        eventListener,
+    };
+}
+// blueprints-node emits `type` (window views as `app`); workbench-cli discriminates on `surface`.
+function toWorkbenchView(view) {
+    switch (view.type) {
+        case 'app': {
+            const { type: _type, ...rest } = view;
+            return { ...rest, surface: 'window' };
+        }
+        case 'panel': {
+            const { type, ...rest } = view;
+            return { ...rest, surface: type };
+        }
+        case 'asset_source': {
+            const { type, ...rest } = view;
+            return { ...rest, surface: type };
+        }
+        case 'tile': {
+            const { type, ...rest } = view;
+            return { ...rest, surface: type };
+        }
+    }
+}
+const eventListener = {
+    onBuildFail({ message }) {
+        throw new Error(message);
+    },
+    onInvalidStyledComponentsVersionRange({ message }) {
+        throw new Error(message);
+    },
+    onNoDeclaredStyledComponentsVersion({ message }) {
+        throw new Error(message);
+    },
+    onNoInstalledSanityVersion({ message }) {
+        throw new Error(message);
+    },
+    onNoInstalledStyledComponentsVersion({ message }) {
+        throw new Error(message);
+    },
+    onPreReleaseInNonInteractiveAutoUpdate({ message }) {
+        throw new Error(message);
+    },
+};
+function createSilentOutput() {
+    return {
+        error(input, options) {
+            if (typeof options?.exit === 'number') {
+                if (input instanceof Error) {
+                    throw input;
+                }
+                throw new Error(input);
+            }
+            return undefined;
+        },
+        log() { },
+        warn(input) {
+            return input;
+        },
+    };
+}
+async function getInstalledSanityVersion(workDir) {
+    try {
+        return (await getLocalPackageVersion('sanity', workDir)) ?? undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+function getAppId(resource) {
+    if ('externalId' in resource && typeof resource.externalId === 'string' && resource.externalId) {
+        return resource.externalId;
+    }
+    else if (resource.lifecycle?.ownershipAction?.type === 'attach') {
+        return resource.lifecycle.ownershipAction.id;
+    }
+    return undefined;
+}

package/dist/utils/bundles/types.d.ts

@@ -0,0 +1,61 @@
+import type { BlueprintProjectResourceLifecycle, BlueprintResource, BlueprintStudioResource as PublishedStudioResource } from '@sanity/blueprints';
+/** Studios point at their directory with `root`, same as applications. */
+export type BlueprintStudioResource = Omit<PublishedStudioResource, 'src'> & {
+    root: string;
+};
+type ApplicationDock = {
+    group?: 'system' | 'applications' | 'user';
+    order?: number;
+};
+type ChildBase = {
+    name: string;
+    title: string;
+    src: string;
+};
+type WindowView = ChildBase & {
+    type: 'app';
+    dock?: ApplicationDock;
+};
+type PanelView = ChildBase & {
+    type: 'panel';
+    dock?: ApplicationDock;
+};
+type AssetSourceView = ChildBase & {
+    type: 'asset_source';
+};
+type TileView = ChildBase & {
+    type: 'tile';
+    size: 'small' | 'large' | 'banner';
+    order?: number;
+};
+type WebWorker = ChildBase & {
+    type: 'worker';
+};
+export type ApplicationView = WindowView | PanelView | AssetSourceView | TileView;
+export interface BlueprintApplicationResource extends BlueprintResource<BlueprintProjectResourceLifecycle> {
+    type: 'sanity.application';
+    slug: string;
+    title: string;
+    /** Application directory, relative to the blueprint file; contains package.json. */
+    root: string;
+    icon?: string;
+    visibility?: 'default' | 'unlisted' | 'disabled';
+    views?: ApplicationView[];
+    webWorkers?: WebWorker[];
+}
+type InstallationConfigField = {
+    name: string;
+    title: string;
+    src: string;
+    public?: boolean;
+};
+export interface BlueprintInstallationConfigResource extends BlueprintResource {
+    type: 'sanity.installation.config';
+    appType: 'media-library';
+    /** Build directory, relative to the blueprint file; contains package.json. Field `src` resolves against it. */
+    root: string;
+    fields: InstallationConfigField[];
+    /** Stamped by the CLI before pre-deploy; the authored shape from blueprints-node has none. */
+    version?: string;
+}
+export {};

package/dist/utils/bundles/types.js

@@ -0,0 +1 @@
+export {};

package/dist/utils/display/blueprints-formatting.d.ts

@@ -4,7 +4,11 @@ import type { DeploymentPlan } from '../../actions/blueprints/stacks.js';
 import { type BlueprintResourceRecord, type Stack, type StackSummary } from '../types.js';
 export declare function formatTitle(title: string, name: string): string;
 export declare function formatDeployedResourceTree(resources: BlueprintResourceRecord[] | undefined, verbose?: boolean): string;
-export declare function formatStudioUrls(resources: BlueprintResourceRecord[] | undefined): string[];
+/**
+ * Returns hosted Studio URLs, one line per Studio from resource-ish shapes
+ * Searches `parameters`, `resolvedParameters` and root for `studioHost`
+ */
+export declare function formatStudioUrls(resources: (BlueprintResource | BlueprintResourceRecord)[] | undefined): string[];
 export declare function formatResourceTree(resources: BlueprintResource[] | undefined, verbose?: boolean): string;
 export declare function formatStackInfo(stack: Stack | StackSummary | Blueprint, isCurrentStack?: boolean): string;
 export declare function formatStacksListing(stacks: StackSummary[], currentStackId?: string): string;

package/dist/utils/display/blueprints-formatting.js

@@ -1,6 +1,6 @@
 import { formatDateTime, formatElapsed } from '@sanity/cli-core/dates';
 import { treeify } from 'array-treeify';
-import { SANITY_ACCESS_ROBOT, SANITY_ACCESS_ROLE, SANITY_FUNCTION_DOCUMENT, SANITY_FUNCTION_DURABLE, SANITY_FUNCTION_MEDIA_LIBRARY_ASSET, SANITY_FUNCTION_PUBSUB, SANITY_FUNCTION_SCHEDULED, SANITY_FUNCTION_SYNC_TAG_INVALIDATE, SANITY_PROJECT, SANITY_PROJECT_CORS, SANITY_PROJECT_DATASET, SANITY_PROJECT_WEBHOOK, SANITY_STUDIO, } from '../../constants.js';
+import { SANITY_ACCESS_ROBOT, SANITY_ACCESS_ROLE, SANITY_APPLICATION, SANITY_FUNCTION_DOCUMENT, SANITY_FUNCTION_DURABLE, SANITY_FUNCTION_MEDIA_LIBRARY_ASSET, SANITY_FUNCTION_PUBSUB, SANITY_FUNCTION_SCHEDULED, SANITY_FUNCTION_SYNC_TAG_INVALIDATE, SANITY_INSTALLATION_CONFIG, SANITY_PROJECT, SANITY_PROJECT_CORS, SANITY_PROJECT_DATASET, SANITY_PROJECT_WEBHOOK, SANITY_STUDIO, } from '../../constants.js';
 import { styleText } from '../style-text.js';
 import { isCorsOriginResource, isDatasetResource, isRobotResource, isRoleResource, isStudioResource, isWebhookResource, } from '../types.js';
 import { capitalize, niceId, renderSection } from './presenters.js';
@@ -65,6 +65,14 @@ const RESOURCE_CATEGORIES = {
             return isStudioResource(res) ? arrayifyStudio(res) : [];
         },
     },
+    [SANITY_APPLICATION]: {
+        label: 'Applications',
+        displayNameAttribute: 'title',
+    },
+    [SANITY_INSTALLATION_CONFIG]: {
+        label: 'Installation configs',
+        displayNameAttribute: 'name',
+    },
 };
 const categoryByLabel = Object.values(RESOURCE_CATEGORIES).reduce((acc, curr) => {
     acc[curr.label] = curr;
@@ -165,6 +173,10 @@ export function formatDeployedResourceTree(resources, verbose = false) {
     (res) => ({ name: res.name, type: res.type, ...(res.resolvedParameters ?? res.parameters) }), verbose);
     return `${treeify(output)}\n`;
 }
+/**
+ * Returns hosted Studio URLs, one line per Studio from resource-ish shapes
+ * Searches `parameters`, `resolvedParameters` and root for `studioHost`
+ */
 export function formatStudioUrls(resources) {
     if (!resources)
         return [];
@@ -172,7 +184,8 @@ export function formatStudioUrls(resources) {
     for (const res of resources) {
         if (res.type !== SANITY_STUDIO)
             continue;
-        const host = studioHost(res.resolvedParameters ?? res.parameters);
+        const { resolvedParameters, parameters } = res;
+        const host = studioHost(resolvedParameters ?? parameters ?? res);
         if (host)
             lines.push(`Studio ${styleText(['bold', 'green'], res.name)} ${studioUrl(host)}`);
     }

package/dist/utils/types.d.ts

@@ -65,6 +65,15 @@ interface StackBase {
 export interface Stack extends StackBase {
     resources: Array<BlueprintResourceRecord>;
 }
+/**
+ * Shape returned by `PUT /stacks/{id}`
+ * The authored document is echoed by the API: resources without `parameters` or `resolvedParameters`.
+ */
+export interface UpdatedStack extends StackBase {
+    resources: BlueprintResource[];
+    operationId: string;
+    changeCount?: number;
+}
 export interface StackSummary extends StackBase {
     resourceCount: number;
 }

package/oclif.manifest.json

@@ -3148,5 +3148,5 @@
       ]
     }
   },
-  "version": "17.13.1-next.g13a83b0"
+  "version": "17.13.1-next.g5faa770"
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@sanity/runtime-cli",
   "description": "Sanity's Runtime CLI for Blueprints and Functions",
-  "version": "17.13.1-next.g13a83b0",
+  "version": "17.13.1-next.g5faa770",
   "author": "Sanity Runtime Team",
   "type": "module",
   "license": "MIT",

package/dist/utils/studios/prepare-asset.d.ts

@@ -1,6 +0,0 @@
-import type { BlueprintStudioResource } from '@sanity/blueprints';
-import type { AssetPrepResult } from '../types.js';
-export declare function prepareStudioAsset({ blueprintFileDir, resource, }: {
-    blueprintFileDir: string;
-    resource: BlueprintStudioResource;
-}): Promise<AssetPrepResult>;

package/dist/utils/studios/prepare-asset.js

@@ -1,166 +0,0 @@
-import { createWriteStream } from 'node:fs';
-import { mkdtemp, readFile, rm, stat } from 'node:fs/promises';
-import { tmpdir } from 'node:os';
-import path, { basename, dirname, join } from 'node:path';
-import { pipeline } from 'node:stream/promises';
-import { createGzip } from 'node:zlib';
-import { buildStudio, compareDependencyVersions } from '@sanity/cli-build/_internal/build';
-import { getLocalPackageVersion } from '@sanity/cli-core';
-import { pack } from 'tar-fs';
-export async function prepareStudioAsset({ blueprintFileDir, resource, }) {
-    // validate resource has an appId
-    const appId = getAppId(resource);
-    if (!appId) {
-        return {
-            success: false,
-            async cleanup() {
-                // no op
-            },
-            error: `Unable to determine appId for sanity.studio resource '${resource.name}'`,
-        };
-    }
-    let cleanup = async () => {
-        // no op
-    };
-    const studioPath = path.resolve(blueprintFileDir, resource.src);
-    // set only when auto-updates is on, because the build compares versions only then
-    let mismatchedPackages;
-    try {
-        const studioPathStat = await stat(studioPath);
-        if (!studioPathStat.isDirectory()) {
-            return {
-                success: false,
-                cleanup,
-                error: `Property 'src' on resource with type '${resource.type}' must be a directory`,
-            };
-        }
-    }
-    catch (error) {
-        const msg = error instanceof Error ? error.message : String(error);
-        return {
-            success: false,
-            cleanup,
-            error: `Unable to read given 'src' on resource with type '${resource.type}': ${msg}`,
-        };
-    }
-    try {
-        const outDir = await mkdtemp(join(tmpdir(), `studio-build-`));
-        const outFile = `${outDir}.tar.gz`;
-        cleanup = async () => {
-            await rm(outDir, { force: true, recursive: true });
-            await rm(outFile, { force: true });
-        };
-        try {
-            await buildStudio({
-                appId,
-                autoUpdatesEnabled: resource.autoUpdates.enabled,
-                checkAppId() { },
-                async compareDependencyVersions(packages) {
-                    const result = await compareDependencyVersions(packages, studioPath, { appId });
-                    mismatchedPackages = result.mismatched.map((m) => m.pkg);
-                    return result;
-                },
-                determineBasePath() {
-                    return resource.basePath ?? '/';
-                },
-                isApp: false,
-                isWorkbenchApp: false,
-                minify: resource.minify ?? true,
-                outDir,
-                output: createSilentOutput(),
-                reactCompiler: resource.reactCompiler || false,
-                schemaExtraction: undefined,
-                sourceMap: resource.sourceMap ?? false,
-                stats: false,
-                unattendedMode: true,
-                // TODO pass in vite config from the studio resource
-                vite: undefined,
-                workDir: studioPath,
-                eventListener: {
-                    onBuildFail({ message }) {
-                        throw new Error(message);
-                    },
-                    onInvalidStyledComponentsVersionRange({ message }) {
-                        throw new Error(message);
-                    },
-                    onNoDeclaredStyledComponentsVersion({ message }) {
-                        throw new Error(message);
-                    },
-                    onNoInstalledSanityVersion({ message }) {
-                        throw new Error(message);
-                    },
-                    onNoInstalledStyledComponentsVersion({ message }) {
-                        throw new Error(message);
-                    },
-                    onPreReleaseInNonInteractiveAutoUpdate({ message }) {
-                        throw new Error(message);
-                    },
-                },
-            });
-        }
-        catch (error) {
-            const message = error instanceof Error ? error.message : String(error);
-            return {
-                success: false,
-                cleanup,
-                error: message,
-            };
-        }
-        // tar/gzip/write the built output
-        await pipeline(pack(dirname(outDir), { entries: [basename(outDir)] }), createGzip(), createWriteStream(outFile));
-        const buffer = await readFile(outFile);
-        return {
-            success: true,
-            cleanup,
-            outputBuffer: buffer,
-            fileExtension: 'tar.gz',
-            assetParameter: 'src',
-            metadata: {
-                sanityVersion: await getInstalledSanityVersion(studioPath),
-                mismatchedPackages,
-                assetBytes: buffer.length,
-            },
-        };
-    }
-    catch (error) {
-        return {
-            success: false,
-            cleanup,
-            error: error instanceof Error ? error.message : String(error),
-        };
-    }
-}
-function createSilentOutput() {
-    return {
-        error(input, options) {
-            if (typeof options?.exit === 'number') {
-                if (input instanceof Error) {
-                    throw input;
-                }
-                throw new Error(input);
-            }
-            return undefined;
-        },
-        log() { },
-        warn(input) {
-            return input;
-        },
-    };
-}
-async function getInstalledSanityVersion(studioPath) {
-    try {
-        return (await getLocalPackageVersion('sanity', studioPath)) ?? undefined;
-    }
-    catch {
-        return undefined;
-    }
-}
-function getAppId(resource) {
-    if ('externalId' in resource && typeof resource.externalId === 'string' && resource.externalId) {
-        return resource.externalId;
-    }
-    else if (resource.lifecycle?.ownershipAction?.type === 'attach') {
-        return resource.lifecycle.ownershipAction.id;
-    }
-    return undefined;
-}