@sanity/runtime-cli 15.2.1 → 16.0.1

package/README.md

@@ -20,7 +20,7 @@ $ npm install -g @sanity/runtime-cli
 $ sanity-run COMMAND
 running command...
 $ sanity-run (--version)
-@sanity/runtime-cli/15.2.1 linux-x64 node-v24.16.0
+@sanity/runtime-cli/16.0.1 linux-x64 node-v24.16.0
 $ sanity-run --help [COMMAND]
 USAGE
   $ sanity-run COMMAND
@@ -103,7 +103,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/v15.2.1/src/commands/blueprints/add.ts)_
+_See code: [src/commands/blueprints/add.ts](https://github.com/sanity-io/runtime-cli/blob/v16.0.1/src/commands/blueprints/add.ts)_
 
 ## `sanity-run blueprints config`
 
@@ -140,7 +140,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/v15.2.1/src/commands/blueprints/config.ts)_
+_See code: [src/commands/blueprints/config.ts](https://github.com/sanity-io/runtime-cli/blob/v16.0.1/src/commands/blueprints/config.ts)_
 
 ## `sanity-run blueprints deploy`
 
@@ -194,7 +194,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/v15.2.1/src/commands/blueprints/deploy.ts)_
+_See code: [src/commands/blueprints/deploy.ts](https://github.com/sanity-io/runtime-cli/blob/v16.0.1/src/commands/blueprints/deploy.ts)_
 
 ## `sanity-run blueprints destroy`
 
@@ -232,7 +232,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/v15.2.1/src/commands/blueprints/destroy.ts)_
+_See code: [src/commands/blueprints/destroy.ts](https://github.com/sanity-io/runtime-cli/blob/v16.0.1/src/commands/blueprints/destroy.ts)_
 
 ## `sanity-run blueprints doctor`
 
@@ -263,7 +263,7 @@ EXAMPLES
   $ sanity-run blueprints doctor --fix
 ```
 
-_See code: [src/commands/blueprints/doctor.ts](https://github.com/sanity-io/runtime-cli/blob/v15.2.1/src/commands/blueprints/doctor.ts)_
+_See code: [src/commands/blueprints/doctor.ts](https://github.com/sanity-io/runtime-cli/blob/v16.0.1/src/commands/blueprints/doctor.ts)_
 
 ## `sanity-run blueprints info`
 
@@ -300,7 +300,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/v15.2.1/src/commands/blueprints/info.ts)_
+_See code: [src/commands/blueprints/info.ts](https://github.com/sanity-io/runtime-cli/blob/v16.0.1/src/commands/blueprints/info.ts)_
 
 ## `sanity-run blueprints init [DIR]`
 
@@ -359,7 +359,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/v15.2.1/src/commands/blueprints/init.ts)_
+_See code: [src/commands/blueprints/init.ts](https://github.com/sanity-io/runtime-cli/blob/v16.0.1/src/commands/blueprints/init.ts)_
 
 ## `sanity-run blueprints logs`
 
@@ -405,7 +405,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/v15.2.1/src/commands/blueprints/logs.ts)_
+_See code: [src/commands/blueprints/logs.ts](https://github.com/sanity-io/runtime-cli/blob/v16.0.1/src/commands/blueprints/logs.ts)_
 
 ## `sanity-run blueprints mint-deploy-token`
 
@@ -450,7 +450,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/v15.2.1/src/commands/blueprints/mint-deploy-token.ts)_
+_See code: [src/commands/blueprints/mint-deploy-token.ts](https://github.com/sanity-io/runtime-cli/blob/v16.0.1/src/commands/blueprints/mint-deploy-token.ts)_
 
 ## `sanity-run blueprints plan`
 
@@ -483,7 +483,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/v15.2.1/src/commands/blueprints/plan.ts)_
+_See code: [src/commands/blueprints/plan.ts](https://github.com/sanity-io/runtime-cli/blob/v16.0.1/src/commands/blueprints/plan.ts)_
 
 ## `sanity-run blueprints promote`
 
@@ -519,7 +519,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/v15.2.1/src/commands/blueprints/promote.ts)_
+_See code: [src/commands/blueprints/promote.ts](https://github.com/sanity-io/runtime-cli/blob/v16.0.1/src/commands/blueprints/promote.ts)_
 
 ## `sanity-run blueprints stacks`
 
@@ -555,7 +555,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/v15.2.1/src/commands/blueprints/stacks.ts)_
+_See code: [src/commands/blueprints/stacks.ts](https://github.com/sanity-io/runtime-cli/blob/v16.0.1/src/commands/blueprints/stacks.ts)_
 
 ## `sanity-run functions add`
 
@@ -607,7 +607,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/v15.2.1/src/commands/functions/add.ts)_
+_See code: [src/commands/functions/add.ts](https://github.com/sanity-io/runtime-cli/blob/v16.0.1/src/commands/functions/add.ts)_
 
 ## `sanity-run functions dev`
 
@@ -642,7 +642,7 @@ EXAMPLES
   $ sanity-run functions dev --timeout 60
 ```
 
-_See code: [src/commands/functions/dev.ts](https://github.com/sanity-io/runtime-cli/blob/v15.2.1/src/commands/functions/dev.ts)_
+_See code: [src/commands/functions/dev.ts](https://github.com/sanity-io/runtime-cli/blob/v16.0.1/src/commands/functions/dev.ts)_
 
 ## `sanity-run functions env add NAME KEY VALUE`
 
@@ -672,7 +672,7 @@ EXAMPLES
   $ sanity-run functions env add MyFunction API_URL https://api.example.com/
 ```
 
-_See code: [src/commands/functions/env/add.ts](https://github.com/sanity-io/runtime-cli/blob/v15.2.1/src/commands/functions/env/add.ts)_
+_See code: [src/commands/functions/env/add.ts](https://github.com/sanity-io/runtime-cli/blob/v16.0.1/src/commands/functions/env/add.ts)_
 
 ## `sanity-run functions env list NAME`
 
@@ -699,7 +699,7 @@ EXAMPLES
   $ sanity-run functions env list MyFunction
 ```
 
-_See code: [src/commands/functions/env/list.ts](https://github.com/sanity-io/runtime-cli/blob/v15.2.1/src/commands/functions/env/list.ts)_
+_See code: [src/commands/functions/env/list.ts](https://github.com/sanity-io/runtime-cli/blob/v16.0.1/src/commands/functions/env/list.ts)_
 
 ## `sanity-run functions env remove NAME KEY`
 
@@ -728,7 +728,7 @@ EXAMPLES
   $ sanity-run functions env remove MyFunction API_URL
 ```
 
-_See code: [src/commands/functions/env/remove.ts](https://github.com/sanity-io/runtime-cli/blob/v15.2.1/src/commands/functions/env/remove.ts)_
+_See code: [src/commands/functions/env/remove.ts](https://github.com/sanity-io/runtime-cli/blob/v16.0.1/src/commands/functions/env/remove.ts)_
 
 ## `sanity-run functions logs [NAME]`
 
@@ -768,7 +768,7 @@ EXAMPLES
   $ sanity-run functions logs <name> --delete
 ```
 
-_See code: [src/commands/functions/logs.ts](https://github.com/sanity-io/runtime-cli/blob/v15.2.1/src/commands/functions/logs.ts)_
+_See code: [src/commands/functions/logs.ts](https://github.com/sanity-io/runtime-cli/blob/v16.0.1/src/commands/functions/logs.ts)_
 
 ## `sanity-run functions test [NAME]`
 
@@ -825,7 +825,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/v15.2.1/src/commands/functions/test.ts)_
+_See code: [src/commands/functions/test.ts](https://github.com/sanity-io/runtime-cli/blob/v16.0.1/src/commands/functions/test.ts)_
 
 ## `sanity-run help [COMMAND]`
 

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

@@ -1,8 +1,8 @@
 import AdmZip from 'adm-zip';
 import type { Logger } from '../../utils/logger.js';
 import type { AssetResource, AuthParams, InstallerType } from '../../utils/types.js';
-export declare const ASSET_CHECK_URL: string;
-export declare const ASSET_STASH_URL: string;
+export declare const assetCheckUrl: string;
+export declare const assetStashUrl: string;
 export declare function stashAsset({ resource, auth, logger, installer, }: {
     resource: AssetResource;
     auth: AuthParams;

package/dist/actions/blueprints/assets.js

@@ -1,16 +1,15 @@
 import crypto from 'node:crypto';
 import fs from 'node:fs';
 import AdmZip from 'adm-zip';
-import config from '../../config.js';
+import { blueprintsUrl } from '../../config.js';
 import { CONVERT_BYTES_TO_MB, MAX_ASSET_SIZE } from '../../constants.js';
 import { prepareAsset as prepareFunctionAsset } from '../../utils/functions/prepare-asset.js';
 import getHeaders from '../../utils/get-headers.js';
 import { createTracedFetch } from '../../utils/traced-fetch.js';
 import { isLocalFunctionResource, isStudioResource } from '../../utils/types.js';
-const { apiUrl } = config;
-const ASSETS_URL = `${apiUrl}vX/blueprints/assets`;
-export const ASSET_CHECK_URL = `${ASSETS_URL}/check`;
-export const ASSET_STASH_URL = `${ASSETS_URL}/stash`;
+const assetsUrl = blueprintsUrl('assets');
+export const assetCheckUrl = `${assetsUrl}/check`;
+export const assetStashUrl = `${assetsUrl}/stash`;
 export async function stashAsset({ resource, auth, logger, installer, }) {
     try {
         let b64;
@@ -88,7 +87,7 @@ async function stashSingleAsset({ b64, hash, cleanup, resource, auth, logger, ex
     const fetchFn = createTracedFetch(logger);
     try {
         try {
-            const checkResponse = await fetchFn(`${ASSET_CHECK_URL}/${hash}`, {
+            const checkResponse = await fetchFn(`${assetCheckUrl}/${hash}`, {
                 method: 'GET',
                 headers: getHeaders(auth),
             });
@@ -99,7 +98,7 @@ async function stashSingleAsset({ b64, hash, cleanup, resource, auth, logger, ex
         }
         catch { } // Continue to stash the Asset
         // Asset doesn't exist, so stash it
-        const assetResponse = await fetchFn(ASSET_STASH_URL, {
+        const assetResponse = await fetchFn(assetStashUrl, {
             method: 'POST',
             headers: getHeaders(auth),
             body: JSON.stringify({

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

@@ -37,7 +37,7 @@ export interface ConfigPatch {
 /**
  * Update the config file with the given properties.
  * Config file must already exist.
- * Adds timestamp. No validation or transformation is performed.
+ * Adds timestamp. No ID combination validation.
  * @param blueprintFilePath - the path to the blueprint file
  * @param updateableProperties - the properties to update
  * @param updateableProperties.organizationId - the organization ID (null to remove)
@@ -45,6 +45,14 @@ export interface ConfigPatch {
  * @param updateableProperties.stackId - the stack ID (null to remove)
  */
 export declare function patchConfigFile(blueprintFilePath: string, updateableProperties: ConfigPatch): BlueprintsConfig;
+/**
+ * Patch a known config using its `configPath`.
+ * Unlike {@link patchConfigFile}, this does not re-derive the config location.
+ * Adds timestamp. No ID combination validation.
+ * @param existingConfig - the located config (includes `configPath`)
+ * @param updateableProperties - the properties to update (null to remove)
+ */
+export declare function patchLocatedConfig(existingConfig: LocatedBlueprintsConfig, updateableProperties: ConfigPatch): BlueprintsConfig;
 /**
  * Find and write an organizationId to the config file by getting it from the projectId
  * @throws {Error} if unable to fetch project

package/dist/actions/blueprints/config.js

@@ -54,7 +54,7 @@ export function writeConfigFile(blueprintFilePath, options) {
 /**
  * Update the config file with the given properties.
  * Config file must already exist.
- * Adds timestamp. No validation or transformation is performed.
+ * Adds timestamp. No ID combination validation.
  * @param blueprintFilePath - the path to the blueprint file
  * @param updateableProperties - the properties to update
  * @param updateableProperties.organizationId - the organization ID (null to remove)
@@ -65,6 +65,16 @@ export function patchConfigFile(blueprintFilePath, updateableProperties) {
     const existingConfig = readConfigFile(blueprintFilePath);
     if (!existingConfig)
         throw new Error('No config file found');
+    return patchLocatedConfig(existingConfig, updateableProperties);
+}
+/**
+ * Patch a known config using its `configPath`.
+ * Unlike {@link patchConfigFile}, this does not re-derive the config location.
+ * Adds timestamp. No ID combination validation.
+ * @param existingConfig - the located config (includes `configPath`)
+ * @param updateableProperties - the properties to update (null to remove)
+ */
+export function patchLocatedConfig(existingConfig, updateableProperties) {
     const { configPath, ...existingConfigProperties } = existingConfig;
     const merged = {
         blueprintConfigVersion: BLUEPRINT_CONFIG_VERSION, // patch doesn't overwrite versions

package/dist/actions/blueprints/logs.js

@@ -1,8 +1,7 @@
-import config from '../../config.js';
+import { blueprintsUrl } from '../../config.js';
 import getHeaders from '../../utils/get-headers.js';
 import { createTracedFetch } from '../../utils/traced-fetch.js';
-const { apiUrl } = config;
-export const logsUrl = `${apiUrl}vX/blueprints/logs`;
+export const logsUrl = blueprintsUrl('logs');
 export async function getLogs(params, auth, logger) {
     const fetchFn = createTracedFetch(logger);
     const url = new URL(logsUrl);

package/dist/actions/blueprints/stacks.js

@@ -1,8 +1,7 @@
-import config from '../../config.js';
+import { blueprintsUrl } from '../../config.js';
 import getHeaders from '../../utils/get-headers.js';
 import { createTracedFetch } from '../../utils/traced-fetch.js';
-const { apiUrl } = config;
-export const stacksUrl = `${apiUrl}vX/blueprints/stacks`;
+export const stacksUrl = blueprintsUrl('stacks');
 export async function listStacks(auth, logger) {
     const fetchFn = createTracedFetch(logger);
     try {

package/dist/baseCommands.d.ts

@@ -1,9 +1,9 @@
 import type { Interfaces } from '@oclif/core';
 import { Command } from '@oclif/core';
 import { type ReadBlueprintResult } from './actions/blueprints/blueprint.js';
+import { type LocatedBlueprintsConfig } from './actions/blueprints/config.js';
 import type { CoreResult } from './cores/index.js';
-import type { Warning } from './utils/blueprints/warnings.js';
-import type { AuthParams, ScopeType, Stack } from './utils/types.js';
+import type { AuthParams, ScopeType, Stack, Warning } from './utils/types.js';
 export type Flags<T extends typeof Command> = Interfaces.InferredFlags<(typeof RuntimeCommand)['baseFlags'] & T['flags']>;
 export type Args<T extends typeof Command> = Interfaces.InferredArgs<T['args']>;
 export declare const pathFlagConfig: {
@@ -126,6 +126,16 @@ export declare abstract class ResolvedCommand<T extends typeof Command> extends
     protected scopeType: ScopeType;
     protected scopeId: string;
     protected stackId: string;
+    /**
+     * locally-resolved Stack ID (flags > env > module > config)
+     * populated regardless of `needs` and is never required
+     */
+    protected resolvedStackId?: string;
+    /**
+     * the located `.sanity/blueprint.config.json` (if any), populated regardless of
+     * `needs`. Lets commands read/update local config without requiring a manifest.
+     */
+    protected blueprintConfig?: LocatedBlueprintsConfig | null;
     protected auth: AuthParams;
     protected deployedStack: Stack;
     init(): Promise<void>;

package/dist/baseCommands.js

@@ -1,7 +1,7 @@
 // * https://oclif.io/docs/base_class
 import { Command, CommandHelp, Flags as OclifFlags } from '@oclif/core';
 import { findBlueprintFile, loadBlueprintFile, parseBlueprintContent, } from './actions/blueprints/blueprint.js';
-import { backfillProjectBasedStackId, readConfigFile } from './actions/blueprints/config.js';
+import { backfillProjectBasedStackId, readConfigFile, } from './actions/blueprints/config.js';
 import { resolveIds } from './actions/blueprints/resolve.js';
 import { getStack, resolveStackIdByNameOrId } from './actions/blueprints/stacks.js';
 import { presentBlueprintParserErrors } from './utils/display/errors.js';
@@ -146,7 +146,7 @@ export class RuntimeCommand extends Command {
         if (!warnings.length)
             return;
         this.log('');
-        this.log(styleText(['bold', 'yellow'], 'Suggestions'));
+        this.log(styleText(['bold', 'yellow'], 'Notice'));
         this.log('');
         for (const entry of warnings) {
             entry.suggestions.forEach((sug) => {
@@ -206,6 +206,16 @@ export class ResolvedCommand extends RuntimeCommand {
     scopeType;
     scopeId;
     stackId;
+    /**
+     * locally-resolved Stack ID (flags > env > module > config)
+     * populated regardless of `needs` and is never required
+     */
+    resolvedStackId;
+    /**
+     * the located `.sanity/blueprint.config.json` (if any), populated regardless of
+     * `needs`. Lets commands read/update local config without requiring a manifest.
+     */
+    blueprintConfig;
     auth;
     deployedStack;
     async init() {
@@ -233,6 +243,7 @@ export class ResolvedCommand extends RuntimeCommand {
         // Anchor to --path flag or the blueprint file location if found, else cwd.
         const blueprintFileInfo = findBlueprintFile(this.flags.path);
         const blueprintConfig = readConfigFile(blueprintFileInfo?.blueprintFilePath);
+        this.blueprintConfig = blueprintConfig;
         // 3. Blueprint (if needed)
         let blueprintModule;
         if (needsBlueprint) {
@@ -292,6 +303,8 @@ export class ResolvedCommand extends RuntimeCommand {
                 // assumption was wrong; leave stackId undefined
             }
         }
+        // Expose the resolved Stack ID regardless of `needs` (optional, for listings/highlighting)
+        this.resolvedStackId = resolved.stackId;
         // Backfill resolved IDs onto the blueprint result if it was loaded
         if (this.blueprint) {
             Object.assign(this.blueprint, {

package/dist/commands/blueprints/destroy.d.ts

@@ -1,6 +1,6 @@
 import { ResolvedCommand } from '../../baseCommands.js';
 export default class DestroyCommand extends ResolvedCommand<typeof DestroyCommand> {
-    static needs: readonly ["token", "blueprint"];
+    static needs: readonly ["scope"];
     static summary: string;
     static description: string;
     static examples: string[];

package/dist/commands/blueprints/destroy.js

@@ -3,7 +3,7 @@ import { organizationIdFlagConfig, projectIdFlagConfig, ResolvedCommand } from '
 import { blueprintDestroyCore } from '../../cores/blueprints/destroy.js';
 import { Logger } from '../../utils/logger.js';
 export default class DestroyCommand extends ResolvedCommand {
-    static needs = ['token', 'blueprint'];
+    static needs = ['scope'];
     static summary = 'Destroy a remote Stack deployment and its resources';
     static description = `Permanently removes the remote Stack and all its provisioned resources. Your Blueprint manifest and resource files remain intact; "stackId" is unset in your local config.
 
@@ -44,8 +44,10 @@ Exit codes: 0 destroyed, 2 destruction failed, 75 destruction accepted but compl
             bin: this.config.bin,
             log: Logger(this.log.bind(this), this.flags),
             token: this.sanityToken,
-            blueprint: this.blueprint,
-            validateResources: this.flags['validate-resources'],
+            scopeType: this.scopeType,
+            scopeId: this.scopeId,
+            localStackId: this.resolvedStackId,
+            blueprintConfig: this.blueprintConfig,
             flags: this.flags,
         });
         if (!result.success)

package/dist/commands/blueprints/plan.js

@@ -28,6 +28,8 @@ Run 'blueprints plan' after making local changes to your Blueprint manifest to v
         });
         if (!result.success)
             this.coreError(result);
+        if (result.warnings)
+            this.renderWarnings(result?.warnings);
         return result.json;
     }
 }

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

@@ -1,6 +1,6 @@
 import { ResolvedCommand } from '../../baseCommands.js';
 export default class StacksCommand extends ResolvedCommand<typeof StacksCommand> {
-    static needs: readonly ["token", "blueprint"];
+    static needs: readonly ["scope"];
     static summary: string;
     static description: string;
     static examples: string[];

package/dist/commands/blueprints/stacks.js

@@ -3,7 +3,7 @@ import { organizationIdFlagConfig, projectIdFlagConfig, ResolvedCommand } from '
 import { blueprintStacksCore } from '../../cores/blueprints/stacks.js';
 import { Logger } from '../../utils/logger.js';
 export default class StacksCommand extends ResolvedCommand {
-    static needs = ['token', 'blueprint'];
+    static needs = ['scope'];
     static summary = 'List remote Stack deployments for your project or organization';
     static description = `Shows all Stacks associated with a project or organization. By default, lists Stacks scoped to the local Blueprint.
 
@@ -32,8 +32,9 @@ Use --include-projects with --organization-id to also list Stacks from all proje
             bin: this.config.bin,
             log: Logger(this.log.bind(this), this.flags),
             token: this.sanityToken,
-            blueprint: this.blueprint,
-            validateResources: this.flags['validate-resources'],
+            scopeType: this.scopeType,
+            scopeId: this.scopeId,
+            localStackId: this.resolvedStackId,
             flags: this.flags,
         });
         if (!result.success)

package/dist/commands/functions/add.js

@@ -71,5 +71,7 @@ After adding, use 'functions dev' to test locally, then 'blueprints deploy' to p
         });
         if (!result.success)
             this.coreError(result);
+        if (result.warnings)
+            this.renderWarnings(result?.warnings);
     }
 }

package/dist/config.d.ts

@@ -1,9 +1,17 @@
 export declare const BLUEPRINT_CONFIG_VERSION = "v2025-05-08";
+export declare const BLUEPRINTS_API_VERSION: string;
 export declare const BLUEPRINT_CONFIG_DIR = ".sanity";
 export declare const BLUEPRINT_CONFIG_FILE = "blueprint.config.json";
 export declare const RUNTIME_CLI_NAME = "@sanity/runtime-cli";
 export declare let RUNTIME_CLI_VERSION: string | undefined;
 export declare const RUNTIME_CLI_USER_AGENT: string;
+/**
+ * Build a Blueprints API URL for the given path.
+ *
+ * Uses `BLUEPRINTS_API_VERSION` by default (itself overridable via the
+ * `SANITY_BLUEPRINTS_API_VERSION` env var); pass `version` to override per-endpoint.
+ */
+export declare function blueprintsUrl(path: string, version?: string): string;
 declare const _default: {
     isTest: boolean;
     isLive: boolean;

package/dist/config.js

@@ -4,6 +4,9 @@ import { fileURLToPath } from 'node:url';
 import * as pkg from 'empathic/package';
 import getToken from './utils/get-token.js';
 export const BLUEPRINT_CONFIG_VERSION = 'v2025-05-08';
+// Default API version for Blueprints service calls.
+// Overridable globally via env, or per-endpoint via the `version` arg to `blueprintsUrl`.
+export const BLUEPRINTS_API_VERSION = env.SANITY_BLUEPRINTS_API_VERSION ?? 'v2026-06-15';
 export const BLUEPRINT_CONFIG_DIR = '.sanity';
 export const BLUEPRINT_CONFIG_FILE = 'blueprint.config.json';
 export const RUNTIME_CLI_NAME = '@sanity/runtime-cli';
@@ -35,6 +38,15 @@ const apiUrls = {
 const apiUrl = sanityEnv ? (apiUrls[sanityEnv] ?? sanityEnv) : apiUrls.default;
 // allow override of populus URL
 const populusApiUrl = env.POPULUS_API_URL ?? apiUrl;
+/**
+ * Build a Blueprints API URL for the given path.
+ *
+ * Uses `BLUEPRINTS_API_VERSION` by default (itself overridable via the
+ * `SANITY_BLUEPRINTS_API_VERSION` env var); pass `version` to override per-endpoint.
+ */
+export function blueprintsUrl(path, version = BLUEPRINTS_API_VERSION) {
+    return `${apiUrl}${version}/blueprints/${path}`;
+}
 let _token;
 function loadToken() {
     let token = null;

package/dist/cores/blueprints/deploy.js

@@ -1,3 +1,4 @@
+import { dirname } from 'node:path';
 import { stashAsset } from '../../actions/blueprints/assets.js';
 import { getStack, updateStack } from '../../actions/blueprints/stacks.js';
 import { waitForOperation } from '../../actions/blueprints/wait-for-operation.js';
@@ -7,6 +8,7 @@ import { niceId } from '../../utils/display/presenters.js';
 import { CODE_OPERATION_UNCONFIRMED, EXIT_OPERATION_UNCONFIRMED } from '../../utils/exit-codes.js';
 import { styleText } from '../../utils/style-text.js';
 import { isAssetResource } from '../../utils/types.js';
+import { getWarnings } from '../../utils/warnings.js';
 const DEFAULT_ASSET_TIMEOUT = 60;
 const assetTimeoutS = Number(process.env.SANITY_ASSET_TIMEOUT) || DEFAULT_ASSET_TIMEOUT;
 const assetTimeoutMs = assetTimeoutS * 1000;
@@ -17,6 +19,7 @@ export async function blueprintDeployCore(options) {
     const noWait = flags['no-wait'] || false;
     const stackName = flags['new-stack-name'] ?? deployedStack.name;
     const installer = flags['fn-installer'] || undefined;
+    const workspaceWarnings = getWarnings({ dir: dirname(blueprint.fileInfo.blueprintFilePath) });
     log(`Deploying "${stackName}" ${niceId(deployedStack.id)}...`);
     try {
         const { ok: checkOk, stack: currentStack } = await getStack({ stackId, auth, logger: log });
@@ -89,11 +92,12 @@ export async function blueprintDeployCore(options) {
             log(styleText(['bold', 'green'], 'Stack deployment started!'));
             log(`Use \`npx ${bin} blueprints info\` to check status`);
             const legacyWarning = await legacyPermissionsNoticePromise;
+            const warnings = [...(legacyWarning ? [legacyWarning] : []), ...workspaceWarnings];
             return {
                 success: true,
                 json: { stackId, resources },
                 data: { resources },
-                warnings: legacyWarning ? [legacyWarning] : undefined,
+                warnings: warnings.length ? warnings : undefined,
             };
         }
         log(styleText('dim', 'Stack deployment progress:'));
@@ -110,11 +114,12 @@ export async function blueprintDeployCore(options) {
         if (outcome.type === 'completed') {
             log(styleText(['bold', 'green'], 'Stack deployment completed!'));
             const legacyWarning = await legacyPermissionsNoticePromise;
+            const warnings = [...(legacyWarning ? [legacyWarning] : []), ...workspaceWarnings];
             return {
                 success: true,
                 json: { stackId, resources },
                 data: { resources },
-                warnings: legacyWarning ? [legacyWarning] : undefined,
+                warnings: warnings.length ? warnings : undefined,
             };
         }
         if (outcome.type === 'unconfirmed') {
@@ -212,7 +217,7 @@ async function checkLegacyDeployPermission({ auth, scopeType, scopeId, log, }) {
         if (result.hasPermission)
             return null;
         return {
-            label: 'Legacy deploy permission',
+            code: 'Legacy deploy permission',
             suggestions: [
                 `This deploy used a legacy permission. Starting ${BLUEPRINTS_PERMISSION_ENFORCEMENT_DATE}, deploys will require the "${requiredPermission}" permission.`,
                 scopeType === 'project'

package/dist/cores/blueprints/destroy.d.ts

@@ -1,5 +1,15 @@
-import type { BlueprintConfig, CoreResult } from '../index.js';
-export interface BlueprintDestroyOptions extends BlueprintConfig {
+import { type LocatedBlueprintsConfig } from '../../actions/blueprints/config.js';
+import type { ScopeType } from '../../utils/types.js';
+import type { CoreConfig, CoreResult } from '../index.js';
+export interface BlueprintDestroyOptions extends CoreConfig {
+    token: string;
+    /** Scope to destroy within, resolved by the base command (flags > env > config). */
+    scopeType?: ScopeType;
+    scopeId?: string;
+    /** Locally-configured Stack ID, used when no --stack override is provided. */
+    localStackId?: string;
+    /** Located local config, used to unset stackId after a successful destroy. */
+    blueprintConfig?: LocatedBlueprintsConfig | null;
     flags: {
         force?: boolean;
         'project-id'?: string;

package/dist/cores/blueprints/destroy.js

@@ -1,27 +1,18 @@
 import { setTimeout as sleep } from 'node:timers/promises';
 import { confirm } from '@inquirer/prompts';
-import { patchConfigFile } from '../../actions/blueprints/config.js';
+import { patchLocatedConfig } from '../../actions/blueprints/config.js';
 import { destroyStack, getStack, resolveStackIdByNameOrId } from '../../actions/blueprints/stacks.js';
 import { waitForOperation } from '../../actions/blueprints/wait-for-operation.js';
 import { niceId } from '../../utils/display/presenters.js';
 import { CODE_OPERATION_UNCONFIRMED, EXIT_OPERATION_UNCONFIRMED } from '../../utils/exit-codes.js';
 import { styleText } from '../../utils/style-text.js';
 export async function blueprintDestroyCore(options) {
-    const { bin = 'sanity', log, token, blueprint, flags } = options;
+    const { bin = 'sanity', log, token, scopeType, scopeId, localStackId, blueprintConfig, flags, } = options;
     const { force = false, 'project-id': flagProjectId, 'organization-id': flagOrganizationId, stack: flagStack, 'no-wait': noWait = false, verbose = false, } = flags;
-    // 3-flag combo: destroy without needing a local blueprint config
+    // 3-flag combo: non-interactive destroy that does not need a local Blueprint nearby.
+    // Scope comes from the --project-id/--organization-id flags (resolved by the base command).
     if ((flagProjectId || flagOrganizationId) && flagStack && force) {
-        let scopeType;
-        let scopeId;
-        if (flagOrganizationId) {
-            scopeType = 'organization';
-            scopeId = flagOrganizationId;
-        }
-        else if (flagProjectId) {
-            scopeType = 'project';
-            scopeId = flagProjectId;
-        }
-        else {
+        if (!scopeType || !scopeId) {
             return { success: false, error: 'Unable to determine scope for Blueprint Destroy' };
         }
         const auth = { token, scopeType, scopeId };
@@ -33,7 +24,7 @@ export async function blueprintDestroyCore(options) {
         });
         if (!ok)
             return { success: false, error: error || 'Failed to destroy Stack deployment' };
-        clearLocalStackIdFromConfig(blueprint, stack.id, log);
+        clearLocalStackIdFromConfig(blueprintConfig, stack.id, log);
         if (noWait) {
             log(styleText(['bold', 'magenta'], 'Stack destruction started!'));
             return { success: true, json: { stackId: stack.id, stackName: stack.name } };
@@ -48,7 +39,6 @@ export async function blueprintDestroyCore(options) {
             verbose,
         });
     }
-    const { scopeType, scopeId, stackId } = blueprint;
     if (!scopeType || !scopeId)
         return { success: false, error: 'Scope is required' };
     const auth = { token, scopeType, scopeId };
@@ -63,8 +53,8 @@ export async function blueprintDestroyCore(options) {
                 return { success: false, error: overrideStack.error || 'Failed to get Stack' };
             stack = overrideStack.stack;
         }
-        else if (stackId) {
-            const blueprintStack = await getStack({ stackId, auth, logger: log });
+        else if (localStackId) {
+            const blueprintStack = await getStack({ stackId: localStackId, auth, logger: log });
             if (!blueprintStack.ok)
                 return { success: false, error: blueprintStack.error || 'Failed to get Stack' };
             stack = blueprintStack.stack;
@@ -115,7 +105,7 @@ export async function blueprintDestroyCore(options) {
             return { success: false, error: error || 'Failed to destroy Stack deployment' };
         }
         destroySpinner.stop().clear();
-        clearLocalStackIdFromConfig(blueprint, stack.id, log);
+        clearLocalStackIdFromConfig(blueprintConfig, stack.id, log);
         if (noWait) {
             log(styleText(['bold', 'magenta'], 'Stack destruction started!'));
             return { success: true, json: { stackId: stack.id, stackName: stack.name } };
@@ -135,13 +125,13 @@ export async function blueprintDestroyCore(options) {
         return { success: false, error: errorMessage };
     }
 }
-function clearLocalStackIdFromConfig(blueprint, destroyedStackId, log) {
-    if (!blueprint.blueprintConfig)
+function clearLocalStackIdFromConfig(blueprintConfig, destroyedStackId, log) {
+    if (!blueprintConfig)
         return;
-    if (blueprint.blueprintConfig.stackId !== destroyedStackId)
+    if (blueprintConfig.stackId !== destroyedStackId)
         return;
     try {
-        patchConfigFile(blueprint.fileInfo.blueprintFilePath, { stackId: null });
+        patchLocatedConfig(blueprintConfig, { stackId: null });
         log(styleText('dim', 'Removed stackId from .sanity/blueprint.config.json'));
     }
     catch {

package/dist/cores/blueprints/doctor.js

@@ -8,12 +8,12 @@ import { readConfigFile } from '../../actions/blueprints/config.js';
 import { resolveIds } from '../../actions/blueprints/resolve.js';
 import { getStack } from '../../actions/blueprints/stacks.js';
 import config, { RUNTIME_CLI_VERSION } from '../../config.js';
-import { getWarnings } from '../../utils/blueprints/warnings.js';
 import { formatDateTime } from '../../utils/display/dates.js';
 import { advise, check, filePathRelativeToCwd, niceId, renderSection, severe, unsure, } from '../../utils/display/presenters.js';
 import { styleText } from '../../utils/style-text.js';
 import { createTracedFetch } from '../../utils/traced-fetch.js';
 import { validTokenOrErrorMessage } from '../../utils/validated-token.js';
+import { getWarnings } from '../../utils/warnings.js';
 import { blueprintConfigCore } from './config.js';
 const diagLookup = {
     online: 'Host online',
@@ -23,7 +23,9 @@ const diagLookup = {
     userHasAccess: 'User has access',
 };
 const warnLookup = {
-    projectLayout: 'Project layout',
+    studio: 'In studio',
+    floating: 'In own dir',
+    functions: 'In functions dir',
 };
 function sourceLabel(source) {
     switch (source) {
@@ -243,16 +245,32 @@ export async function blueprintDoctorCore(options) {
     for (const key in warnLookup) {
         warningDiagnostics[key] = { status: null };
     }
-    // LAYOUT ISSUES; IE Functions in Studio
-    let layoutWarnings = [];
+    // Workspace issues; IE Functions in Studio
+    let warnings = [];
     if (localBlueprint) {
         const blueprintDir = dirname(localBlueprint.fileInfo.blueprintFilePath || '.');
-        layoutWarnings = getWarnings({ dir: blueprintDir });
-        if (layoutWarnings.length) {
-            warningDiagnostics.projectLayout = {
-                status: true,
-                detail: 'Blueprint config in the Studio dir',
-            };
+        warnings = getWarnings({ dir: blueprintDir });
+        if (warnings.length) {
+            for (const warning of warnings) {
+                if (warning.code === 'studio') {
+                    warningDiagnostics.studio = {
+                        status: true,
+                        detail: 'Blueprint config in the Studio dir',
+                    };
+                }
+                if (warning.code === 'functions') {
+                    warningDiagnostics.functions = {
+                        status: true,
+                        detail: 'Blueprints config in the Functions dir',
+                    };
+                }
+                if (warning.code === 'floating') {
+                    warningDiagnostics.floating = {
+                        status: true,
+                        detail: 'Blueprint not part of a project',
+                    };
+                }
+            }
         }
     }
     // --- RENDER REPORT ---
@@ -292,12 +310,14 @@ export async function blueprintDoctorCore(options) {
         }
     }
     let hasWarnings = false;
+    // Because TS is TS - narrow string keys to WarningCode before indexing warnLookup
+    const isWarningCode = (code) => code in warnLookup;
     if (Object.values(warningDiagnostics).some((entry) => entry.status === true)) {
         hasWarnings = true;
         const maxLabel = Math.max(...Object.values(warnLookup).map((l) => l.length));
         log(styleText('bold', 'Warnings'));
         for (const [key, entry] of Object.entries(warningDiagnostics)) {
-            if (entry.status) {
+            if (entry.status && isWarningCode(key)) {
                 const label = warnLookup[key].padEnd(maxLabel);
                 const detail = entry.detail ? `  ${styleText('dim', entry.detail)}` : '';
                 log(`  ${advise(label)}${detail}`);
@@ -320,7 +340,7 @@ export async function blueprintDoctorCore(options) {
             success: true,
             json: { diagnostics: flatDiagnostics },
             data: { diagnostics: flatDiagnostics },
-            warnings: hasWarnings ? layoutWarnings : undefined,
+            warnings: hasWarnings ? warnings : undefined,
         };
     }
     if (fix) {
@@ -364,7 +384,7 @@ export async function blueprintDoctorCore(options) {
             flags: { edit: true, verbose: v },
         });
         if (fixResult.success) {
-            return { ...fixResult, warnings: hasWarnings ? layoutWarnings : undefined };
+            return { ...fixResult, warnings: hasWarnings ? warnings : undefined };
         }
         return fixResult;
     }

package/dist/cores/blueprints/plan.js

@@ -1,7 +1,9 @@
+import { dirname } from 'node:path';
 import { planStack, resolveStackIdByNameOrId } from '../../actions/blueprints/stacks.js';
 import { createHintCollector } from '../../utils/blueprints/hints.js';
 import { formatDeploymentPlan, formatResourceTree, hasActionableChanges, } from '../../utils/display/blueprints-formatting.js';
 import { styleText } from '../../utils/style-text.js';
+import { getWarnings } from '../../utils/warnings.js';
 export async function blueprintPlanCore(options) {
     const { bin = 'sanity', log, blueprint, token, flags } = options;
     const { verbose: _verbose = false } = flags;
@@ -69,6 +71,7 @@ export async function blueprintPlanCore(options) {
             ],
         };
     }
+    const warnings = getWarnings({ dir: dirname(fileInfo.blueprintFilePath) });
     log('');
     log(formatDeploymentPlan(planResponse.deploymentPlan));
     if (hasActionableChanges(planResponse.deploymentPlan)) {
@@ -83,5 +86,6 @@ export async function blueprintPlanCore(options) {
             resources,
             plan: planResponse.deploymentPlan,
         },
+        warnings: warnings,
     };
 }

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

@@ -1,8 +1,13 @@
-import type { BlueprintConfig, CoreResult } from '../index.js';
-export interface BlueprintStacksOptions extends BlueprintConfig {
+import type { ScopeType } from '../../utils/types.js';
+import type { CoreConfig, CoreResult } from '../index.js';
+export interface BlueprintStacksOptions extends CoreConfig {
+    token: string;
+    /** Scope to list Stacks for, resolved by the base command (flags > env > config). */
+    scopeType: ScopeType;
+    scopeId: string;
+    /** Locally-configured Stack ID, used only to highlight the current Stack in listings. */
+    localStackId?: string;
     flags: {
-        'project-id'?: string;
-        'organization-id'?: string;
         'include-projects'?: boolean;
         verbose?: boolean;
     };

package/dist/cores/blueprints/stacks.js

@@ -6,30 +6,8 @@ import { styleText } from '../../utils/style-text.js';
 /** Max projects to query for stacks during --include-projects */
 const PROJECT_LIMIT = 50;
 export async function blueprintStacksCore(options) {
-    const { log, token, blueprint, flags } = options;
-    const { scopeType: blueprintScopeType, scopeId: blueprintScopeId, stackId: blueprintStackId, } = blueprint;
-    const { 'project-id': flagProjectId, 'organization-id': flagOrganizationId, 'include-projects': includeProjects = false, verbose: _verbose = false, } = flags;
-    if (flagOrganizationId && flagProjectId) {
-        log.error('Cannot specify both --organization-id and --project-id');
-        return { success: false, error: 'Cannot specify both --organization-id and --project-id' };
-    }
-    let scopeType = blueprintScopeType;
-    let scopeId = blueprintScopeId;
-    if (flagOrganizationId) {
-        scopeType = 'organization';
-        scopeId = flagOrganizationId;
-    }
-    if (flagProjectId) {
-        scopeType = 'project';
-        scopeId = flagProjectId;
-    }
-    if (!scopeType || !scopeId) {
-        return {
-            success: false,
-            error: 'Unable to determine scope for Blueprint Stacks',
-            suggestions: ['Run in a Blueprint directory or provide a project with --project-id.'],
-        };
-    }
+    const { log, token, scopeType, scopeId, localStackId: blueprintStackId, flags } = options;
+    const { 'include-projects': includeProjects = false } = flags;
     if (includeProjects && scopeType === 'organization') {
         return deepListStacks({ organizationId: scopeId, token, log, blueprintStackId });
     }

package/dist/cores/functions/add.js

@@ -9,6 +9,7 @@ import { EVENT_DOCUMENT_CREATE, EVENT_DOCUMENT_DELETE, EVENT_DOCUMENT_UPDATE, EV
 import { check, indent, warn } from '../../utils/display/presenters.js';
 import { validateFunctionName } from '../../utils/functions/validate-name.js';
 import { styleText } from '../../utils/style-text.js';
+import { getWarnings } from '../../utils/warnings.js';
 export const generateFunctionBlueprintResourceTemplate = (fnName, eventNames) => {
     const functionType = MAP_EVENT_TO_FUNCTION_TYPE[eventNames[0]];
     let definer = '';
@@ -40,6 +41,7 @@ export async function functionAddCore(options) {
     const root = cwd();
     const { log, blueprint, flags } = options;
     const { blueprintFilePath } = blueprint.fileInfo;
+    const warnings = getWarnings({ dir: dirname(blueprintFilePath) });
     const { example: flagExample, name: flagResourceName, type: flagType, javascript: flagJs, helpers: flagHelpers, install: flagI, installer: flagInstaller, } = flags;
     let { language: flagLang } = flags;
     flagLang = flagJs ? 'js' : flagLang;
@@ -208,7 +210,7 @@ export async function functionAddCore(options) {
         else {
             log(`Function "${styleText('bold', fnName)}" added to Blueprint file.`);
         }
-        return { success: true };
+        return { success: true, warnings };
     }
     catch (err) {
         const errorMessage = err instanceof Error ? err.message : String(err);

package/dist/cores/index.d.ts

@@ -1,7 +1,6 @@
 import { type ReadBlueprintResult } from '../actions/blueprints/blueprint.js';
-import type { Warning } from '../utils/blueprints/warnings.js';
 import type { Logger } from '../utils/logger.js';
-import type { AuthParams, Result, ScopeType, Stack } from '../utils/types.js';
+import type { AuthParams, Result, ScopeType, Stack, Warning } from '../utils/types.js';
 export interface CoreConfig {
     /** The CLI binary name. */
     bin: string;

package/dist/utils/functions/transpile/function.d.ts

@@ -10,3 +10,9 @@ export declare function transpileFunction(resource: FunctionResource, { installe
     timings: Record<string, number>;
     bundled: boolean;
 }>;
+/**
+ * Vite 8's `build()` wraps failures in a `BundleError` whose `message` contains
+ * a "Build failed with N errors" preamble and full stack traces. The individual
+ * errors on `.errors` carry the original, human-readable messages.
+ */
+export declare function formatBuildError(err: unknown): string;

package/dist/utils/functions/transpile/function.js

@@ -4,7 +4,6 @@ import { performance } from 'node:perf_hooks';
 import { cwd } from 'node:process';
 import * as find from 'empathic/find';
 import { build as viteBuild } from 'vite';
-import tsConfigPaths from 'vite-tsconfig-paths';
 import { detectNativeModulesPlugin } from '../detect-native-modules.js';
 import { findFunctionEntryPoint } from '../find-entry-point.js';
 import { cleanupSourceMaps } from './cleanup-source-maps.js';
@@ -51,7 +50,7 @@ export async function transpileFunction(resource, { installer } = {}) {
                 minify: false,
                 sourcemap: true,
                 ssr: true,
-                rollupOptions: {
+                rolldownOptions: {
                     input: entry,
                     output: {
                         format: 'esm',
@@ -66,16 +65,18 @@ export async function transpileFunction(resource, { installer } = {}) {
                     external: bundle ? [] : [/node_modules/],
                 },
             },
+            resolve: {
+                // Replaces the vite-tsconfig-paths plugin; vite 8 resolves tsconfig
+                // `compilerOptions.paths` natively
+                tsconfigPaths: true,
+            },
             ssr: {
                 noExternal: bundle ? true : [],
                 resolve: {
                     conditions: ['node'],
                 },
             },
-            plugins: [
-                ...(bundle ? [detectNativeModulesPlugin(), pnpmResolvePlugin(cwd())] : []),
-                tsConfigPaths(),
-            ],
+            plugins: bundle ? [detectNativeModulesPlugin(), pnpmResolvePlugin(cwd())] : [],
         });
         timings['transpile:build'] = performance.now() - viteStart;
         const verifyStart = performance.now();
@@ -99,11 +100,37 @@ export async function transpileFunction(resource, { installer } = {}) {
     }
     catch (err) {
         await cleanupTmpDir();
-        throw new Error(`Transpiling of function failed: ${err instanceof Error ? err.message : err}`, {
+        throw new Error(`Transpiling of function failed: ${formatBuildError(err)}`, {
             cause: err,
         });
     }
 }
+/**
+ * Vite 8's `build()` wraps failures in a `BundleError` whose `message` contains
+ * a "Build failed with N errors" preamble and full stack traces. The individual
+ * errors on `.errors` carry the original, human-readable messages.
+ */
+export function formatBuildError(err) {
+    if (!(err instanceof Error))
+        return String(err);
+    if ('errors' in err && Array.isArray(err.errors) && err.errors.length > 0) {
+        return err.errors.map(formatBuildErrorEntry).join('\n');
+    }
+    return err.message;
+}
+/**
+ * A `BundleError.errors` entry may be...
+ *   a real `Error`,
+ *   a plain object carrying a `message` (Rolldown/Oxc diagnostics),
+ *   or unknown
+ * Prefer `.message` and fall back to `String()`
+ */
+function formatBuildErrorEntry(e) {
+    if (e instanceof Error)
+        return e.message;
+    const message = e?.message;
+    return typeof message === 'string' ? message : String(e);
+}
 async function writeTranspiledPackageJson(inputDir, outputFilePath) {
     const baseName = path.basename(outputFilePath);
     let original;

package/dist/utils/types.d.ts

@@ -218,4 +218,8 @@ export type AssetPrepResult = {
     cleanup: () => Promise<void>;
     error: string;
 };
+export type Warning = {
+    code: string;
+    suggestions: string[];
+};
 export {};

package/dist/utils/warnings.d.ts

@@ -0,0 +1,14 @@
+import type { Warning } from './types.js';
+export type WarningCode = 'studio' | 'floating' | 'functions';
+export type WarningContext = {
+    dir: string;
+};
+export type WarningType = {
+    code: WarningCode;
+    suggestions: string[];
+};
+/**
+ * Generates warnings based upon the provided context by running through all rules and returning any matches
+ * @param ctx
+ */
+export declare const getWarnings: (ctx: WarningContext) => Warning[];

package/dist/utils/warnings.js

@@ -0,0 +1,45 @@
+import { checkWorkspaceStruct } from './workspace-checks.js';
+const workspaceRuleWarnings = [
+    {
+        code: 'studio',
+        suggestions: [
+            'Blueprint should not be co-located with a Sanity Studio. See docs for correct layout options:',
+            // @todo: this will need to updated once the layout is published.
+            'https://www.sanity.io/docs/blueprints/blueprints-introduction#aaeea93bdd42',
+        ],
+    },
+    {
+        code: 'floating',
+        suggestions: [
+            'Blueprint is in a separate directory from its stack. See docs for recommended layout options:',
+            // @todo: this will need to updated once the layout is published.
+            'https://www.sanity.io/docs/blueprints/blueprints-introduction#aaeea93bdd42',
+        ],
+    },
+    {
+        code: 'functions',
+        suggestions: [
+            'Blueprint is co-located with the functions directory. See docs for correct layout options:',
+            // @todo: this will need to updated once the layout is published.
+            'https://www.sanity.io/docs/blueprints/blueprints-introduction#aaeea93bdd42',
+        ],
+    },
+];
+const workspaceRulesWarnings = (ctx) => {
+    const code = checkWorkspaceStruct(ctx.dir);
+    const warnings = workspaceRuleWarnings.find((w) => w.code === code);
+    return warnings ? [warnings] : [];
+};
+/**
+ * Additive way of generating warnings based upon context
+ * At the moment, we have a single workspace warning check,
+ * more could be added via [workspaceRulesWarnings, otherWarningChecks, ...]
+ */
+const rules = [workspaceRulesWarnings];
+/**
+ * Generates warnings based upon the provided context by running through all rules and returning any matches
+ * @param ctx
+ */
+export const getWarnings = (ctx) => {
+    return rules.flatMap((rule) => rule(ctx));
+};

package/dist/utils/workspace-checks.d.ts

@@ -0,0 +1,9 @@
+import type { WarningCode } from './warnings.js';
+/**
+ * Shared utility called by functions or blueprints to deterministically show warnings to users if it's not ideal
+ * 1. Checks to see if the given filepath is in a studio specific workspace
+ * 2. Checks to see if the given filepath is under a functions directory (/functions/sanity.blueprint.ts)
+ * 3. Checks to see if the given filepath is in a self-contained directory (/blueprints/my-blueprint/sanity.blueprint.ts)
+ * @param filePath
+ */
+export declare const checkWorkspaceStruct: (filePath: string) => WarningCode | undefined;

package/dist/utils/workspace-checks.js

@@ -0,0 +1,47 @@
+import { existsSync, readdirSync } from 'node:fs';
+import { dirname, join, relative, resolve, sep } from 'node:path';
+/**
+ * Shared utility called by functions or blueprints to deterministically show warnings to users if it's not ideal
+ * 1. Checks to see if the given filepath is in a studio specific workspace
+ * 2. Checks to see if the given filepath is under a functions directory (/functions/sanity.blueprint.ts)
+ * 3. Checks to see if the given filepath is in a self-contained directory (/blueprints/my-blueprint/sanity.blueprint.ts)
+ * @param filePath
+ */
+export const checkWorkspaceStruct = (filePath) => {
+    const startDir = resolve(filePath);
+    let currentDir = startDir;
+    let packageRoot = null;
+    let underFunctionsDir = false;
+    let isInStudio = false;
+    while (true) {
+        if (existsSync(join(currentDir, 'package.json'))) {
+            packageRoot = currentDir;
+            break;
+        }
+        const parent = dirname(currentDir);
+        if (parent === currentDir)
+            break;
+        currentDir = parent;
+    }
+    try {
+        isInStudio = readdirSync(startDir, { withFileTypes: true }).some((entry) => entry.isFile() &&
+            (entry.name.startsWith('sanity.config') || entry.name.startsWith('sanity.cli')));
+    }
+    catch (_e) {
+        // readdirSync lookup failed for some reason
+        isInStudio = false;
+    }
+    if (packageRoot !== null) {
+        const rel = packageRoot ? relative(packageRoot, startDir) : '';
+        underFunctionsDir = rel.split(sep).includes('functions');
+    }
+    const isPackageRoot = packageRoot === startDir && !underFunctionsDir;
+    const isFloating = !isInStudio && !isPackageRoot && !underFunctionsDir;
+    return isInStudio
+        ? 'studio'
+        : underFunctionsDir
+            ? 'functions'
+            : isFloating
+                ? 'floating'
+                : undefined;
+};

package/oclif.manifest.json

@@ -643,8 +643,7 @@
       "summary": "Destroy a remote Stack deployment and its resources",
       "enableJsonFlag": true,
       "needs": [
-        "token",
-        "blueprint"
+        "scope"
       ],
       "isESM": true,
       "relativePath": [
@@ -1648,8 +1647,7 @@
       "summary": "List remote Stack deployments for your project or organization",
       "enableJsonFlag": true,
       "needs": [
-        "token",
-        "blueprint"
+        "scope"
       ],
       "isESM": true,
       "relativePath": [
@@ -2998,5 +2996,5 @@
       ]
     }
   },
-  "version": "15.2.1"
+  "version": "16.0.1"
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@sanity/runtime-cli",
   "description": "Sanity's Runtime CLI for Blueprints and Functions",
-  "version": "15.2.1",
+  "version": "16.0.1",
   "author": "Sanity Runtime Team",
   "type": "module",
   "license": "MIT",
@@ -50,6 +50,7 @@
     "test:depmgmt": "vitest run --config ./test-depmgmt/vitest.config.ts",
     "test:coverage": "vitest run --coverage --coverage.include \"runtime-cli/src/**/*\"",
     "test:scenarios": "vitest run test/scenarios",
+    "test:bp-version-smoke": "node ./test/blueprints-version-smoke.js",
     "test:unit": "vitest run --exclude \"test/scenarios/**/*\"",
     "test:vitest": "vitest run",
     "typecheck": "tsc --project tsconfig.typecheck.json",
@@ -75,8 +76,7 @@
     "mime-types": "^3.0.2",
     "ora": "^9.4.0",
     "tar-stream": "^3.2.0",
-    "vite": "^7.3.3",
-    "vite-tsconfig-paths": "^6.1.1",
+    "vite": "^8.0.16",
     "ws": "^8.20.0",
     "xdg-basedir": "^5.1.0"
   },

package/dist/utils/blueprints/warnings.d.ts

@@ -1,19 +0,0 @@
-export type Warning = {
-    label: string;
-    suggestions: string[];
-};
-export type WarningContext = {
-    dir: string;
-};
-export type WarningEntryCheck = {
-    label: string;
-    suggestions: string[];
-    check: (ctx: WarningContext) => boolean;
-};
-/**
- * Checks if the given directory contains files Sanity Studio specific files.
- * Directory is either the cwd where `init` is run or during the `doctor` command
- */
-export declare const isStudioDir: (filePath: string) => boolean;
-export declare const warningCheck: WarningEntryCheck[];
-export declare const getWarnings: (ctx: WarningContext) => Warning[];

package/dist/utils/blueprints/warnings.js

@@ -1,36 +0,0 @@
-import { readdirSync } from 'node:fs';
-import { resolve } from 'node:path';
-/**
- * Checks if the given directory contains files Sanity Studio specific files.
- * Directory is either the cwd where `init` is run or during the `doctor` command
- */
-export const isStudioDir = (filePath) => {
-    try {
-        const dir = resolve(filePath);
-        return readdirSync(dir, { withFileTypes: true }).some((entry) => {
-            if (entry.isFile()) {
-                return entry.name.startsWith('sanity.config') || entry.name.startsWith('sanity.cli');
-            }
-            return false;
-        });
-    }
-    catch (_err) {
-        return false;
-    }
-};
-export const warningCheck = [
-    {
-        label: 'Project layout',
-        suggestions: [
-            'A Blueprints file is co-located with a Sanity Studio. Please see the docs for better layout options',
-            // @todo: this will need to updated once the layout is published.
-            'https://www.sanity.io/docs/blueprints/blueprints-introduction#aaeea93bdd42',
-        ],
-        check: ({ dir }) => isStudioDir(dir),
-    },
-];
-export const getWarnings = (ctx) => {
-    return warningCheck
-        .filter(({ check }) => check(ctx))
-        .map(({ label, suggestions }) => ({ label, suggestions }));
-};