@frontera-sdk/workflow 1.52.39 → 1.52.40

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@frontera-sdk/workflow",
-  "version": "1.52.39",
+  "version": "1.52.40",
   "description": "Typed headless client for starting, inspecting, waiting on and cancelling Frontera workflow runs from a script or backend.",
   "keywords": [
     "frontera",
@@ -38,8 +38,8 @@
     "typecheck": "bunx tsc --noEmit"
   },
   "dependencies": {
-    "@frontera-sdk/core": "1.52.39",
-    "@frontera-sdk/functions": "1.52.39"
+    "@frontera-sdk/core": "1.52.40",
+    "@frontera-sdk/functions": "1.52.40"
   },
   "devDependencies": {
     "@types/bun": "^1.3.14",

package/src/definition.ts

@@ -278,6 +278,12 @@ export interface DecideParams {
   /** Question id to question; each id is a key of the result's `answers`. */
   questions: Record<string, DecideQuestion>
 }
+export interface ActionSubjectParams {
+  /** The record's primary key: text or a number. */
+  primaryKey: DataInput
+  /** The record version the change was decided on: a whole number, 0 or more. */
+  expectedVersion?: DataInput
+}
 export interface ActionParams {
   input: DataInput
   /**
@@ -287,6 +293,24 @@ export interface ActionParams {
    * without one. An empty reason is not sent.
    */
   reason?: DataInput
+  /**
+   * The record the Action acts on, when the step names its own instead of the
+   * run's subject: typically a row a `blueprint` step found, inside `forEach`.
+   *
+   * ```ts
+   * subject: {
+   *   primaryKey: { type: 'expr', expr: '$item.id' },
+   *   expectedVersion: { type: 'expr', expr: '$item._meta.recordVersion' },
+   * }
+   * ```
+   *
+   * The record is of the Action's own subject type. `expectedVersion` is the
+   * version the change was decided on; absent (or evaluating to nothing), the
+   * record's version is read right before the submit. When `input` leaves them
+   * out, the Action's primary-key input and its `expectedVersion` input are
+   * filled from the subject. A create Action takes no subject.
+   */
+  subject?: ActionSubjectParams
   /**
    * Keep the step open until the request settles (succeeded, rejected,
    * expired, cancelled, failed, or closed with an unknown outcome) instead of
@@ -388,6 +412,12 @@ export interface ConfirmParams {
   cancelLabel?: string
   /** How long the question stays open, in minutes (1 to 1440); 60 by default. */
   timeoutMinutes?: number
+  /**
+   * What happens when nobody can answer (a scheduled, manual or webhook run has no person):
+   * `fail` fails the step with `CONFIRM_UNAVAILABLE`; `continue` answers `unavailable` for
+   * the definition to branch on. Unset, it fails unless the definition reads the step's answer.
+   */
+  onUnavailable?: 'fail' | 'continue'
 }
 export interface RespondParams {
   status: number