@sanity/runtime-cli 17.13.0 → 17.13.1-next.g09af4b8

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.0/src/commands/blueprints/add.ts)_
+_See code: [src/commands/blueprints/add.ts](https://github.com/sanity-io/runtime-cli/blob/v17.13.1-next.g09af4b8/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.0/src/commands/blueprints/config.ts)_
+_See code: [src/commands/blueprints/config.ts](https://github.com/sanity-io/runtime-cli/blob/v17.13.1-next.g09af4b8/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.0/src/commands/blueprints/deploy.ts)_
+_See code: [src/commands/blueprints/deploy.ts](https://github.com/sanity-io/runtime-cli/blob/v17.13.1-next.g09af4b8/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.0/src/commands/blueprints/destroy.ts)_
+_See code: [src/commands/blueprints/destroy.ts](https://github.com/sanity-io/runtime-cli/blob/v17.13.1-next.g09af4b8/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.0/src/commands/blueprints/doctor.ts)_
+_See code: [src/commands/blueprints/doctor.ts](https://github.com/sanity-io/runtime-cli/blob/v17.13.1-next.g09af4b8/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.0/src/commands/blueprints/info.ts)_
+_See code: [src/commands/blueprints/info.ts](https://github.com/sanity-io/runtime-cli/blob/v17.13.1-next.g09af4b8/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.0/src/commands/blueprints/init.ts)_
+_See code: [src/commands/blueprints/init.ts](https://github.com/sanity-io/runtime-cli/blob/v17.13.1-next.g09af4b8/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.0/src/commands/blueprints/logs.ts)_
+_See code: [src/commands/blueprints/logs.ts](https://github.com/sanity-io/runtime-cli/blob/v17.13.1-next.g09af4b8/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.0/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.g09af4b8/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.0/src/commands/blueprints/plan.ts)_
+_See code: [src/commands/blueprints/plan.ts](https://github.com/sanity-io/runtime-cli/blob/v17.13.1-next.g09af4b8/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.0/src/commands/blueprints/promote.ts)_
+_See code: [src/commands/blueprints/promote.ts](https://github.com/sanity-io/runtime-cli/blob/v17.13.1-next.g09af4b8/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.0/src/commands/blueprints/stacks.ts)_
+_See code: [src/commands/blueprints/stacks.ts](https://github.com/sanity-io/runtime-cli/blob/v17.13.1-next.g09af4b8/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.0/src/commands/functions/add.ts)_
+_See code: [src/commands/functions/add.ts](https://github.com/sanity-io/runtime-cli/blob/v17.13.1-next.g09af4b8/src/commands/functions/add.ts)_
 
 ## `sanity-run functions dev`
 
@@ -632,8 +632,8 @@ DESCRIPTION
 
   Open the emulator in your browser to interactively test your functions with the payload editor.
 
-  Optionally, set the host and port with the --host and --port flags. Port 8974 is reserved for the emulator's
-  live-reload WebSocket server. Function timeout can be configured with the --timeout flag.
+  Optionally, set the host and port with the --host and --port flags. The live-reload WebSocket server shares this host
+  and port. Function timeout can be configured with the --timeout flag.
 
   To invoke a function with the CLI, use 'functions test'.
 
@@ -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.0/src/commands/functions/dev.ts)_
+_See code: [src/commands/functions/dev.ts](https://github.com/sanity-io/runtime-cli/blob/v17.13.1-next.g09af4b8/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.0/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.g09af4b8/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.0/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.g09af4b8/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.0/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.g09af4b8/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.0/src/commands/functions/logs.ts)_
+_See code: [src/commands/functions/logs.ts](https://github.com/sanity-io/runtime-cli/blob/v17.13.1-next.g09af4b8/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.0/src/commands/functions/test.ts)_
+_See code: [src/commands/functions/test.ts](https://github.com/sanity-io/runtime-cli/blob/v17.13.1-next.g09af4b8/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 { APP_BUILD_SPECS, prepareApplicationAsset, } from '../../utils/applications/prepare-asset.js';
 import { resolveDeployedResources } from '../../utils/blueprints/resolve-deployed-resources.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 APP_BUILD_SPECS,
         async prepareAsset(options) {
-            return prepareStudioAsset({
+            return prepareApplicationAsset({
                 resource: options.resource,
                 blueprintFileDir: options.blueprintFileDir,
             });

package/dist/commands/functions/dev.js

@@ -9,7 +9,7 @@ export default class DevCommand extends ResolvedCommand {
 
 Open the emulator in your browser to interactively test your functions with the payload editor.
 
-Optionally, set the host and port with the --host and --port flags. Port 8974 is reserved for the emulator's live-reload WebSocket server. Function timeout can be configured with the --timeout flag.
+Optionally, set the host and port with the --host and --port flags. The live-reload WebSocket server shares this host and port. Function timeout can be configured with the --timeout flag.
 
 To invoke a function with the CLI, use 'functions test'.`;
     static examples = [

package/dist/constants.d.ts

@@ -13,6 +13,7 @@ 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 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,7 @@ 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 EVENT_DOCUMENT_PUBLISH = 'document-publish';
 export const EVENT_DOCUMENT_CREATE = 'document-create';
 export const EVENT_DOCUMENT_UPDATE = 'document-update';

package/dist/server/app.d.ts

@@ -1,5 +1,6 @@
+import * as http from 'node:http';
 import { type InvokeExecutionOptions } from '../utils/types.js';
-declare const app: (host: string, port: number, validateResources: boolean, executionOptions?: Partial<InvokeExecutionOptions>) => void;
+declare const app: (host: string, port: number, validateResources: boolean, executionOptions?: Partial<InvokeExecutionOptions>) => http.Server<typeof http.IncomingMessage, typeof http.ServerResponse>;
 declare function parseDocumentUrl(url: string): {
     projectId: string;
     dataset: string;

package/dist/server/app.js

@@ -11,7 +11,6 @@ import { isRecord } from '../utils/is-record.js';
 import { isEventType, isGroqContextOptions, } from '../utils/types.js';
 import { handleInvokeRequest } from './handlers/invoke.js';
 const app = (host, port, validateResources, executionOptions) => {
-    const wss = new WebSocketServer({ port: 8974 });
     // Send a JSON envelope to every connected UI client.
     const broadcast = (envelope) => {
         const message = JSON.stringify(envelope);
@@ -268,6 +267,9 @@ const app = (host, port, validateResources, executionOptions) => {
         }
     };
     const server = http.createServer(requestListener);
+    // Share the HTTP server so live-reload upgrades on the emulator's own port,
+    // rather than reserving a second port that may already be taken.
+    const wss = new WebSocketServer({ server });
     server.listen(port, host, () => { });
     wss.on('connection', function connection(ws) {
         ws.on('error', console.error);
@@ -280,6 +282,7 @@ const app = (host, port, validateResources, executionOptions) => {
                 ws.send('reload-blueprint');
         });
     });
+    return server;
 };
 // Helper function to test URL parsing and document fetching logic
 function parseDocumentUrl(url) {

package/dist/server/static/web-socket.js

@@ -2,8 +2,10 @@ import apiConstructor from '../api.js'
 
 const api = apiConstructor()
 
-// Create WebSocket connection.
-const socket = new WebSocket('ws://localhost:8974')
+// Create WebSocket connection on the same origin the emulator is served from,
+// so it follows the --host and --port the server was started with.
+const protocol = window.location.protocol === 'https:' ? 'wss:' : 'ws:'
+const socket = new WebSocket(`${protocol}//${window.location.host}`)
 
 // Connection opened
 socket.addEventListener('open', () => {

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

@@ -0,0 +1,31 @@
+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, BlueprintStudioResource } from './types.js';
+export type ApplicationBuildResource = BlueprintStudioResource | BlueprintApplicationResource;
+type BuildContext<R extends ApplicationBuildResource> = {
+    resource: R;
+    appId: string;
+    workDir: string;
+    outDir: string;
+    output: Output;
+    eventListener: Partial<BuildStudioEventListener>;
+};
+type BuildResult = {
+    mismatchedPackages?: string[];
+};
+export declare const APP_BUILD_SPECS: {
+    'sanity.studio': {
+        build: typeof buildStudioBundle;
+    };
+    'sanity.application': {
+        build: typeof buildApplicationBundle;
+    };
+};
+export declare function prepareApplicationAsset<R extends ApplicationBuildResource>({ 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>;
+export {};

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

@@ -0,0 +1,245 @@
+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 APP_BUILD_SPECS = {
+    'sanity.studio': { build: buildStudioBundle },
+    'sanity.application': { build: buildApplicationBundle },
+};
+export async function prepareApplicationAsset({ blueprintFileDir, resource, }) {
+    // The lookup can't prove it yields the spec matching this R, so it's asserted once here.
+    const spec = APP_BUILD_SPECS[resource.type];
+    const appId = getAppId(resource);
+    if (!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);
+    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(), `app-build-`));
+        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`);
+    }
+    let mismatchedPackages;
+    await buildApp({
+        appId,
+        appTitle: resource.title,
+        autoUpdatesEnabled: false,
+        checkAppId() { },
+        async compareDependencyVersions(packages) {
+            const result = await compareDependencyVersions(packages, workDir, { appId });
+            mismatchedPackages = result.mismatched.map((m) => m.pkg);
+            return result;
+        },
+        determineBasePath() {
+            return '/';
+        },
+        entry: window?.src,
+        isWorkbenchApp: true,
+        isBlueprints: true,
+        workbenchAppId: appId,
+        minify: true,
+        outDir,
+        output,
+        reactCompiler: false,
+        schemaExtraction: undefined,
+        sourceMap: false,
+        stats: false,
+        unattendedMode: true,
+        vite: undefined,
+        workDir,
+        eventListener,
+        exposes: {
+            views: views.map(toWorkbenchView),
+            webWorkers: resource.webWorkers,
+        },
+    });
+    return { mismatchedPackages };
+}
+// 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/applications/types.d.ts

@@ -0,0 +1,46 @@
+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[];
+}
+export {};

package/dist/utils/applications/types.js

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

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_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,10 @@ const RESOURCE_CATEGORIES = {
             return isStudioResource(res) ? arrayifyStudio(res) : [];
         },
     },
+    [SANITY_APPLICATION]: {
+        label: 'Applications',
+        displayNameAttribute: 'title',
+    },
 };
 const categoryByLabel = Object.values(RESOURCE_CATEGORIES).reduce((acc, curr) => {
     acc[curr.label] = curr;

package/oclif.manifest.json

@@ -2042,7 +2042,7 @@
     "functions:dev": {
       "aliases": [],
       "args": {},
-      "description": "Runs a local, web-based development server to test your functions before deploying.\n\nOpen the emulator in your browser to interactively test your functions with the payload editor.\n\nOptionally, set the host and port with the --host and --port flags. Port 8974 is reserved for the emulator's live-reload WebSocket server. Function timeout can be configured with the --timeout flag.\n\nTo invoke a function with the CLI, use 'functions test'.",
+      "description": "Runs a local, web-based development server to test your functions before deploying.\n\nOpen the emulator in your browser to interactively test your functions with the payload editor.\n\nOptionally, set the host and port with the --host and --port flags. The live-reload WebSocket server shares this host and port. Function timeout can be configured with the --timeout flag.\n\nTo invoke a function with the CLI, use 'functions test'.",
       "examples": [
         "<%= config.bin %> <%= command.id %> --host 127.0.0.1 --port 3333",
         "<%= config.bin %> <%= command.id %> --timeout 60"
@@ -3148,5 +3148,5 @@
       ]
     }
   },
-  "version": "17.13.0"
+  "version": "17.13.1-next.g09af4b8"
 }

package/package.json

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

package/skills/functions-dev.md

@@ -16,6 +16,6 @@ The emulator is available at `http://localhost:8080`. Choose another loopback po
 npx @sanity/cli functions dev --host 127.0.0.1 --port 3333 --timeout 60
 ```
 
-Port 8974 is not available: the emulator's WebSocket server binds it. `--timeout` sets the execution limit in seconds for every Function, taking precedence over each Function's configured `timeout` (default 10 seconds). Bind to a non-loopback interface only when network access is requested and exposing the development server is acceptable.
+The emulator's live-reload WebSocket server shares the same host and port, so no additional port is reserved. `--timeout` sets the execution limit in seconds for every Function, taking precedence over each Function's configured `timeout` (default 10 seconds). Bind to a non-loopback interface only when network access is requested and exposing the development server is acceptable.
 
 Run this command in a persistent terminal, report the URL, and stop the process when development is complete. For one bounded invocation without a web server, use `functions test`.

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;
-}