@sanity/runtime-cli 16.0.3 → 17.1.0-next.g3cb2d2e

package/dist/utils/logger.d.ts

@@ -5,6 +5,7 @@ export declare function Logger(log: (msg: string) => void, flags?: {
     json?: boolean;
 }): {
     (msg: string): void;
+    isTraceEnabled: boolean;
     trace(formatter: unknown, ...args: unknown[]): false | void;
     verbose(formatter: unknown, ...args: unknown[]): false | void;
     info(formatter: unknown, ...args: unknown[]): false | void;

package/dist/utils/logger.js

@@ -13,6 +13,7 @@ export function Logger(log, flags = {}) {
         log(msg);
     };
     const level = flags.verbose ? LogLevel.VERBOSE : flags.trace ? LogLevel.TRACE : LogLevel.INFO;
+    logger.isTraceEnabled = level <= LogLevel.TRACE;
     logger.trace = (formatter, ...args) => level <= LogLevel.TRACE && logger(format(formatter, ...args));
     logger.verbose = (formatter, ...args) => level <= LogLevel.VERBOSE && logger(format(formatter, ...args));
     logger.info = (formatter, ...args) => level <= LogLevel.INFO && logger(format(formatter, ...args));

package/dist/utils/style-text.js

@@ -1,5 +1,6 @@
-import { env, stdout } from 'node:process';
+import { env } from 'node:process';
 import { styleText as nodeStyleText } from 'node:util';
+import { isInteractive } from './interactive.js';
 function supportsColor() {
     /*
      * https://force-color.org
@@ -32,10 +33,8 @@ function supportsColor() {
     if (env.NODE_DISABLE_COLORS !== undefined && env.NODE_DISABLE_COLORS !== '') {
         return false;
     }
-    /*
-     * If the stdout is a TTY, use colors.
-     */
-    return typeof stdout?.isTTY === 'boolean' && stdout.isTTY;
+    // if interactive, use colors
+    return isInteractive;
 }
 export const styleText = (format, text) => {
     if (!supportsColor())

package/dist/utils/traced-fetch.js

@@ -173,6 +173,8 @@ export function createTracedFetch(logger, options) {
         ...options,
     };
     return async (input, init) => {
+        if (!logger.isTraceEnabled)
+            return fetch(input, init);
         const requestId = randomUUID().slice(0, 3);
         const url = typeof input === 'string' ? input : input instanceof URL ? input.toString() : input.url;
         const method = init?.method || 'GET';

package/dist/utils/types.d.ts

@@ -98,13 +98,14 @@ export interface InvokeGroqPayloadOptions {
     before: Record<string, unknown> | null;
     after: Record<string, unknown> | null;
 }
-export interface InvokeSchedulePayloadOptions {
+export interface InvokeNonGroqPayloadOptions {
     payload?: Record<string, unknown>;
-    event: 'scheduled';
+    event: NonGroqEventType;
 }
-export type InvokePayloadOptions = InvokeGroqPayloadOptions | InvokeSchedulePayloadOptions;
-export type InvokePayloadMetadata = Pick<InvokeGroqPayloadOptions, 'event' | 'before' | 'after'> | Pick<InvokeSchedulePayloadOptions, 'event'>;
+export type InvokePayloadOptions = InvokeGroqPayloadOptions | InvokeNonGroqPayloadOptions;
+export type InvokePayloadMetadata = Pick<InvokeGroqPayloadOptions, 'event' | 'before' | 'after'> | Pick<InvokeNonGroqPayloadOptions, 'event'>;
 export type EventType = 'create' | 'update' | 'delete';
+export type NonGroqEventType = 'scheduled' | 'nested';
 export declare function isEventType(arg: string): arg is EventType;
 /** @internal */
 export interface InvokeGroqContextOptions {
@@ -140,7 +141,64 @@ export declare function isGroqContextOptions(context: InvokeContextOptions): con
 export interface InvokeExecutionOptions {
     forceColor?: boolean;
     timeout?: number;
+    /**
+     * Callback used to resolve a nested `context.invoke(name, payload)` made from
+     * within a running function. When absent, nested invokes are rejected.
+     * @internal
+     */
+    onNestedInvoke?: NestedInvoke;
+    /** Current invocation depth, used to bound nested `context.invoke` recursion. @internal */
+    depth?: number;
+    /** Function names already on the invoke call stack (innermost last), used to detect cycles. @internal */
+    callStack?: string[];
 }
+/**
+ * Re-entrant callback that executes a named function from the blueprint on behalf
+ * of a nested `context.invoke(name, payload)` and returns its invocation result.
+ * @internal
+ */
+export type NestedInvoke = (name: string, payload: Record<string, unknown>, context: InvokeContextOptions, depth: number, callStack: string[]) => Promise<InvocationResponse & {
+    timings: Record<string, number>;
+}>;
+/**
+ * IPC messages sent from the parent (invoke-local) down to a function child process.
+ * @internal
+ */
+export type ParentToChildMessage = {
+    type: 'start';
+    srcPath: string;
+    payload: unknown;
+} | {
+    type: 'invoke-response';
+    id: string;
+    ok: true;
+    result: {
+        json: JsonInvocationResponse | undefined;
+    };
+} | {
+    type: 'invoke-response';
+    id: string;
+    ok: false;
+    error: InvocationError;
+};
+/**
+ * IPC messages sent from a function child process back up to the parent.
+ * `result` is terminal and triggers shutdown; `invoke-request` is a nested
+ * `context.invoke` awaiting a correlated `invoke-response`.
+ * @internal
+ */
+export type ChildToParentMessage = {
+    type: 'invoke-request';
+    id: string;
+    name: string;
+    payload: Record<string, unknown>;
+} | {
+    type: 'result';
+    json?: JsonInvocationResponse;
+    logs?: string;
+    errorLogs?: string;
+    error?: InvocationError;
+};
 /** @internal */
 export interface InvocationResponse {
     error: InvocationError | undefined;

package/oclif.manifest.json

@@ -839,13 +839,14 @@
       "aliases": [],
       "args": {
         "dir": {
-          "description": "Directory to create the local Blueprint in",
+          "description": "Directory to create the local Blueprint in (defaults to the current directory)",
           "name": "dir"
         }
       },
-      "description": "A Blueprint is your local infrastructure-as-code configuration that defines Sanity resources (datasets, functions, etc.). A Stack is the remote deployment target where your Blueprint is applied.\n[NOTE: Currently, accounts are limited to three (3) Stacks per project scope.]\n\nThis is typically the first command you run in a new project. It creates a local Blueprint manifest file (sanity.blueprint.ts, .js, or .json) and provisions a new remote Stack.\nAdditionally, a Blueprint configuration file is created in .sanity/ containing the scope and Stack IDs. This is .gitignored by default.\n\nAfter initialization, use 'blueprints plan' to preview changes, then 'blueprints deploy' to apply them.",
+      "description": "A Blueprint is your local infrastructure-as-code configuration that defines Sanity resources (datasets, functions, etc.). A Stack is the remote deployment target where your Blueprint is applied.\n[NOTE: Currently, accounts are limited to three (3) Stacks per project scope.]\n\nThis is typically the first command you run in a new project. It creates a local Blueprint manifest file (sanity.blueprint.ts, .js, or .json) and provisions a new remote Stack.\nAdditionally, a Blueprint configuration file is created in .sanity/ containing the scope and Stack IDs. This is .gitignored by default.\n\nAfter initialization, use 'blueprints plan' to preview changes, then 'blueprints deploy' to apply them.\n\nRunning without a directory prompts to confirm the current directory. Run 'blueprints init .' to initialize in the current directory without a prompt.",
       "examples": [
         "<%= config.bin %> <%= command.id %>",
+        "<%= config.bin %> <%= command.id %> .",
         "<%= config.bin %> <%= command.id %> [directory]",
         "<%= config.bin %> <%= command.id %> --blueprint-type <json|js|ts>",
         "<%= config.bin %> <%= command.id %> --organization-id <organizationId>",
@@ -2996,5 +2997,5 @@
       ]
     }
   },
-  "version": "16.0.3"
+  "version": "17.1.0-next.g3cb2d2e"
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@sanity/runtime-cli",
   "description": "Sanity's Runtime CLI for Blueprints and Functions",
-  "version": "16.0.3",
+  "version": "17.1.0-next.g3cb2d2e",
   "author": "Sanity Runtime Team",
   "type": "module",
   "license": "MIT",
@@ -21,7 +21,7 @@
     }
   },
   "engines": {
-    "node": ">=20.19"
+    "node": ">=22.12"
   },
   "files": [
     "./bin",
@@ -58,27 +58,27 @@
     "watch": "tsc --watch"
   },
   "dependencies": {
-    "@architect/hydrate": "^5.0.2",
-    "@architect/inventory": "^5.0.0",
-    "@inquirer/prompts": "^8.4.2",
-    "@oclif/core": "^4.11.0",
-    "@oclif/plugin-help": "^6.2.46",
+    "@architect/hydrate": "~6.0.2",
+    "@architect/inventory": "~6.0.0",
+    "@inquirer/prompts": "^8.5.2",
+    "@oclif/core": "^4.11.6",
+    "@oclif/plugin-help": "^6.2.50",
     "@sanity-labs/design-tokens": "^0.0.2-alpha.2",
     "@sanity/blueprints": "^0.20.1",
     "@sanity/blueprints-parser": "^0.4.0",
-    "@sanity/client": "^7.22.0",
+    "@sanity/client": "^7.22.1",
     "adm-zip": "^0.5.17",
     "array-treeify": "^0.1.5",
     "cardinal": "^2.1.1",
-    "empathic": "^2.0.0",
+    "empathic": "^2.0.1",
     "eventsource": "^4.1.0",
-    "groq-js": "^1.30.1",
+    "groq-js": "^1.30.2",
     "jiti": "^2.7.0",
     "mime-types": "^3.0.2",
     "ora": "^9.4.0",
     "tar-stream": "^3.2.0",
     "vite": "^8.0.16",
-    "ws": "^8.20.0",
+    "ws": "^8.21.0",
     "xdg-basedir": "^5.1.0"
   },
   "devDependencies": {
@@ -94,10 +94,10 @@
     "@types/adm-zip": "^0.5.8",
     "@types/cardinal": "^2.1.1",
     "@types/mime-types": "^3.0.1",
-    "@types/node": "20",
+    "@types/node": "^22",
     "@types/tar-stream": "^3.1.4",
     "@types/ws": "^8.18.1",
-    "@vitest/coverage-v8": "^4.1.5",
+    "@vitest/coverage-v8": "4.1.9",
     "codemirror": "^6.0.2",
     "mentoss": "^0.13.0",
     "oclif": "^4.23.0",
@@ -107,7 +107,7 @@
     "shx": "^0.4.0",
     "ts-node": "^10.9.2",
     "typescript": "^6.0.3",
-    "vitest": "4.1.5"
+    "vitest": "4.1.9"
   },
   "oclif": {
     "bin": "sanity-run",
@@ -129,5 +129,9 @@
   "publishConfig": {
     "access": "public",
     "provenance": false
+  },
+  "allowScripts": {
+    "fsevents@2.3.2": true,
+    "fsevents@2.3.3": true
   }
 }

package/dist/server/static/hot-reload.js

@@ -1,16 +0,0 @@
-import apiConstructor from '../api.js'
-
-const api = apiConstructor()
-
-// Create WebSocket connection.
-const socket = new WebSocket('ws://localhost:8974')
-
-// Connection opened
-socket.addEventListener('open', () => {
-  console.log('Watching for Blueprint changes')
-})
-
-// Listen for messages
-socket.addEventListener('message', (event) => {
-  if (event.data === 'reload-blueprint') api.blueprint()
-})

package/dist/utils/functions/invoke-local.js

@@ -1,185 +0,0 @@
-import { spawn } from 'node:child_process';
-import { performance } from 'node:perf_hooks';
-import { cwd } from 'node:process';
-import { setTimeout } from 'node:timers';
-import { fileURLToPath } from 'node:url';
-import * as groq from 'groq-js';
-import config from '../../config.js';
-import { groupBlueprintResources } from '../blueprints/group-resources.js';
-import { isGroqContextOptions, } from '../types.js';
-import { findFunctionEntryPoint } from './find-entry-point.js';
-import { cleanupTempPackageJson, createTempPackageJson, doesPackageJsonExists, } from './package-json.js';
-import { resolveResourceDependencies } from './resolve-dependencies.js';
-import { shouldAutoResolveDependencies } from './should-auto-resolve-deps.js';
-import { shouldTranspileFunction } from './should-transpile.js';
-import { transpileFunction } from './transpile/function.js';
-function getChildProcessWrapperPath() {
-    return fileURLToPath(new URL('./child-process-wrapper.js', import.meta.url));
-}
-export function sanitizeLogs(logs) {
-    return logs.replace(/([a-zA-Z0-9]{10})[a-zA-Z0-9]{65,}/g, '$1**********');
-}
-export async function applyGroqRule(resource, payload, projectId, dataset) {
-    const { before, after, payload: data = null } = payload;
-    // If there is no rule set return everything
-    if (!resource.event)
-        return data;
-    // default groq rule is: gimme full doc content. otherwise, parse + eval custom rule
-    // applying the GROQ filter may result in a slimmer set of documents
-    if (resource.event.filter || resource.event.projection) {
-        const query = `*[${resource.event.filter || ''}]${resource.event.projection || ''}`;
-        try {
-            const rule = groq.parse(query, { mode: 'delta' });
-            const sanity = projectId && dataset ? { projectId, dataset } : undefined;
-            const queryResults = await groq.evaluate(rule, { dataset: [data], before, after, sanity });
-            const currentFunctionDocumentSet = await queryResults.get();
-            return currentFunctionDocumentSet[0];
-        }
-        catch (groqErr) {
-            const detail = groqErr instanceof Error && `; ${groqErr.message}`;
-            throw new Error(`Invalid rule configuration: ${query}${detail}`, { cause: groqErr });
-        }
-    }
-    // default groq rule so just return the data
-    return data;
-}
-export default async function invoke(resource, payload, context, options) {
-    if (!resource.src) {
-        throw new Error(`Function resource "${resource.name}" is missing the 'src' property.`);
-    }
-    let cleanupBundle = async () => { };
-    let functionPath = '';
-    let bundleTimings;
-    // If no package.json exists we will create a temporary one to avoid the
-    // Module Type warning from node
-    const existingPackageJson = doesPackageJsonExists(resource);
-    const shouldTranspile = await shouldTranspileFunction(resource);
-    if (shouldTranspile) {
-        const transpileResult = await transpileFunction(resource);
-        functionPath = await findFunctionEntryPoint(transpileResult.outputDir);
-        bundleTimings = transpileResult.timings;
-        cleanupBundle = transpileResult.cleanup;
-    }
-    else {
-        functionPath = await findFunctionEntryPoint(resource.src, resource.displayName ?? resource.name);
-    }
-    const shouldResolveDependencies = await shouldAutoResolveDependencies(resource);
-    if (shouldResolveDependencies && existingPackageJson) {
-        await resolveResourceDependencies(resource, { transpiled: shouldTranspile });
-    }
-    if (!existingPackageJson) {
-        createTempPackageJson(functionPath);
-    }
-    const { forceColor = true, timeout = 10 } = options;
-    let filteredData = payload?.payload?.data || {};
-    if (resource.type === 'sanity.function.document' ||
-        resource.type === 'sanity.function.media-library.asset') {
-        if (!isGroqContextOptions(context)) {
-            throw new Error('GROQ-based functions require a context with clientOptions');
-        }
-        const { projectId, dataset } = context.clientOptions;
-        if ('before' in payload) {
-            filteredData = await applyGroqRule(resource, payload, projectId, dataset);
-            if (typeof filteredData === 'undefined') {
-                return {
-                    logs: `⚠️ Filter "${resource.event?.filter}" returned an empty result. Skipping invoke.`,
-                    error: undefined,
-                    json: undefined,
-                };
-            }
-        }
-    }
-    return new Promise((resolve, reject) => {
-        let child;
-        let timer;
-        let executionStart;
-        function start() {
-            executionStart = performance.now();
-            child = spawn('node', ['--enable-source-maps', getChildProcessWrapperPath()], {
-                cwd: cwd(),
-                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, error } = JSON.parse(data.toString());
-                shutdown();
-                resolve({
-                    json,
-                    logs: sanitizeLogs(logs),
-                    error,
-                    timings: {
-                        ...bundleTimings,
-                        execute: executionTimeMs,
-                    },
-                });
-            });
-            child.on('error', (error) => {
-                shutdown();
-                reject(new Error(`encountered error ${error.message}`));
-            });
-            child.on('exit', (code) => {
-                const executionTimeMs = performance.now() - executionStart;
-                shutdown();
-                if (code !== 0) {
-                    // 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: sanitizeLogs(stdout),
-                        error: undefined,
-                        timings: {
-                            ...bundleTimings,
-                            execute: executionTimeMs,
-                        },
-                    });
-                }
-            });
-            timer = setTimeout(() => {
-                shutdown();
-                reject(new Error(`Timeout: Function exceeded the ${timeout}-second time limit.`));
-            }, timeout * 1000);
-            const payload = {
-                data: { ...filteredData },
-                context: {
-                    ...context,
-                    local: true,
-                    resources: groupBlueprintResources(context.resources ?? []),
-                    ...(isGroqContextOptions(context) && {
-                        clientOptions: {
-                            ...context.clientOptions,
-                            apiHost: config.apiUrl,
-                        },
-                    }),
-                },
-            };
-            child.send(JSON.stringify({ srcPath: functionPath, payload }, null, 2));
-        }
-        function shutdown() {
-            clearTimeout(timer);
-            if (child && !child.killed) {
-                child.kill();
-            }
-            // If we previously created a temporary package.json, let's clean it up
-            if (!existingPackageJson) {
-                cleanupTempPackageJson(functionPath);
-            }
-            cleanupBundle().catch((err) => console.warn('Bundle cleanup failed:', err));
-        }
-        start();
-    });
-}