@sanity/runtime-cli 17.9.0 → 17.10.0

package/README.md

@@ -90,7 +90,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.9.0/src/commands/blueprints/add.ts)_
+_See code: [src/commands/blueprints/add.ts](https://github.com/sanity-io/runtime-cli/blob/v17.10.0/src/commands/blueprints/add.ts)_
 
 ## `sanity-run blueprints config`
 
@@ -127,7 +127,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.9.0/src/commands/blueprints/config.ts)_
+_See code: [src/commands/blueprints/config.ts](https://github.com/sanity-io/runtime-cli/blob/v17.10.0/src/commands/blueprints/config.ts)_
 
 ## `sanity-run blueprints deploy`
 
@@ -183,7 +183,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.9.0/src/commands/blueprints/deploy.ts)_
+_See code: [src/commands/blueprints/deploy.ts](https://github.com/sanity-io/runtime-cli/blob/v17.10.0/src/commands/blueprints/deploy.ts)_
 
 ## `sanity-run blueprints destroy`
 
@@ -221,7 +221,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.9.0/src/commands/blueprints/destroy.ts)_
+_See code: [src/commands/blueprints/destroy.ts](https://github.com/sanity-io/runtime-cli/blob/v17.10.0/src/commands/blueprints/destroy.ts)_
 
 ## `sanity-run blueprints doctor`
 
@@ -253,7 +253,7 @@ EXAMPLES
   $ sanity-run blueprints doctor --fix
 ```
 
-_See code: [src/commands/blueprints/doctor.ts](https://github.com/sanity-io/runtime-cli/blob/v17.9.0/src/commands/blueprints/doctor.ts)_
+_See code: [src/commands/blueprints/doctor.ts](https://github.com/sanity-io/runtime-cli/blob/v17.10.0/src/commands/blueprints/doctor.ts)_
 
 ## `sanity-run blueprints info`
 
@@ -291,7 +291,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.9.0/src/commands/blueprints/info.ts)_
+_See code: [src/commands/blueprints/info.ts](https://github.com/sanity-io/runtime-cli/blob/v17.10.0/src/commands/blueprints/info.ts)_
 
 ## `sanity-run blueprints init [DIR]`
 
@@ -355,7 +355,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.9.0/src/commands/blueprints/init.ts)_
+_See code: [src/commands/blueprints/init.ts](https://github.com/sanity-io/runtime-cli/blob/v17.10.0/src/commands/blueprints/init.ts)_
 
 ## `sanity-run blueprints logs`
 
@@ -401,7 +401,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.9.0/src/commands/blueprints/logs.ts)_
+_See code: [src/commands/blueprints/logs.ts](https://github.com/sanity-io/runtime-cli/blob/v17.10.0/src/commands/blueprints/logs.ts)_
 
 ## `sanity-run blueprints mint-deploy-token`
 
@@ -446,7 +446,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.9.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.10.0/src/commands/blueprints/mint-deploy-token.ts)_
 
 ## `sanity-run blueprints plan`
 
@@ -479,7 +479,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.9.0/src/commands/blueprints/plan.ts)_
+_See code: [src/commands/blueprints/plan.ts](https://github.com/sanity-io/runtime-cli/blob/v17.10.0/src/commands/blueprints/plan.ts)_
 
 ## `sanity-run blueprints promote`
 
@@ -515,7 +515,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.9.0/src/commands/blueprints/promote.ts)_
+_See code: [src/commands/blueprints/promote.ts](https://github.com/sanity-io/runtime-cli/blob/v17.10.0/src/commands/blueprints/promote.ts)_
 
 ## `sanity-run blueprints stacks`
 
@@ -556,7 +556,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.9.0/src/commands/blueprints/stacks.ts)_
+_See code: [src/commands/blueprints/stacks.ts](https://github.com/sanity-io/runtime-cli/blob/v17.10.0/src/commands/blueprints/stacks.ts)_
 
 ## `sanity-run functions add`
 
@@ -608,7 +608,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.9.0/src/commands/functions/add.ts)_
+_See code: [src/commands/functions/add.ts](https://github.com/sanity-io/runtime-cli/blob/v17.10.0/src/commands/functions/add.ts)_
 
 ## `sanity-run functions dev`
 
@@ -643,7 +643,7 @@ EXAMPLES
   $ sanity-run functions dev --timeout 60
 ```
 
-_See code: [src/commands/functions/dev.ts](https://github.com/sanity-io/runtime-cli/blob/v17.9.0/src/commands/functions/dev.ts)_
+_See code: [src/commands/functions/dev.ts](https://github.com/sanity-io/runtime-cli/blob/v17.10.0/src/commands/functions/dev.ts)_
 
 ## `sanity-run functions env add NAME KEY VALUE`
 
@@ -676,7 +676,7 @@ EXAMPLES
   $ 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.9.0/src/commands/functions/env/add.ts)_
+_See code: [src/commands/functions/env/add.ts](https://github.com/sanity-io/runtime-cli/blob/v17.10.0/src/commands/functions/env/add.ts)_
 
 ## `sanity-run functions env list NAME`
 
@@ -706,7 +706,7 @@ EXAMPLES
   $ 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.9.0/src/commands/functions/env/list.ts)_
+_See code: [src/commands/functions/env/list.ts](https://github.com/sanity-io/runtime-cli/blob/v17.10.0/src/commands/functions/env/list.ts)_
 
 ## `sanity-run functions env remove NAME KEY`
 
@@ -738,7 +738,7 @@ EXAMPLES
   $ 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.9.0/src/commands/functions/env/remove.ts)_
+_See code: [src/commands/functions/env/remove.ts](https://github.com/sanity-io/runtime-cli/blob/v17.10.0/src/commands/functions/env/remove.ts)_
 
 ## `sanity-run functions logs [NAME]`
 
@@ -778,7 +778,7 @@ EXAMPLES
   $ sanity-run functions logs <name> --delete
 ```
 
-_See code: [src/commands/functions/logs.ts](https://github.com/sanity-io/runtime-cli/blob/v17.9.0/src/commands/functions/logs.ts)_
+_See code: [src/commands/functions/logs.ts](https://github.com/sanity-io/runtime-cli/blob/v17.10.0/src/commands/functions/logs.ts)_
 
 ## `sanity-run functions test [NAME]`
 
@@ -790,7 +790,7 @@ USAGE
     <value>] |  |  | --file-before <value> | --file-after <value> | --document-id-before <value> | --document-id-after
     <value>] [--data-after <value> |  |  |  |  |  |  | ] [-e create|update|delete] [-t <value>] [-a <value>]
     [--with-user-token] [--media-library-id <value> | [--project-id <value> | --organization-id <value>] | --dataset
-    <value>]
+    <value>] [--no-wait]
 
 ARGUMENTS
   [NAME]  The name of the Sanity Function
@@ -812,6 +812,7 @@ FLAGS
       --file-before=<value>         Original document
       --json                        Format output as json
       --media-library-id=<value>    Sanity Media Library ID to use
+      --no-wait                     Skip durable wait delays instead of sleeping
       --organization-id=<value>     Sanity organization ID used to scope Blueprint and Stack
       --project-id=<value>          Sanity project ID used to scope Blueprint and Stack
       --with-user-token             Prime access token from CLI config
@@ -835,7 +836,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.9.0/src/commands/functions/test.ts)_
+_See code: [src/commands/functions/test.ts](https://github.com/sanity-io/runtime-cli/blob/v17.10.0/src/commands/functions/test.ts)_
 
 ## `sanity-run help [COMMAND]`
 

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

@@ -73,6 +73,8 @@ async function preDeployStack(options) {
         };
     }
     spinner.stop().clear();
+    if (stack.changeCount === 0)
+        return { success: true };
     logger(styleText('dim', 'Stack deployment progress:'));
     logger('');
     const outcome = await waitForOperation({

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

@@ -48,6 +48,7 @@ type UpdateStackResponse = {
     error: null;
     stack: Stack & {
         operationId: string;
+        changeCount?: number;
     };
 } | {
     ok: false;

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

@@ -25,6 +25,7 @@ export default class TestCommand extends ResolvedCommand<typeof TestCommand> {
         'document-id-after': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         'with-user-token': import("@oclif/core/interfaces").BooleanFlag<boolean>;
         'media-library-id': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'no-wait': import("@oclif/core/interfaces").BooleanFlag<boolean>;
     };
     run(): Promise<Record<string, unknown> | undefined>;
 }

package/dist/commands/functions/test.js

@@ -146,6 +146,11 @@ Provide test data via --data (inline JSON), --file (JSON file), or --document-id
             exclusive: ['project-id', 'dataset'],
             required: false,
         }),
+        'no-wait': Flags.boolean({
+            description: 'Skip durable wait delays instead of sleeping',
+            default: false,
+            required: false,
+        }),
     };
     async run() {
         const { name } = this.args;

package/dist/cores/functions/test.js

@@ -3,6 +3,7 @@ import { testAction } from '../../actions/functions/test.js';
 import config from '../../config.js';
 import { STEP_PHASE_GLYPH } from '../../constants.js';
 import { resolveDeployedResources } from '../../utils/blueprints/resolve-deployed-resources.js';
+import { createDurableJsonCollector } from '../../utils/functions/durable-logs.js';
 import { findFunctionInResources, getFunctionNames } from '../../utils/functions/find.js';
 import { runFunction } from '../../utils/functions/invoke/nested.js';
 import { buildContext, buildInvokeOptions, collectInvokeInput, defaultInvocationDeps, resolveInvocationPlan, } from '../../utils/functions/invoke/resolve-invoke-type.js';
@@ -12,19 +13,25 @@ import { isEventType, } from '../../utils/types.js';
  * @param events
  */
 function renderStepTimeline(events) {
-    return events
-        .filter((event) => event.phase !== 'start')
-        .map((event) => {
+    const lines = [];
+    for (const event of events) {
+        if (event.kind === 'log') {
+            lines.push(`${event.timestamp} ${event.level.toUpperCase()} ${event.message}`);
+            continue;
+        }
+        if (event.phase === 'start')
+            continue;
         const glyph = STEP_PHASE_GLYPH[event.phase] ?? '•';
         const duration = typeof event.durationMs === 'number' ? ` (${Math.round(event.durationMs)}ms)` : '';
         const detail = event.phase === 'error' && event.error ? ` ${event.error.message}` : '';
-        return `  ${glyph} ${event.name} [${event.kind}]${duration}${detail}`;
-    });
+        lines.push(`  ${glyph} ${event.name} [${event.kind}]${duration}${detail}`);
+    }
+    return lines;
 }
 export async function functionTestCore(options) {
     const { blueprint, log, error, args, flags, helpText } = options;
     const { name: fnName } = args;
-    const { event, timeout, api, 'with-user-token': withUserToken } = flags;
+    const { event, timeout, api, 'with-user-token': withUserToken, 'no-wait': noWait } = flags;
     const { 'project-id': projectId = blueprint?.projectId, 'organization-id': organizationId = blueprint?.organizationId, } = flags;
     if (!fnName) {
         const functionNames = getFunctionNames(blueprint.resources);
@@ -77,10 +84,17 @@ export async function functionTestCore(options) {
         // Records each nested context.invoke() so they can be surfaced in order after the spinner resolves.
         const nestedRuns = [];
         let nestedOrder = 0;
-        const stepEvents = [];
+        const durableJson = createDurableJsonCollector();
         const onStepEvent = plan.isDurable
             ? (event) => {
-                stepEvents.push(event);
+                if (flags.json) {
+                    durableJson.record(event);
+                    return;
+                }
+                for (const line of renderStepTimeline([event])) {
+                    if (line !== null)
+                        log(line);
+                }
             }
             : undefined;
         /**
@@ -120,6 +134,7 @@ export async function functionTestCore(options) {
             depth: 0,
             callStack: [fnName],
             onStepEvent,
+            noWait,
         });
         if (error) {
             spinner.fail('Function execution failed.');
@@ -131,12 +146,6 @@ export async function functionTestCore(options) {
             logNestedRuns();
             const errorMessage = error.stack || error.message || error.name;
             const isTimeout = error.message?.includes('Timeout');
-            if (plan.isDurable && stepEvents.length > 0) {
-                log('Steps:');
-                for (const line of renderStepTimeline(stepEvents)) {
-                    log(line);
-                }
-            }
             return {
                 success: false,
                 error: errorMessage,
@@ -147,20 +156,26 @@ export async function functionTestCore(options) {
             };
         }
         spinner.succeed('Function execution succeeded.');
-        log('Logs:');
-        log(logs || '');
-        logNestedRuns();
-        if (response) {
-            log('Response:');
-            log(JSON.stringify(response, null, 2));
-        }
-        if (plan.isDurable && stepEvents.length > 0) {
-            log('Steps:');
-            for (const line of renderStepTimeline(stepEvents)) {
-                log(line);
+        if (!plan.isDurable) {
+            log('Logs:');
+            log(logs || '');
+            logNestedRuns();
+            if (response) {
+                log('Response:');
+                log(JSON.stringify(response, null, 2));
             }
         }
-        return { success: true, json: { response, logs } };
+        const durableResult = durableJson.result();
+        return {
+            success: true,
+            json: plan.isDurable
+                ? {
+                    response: response ?? null,
+                    steps: durableResult.steps,
+                    logs: durableResult.logs,
+                }
+                : { response, logs },
+        };
     }
     catch (error) {
         return {

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

@@ -41,7 +41,7 @@ process.on('message', async (data) => {
 
   // Otherwise this is the initial start message. Support the legacy untyped
   // `{srcPath, payload}` shape as well as the new `{type: 'start', ...}`.
-  const {srcPath, payload, isDurable} = jsonData
+  const {srcPath, payload, isDurable, noWait} = jsonData
   const {context, ...event} = payload
 
   let logs = ''
@@ -83,9 +83,10 @@ process.on('message', async (data) => {
     if (isDurable) {
       json = await runDurable(
         handler,
-        {context, event, logger: console},
+        {context, event},
         {
           emit: (e) => process.send(JSON.stringify({type: 'step-event', event: e})),
+          wait: (ms) => new Promise((resolve) => setTimeout(resolve, noWait ? 0 : ms)),
         },
       )
     } else {

package/dist/utils/functions/child-runtime/durable.d.ts

@@ -1,5 +1,5 @@
 import type {DurableContext, DurableHandler, DurableLogger, GenericEvent} from '@sanity/functions'
-import type {DurableStepEvent} from '../../types.js'
+import type {DurableRuntimeEvent} from '../../types.js'
 
 type RunDurableArgs = {
   context: DurableContext
@@ -8,7 +8,7 @@ type RunDurableArgs = {
 }
 
 type DurableIO = {
-  emit: (event: DurableStepEvent) => void
+  emit: (event: DurableRuntimeEvent) => void
 }
 
 export function runDurable(

package/dist/utils/functions/child-runtime/durable.js

@@ -1,17 +1,60 @@
 import {performance} from 'node:perf_hooks'
+import {inspect} from 'node:util'
+
+/**
+ *
+ * @param duration
+ * @return {number}
+ */
+const durationToMs = (duration = {}) => {
+  const {days = 0, hours = 0, minutes = 0, seconds = 0} = duration
+  return (((days * 24 + hours) * 60 + minutes) * 60 + seconds) * 1000
+}
+
+/**
+ *
+ * @param args
+ */
+const formatArgs = (args) =>
+  args.map((a) => (typeof a === 'string' ? a : inspect(a, {depth: null}))).join(' ')
 
 /**
  * Runs a durable function handler
  * @param handler - callback being run
  * @param context - data to send to the operation
  * @param event - the step being run
- * @param logger
  * @param io
  */
-export async function runDurable(handler, {context, event, logger}, io) {
+export async function runDurable(handler, {context, event}, io) {
+  let currentStep = null
+  const streamLog = (level, args) => {
+    const date = new Date()
+    const timestamp = `${date.toLocaleDateString()} ${date.toLocaleTimeString()}`
+
+    return io.emit({
+      timestamp,
+      kind: 'log',
+      phase: 'log',
+      step: currentStep,
+      level,
+      message: formatArgs(args),
+    })
+  }
+
+  // @todo: need to throw error for use of `console.log` in a durable function
+  const logger = {
+    log: (...a) => streamLog('info', a),
+    info: (...a) => streamLog('info', a),
+    warn: (...a) => streamLog('warn', a),
+    error: (...a) => streamLog('error', a),
+  }
+
   const track = async (name, kind, produce) => {
     io.emit({name, kind, phase: 'start'})
     const startedAt = performance.now()
+    const prev = currentStep
+    currentStep = name
+
     try {
       const value = await produce()
       io.emit({
@@ -35,11 +78,35 @@ export async function runDurable(handler, {context, event, logger}, io) {
         durationMs: performance.now() - startedAt,
       })
       throw err
+    } finally {
+      currentStep = prev
     }
   }
 
   const step = {
-    run: ({name, handler: fn}) => track(name || 'step-run', 'run', () => fn({logger, attempt: 1})),
+    run: ({name, handler: fn}) => track(name || '', 'run', () => fn({logger, attempt: 1})),
+    wait: ({name, duration}) =>
+      track(name || '', 'wait', async () => {
+        await io.wait(durationToMs(duration))
+        return undefined
+      }),
+    waitForCondition: ({name, initial, poller, next}) =>
+      track(name || '', 'wait-for-condition', async () => {
+        let state = initial
+        let attempt = 1
+        let polling = true
+        while (polling) {
+          state = await poller(state, {logger, attempt})
+          const decision = next(state, {attempt})
+          if (decision.shouldRetry) {
+            await io.wait(durationToMs(decision.delay))
+            attempt += 1
+          } else {
+            polling = false
+          }
+        }
+        return state
+      }),
   }
 
   return handler({context, event, step, logger})

package/dist/utils/functions/durable-logs.d.ts

@@ -0,0 +1,16 @@
+import type { DurableLogEvent, DurableRuntimeEvent, DurableStepEvent } from '../types.js';
+type DurableLogLine = Pick<DurableLogEvent, 'level' | 'message'>;
+type DurableJsonStep = DurableStepEvent & {
+    logs: DurableLogLine[];
+};
+/**
+ * Records a durable log event
+ */
+export declare const createDurableJsonCollector: () => {
+    record: (event: DurableRuntimeEvent) => void;
+    result: () => {
+        steps: DurableJsonStep[];
+        logs: DurableLogLine[];
+    };
+};
+export {};

package/dist/utils/functions/durable-logs.js

@@ -0,0 +1,52 @@
+/**
+ * Records a durable log event
+ */
+export const createDurableJsonCollector = () => {
+    const steps = [];
+    const logLines = [];
+    const activeSteps = new Map();
+    function record(event) {
+        if (event.kind === 'log') {
+            const logLine = {
+                level: event.level,
+                message: event.message,
+            };
+            if (event.step === null) {
+                logLines.push(logLine);
+                return;
+            }
+            const step = activeSteps.get(event.step);
+            if (step) {
+                step.logs.push(logLine);
+                return;
+            }
+            logLines.push(logLine);
+            return;
+        }
+        if (event.phase === 'start') {
+            const step = {
+                ...event,
+                logs: [],
+            };
+            steps.push(step);
+            activeSteps.set(event.name, step);
+            return;
+        }
+        const step = activeSteps.get(event.name);
+        if (!step)
+            return;
+        step.phase = event.phase;
+        step.durationMs = event.durationMs;
+        if (event.phase === 'complete') {
+            step.output = event.output;
+        }
+        if (event.phase === 'error') {
+            step.error = event.error;
+        }
+        activeSteps.delete(event.name);
+    }
+    return {
+        record,
+        result: () => ({ steps, logs: logLines }),
+    };
+};

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

@@ -47,7 +47,7 @@ export default async function invoke(resource, payload, context, options) {
     if (!resource.src) {
         throw new Error(`Function resource "${resource.name}" is missing the 'src' property.`);
     }
-    const { forceColor = true, timeout = 10, onNestedInvoke, depth = 0, callStack = [], onStepEvent = () => { }, } = options;
+    const { forceColor = true, timeout = 10, onNestedInvoke, depth = 0, callStack = [], onStepEvent = () => { }, noWait = false, } = options;
     // `payload.payload` is the event body for every function type: the document for
     // GROQ-based events, whatever the producer sent for the rest. The handler always
     // receives it as `event.data` (see the `payload` built in `start()` below).
@@ -306,6 +306,7 @@ export default async function invoke(resource, payload, context, options) {
                 srcPath: functionPath,
                 payload,
                 isDurable: resource.type === SANITY_FUNCTION_DURABLE,
+                noWait,
             };
             child.send(JSON.stringify(startMessage));
         }

package/dist/utils/types.d.ts

@@ -162,7 +162,9 @@ export interface InvokeExecutionOptions {
     /** Function names already on the invoke call stack (innermost last), used to detect cycles. @internal */
     callStack?: string[];
     /** Stream a durable step transition to the caller. @internal */
-    onStepEvent?: (event: DurableStepEvent) => void;
+    onStepEvent?: (event: DurableRuntimeEvent) => void;
+    /** Don't wait the full duration during a wait durable event @internal */
+    noWait?: boolean;
 }
 /**
  * Re-entrant callback that executes a named function from the blueprint on behalf
@@ -181,6 +183,7 @@ export type ParentToChildMessage = {
     srcPath: string;
     payload: unknown;
     isDurable?: boolean;
+    noWait?: boolean;
 } | {
     type: 'invoke-response';
     id: string;
@@ -195,7 +198,7 @@ export type ParentToChildMessage = {
     error: InvocationError;
 } | {
     type: 'step-event';
-    event: DurableStepEvent;
+    event: DurableRuntimeEvent;
 };
 /**
  * IPC messages sent from a function child process back up to the parent.
@@ -217,7 +220,7 @@ export type ChildToParentMessage = {
     error?: InvocationError;
 } | {
     type: 'step-event';
-    event: DurableStepEvent;
+    event: DurableRuntimeEvent;
 };
 /** @internal */
 export interface InvocationResponse {
@@ -301,7 +304,7 @@ export type Warning = {
     suggestions: string[];
 };
 /** @internal */
-export type DurableOperationSteps = 'run';
+export type DurableOperationSteps = 'run' | 'wait' | 'waitForCondition';
 /** @internal */
 export type DurableStepPhase = 'start' | 'complete' | 'error';
 /**
@@ -315,6 +318,15 @@ export interface DurableStepEvent {
     error?: InvocationError;
     durationMs?: number;
 }
+export interface DurableLogEvent {
+    kind: 'log';
+    phase: 'log';
+    step: string | null;
+    level: 'info' | 'warn' | 'error';
+    message: string;
+    timestamp?: string;
+}
+export type DurableRuntimeEvent = DurableStepEvent | DurableLogEvent;
 export interface FunctionTestFlags {
     data?: string;
     event?: string;
@@ -333,5 +345,7 @@ export interface FunctionTestFlags {
     'document-id-before'?: string;
     'document-id-after'?: string;
     'media-library-id'?: string;
+    'no-wait'?: boolean;
+    json?: boolean;
 }
 export {};

package/oclif.manifest.json

@@ -2755,6 +2755,13 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "no-wait": {
+          "description": "Skip durable wait delays instead of sleeping",
+          "name": "no-wait",
+          "required": false,
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
@@ -3141,5 +3148,5 @@
       ]
     }
   },
-  "version": "17.9.0"
+  "version": "17.10.0"
 }

package/package.json

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