@sanity/runtime-cli 10.9.2 → 10.11.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/10.9.2 linux-x64 node-v22.19.0
+@sanity/runtime-cli/10.11.0 linux-x64 node-v22.20.0
 $ sanity-run --help [COMMAND]
 USAGE
   $ sanity-run COMMAND
@@ -33,6 +33,7 @@ USAGE
 * [`sanity-run blueprints config`](#sanity-run-blueprints-config)
 * [`sanity-run blueprints deploy`](#sanity-run-blueprints-deploy)
 * [`sanity-run blueprints destroy`](#sanity-run-blueprints-destroy)
+* [`sanity-run blueprints doctor`](#sanity-run-blueprints-doctor)
 * [`sanity-run blueprints info`](#sanity-run-blueprints-info)
 * [`sanity-run blueprints init [DIR]`](#sanity-run-blueprints-init-dir)
 * [`sanity-run blueprints logs`](#sanity-run-blueprints-logs)
@@ -88,7 +89,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/v10.9.2/src/commands/blueprints/add.ts)_
+_See code: [src/commands/blueprints/add.ts](https://github.com/sanity-io/runtime-cli/blob/v10.11.0/src/commands/blueprints/add.ts)_
 
 ## `sanity-run blueprints config`
 
@@ -119,7 +120,7 @@ EXAMPLES
   $ sanity-run blueprints config --edit --project-id <projectId> --stack-id <stackId>
 ```
 
-_See code: [src/commands/blueprints/config.ts](https://github.com/sanity-io/runtime-cli/blob/v10.9.2/src/commands/blueprints/config.ts)_
+_See code: [src/commands/blueprints/config.ts](https://github.com/sanity-io/runtime-cli/blob/v10.11.0/src/commands/blueprints/config.ts)_
 
 ## `sanity-run blueprints deploy`
 
@@ -141,7 +142,7 @@ EXAMPLES
   $ sanity-run blueprints deploy --no-wait
 ```
 
-_See code: [src/commands/blueprints/deploy.ts](https://github.com/sanity-io/runtime-cli/blob/v10.9.2/src/commands/blueprints/deploy.ts)_
+_See code: [src/commands/blueprints/deploy.ts](https://github.com/sanity-io/runtime-cli/blob/v10.11.0/src/commands/blueprints/deploy.ts)_
 
 ## `sanity-run blueprints destroy`
 
@@ -166,7 +167,25 @@ EXAMPLES
   $ sanity-run blueprints destroy --stack-id <stackId> --project-id <projectId> --force --no-wait
 ```
 
-_See code: [src/commands/blueprints/destroy.ts](https://github.com/sanity-io/runtime-cli/blob/v10.9.2/src/commands/blueprints/destroy.ts)_
+_See code: [src/commands/blueprints/destroy.ts](https://github.com/sanity-io/runtime-cli/blob/v10.11.0/src/commands/blueprints/destroy.ts)_
+
+## `sanity-run blueprints doctor`
+
+Diagnose potential issues with Blueprint configuration
+
+```
+USAGE
+  $ sanity-run blueprints doctor [--verbose] [--path <value>]
+
+FLAGS
+  --path=<value>  Path to the Blueprint configuration file
+  --verbose       Provide detailed information about issues
+
+DESCRIPTION
+  Diagnose potential issues with Blueprint configuration
+```
+
+_See code: [src/commands/blueprints/doctor.ts](https://github.com/sanity-io/runtime-cli/blob/v10.11.0/src/commands/blueprints/doctor.ts)_
 
 ## `sanity-run blueprints info`
 
@@ -188,7 +207,7 @@ EXAMPLES
   $ sanity-run blueprints info --stack-id <stackId>
 ```
 
-_See code: [src/commands/blueprints/info.ts](https://github.com/sanity-io/runtime-cli/blob/v10.9.2/src/commands/blueprints/info.ts)_
+_See code: [src/commands/blueprints/info.ts](https://github.com/sanity-io/runtime-cli/blob/v10.11.0/src/commands/blueprints/info.ts)_
 
 ## `sanity-run blueprints init [DIR]`
 
@@ -226,7 +245,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/v10.9.2/src/commands/blueprints/init.ts)_
+_See code: [src/commands/blueprints/init.ts](https://github.com/sanity-io/runtime-cli/blob/v10.11.0/src/commands/blueprints/init.ts)_
 
 ## `sanity-run blueprints logs`
 
@@ -248,7 +267,7 @@ EXAMPLES
   $ sanity-run blueprints logs --watch
 ```
 
-_See code: [src/commands/blueprints/logs.ts](https://github.com/sanity-io/runtime-cli/blob/v10.9.2/src/commands/blueprints/logs.ts)_
+_See code: [src/commands/blueprints/logs.ts](https://github.com/sanity-io/runtime-cli/blob/v10.11.0/src/commands/blueprints/logs.ts)_
 
 ## `sanity-run blueprints plan`
 
@@ -265,7 +284,7 @@ EXAMPLES
   $ sanity-run blueprints plan
 ```
 
-_See code: [src/commands/blueprints/plan.ts](https://github.com/sanity-io/runtime-cli/blob/v10.9.2/src/commands/blueprints/plan.ts)_
+_See code: [src/commands/blueprints/plan.ts](https://github.com/sanity-io/runtime-cli/blob/v10.11.0/src/commands/blueprints/plan.ts)_
 
 ## `sanity-run blueprints stacks`
 
@@ -287,7 +306,7 @@ EXAMPLES
   $ sanity-run blueprints stacks --project-id <projectId>
 ```
 
-_See code: [src/commands/blueprints/stacks.ts](https://github.com/sanity-io/runtime-cli/blob/v10.9.2/src/commands/blueprints/stacks.ts)_
+_See code: [src/commands/blueprints/stacks.ts](https://github.com/sanity-io/runtime-cli/blob/v10.11.0/src/commands/blueprints/stacks.ts)_
 
 ## `sanity-run functions dev`
 
@@ -295,10 +314,12 @@ Start the Sanity Function emulator
 
 ```
 USAGE
-  $ sanity-run functions dev [-p <value>]
+  $ sanity-run functions dev [-p <value>] [-t <value>]
 
 FLAGS
-  -p, --port=<value>  Port to start emulator on
+  -p, --port=<value>     Port to start emulator on
+  -t, --timeout=<value>  Maximum execution time for all functions, in seconds. Takes precedence over function-specific
+                         `timeout`
 
 DESCRIPTION
   Start the Sanity Function emulator
@@ -307,7 +328,7 @@ EXAMPLES
   $ sanity-run functions dev --port 8974
 ```
 
-_See code: [src/commands/functions/dev.ts](https://github.com/sanity-io/runtime-cli/blob/v10.9.2/src/commands/functions/dev.ts)_
+_See code: [src/commands/functions/dev.ts](https://github.com/sanity-io/runtime-cli/blob/v10.11.0/src/commands/functions/dev.ts)_
 
 ## `sanity-run functions env add NAME KEY VALUE`
 
@@ -329,7 +350,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/v10.9.2/src/commands/functions/env/add.ts)_
+_See code: [src/commands/functions/env/add.ts](https://github.com/sanity-io/runtime-cli/blob/v10.11.0/src/commands/functions/env/add.ts)_
 
 ## `sanity-run functions env list NAME`
 
@@ -349,7 +370,7 @@ EXAMPLES
   $ sanity-run functions env list MyFunction
 ```
 
-_See code: [src/commands/functions/env/list.ts](https://github.com/sanity-io/runtime-cli/blob/v10.9.2/src/commands/functions/env/list.ts)_
+_See code: [src/commands/functions/env/list.ts](https://github.com/sanity-io/runtime-cli/blob/v10.11.0/src/commands/functions/env/list.ts)_
 
 ## `sanity-run functions env remove NAME KEY`
 
@@ -370,7 +391,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/v10.9.2/src/commands/functions/env/remove.ts)_
+_See code: [src/commands/functions/env/remove.ts](https://github.com/sanity-io/runtime-cli/blob/v10.11.0/src/commands/functions/env/remove.ts)_
 
 ## `sanity-run functions logs NAME`
 
@@ -404,7 +425,7 @@ EXAMPLES
   $ sanity-run functions logs <name> --delete
 ```
 
-_See code: [src/commands/functions/logs.ts](https://github.com/sanity-io/runtime-cli/blob/v10.9.2/src/commands/functions/logs.ts)_
+_See code: [src/commands/functions/logs.ts](https://github.com/sanity-io/runtime-cli/blob/v10.11.0/src/commands/functions/logs.ts)_
 
 ## `sanity-run functions test NAME`
 
@@ -451,7 +472,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/v10.9.2/src/commands/functions/test.ts)_
+_See code: [src/commands/functions/test.ts](https://github.com/sanity-io/runtime-cli/blob/v10.11.0/src/commands/functions/test.ts)_
 
 ## `sanity-run help [COMMAND]`
 

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

@@ -4,7 +4,7 @@ export interface BlueprintsConfig {
     projectId?: string;
     stackId?: string;
 }
-export declare function readConfigFile(blueprintFilePath: string): BlueprintsConfig | null;
+export declare function readConfigFile(blueprintFilePath?: string): BlueprintsConfig | null;
 export declare function writeConfigFile({ blueprintFilePath, organizationId, projectId, stackId, }: {
     blueprintFilePath?: string;
     stackId?: string;

package/dist/actions/blueprints/config.js

@@ -3,7 +3,7 @@ import { dirname, join } from 'node:path';
 import { cwd } from 'node:process';
 import { BLUEPRINT_CONFIG_FILE, BLUEPRINT_CONFIG_VERSION, BLUEPRINT_DIR } from '../../config.js';
 export function readConfigFile(blueprintFilePath) {
-    const blueprintDir = dirname(blueprintFilePath);
+    const blueprintDir = blueprintFilePath ? dirname(blueprintFilePath) : cwd();
     const configPath = join(blueprintDir, BLUEPRINT_DIR, BLUEPRINT_CONFIG_FILE);
     if (existsSync(configPath)) {
         try {
@@ -14,16 +14,7 @@ export function readConfigFile(blueprintFilePath) {
             return null;
         }
     }
-    const configFilePath = join(cwd(), BLUEPRINT_DIR, BLUEPRINT_CONFIG_FILE);
-    if (!existsSync(configFilePath))
-        return null;
-    try {
-        const config = JSON.parse(readFileSync(configFilePath, 'utf8'));
-        return config || null;
-    }
-    catch {
-        return null;
-    }
+    return null;
 }
 export function writeConfigFile({ blueprintFilePath, organizationId, projectId, stackId, }) {
     const blueprintDir = blueprintFilePath ? dirname(blueprintFilePath) : cwd();

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

@@ -10,6 +10,7 @@ interface GetStackResponse {
     ok: boolean;
     error: string | null;
     stack: Stack;
+    response: Response;
 }
 export declare function getStack({ stackId, auth, }: {
     stackId: string;

package/dist/actions/blueprints/stacks.js

@@ -47,6 +47,7 @@ export async function getStack({ stackId, auth, }) {
         ok: response.ok,
         error: response.ok ? null : data.message,
         stack: response.ok ? flattenStackResources(data) : data,
+        response,
     };
 }
 export async function createStack({ stackMutation, auth, }) {

package/dist/actions/functions/dev.d.ts

@@ -1 +1,2 @@
-export declare function dev(port: number): Promise<void>;
+import type { InvokeExecutionOptions } from '../../utils/types.js';
+export declare function dev(port: number, executionOptions?: Partial<InvokeExecutionOptions>): Promise<void>;

package/dist/actions/functions/dev.js

@@ -1,4 +1,4 @@
 import { app } from '../../server/app.js';
-export async function dev(port) {
-    app(Number(port));
+export async function dev(port, executionOptions) {
+    app(Number(port), executionOptions);
 }

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

@@ -0,0 +1,10 @@
+import { Command } from '@oclif/core';
+export default class DoctorCommand extends Command {
+    static description: string;
+    static examples: never[];
+    static flags: {
+        verbose: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        path: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/blueprints/doctor.js

@@ -0,0 +1,28 @@
+import { Command, Flags } from '@oclif/core';
+import config from '../../config.js';
+import { blueprintDoctorCore } from '../../cores/blueprints/doctor.js';
+export default class DoctorCommand extends Command {
+    static description = 'Diagnose potential issues with Blueprint configuration';
+    static examples = [];
+    static flags = {
+        verbose: Flags.boolean({
+            description: 'Provide detailed information about issues',
+            default: false,
+        }),
+        path: Flags.string({
+            description: 'Path to the Blueprint configuration file',
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(DoctorCommand);
+        const { token } = config;
+        const { success, error } = await blueprintDoctorCore({
+            bin: this.config.bin,
+            log: (message) => this.log(message),
+            token,
+            flags,
+        });
+        if (!success)
+            this.error(error);
+    }
+}

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

@@ -4,6 +4,7 @@ export default class DevCommand extends Command {
     static examples: string[];
     static flags: {
         port: import("@oclif/core/interfaces").OptionFlag<number | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        timeout: import("@oclif/core/interfaces").OptionFlag<number | undefined, import("@oclif/core/interfaces").CustomOptions>;
     };
     run(): Promise<void>;
 }

package/dist/commands/functions/dev.js

@@ -5,6 +5,11 @@ export default class DevCommand extends Command {
     static examples = ['<%= config.bin %> <%= command.id %> --port 8974'];
     static flags = {
         port: Flags.integer({ char: 'p', description: 'Port to start emulator on', required: false }),
+        timeout: Flags.integer({
+            char: 't',
+            description: 'Maximum execution time for all functions, in seconds. Takes precedence over function-specific `timeout`',
+            required: false,
+        }),
     };
     async run() {
         const { flags } = await this.parse(DevCommand);

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

@@ -0,0 +1,9 @@
+import type { CoreConfig, CoreResult } from '../index.js';
+export interface BlueprintDoctorOptions extends CoreConfig {
+    token: string | null;
+    flags: {
+        verbose: boolean;
+        path: string | undefined;
+    };
+}
+export declare function blueprintDoctorCore(options: BlueprintDoctorOptions): Promise<CoreResult>;

package/dist/cores/blueprints/doctor.js

@@ -0,0 +1,188 @@
+import { cwd } from 'node:process';
+import chalk from 'chalk';
+import ora from 'ora';
+import { findBlueprintFile, readLocalBlueprint, } from '../../actions/blueprints/blueprint.js';
+import { getStack } from '../../actions/blueprints/stacks.js';
+import config from '../../config.js';
+import { check, indent, niceId, severe, warn } from '../../utils/display/presenters.js';
+import { validTokenOrErrorMessage } from '../../utils/validated-token.js';
+const diagLookup = {
+    online: 'Online',
+    tokenPresent: 'Auth token present',
+    tokenValid: 'Auth token valid',
+    configFilePresent: 'Blueprints config file present',
+    configFileValid: 'Blueprints config file valid',
+    blueprintPresent: 'Blueprint file present',
+    blueprintValid: 'Blueprint file valid',
+    stackReady: 'Deployment "Stack" ready',
+    userHasAccess: 'User has access to "Stack"',
+};
+export async function blueprintDoctorCore(options) {
+    const { log, token, flags: { verbose: v, path: p }, } = options;
+    const yikes = (s) => {
+        log(chalk.bgRedBright.whiteBright.bold(` ${s} `));
+    };
+    const here = cwd();
+    const path = p || here;
+    if (v)
+        log(`Checking ${path}`);
+    // 3 states: null == unknown, true == good, false == bad
+    const diagnostics = {};
+    for (const key in diagLookup) {
+        diagnostics[key] = null;
+    }
+    let spinner;
+    if (!v)
+        spinner = ora('Checking environment').start();
+    // ONLINE
+    try {
+        const res = await fetch(config.apiUrl);
+        if (res.ok) {
+            if (v)
+                log(`Successfully pinged ${config.apiUrl}`);
+            diagnostics.online = res.ok;
+        }
+        else {
+            if (v)
+                yikes(`Failed to ping ${config.apiUrl}: ${res.status} ${res.statusText}`);
+            diagnostics.online = false;
+        }
+    }
+    catch {
+        if (v)
+            yikes(`Failed to ping ${config.apiUrl}`);
+    }
+    // TOKEN
+    if (token) {
+        diagnostics.tokenPresent = true;
+        const tokenOrError = await validTokenOrErrorMessage(token);
+        if (tokenOrError.ok) {
+            diagnostics.tokenValid = true;
+        }
+        else {
+            if (v)
+                yikes(`Token error: ${tokenOrError.error}`);
+            diagnostics.tokenValid = false;
+        }
+    }
+    else {
+        diagnostics.tokenPresent = false;
+    }
+    // BLUEPRINT file
+    const blueprintFile = findBlueprintFile(path);
+    if (blueprintFile?.blueprintFilePath) {
+        if (v)
+            log(`Found blueprint file at ${blueprintFile.blueprintFilePath.replace(here, '.')}`);
+        diagnostics.blueprintPresent = true;
+    }
+    else {
+        diagnostics.blueprintPresent = false;
+    }
+    let blueprint;
+    try {
+        blueprint = await readLocalBlueprint(path);
+        if (blueprint.errors.length === 0) {
+            if (v)
+                log(`Blueprint has no errors`);
+            diagnostics.blueprintValid = true;
+        }
+        else {
+            if (v)
+                log(`Blueprint errors: \n${blueprint.errors.join('\n  ')}`);
+            diagnostics.blueprintValid = false;
+        }
+    }
+    catch {
+        if (v)
+            yikes(`Unable to read blueprint`);
+        diagnostics.blueprintValid = false;
+    }
+    if (blueprint) {
+        const { configPath, scopeType, scopeId, stackId, projectId } = blueprint;
+        // CONFIG file
+        if (configPath) {
+            if (v)
+                log(`Found config file at ${configPath.replace(here, '.')}`);
+            diagnostics.configFilePresent = true;
+            if (scopeType && scopeId && stackId) {
+                diagnostics.configFileValid = true;
+                if (v) {
+                    const capitalizedScopeType = scopeType.charAt(0).toUpperCase() + scopeType.slice(1);
+                    const configOutput = [
+                        `${capitalizedScopeType}: ${niceId(scopeId)}`,
+                        `Deployment: ${niceId(stackId)}`,
+                    ].join('\n');
+                    log(indent(configOutput));
+                }
+            }
+            else {
+                diagnostics.configFileValid = false;
+            }
+        }
+        else {
+            diagnostics.configFilePresent = false;
+        }
+        // STACK + ACCESS
+        if (diagnostics.online && diagnostics.tokenValid && token && stackId && projectId) {
+            const stackResponse = await getStack({
+                auth: { token, projectId },
+                stackId,
+            });
+            if (stackResponse.ok) {
+                if (v)
+                    log(`Deployment "Stack" ${niceId(stackId)} ready`);
+                diagnostics.stackReady = true;
+                diagnostics.userHasAccess = true;
+            }
+            else if (stackResponse.response.status === 404) {
+                if (v)
+                    yikes(`Deployment "Stack" <${stackId}> not found`);
+                diagnostics.stackReady = false;
+            }
+            else if (stackResponse.response.status === 403 || stackResponse.response.status === 401) {
+                if (v)
+                    yikes(`User does not have access to "Stack" <${stackId}>`);
+                diagnostics.userHasAccess = false;
+            }
+            else {
+                if (v)
+                    yikes(`Unknown error with "Stack" <${stackId}>: ${stackResponse.error}`);
+            }
+        }
+        else {
+            if (v)
+                yikes('Unable to check deployment "Stack" status.');
+        }
+    }
+    if (spinner)
+        spinner.stop();
+    if (v)
+        log('');
+    let allGood = true;
+    for (const [key, value] of Object.entries(diagnostics)) {
+        switch (value) {
+            case true:
+                if (v)
+                    log(check(diagLookup[key]));
+                break;
+            case false:
+                allGood = false;
+                log(severe(diagLookup[key]));
+                break;
+            case null:
+                allGood = false;
+                log(warn(diagLookup[key]));
+                break;
+            default:
+                allGood = false;
+                log(severe(`${key} is ${value}`));
+        }
+    }
+    if (allGood) {
+        log(chalk.bold.green('All checks passed'));
+        return { success: true, data: { diagnostics } };
+    }
+    else {
+        return { success: false, error: 'One or more checks failed', data: { diagnostics } };
+    }
+}

package/dist/cores/functions/dev.d.ts

@@ -2,6 +2,7 @@ import type { CoreConfig, CoreResult } from '../index.js';
 export interface FunctionDevOptions extends CoreConfig {
     flags: {
         port?: number;
+        timeout?: number;
     };
 }
 export declare function functionDevCore(options: FunctionDevOptions): Promise<CoreResult>;

package/dist/cores/functions/dev.js

@@ -1,9 +1,13 @@
 import { dev } from '../../actions/functions/dev.js';
 export async function functionDevCore(options) {
     const { log, flags } = options;
-    const { port = 8080 } = flags;
+    const { port = 8080, timeout } = flags;
+    // Construct execution options only if timeout is provided
+    const executionOptions = timeout
+        ? { timeout }
+        : undefined;
     try {
-        await dev(Number(port));
+        await dev(Number(port), executionOptions);
         log(`Server is running on http://localhost:${port}\n`);
         return {
             success: true,

package/dist/cores/index.d.ts

@@ -19,6 +19,9 @@ export interface DeployedBlueprintConfig extends BlueprintConfig {
     deployedStack: Stack;
 }
 export type CoreResult = {
+    /** Arbitrary data for isolated testing */
+    data?: Record<string, unknown>;
+} & ({
     /** Something went wrong. */
     success: false;
     /** The error message, if the operation failed. */
@@ -30,7 +33,7 @@ export type CoreResult = {
     /** The streaming function, if the operation is streaming. */
     streaming?: Promise<void>;
     error?: never;
-};
+});
 type InitBlueprintConfigParams = {
     bin: string;
     log: (msg: string) => void;

package/dist/server/app.d.ts

@@ -1,4 +1,5 @@
-declare const app: (port: number) => void;
+import { type InvokeExecutionOptions } from '../utils/types.js';
+declare const app: (port: number, executionOptions?: Partial<InvokeExecutionOptions>) => void;
 declare function parseDocumentUrl(url: string): {
     projectId: string;
     dataset: string;

package/dist/server/app.js

@@ -5,10 +5,10 @@ import { WebSocketServer } from 'ws';
 import { readLocalBlueprint } from '../actions/blueprints/blueprint.js';
 import config from '../config.js';
 import { isRecord } from '../utils/is-record.js';
-import { isEventType } from '../utils/types.js';
+import { isEventType, } from '../utils/types.js';
 import { handleInvokeRequest } from './handlers/invoke.js';
 const host = 'localhost';
-const app = (port) => {
+const app = (port, executionOptions) => {
     const requestListener = async (req, res) => {
         res.setHeader('Content-Type', 'application/json');
         switch (true) {
@@ -41,7 +41,7 @@ const app = (port) => {
                             else {
                                 delete context.clientOptions.token;
                             }
-                            const result = await handleInvokeRequest(functionName, event, metadata, context);
+                            const result = await handleInvokeRequest(functionName, event, metadata, context, executionOptions);
                             // Add Server-Timing header
                             const timingHeaders = [];
                             for (const [key, value] of Object.entries(result.timings)) {

package/dist/server/handlers/invoke.d.ts

@@ -1,4 +1,4 @@
-import type { InvocationResponse, InvokeContextOptions, InvokePayloadOptions } from '../../utils/types.js';
-export declare function handleInvokeRequest(functionName: string, event: Record<string, unknown>, metadata: Pick<InvokePayloadOptions, 'event' | 'before' | 'after'>, context: InvokeContextOptions): Promise<InvocationResponse & {
+import type { InvocationResponse, InvokeContextOptions, InvokeExecutionOptions, InvokePayloadOptions } from '../../utils/types.js';
+export declare function handleInvokeRequest(functionName: string, event: Record<string, unknown>, metadata: Pick<InvokePayloadOptions, 'event' | 'before' | 'after'>, context: InvokeContextOptions, executionOptions?: Partial<InvokeExecutionOptions>): Promise<InvocationResponse & {
     timings: Record<string, number>;
 }>;

package/dist/server/handlers/invoke.js

@@ -1,7 +1,7 @@
 import { readLocalBlueprint } from '../../actions/blueprints/blueprint.js';
 import { findFunctionByName } from '../../utils/find-function.js';
 import invoke from '../../utils/invoke-local.js';
-export async function handleInvokeRequest(functionName, event, metadata, context) {
+export async function handleInvokeRequest(functionName, event, metadata, context, executionOptions) {
     const start = performance.now();
     const { parsedBlueprint } = await readLocalBlueprint();
     const resource = findFunctionByName(parsedBlueprint, functionName);
@@ -11,8 +11,8 @@ export async function handleInvokeRequest(functionName, event, metadata, context
         ...metadata,
     };
     const response = await invoke(resource, payload, context, {
-        forceColor: false,
-        timeout: resource.timeout,
+        forceColor: executionOptions?.forceColor ?? false,
+        timeout: executionOptions?.timeout ?? resource.timeout,
     });
     const timings = { ...response.timings, 'blueprint:read': readBlueprintTime };
     return { ...response, timings };

package/dist/utils/get-headers.js

@@ -9,6 +9,7 @@ async function getUserAgent() {
     }
 }
 export default function getHeaders({ token, projectId }) {
+    // TODO: support organization scope type
     return {
         Accept: 'application/json',
         'Content-Type': 'application/json',