@lunnoa/client 2.3.0 → 2.4.0

package/dist/react.d.cts

@@ -810,13 +810,18 @@ interface components {
             requestedCount: number;
         };
         UpsertWorkflowStepDto: {
+            /**
+             * @description Name later steps use in ={{step:<key>,path}}. Keyed steps keep their node id across deploys. "trigger" is reserved.
+             * @example loadCase
+             */
+            key?: string;
             /** @description Workflow app id (catalogue slug). */
             appId: string;
             /** @description Catalogue action id. */
             actionId: string;
             /** @description Connection instance UUID for this step. */
             connectionId?: string;
-            /** @description Action input / config fields. */
+            /** @description Action input / config fields. String values may use ={{step:trigger,field}} or ={{step:<key>,path,to,value}}. */
             input?: {
                 [key: string]: unknown;
             };
@@ -1975,6 +1980,8 @@ interface components {
             executionPath?: components["schemas"]["ExecutionPathStepDto"][];
         };
         RunStepDto: {
+            /** @description Name later steps use in ={{step:<key>,path}}. Ad-hoc runs have no trigger. */
+            key?: string;
             /** @description Workflow app id (catalogue slug), e.g. `http`, `gmail`. */
             appId: string;
             /** @description Action id within the app, e.g. `http_action_send-request`. Discover via GET /workflow-apps. */
@@ -2761,9 +2768,14 @@ interface TriggerDefinition {
     description?: string;
 }
 interface WorkflowStepDefinition {
+    /**
+     * Name later steps use with `ref.step(key, ...)`. Keyed steps keep their
+     * node id across deploys. `trigger` is reserved.
+     */
+    key?: string;
     /** Action definition (or inline action-shaped object). */
     use: ActionDefinition;
-    /** Per-step input overrides. */
+    /** Per-step input overrides. Values may contain `ref.trigger` / `ref.step`. */
     input?: Record<string, unknown>;
     name?: string;
 }
@@ -3390,6 +3402,8 @@ declare class QueuesResource {
 }
 
 interface StartRunStep {
+    /** Name later steps use with `ref.step(key, ...)`. */
+    key?: string;
     appId: string;
     actionId: string;
     connectionId?: string;
@@ -3542,6 +3556,8 @@ declare class VariablesResource {
 }
 
 interface UpsertWorkflowStepInput {
+    /** Name later steps use in `={{step:<key>,path}}`. Keeps the node id stable. */
+    key?: string;
     appId: string;
     actionId: string;
     connectionId?: string;

package/dist/react.d.ts

@@ -810,13 +810,18 @@ interface components {
             requestedCount: number;
         };
         UpsertWorkflowStepDto: {
+            /**
+             * @description Name later steps use in ={{step:<key>,path}}. Keyed steps keep their node id across deploys. "trigger" is reserved.
+             * @example loadCase
+             */
+            key?: string;
             /** @description Workflow app id (catalogue slug). */
             appId: string;
             /** @description Catalogue action id. */
             actionId: string;
             /** @description Connection instance UUID for this step. */
             connectionId?: string;
-            /** @description Action input / config fields. */
+            /** @description Action input / config fields. String values may use ={{step:trigger,field}} or ={{step:<key>,path,to,value}}. */
             input?: {
                 [key: string]: unknown;
             };
@@ -1975,6 +1980,8 @@ interface components {
             executionPath?: components["schemas"]["ExecutionPathStepDto"][];
         };
         RunStepDto: {
+            /** @description Name later steps use in ={{step:<key>,path}}. Ad-hoc runs have no trigger. */
+            key?: string;
             /** @description Workflow app id (catalogue slug), e.g. `http`, `gmail`. */
             appId: string;
             /** @description Action id within the app, e.g. `http_action_send-request`. Discover via GET /workflow-apps. */
@@ -2761,9 +2768,14 @@ interface TriggerDefinition {
     description?: string;
 }
 interface WorkflowStepDefinition {
+    /**
+     * Name later steps use with `ref.step(key, ...)`. Keyed steps keep their
+     * node id across deploys. `trigger` is reserved.
+     */
+    key?: string;
     /** Action definition (or inline action-shaped object). */
     use: ActionDefinition;
-    /** Per-step input overrides. */
+    /** Per-step input overrides. Values may contain `ref.trigger` / `ref.step`. */
     input?: Record<string, unknown>;
     name?: string;
 }
@@ -3390,6 +3402,8 @@ declare class QueuesResource {
 }
 
 interface StartRunStep {
+    /** Name later steps use with `ref.step(key, ...)`. */
+    key?: string;
     appId: string;
     actionId: string;
     connectionId?: string;
@@ -3542,6 +3556,8 @@ declare class VariablesResource {
 }
 
 interface UpsertWorkflowStepInput {
+    /** Name later steps use in `={{step:<key>,path}}`. Keeps the node id stable. */
+    key?: string;
     appId: string;
     actionId: string;
     connectionId?: string;

package/dist/react.js

@@ -1848,7 +1848,9 @@ function stepFromDefinition(step) {
     ...use.input ?? {},
     ...step.input ?? {}
   };
+  const key = step.key;
   return {
+    ...key ? { key } : {},
     appId: resolveActionAppId(use),
     actionId: resolveActionId(use),
     ...use.connection?.id ? { connectionId: use.connection.id } : {},
@@ -2064,6 +2066,7 @@ function triggerToUpsertInput(trigger) {
 function stepToUpsertInput(step) {
   const use = step.use;
   return {
+    ...step.key ? { key: step.key } : {},
     appId: resolveActionAppId(use),
     actionId: resolveActionId(use),
     connectionId: use.connection?.id,