@sanity/runtime-cli 14.13.2 → 14.13.4

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.13.2 linux-x64 node-v24.14.1
+@sanity/runtime-cli/14.13.4 linux-x64 node-v24.14.1
 $ sanity-run --help [COMMAND]
 USAGE
   $ sanity-run COMMAND
@@ -102,7 +102,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.13.2/src/commands/blueprints/add.ts)_
+_See code: [src/commands/blueprints/add.ts](https://github.com/sanity-io/runtime-cli/blob/v14.13.4/src/commands/blueprints/add.ts)_
 
 ## `sanity-run blueprints config`
 
@@ -141,7 +141,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.13.2/src/commands/blueprints/config.ts)_
+_See code: [src/commands/blueprints/config.ts](https://github.com/sanity-io/runtime-cli/blob/v14.13.4/src/commands/blueprints/config.ts)_
 
 ## `sanity-run blueprints deploy`
 
@@ -183,7 +183,7 @@ EXAMPLES
   $ sanity-run blueprints deploy --fn-installer npm
 ```
 
-_See code: [src/commands/blueprints/deploy.ts](https://github.com/sanity-io/runtime-cli/blob/v14.13.2/src/commands/blueprints/deploy.ts)_
+_See code: [src/commands/blueprints/deploy.ts](https://github.com/sanity-io/runtime-cli/blob/v14.13.4/src/commands/blueprints/deploy.ts)_
 
 ## `sanity-run blueprints destroy`
 
@@ -219,7 +219,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.13.2/src/commands/blueprints/destroy.ts)_
+_See code: [src/commands/blueprints/destroy.ts](https://github.com/sanity-io/runtime-cli/blob/v14.13.4/src/commands/blueprints/destroy.ts)_
 
 ## `sanity-run blueprints doctor`
 
@@ -251,7 +251,7 @@ EXAMPLES
   $ sanity-run blueprints doctor --fix
 ```
 
-_See code: [src/commands/blueprints/doctor.ts](https://github.com/sanity-io/runtime-cli/blob/v14.13.2/src/commands/blueprints/doctor.ts)_
+_See code: [src/commands/blueprints/doctor.ts](https://github.com/sanity-io/runtime-cli/blob/v14.13.4/src/commands/blueprints/doctor.ts)_
 
 ## `sanity-run blueprints info`
 
@@ -286,7 +286,7 @@ EXAMPLES
   $ sanity-run blueprints info --project-id <id> --stack <name-or-id>
 ```
 
-_See code: [src/commands/blueprints/info.ts](https://github.com/sanity-io/runtime-cli/blob/v14.13.2/src/commands/blueprints/info.ts)_
+_See code: [src/commands/blueprints/info.ts](https://github.com/sanity-io/runtime-cli/blob/v14.13.4/src/commands/blueprints/info.ts)_
 
 ## `sanity-run blueprints init [DIR]`
 
@@ -339,7 +339,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.13.2/src/commands/blueprints/init.ts)_
+_See code: [src/commands/blueprints/init.ts](https://github.com/sanity-io/runtime-cli/blob/v14.13.4/src/commands/blueprints/init.ts)_
 
 ## `sanity-run blueprints logs`
 
@@ -370,7 +370,7 @@ EXAMPLES
   $ sanity-run blueprints logs --watch
 ```
 
-_See code: [src/commands/blueprints/logs.ts](https://github.com/sanity-io/runtime-cli/blob/v14.13.2/src/commands/blueprints/logs.ts)_
+_See code: [src/commands/blueprints/logs.ts](https://github.com/sanity-io/runtime-cli/blob/v14.13.4/src/commands/blueprints/logs.ts)_
 
 ## `sanity-run blueprints plan`
 
@@ -398,7 +398,7 @@ EXAMPLES
   $ sanity-run blueprints plan
 ```
 
-_See code: [src/commands/blueprints/plan.ts](https://github.com/sanity-io/runtime-cli/blob/v14.13.2/src/commands/blueprints/plan.ts)_
+_See code: [src/commands/blueprints/plan.ts](https://github.com/sanity-io/runtime-cli/blob/v14.13.4/src/commands/blueprints/plan.ts)_
 
 ## `sanity-run blueprints stacks`
 
@@ -436,7 +436,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/v14.13.2/src/commands/blueprints/stacks.ts)_
+_See code: [src/commands/blueprints/stacks.ts](https://github.com/sanity-io/runtime-cli/blob/v14.13.4/src/commands/blueprints/stacks.ts)_
 
 ## `sanity-run functions add`
 
@@ -489,7 +489,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.13.2/src/commands/functions/add.ts)_
+_See code: [src/commands/functions/add.ts](https://github.com/sanity-io/runtime-cli/blob/v14.13.4/src/commands/functions/add.ts)_
 
 ## `sanity-run functions dev`
 
@@ -525,7 +525,7 @@ EXAMPLES
   $ sanity-run functions dev --timeout 60
 ```
 
-_See code: [src/commands/functions/dev.ts](https://github.com/sanity-io/runtime-cli/blob/v14.13.2/src/commands/functions/dev.ts)_
+_See code: [src/commands/functions/dev.ts](https://github.com/sanity-io/runtime-cli/blob/v14.13.4/src/commands/functions/dev.ts)_
 
 ## `sanity-run functions env add NAME KEY VALUE`
 
@@ -556,7 +556,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.13.2/src/commands/functions/env/add.ts)_
+_See code: [src/commands/functions/env/add.ts](https://github.com/sanity-io/runtime-cli/blob/v14.13.4/src/commands/functions/env/add.ts)_
 
 ## `sanity-run functions env list NAME`
 
@@ -584,7 +584,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.13.2/src/commands/functions/env/list.ts)_
+_See code: [src/commands/functions/env/list.ts](https://github.com/sanity-io/runtime-cli/blob/v14.13.4/src/commands/functions/env/list.ts)_
 
 ## `sanity-run functions env remove NAME KEY`
 
@@ -614,7 +614,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.13.2/src/commands/functions/env/remove.ts)_
+_See code: [src/commands/functions/env/remove.ts](https://github.com/sanity-io/runtime-cli/blob/v14.13.4/src/commands/functions/env/remove.ts)_
 
 ## `sanity-run functions logs [NAME]`
 
@@ -656,7 +656,7 @@ EXAMPLES
   $ sanity-run functions logs <name> --delete
 ```
 
-_See code: [src/commands/functions/logs.ts](https://github.com/sanity-io/runtime-cli/blob/v14.13.2/src/commands/functions/logs.ts)_
+_See code: [src/commands/functions/logs.ts](https://github.com/sanity-io/runtime-cli/blob/v14.13.4/src/commands/functions/logs.ts)_
 
 ## `sanity-run functions test [NAME]`
 
@@ -714,7 +714,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.13.2/src/commands/functions/test.ts)_
+_See code: [src/commands/functions/test.ts](https://github.com/sanity-io/runtime-cli/blob/v14.13.4/src/commands/functions/test.ts)_
 
 ## `sanity-run help [COMMAND]`
 

package/dist/actions/blueprints/blueprint.js

@@ -87,11 +87,11 @@ export async function loadBlueprintFile(fileInfo) {
                 break;
             }
             default:
-                throw Error(`Unsupported blueprint file extension: ${extension}`);
+                throw Error(`Unsupported Blueprint manifest extension: ${extension}`);
         }
     }
     catch (err) {
-        throw Error(`Unable to parse Blueprint file: ${fileName}\n${err}`);
+        throw Error(`Could not parse Blueprint manifest: ${fileName}\n${err}`);
     }
     // Dynamic modules: extract attached properties, then execute to get raw blueprint
     if (blueprintModule) {
@@ -100,15 +100,15 @@ export async function loadBlueprintFile(fileInfo) {
                 rawBlueprint = blueprintModule();
             }
             catch {
-                throw Error(`Error executing Blueprint file: ${fileName}`);
+                throw Error(`Error executing Blueprint manifest: ${fileName}`);
             }
         }
         else {
-            throw Error(`Blueprint ${fileName} must export a default function`);
+            throw Error(`Blueprint manifest ${fileName} must export a default function.`);
         }
     }
     if (typeof rawBlueprint === 'undefined') {
-        throw Error('Unable to read Blueprint');
+        throw Error('Could not read Blueprint manifest.');
     }
     return { rawBlueprint, module: blueprintModule };
 }
@@ -148,8 +148,9 @@ export function parseBlueprintContent(rawBlueprint, options) {
  */
 export async function loadAndParseBlueprint(blueprintPath, options = { validateResources: true }) {
     const fileInfo = findBlueprintFile(blueprintPath);
-    if (!fileInfo)
-        throw Error('Could not find Blueprint file! Use the `blueprints init` command.');
+    if (!fileInfo) {
+        throw Error('Could not find a Blueprint manifest (sanity.blueprint.ts, .js, or .json). Run `blueprints init` to create one.');
+    }
     const loaded = await loadBlueprintFile(fileInfo);
     const parsed = parseBlueprintContent(loaded.rawBlueprint, options);
     return {
@@ -169,8 +170,9 @@ export async function loadAndParseBlueprint(blueprintPath, options = { validateR
  */
 export async function readLocalBlueprint(logger, validate, blueprintPath) {
     const fileInfo = findBlueprintFile(blueprintPath);
-    if (!fileInfo)
-        throw Error('Could not find Blueprint file! Use the `blueprints init` command.');
+    if (!fileInfo) {
+        throw Error('Could not find a Blueprint manifest (sanity.blueprint.ts, .js, or .json). Run `blueprints init` to create one.');
+    }
     // 1. Load blueprint from disk
     const loaded = await loadBlueprintFile(fileInfo);
     const { rawBlueprint } = loaded;
@@ -226,7 +228,7 @@ export function writeBlueprintToDisk({ blueprintFilePath, jsonContent = JSON_BLU
             break;
         }
         default: {
-            throw Error(`Unsupported blueprint file extension: ${extension}`);
+            throw Error(`Unsupported Blueprint manifest extension: ${extension}`);
         }
     }
     mkdirSync(dir, { recursive: true });
@@ -236,7 +238,7 @@ export function writeBlueprintToDisk({ blueprintFilePath, jsonContent = JSON_BLU
 export function addResourceToBlueprint({ blueprintFilePath, resource, }) {
     const blueprintFile = findBlueprintFile(blueprintFilePath);
     if (!blueprintFile)
-        throw Error('Could not find Blueprint file');
+        throw Error('Could not find a Blueprint manifest.');
     const { blueprintFilePath: foundPath, extension } = blueprintFile;
     // modify .json files directly
     if (extension === '.json') {

package/dist/baseCommands.js

@@ -216,7 +216,7 @@ export class ResolvedCommand extends RuntimeCommand {
         let blueprintModule;
         if (needsBlueprint) {
             if (!blueprintFileInfo) {
-                this.error('Could not find Blueprint file! Use the `blueprints init` command.', {
+                this.error('Could not find a Blueprint manifest (sanity.blueprint.ts, .js, or .json).', {
                     suggestions: [
                         `Run \`${this.config.bin} blueprints init\` to create one.`,
                         `Run \`${this.config.bin} blueprints doctor\` to check your configuration.`,
@@ -229,9 +229,9 @@ export class ResolvedCommand extends RuntimeCommand {
             });
             if (parsed.errors.length > 0) {
                 log(presentBlueprintParserErrors(parsed.errors));
-                this.error('Blueprint file contains errors.', {
+                this.error('Blueprint manifest contains errors.', {
                     suggestions: [
-                        'Fix the Blueprint errors listed above.',
+                        'Fix the manifest errors listed above.',
                         `Run \`${this.config.bin} blueprints doctor\` to check your configuration.`,
                     ],
                 });
@@ -285,7 +285,7 @@ export class ResolvedCommand extends RuntimeCommand {
         // 5. Scope
         if (needsScope) {
             if (!resolved.scopeType || !resolved.scopeId) {
-                this.error('Missing scope: provide --project-id or --organization-id, or configure a Blueprint.', {
+                this.error('Missing scope: provide --project-id or --organization-id, or run `blueprints init` to create a Blueprint config (.sanity/blueprint.config.json).', {
                     suggestions: [
                         `Run \`${this.config.bin} blueprints doctor\` to check your configuration.`,
                     ],
@@ -307,7 +307,7 @@ export class ResolvedCommand extends RuntimeCommand {
                 stackId = await resolveStackIdByNameOrId(stackOverride, auth, log);
             }
             if (!stackId) {
-                this.error('Missing Stack: provide --stack, or configure a Blueprint with a Stack.', {
+                this.error(`Missing Stack: provide --stack, or set a Stack in your Blueprint config (\`${this.config.bin} blueprints config --edit\`).`, {
                     suggestions: [
                         `Run \`${this.config.bin} blueprints doctor\` to check your configuration.`,
                     ],

package/dist/cores/blueprints/config.js

@@ -12,10 +12,10 @@ export async function blueprintConfigCore(options) {
     const hasConfigFile = !!blueprintConfig;
     if (!configStackId && !configScopeType && !configScopeId) {
         if (hasConfigFile) {
-            log(warn('Incomplete configuration.'));
+            log(warn('Blueprint config (.sanity/blueprint.config.json) is incomplete.'));
         }
         else {
-            log('No configuration file found.');
+            log('No Blueprint config found at .sanity/blueprint.config.json.');
         }
         if (!editConfig) {
             log(`Run \`npx ${bin} blueprints doctor\` for diagnostics.`);
@@ -26,7 +26,7 @@ export async function blueprintConfigCore(options) {
         printConfig({ configLabel: 'Current', log, config: blueprintConfig });
     // passing new config without --edit flag is not allowed
     if (providedConfigFlag && !editConfig) {
-        log('To update the configuration, use the --edit flag.');
+        log('To update the Blueprint config, use the --edit flag.');
         return { success: true, json: blueprintConfig ? { config: blueprintConfig } : undefined };
     }
     if (!editConfig) {
@@ -70,7 +70,10 @@ export async function blueprintConfigCore(options) {
                     return { success: true, json: { config: newConfig } };
                 }
                 catch {
-                    return { success: false, error: 'Unable to update configuration.' };
+                    return {
+                        success: false,
+                        error: 'Could not update Blueprint config (.sanity/blueprint.config.json).',
+                    };
                 }
             }
         }
@@ -107,7 +110,10 @@ export async function blueprintConfigCore(options) {
             return { success: true, json: { config: newConfig } };
         }
         catch {
-            return { success: false, error: 'Unable to update configuration!' };
+            return {
+                success: false,
+                error: 'Could not update Blueprint config (.sanity/blueprint.config.json).',
+            };
         }
     }
 }

package/dist/cores/blueprints/doctor.js

@@ -15,7 +15,7 @@ import { blueprintConfigCore } from './config.js';
 const diagLookup = {
     online: 'Host online',
     tokenValid: 'Authenticated',
-    blueprintValid: 'Blueprint valid',
+    blueprintValid: 'Manifest valid',
     stackReady: 'Stack ready',
     userHasAccess: 'User has access',
 };
@@ -24,9 +24,9 @@ function sourceLabel(source) {
         case 'env':
             return 'environment';
         case 'module':
-            return 'blueprint module';
+            return 'manifest module';
         case 'config':
-            return 'config file';
+            return '.sanity/blueprint.config.json';
         case 'inferred':
             return 'inferred';
         default:
@@ -91,7 +91,7 @@ export async function blueprintDoctorCore(options) {
             blueprintConfig,
             ...resolved,
         };
-        envRows.push(['Blueprint', filePathRelativeToCwd(blueprint.fileInfo.blueprintFilePath)]);
+        envRows.push(['Manifest', filePathRelativeToCwd(blueprint.fileInfo.blueprintFilePath)]);
         if (blueprint.errors.length === 0) {
             diagnostics.blueprintValid = { status: true };
         }
@@ -129,7 +129,7 @@ export async function blueprintDoctorCore(options) {
             configRows.push(['Source', filePathRelativeToCwd(blueprintConfig.configPath)]);
         }
         else if (!blueprintConfig) {
-            configRows.push(['Source', styleText('dim', 'no config file')]);
+            configRows.push(['Source', styleText('dim', 'no .sanity/blueprint.config.json')]);
         }
         if (blueprintConfig?.updatedAt) {
             configRows.push(['Updated', new Date(blueprintConfig.updatedAt).toLocaleString('sv-SE')]);
@@ -315,8 +315,8 @@ export async function blueprintDoctorCore(options) {
         if (!localBlueprint) {
             return {
                 success: false,
-                error: `${errorMessage}. Unable to fix: Blueprint is missing or invalid`,
-                suggestions: [`Run \`npx ${bin} blueprints init\` to create a new Blueprint.`],
+                error: `${errorMessage}. Unable to fix: Blueprint manifest is missing or invalid`,
+                suggestions: [`Run \`npx ${bin} blueprints init\` to create a new Blueprint manifest.`],
                 data: { diagnostics: flatDiagnostics },
             };
         }

package/dist/cores/blueprints/promote.js

@@ -38,14 +38,14 @@ export async function blueprintPromoteCore(options) {
                 organizationId: stack.scopeId,
                 projectId: null,
             });
-            log('Blueprint configuration updated');
+            log('Blueprint config updated (.sanity/blueprint.config.json)');
         }
         catch {
             return {
                 success: false,
-                error: 'Stack promoted successfully but failed to update local Blueprint configuration. No config file found.',
+                error: 'Stack promoted, but could not update Blueprint config (.sanity/blueprint.config.json).',
                 suggestions: [
-                    `Run \`npx ${bin} blueprints config --edit\` to update your local configuration.`,
+                    `Run \`npx ${bin} blueprints config --edit\` to update your Blueprint config manually.`,
                 ],
             };
         }

package/dist/cores/functions/test.js

@@ -8,7 +8,7 @@ import buildPayload from '../../utils/build-payload.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';
+import { isEventType, } from '../../utils/types.js';
 export async function functionTestCore(options) {
     const { blueprint, log, error, args, flags, helpText } = options;
     const { name: fnName } = args;
@@ -53,9 +53,9 @@ export async function functionTestCore(options) {
                 functionResourceType: 'project',
                 functionResourceId: projectId || '',
             }
-            : {};
+            : { clientOptions: {} };
         // If the user sets the flag to use the real token set it in our options
-        if (withUserToken && isGroqContextOptions(contextOptions)) {
+        if (withUserToken) {
             contextOptions.clientOptions.token = config.token || undefined;
         }
         let before = null;

package/dist/cores/index.js

@@ -19,7 +19,7 @@ export async function initBlueprintConfig({ bin, log, token, validateResources =
     const blueprint = await readLocalBlueprint(log, { resources: validateResources }, blueprintPath);
     if (blueprint.errors.length > 0) {
         log(presentBlueprintParserErrors(blueprint.errors));
-        return { ok: false, error: 'Blueprint file contains errors.' };
+        return { ok: false, error: 'Blueprint manifest contains errors.' };
     }
     return {
         ok: true,

package/dist/utils/types.d.ts

@@ -124,7 +124,12 @@ export interface InvokeGroqContextOptions {
     /** The resource ID of the function container; resource ID that houses the function. */
     functionResourceId: string;
 }
-export type InvokeScheduleContextOptions = Record<string, never>;
+/** @internal */
+export interface InvokeScheduleContextOptions {
+    clientOptions: {
+        token?: string;
+    };
+}
 export type InvokeContextOptions = InvokeGroqContextOptions | InvokeScheduleContextOptions;
 export declare function isGroqContextOptions(context: InvokeContextOptions): context is InvokeGroqContextOptions;
 /** @internal */

package/oclif.manifest.json

@@ -2692,5 +2692,5 @@
       ]
     }
   },
-  "version": "14.13.2"
+  "version": "14.13.4"
 }

package/package.json

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