@sanity/runtime-cli 17.16.0-next.g91e6dd2 → 17.16.0-next.gfe46ad0

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.16.0-next.g91e6dd2/src/commands/blueprints/add.ts)_
+_See code: [src/commands/blueprints/add.ts](https://github.com/sanity-io/runtime-cli/blob/v17.16.0-next.gfe46ad0/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.16.0-next.g91e6dd2/src/commands/blueprints/config.ts)_
+_See code: [src/commands/blueprints/config.ts](https://github.com/sanity-io/runtime-cli/blob/v17.16.0-next.gfe46ad0/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.16.0-next.g91e6dd2/src/commands/blueprints/deploy.ts)_
+_See code: [src/commands/blueprints/deploy.ts](https://github.com/sanity-io/runtime-cli/blob/v17.16.0-next.gfe46ad0/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.16.0-next.g91e6dd2/src/commands/blueprints/destroy.ts)_
+_See code: [src/commands/blueprints/destroy.ts](https://github.com/sanity-io/runtime-cli/blob/v17.16.0-next.gfe46ad0/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.16.0-next.g91e6dd2/src/commands/blueprints/doctor.ts)_
+_See code: [src/commands/blueprints/doctor.ts](https://github.com/sanity-io/runtime-cli/blob/v17.16.0-next.gfe46ad0/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.16.0-next.g91e6dd2/src/commands/blueprints/info.ts)_
+_See code: [src/commands/blueprints/info.ts](https://github.com/sanity-io/runtime-cli/blob/v17.16.0-next.gfe46ad0/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.16.0-next.g91e6dd2/src/commands/blueprints/init.ts)_
+_See code: [src/commands/blueprints/init.ts](https://github.com/sanity-io/runtime-cli/blob/v17.16.0-next.gfe46ad0/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.16.0-next.g91e6dd2/src/commands/blueprints/logs.ts)_
+_See code: [src/commands/blueprints/logs.ts](https://github.com/sanity-io/runtime-cli/blob/v17.16.0-next.gfe46ad0/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.16.0-next.g91e6dd2/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.16.0-next.gfe46ad0/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.16.0-next.g91e6dd2/src/commands/blueprints/plan.ts)_
+_See code: [src/commands/blueprints/plan.ts](https://github.com/sanity-io/runtime-cli/blob/v17.16.0-next.gfe46ad0/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.16.0-next.g91e6dd2/src/commands/blueprints/promote.ts)_
+_See code: [src/commands/blueprints/promote.ts](https://github.com/sanity-io/runtime-cli/blob/v17.16.0-next.gfe46ad0/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.16.0-next.g91e6dd2/src/commands/blueprints/stacks.ts)_
+_See code: [src/commands/blueprints/stacks.ts](https://github.com/sanity-io/runtime-cli/blob/v17.16.0-next.gfe46ad0/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.16.0-next.g91e6dd2/src/commands/functions/add.ts)_
+_See code: [src/commands/functions/add.ts](https://github.com/sanity-io/runtime-cli/blob/v17.16.0-next.gfe46ad0/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.16.0-next.g91e6dd2/src/commands/functions/dev.ts)_
+_See code: [src/commands/functions/dev.ts](https://github.com/sanity-io/runtime-cli/blob/v17.16.0-next.gfe46ad0/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.16.0-next.g91e6dd2/src/commands/functions/env/add.ts)_
+_See code: [src/commands/functions/env/add.ts](https://github.com/sanity-io/runtime-cli/blob/v17.16.0-next.gfe46ad0/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.16.0-next.g91e6dd2/src/commands/functions/env/list.ts)_
+_See code: [src/commands/functions/env/list.ts](https://github.com/sanity-io/runtime-cli/blob/v17.16.0-next.gfe46ad0/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.16.0-next.g91e6dd2/src/commands/functions/env/remove.ts)_
+_See code: [src/commands/functions/env/remove.ts](https://github.com/sanity-io/runtime-cli/blob/v17.16.0-next.gfe46ad0/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.16.0-next.g91e6dd2/src/commands/functions/logs.ts)_
+_See code: [src/commands/functions/logs.ts](https://github.com/sanity-io/runtime-cli/blob/v17.16.0-next.gfe46ad0/src/commands/functions/logs.ts)_
 
 ## `sanity-run functions test [NAME]`
 
@@ -836,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.16.0-next.g91e6dd2/src/commands/functions/test.ts)_
+_See code: [src/commands/functions/test.ts](https://github.com/sanity-io/runtime-cli/blob/v17.16.0-next.gfe46ad0/src/commands/functions/test.ts)_
 
 ## `sanity-run help [COMMAND]`
 

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

@@ -1,5 +1,6 @@
 import {performance} from 'node:perf_hooks'
 import {inspect} from 'node:util'
+import {getBatchResults} from './getBatchResults.js'
 import {createStepHistory} from './step-history.js'
 
 /**
@@ -24,9 +25,10 @@ const formatArgs = (args) =>
  * @param handler - callback being run
  * @param context - data to send to the operation
  * @param event - the step being run
+ * @param [branchName] - the name of the branch being run
  * @param io
  */
-export async function runDurable(handler, {context, event}, io) {
+export async function runDurable(handler, {context, event, branchName}, io) {
   const history = createStepHistory()
   let currentStep = null
 
@@ -132,6 +134,14 @@ export async function runDurable(handler, {context, event}, io) {
     }
   }
 
+  const FANOUT_STATUS = {
+    STARTED: 'STARTED',
+    ALL_COMPLETED: 'ALL_COMPLETED',
+    FAILURE_TOLERANCE_EXCEEDED: 'FAILURE_TOLERANCE_EXCEEDED',
+    SUCCEEDED: 'SUCCEEDED',
+    FAILED: 'FAILED',
+  }
+
   const step = {
     run: ({name, handler: fn, retry}) =>
       track(name || '', 'run', (attempt) => fn({logger, attempt}), retry),
@@ -148,6 +158,36 @@ export async function runDurable(handler, {context, event}, io) {
         },
         retry,
       ),
+    fanout: async ({name, branches}) => {
+      if (
+        !Array.isArray(branches) ||
+        Array.from(branches).some((branch) => typeof branch !== 'function')
+      ) {
+        throw new TypeError('fanout branches must be an array of functions')
+      }
+
+      const outcomes = branches.map((_, index) => ({index, status: FANOUT_STATUS.STARTED}))
+      return new Promise((resolve, reject) => {
+        const execs = branches.map(async (branch, index) => {
+          try {
+            const branchName = `${name || 'fanout'} / branch ${index}`
+            const result = await runDurable(branch, {context, event, branchName}, io)
+            outcomes[index] = {index, status: FANOUT_STATUS.SUCCEEDED, result}
+          } catch (err) {
+            const error = err instanceof Error ? err : new Error(String(err))
+            outcomes[index] = {index, status: FANOUT_STATUS.FAILED, error}
+          }
+        })
+
+        Promise.allSettled(execs)
+          .then(() => {
+            resolve(getBatchResults(outcomes, FANOUT_STATUS.ALL_COMPLETED))
+          })
+          .catch(() => {
+            reject(reject)
+          })
+      })
+    },
     waitForCondition: ({name, initial, poller, next}) =>
       track(name || '', 'wait-for-condition', async () => {
         let state = initial
@@ -174,10 +214,11 @@ export async function runDurable(handler, {context, event}, io) {
 
   let result
   let done = false
+  const handlerArgs = branchName !== undefined ? {step, logger} : {context, event, step, logger}
   while (!done) {
     history.startRun()
     try {
-      result = await handler({context, event, step, logger})
+      result = await handler(handlerArgs)
       settleUnretried()
       done = true
     } catch (err) {

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

@@ -0,0 +1,75 @@
+/**
+ * Maps to runtime APIs from @sanity/functions
+ * @param outcomes - array of outcomes from the batch execution, each outcome should have a status and result or error
+ * @param reason - a string indicating the reason for the batch result, e.g., 'ALL_COMPLETED' or 'FAILED'
+ */
+export const getBatchResults = (outcomes, reason) => {
+  /**
+   * Returns an array of all outcomes, regardless of their status.
+   */
+  const all = outcomes.map((outcome) => ({...outcome}))
+
+  /**
+   * Returns an array of outcomes that have failed (status 'FAILED').
+   */
+  const failed = () =>
+    all.filter((outcome) => outcome.error !== undefined && outcome.status === 'FAILED')
+
+  /**
+   * Returns an array of outcomes that have succeeded (status 'SUCCEEDED').
+   */
+  const succeeded = () =>
+    all.filter((outcome) => outcome.result !== undefined && outcome.status === 'SUCCEEDED')
+
+  /**
+   * Returns an array of outcomes that are still in progress (status 'STARTED').
+   */
+  const started = () => all.filter((outcome) => outcome.status === 'STARTED')
+
+  /**
+   * Returns the count of successful outcomes (status 'SUCCEEDED')
+   */
+  const successCount = all.filter((item) => item.status === 'SUCCEEDED').length
+
+  /**
+   * Returns the count of failed outcomes (status 'FAILED')
+   */
+  const failureCount = all.filter((item) => item.status === 'FAILED').length
+
+  /**
+   * Returns an array of results from successful outcomes (status 'SUCCEEDED').
+   */
+  const getResults = () => succeeded().map((item) => item.result)
+
+  /**
+   * Returns an array of errors from failed outcomes (status 'FAILED').
+   */
+  const getErrors = () => failed().map((item) => item.error)
+
+  /**
+   * Throws the first error found in the failed outcomes (status 'FAILED').
+   */
+  const throwIfError = () => {
+    const failure = all.find((outcome) => outcome.status === 'FAILED')
+    if (failure?.error) {
+      throw failure.error
+    }
+  }
+
+  return {
+    all,
+    status: failureCount > 0 ? 'FAILED' : 'SUCCEEDED',
+    hasFailure: failureCount > 0,
+    failed,
+    succeeded,
+    started,
+    reason,
+    successCount,
+    failureCount,
+    startedCount: started().length,
+    totalCount: all.length,
+    getResults,
+    getErrors,
+    throwIfError,
+  }
+}

package/oclif.manifest.json

@@ -3148,5 +3148,5 @@
       ]
     }
   },
-  "version": "17.16.0-next.g91e6dd2"
+  "version": "17.16.0-next.gfe46ad0"
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@sanity/runtime-cli",
   "description": "Sanity's Runtime CLI for Blueprints and Functions",
-  "version": "17.16.0-next.g91e6dd2",
+  "version": "17.16.0-next.gfe46ad0",
   "author": "Sanity Runtime Team",
   "type": "module",
   "license": "MIT",
@@ -100,7 +100,7 @@
     "@oclif/test": "^4.2.0",
     "@playwright/test": "^1.63.0",
     "@sanity-labs/design-tokens": "^0.0.2-alpha.2",
-    "@sanity/functions": "^1.8.1",
+    "@sanity/functions": "^1.10.1",
     "@types/cardinal": "^2.1.1",
     "@types/mime-types": "^3.0.1",
     "@types/node": "^22",