@sanity/runtime-cli 17.2.0 → 17.3.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/17.2.0 linux-x64 node-v24.18.0
+@sanity/runtime-cli/17.3.0 linux-x64 node-v24.18.0
 $ sanity-run --help [COMMAND]
 USAGE
   $ sanity-run COMMAND
@@ -103,7 +103,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/v17.2.0/src/commands/blueprints/add.ts)_
+_See code: [src/commands/blueprints/add.ts](https://github.com/sanity-io/runtime-cli/blob/v17.3.0/src/commands/blueprints/add.ts)_
 
 ## `sanity-run blueprints config`
 
@@ -140,7 +140,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/v17.2.0/src/commands/blueprints/config.ts)_
+_See code: [src/commands/blueprints/config.ts](https://github.com/sanity-io/runtime-cli/blob/v17.3.0/src/commands/blueprints/config.ts)_
 
 ## `sanity-run blueprints deploy`
 
@@ -194,7 +194,7 @@ EXAMPLES
   $ sanity-run blueprints deploy --new-stack-name <new-name>
 ```
 
-_See code: [src/commands/blueprints/deploy.ts](https://github.com/sanity-io/runtime-cli/blob/v17.2.0/src/commands/blueprints/deploy.ts)_
+_See code: [src/commands/blueprints/deploy.ts](https://github.com/sanity-io/runtime-cli/blob/v17.3.0/src/commands/blueprints/deploy.ts)_
 
 ## `sanity-run blueprints destroy`
 
@@ -232,7 +232,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/v17.2.0/src/commands/blueprints/destroy.ts)_
+_See code: [src/commands/blueprints/destroy.ts](https://github.com/sanity-io/runtime-cli/blob/v17.3.0/src/commands/blueprints/destroy.ts)_
 
 ## `sanity-run blueprints doctor`
 
@@ -264,7 +264,7 @@ EXAMPLES
   $ sanity-run blueprints doctor --fix
 ```
 
-_See code: [src/commands/blueprints/doctor.ts](https://github.com/sanity-io/runtime-cli/blob/v17.2.0/src/commands/blueprints/doctor.ts)_
+_See code: [src/commands/blueprints/doctor.ts](https://github.com/sanity-io/runtime-cli/blob/v17.3.0/src/commands/blueprints/doctor.ts)_
 
 ## `sanity-run blueprints info`
 
@@ -301,7 +301,7 @@ EXAMPLES
   $ sanity-run blueprints info --organization-id <orgId> --stack <name-or-id>
 ```
 
-_See code: [src/commands/blueprints/info.ts](https://github.com/sanity-io/runtime-cli/blob/v17.2.0/src/commands/blueprints/info.ts)_
+_See code: [src/commands/blueprints/info.ts](https://github.com/sanity-io/runtime-cli/blob/v17.3.0/src/commands/blueprints/info.ts)_
 
 ## `sanity-run blueprints init [DIR]`
 
@@ -365,7 +365,7 @@ EXAMPLES
   $ sanity-run blueprints init old-stack --type <json|js|ts> --project-id <projectId> --stack-id <existingStackId>
 ```
 
-_See code: [src/commands/blueprints/init.ts](https://github.com/sanity-io/runtime-cli/blob/v17.2.0/src/commands/blueprints/init.ts)_
+_See code: [src/commands/blueprints/init.ts](https://github.com/sanity-io/runtime-cli/blob/v17.3.0/src/commands/blueprints/init.ts)_
 
 ## `sanity-run blueprints logs`
 
@@ -411,7 +411,7 @@ EXAMPLES
   $ sanity-run blueprints logs --before 2026-05-01T00:00:00Z
 ```
 
-_See code: [src/commands/blueprints/logs.ts](https://github.com/sanity-io/runtime-cli/blob/v17.2.0/src/commands/blueprints/logs.ts)_
+_See code: [src/commands/blueprints/logs.ts](https://github.com/sanity-io/runtime-cli/blob/v17.3.0/src/commands/blueprints/logs.ts)_
 
 ## `sanity-run blueprints mint-deploy-token`
 
@@ -456,7 +456,7 @@ EXAMPLES
   $ sanity-run blueprints mint-deploy-token --organization-id <orgId>
 ```
 
-_See code: [src/commands/blueprints/mint-deploy-token.ts](https://github.com/sanity-io/runtime-cli/blob/v17.2.0/src/commands/blueprints/mint-deploy-token.ts)_
+_See code: [src/commands/blueprints/mint-deploy-token.ts](https://github.com/sanity-io/runtime-cli/blob/v17.3.0/src/commands/blueprints/mint-deploy-token.ts)_
 
 ## `sanity-run blueprints plan`
 
@@ -489,7 +489,7 @@ EXAMPLES
   $ sanity-run blueprints plan --organization-id <orgId> --stack <name-or-id>
 ```
 
-_See code: [src/commands/blueprints/plan.ts](https://github.com/sanity-io/runtime-cli/blob/v17.2.0/src/commands/blueprints/plan.ts)_
+_See code: [src/commands/blueprints/plan.ts](https://github.com/sanity-io/runtime-cli/blob/v17.3.0/src/commands/blueprints/plan.ts)_
 
 ## `sanity-run blueprints promote`
 
@@ -525,7 +525,7 @@ EXAMPLES
   $ sanity-run blueprints promote --new-stack-name <new-name>
 ```
 
-_See code: [src/commands/blueprints/promote.ts](https://github.com/sanity-io/runtime-cli/blob/v17.2.0/src/commands/blueprints/promote.ts)_
+_See code: [src/commands/blueprints/promote.ts](https://github.com/sanity-io/runtime-cli/blob/v17.3.0/src/commands/blueprints/promote.ts)_
 
 ## `sanity-run blueprints stacks`
 
@@ -561,7 +561,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/v17.2.0/src/commands/blueprints/stacks.ts)_
+_See code: [src/commands/blueprints/stacks.ts](https://github.com/sanity-io/runtime-cli/blob/v17.3.0/src/commands/blueprints/stacks.ts)_
 
 ## `sanity-run functions add`
 
@@ -613,7 +613,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/v17.2.0/src/commands/functions/add.ts)_
+_See code: [src/commands/functions/add.ts](https://github.com/sanity-io/runtime-cli/blob/v17.3.0/src/commands/functions/add.ts)_
 
 ## `sanity-run functions dev`
 
@@ -648,7 +648,7 @@ EXAMPLES
   $ sanity-run functions dev --timeout 60
 ```
 
-_See code: [src/commands/functions/dev.ts](https://github.com/sanity-io/runtime-cli/blob/v17.2.0/src/commands/functions/dev.ts)_
+_See code: [src/commands/functions/dev.ts](https://github.com/sanity-io/runtime-cli/blob/v17.3.0/src/commands/functions/dev.ts)_
 
 ## `sanity-run functions env add NAME KEY VALUE`
 
@@ -656,7 +656,7 @@ Add or set an environment variable for a deployed function
 
 ```
 USAGE
-  $ sanity-run functions env add NAME KEY VALUE [--json]
+  $ sanity-run functions env add NAME KEY VALUE [--json] [--stack <value>]
 
 ARGUMENTS
   NAME   The name of the Sanity Function
@@ -664,7 +664,8 @@ ARGUMENTS
   VALUE  The value of the environment variable
 
 FLAGS
-  --json  Format output as json
+  --json           Format output as json
+  --stack=<value>  Stack name or ID to use instead of the locally configured Stack
 
 DESCRIPTION
   Add or set an environment variable for a deployed function
@@ -676,9 +677,11 @@ DESCRIPTION
 
 EXAMPLES
   $ sanity-run functions env add MyFunction API_URL https://api.example.com/
+
+  $ sanity-run functions env add --stack <name-or-id> MyFunction API_URL https://api.example.com/
 ```
 
-_See code: [src/commands/functions/env/add.ts](https://github.com/sanity-io/runtime-cli/blob/v17.2.0/src/commands/functions/env/add.ts)_
+_See code: [src/commands/functions/env/add.ts](https://github.com/sanity-io/runtime-cli/blob/v17.3.0/src/commands/functions/env/add.ts)_
 
 ## `sanity-run functions env list NAME`
 
@@ -686,13 +689,14 @@ List environment variables for a deployed function
 
 ```
 USAGE
-  $ sanity-run functions env list NAME [--json]
+  $ sanity-run functions env list NAME [--json] [--stack <value>]
 
 ARGUMENTS
   NAME  The name of the Sanity Function
 
 FLAGS
-  --json  Format output as json
+  --json           Format output as json
+  --stack=<value>  Stack name or ID to use instead of the locally configured Stack
 
 DESCRIPTION
   List environment variables for a deployed function
@@ -703,9 +707,11 @@ DESCRIPTION
 
 EXAMPLES
   $ sanity-run functions env list MyFunction
+
+  $ sanity-run functions env list --stack <name-or-id> MyFunction
 ```
 
-_See code: [src/commands/functions/env/list.ts](https://github.com/sanity-io/runtime-cli/blob/v17.2.0/src/commands/functions/env/list.ts)_
+_See code: [src/commands/functions/env/list.ts](https://github.com/sanity-io/runtime-cli/blob/v17.3.0/src/commands/functions/env/list.ts)_
 
 ## `sanity-run functions env remove NAME KEY`
 
@@ -713,14 +719,15 @@ Remove an environment variable from a deployed function
 
 ```
 USAGE
-  $ sanity-run functions env remove NAME KEY [--json]
+  $ sanity-run functions env remove NAME KEY [--json] [--stack <value>]
 
 ARGUMENTS
   NAME  The name of the Sanity Function
   KEY   The name of the environment variable
 
 FLAGS
-  --json  Format output as json
+  --json           Format output as json
+  --stack=<value>  Stack name or ID to use instead of the locally configured Stack
 
 DESCRIPTION
   Remove an environment variable from a deployed function
@@ -732,9 +739,11 @@ DESCRIPTION
 
 EXAMPLES
   $ sanity-run functions env remove MyFunction API_URL
+
+  $ sanity-run functions env remove --stack <name-or-id> MyFunction API_URL
 ```
 
-_See code: [src/commands/functions/env/remove.ts](https://github.com/sanity-io/runtime-cli/blob/v17.2.0/src/commands/functions/env/remove.ts)_
+_See code: [src/commands/functions/env/remove.ts](https://github.com/sanity-io/runtime-cli/blob/v17.3.0/src/commands/functions/env/remove.ts)_
 
 ## `sanity-run functions logs [NAME]`
 
@@ -774,7 +783,7 @@ EXAMPLES
   $ sanity-run functions logs <name> --delete
 ```
 
-_See code: [src/commands/functions/logs.ts](https://github.com/sanity-io/runtime-cli/blob/v17.2.0/src/commands/functions/logs.ts)_
+_See code: [src/commands/functions/logs.ts](https://github.com/sanity-io/runtime-cli/blob/v17.3.0/src/commands/functions/logs.ts)_
 
 ## `sanity-run functions test [NAME]`
 
@@ -831,7 +840,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/v17.2.0/src/commands/functions/test.ts)_
+_See code: [src/commands/functions/test.ts](https://github.com/sanity-io/runtime-cli/blob/v17.3.0/src/commands/functions/test.ts)_
 
 ## `sanity-run help [COMMAND]`
 

package/dist/actions/blueprints/assets.js

@@ -1,48 +1,52 @@
 import crypto from 'node:crypto';
 import fs from 'node:fs';
+import { readFile } from 'node:fs/promises';
 import AdmZip from 'adm-zip';
 import { blueprintsUrl } from '../../config.js';
 import { CONVERT_BYTES_TO_MB, MAX_ASSET_SIZE } from '../../constants.js';
 import { prepareAsset as prepareFunctionAsset } from '../../utils/functions/prepare-asset.js';
 import getHeaders from '../../utils/get-headers.js';
+import { prepareStudioAsset } from '../../utils/studios/prepare-asset.js';
 import { createTracedFetch } from '../../utils/traced-fetch.js';
 import { isLocalFunctionResource, isStudioResource } from '../../utils/types.js';
 const assetsUrl = blueprintsUrl('assets');
 export const assetCheckUrl = `${assetsUrl}/check`;
 export const assetStashUrl = `${assetsUrl}/stash`;
 export async function stashAsset({ resource, auth, blueprintFileDir, logger, installer, }) {
+    let cleanup = async () => { };
     try {
         let b64;
         let hash;
         let extension;
-        let cleanup;
         if (isLocalFunctionResource(resource)) {
             const prepResult = await prepareFunctionAsset({ resource, blueprintFileDir, installer });
             if (prepResult.success === false) {
+                await prepResult.cleanup();
                 return {
                     success: false,
                     error: prepResult.error,
                 };
             }
+            cleanup = prepResult.cleanup;
             const zipResult = await pathToB64ZipHash(prepResult.outputPath);
             b64 = zipResult.b64;
             hash = zipResult.hash;
             extension = 'zip';
-            cleanup = prepResult.cleanup;
         }
         else if (isStudioResource(resource)) {
-            const prepResult = await prepareStudioAsset({ resource });
+            const prepResult = await prepareStudioAsset({ resource, blueprintFileDir });
             if (prepResult.success === false) {
+                await prepResult.cleanup();
                 return {
                     success: false,
                     error: prepResult.error,
                 };
             }
-            const buffer = await fs.promises.readFile(prepResult.outputPath);
+            cleanup = prepResult.cleanup;
+            const buffer = await readFile(prepResult.outputPath);
             b64 = buffer.toString('base64');
             hash = hashBuffer(buffer);
             extension = 'tar.gz';
-            cleanup = prepResult.cleanup;
         }
         else {
             return {
@@ -61,28 +65,15 @@ export async function stashAsset({ resource, auth, blueprintFileDir, logger, ins
         });
     }
     catch (err) {
+        try {
+            await cleanup();
+        }
+        catch {
+            // ignore clean up errors
+        }
         return { success: false, error: err instanceof Error ? err.message : `${err}` };
     }
 }
-async function prepareStudioAsset({ resource, }) {
-    if (!fs.existsSync(resource.src)) {
-        return {
-            success: false,
-            async cleanup() {
-                // no op
-            },
-            error: `Property 'src' on resource with type '${resource.type}' must be a directory`,
-        };
-    }
-    return {
-        success: true,
-        async cleanup() {
-            // no op
-        },
-        // studio must be pre built (e.g. with `npm run build`) and tarred/gzipped
-        outputPath: resource.src,
-    };
-}
 async function stashSingleAsset({ b64, hash, cleanup, resource, auth, logger, extension = 'zip', }) {
     const fetchFn = createTracedFetch(logger);
     try {

package/dist/actions/blueprints/pre-deploy.d.ts

@@ -0,0 +1,29 @@
+import type { BlueprintResource } from '@sanity/blueprints';
+import type { Logger } from '../../utils/logger.js';
+import { type AuthParams, type InstallerType, type ScopeType } from '../../utils/types.js';
+type PreDeployResult = {
+    success: false;
+    error: string;
+    code?: string;
+    exitCode?: number;
+    suggestions?: string[];
+} | {
+    success: true;
+};
+type PreDeployResourceOptions = {
+    auth: AuthParams;
+    blueprintFileDir: string;
+    installer: InstallerType;
+    log: Logger;
+};
+type PreDeployOptions = {
+    scopeType: ScopeType;
+    scopeId: string;
+    resources: BlueprintResource[];
+    stackId: string;
+    stackName: string;
+    bin: string;
+    verbose: boolean | undefined;
+} & PreDeployResourceOptions;
+export declare function preDeploy(options: PreDeployOptions): Promise<PreDeployResult>;
+export {};

package/dist/actions/blueprints/pre-deploy.js

@@ -0,0 +1,164 @@
+import { env } from 'node:process';
+import { resolveDeployedResources } from '../../utils/blueprints/resolve-deployed-resources.js';
+import { niceId } from '../../utils/display/presenters.js';
+import { CODE_OPERATION_UNCONFIRMED, EXIT_OPERATION_UNCONFIRMED } from '../../utils/exit-codes.js';
+import { styleText } from '../../utils/style-text.js';
+import { isAssetResource, } from '../../utils/types.js';
+import { stashAsset } from './assets.js';
+import { updateStack } from './stacks.js';
+import { waitForOperation } from './wait-for-operation.js';
+const DEFAULT_ASSET_TIMEOUT = 180;
+const assetTimeoutS = Number(process.env.SANITY_ASSET_TIMEOUT) || DEFAULT_ASSET_TIMEOUT;
+const assetTimeoutMs = assetTimeoutS * 1000;
+const warnTimeoutMs = assetTimeoutMs / 3;
+export async function preDeploy(options) {
+    const { resources, stackId, auth, blueprintFileDir, installer, log } = options;
+    const hasAssetResources = resources.some(isAssetResource);
+    if (hasAssetResources) {
+        let assetResources;
+        if (env.SANITY_BLUEPRINTS_PRE_DEPLOY_ENABLED === 'true') {
+            const preDeployStackResult = await preDeployStack(options);
+            if (!preDeployStackResult.success) {
+                return preDeployStackResult;
+            }
+            /** Look up resources from the back-end and attach the externalId if possible */
+            const resolvedResources = await resolveDeployedResources({
+                resources,
+                stackId,
+                auth,
+                logger: log,
+            });
+            assetResources = resolvedResources.filter(isAssetResource);
+        }
+        else {
+            assetResources = resources.filter(isAssetResource);
+        }
+        log('Processing assets...');
+        for (const resource of assetResources) {
+            const preDeployResult = await preDeployResource(resource, {
+                auth,
+                blueprintFileDir,
+                installer,
+                log,
+            });
+            if (!preDeployResult.success)
+                return preDeployResult;
+            const idx = resources.findIndex((r) => r.name === resource.name);
+            if (idx === -1)
+                throw new Error('Unable to update resource asset');
+            resources[idx] = preDeployResult.resource;
+        }
+    }
+    return { success: true };
+}
+async function preDeployStack(options) {
+    const { scopeType, scopeId, stackId, stackName, resources, auth, log, bin, verbose } = options;
+    const spinner = log.ora('Starting pre-deploy...').start();
+    const stackMutation = {
+        scopeType,
+        scopeId,
+        name: stackName,
+        preDeploy: true,
+        document: { resources },
+    };
+    const { ok: deployOk, stack, error: deployError, } = await updateStack({ stackId, stackMutation, auth, logger: log });
+    if (!deployOk) {
+        spinner.fail(`${styleText('red', 'Failed')} to complete Stack pre-deployment`);
+        return {
+            success: false,
+            error: deployError || 'Failed to complete Stack pre-deployment',
+            suggestions: [
+                `Run \`npx ${bin} blueprints plan\` to preview changes before deploying.`,
+                `Run \`npx ${bin} blueprints doctor\` to check your configuration.`,
+            ],
+        };
+    }
+    spinner.stop().clear();
+    log(styleText('dim', 'Stack deployment progress:'));
+    log('');
+    const outcome = await waitForOperation({
+        stackId,
+        operationId: stack.operationId,
+        auth,
+        log,
+        bin,
+        verbose,
+        progressNoun: 'pre-deployment',
+    });
+    if (outcome.type === 'completed') {
+        log(styleText(['bold', 'green'], 'Stack pre-deployment completed!'));
+    }
+    else if (outcome.type === 'unconfirmed') {
+        return {
+            success: false,
+            error: `Stack pre-deployment was accepted but completion could not be confirmed${outcome.error ? ` (${outcome.error})` : ''}.`,
+            code: CODE_OPERATION_UNCONFIRMED,
+            exitCode: EXIT_OPERATION_UNCONFIRMED,
+            suggestions: [
+                'The pre-deployment may or may not have finished on Sanity servers.',
+                `Run \`npx ${bin} blueprints info\` to check status.`,
+                `Run \`npx ${bin} blueprints logs --watch\` to keep streaming logs.`,
+            ],
+        };
+    }
+    else {
+        return {
+            success: false,
+            error: 'Stack pre-deployment failed',
+            suggestions: [
+                ...outcome.logHints,
+                'Review the pre-deployment output above for error details.',
+                `Run \`npx ${bin} blueprints logs --verbose\` for more context.`,
+                `Run \`npx ${bin} blueprints plan\` to identify issues with your Blueprint.`,
+            ],
+        };
+    }
+    return { success: true };
+}
+async function preDeployResource(resource, options) {
+    const { auth, blueprintFileDir, installer, log } = options;
+    const fnSpinner = log.ora({ text: `Processing ${resource.name}...`, prefixText: ' ' }).start();
+    const warnTimer = setTimeout(() => {
+        fnSpinner.text = `Still processing ${resource.name}, this can take a moment...`;
+    }, warnTimeoutMs);
+    let assetTimeoutTimer;
+    let result;
+    try {
+        result = await Promise.race([
+            stashAsset({ resource, blueprintFileDir, auth, logger: log, installer }),
+            new Promise((_, reject) => {
+                assetTimeoutTimer = setTimeout(() => {
+                    reject(new Error(`Processing ${resource.name} timed out after ${assetTimeoutS}s`));
+                }, assetTimeoutMs);
+            }),
+        ]);
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        fnSpinner.fail(msg);
+        return { success: false, error: msg };
+    }
+    finally {
+        clearTimeout(warnTimer);
+        clearTimeout(assetTimeoutTimer);
+    }
+    if (result.success && result.assetId) {
+        const updatedResource = { ...resource, src: result.assetId };
+        fnSpinner.succeed(`${updatedResource.name} ${niceId(result.assetId)}`);
+        log(`   Source: ${updatedResource.src}`);
+        if (result.hash) {
+            if (result.hash.length > 24) {
+                log.verbose(`   Hash: ${result.hash.slice(0, 8)}...${result.hash.slice(-12)}`);
+            }
+            else {
+                log.verbose(`   Hash: ${result.hash}`);
+            }
+        }
+        if (result.exists)
+            log.verbose('   Asset unchanged');
+        return { success: true, resource: updatedResource };
+    }
+    const errorMsg = `Failed uploading ${resource.name} asset, deploy has stopped`;
+    fnSpinner.fail(errorMsg);
+    return { success: false, error: result.error || 'Failed to process asset' };
+}

package/dist/commands/functions/env/add.d.ts

@@ -8,6 +8,9 @@ export default class EnvAddCommand extends ResolvedCommand<typeof EnvAddCommand>
         key: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
         value: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
     };
+    static flags: {
+        stack: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
     static examples: string[];
     run(): Promise<Record<string, unknown> | undefined>;
 }

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

@@ -1,5 +1,5 @@
-import { Args } from '@oclif/core';
-import { ResolvedCommand } from '../../../baseCommands.js';
+import { Args, Flags } from '@oclif/core';
+import { ResolvedCommand, stackFlagConfig } from '../../../baseCommands.js';
 import { functionEnvAddCore } from '../../../cores/functions/env/add.js';
 import { Logger } from '../../../utils/logger.js';
 export default class EnvAddCommand extends ResolvedCommand {
@@ -13,8 +13,12 @@ Environment variables are useful for API keys, configuration values, and other s
         key: Args.string({ description: 'The name of the environment variable', required: true }),
         value: Args.string({ description: 'The value of the environment variable', required: true }),
     };
+    static flags = {
+        stack: Flags.string({ ...stackFlagConfig }),
+    };
     static examples = [
         '<%= config.bin %> <%= command.id %> MyFunction API_URL https://api.example.com/',
+        '<%= config.bin %> <%= command.id %> --stack <name-or-id> MyFunction API_URL https://api.example.com/',
     ];
     async run() {
         const result = await functionEnvAddCore({

package/dist/commands/functions/env/list.d.ts

@@ -6,6 +6,9 @@ export default class EnvListCommand extends ResolvedCommand<typeof EnvListComman
     static args: {
         name: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
     };
+    static flags: {
+        stack: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
     static examples: string[];
     run(): Promise<Record<string, unknown> | undefined>;
 }

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

@@ -1,5 +1,5 @@
-import { Args } from '@oclif/core';
-import { ResolvedCommand } from '../../../baseCommands.js';
+import { Args, Flags } from '@oclif/core';
+import { ResolvedCommand, stackFlagConfig } from '../../../baseCommands.js';
 import { functionEnvListCore } from '../../../cores/functions/env/list.js';
 import { Logger } from '../../../utils/logger.js';
 export default class EnvListCommand extends ResolvedCommand {
@@ -11,7 +11,13 @@ Use 'functions env add' to set variables or 'functions env remove' to delete the
     static args = {
         name: Args.string({ description: 'The name of the Sanity Function', required: true }),
     };
-    static examples = ['<%= config.bin %> <%= command.id %> MyFunction'];
+    static flags = {
+        stack: Flags.string({ ...stackFlagConfig }),
+    };
+    static examples = [
+        '<%= config.bin %> <%= command.id %> MyFunction',
+        '<%= config.bin %> <%= command.id %> --stack <name-or-id> MyFunction',
+    ];
     async run() {
         const result = await functionEnvListCore({
             bin: this.config.bin,

package/dist/commands/functions/env/remove.d.ts

@@ -7,6 +7,9 @@ export default class EnvRemoveCommand extends ResolvedCommand<typeof EnvRemoveCo
         name: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
         key: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
     };
+    static flags: {
+        stack: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
     static examples: string[];
     run(): Promise<Record<string, unknown> | undefined>;
 }

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

@@ -1,5 +1,5 @@
-import { Args } from '@oclif/core';
-import { ResolvedCommand } from '../../../baseCommands.js';
+import { Args, Flags } from '@oclif/core';
+import { ResolvedCommand, stackFlagConfig } from '../../../baseCommands.js';
 import { functionEnvRemoveCore } from '../../../cores/functions/env/remove.js';
 import { Logger } from '../../../utils/logger.js';
 export default class EnvRemoveCommand extends ResolvedCommand {
@@ -12,7 +12,13 @@ Use 'functions env list' to see current variables before removing.`;
         name: Args.string({ description: 'The name of the Sanity Function', required: true }),
         key: Args.string({ description: 'The name of the environment variable', required: true }),
     };
-    static examples = ['<%= config.bin %> <%= command.id %> MyFunction API_URL'];
+    static flags = {
+        stack: Flags.string({ ...stackFlagConfig }),
+    };
+    static examples = [
+        '<%= config.bin %> <%= command.id %> MyFunction API_URL',
+        '<%= config.bin %> <%= command.id %> --stack <name-or-id> MyFunction API_URL',
+    ];
     async run() {
         const result = await functionEnvRemoveCore({
             bin: this.config.bin,

package/dist/constants.d.ts

@@ -9,6 +9,7 @@ export declare const SANITY_PROJECT = "sanity.project";
 export declare const SANITY_PROJECT_CORS = "sanity.project.cors";
 export declare const SANITY_PROJECT_DATASET = "sanity.project.dataset";
 export declare const SANITY_PROJECT_WEBHOOK = "sanity.project.webhook";
+export declare const SANITY_STUDIO = "sanity.studio";
 export declare const EVENT_DOCUMENT_PUBLISH = "document-publish";
 export declare const EVENT_DOCUMENT_CREATE = "document-create";
 export declare const EVENT_DOCUMENT_UPDATE = "document-update";

package/dist/constants.js

@@ -9,6 +9,7 @@ export const SANITY_PROJECT = 'sanity.project';
 export const SANITY_PROJECT_CORS = 'sanity.project.cors';
 export const SANITY_PROJECT_DATASET = 'sanity.project.dataset';
 export const SANITY_PROJECT_WEBHOOK = 'sanity.project.webhook';
+export const SANITY_STUDIO = 'sanity.studio';
 export const EVENT_DOCUMENT_PUBLISH = 'document-publish';
 export const EVENT_DOCUMENT_CREATE = 'document-create';
 export const EVENT_DOCUMENT_UPDATE = 'document-update';