@sanity/runtime-cli 14.0.1 → 14.1.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/14.0.1 linux-x64 node-v24.13.0
+@sanity/runtime-cli/14.1.1 linux-x64 node-v24.13.1
 $ sanity-run --help [COMMAND]
 USAGE
   $ sanity-run COMMAND
@@ -98,7 +98,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/v14.0.1/src/commands/blueprints/add.ts)_
+_See code: [src/commands/blueprints/add.ts](https://github.com/sanity-io/runtime-cli/blob/v14.1.1/src/commands/blueprints/add.ts)_
 
 ## `sanity-run blueprints config`
 
@@ -133,7 +133,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/v14.0.1/src/commands/blueprints/config.ts)_
+_See code: [src/commands/blueprints/config.ts](https://github.com/sanity-io/runtime-cli/blob/v14.1.1/src/commands/blueprints/config.ts)_
 
 ## `sanity-run blueprints deploy`
 
@@ -166,7 +166,7 @@ EXAMPLES
   $ sanity-run blueprints deploy --no-wait
 ```
 
-_See code: [src/commands/blueprints/deploy.ts](https://github.com/sanity-io/runtime-cli/blob/v14.0.1/src/commands/blueprints/deploy.ts)_
+_See code: [src/commands/blueprints/deploy.ts](https://github.com/sanity-io/runtime-cli/blob/v14.1.1/src/commands/blueprints/deploy.ts)_
 
 ## `sanity-run blueprints destroy`
 
@@ -198,7 +198,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/v14.0.1/src/commands/blueprints/destroy.ts)_
+_See code: [src/commands/blueprints/destroy.ts](https://github.com/sanity-io/runtime-cli/blob/v14.1.1/src/commands/blueprints/destroy.ts)_
 
 ## `sanity-run blueprints doctor`
 
@@ -224,7 +224,7 @@ DESCRIPTION
   issues.
 ```
 
-_See code: [src/commands/blueprints/doctor.ts](https://github.com/sanity-io/runtime-cli/blob/v14.0.1/src/commands/blueprints/doctor.ts)_
+_See code: [src/commands/blueprints/doctor.ts](https://github.com/sanity-io/runtime-cli/blob/v14.1.1/src/commands/blueprints/doctor.ts)_
 
 ## `sanity-run blueprints info`
 
@@ -254,7 +254,7 @@ EXAMPLES
   $ sanity-run blueprints info --stack <name-or-id>
 ```
 
-_See code: [src/commands/blueprints/info.ts](https://github.com/sanity-io/runtime-cli/blob/v14.0.1/src/commands/blueprints/info.ts)_
+_See code: [src/commands/blueprints/info.ts](https://github.com/sanity-io/runtime-cli/blob/v14.1.1/src/commands/blueprints/info.ts)_
 
 ## `sanity-run blueprints init [DIR]`
 
@@ -304,7 +304,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/v14.0.1/src/commands/blueprints/init.ts)_
+_See code: [src/commands/blueprints/init.ts](https://github.com/sanity-io/runtime-cli/blob/v14.1.1/src/commands/blueprints/init.ts)_
 
 ## `sanity-run blueprints logs`
 
@@ -333,7 +333,7 @@ EXAMPLES
   $ sanity-run blueprints logs --watch
 ```
 
-_See code: [src/commands/blueprints/logs.ts](https://github.com/sanity-io/runtime-cli/blob/v14.0.1/src/commands/blueprints/logs.ts)_
+_See code: [src/commands/blueprints/logs.ts](https://github.com/sanity-io/runtime-cli/blob/v14.1.1/src/commands/blueprints/logs.ts)_
 
 ## `sanity-run blueprints plan`
 
@@ -359,7 +359,7 @@ EXAMPLES
   $ sanity-run blueprints plan
 ```
 
-_See code: [src/commands/blueprints/plan.ts](https://github.com/sanity-io/runtime-cli/blob/v14.0.1/src/commands/blueprints/plan.ts)_
+_See code: [src/commands/blueprints/plan.ts](https://github.com/sanity-io/runtime-cli/blob/v14.1.1/src/commands/blueprints/plan.ts)_
 
 ## `sanity-run blueprints stacks`
 
@@ -388,7 +388,7 @@ EXAMPLES
   $ sanity-run blueprints stacks --organization-id <organizationId>
 ```
 
-_See code: [src/commands/blueprints/stacks.ts](https://github.com/sanity-io/runtime-cli/blob/v14.0.1/src/commands/blueprints/stacks.ts)_
+_See code: [src/commands/blueprints/stacks.ts](https://github.com/sanity-io/runtime-cli/blob/v14.1.1/src/commands/blueprints/stacks.ts)_
 
 ## `sanity-run functions add`
 
@@ -437,7 +437,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/v14.0.1/src/commands/functions/add.ts)_
+_See code: [src/commands/functions/add.ts](https://github.com/sanity-io/runtime-cli/blob/v14.1.1/src/commands/functions/add.ts)_
 
 ## `sanity-run functions dev`
 
@@ -471,7 +471,7 @@ EXAMPLES
   $ sanity-run functions dev --timeout 60
 ```
 
-_See code: [src/commands/functions/dev.ts](https://github.com/sanity-io/runtime-cli/blob/v14.0.1/src/commands/functions/dev.ts)_
+_See code: [src/commands/functions/dev.ts](https://github.com/sanity-io/runtime-cli/blob/v14.1.1/src/commands/functions/dev.ts)_
 
 ## `sanity-run functions env add NAME KEY VALUE`
 
@@ -498,7 +498,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/v14.0.1/src/commands/functions/env/add.ts)_
+_See code: [src/commands/functions/env/add.ts](https://github.com/sanity-io/runtime-cli/blob/v14.1.1/src/commands/functions/env/add.ts)_
 
 ## `sanity-run functions env list NAME`
 
@@ -522,7 +522,7 @@ EXAMPLES
   $ sanity-run functions env list MyFunction
 ```
 
-_See code: [src/commands/functions/env/list.ts](https://github.com/sanity-io/runtime-cli/blob/v14.0.1/src/commands/functions/env/list.ts)_
+_See code: [src/commands/functions/env/list.ts](https://github.com/sanity-io/runtime-cli/blob/v14.1.1/src/commands/functions/env/list.ts)_
 
 ## `sanity-run functions env remove NAME KEY`
 
@@ -548,7 +548,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/v14.0.1/src/commands/functions/env/remove.ts)_
+_See code: [src/commands/functions/env/remove.ts](https://github.com/sanity-io/runtime-cli/blob/v14.1.1/src/commands/functions/env/remove.ts)_
 
 ## `sanity-run functions logs [NAME]`
 
@@ -588,7 +588,7 @@ EXAMPLES
   $ sanity-run functions logs <name> --delete
 ```
 
-_See code: [src/commands/functions/logs.ts](https://github.com/sanity-io/runtime-cli/blob/v14.0.1/src/commands/functions/logs.ts)_
+_See code: [src/commands/functions/logs.ts](https://github.com/sanity-io/runtime-cli/blob/v14.1.1/src/commands/functions/logs.ts)_
 
 ## `sanity-run functions test [NAME]`
 
@@ -642,7 +642,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/v14.0.1/src/commands/functions/test.ts)_
+_See code: [src/commands/functions/test.ts](https://github.com/sanity-io/runtime-cli/blob/v14.1.1/src/commands/functions/test.ts)_
 
 ## `sanity-run help [COMMAND]`
 

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

@@ -1,3 +1,4 @@
+import type { Blueprint } from '@sanity/blueprints-parser';
 import type { Logger } from '../../utils/logger.js';
 import type { AuthParams, ScopeType, Stack, StackMutation } from '../../utils/types.js';
 export declare const stacksUrl: string;
@@ -50,6 +51,56 @@ export declare function updateStack({ stackId, stackMutation, auth, logger, }: {
     auth: AuthParams;
     logger: ReturnType<typeof Logger>;
 }): Promise<UpdateStackResponse>;
+interface PlanResourceSnapshot {
+    name: string;
+    type: string;
+    parameters: Record<string, unknown>;
+}
+export interface PlanActionDetails {
+    name: string;
+    type: string;
+    parameters?: Record<string, unknown>;
+    existingResource?: PlanResourceSnapshot & {
+        id: string;
+        externalId?: string;
+    };
+    updatedResource?: PlanResourceSnapshot;
+}
+export interface DeploymentPlanAction {
+    type: 'create' | 'update' | 'destroy' | 'skip' | 'attach' | 'detach';
+    resourceType: string;
+    details: PlanActionDetails | null;
+}
+export interface DeploymentPlan {
+    plan: DeploymentPlanAction[];
+    summary: {
+        createCount: number;
+        updateCount: number;
+        destroyCount: number;
+        skipCount: number;
+        attachCount: number;
+        detachCount: number;
+    };
+}
+type PlanStackResponse = {
+    ok: true;
+    error: null;
+    problems: null;
+    deploymentPlan: DeploymentPlan;
+} | {
+    ok: false;
+    error: string;
+    problems: {
+        message: string;
+    }[] | null;
+    deploymentPlan: null;
+};
+export declare function planStack({ stackId, document, auth, logger, }: {
+    stackId: string;
+    document: Blueprint;
+    auth: AuthParams;
+    logger: ReturnType<typeof Logger>;
+}): Promise<PlanStackResponse>;
 interface DestroyStackResponse {
     ok: boolean;
     error: string | null;

package/dist/actions/blueprints/stacks.js

@@ -75,6 +75,24 @@ export async function updateStack({ stackId, stackMutation, auth, logger, }) {
         stack: data,
     };
 }
+export async function planStack({ stackId, document, auth, logger, }) {
+    const fetchFn = createTracedFetch(logger);
+    const response = await fetchFn(`${stacksUrl}/${stackId}/plan`, {
+        method: 'POST',
+        headers: getHeaders(auth),
+        body: JSON.stringify({ document }),
+    });
+    const data = await response.json();
+    if (!response.ok) {
+        return {
+            ok: false,
+            error: data.message || 'Failed to retrieve deployment plan',
+            problems: response.status === 400 && Array.isArray(data.problems) ? data.problems : null,
+            deploymentPlan: null,
+        };
+    }
+    return { ok: true, error: null, problems: null, deploymentPlan: data };
+}
 export async function resolveStackIdByNameOrId(value, auth, logger) {
     if (value.startsWith('ST-') && value.length === 13)
         return value;

package/dist/config.d.ts

@@ -4,6 +4,7 @@ export declare const BLUEPRINT_CONFIG_FILE = "blueprint.config.json";
 export declare let RUNTIME_CLI_VERSION: string | undefined;
 declare const _default: {
     isTest: boolean;
+    isLive: boolean;
     apiUrl: string;
     token: string | null;
 };

package/dist/config.js

@@ -21,6 +21,7 @@ const nodeEnv = env.NODE_ENV?.toLowerCase() ?? 'production';
 const isTest = nodeEnv === 'test';
 const sanityEnv = env.SANITY_INTERNAL_ENV?.toLowerCase() ?? 'production';
 const sanityProd = sanityEnv === 'production';
+const isLive = sanityProd || sanityEnv === 'staging';
 const isPublishing = env?.PUBLISHING?.toLowerCase() === 'true';
 const apiUrls = {
     production: 'https://api.sanity.io/',
@@ -52,6 +53,7 @@ function loadToken() {
 }
 export default {
     isTest,
+    isLive,
     apiUrl,
     get token() {
         return _token === undefined ? loadToken() : _token;

package/dist/cores/blueprints/plan.js

@@ -1,32 +1,67 @@
-import { getStack, resolveStackIdByNameOrId } from '../../actions/blueprints/stacks.js';
-import { formatResourceTree, stackDeployDiff } from '../../utils/display/blueprints-formatting.js';
+import { planStack, resolveStackIdByNameOrId } from '../../actions/blueprints/stacks.js';
+import { formatDeploymentPlan, formatResourceTree, hasActionableChanges, } from '../../utils/display/blueprints-formatting.js';
 import { styleText } from '../../utils/style-text.js';
 export async function blueprintPlanCore(options) {
     const { bin = 'sanity', log, blueprint, token, flags } = options;
     const { verbose: _verbose = false } = flags;
     const { scopeType, scopeId, stackId: blueprintStackId, parsedBlueprint, fileInfo } = blueprint;
-    log(`${styleText(['bold', 'blueBright'], 'Blueprint Stack deployment plan')} ${styleText('dim', `(${fileInfo.fileName})`)}`);
+    log(`${styleText(['bold', 'blueBright'], 'Local Blueprint')} ${styleText('dim', `(${fileInfo.fileName})`)}`);
     log(formatResourceTree(parsedBlueprint.resources));
-    if (token && scopeType && scopeId) {
-        const stackId = flags.stack
-            ? await resolveStackIdByNameOrId(flags.stack, { token, scopeType, scopeId }, log)
-            : blueprintStackId;
-        if (stackId) {
-            const stackResponse = await getStack({
-                auth: { token, scopeType, scopeId },
-                stackId,
-                logger: log,
-            });
-            if (!stackResponse.ok) {
-                log(styleText('dim', 'Unable to retrieve live Stack deployment for comparison'));
-            }
-            else {
-                const diff = stackDeployDiff(parsedBlueprint, stackResponse.stack);
-                if (diff)
-                    log(diff);
+    if (!token || !scopeType || !scopeId) {
+        log(styleText('dim', 'Unable to retrieve live Stack deployment for comparison'));
+        const errorMessage = !token
+            ? `Missing authentication token. Run \`${bin} login\` to authenticate.`
+            : `Missing Blueprint configuration. Run \`${bin} blueprints doctor --fix\` to repair.`;
+        return {
+            success: false,
+            error: errorMessage,
+        };
+    }
+    const stackId = flags.stack
+        ? await resolveStackIdByNameOrId(flags.stack, { token, scopeType, scopeId }, log)
+        : blueprintStackId;
+    if (!stackId) {
+        log(styleText('dim', 'Unable to retrieve live Stack deployment for comparison'));
+        return {
+            success: false,
+            error: `Missing Stack deployment configuration. Run \`${bin} blueprints doctor --fix\` to repair.`,
+        };
+    }
+    const auth = { token, scopeType, scopeId };
+    const spinner = log.ora('Generating deployment plan...').start();
+    const planResponse = await planStack({
+        stackId,
+        document: parsedBlueprint,
+        auth,
+        logger: log,
+    });
+    spinner.stop().clear();
+    if (!planResponse.ok) {
+        if (planResponse.problems) {
+            log('');
+            for (const problem of planResponse.problems) {
+                const messages = problem.message
+                    .split('\n')
+                    .map((s) => s.trim())
+                    .filter(Boolean);
+                for (const msg of messages) {
+                    log(`  ${styleText(['bold', 'red'], '✘')} ${msg}`);
+                }
             }
+            log(`\n  Fix the issues above before running "${styleText(['bold', 'magenta'], `${bin} blueprints deploy`)}"`);
         }
+        else {
+            log(styleText('dim', '\nUnable to retrieve deployment plan from server'));
+        }
+        return { success: false, error: 'Deployment plan has problems' };
+    }
+    log('');
+    log(formatDeploymentPlan(planResponse.deploymentPlan));
+    if (hasActionableChanges(planResponse.deploymentPlan)) {
+        log(`\n  Run "${styleText(['bold', 'magenta'], `${bin} blueprints deploy`)}" to apply these Stack changes`);
+    }
+    else {
+        log(`\n  ${styleText('dim', `No significant changes to deploy. Run \`${bin} blueprints deploy\` to apply.`)}`);
     }
-    log(`\n  Run "${styleText(['bold', 'magenta'], `${bin} blueprints deploy`)}" to deploy these Stack changes`);
     return { success: true };
 }

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

@@ -1,8 +1,10 @@
 import type { Blueprint, Resource } from '@sanity/blueprints-parser';
+import type { DeploymentPlan } from '../../actions/blueprints/stacks.js';
 import { type BlueprintResourceRecord, type Stack } from '../types.js';
 export declare function formatTitle(title: string, name: string): string;
 export declare function formatDeployedResourceTree(resources: BlueprintResourceRecord[] | undefined, verbose?: boolean): string;
 export declare function formatResourceTree(resources: Resource[] | undefined, verbose?: boolean): string;
 export declare function formatStackInfo(stack: Stack | Blueprint, isCurrentStack?: boolean): string;
 export declare function formatStacksListing(stacks: Stack[], currentStackId?: string): string;
-export declare function stackDeployDiff(localBlueprint: Blueprint, deployedStack: Stack): string | null;
+export declare function hasActionableChanges(deploymentPlan: DeploymentPlan): boolean;
+export declare function formatDeploymentPlan(deploymentPlan: DeploymentPlan): string;

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

@@ -208,29 +208,143 @@ export function formatStacksListing(stacks, currentStackId) {
     }
     return output.join('\n');
 }
-export function stackDeployDiff(localBlueprint, deployedStack) {
-    const added = [];
-    const removed = [];
-    // look for new resources
-    for (const resource of localBlueprint.resources ?? []) {
-        const deployedResource = deployedStack.resources.find(({ name, type }) => resource.name === name && resource.type === type);
-        if (!deployedResource)
-            added.push(resource);
-    }
-    // look for destroyed resources
-    for (const resource of deployedStack.resources) {
-        const localResource = localBlueprint.resources?.find(({ name, type }) => resource.name === name && resource.type === type);
-        if (!localResource)
-            removed.push(resource);
-    }
-    if (added.length === 0 && removed.length === 0)
-        return null;
-    const output = [];
-    if (added.length > 0) {
-        output.push(`  ${styleText(['bold', 'greenBright'], '++')} ${added.map(({ name }) => styleText(['bgGreen', 'whiteBright'], `"${name}"`)).join(' ')}`);
+const IGNORED_PARAMS = {
+    [SANITY_FUNCTION_DOCUMENT]: new Set(['src']),
+    [SANITY_FUNCTION_MEDIA_LIBRARY_ASSET]: new Set(['src']),
+    [SANITY_FUNCTION_SCHEDULE]: new Set(['src']),
+};
+const ASSET_RESOURCE_TYPES = new Set([
+    SANITY_FUNCTION_DOCUMENT,
+    SANITY_FUNCTION_MEDIA_LIBRARY_ASSET,
+    SANITY_FUNCTION_SCHEDULE,
+]);
+function stringifyUnknown(val) {
+    if (val === null || val === undefined)
+        return JSON.stringify(val);
+    if (Array.isArray(val))
+        return `[${val.map(stringifyUnknown).join(',')}]`;
+    if (typeof val === 'object') {
+        const obj = val;
+        const sorted = Object.keys(obj)
+            .sort()
+            .map((k) => `${JSON.stringify(k)}:${stringifyUnknown(obj[k])}`);
+        return `{${sorted.join(',')}}`;
     }
-    if (removed.length > 0) {
-        output.push(`  ${styleText(['bold', 'redBright'], '--')} ${removed.map(({ name }) => styleText(['bgRed', 'whiteBright'], `"${name}"`)).join(' ')}`);
+    return JSON.stringify(val);
+}
+function detectChangedParams(details) {
+    const existing = details.existingResource?.parameters;
+    const updated = details.updatedResource?.parameters;
+    if (!existing || !updated)
+        return [];
+    const ignored = IGNORED_PARAMS[details.type];
+    const keys = new Set([...Object.keys(existing), ...Object.keys(updated)]);
+    const changed = [];
+    for (const key of keys) {
+        if (ignored?.has(key))
+            continue;
+        if (stringifyUnknown(existing[key]) !== stringifyUnknown(updated[key])) {
+            changed.push(key);
+        }
     }
-    return output.join('\n');
+    return changed;
+}
+function getAssetSrc(details) {
+    const src = details.updatedResource?.parameters?.src ?? details.parameters?.src;
+    return typeof src === 'string' && !src.startsWith('AS-') ? src : undefined;
+}
+function actionStyle(type, isUnchanged = false) {
+    if (isUnchanged)
+        return { icon: '=', color: 'dim' };
+    switch (type) {
+        case 'create':
+            return { icon: '+', color: 'green' };
+        case 'update':
+            return { icon: '~', color: 'yellow' };
+        case 'destroy':
+            return { icon: '-', color: 'red' };
+        case 'attach':
+            return { icon: '←', color: 'blue' };
+        case 'detach':
+            return { icon: '→', color: 'gray' };
+        // case 'skip':
+        default:
+            return { icon: '=', color: 'dim' };
+    }
+}
+export function hasActionableChanges(deploymentPlan) {
+    const { summary } = deploymentPlan;
+    if (summary.createCount || summary.destroyCount || summary.attachCount || summary.detachCount) {
+        return true;
+    }
+    return deploymentPlan.plan.some((action) => action.type === 'update' &&
+        action.details &&
+        (detectChangedParams(action.details).length > 0 ||
+            (ASSET_RESOURCE_TYPES.has(action.resourceType) &&
+                getAssetSrc(action.details) !== undefined)));
+}
+export function formatDeploymentPlan(deploymentPlan) {
+    const lines = [];
+    lines.push(styleText('bold', 'Deployment Plan'));
+    if (deploymentPlan.plan.length === 0) {
+        lines.push(styleText('dim', '  No changes'));
+        return lines.join('\n');
+    }
+    const typePad = Math.max(...deploymentPlan.plan.map((a) => a.type.length));
+    const names = deploymentPlan.plan.map((a) => a.details?.name ?? '');
+    const namePad = Math.max(...names.map((n) => n.length));
+    const enrichedPlan = deploymentPlan.plan.map((action) => {
+        const changedParams = action.type === 'update' && action.details ? detectChangedParams(action.details) : [];
+        // always represent asset updates as a change; hard to know if the asset has changed
+        const assetSrc = action.details && ASSET_RESOURCE_TYPES.has(action.resourceType)
+            ? getAssetSrc(action.details)
+            : undefined;
+        const isUnchanged = action.type === 'update' && changedParams.length === 0 && !assetSrc;
+        return { action, changedParams, isUnchanged };
+    });
+    let unchangedCount = 0;
+    for (const { action, changedParams, isUnchanged } of enrichedPlan) {
+        const name = action.details?.name ?? '';
+        if (isUnchanged)
+            unchangedCount++;
+        const style = actionStyle(action.type, isUnchanged);
+        const icon = styleText(['bold', style.color], style.icon);
+        const typeLabel = styleText(style.color, action.type.padEnd(typePad));
+        const nameLabel = isUnchanged
+            ? styleText('dim', name.padEnd(namePad))
+            : styleText('bold', name.padEnd(namePad));
+        const resourceType = styleText('dim', action.resourceType);
+        let suffix = '';
+        if (changedParams.length > 0) {
+            suffix = `  ${styleText('yellow', changedParams.join(', '))}`;
+        }
+        lines.push(`  ${icon} ${typeLabel}  ${nameLabel}  ${resourceType}${suffix}`);
+    }
+    const { summary } = deploymentPlan;
+    const parts = [];
+    if (summary.createCount)
+        parts.push(styleText('green', `${summary.createCount} create`));
+    if (summary.updateCount) {
+        let label = `${summary.updateCount} update`;
+        if (unchangedCount > 0 && unchangedCount < summary.updateCount) {
+            label += ` (${styleText('yellow', `${summary.updateCount - unchangedCount} changed`)})`;
+        }
+        else if (unchangedCount === summary.updateCount) {
+            label += ` ${styleText('dim', '(no changes)')}`;
+        }
+        parts.push(label);
+    }
+    if (summary.destroyCount)
+        parts.push(styleText('red', `${summary.destroyCount} destroy`));
+    if (summary.skipCount)
+        parts.push(styleText('dim', `${summary.skipCount} skip`));
+    if (summary.attachCount)
+        parts.push(styleText('blue', `${summary.attachCount} attach`));
+    if (summary.detachCount)
+        parts.push(styleText('dim', `${summary.detachCount} detach`));
+    if (parts.length > 0) {
+        lines.push('');
+        lines.push(`  ${parts.join(', ')}`);
+    }
+    return lines.join('\n');
 }

package/dist/utils/other/npmjs.js

@@ -1,7 +1,10 @@
+import { env } from 'node:process';
 import { createTracedFetch } from '../traced-fetch.js';
 export async function getLatestNpmVersion(pkg, logger) {
     const fetchFn = createTracedFetch(logger);
-    const url = `https://registry.npmjs.org/${pkg}/latest`;
+    // allow for registry override; helpful for testing
+    const registry = env.SANITY_INTERNAL_NPM_REGISTRY_URL || 'https://registry.npmjs.org';
+    const url = `${registry}/${pkg}/latest`;
     try {
         const res = await fetchFn(url);
         if (!res.ok)

package/dist/utils/validated-token.js

@@ -3,10 +3,12 @@ import { createTracedFetch } from './traced-fetch.js';
 export async function validToken(logger, maybeToken) {
     if (config.isTest)
         return maybeToken ?? 'token';
-    const fetchFn = createTracedFetch(logger);
     const token = maybeToken ?? config.token;
     if (!token)
         throw new Error('NO_TOKEN');
+    if (!config.isLive)
+        return token;
+    const fetchFn = createTracedFetch(logger);
     const url = `${config.apiUrl}v2025-04-23/users/me`;
     const response = await fetchFn(url, {
         method: 'GET',

package/oclif.manifest.json

@@ -2083,5 +2083,5 @@
       ]
     }
   },
-  "version": "14.0.1"
+  "version": "14.1.1"
 }

package/package.json

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