@sanity/runtime-cli 14.5.1 → 14.6.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/14.5.1 linux-x64 node-v24.14.0
+@sanity/runtime-cli/14.6.0 linux-x64 node-v24.14.0
 $ 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.5.1/src/commands/blueprints/add.ts)_
+_See code: [src/commands/blueprints/add.ts](https://github.com/sanity-io/runtime-cli/blob/v14.6.0/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.5.1/src/commands/blueprints/config.ts)_
+_See code: [src/commands/blueprints/config.ts](https://github.com/sanity-io/runtime-cli/blob/v14.6.0/src/commands/blueprints/config.ts)_
 
 ## `sanity-run blueprints deploy`
 
@@ -170,7 +170,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.5.1/src/commands/blueprints/deploy.ts)_
+_See code: [src/commands/blueprints/deploy.ts](https://github.com/sanity-io/runtime-cli/blob/v14.6.0/src/commands/blueprints/deploy.ts)_
 
 ## `sanity-run blueprints destroy`
 
@@ -202,7 +202,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.5.1/src/commands/blueprints/destroy.ts)_
+_See code: [src/commands/blueprints/destroy.ts](https://github.com/sanity-io/runtime-cli/blob/v14.6.0/src/commands/blueprints/destroy.ts)_
 
 ## `sanity-run blueprints doctor`
 
@@ -228,7 +228,7 @@ DESCRIPTION
   issues.
 ```
 
-_See code: [src/commands/blueprints/doctor.ts](https://github.com/sanity-io/runtime-cli/blob/v14.5.1/src/commands/blueprints/doctor.ts)_
+_See code: [src/commands/blueprints/doctor.ts](https://github.com/sanity-io/runtime-cli/blob/v14.6.0/src/commands/blueprints/doctor.ts)_
 
 ## `sanity-run blueprints info`
 
@@ -258,7 +258,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.5.1/src/commands/blueprints/info.ts)_
+_See code: [src/commands/blueprints/info.ts](https://github.com/sanity-io/runtime-cli/blob/v14.6.0/src/commands/blueprints/info.ts)_
 
 ## `sanity-run blueprints init [DIR]`
 
@@ -308,7 +308,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.5.1/src/commands/blueprints/init.ts)_
+_See code: [src/commands/blueprints/init.ts](https://github.com/sanity-io/runtime-cli/blob/v14.6.0/src/commands/blueprints/init.ts)_
 
 ## `sanity-run blueprints logs`
 
@@ -337,7 +337,7 @@ EXAMPLES
   $ sanity-run blueprints logs --watch
 ```
 
-_See code: [src/commands/blueprints/logs.ts](https://github.com/sanity-io/runtime-cli/blob/v14.5.1/src/commands/blueprints/logs.ts)_
+_See code: [src/commands/blueprints/logs.ts](https://github.com/sanity-io/runtime-cli/blob/v14.6.0/src/commands/blueprints/logs.ts)_
 
 ## `sanity-run blueprints plan`
 
@@ -363,7 +363,7 @@ EXAMPLES
   $ sanity-run blueprints plan
 ```
 
-_See code: [src/commands/blueprints/plan.ts](https://github.com/sanity-io/runtime-cli/blob/v14.5.1/src/commands/blueprints/plan.ts)_
+_See code: [src/commands/blueprints/plan.ts](https://github.com/sanity-io/runtime-cli/blob/v14.6.0/src/commands/blueprints/plan.ts)_
 
 ## `sanity-run blueprints stacks`
 
@@ -392,7 +392,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.5.1/src/commands/blueprints/stacks.ts)_
+_See code: [src/commands/blueprints/stacks.ts](https://github.com/sanity-io/runtime-cli/blob/v14.6.0/src/commands/blueprints/stacks.ts)_
 
 ## `sanity-run functions add`
 
@@ -441,7 +441,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.5.1/src/commands/functions/add.ts)_
+_See code: [src/commands/functions/add.ts](https://github.com/sanity-io/runtime-cli/blob/v14.6.0/src/commands/functions/add.ts)_
 
 ## `sanity-run functions dev`
 
@@ -475,7 +475,7 @@ EXAMPLES
   $ sanity-run functions dev --timeout 60
 ```
 
-_See code: [src/commands/functions/dev.ts](https://github.com/sanity-io/runtime-cli/blob/v14.5.1/src/commands/functions/dev.ts)_
+_See code: [src/commands/functions/dev.ts](https://github.com/sanity-io/runtime-cli/blob/v14.6.0/src/commands/functions/dev.ts)_
 
 ## `sanity-run functions env add NAME KEY VALUE`
 
@@ -502,7 +502,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.5.1/src/commands/functions/env/add.ts)_
+_See code: [src/commands/functions/env/add.ts](https://github.com/sanity-io/runtime-cli/blob/v14.6.0/src/commands/functions/env/add.ts)_
 
 ## `sanity-run functions env list NAME`
 
@@ -526,7 +526,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.5.1/src/commands/functions/env/list.ts)_
+_See code: [src/commands/functions/env/list.ts](https://github.com/sanity-io/runtime-cli/blob/v14.6.0/src/commands/functions/env/list.ts)_
 
 ## `sanity-run functions env remove NAME KEY`
 
@@ -552,7 +552,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.5.1/src/commands/functions/env/remove.ts)_
+_See code: [src/commands/functions/env/remove.ts](https://github.com/sanity-io/runtime-cli/blob/v14.6.0/src/commands/functions/env/remove.ts)_
 
 ## `sanity-run functions logs [NAME]`
 
@@ -592,7 +592,7 @@ EXAMPLES
   $ sanity-run functions logs <name> --delete
 ```
 
-_See code: [src/commands/functions/logs.ts](https://github.com/sanity-io/runtime-cli/blob/v14.5.1/src/commands/functions/logs.ts)_
+_See code: [src/commands/functions/logs.ts](https://github.com/sanity-io/runtime-cli/blob/v14.6.0/src/commands/functions/logs.ts)_
 
 ## `sanity-run functions test [NAME]`
 
@@ -646,7 +646,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.5.1/src/commands/functions/test.ts)_
+_See code: [src/commands/functions/test.ts](https://github.com/sanity-io/runtime-cli/blob/v14.6.0/src/commands/functions/test.ts)_
 
 ## `sanity-run help [COMMAND]`
 
@@ -666,5 +666,5 @@ DESCRIPTION
   Display help for sanity-run.
 ```
 
-_See code: [@oclif/plugin-help](https://github.com/oclif/plugin-help/blob/v6.2.37/src/commands/help.ts)_
+_See code: [@oclif/plugin-help](https://github.com/oclif/plugin-help/blob/6.2.38/src/commands/help.ts)_
 <!-- commandsstop -->

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

@@ -29,17 +29,22 @@ export declare function writeConfigFile(blueprintFilePath: string, options: {
     organizationId?: string;
     projectId?: string;
 }): BlueprintsConfig;
+export interface ConfigPatch {
+    organizationId?: string | null;
+    projectId?: string | null;
+    stackId?: string;
+}
 /**
  * Update the config file with the given properties.
  * Config file must already exist.
  * Adds timestamp. No validation or transformation is performed.
  * @param blueprintFilePath - the path to the blueprint file
  * @param updateableProperties - the properties to update
- * @param updateableProperties.organizationId - the organization ID
- * @param updateableProperties.projectId - the project ID
+ * @param updateableProperties.organizationId - the organization ID (null to remove)
+ * @param updateableProperties.projectId - the project ID (null to remove)
  * @param updateableProperties.stackId - the stack ID
  */
-export declare function patchConfigFile(blueprintFilePath: string, updateableProperties: ConfigUpdate): BlueprintsConfig;
+export declare function patchConfigFile(blueprintFilePath: string, updateableProperties: ConfigPatch): BlueprintsConfig;
 /**
  * Find and write an organizationId to the config file by getting it from the projectId
  * @throws {Error} if unable to fetch project

package/dist/actions/blueprints/config.js

@@ -57,8 +57,8 @@ export function writeConfigFile(blueprintFilePath, options) {
  * Adds timestamp. No validation or transformation is performed.
  * @param blueprintFilePath - the path to the blueprint file
  * @param updateableProperties - the properties to update
- * @param updateableProperties.organizationId - the organization ID
- * @param updateableProperties.projectId - the project ID
+ * @param updateableProperties.organizationId - the organization ID (null to remove)
+ * @param updateableProperties.projectId - the project ID (null to remove)
  * @param updateableProperties.stackId - the stack ID
  */
 export function patchConfigFile(blueprintFilePath, updateableProperties) {
@@ -66,13 +66,15 @@ export function patchConfigFile(blueprintFilePath, updateableProperties) {
     if (!existingConfig)
         throw new Error('No config file found');
     const { configPath, ...existingConfigProperties } = existingConfig;
-    const newConfig = {
+    const merged = {
         blueprintConfigVersion: BLUEPRINT_CONFIG_VERSION, // patch doesn't overwrite versions
         runtimeCliVersion: RUNTIME_CLI_VERSION,
         ...existingConfigProperties,
         ...updateableProperties,
         updatedAt: Date.now(),
     };
+    // remove value if set to null
+    const newConfig = Object.fromEntries(Object.entries(merged).filter(([_, v]) => v !== null));
     writeFileSync(configPath, JSON.stringify(newConfig, null, 2));
     return newConfig;
 }

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

@@ -107,6 +107,18 @@ interface DestroyStackResponse {
     stack: Stack;
 }
 export declare function resolveStackIdByNameOrId(value: string, auth: AuthParams, logger: ReturnType<typeof Logger>): Promise<string>;
+interface PromoteStackResponse {
+    ok: boolean;
+    error: string | null;
+    stack: Stack & {
+        alreadyPromoted: boolean;
+    };
+}
+export declare function promoteStack({ stackId, auth, logger, }: {
+    stackId: string;
+    auth: AuthParams;
+    logger: ReturnType<typeof Logger>;
+}): Promise<PromoteStackResponse>;
 export declare function destroyStack({ stackId, auth, logger, }: {
     stackId: string;
     auth: AuthParams;

package/dist/actions/blueprints/stacks.js

@@ -94,8 +94,9 @@ export async function planStack({ stackId, document, auth, logger, }) {
     return { ok: true, error: null, problems: null, deploymentPlan: data };
 }
 export async function resolveStackIdByNameOrId(value, auth, logger) {
-    if (value.startsWith('ST-') && value.length === 13)
+    if (value.startsWith('ST-') && (value.length === 13 || value.length === 11))
         return value;
+    //     ID prefixed w 'ST-'         standard IDs: 13    old project IDs: 11
     const result = await listStacks(auth, logger);
     if (!result.ok)
         throw new Error(result.error || 'Failed to list stacks');
@@ -104,6 +105,19 @@ export async function resolveStackIdByNameOrId(value, auth, logger) {
         throw new Error(`No stack found with name "${value}"`);
     return match.id;
 }
+export async function promoteStack({ stackId, auth, logger, }) {
+    const fetchFn = createTracedFetch(logger);
+    const response = await fetchFn(`${stacksUrl}/${stackId}/promote`, {
+        method: 'POST',
+        headers: getHeaders(auth),
+    });
+    const data = await response.json();
+    return {
+        ok: response.ok,
+        error: response.ok ? null : data.message,
+        stack: data,
+    };
+}
 export async function destroyStack({ stackId, auth, logger, }) {
     const fetchFn = createTracedFetch(logger);
     const response = await fetchFn(`${stacksUrl}/${stackId}`, {

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

@@ -7,5 +7,5 @@ export default class LogsCommand extends DeployedStackCommand<typeof LogsCommand
         stack: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         watch: import("@oclif/core/interfaces").BooleanFlag<boolean>;
     };
-    run(): Promise<void>;
+    run(): Promise<void | Record<string, unknown>>;
 }

package/dist/commands/blueprints/logs.js

@@ -22,7 +22,7 @@ If you're not seeing expected logs, verify your Stack is deployed with 'blueprin
         }),
     };
     async run() {
-        const { success, streaming, error } = await blueprintLogsCore({
+        const { success, streaming, error, json } = await blueprintLogsCore({
             bin: this.config.bin,
             log: Logger(this.log.bind(this), this.flags),
             auth: this.auth,
@@ -35,5 +35,6 @@ If you're not seeing expected logs, verify your Stack is deployed with 'blueprin
             return streaming;
         if (!success)
             this.error(error);
+        return json;
     }
 }

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

@@ -0,0 +1,13 @@
+import { DeployedStackCommand } from '../../baseCommands.js';
+export default class PromoteCommand extends DeployedStackCommand<typeof PromoteCommand> {
+    static summary: string;
+    static description: string;
+    static hidden: boolean;
+    static examples: string[];
+    static flags: {
+        stack: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'i-know-what-im-doing': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        force: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<Record<string, unknown> | undefined>;
+}

package/dist/commands/blueprints/promote.js

@@ -0,0 +1,45 @@
+import { Flags } from '@oclif/core';
+import { DeployedStackCommand } from '../../baseCommands.js';
+import { blueprintPromoteCore } from '../../cores/blueprints/promote.js';
+import { Logger } from '../../utils/logger.js';
+export default class PromoteCommand extends DeployedStackCommand {
+    static summary = 'Promote a Stack deployment to a broader scope';
+    static description = `EXPERIMENTAL! Promotes a Stack, changing its scope from project to organization. This is a one-way trip.`;
+    static hidden = true;
+    static examples = [
+        '<%= config.bin %> <%= command.id %>',
+        '<%= config.bin %> <%= command.id %> --stack <name-or-id>',
+    ];
+    static flags = {
+        stack: Flags.string({
+            description: 'Stack name or ID to promote',
+            aliases: ['id'],
+        }),
+        'i-know-what-im-doing': Flags.boolean({
+            description: 'Must be set',
+            default: false,
+        }),
+        force: Flags.boolean({
+            description: 'Skip confirmation prompt',
+            default: false,
+        }),
+    };
+    async run() {
+        const { success, error, data } = await blueprintPromoteCore({
+            bin: this.config.bin,
+            log: Logger(this.log.bind(this), this.flags),
+            token: this.sanityToken,
+            blueprint: this.blueprint,
+            stackId: this.stackId,
+            scopeType: this.scopeType,
+            scopeId: this.scopeId,
+            deployedStack: this.deployedStack,
+            auth: this.auth,
+            validateResources: this.flags['validate-resources'],
+            flags: this.flags,
+        });
+        if (!success)
+            this.error(error);
+        return data;
+    }
+}

package/dist/commands/functions/logs.d.ts

@@ -15,5 +15,5 @@ export default class LogsCommand extends DeployedStackCommand<typeof LogsCommand
         force: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         watch: import("@oclif/core/interfaces").BooleanFlag<boolean>;
     };
-    run(): Promise<void>;
+    run(): Promise<Record<string, unknown> | undefined>;
 }

package/dist/commands/functions/logs.js

@@ -53,7 +53,7 @@ Use --watch (-w) to stream logs in real-time. Use --delete to clear all logs for
         }),
     };
     async run() {
-        const { success, error } = await functionLogsCore({
+        const { success, error, json } = await functionLogsCore({
             bin: this.config.bin,
             log: Logger(this.log.bind(this), this.flags),
             error: (msg, options) => this.error(msg, options),
@@ -71,5 +71,6 @@ Use --watch (-w) to stream logs in real-time. Use --delete to clear all logs for
         });
         if (!success)
             this.error(error);
+        return json;
     }
 }

package/dist/constants.d.ts

@@ -17,6 +17,8 @@ export declare const EVENT_MEDIA_LIBRARY_ASSET_UPDATE = "media-library-asset-upd
 export declare const EVENT_MEDIA_LIBRARY_ASSET_DELETE = "media-library-asset-delete";
 export declare const EVENT_SCHEDULED = "scheduled-function";
 export declare const FUNCTION_TYPES: string[];
+export declare const PROJECT_SCOPED_FUNCTION_TYPES: ReadonlySet<string>;
+export declare const ORGANIZATION_SCOPED_FUNCTION_TYPES: ReadonlySet<string>;
 export declare const MAX_ASSET_SIZE = 209715200;
 export declare const CONVERT_BYTES_TO_MB = 1048576;
 export declare const LABEL_DOCUMENT_CREATE = "Document Create";

package/dist/constants.js

@@ -26,6 +26,13 @@ export const FUNCTION_TYPES = [
     EVENT_MEDIA_LIBRARY_ASSET_DELETE,
     EVENT_SCHEDULED,
 ];
+export const PROJECT_SCOPED_FUNCTION_TYPES = new Set([
+    SANITY_FUNCTION_DOCUMENT,
+    SANITY_FUNCTION_MEDIA_LIBRARY_ASSET,
+]);
+export const ORGANIZATION_SCOPED_FUNCTION_TYPES = new Set([
+    SANITY_FUNCTION_SCHEDULED,
+]);
 export const MAX_ASSET_SIZE = 209_715_200; // 200 MB in bytes
 export const CONVERT_BYTES_TO_MB = 1_048_576; // Used to convert bytes to megabytes (1024 * 1024)
 export const LABEL_DOCUMENT_CREATE = 'Document Create';

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

@@ -14,5 +14,7 @@ export type { BlueprintLogsOptions } from './logs.js';
 export { blueprintLogsCore } from './logs.js';
 export type { BlueprintPlanOptions } from './plan.js';
 export { blueprintPlanCore } from './plan.js';
+export type { BlueprintPromoteOptions } from './promote.js';
+export { blueprintPromoteCore } from './promote.js';
 export type { BlueprintStacksOptions } from './stacks.js';
 export { blueprintStacksCore } from './stacks.js';

package/dist/cores/blueprints/index.js

@@ -6,4 +6,5 @@ export { blueprintInfoCore } from './info.js';
 export { blueprintInitCore } from './init.js';
 export { blueprintLogsCore } from './logs.js';
 export { blueprintPlanCore } from './plan.js';
+export { blueprintPromoteCore } from './promote.js';
 export { blueprintStacksCore } from './stacks.js';

package/dist/cores/blueprints/logs.js

@@ -58,7 +58,7 @@ export async function blueprintLogsCore(options) {
         spinner.succeed(`${formatTitle('Blueprint', deployedStack.name)} Logs`);
         log(`Found ${styleText('bold', logs.length.toString())} log entries for Stack deployment ${niceId(stackId)}\n`);
         log(formatLogs(logs, verbose));
-        return { success: true };
+        return { success: true, json: { logs } };
     }
     catch (err) {
         spinner.fail('Failed to retrieve Stack deployment logs');

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

@@ -0,0 +1,9 @@
+import type { CoreResult, DeployedBlueprintConfig } from '../index.js';
+export interface BlueprintPromoteOptions extends DeployedBlueprintConfig {
+    flags: {
+        'i-know-what-im-doing': boolean;
+        force?: boolean;
+        verbose?: boolean;
+    };
+}
+export declare function blueprintPromoteCore(options: BlueprintPromoteOptions): Promise<CoreResult>;

package/dist/cores/blueprints/promote.js

@@ -0,0 +1,50 @@
+import { confirm } from '@inquirer/prompts';
+import { patchConfigFile } from '../../actions/blueprints/config.js';
+import { promoteStack } from '../../actions/blueprints/stacks.js';
+import { niceId } from '../../utils/display/presenters.js';
+export async function blueprintPromoteCore(options) {
+    const { log, stackId, auth, flags, deployedStack, blueprint } = options;
+    if (!flags['i-know-what-im-doing']) {
+        return { success: false, error: 'Seems you do not know what you are doing.' };
+    }
+    let message = `"${deployedStack.name}" ${niceId(deployedStack.id)}`;
+    if (deployedStack.scopeType === 'organization') {
+        message = `Stack ${message} is already org-scoped. Promote again?`;
+    }
+    else {
+        message = `Are you sure you want to promote Stack ${message}?`;
+    }
+    if (!flags.force) {
+        const confirmed = await confirm({ message });
+        if (!confirmed) {
+            return { success: false, error: 'Promotion cancelled by user' };
+        }
+    }
+    try {
+        const { ok, error, stack } = await promoteStack({ stackId, auth, logger: log });
+        if (!ok) {
+            return { success: false, error: error || 'Failed to promote Stack' };
+        }
+        log(`Stack "${stack.name}" ${niceId(stack.id)} promoted successfully`);
+        const { blueprintFilePath } = blueprint.fileInfo;
+        try {
+            patchConfigFile(blueprintFilePath, {
+                stackId: stack.id,
+                organizationId: stack.scopeId,
+                projectId: null,
+            });
+            log('Blueprint configuration updated');
+        }
+        catch {
+            return {
+                success: false,
+                error: 'Stack promoted successfully but failed to update local Blueprint configuration. No config file found.',
+            };
+        }
+        return { success: true, data: { stack } };
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        return { success: false, error: errorMessage };
+    }
+}

package/dist/cores/functions/add.js

@@ -21,7 +21,7 @@ const generateFunctionBlueprintResourceTemplate = (fnName, eventNames) => {
             definer = `defineMediaLibraryAssetFunction({name: '${fnName}', event: {on: [${eventOns.join(', ')}], resource: {type: 'media-library', id: 'my-media-library-id'}}}), // ← add this line`;
             break;
         case 'scheduled':
-            definer = `defineScheduleFunction({name: '${fnName}', event: {expression: '0 0 * * *'}}), // ← add this line`;
+            definer = `defineScheduledFunction({name: '${fnName}', event: {expression: '0 0 * * *'}}), // ← add this line`;
             break;
     }
     return `

package/dist/cores/functions/env/add.js

@@ -1,11 +1,14 @@
 import { update } from '../../../actions/functions/env/update.js';
 import { findFunctionInStack } from '../../../utils/find-function.js';
+import { resolveFunctionAuth } from '../../../utils/functions/resolve-function-auth.js';
 import { styleText } from '../../../utils/style-text.js';
 export async function functionEnvAddCore(options) {
     const { args, log } = options;
     const spinner = log.ora(`Updating "${args.key}" environment variable in "${args.name}"`).start();
-    const { externalId } = findFunctionInStack(options.deployedStack, args.name);
-    const result = await update(externalId, args.key, args.value, options.auth, options.log);
+    const resource = findFunctionInStack(options.deployedStack, args.name);
+    const { externalId } = resource;
+    const auth = resolveFunctionAuth(options.auth, options.deployedStack, resource);
+    const result = await update(externalId, args.key, args.value, auth, options.log);
     if (!result.ok) {
         spinner.fail(`${styleText('red', 'Failed')} to update ${args.key}`);
         return {

package/dist/cores/functions/env/list.js

@@ -1,10 +1,13 @@
 import { list } from '../../../actions/functions/env/list.js';
 import { findFunctionInStack } from '../../../utils/find-function.js';
+import { resolveFunctionAuth } from '../../../utils/functions/resolve-function-auth.js';
 export async function functionEnvListCore(options) {
     const { args, log } = options;
     const spinner = log.ora(`Listing environment variables for "${args.name}"`).start();
-    const { externalId } = findFunctionInStack(options.deployedStack, args.name);
-    const result = await list(externalId, options.auth, options.log);
+    const resource = findFunctionInStack(options.deployedStack, args.name);
+    const { externalId } = resource;
+    const auth = resolveFunctionAuth(options.auth, options.deployedStack, resource);
+    const result = await list(externalId, auth, options.log);
     if (!result.ok) {
         spinner.stop();
         return { success: false, error: result.error || 'Unknown error' };

package/dist/cores/functions/env/remove.js

@@ -1,11 +1,14 @@
 import { remove } from '../../../actions/functions/env/remove.js';
 import { findFunctionInStack } from '../../../utils/find-function.js';
+import { resolveFunctionAuth } from '../../../utils/functions/resolve-function-auth.js';
 import { styleText } from '../../../utils/style-text.js';
 export async function functionEnvRemoveCore(options) {
     const { args, log } = options;
     const spinner = log.ora(`Removing "${args.key}" environment variable in "${args.name}"`).start();
-    const { externalId } = findFunctionInStack(options.deployedStack, args.name);
-    const result = await remove(externalId, args.key, options.auth, options.log);
+    const resource = findFunctionInStack(options.deployedStack, args.name);
+    const { externalId } = resource;
+    const auth = resolveFunctionAuth(options.auth, options.deployedStack, resource);
+    const result = await remove(externalId, args.key, auth, options.log);
     if (!result.ok) {
         spinner.fail(`${styleText('red', 'Failed')} to remove ${args.key}`);
         return { success: false, error: result.error || 'Unknown error' };

package/dist/cores/functions/logs.js

@@ -3,9 +3,10 @@ import { deleteLogs as deleteLogsAction, logs as getLogsAction, streamLogs as st
 import { formatTitle } from '../../utils/display/blueprints-formatting.js';
 import { niceId } from '../../utils/display/presenters.js';
 import { findFunctionInStack, getFunctionNames } from '../../utils/find-function.js';
+import { resolveFunctionAuth } from '../../utils/functions/resolve-function-auth.js';
 import { styleText } from '../../utils/style-text.js';
 export async function functionLogsCore(options) {
-    const { args, flags, log, error, auth, deployedStack, blueprint, helpText } = options;
+    const { args, flags, log, error, deployedStack, blueprint, helpText } = options;
     const { name } = args;
     const { delete: shouldDelete, watch: shouldWatch, force, limit, json, utc } = flags;
     if (!name) {
@@ -17,7 +18,9 @@ export async function functionLogsCore(options) {
         log(helpText);
         return { success: true };
     }
-    const { externalId } = findFunctionInStack(deployedStack, name); // throws if not found
+    const resource = findFunctionInStack(deployedStack, name); // throws if not found
+    const { externalId } = resource;
+    const auth = resolveFunctionAuth(options.auth, deployedStack, resource);
     if (shouldDelete)
         return deleteLogs({ name, externalId, auth, force, log });
     if (shouldWatch)
@@ -94,7 +97,7 @@ async function getLogs({ name, externalId, auth, limit, json, utc, log, }) {
         }
     }
     else {
-        log(JSON.stringify(filteredLogs, null, 2));
+        return { success: true, json: { logs: filteredLogs } };
     }
     return { success: true };
 }

package/dist/cores/index.d.ts

@@ -33,12 +33,14 @@ export type CoreResult = {
     /** The error message, if the operation failed. */
     error: string;
     streaming?: never;
+    json?: never;
 } | {
     /** Everything went well. */
     success: true;
     /** The streaming function, if the operation is streaming. */
     streaming?: Promise<void>;
     error?: never;
+    json?: Record<string, unknown>;
 });
 type InitBlueprintConfigParams = CoreConfig & ({
     validateToken: true;

package/dist/index.d.ts

@@ -8,6 +8,7 @@ export { default as BlueprintsInfoCommand } from './commands/blueprints/info.js'
 export { default as BlueprintsInitCommand } from './commands/blueprints/init.js';
 export { default as BlueprintsLogsCommand } from './commands/blueprints/logs.js';
 export { default as BlueprintsPlanCommand } from './commands/blueprints/plan.js';
+export { default as BlueprintsPromoteCommand } from './commands/blueprints/promote.js';
 export { default as BlueprintsStacksCommand } from './commands/blueprints/stacks.js';
 export { default as FunctionsAddCommand } from './commands/functions/add.js';
 export { default as FunctionsDevCommand } from './commands/functions/dev.js';

package/dist/index.js

@@ -9,6 +9,7 @@ export { default as BlueprintsInfoCommand } from './commands/blueprints/info.js'
 export { default as BlueprintsInitCommand } from './commands/blueprints/init.js';
 export { default as BlueprintsLogsCommand } from './commands/blueprints/logs.js';
 export { default as BlueprintsPlanCommand } from './commands/blueprints/plan.js';
+export { default as BlueprintsPromoteCommand } from './commands/blueprints/promote.js';
 export { default as BlueprintsStacksCommand } from './commands/blueprints/stacks.js';
 // Functions command classes
 export { default as FunctionsAddCommand } from './commands/functions/add.js';

package/dist/server/static/vendor/vendor.bundle.js

@@ -5839,11 +5839,11 @@ class SelectionRange {
     /**
     Extend this range to cover at least `from` to `to`.
     */
-    extend(from, to = from) {
+    extend(from, to = from, assoc = 0) {
         if (from <= this.anchor && to >= this.anchor)
-            return EditorSelection.range(from, to);
+            return EditorSelection.range(from, to, undefined, undefined, assoc);
         let head = Math.abs(from - this.anchor) > Math.abs(to - this.anchor) ? from : to;
-        return EditorSelection.range(this.anchor, head);
+        return EditorSelection.range(this.anchor, head, undefined, undefined, assoc);
     }
     /**
     Compare this range to another range.
@@ -5990,11 +5990,13 @@ class EditorSelection {
     /**
     Create a selection range.
     */
-    static range(anchor, head, goalColumn, bidiLevel) {
+    static range(anchor, head, goalColumn, bidiLevel, assoc) {
         let flags = ((goalColumn !== null && goalColumn !== void 0 ? goalColumn : 16777215 /* RangeFlag.NoGoalColumn */) << 6 /* RangeFlag.GoalColumnOffset */) |
             (bidiLevel == null ? 7 : Math.min(6, bidiLevel));
+        if (!assoc && anchor != head)
+            assoc = head < anchor ? 1 : -1;
         return head < anchor ? SelectionRange.create(head, anchor, 32 /* RangeFlag.Inverted */ | 16 /* RangeFlag.AssocAfter */ | flags)
-            : SelectionRange.create(anchor, head, (head > anchor ? 8 /* RangeFlag.AssocBefore */ : 0) | flags);
+            : SelectionRange.create(anchor, head, (!assoc ? 0 : assoc < 0 ? 8 /* RangeFlag.AssocBefore */ : 16 /* RangeFlag.AssocAfter */) | flags);
     }
     /**
     @internal

package/dist/utils/functions/resolve-function-auth.d.ts

@@ -0,0 +1,9 @@
+import type { AuthParams, DeployedResource, Stack } from '../types.js';
+/**
+ * Resolves the correct auth scope for a function API request.
+ *
+ * 1. explicit `project` or `organization` on the resource parameters (highest priority)
+ * 2. stack's `defaultProjectId` for project-scoped function types in org-scoped stacks
+ * 3. pass-through the stack's deployment scope (lowest priority)
+ */
+export declare function resolveFunctionAuth(auth: AuthParams, deployedStack: Stack, resource: DeployedResource): AuthParams;

package/dist/utils/functions/resolve-function-auth.js

@@ -0,0 +1,36 @@
+import { ORGANIZATION_SCOPED_FUNCTION_TYPES, PROJECT_SCOPED_FUNCTION_TYPES } from '../../constants.js';
+/**
+ * Resolves the correct auth scope for a function API request.
+ *
+ * 1. explicit `project` or `organization` on the resource parameters (highest priority)
+ * 2. stack's `defaultProjectId` for project-scoped function types in org-scoped stacks
+ * 3. pass-through the stack's deployment scope (lowest priority)
+ */
+export function resolveFunctionAuth(auth, deployedStack, resource) {
+    // 1. explicit resource-level scope takes highest priority
+    if (typeof resource.parameters.project === 'string') {
+        return { ...auth, scopeType: 'project', scopeId: resource.parameters.project };
+    }
+    if (typeof resource.parameters.organization === 'string') {
+        return { ...auth, scopeType: 'organization', scopeId: resource.parameters.organization };
+    }
+    // 2. project-scoped function types: resolve a project ID or fail
+    if (PROJECT_SCOPED_FUNCTION_TYPES.has(resource.type)) {
+        if (auth.scopeType === 'project')
+            return auth;
+        if (deployedStack.defaultProjectId) {
+            return { ...auth, scopeType: 'project', scopeId: deployedStack.defaultProjectId };
+        }
+        throw new Error(`Function "${resource.name}" (${resource.type}) requires project scope, but no project ID could be resolved. ` +
+            'Set the `project` attribute on the function resource.');
+    }
+    // 3. Organization-scoped function types: must be in an org-scoped stack
+    if (ORGANIZATION_SCOPED_FUNCTION_TYPES.has(resource.type)) {
+        if (auth.scopeType === 'organization')
+            return auth;
+        throw new Error(`Function "${resource.name}" (${resource.type}) requires organization scope, ` +
+            'but the current blueprint is project-scoped.');
+    }
+    // 4. Unknown type; pass it along (don't break on future types)
+    return auth;
+}

package/dist/utils/types.d.ts

@@ -121,6 +121,7 @@ interface StackBase {
     displayName: string;
     scopeType: ScopeType;
     scopeId: string;
+    defaultProjectId: string | null;
     recentOperation?: StackOperation;
     createdAt?: string;
     updatedAt?: string;

package/oclif.manifest.json

@@ -1031,6 +1031,97 @@
         "plan.js"
       ]
     },
+    "blueprints:promote": {
+      "aliases": [],
+      "args": {},
+      "description": "EXPERIMENTAL! Promotes a Stack, changing its scope from project to organization. This is a one-way trip.",
+      "examples": [
+        "<%= config.bin %> <%= command.id %>",
+        "<%= config.bin %> <%= command.id %> --stack <name-or-id>"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "hidden": true,
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "path": {
+          "aliases": [
+            "blueprint-path"
+          ],
+          "char": "p",
+          "description": "Path to a Blueprint file or directory containing one",
+          "env": "SANITY_BLUEPRINT_PATH",
+          "hidden": true,
+          "name": "path",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "trace": {
+          "description": "Trace output",
+          "hidden": true,
+          "name": "trace",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "validate-resources": {
+          "description": "Validate resources",
+          "hidden": true,
+          "name": "validate-resources",
+          "allowNo": true,
+          "type": "boolean"
+        },
+        "verbose": {
+          "description": "Verbose output",
+          "hidden": true,
+          "name": "verbose",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "stack": {
+          "aliases": [
+            "id"
+          ],
+          "description": "Stack name or ID to promote",
+          "name": "stack",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "i-know-what-im-doing": {
+          "description": "Must be set",
+          "name": "i-know-what-im-doing",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "force": {
+          "description": "Skip confirmation prompt",
+          "name": "force",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hidden": true,
+      "hiddenAliases": [],
+      "id": "blueprints:promote",
+      "pluginAlias": "@sanity/runtime-cli",
+      "pluginName": "@sanity/runtime-cli",
+      "pluginType": "core",
+      "strict": true,
+      "summary": "Promote a Stack deployment to a broader scope",
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "blueprints",
+        "promote.js"
+      ]
+    },
     "blueprints:stacks": {
       "aliases": [],
       "args": {},
@@ -2198,5 +2289,5 @@
       ]
     }
   },
-  "version": "14.5.1"
+  "version": "14.6.0"
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@sanity/runtime-cli",
   "description": "Sanity's Runtime CLI for Blueprints and Functions",
-  "version": "14.5.1",
+  "version": "14.6.0",
   "author": "Sanity Runtime Team",
   "type": "module",
   "license": "MIT",
@@ -100,38 +100,38 @@
   "dependencies": {
     "@architect/hydrate": "^5.0.2",
     "@architect/inventory": "^5.0.0",
-    "@inquirer/prompts": "^8.2.1",
-    "@oclif/core": "^4.8.0",
-    "@oclif/plugin-help": "^6.2.37",
+    "@inquirer/prompts": "^8.3.2",
+    "@oclif/core": "^4.9.0",
+    "@oclif/plugin-help": "^6.2.38",
     "@sanity/blueprints": "^0.13.1",
     "@sanity/blueprints-parser": "^0.4.0",
-    "@sanity/client": "^7.15.0",
+    "@sanity/client": "^7.17.0",
     "adm-zip": "^0.5.16",
     "array-treeify": "^0.1.5",
     "cardinal": "^2.1.1",
     "empathic": "^2.0.0",
     "eventsource": "^4.1.0",
-    "groq-js": "^1.27.1",
+    "groq-js": "^1.29.0",
     "jiti": "^2.6.1",
     "mime-types": "^3.0.2",
     "ora": "^9.3.0",
-    "tar-stream": "^3.1.7",
+    "tar-stream": "^3.1.8",
     "vite": "^7.3.1",
     "vite-tsconfig-paths": "^6.1.1",
     "ws": "^8.19.0",
     "xdg-basedir": "^5.1.0"
   },
   "devDependencies": {
-    "@biomejs/biome": "2.4.3",
+    "@biomejs/biome": "2.4.8",
     "@codemirror/lang-json": "^6.0.2",
-    "@codemirror/state": "^6.5.4",
+    "@codemirror/state": "^6.6.0",
     "@enhance/store": "^1.0.2",
     "@lezer/highlight": "^1.2.3",
     "@oclif/test": "^4.1.16",
     "@playwright/test": "^1.58.2",
     "@rollup/plugin-node-resolve": "^16.0.3",
-    "@sanity/functions": "^1.2.0",
-    "@types/adm-zip": "^0.5.7",
+    "@sanity/functions": "^1.2.1",
+    "@types/adm-zip": "^0.5.8",
     "@types/cardinal": "^2.1.1",
     "@types/mime-types": "^3.0.1",
     "@types/node": "20",
@@ -139,14 +139,14 @@
     "@types/ws": "^8.18.1",
     "codemirror": "^6.0.2",
     "mentoss": "^0.13.0",
-    "oclif": "^4.22.79",
+    "oclif": "^4.22.92",
     "pretty-bytes": "^7.1.0",
     "pretty-ms": "^9.3.0",
-    "rollup": "^4.57.1",
+    "rollup": "^4.59.0",
     "shx": "^0.4.0",
     "ts-node": "^10.9.2",
     "typescript": "^5.9.3",
-    "vitest": "4.0.18"
+    "vitest": "4.1.0"
   },
   "oclif": {
     "bin": "sanity-run",