@sanity/runtime-cli 12.0.0 → 12.1.0

package/README.md

@@ -20,7 +20,7 @@ $ npm install -g @sanity/runtime-cli
 $ sanity-run COMMAND
 running command...
 $ sanity-run (--version)
-@sanity/runtime-cli/12.0.0 linux-x64 node-v24.11.1
+@sanity/runtime-cli/12.1.0 linux-x64 node-v24.11.1
 $ sanity-run --help [COMMAND]
 USAGE
   $ sanity-run COMMAND
@@ -92,7 +92,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/v12.0.0/src/commands/blueprints/add.ts)_
+_See code: [src/commands/blueprints/add.ts](https://github.com/sanity-io/runtime-cli/blob/v12.1.0/src/commands/blueprints/add.ts)_
 
 ## `sanity-run blueprints config`
 
@@ -121,7 +121,7 @@ EXAMPLES
   $ sanity-run blueprints config --edit --project-id <projectId> --stack-id <stackId>
 ```
 
-_See code: [src/commands/blueprints/config.ts](https://github.com/sanity-io/runtime-cli/blob/v12.0.0/src/commands/blueprints/config.ts)_
+_See code: [src/commands/blueprints/config.ts](https://github.com/sanity-io/runtime-cli/blob/v12.1.0/src/commands/blueprints/config.ts)_
 
 ## `sanity-run blueprints deploy`
 
@@ -143,7 +143,7 @@ EXAMPLES
   $ sanity-run blueprints deploy --no-wait
 ```
 
-_See code: [src/commands/blueprints/deploy.ts](https://github.com/sanity-io/runtime-cli/blob/v12.0.0/src/commands/blueprints/deploy.ts)_
+_See code: [src/commands/blueprints/deploy.ts](https://github.com/sanity-io/runtime-cli/blob/v12.1.0/src/commands/blueprints/deploy.ts)_
 
 ## `sanity-run blueprints destroy`
 
@@ -170,7 +170,7 @@ EXAMPLES
   $ sanity-run blueprints destroy --stack-id <stackId> --project-id <projectId> --force --no-wait
 ```
 
-_See code: [src/commands/blueprints/destroy.ts](https://github.com/sanity-io/runtime-cli/blob/v12.0.0/src/commands/blueprints/destroy.ts)_
+_See code: [src/commands/blueprints/destroy.ts](https://github.com/sanity-io/runtime-cli/blob/v12.1.0/src/commands/blueprints/destroy.ts)_
 
 ## `sanity-run blueprints doctor`
 
@@ -188,7 +188,7 @@ DESCRIPTION
   Diagnose potential issues with Blueprint configuration
 ```
 
-_See code: [src/commands/blueprints/doctor.ts](https://github.com/sanity-io/runtime-cli/blob/v12.0.0/src/commands/blueprints/doctor.ts)_
+_See code: [src/commands/blueprints/doctor.ts](https://github.com/sanity-io/runtime-cli/blob/v12.1.0/src/commands/blueprints/doctor.ts)_
 
 ## `sanity-run blueprints info`
 
@@ -207,14 +207,14 @@ DESCRIPTION
 EXAMPLES
   $ sanity-run blueprints info
 
-  $ sanity-run blueprints info --stack-id <stackId>
+  $ sanity-run blueprints info --id <stackId>
 ```
 
-_See code: [src/commands/blueprints/info.ts](https://github.com/sanity-io/runtime-cli/blob/v12.0.0/src/commands/blueprints/info.ts)_
+_See code: [src/commands/blueprints/info.ts](https://github.com/sanity-io/runtime-cli/blob/v12.1.0/src/commands/blueprints/info.ts)_
 
 ## `sanity-run blueprints init [DIR]`
 
-Initialize a new Blueprint
+Initialize a new Blueprint Stack deployment
 
 ```
 USAGE
@@ -236,7 +236,7 @@ FLAGS
   --verbose                  Verbose output
 
 DESCRIPTION
-  Initialize a new Blueprint
+  Initialize a new Blueprint Stack deployment
 
 EXAMPLES
   $ sanity-run blueprints init
@@ -250,7 +250,7 @@ EXAMPLES
   $ sanity-run blueprints init --blueprint-type <json|js|ts> --stack-name <stackName>
 ```
 
-_See code: [src/commands/blueprints/init.ts](https://github.com/sanity-io/runtime-cli/blob/v12.0.0/src/commands/blueprints/init.ts)_
+_See code: [src/commands/blueprints/init.ts](https://github.com/sanity-io/runtime-cli/blob/v12.1.0/src/commands/blueprints/init.ts)_
 
 ## `sanity-run blueprints logs`
 
@@ -272,7 +272,7 @@ EXAMPLES
   $ sanity-run blueprints logs --watch
 ```
 
-_See code: [src/commands/blueprints/logs.ts](https://github.com/sanity-io/runtime-cli/blob/v12.0.0/src/commands/blueprints/logs.ts)_
+_See code: [src/commands/blueprints/logs.ts](https://github.com/sanity-io/runtime-cli/blob/v12.1.0/src/commands/blueprints/logs.ts)_
 
 ## `sanity-run blueprints plan`
 
@@ -289,11 +289,11 @@ EXAMPLES
   $ sanity-run blueprints plan
 ```
 
-_See code: [src/commands/blueprints/plan.ts](https://github.com/sanity-io/runtime-cli/blob/v12.0.0/src/commands/blueprints/plan.ts)_
+_See code: [src/commands/blueprints/plan.ts](https://github.com/sanity-io/runtime-cli/blob/v12.1.0/src/commands/blueprints/plan.ts)_
 
 ## `sanity-run blueprints stacks`
 
-List all Blueprint stacks
+List all Blueprint Stacks
 
 ```
 USAGE
@@ -304,7 +304,7 @@ FLAGS
   --project-id=<value>       Project ID to show stacks for
 
 DESCRIPTION
-  List all Blueprint stacks
+  List all Blueprint Stacks
 
 EXAMPLES
   $ sanity-run blueprints stacks
@@ -314,7 +314,7 @@ EXAMPLES
   $ sanity-run blueprints stacks --organization-id <organizationId>
 ```
 
-_See code: [src/commands/blueprints/stacks.ts](https://github.com/sanity-io/runtime-cli/blob/v12.0.0/src/commands/blueprints/stacks.ts)_
+_See code: [src/commands/blueprints/stacks.ts](https://github.com/sanity-io/runtime-cli/blob/v12.1.0/src/commands/blueprints/stacks.ts)_
 
 ## `sanity-run functions add`
 
@@ -356,7 +356,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/v12.0.0/src/commands/functions/add.ts)_
+_See code: [src/commands/functions/add.ts](https://github.com/sanity-io/runtime-cli/blob/v12.1.0/src/commands/functions/add.ts)_
 
 ## `sanity-run functions dev`
 
@@ -379,7 +379,7 @@ EXAMPLES
   $ sanity-run functions dev --host 127.0.0.1 --port 8974
 ```
 
-_See code: [src/commands/functions/dev.ts](https://github.com/sanity-io/runtime-cli/blob/v12.0.0/src/commands/functions/dev.ts)_
+_See code: [src/commands/functions/dev.ts](https://github.com/sanity-io/runtime-cli/blob/v12.1.0/src/commands/functions/dev.ts)_
 
 ## `sanity-run functions env add NAME KEY VALUE`
 
@@ -401,7 +401,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/v12.0.0/src/commands/functions/env/add.ts)_
+_See code: [src/commands/functions/env/add.ts](https://github.com/sanity-io/runtime-cli/blob/v12.1.0/src/commands/functions/env/add.ts)_
 
 ## `sanity-run functions env list NAME`
 
@@ -421,7 +421,7 @@ EXAMPLES
   $ sanity-run functions env list MyFunction
 ```
 
-_See code: [src/commands/functions/env/list.ts](https://github.com/sanity-io/runtime-cli/blob/v12.0.0/src/commands/functions/env/list.ts)_
+_See code: [src/commands/functions/env/list.ts](https://github.com/sanity-io/runtime-cli/blob/v12.1.0/src/commands/functions/env/list.ts)_
 
 ## `sanity-run functions env remove NAME KEY`
 
@@ -442,7 +442,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/v12.0.0/src/commands/functions/env/remove.ts)_
+_See code: [src/commands/functions/env/remove.ts](https://github.com/sanity-io/runtime-cli/blob/v12.1.0/src/commands/functions/env/remove.ts)_
 
 ## `sanity-run functions logs NAME`
 
@@ -476,7 +476,7 @@ EXAMPLES
   $ sanity-run functions logs <name> --delete
 ```
 
-_See code: [src/commands/functions/logs.ts](https://github.com/sanity-io/runtime-cli/blob/v12.0.0/src/commands/functions/logs.ts)_
+_See code: [src/commands/functions/logs.ts](https://github.com/sanity-io/runtime-cli/blob/v12.1.0/src/commands/functions/logs.ts)_
 
 ## `sanity-run functions test NAME`
 
@@ -525,7 +525,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/v12.0.0/src/commands/functions/test.ts)_
+_See code: [src/commands/functions/test.ts](https://github.com/sanity-io/runtime-cli/blob/v12.1.0/src/commands/functions/test.ts)_
 
 ## `sanity-run help [COMMAND]`
 

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

@@ -1,7 +1,7 @@
 import { type Blueprint } from '@sanity/blueprints-parser';
 import type { BlueprintParserError, Resource } from '../../utils/types.js';
 import { type ScopeType } from '../../utils/types.js';
-import { type BlueprintsConfig } from './config.js';
+import { type LocatedBlueprintsConfig } from './config.js';
 declare const SUPPORTED_FILE_EXTENSIONS: readonly [".json", ".js", ".mjs", ".ts"];
 type BlueprintFileExtension = (typeof SUPPORTED_FILE_EXTENSIONS)[number];
 export declare const JSON_BLUEPRINT_CONTENT: {
@@ -29,7 +29,7 @@ export declare function findBlueprintFile(blueprintPath?: string): FileInfo | nu
 /** Result of the blueprint read operation */
 export interface ReadBlueprintResult {
     fileInfo: FileInfo;
-    blueprintConfig: BlueprintsConfig | null;
+    blueprintConfig: LocatedBlueprintsConfig | null;
     rawBlueprint: Record<string, unknown>;
     parsedBlueprint: Blueprint;
     errors: BlueprintParserError[];

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

@@ -5,12 +5,14 @@ export interface ConfigUpdate {
     stackId?: string;
 }
 export interface BlueprintsConfig extends ConfigUpdate {
-    configPath: string;
     blueprintConfigVersion?: typeof BLUEPRINT_CONFIG_VERSION;
     runtimeCliVersion?: typeof RUNTIME_CLI_VERSION;
     updatedAt?: number;
 }
-export declare function readConfigFile(blueprintFilePath?: string): BlueprintsConfig | null;
+export interface LocatedBlueprintsConfig extends BlueprintsConfig {
+    configPath: string;
+}
+export declare function readConfigFile(blueprintFilePath?: string): LocatedBlueprintsConfig | null;
 /**
  * Create or update the config file to disk.
  * One of organizationId or projectId must be provided. Not both.
@@ -21,8 +23,7 @@ export declare function readConfigFile(blueprintFilePath?: string): BlueprintsCo
  * @param options.projectId - the project ID
  * @param options.stackId - the stack ID
  */
-export declare function writeConfigFile(options: {
-    blueprintFilePath?: string;
+export declare function writeConfigFile(blueprintFilePath: string, options: {
     stackId?: string;
 } & ({
     organizationId: string;
@@ -30,7 +31,7 @@ export declare function writeConfigFile(options: {
 } | {
     projectId: string;
     organizationId?: string;
-})): void;
+})): BlueprintsConfig;
 /**
  * Update the config file with the given properties.
  * Config file must already exist.
@@ -41,7 +42,7 @@ export declare function writeConfigFile(options: {
  * @param updateableProperties.projectId - the project ID
  * @param updateableProperties.stackId - the stack ID
  */
-export declare function patchConfigFile(blueprintFilePath: string, updateableProperties: ConfigUpdate): void;
+export declare function patchConfigFile(blueprintFilePath: string, updateableProperties: ConfigUpdate): 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

@@ -28,8 +28,8 @@ export function readConfigFile(blueprintFilePath) {
  * @param options.projectId - the project ID
  * @param options.stackId - the stack ID
  */
-export function writeConfigFile(options) {
-    const { blueprintFilePath, organizationId, projectId, stackId } = options;
+export function writeConfigFile(blueprintFilePath, options) {
+    const { organizationId, projectId, stackId } = options;
     const blueprintDir = blueprintFilePath ? dirname(blueprintFilePath) : cwd();
     const configDir = join(blueprintDir, BLUEPRINT_CONFIG_DIR);
     const configPath = join(configDir, BLUEPRINT_CONFIG_FILE);
@@ -49,6 +49,7 @@ export function writeConfigFile(options) {
     config.runtimeCliVersion = RUNTIME_CLI_VERSION;
     config.updatedAt = Date.now();
     writeFileSync(configPath, JSON.stringify(config, null, 2));
+    return config;
 }
 /**
  * Update the config file with the given properties.
@@ -66,13 +67,14 @@ export function patchConfigFile(blueprintFilePath, updateableProperties) {
         throw new Error('No config file found');
     const { configPath, ...existingConfigProperties } = existingConfig;
     const newConfig = {
-        blueprintConfigVersion: BLUEPRINT_CONFIG_VERSION, // don't overwrite the version
+        blueprintConfigVersion: BLUEPRINT_CONFIG_VERSION, // patch doesn't overwrite versions
+        runtimeCliVersion: RUNTIME_CLI_VERSION,
         ...existingConfigProperties,
         ...updateableProperties,
         updatedAt: Date.now(),
-        runtimeCliVersion: RUNTIME_CLI_VERSION,
     };
     writeFileSync(configPath, JSON.stringify(newConfig, null, 2));
+    return newConfig;
 }
 /**
  * Find and write an organizationId to the config file by getting it from the projectId
@@ -97,7 +99,7 @@ export async function backfillOrganizationId({ blueprintFilePath, projectId, })
     }
     if (!organizationId)
         throw new Error('No organizationId found');
-    writeConfigFile({ blueprintFilePath, organizationId });
+    patchConfigFile(blueprintFilePath, { organizationId });
     return organizationId;
 }
 export async function backfillProjectBasedStackId({ blueprintFilePath, projectId, }) {
@@ -117,7 +119,7 @@ export async function backfillProjectBasedStackId({ blueprintFilePath, projectId
         stacks[0].scopeType === 'project' &&
         stacks[0].id === possibleStackId) {
         // jackpot
-        writeConfigFile({ blueprintFilePath, projectId, stackId: possibleStackId });
+        patchConfigFile(blueprintFilePath, { projectId, stackId: possibleStackId });
         return possibleStackId;
     }
     return undefined;

package/dist/commands/blueprints/destroy.js

@@ -17,11 +17,13 @@ export default class DestroyCommand extends BlueprintCommand {
             description: 'Project associated with the Stack',
             aliases: ['projectId', 'project'],
             dependsOn: ['stack-id', 'force'],
+            exclusive: ['organization-id'],
         }),
         'organization-id': Flags.string({
             description: 'Organization associated with the Stack',
             aliases: ['organizationId', 'organization', 'org'],
             dependsOn: ['stack-id', 'force'],
+            exclusive: ['project-id'],
         }),
         'stack-id': Flags.string({
             description: 'Stack ID to destroy (defaults to current Stack)',

package/dist/commands/blueprints/info.js

@@ -5,7 +5,7 @@ export default class InfoCommand extends DeployedBlueprintCommand {
     static description = 'Show information about a Blueprint Stack deployment';
     static examples = [
         '<%= config.bin %> <%= command.id %>',
-        '<%= config.bin %> <%= command.id %> --stack-id <stackId>',
+        '<%= config.bin %> <%= command.id %> --id <stackId>',
     ];
     static flags = {
         id: Flags.string({

package/dist/commands/blueprints/init.js

@@ -2,7 +2,7 @@ import { Args, Command, Flags } from '@oclif/core';
 import { blueprintInitCore } from '../../cores/blueprints/init.js';
 import { validTokenOrErrorMessage } from '../../utils/validated-token.js';
 export default class InitCommand extends Command {
-    static description = 'Initialize a new Blueprint';
+    static description = 'Initialize a new Blueprint Stack deployment';
     static examples = [
         '<%= config.bin %> <%= command.id %>',
         '<%= config.bin %> <%= command.id %> [directory]',

package/dist/commands/blueprints/stacks.js

@@ -2,7 +2,7 @@ import { Flags } from '@oclif/core';
 import { BlueprintCommand } from '../../baseCommands.js';
 import { blueprintStacksCore } from '../../cores/blueprints/stacks.js';
 export default class StacksCommand extends BlueprintCommand {
-    static description = 'List all Blueprint stacks';
+    static description = 'List all Blueprint Stacks';
     static examples = [
         '<%= config.bin %> <%= command.id %>',
         '<%= config.bin %> <%= command.id %> --project-id <projectId>',

package/dist/config.js

@@ -1,13 +1,23 @@
 import { readFileSync } from 'node:fs';
-import { dirname, join } from 'node:path';
 import { env } from 'node:process';
+import { fileURLToPath } from 'node:url';
+import { findUpSync } from 'find-up';
 import getToken from './utils/get-token.js';
 export const BLUEPRINT_CONFIG_VERSION = 'v2025-05-08';
 export const BLUEPRINT_CONFIG_DIR = '.sanity';
 export const BLUEPRINT_CONFIG_FILE = 'blueprint.config.json';
 export let RUNTIME_CLI_VERSION;
 try {
-    RUNTIME_CLI_VERSION = JSON.parse(readFileSync(join(dirname(import.meta.url), '..', 'package.json'), 'utf8')).version;
+    const packageJsonPath = findUpSync('package.json', {
+        cwd: fileURLToPath(new URL('.', import.meta.url)),
+        type: 'file',
+    });
+    if (packageJsonPath) {
+        const packageJson = JSON.parse(readFileSync(packageJsonPath, 'utf8'));
+        if (packageJson.name === '@sanity/runtime-cli') {
+            RUNTIME_CLI_VERSION = packageJson.version;
+        }
+    }
 }
 catch { }
 const nodeEnv = env.NODE_ENV?.toLowerCase() ?? 'production';

package/dist/cores/blueprints/config.js

@@ -1,15 +1,13 @@
-import { highlight } from 'cardinal';
 import chalk from 'chalk';
 import { patchConfigFile, writeConfigFile, } from '../../actions/blueprints/config.js';
-import { BLUEPRINT_CONFIG_DIR, BLUEPRINT_CONFIG_FILE } from '../../config.js';
-import { capitalize, filePathRelativeToCwd, niceId, warn } from '../../utils/display/presenters.js';
+import { filePathRelativeToCwd, labeledId, warn } from '../../utils/display/presenters.js';
 import { promptForProject, promptForStack } from '../../utils/display/prompt.js';
 export async function blueprintConfigCore(options) {
     const { bin = 'sanity', blueprint, log, token, flags } = options;
     const { edit: editConfig = false, 'project-id': flagProjectId, 'organization-id': flagOrganizationId, 'stack-id': flagStackId, verbose: v = false, } = flags;
+    const providedConfigFlag = [flagProjectId, flagStackId, flagOrganizationId].some(Boolean);
     const { stackId: configStackId, scopeType: configScopeType, scopeId: configScopeId, blueprintConfig, fileInfo, } = blueprint;
     const blueprintFilePath = fileInfo.blueprintFilePath;
-    const configPath = blueprintConfig?.configPath;
     if (!configStackId && !configScopeType && !configScopeId) {
         log(warn('Incomplete configuration.'));
         if (!editConfig) {
@@ -18,19 +16,10 @@ export async function blueprintConfigCore(options) {
             return { success: true }; // not necessarily fatal
         }
     }
-    log(chalk.bold('Current Blueprint configuration:'));
-    if (configPath) {
-        if (v)
-            log(`        File: ${filePathRelativeToCwd(configPath)}`);
-    }
-    log(`  Deployment: ${chalk.blue('Stack')} ${niceId(configStackId || 'unknown')}`);
-    log(`   Scoped to: ${chalk.blue(capitalize(configScopeType || 'unknown'))} ${niceId(configScopeId || 'unknown')}`);
-    if (blueprintConfig?.updatedAt) {
-        if (v)
-            log(`     Updated: ${new Date(blueprintConfig.updatedAt).toLocaleString()}`);
-    }
+    if (blueprintConfig)
+        printConfig({ configLabel: 'Current', log, config: blueprintConfig, v });
     // passing new config without --edit flag is not allowed
-    if ((flagProjectId || flagOrganizationId || flagStackId) && !editConfig) {
+    if (providedConfigFlag && !editConfig) {
         log('To update the configuration, use the --edit flag.');
         return { success: true };
     }
@@ -39,10 +28,9 @@ export async function blueprintConfigCore(options) {
         return { success: true };
     }
     else {
-        // if a config property flag was passed, set the value and return success
-        // do not try to validate correctness of combined flags; this should not be interactive
-        const providedConfigFlag = [flagProjectId, flagStackId, flagOrganizationId].some(Boolean);
         if (providedConfigFlag) {
+            // if a config property flag was passed, set the value and return success
+            // do not try to validate correctness of combined flags; this should not be interactive
             const configUpdate = {};
             if (flagProjectId)
                 configUpdate.projectId = flagProjectId;
@@ -51,19 +39,16 @@ export async function blueprintConfigCore(options) {
             if (flagOrganizationId)
                 configUpdate.organizationId = flagOrganizationId;
             try {
-                patchConfigFile(blueprintFilePath, configUpdate);
+                const newConfig = patchConfigFile(blueprintFilePath, configUpdate);
+                printConfig({ configLabel: 'Updated', log, config: newConfig, v });
+                return { success: true };
             }
             catch {
                 return { success: false, error: 'Unable to update configuration.' };
             }
-            log('\nConfiguration updated.');
-            return { success: true };
-        }
-        // organization-based Blueprints are not yet supported for interactive editing
-        if (configScopeType === 'organization') {
-            return { success: false, error: 'Only project-based Blueprints are supported.' };
         }
-        // otherwise, prompt for values interactively
+        // prompt for values interactively
+        // do not yet offer organization as scope option
         let updatedProjectId = flagProjectId;
         if (!updatedProjectId) {
             const pickedProject = await promptForProject({
@@ -83,21 +68,33 @@ export async function blueprintConfigCore(options) {
             return { success: false, error: 'Stack is required.' };
         try {
             // update or create config JSON
-            writeConfigFile({ blueprintFilePath, projectId: updatedProjectId, stackId: updatedStackId });
-            log(`\n${chalk.bold('New configuration:')}`);
-            log(`  Deployment: ${chalk.blue('Stack')} ${niceId(updatedStackId)}`);
-            log(`   Scoped to: ${chalk.blue('Project')} ${niceId(updatedProjectId)}`);
-            log('');
-            log('Configuration updated.');
+            const newConfig = await writeConfigFile(blueprintFilePath, {
+                projectId: updatedProjectId,
+                stackId: updatedStackId,
+            });
+            printConfig({ configLabel: 'Updated', log, config: newConfig, v });
             return { success: true };
         }
         catch {
-            log(`Unable to update config. These values should be set in ${BLUEPRINT_CONFIG_DIR}/${BLUEPRINT_CONFIG_FILE}`);
-            log(highlight(JSON.stringify({ metadata: { projectId: updatedProjectId, stackId: updatedStackId } }, null, 2)));
-            return {
-                success: false,
-                error: `Be sure to update your ${BLUEPRINT_CONFIG_DIR}/${BLUEPRINT_CONFIG_FILE}`,
-            };
+            return { success: false, error: 'Unable to update configuration!' };
         }
     }
 }
+function printConfig(options) {
+    const { configLabel, log, config, v = false } = options;
+    const { projectId, organizationId, stackId, updatedAt } = config;
+    const scopeType = projectId ? 'project' : 'organization';
+    const scopeId = projectId ? projectId : organizationId;
+    if (v)
+        log(JSON.stringify(config));
+    log(`${chalk.bold(`${configLabel} configuration:`)}`);
+    log(`  Deployment: ${labeledId('stack', stackId)}`);
+    log(`   Scoped to: ${labeledId(scopeType, scopeId)}`);
+    if (updatedAt)
+        log(`     Updated: ${new Date(updatedAt).toLocaleString()}`);
+    if ('configPath' in config) {
+        const { configPath } = config;
+        if (configPath)
+            log(`        File: ${filePathRelativeToCwd(configPath)}`);
+    }
+}

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

@@ -33,11 +33,13 @@ export declare function resolveScopeAndStack(params: {
     organizationId: string | undefined;
     stackId: string | undefined;
     stackName: string | undefined;
+    log: (message: string) => void;
     token: string;
 }): Promise<ResolvedScope>;
 export declare function determineBlueprintExtension(params: {
     requestedType: string | undefined;
     blueprintDir: string;
+    log: (message: string) => void;
 }): Promise<string>;
 export declare function createBlueprintFiles(params: {
     blueprintDir: string;

package/dist/cores/blueprints/init.js

@@ -9,7 +9,7 @@ import { writeGitignoreFile } from '../../actions/git.js';
 import { writeOrUpdateNodeDependency } from '../../actions/node.js';
 import { verifyExampleExists, writeExample } from '../../actions/sanity/examples.js';
 import { BLUEPRINT_CONFIG_DIR, BLUEPRINT_CONFIG_FILE } from '../../config.js';
-import { check, filePathRelativeToCwd, warn } from '../../utils/display/presenters.js';
+import { check, filePathRelativeToCwd, labeledId, warn } from '../../utils/display/presenters.js';
 import { promptForBlueprintType, promptForProject, promptForStack, } from '../../utils/display/prompt.js';
 import { blueprintConfigCore } from './config.js';
 const SCOPE_PROJECT = 'project';
@@ -20,6 +20,7 @@ export async function blueprintInitCore(options) {
     const { dir: argDir } = args;
     const userProvidedDirName = argDir || flagDir;
     const blueprintDir = userProvidedDirName || '.';
+    const flagProvidedConfig = [flagProjectId, flagOrganizationId, flagStackId].some(Boolean);
     const validationError = validateFlags({
         stackId: flagStackId,
         stackName: flagStackName,
@@ -29,15 +30,30 @@ export async function blueprintInitCore(options) {
     if (validationError)
         return validationError;
     try {
+        // look for existing blueprint file and maybe re-configure it
         const existingBlueprintFile = findBlueprintFile(blueprintDir);
         if (existingBlueprintFile) {
             log(warn(`Existing Blueprint found: ${filePathRelativeToCwd(existingBlueprintFile.blueprintFilePath)}`));
-            const overwrite = await confirm({
-                message: 'Would you like to re-configure deployment for this Blueprint?',
-                default: true,
-            });
-            if (!overwrite)
-                return { success: false, error: 'Initialization cancelled.' };
+            if (flagExample) {
+                return {
+                    success: false,
+                    error: 'Flag --example cannot be used with an existing Blueprint.',
+                };
+            }
+            if (flagStackName) {
+                return {
+                    success: false,
+                    error: 'Flag --stack-name cannot be used with an existing Blueprint.',
+                };
+            }
+            if (!flagProvidedConfig) {
+                const overwrite = await confirm({
+                    message: 'Would you like to re-configure deployment for this Blueprint?',
+                    default: true,
+                });
+                if (!overwrite)
+                    return { success: false, error: 'Initialization cancelled.' };
+            }
             const existingBlueprint = await readLocalBlueprint(existingBlueprintFile.blueprintFilePath);
             return blueprintConfigCore({
                 blueprint: existingBlueprint,
@@ -68,11 +84,13 @@ export async function blueprintInitCore(options) {
             organizationId: flagOrganizationId,
             stackId: flagStackId,
             stackName: flagStackName,
+            log,
             token,
         });
         const blueprintExtension = await determineBlueprintExtension({
             requestedType: flagBlueprintType,
             blueprintDir,
+            log,
         });
         return createBlueprintFiles({
             blueprintDir,
@@ -87,7 +105,6 @@ export async function blueprintInitCore(options) {
     }
     catch (error) {
         const errorMessage = error instanceof Error ? error.message : String(error);
-        log(`Error: ${errorMessage}`);
         return { success: false, error: errorMessage };
     }
 }
@@ -136,7 +153,7 @@ async function handleExampleInitialization(options) {
         return { success: false, error: 'Failed to find blueprint file.' };
     }
     const { blueprintFilePath } = discoveredBlueprint;
-    writeConfigFile({ blueprintFilePath, projectId: resolvedProjectId, stackId: stack.id });
+    writeConfigFile(blueprintFilePath, { projectId: resolvedProjectId, stackId: stack.id });
     log(check(`${chalk.bold('Configured:')} ${exampleDir}/${BLUEPRINT_CONFIG_DIR}/${BLUEPRINT_CONFIG_FILE}`));
     log(`\n  Run "${chalk.bold.magenta(`cd ${exampleDir} && npm i`)}" and check out the README`);
     if (instructions) {
@@ -146,7 +163,7 @@ async function handleExampleInitialization(options) {
     return { success: true };
 }
 export async function resolveScopeAndStack(params) {
-    const { projectId, organizationId, stackId, stackName, token } = params;
+    const { projectId, organizationId, stackId, stackName, log, token } = params;
     let scopeType = SCOPE_PROJECT;
     let scopeId;
     if (projectId) {
@@ -159,7 +176,9 @@ export async function resolveScopeAndStack(params) {
     }
     let resolvedStackId = stackId;
     if (!resolvedStackId && stackName && scopeType && scopeId) {
+        // sending stackName will assume you want to create a new stack
         // essentially the only way to create an org-scoped stack
+        log(`\nCreating new Stack "${stackName}" scoped to ${labeledId(scopeType, scopeId)}`);
         const stack = await createEmptyStack({
             token,
             scopeType,
@@ -169,11 +188,13 @@ export async function resolveScopeAndStack(params) {
         resolvedStackId = stack.id;
     }
     if (!scopeId) {
+        log('\nBlueprints are associated with a Sanity Project. Please select one:');
         const pickedProject = await promptForProject({ token });
         scopeType = SCOPE_PROJECT;
         scopeId = pickedProject.projectId;
     }
     if (!resolvedStackId) {
+        log('\nBlueprints are deployed to a "Stack".');
         const { stackId } = await promptForStack({ projectId: scopeId, token });
         resolvedStackId = stackId;
     }
@@ -184,11 +205,14 @@ export async function resolveScopeAndStack(params) {
     };
 }
 export async function determineBlueprintExtension(params) {
-    const { requestedType, blueprintDir } = params;
+    const { requestedType, blueprintDir, log } = params;
     let extension = requestedType;
-    if (!extension)
+    if (!extension) {
+        log('\nBlueprint files are authored locally to create resources in your Stack.');
         extension = await promptForBlueprintType();
+    }
     if (extension === 'js') {
+        // do we need to use .mjs or .js?
         const packageJsonPath = join(blueprintDir, 'package.json');
         const packageExists = existsSync(packageJsonPath);
         if (packageExists) {
@@ -209,6 +233,7 @@ export async function createBlueprintFiles(params) {
     if (!blueprintExtension) {
         return { success: false, error: 'Blueprint type is required.' };
     }
+    log(`\nCreating local Blueprint setup...`);
     const blueprintFileName = `sanity.blueprint.${blueprintExtension}`;
     const blueprintFilePath = join(blueprintDir, blueprintFileName);
     writeBlueprintToDisk({ blueprintFilePath });
@@ -217,8 +242,7 @@ export async function createBlueprintFiles(params) {
     }
     const displayPath = userProvidedDirName || '.';
     log(check(`${chalk.bold('Created Blueprint:')}   ${displayPath}/${blueprintFileName}`));
-    writeConfigFile({
-        blueprintFilePath,
+    writeConfigFile(blueprintFilePath, {
         stackId,
         ...(scopeType === SCOPE_ORGANIZATION ? { organizationId: scopeId } : { projectId: scopeId }),
     });

package/dist/utils/display/presenters.d.ts

@@ -7,3 +7,4 @@ export declare function niceId(id: string | undefined): string;
 export declare function indent(str: string, spaces?: number): string;
 export declare function capitalize(str: string): string;
 export declare function filePathRelativeToCwd(filePath: string): string;
+export declare function labeledId(label: string | undefined, id: string | undefined): string;

package/dist/utils/display/presenters.js

@@ -33,3 +33,6 @@ export function capitalize(str) {
 export function filePathRelativeToCwd(filePath) {
     return filePath.replace(cwd(), '.');
 }
+export function labeledId(label, id) {
+    return `${chalk.blue(capitalize(label || 'unknown'))} ${niceId(id || 'unknown')}`;
+}

package/dist/utils/display/prompt.js

@@ -84,24 +84,25 @@ export async function promptForStack({ projectId, token, }) {
         throw new Error(stacksErr || 'Failed to list Stacks');
     }
     const newStackValue = { id: 'new', name: 'new' };
-    const stackChoices = [];
-    stackChoices.push(new Separator(chalk.underline('Create a new Stack:')));
-    stackChoices.push({ name: chalk.bold('New Stack ✨'), value: newStackValue });
+    let pickedStackId = newStackValue;
     if (stacks.length > 0) {
+        const stackChoices = [];
+        stackChoices.push(new Separator(chalk.underline('Create a new Stack:')));
+        stackChoices.push({ name: chalk.bold('New Stack ✨'), value: newStackValue });
         stackChoices.push(new Separator(chalk.underline('Use an existing Stack:')));
         stackChoices.push(...stacks.map((s) => ({
             name: `"${s.name}" ${niceId(s.id)} ${chalk.dim(`(${s.resources.length} res)`)}`,
             value: { id: s.id, name: s.name },
         })));
+        pickedStackId = await select({
+            message: 'Select a deployment Stack:',
+            choices: stackChoices,
+            default: newStackValue,
+        });
     }
-    const pickedStackId = await select({
-        message: 'Select an existing deployment or create a new one:',
-        choices: stackChoices,
-        default: newStackValue,
-    });
     if (pickedStackId.id === 'new') {
         const stackName = await input({
-            message: 'Enter a name for your Stack:',
+            message: 'Enter a name for your new Stack:',
             validate: (input) => input.length > 0 || 'Stack name is required',
         });
         const stack = await createEmptyStack({

package/dist/utils/validated-token.js

@@ -50,7 +50,7 @@ export async function validTokenOrErrorMessage(maybeToken) {
                         ok: false,
                         error: {
                             e,
-                            message: `Authentication server error: "${e.cause}". Try again later`,
+                            message: `Server error: "${e.cause}". Try logging in again with \`npx @sanity/cli login\``,
                         },
                     };
                 default:

package/oclif.manifest.json

@@ -318,6 +318,9 @@
             "force"
           ],
           "description": "Project associated with the Stack",
+          "exclusive": [
+            "organization-id"
+          ],
           "name": "project-id",
           "hasDynamicHelp": false,
           "multiple": false,
@@ -334,6 +337,9 @@
             "force"
           ],
           "description": "Organization associated with the Stack",
+          "exclusive": [
+            "project-id"
+          ],
           "name": "organization-id",
           "hasDynamicHelp": false,
           "multiple": false,
@@ -415,7 +421,7 @@
       "description": "Show information about a Blueprint Stack deployment",
       "examples": [
         "<%= config.bin %> <%= command.id %>",
-        "<%= config.bin %> <%= command.id %> --stack-id <stackId>"
+        "<%= config.bin %> <%= command.id %> --id <stackId>"
       ],
       "flags": {
         "verbose": {
@@ -457,7 +463,7 @@
           "name": "dir"
         }
       },
-      "description": "Initialize a new Blueprint",
+      "description": "Initialize a new Blueprint Stack deployment",
       "examples": [
         "<%= config.bin %> <%= command.id %>",
         "<%= config.bin %> <%= command.id %> [directory]",
@@ -657,7 +663,7 @@
     "blueprints:stacks": {
       "aliases": [],
       "args": {},
-      "description": "List all Blueprint stacks",
+      "description": "List all Blueprint Stacks",
       "examples": [
         "<%= config.bin %> <%= command.id %>",
         "<%= config.bin %> <%= command.id %> --project-id <projectId>",
@@ -1410,5 +1416,5 @@
       ]
     }
   },
-  "version": "12.0.0"
+  "version": "12.1.0"
 }

package/package.json

@@ -1,11 +1,14 @@
 {
   "name": "@sanity/runtime-cli",
   "description": "Sanity's Runtime CLI for Blueprints and Functions",
-  "version": "12.0.0",
+  "version": "12.1.0",
   "author": "Sanity Runtime Team",
   "type": "module",
   "license": "MIT",
-  "repository": "sanity-io/runtime-cli",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/sanity-io/runtime-cli.git"
+  },
   "bugs": "https://github.com/sanity-io/runtime-cli/issues",
   "homepage": "https://github.com/sanity-io/runtime-cli",
   "main": "dist/index.js",
@@ -53,7 +56,7 @@
     "./oclif.manifest.json"
   ],
   "bin": {
-    "sanity-run": "./bin/run.js"
+    "sanity-run": "bin/run.js"
   },
   "scripts": {
     "build": "rollup -c && npm run build:ts && npm run build:static && npm run build:oclif",