@sanity/runtime-cli 14.8.5 → 14.9.0

package/dist/cores/functions/add.js

@@ -127,7 +127,7 @@ export async function functionAddCore(options) {
     }
     try {
         const fnName = flagResourceName || (await promptForFunctionName());
-        if (blueprint.parsedBlueprint.resources?.some((r) => r.name === fnName)) {
+        if (blueprint.resources.some((r) => r.name === fnName)) {
             return {
                 success: false,
                 error: `Function "${styleText('bold', fnName)}" already exists.`,

package/dist/cores/functions/build.js

@@ -1,20 +1,18 @@
 import fs from 'node:fs';
 import path from 'node:path';
 import { pathToZip } from '../../actions/blueprints/assets.js';
-import { findFunctionInBlueprint } from '../../utils/find-function.js';
+import { findFunctionInResources } from '../../utils/find-function.js';
 import { prepareAsset } from '../../utils/functions/prepare-asset.js';
 import { isLocalFunctionResource } from '../../utils/types.js';
 export async function functionBuildCore(options) {
     const { blueprint, log, args, flags } = options;
-    const { parsedBlueprint } = blueprint;
-    const allFunctions = (parsedBlueprint.resources ?? []).filter(isLocalFunctionResource);
+    const allFunctions = blueprint.resources.filter(isLocalFunctionResource);
     if (allFunctions.length === 0) {
         return { success: false, error: 'No functions found in blueprint.' };
     }
     let functions;
     if (args.name) {
-        const resource = findFunctionInBlueprint(parsedBlueprint, args.name);
-        functions = [resource];
+        functions = [findFunctionInResources(blueprint.resources, args.name)];
     }
     else {
         functions = allFunctions;

package/dist/cores/functions/logs.js

@@ -10,7 +10,7 @@ export async function functionLogsCore(options) {
     const { name } = args;
     const { delete: shouldDelete, watch: shouldWatch, force, limit, json, utc } = flags;
     if (!name) {
-        const functionNames = getFunctionNames(blueprint.parsedBlueprint.resources);
+        const functionNames = getFunctionNames(blueprint.resources);
         const validNames = functionNames.length > 0
             ? `Valid names are: ${functionNames.join(', ')}`
             : 'No functions are defined in the blueprint.';

package/dist/cores/functions/test.js

@@ -5,7 +5,7 @@ import { testAction } from '../../actions/functions/test.js';
 import config from '../../config.js';
 import { SANITY_FUNCTION_DOCUMENT, SANITY_FUNCTION_MEDIA_LIBRARY_ASSET } from '../../constants.js';
 import buildPayload from '../../utils/build-payload.js';
-import { findFunctionInBlueprint, getFunctionNames } from '../../utils/find-function.js';
+import { findFunctionInResources, getFunctionNames } from '../../utils/find-function.js';
 import { fetchAsset, fetchDocument } from '../../utils/functions/fetch-document.js';
 import { parseJsonObject } from '../../utils/parse-json-object.js';
 import { isEventType, isGroqContextOptions, } from '../../utils/types.js';
@@ -13,10 +13,9 @@ export async function functionTestCore(options) {
     const { blueprint, log, error, args, flags, helpText } = options;
     const { name: fnName } = args;
     const { data, event, file, timeout, api, dataset, 'document-id': documentId, 'with-user-token': withUserToken, 'data-before': dataBefore, 'data-after': dataAfter, 'file-before': fileBefore, 'file-after': fileAfter, 'document-id-before': documentIdBefore, 'document-id-after': documentIdAfter, 'media-library-id': mediaLibraryId, } = flags;
-    const { parsedBlueprint } = blueprint;
     const { 'project-id': projectId = blueprint?.projectId, 'organization-id': organizationId = blueprint?.organizationId, } = flags;
     if (!fnName) {
-        const functionNames = getFunctionNames(blueprint.parsedBlueprint.resources);
+        const functionNames = getFunctionNames(blueprint.resources);
         const validNames = functionNames.length > 0
             ? `Valid names are: ${functionNames.join(', ')}`
             : 'No functions are defined in the blueprint.';
@@ -38,7 +37,7 @@ export async function functionTestCore(options) {
         };
     }
     try {
-        const resource = findFunctionInBlueprint(parsedBlueprint, fnName); // throws if not found
+        const resource = findFunctionInResources(blueprint.resources, fnName); // throws if not found
         const docFunction = resource.type === SANITY_FUNCTION_DOCUMENT;
         const mediaFunction = resource.type === SANITY_FUNCTION_MEDIA_LIBRARY_ASSET;
         const contextOptions = docFunction || mediaFunction
@@ -143,9 +142,15 @@ export async function functionTestCore(options) {
         });
         if (error) {
             spinner.fail('Function execution failed.');
+            const errorMessage = error.stack || error.message || error.name;
+            const isTimeout = error.message?.includes('Timeout');
             return {
                 success: false,
-                error: error.stack || error.message || error.name,
+                error: errorMessage,
+                ref: isTimeout ? 'https://www.sanity.io/docs/help/functions-timeout' : undefined,
+                suggestions: isTimeout
+                    ? ['Increase the timeout in your Blueprint function configuration.']
+                    : undefined,
             };
         }
         spinner.succeed('Function execution succeeded.');

package/dist/cores/index.d.ts

@@ -35,6 +35,12 @@ export type CoreResult = {
     success: false;
     /** The error message, if the operation failed. */
     error: string;
+    /** Actionable suggestions displayed to the user via oclif's PrettyPrintableError. */
+    suggestions?: string[];
+    /** A URL for more information about the error. */
+    ref?: string;
+    /** A machine-readable error code. */
+    code?: string;
     streaming?: never;
     json?: never;
 } | {

package/dist/cores/index.js

@@ -42,7 +42,6 @@ export async function initDeployedBlueprintConfig(config) {
     }
     const { scopeType, scopeId, stackId: blueprintStackId } = config.blueprint;
     if (!scopeType || !scopeId) {
-        config.log(`Incomplete configuration. Run \`${config.bin} blueprints doctor\` for diagnostics.`);
         return { ok: false, error: 'Missing scope configuration for Blueprint' };
     }
     const auth = { token: config.token, scopeType, scopeId };
@@ -51,14 +50,12 @@ export async function initDeployedBlueprintConfig(config) {
         stackId = await resolveStackIdByNameOrId(config.stackOverride, auth, config.log);
     }
     if (!stackId) {
-        config.log(`Incomplete configuration. Run \`${config.bin} blueprints doctor\` for diagnostics.`);
         return { ok: false, error: 'Missing Stack deployment configuration for Blueprint' };
     }
     const spinner = config.log.ora('Loading Stack deployment...').start();
     const stackResponse = await getStack({ stackId, auth, logger: config.log });
     if (!stackResponse.ok) {
         spinner.fail('Could not load Stack deployment');
-        config.log(`Run \`${config.bin} blueprints doctor\` for diagnostics.`);
         return { ok: false, error: 'Missing Stack deployment' };
     }
     spinner.stop().clear();

package/dist/server/handlers/invoke.js

@@ -1,10 +1,10 @@
 import { readLocalBlueprint } from '../../actions/blueprints/blueprint.js';
-import { findFunctionInBlueprint } from '../../utils/find-function.js';
+import { findFunctionInResources } from '../../utils/find-function.js';
 import invoke from '../../utils/invoke-local.js';
 export async function handleInvokeRequest(functionName, event, metadata, context, logger, validateResources, executionOptions) {
     const start = performance.now();
-    const { parsedBlueprint } = await readLocalBlueprint(logger, { resources: validateResources });
-    const resource = findFunctionInBlueprint(parsedBlueprint, functionName);
+    const blueprint = await readLocalBlueprint(logger, { resources: validateResources });
+    const resource = findFunctionInResources(blueprint.resources, functionName);
     const readBlueprintTime = performance.now() - start;
     const payload = {
         payload: event,

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

@@ -1,5 +1,5 @@
 import { treeify } from 'array-treeify';
-import { SANITY_ACCESS_ROBOT, SANITY_ACCESS_ROLE, SANITY_FUNCTION_DOCUMENT, SANITY_FUNCTION_MEDIA_LIBRARY_ASSET, SANITY_FUNCTION_SCHEDULED, SANITY_PROJECT, SANITY_PROJECT_CORS, SANITY_PROJECT_DATASET, SANITY_PROJECT_WEBHOOK, } from '../../constants.js';
+import { SANITY_ACCESS_ROBOT, SANITY_ACCESS_ROLE, SANITY_FUNCTION_DOCUMENT, SANITY_FUNCTION_MEDIA_LIBRARY_ASSET, SANITY_FUNCTION_SCHEDULED, SANITY_FUNCTION_SYNC_TAG_INVALIDATE, SANITY_PROJECT, SANITY_PROJECT_CORS, SANITY_PROJECT_DATASET, SANITY_PROJECT_WEBHOOK, } from '../../constants.js';
 import { styleText } from '../style-text.js';
 import { isCorsOriginResource, isDatasetResource, isRobotResource, isRoleResource, isWebhookResource, } from '../types.js';
 import { formatDate, formatDuration } from './dates.js';
@@ -28,6 +28,7 @@ const RESOURCE_CATEGORIES = {
     [SANITY_FUNCTION_DOCUMENT]: functionCategory,
     [SANITY_FUNCTION_MEDIA_LIBRARY_ASSET]: functionCategory,
     [SANITY_FUNCTION_SCHEDULED]: functionCategory,
+    [SANITY_FUNCTION_SYNC_TAG_INVALIDATE]: functionCategory,
     [SANITY_PROJECT]: {
         label: 'Projects',
         displayNameAttribute: 'displayName',

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

@@ -19,15 +19,20 @@ function arrayifyEvent(event) {
         }
     }
     else {
-        if (event.on) {
+        if ('on' in event && event.on) {
             details.push(formatLabeledValue('on', event.on.map((o) => `"${o}"`).join(', ')));
         }
-        if (event.filter) {
+        if ('filter' in event && event.filter) {
             details.push(formatLabeledValue('filter', event.filter));
         }
-        if (event.projection) {
+        if ('projection' in event && event.projection) {
             details.push(formatLabeledValue('projection', event.projection));
         }
+        // TODO: expose event.resource details once we are ready
+        // https://linear.app/sanity/issue/RUN-1246/cli-should-show-eventresource-details-in-blueprints-infoplans
+        // if (event.resource) {
+        //   details.push(formatLabeledValue('resource', JSON.stringify(event.resource)))
+        // }
     }
     return details;
 }

package/dist/utils/find-function.d.ts

@@ -1,8 +1,9 @@
-import type { Blueprint } from '@sanity/blueprints';
+import type { BlueprintResource } from '@sanity/blueprints';
 import { type DeployedResource, type FunctionResource, type Stack } from './types.js';
-export declare function getFunctionNames(resources: Array<{
-    type?: string;
-    name?: string;
-}> | undefined): string[];
-export declare function findFunctionInBlueprint(blueprint: Pick<Blueprint, 'resources'>, name: string): FunctionResource;
+export declare function getFunctionNames(resources: BlueprintResource[] | undefined): string[];
+export declare function findFunctionInResources(resources: BlueprintResource[], name: string): FunctionResource;
+/** @deprecated Use findFunctionInResources instead */
+export declare const findFunctionInBlueprint: (blueprint: {
+    resources?: BlueprintResource[];
+}, name: string) => FunctionResource;
 export declare function findFunctionInStack(stack: Stack, name: string): DeployedResource;

package/dist/utils/find-function.js

@@ -2,16 +2,18 @@ import { SANITY_FUNCTION_PREFIX } from '../constants.js';
 import { isLocalFunctionResource, } from './types.js';
 export function getFunctionNames(resources) {
     return (resources
-        ?.filter((r) => r?.type?.startsWith(SANITY_FUNCTION_PREFIX))
+        ?.filter((r) => r.type.startsWith(SANITY_FUNCTION_PREFIX))
         .map((r) => r.name)
         .filter((name) => typeof name === 'string') ?? []);
 }
-export function findFunctionInBlueprint(blueprint, name) {
-    const func = blueprint?.resources?.filter(isLocalFunctionResource).find((r) => r.name === name);
+export function findFunctionInResources(resources, name) {
+    const func = resources.filter(isLocalFunctionResource).find((r) => r.name === name);
     if (!func)
         throw Error(`Unable to find function ${name}`);
     return func;
 }
+/** @deprecated Use findFunctionInResources instead */
+export const findFunctionInBlueprint = (blueprint, name) => findFunctionInResources(blueprint?.resources ?? [], name);
 export function findFunctionInStack(stack, name) {
     const func = stack?.resources?.filter(isLocalFunctionResource).find((r) => r.name === name);
     if (!func)

package/dist/utils/functions/detect-native-modules.js

@@ -9,7 +9,11 @@ export const errorMessage = (elements) => `Native modules detected:\n${elements.
  * Quick helper so we can recurse through pnpm symlinks if they exist
  * Fallback to statSync if it's a symlink
  */
-const isDirEntry = (dir, parent) => dir.isDirectory() || (dir.isSymbolicLink() && statSync(path.join(parent, dir.name)).isDirectory());
+const isDirEntry = (dir, parent) => {
+    return (dir.isDirectory() ||
+        (dir.isSymbolicLink() &&
+            statSync(path.join(parent, dir.name), { throwIfNoEntry: false })?.isDirectory()));
+};
 /**
  * Recursively checks a directory for files that match known native module patterns.
  */

package/dist/utils/invoke-local.js

@@ -150,7 +150,7 @@ export default async function invoke(resource, payload, context, options) {
             });
             timer = setTimeout(() => {
                 shutdown();
-                reject(new Error(`Timeout: The process exceeded your current timeout limit of ${timeout} seconds. Learn to adjust your Blueprint's timeout settings here: https://www.sanity.io/docs/help/functions-timeout`));
+                reject(new Error(`Timeout: Function exceeded the ${timeout}-second time limit.`));
             }, timeout * 1000);
             const payload = {
                 data: { ...filteredData },

package/dist/utils/types.d.ts

@@ -1,4 +1,4 @@
-import { type BlueprintCorsOriginResource, type BlueprintDatasetResource, type BlueprintDocumentFunctionResource, type BlueprintDocumentWebhookResource, type BlueprintMediaLibraryAssetFunctionResource, type BlueprintProjectResource, type BlueprintResource, type BlueprintRobotResource, type BlueprintRoleResource, type BlueprintScheduledFunctionResource } from '@sanity/blueprints';
+import { type BlueprintCorsOriginResource, type BlueprintDatasetResource, type BlueprintDocumentFunctionResource, type BlueprintDocumentWebhookResource, type BlueprintMediaLibraryAssetFunctionResource, type BlueprintProjectResource, type BlueprintResource, type BlueprintRobotResource, type BlueprintRoleResource, type BlueprintScheduledFunctionResource, type BlueprintSyncTagInvalidateFunctionResource } from '@sanity/blueprints';
 export type ScopeType = 'organization' | 'project';
 /** Result utility type */
 export type Result<T, E = string> = {
@@ -15,7 +15,7 @@ export interface ActionResponse {
 }
 /** @internal */
 export type FunctionGroqResource = BlueprintDocumentFunctionResource | BlueprintMediaLibraryAssetFunctionResource;
-export type FunctionResource = FunctionGroqResource | BlueprintScheduledFunctionResource;
+export type FunctionResource = FunctionGroqResource | BlueprintScheduledFunctionResource | BlueprintSyncTagInvalidateFunctionResource;
 export interface StudioResource extends BlueprintResource {
     type: 'sanity.studio';
     src: string;
@@ -79,7 +79,7 @@ export interface StackMutation {
     scopeType: ScopeType;
     scopeId: string;
     document: {
-        resources?: Array<BlueprintResource & Record<string, unknown>>;
+        resources?: BlueprintResource[];
     };
 }
 /** @internal */

package/oclif.manifest.json

@@ -314,7 +314,7 @@
     "blueprints:deploy": {
       "aliases": [],
       "args": {},
-      "description": "Pushes your local Blueprint configuration to the remote Stack; provisioning, updating, or destroying resources as needed. This is the primary command for applying infrastructure changes.\n\nBefore deploying, run 'blueprints plan' to preview changes. After deployment, use 'blueprints info' to verify Stack status or 'blueprints logs' to monitor activity.\n\nUse --no-wait to queue the deployment and return immediately without waiting for completion.\n\nUse --fn-installer to force which package manager to use when deploying functions.\n\nSet SANITY_ASSET_TIMEOUT (seconds) to override the 60-second timeout for processing resource assets.",
+      "description": "Applies your local Blueprint to the remote Stack, creating, updating, or removing resources as needed. This is the primary command for applying infrastructure changes.\n\nBefore deploying, run 'blueprints plan' to preview changes. After deployment, use 'blueprints info' to verify Stack status or 'blueprints logs' to monitor activity.\n\nUse --no-wait to queue the deployment and return immediately without waiting for completion.\n\nUse --fn-installer to force which package manager to use when deploying functions.\n\nSet SANITY_ASSET_TIMEOUT (seconds) to override the 60-second timeout for processing resource assets.",
       "examples": [
         "<%= config.bin %> <%= command.id %>",
         "<%= config.bin %> <%= command.id %> --no-wait",
@@ -536,7 +536,7 @@
       "pluginName": "@sanity/runtime-cli",
       "pluginType": "core",
       "strict": true,
-      "summary": "Destroy the remote Stack deployment and its resources (will not delete local files)",
+      "summary": "Destroy a remote Stack deployment and its resources",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
@@ -550,7 +550,10 @@
       "aliases": [],
       "args": {},
       "description": "Analyzes your local Blueprint and remote Stack configuration for common issues, such as missing authentication, invalid project references, or misconfigured resources.\n\nRun this command when encountering errors with other Blueprint commands. Use --fix to interactively resolve detected issues.",
-      "examples": [],
+      "examples": [
+        "<%= config.bin %> <%= command.id %>",
+        "<%= config.bin %> <%= command.id %> --fix"
+      ],
       "flags": {
         "json": {
           "description": "Format output as json",
@@ -681,7 +684,7 @@
       "pluginName": "@sanity/runtime-cli",
       "pluginType": "core",
       "strict": true,
-      "summary": "Show information about the local Blueprint's remote Stack deployment",
+      "summary": "Display the status and resources of the remote Stack deployment",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
@@ -841,7 +844,7 @@
       "pluginName": "@sanity/runtime-cli",
       "pluginType": "core",
       "strict": true,
-      "summary": "Initialize a local Blueprint and optionally provision a remote Stack deployment",
+      "summary": "Initialize a Blueprint and create a remote Stack",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
@@ -998,7 +1001,7 @@
       "pluginName": "@sanity/runtime-cli",
       "pluginType": "core",
       "strict": true,
-      "summary": "Enumerate resources to be deployed to the remote Stack - will not modify any resources",
+      "summary": "Preview changes that will be applied to the remote Stack",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
@@ -1011,7 +1014,7 @@
     "blueprints:promote": {
       "aliases": [],
       "args": {},
-      "description": "EXPERIMENTAL! Promotes a Stack, changing its scope from project to organization. This is a one-way trip.",
+      "description": "Promotes a deployed Stack to organization scope, enabling management of org-level resources. Promotion cannot be reversed.\n\nYour local Blueprint configuration will be updated to reflect the new scope.",
       "examples": [
         "<%= config.bin %> <%= command.id %>",
         "<%= config.bin %> <%= command.id %> --stack <name-or-id>"
@@ -1081,7 +1084,7 @@
       "pluginName": "@sanity/runtime-cli",
       "pluginType": "core",
       "strict": true,
-      "summary": "Promote a Stack deployment to a broader scope",
+      "summary": "Promote a Stack from project scope to organization scope",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
@@ -1177,7 +1180,7 @@
       "pluginName": "@sanity/runtime-cli",
       "pluginType": "core",
       "strict": true,
-      "summary": "List all remote Stack deployments (defaults to the current Blueprint's project scope)",
+      "summary": "List remote Stack deployments for your project or organization",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
@@ -2235,5 +2238,5 @@
       ]
     }
   },
-  "version": "14.8.5"
+  "version": "14.9.0"
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@sanity/runtime-cli",
   "description": "Sanity's Runtime CLI for Blueprints and Functions",
-  "version": "14.8.5",
+  "version": "14.9.0",
   "author": "Sanity Runtime Team",
   "type": "module",
   "license": "MIT",
@@ -145,7 +145,7 @@
     "rollup": "^4.59.0",
     "shx": "^0.4.0",
     "ts-node": "^10.9.2",
-    "typescript": "^5.9.3",
+    "typescript": "^6.0.2",
     "vitest": "4.1.0"
   },
   "oclif": {