@sanity/runtime-cli 11.1.2 → 11.1.4

package/README.md

@@ -20,7 +20,7 @@ $ npm install -g @sanity/runtime-cli
 $ sanity-run COMMAND
 running command...
 $ sanity-run (--version)
-@sanity/runtime-cli/11.1.2 linux-x64 node-v24.11.0
+@sanity/runtime-cli/11.1.4 linux-x64 node-v24.11.1
 $ sanity-run --help [COMMAND]
 USAGE
   $ sanity-run COMMAND
@@ -92,7 +92,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/v11.1.2/src/commands/blueprints/add.ts)_
+_See code: [src/commands/blueprints/add.ts](https://github.com/sanity-io/runtime-cli/blob/v11.1.4/src/commands/blueprints/add.ts)_
 
 ## `sanity-run blueprints config`
 
@@ -124,7 +124,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/v11.1.2/src/commands/blueprints/config.ts)_
+_See code: [src/commands/blueprints/config.ts](https://github.com/sanity-io/runtime-cli/blob/v11.1.4/src/commands/blueprints/config.ts)_
 
 ## `sanity-run blueprints deploy`
 
@@ -146,7 +146,7 @@ EXAMPLES
   $ sanity-run blueprints deploy --no-wait
 ```
 
-_See code: [src/commands/blueprints/deploy.ts](https://github.com/sanity-io/runtime-cli/blob/v11.1.2/src/commands/blueprints/deploy.ts)_
+_See code: [src/commands/blueprints/deploy.ts](https://github.com/sanity-io/runtime-cli/blob/v11.1.4/src/commands/blueprints/deploy.ts)_
 
 ## `sanity-run blueprints destroy`
 
@@ -173,7 +173,7 @@ 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/v11.1.2/src/commands/blueprints/destroy.ts)_
+_See code: [src/commands/blueprints/destroy.ts](https://github.com/sanity-io/runtime-cli/blob/v11.1.4/src/commands/blueprints/destroy.ts)_
 
 ## `sanity-run blueprints doctor`
 
@@ -191,7 +191,7 @@ DESCRIPTION
   Diagnose potential issues with Blueprint configuration
 ```
 
-_See code: [src/commands/blueprints/doctor.ts](https://github.com/sanity-io/runtime-cli/blob/v11.1.2/src/commands/blueprints/doctor.ts)_
+_See code: [src/commands/blueprints/doctor.ts](https://github.com/sanity-io/runtime-cli/blob/v11.1.4/src/commands/blueprints/doctor.ts)_
 
 ## `sanity-run blueprints info`
 
@@ -213,7 +213,7 @@ EXAMPLES
   $ sanity-run blueprints info --stack-id <stackId>
 ```
 
-_See code: [src/commands/blueprints/info.ts](https://github.com/sanity-io/runtime-cli/blob/v11.1.2/src/commands/blueprints/info.ts)_
+_See code: [src/commands/blueprints/info.ts](https://github.com/sanity-io/runtime-cli/blob/v11.1.4/src/commands/blueprints/info.ts)_
 
 ## `sanity-run blueprints init [DIR]`
 
@@ -252,7 +252,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/v11.1.2/src/commands/blueprints/init.ts)_
+_See code: [src/commands/blueprints/init.ts](https://github.com/sanity-io/runtime-cli/blob/v11.1.4/src/commands/blueprints/init.ts)_
 
 ## `sanity-run blueprints logs`
 
@@ -274,7 +274,7 @@ EXAMPLES
   $ sanity-run blueprints logs --watch
 ```
 
-_See code: [src/commands/blueprints/logs.ts](https://github.com/sanity-io/runtime-cli/blob/v11.1.2/src/commands/blueprints/logs.ts)_
+_See code: [src/commands/blueprints/logs.ts](https://github.com/sanity-io/runtime-cli/blob/v11.1.4/src/commands/blueprints/logs.ts)_
 
 ## `sanity-run blueprints plan`
 
@@ -291,7 +291,7 @@ EXAMPLES
   $ sanity-run blueprints plan
 ```
 
-_See code: [src/commands/blueprints/plan.ts](https://github.com/sanity-io/runtime-cli/blob/v11.1.2/src/commands/blueprints/plan.ts)_
+_See code: [src/commands/blueprints/plan.ts](https://github.com/sanity-io/runtime-cli/blob/v11.1.4/src/commands/blueprints/plan.ts)_
 
 ## `sanity-run blueprints stacks`
 
@@ -316,7 +316,7 @@ EXAMPLES
   $ sanity-run blueprints stacks --organization-id <organizationId>
 ```
 
-_See code: [src/commands/blueprints/stacks.ts](https://github.com/sanity-io/runtime-cli/blob/v11.1.2/src/commands/blueprints/stacks.ts)_
+_See code: [src/commands/blueprints/stacks.ts](https://github.com/sanity-io/runtime-cli/blob/v11.1.4/src/commands/blueprints/stacks.ts)_
 
 ## `sanity-run functions add`
 
@@ -358,7 +358,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/v11.1.2/src/commands/functions/add.ts)_
+_See code: [src/commands/functions/add.ts](https://github.com/sanity-io/runtime-cli/blob/v11.1.4/src/commands/functions/add.ts)_
 
 ## `sanity-run functions dev`
 
@@ -366,10 +366,11 @@ Start the Sanity Function emulator
 
 ```
 USAGE
-  $ sanity-run functions dev [-p <value>] [-t <value>]
+  $ sanity-run functions dev [-h <value>] [-p <value>] [-t <value>]
 
 FLAGS
-  -p, --port=<value>     Port to start emulator on
+  -h, --host=<value>     The local network interface at which to listen. [default: "localhost"]
+  -p, --port=<value>     TCP port to start emulator on. [default: 8080]
   -t, --timeout=<value>  Maximum execution time for all functions, in seconds. Takes precedence over function-specific
                          `timeout`
 
@@ -377,10 +378,10 @@ DESCRIPTION
   Start the Sanity Function emulator
 
 EXAMPLES
-  $ sanity-run functions dev --port 8974
+  $ sanity-run functions dev --host 127.0.0.1 --port 8974
 ```
 
-_See code: [src/commands/functions/dev.ts](https://github.com/sanity-io/runtime-cli/blob/v11.1.2/src/commands/functions/dev.ts)_
+_See code: [src/commands/functions/dev.ts](https://github.com/sanity-io/runtime-cli/blob/v11.1.4/src/commands/functions/dev.ts)_
 
 ## `sanity-run functions env add NAME KEY VALUE`
 
@@ -402,7 +403,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/v11.1.2/src/commands/functions/env/add.ts)_
+_See code: [src/commands/functions/env/add.ts](https://github.com/sanity-io/runtime-cli/blob/v11.1.4/src/commands/functions/env/add.ts)_
 
 ## `sanity-run functions env list NAME`
 
@@ -422,7 +423,7 @@ EXAMPLES
   $ sanity-run functions env list MyFunction
 ```
 
-_See code: [src/commands/functions/env/list.ts](https://github.com/sanity-io/runtime-cli/blob/v11.1.2/src/commands/functions/env/list.ts)_
+_See code: [src/commands/functions/env/list.ts](https://github.com/sanity-io/runtime-cli/blob/v11.1.4/src/commands/functions/env/list.ts)_
 
 ## `sanity-run functions env remove NAME KEY`
 
@@ -443,7 +444,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/v11.1.2/src/commands/functions/env/remove.ts)_
+_See code: [src/commands/functions/env/remove.ts](https://github.com/sanity-io/runtime-cli/blob/v11.1.4/src/commands/functions/env/remove.ts)_
 
 ## `sanity-run functions logs NAME`
 
@@ -477,7 +478,7 @@ EXAMPLES
   $ sanity-run functions logs <name> --delete
 ```
 
-_See code: [src/commands/functions/logs.ts](https://github.com/sanity-io/runtime-cli/blob/v11.1.2/src/commands/functions/logs.ts)_
+_See code: [src/commands/functions/logs.ts](https://github.com/sanity-io/runtime-cli/blob/v11.1.4/src/commands/functions/logs.ts)_
 
 ## `sanity-run functions test NAME`
 
@@ -526,7 +527,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/v11.1.2/src/commands/functions/test.ts)_
+_See code: [src/commands/functions/test.ts](https://github.com/sanity-io/runtime-cli/blob/v11.1.4/src/commands/functions/test.ts)_
 
 ## `sanity-run help [COMMAND]`
 

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

@@ -1,2 +1,2 @@
 import type { InvokeExecutionOptions } from '../../utils/types.js';
-export declare function dev(port: number, executionOptions?: Partial<InvokeExecutionOptions>): Promise<void>;
+export declare function dev(host: string, 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, executionOptions) {
-    app(Number(port), executionOptions);
+export async function dev(host, port, executionOptions) {
+    app(host, Number(port), executionOptions);
 }

package/dist/actions/functions/test.js

@@ -1,10 +1,10 @@
 import invoke from '../../utils/invoke-local.js';
 export async function testAction(resource, payload, context, options) {
     try {
-        const { json, logs } = await invoke(resource, payload, context, options);
-        return { error: undefined, json, logs };
+        const { json, logs, error } = await invoke(resource, payload, context, options);
+        return { error: error, json, logs };
     }
     catch (error) {
-        return { error, json: undefined, logs: undefined };
+        return { error: error, json: undefined, logs: undefined };
     }
 }

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

@@ -3,6 +3,7 @@ export default class DevCommand extends Command {
     static description: string;
     static examples: string[];
     static flags: {
+        host: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         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>;
     };

package/dist/commands/functions/dev.js

@@ -2,9 +2,18 @@ import { Command, Flags } from '@oclif/core';
 import { functionDevCore } from '../../cores/functions/dev.js';
 export default class DevCommand extends Command {
     static description = 'Start the Sanity Function emulator';
-    static examples = ['<%= config.bin %> <%= command.id %> --port 8974'];
+    static examples = ['<%= config.bin %> <%= command.id %> --host 127.0.0.1 --port 8974'];
     static flags = {
-        port: Flags.integer({ char: 'p', description: 'Port to start emulator on', required: false }),
+        host: Flags.string({
+            char: 'h',
+            description: 'The local network interface at which to listen. [default: "localhost"]',
+            required: false,
+        }),
+        port: Flags.integer({
+            char: 'p',
+            description: 'TCP port to start emulator on. [default: 8080]',
+            required: false,
+        }),
         timeout: Flags.integer({
             char: 't',
             description: 'Maximum execution time for all functions, in seconds. Takes precedence over function-specific `timeout`',

package/dist/cores/blueprints/plan.js

@@ -18,8 +18,6 @@ export async function blueprintPlanCore(options) {
             const diff = stackDeployDiff(parsedBlueprint, stackResponse.stack);
             if (diff)
                 log(diff);
-            else
-                log(chalk.dim('No changes detected to live deployment'));
         }
     }
     log(`\n  Run "${chalk.bold.magenta(`${bin} blueprints deploy`)}" to deploy these changes`);

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

@@ -1,6 +1,7 @@
 import type { CoreConfig, CoreResult } from '../index.js';
 export interface FunctionDevOptions extends CoreConfig {
     flags: {
+        host?: string;
         port?: number;
         timeout?: number;
     };

package/dist/cores/functions/dev.js

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

package/dist/cores/functions/test.js

@@ -129,7 +129,7 @@ export async function functionTestCore(options) {
             spinner.fail('Function execution failed.');
             return {
                 success: false,
-                error: error.toString(),
+                error: error.stack || error.message || error.name,
             };
         }
         spinner.succeed('Function execution succeeded.');

package/dist/cores/index.js

@@ -51,7 +51,7 @@ export async function initDeployedBlueprintConfig(config) {
     const auth = { token: config.token, scopeType, scopeId };
     const stackResponse = await getStack({ stackId, auth });
     if (!stackResponse.ok) {
-        config.log(`Could not retrieve deployment info for ${niceId(stackId)}. Was it destroyed?`);
+        config.log(`Could not retrieve deployment info for ${niceId(stackId)}.`);
         config.log(`Run \`${config.bin} blueprints doctor\` for diagnostics.`);
         return { ok: false, error: 'Missing deployment' };
     }

package/dist/server/app.d.ts

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

package/dist/server/app.js

@@ -7,8 +7,7 @@ import config from '../config.js';
 import { isRecord } from '../utils/is-record.js';
 import { isEventType, } from '../utils/types.js';
 import { handleInvokeRequest } from './handlers/invoke.js';
-const host = 'localhost';
-const app = (port, executionOptions) => {
+const app = (host, port, executionOptions) => {
     const requestListener = async (req, res) => {
         res.setHeader('Content-Type', 'application/json');
         switch (true) {

package/dist/server/static/components/console-panel.js

@@ -29,7 +29,7 @@ class ConsolePanel extends ApiBaseElement {
     let update = ''
     if (error) {
       // Display error details in the console
-      update = error?.details?.error ?? 'An error occurred.'
+      update = (error.stack || error.message || error.name) ?? 'An error occurred.'
     } else {
       // Display regular logs
       update = logs ?? '' // Handle case where logs might be null/undefined

package/dist/utils/child-process-wrapper.js

@@ -84,44 +84,62 @@ process.on('message', async (data) => {
     // invalid payload so return early
     return
   }
+
   const {srcPath, payload} = jsonData
   const {context, ...event} = payload
+
   let logs = ''
+  let errorLogs = ''
   let json = null
 
-  // Import the function code
-  const entry = await import(getFunctionSource(srcPath))
-
-  let eventHandler = null
-
-  if (typeof entry.handler === 'function') {
-    eventHandler = entry.handler
-  } else if (typeof entry.default === 'function') {
-    eventHandler = entry.default
-  }
-
-  if (!eventHandler) {
-    throw new Error(
-      'No valid handler found. Please provide a default export or a named export, "handler"',
-    )
-  }
-
-  // backup stdout
+  // Capture stdout and stderr
   const originalStdoutWrite = process.stdout.write.bind(process.stdout)
+  const originalStderrWrite = process.stderr.write.bind(process.stderr)
 
-  // redirect stdout to a buffer
   process.stdout.write = (chunk) => {
-    if (typeof chunk === 'string') {
-      logs += chunk
-    }
+    if (typeof chunk === 'string') logs += chunk
+    return true
+  }
+  process.stderr.write = (chunk) => {
+    if (typeof chunk === 'string') errorLogs += chunk
     return true
   }
 
-  json = await eventHandler({context, event})
-
-  // revert changes to stdout
-  process.stdout.write = originalStdoutWrite
+  try {
+    // Import the function code
+    const entry = await import(getFunctionSource(srcPath))
+    const eventHandler = entry.handler || entry.default
+
+    if (typeof eventHandler !== 'function') {
+      throw new Error(
+        'No valid handler found. Please provide a default export or a named export, "handler"',
+      )
+    }
 
-  // Send result of handler code to parent process.
-  process.send(JSON.stringify({json, logs}))
+    json = await eventHandler({context, event})
+
+    // Restore streams
+    process.stdout.write = originalStdoutWrite
+    process.stderr.write = originalStderrWrite
+
+    // Send result to parent
+    process.send(JSON.stringify({json, logs, errorLogs}))
+  } catch (err) {
+    // Restore streams on error
+    process.stdout.write = originalStdoutWrite
+    process.stderr.write = originalStderrWrite
+
+    const errorInfo = {
+      json: null,
+      logs,
+      errorLogs,
+      error: {
+        message: err?.message,
+        stack: err?.stack,
+        name: err?.name,
+      },
+    }
+    process.send(JSON.stringify(errorInfo))
+    process.exit(1)
+  }
 })

package/dist/utils/invoke-local.js

@@ -106,17 +106,26 @@ export default async function invoke(resource, payload, context, options) {
             executionStart = performance.now();
             child = spawn('node', ['--enable-source-maps', getChildProcessWrapperPath()], {
                 cwd: cwd(),
-                stdio: ['inherit', 'inherit', 'inherit', 'ipc'],
+                stdio: ['pipe', 'pipe', 'pipe', 'ipc'], // changed: use 'pipe' so we can capture output
                 env: { ...process.env, ...resource.env, FORCE_COLOR: forceColor ? '1' : '0' },
             });
+            // NEW: capture stdout and stderr
+            let stdout = '';
+            let stderr = '';
+            child.stdout?.on('data', (data) => {
+                stdout += data.toString();
+            });
+            child.stderr?.on('data', (data) => {
+                stderr += data.toString();
+            });
             child.on('message', (data) => {
                 const executionTimeMs = performance.now() - executionStart;
-                const { json, logs } = JSON.parse(data.toString());
+                const { json, logs, error } = JSON.parse(data.toString());
                 shutdown();
                 resolve({
                     json,
                     logs: sanitizeLogs(logs),
-                    error: undefined,
+                    error,
                     timings: {
                         ...bundleTimings,
                         execute: executionTimeMs,
@@ -131,12 +140,16 @@ export default async function invoke(resource, payload, context, options) {
                 const executionTimeMs = performance.now() - executionStart;
                 shutdown();
                 if (code !== 0) {
-                    reject(new Error(`exited with code ${code}`));
+                    // use captured stderr if available
+                    const message = stderr.trim().length > 0
+                        ? `Process failed with code ${code}\n${stderr}`
+                        : `exited with code ${code}`;
+                    reject(new Error(message));
                 }
                 else {
                     resolve({
                         json: undefined,
-                        logs: '',
+                        logs: sanitizeLogs(stdout),
                         error: undefined,
                         timings: {
                             ...bundleTimings,

package/dist/utils/types.d.ts

@@ -138,12 +138,18 @@ export interface InvokeExecutionOptions {
 }
 /** @internal */
 export interface InvocationResponse {
-    error: undefined | unknown;
+    error: InvocationError | undefined;
     json: JsonInvocationResponse | undefined;
     logs: string | undefined;
     timings?: Record<string, number>;
 }
 /** @internal */
+export interface InvocationError {
+    stack: string;
+    message: string;
+    name: string;
+}
+/** @internal */
 export interface JsonInvocationResponse {
     data: Record<string, unknown> | undefined;
 }

package/oclif.manifest.json

@@ -866,12 +866,21 @@
       "args": {},
       "description": "Start the Sanity Function emulator",
       "examples": [
-        "<%= config.bin %> <%= command.id %> --port 8974"
+        "<%= config.bin %> <%= command.id %> --host 127.0.0.1 --port 8974"
       ],
       "flags": {
+        "host": {
+          "char": "h",
+          "description": "The local network interface at which to listen. [default: \"localhost\"]",
+          "name": "host",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
         "port": {
           "char": "p",
-          "description": "Port to start emulator on",
+          "description": "TCP port to start emulator on. [default: 8080]",
           "name": "port",
           "required": false,
           "hasDynamicHelp": false,
@@ -1408,5 +1417,5 @@
       ]
     }
   },
-  "version": "11.1.2"
+  "version": "11.1.4"
 }

package/package.json

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