@uipath/maestro-builder-sdk 6.52.1 → 6.53.0

package/dist/case/action-output-var.d.ts

@@ -0,0 +1,19 @@
+/**
+ * The case variable a human task's form output writes when the author gives no
+ * `value`. Shared by the serializer, which writes the row, and the build-time
+ * expression check, which must count that variable as declared.
+ *
+ * @module
+ */
+/**
+ * The case variable an action output writes when the author gives no `value`:
+ * the Designer's camelCase of the field name (`Comment` → `comment`), or the
+ * name itself when that leaves nothing (a name of only punctuation).
+ */
+export declare function defaultActionOutputVar(name: string): string;
+/**
+ * The Designer's `camelizeDisplayName`: drop non-identifier characters, split on
+ * spaces/underscores, lower the first letter of the first word and upper the
+ * first letter of the rest (`APIOutput1` → `aPIOutput1`).
+ */
+export declare function camelizeName(name: string): string;

package/dist/case/action-output-var.js

@@ -0,0 +1,24 @@
+/**
+ * The case variable a human task's form output writes when the author gives no
+ * `value`. Shared by the serializer, which writes the row, and the build-time
+ * expression check, which must count that variable as declared.
+ *
+ * @module
+ */
+/**
+ * The case variable an action output writes when the author gives no `value`:
+ * the Designer's camelCase of the field name (`Comment` → `comment`), or the
+ * name itself when that leaves nothing (a name of only punctuation).
+ */
+export function defaultActionOutputVar(name) {
+    return camelizeName(name) || name;
+}
+/**
+ * The Designer's `camelizeDisplayName`: drop non-identifier characters, split on
+ * spaces/underscores, lower the first letter of the first word and upper the
+ * first letter of the rest (`APIOutput1` → `aPIOutput1`).
+ */
+export function camelizeName(name) {
+    const words = name.replace(/[^a-zA-Z0-9_ ]/g, '').split(/[\s_]+/).filter(Boolean);
+    return words.map((w, i) => (i === 0 ? w.charAt(0).toLowerCase() : w.charAt(0).toUpperCase()) + w.slice(1)).join('');
+}

package/dist/case/case-expr-check.js

@@ -16,6 +16,7 @@
  * `case/check.ts`, not here.
  */
 import { checkExpression } from '../core/expr-check.js';
+import { defaultActionOutputVar } from './action-output-var.js';
 const NOUN = 'case variable';
 const NAMESPACE = 'vars';
 function checkExpr(expr, where, roots, out) {
@@ -44,12 +45,12 @@ export function checkCaseExpressions(built) {
                     roots.add(o.var);
                 // A human task's form outputs declare one too: the field's `value` is the
                 // variable the assignee's answer lands in (`.action({ outputs: [{ name:
-                // 'Action', value: 'decision' }] })` → `vars.decision`). The serializer
-                // registers exactly that companion (`emitActionField`), so a gate on it
-                // is a declared read, not a typo.
+                // 'Action', value: 'decision' }] })` → `vars.decision`). With no `value`
+                // the serializer writes the field's camelCased name (`approved` →
+                // `vars.approved`, builder-sdk#1422). Either way `emitActionField` writes
+                // that variable, so a gate on it is a declared read, not a typo.
                 for (const f of task.action?.outputs ?? [])
-                    if (f.value)
-                        roots.add(f.value);
+                    roots.add(f.value ?? defaultActionOutputVar(f.name));
             }
     // Event-trigger payload extractions declare readable case variables too.
     for (const t of built.triggers)

package/dist/case/case-sdk.d.ts

@@ -381,8 +381,13 @@ export interface BuiltCaseExitCondition {
     rules: CaseRule[][];
 }
 export type TaskKind = 'process' | 'agent' | 'rpa' | 'api-workflow' | 'case-management' | 'flow-process' | 'function' | 'business-rule' | 'external-agent' | 'external-workflow' | 'action' | 'connector' | 'wait-for-timer' | 'wait-for-connector';
-/** Published-resource task kinds that the Case schema permits as unresolved skeletons. */
-export type UnresolvedReferenceTaskKind = 'process' | 'agent' | 'rpa' | 'api-workflow' | 'case-management' | 'function';
+/**
+ * Task kinds that the Case schema permits as unresolved skeletons: the
+ * published-resource kinds, and `action` (a human task whose Action App or form
+ * is not known yet). Each compiles to a task whose `data` is `{}`, which
+ * `uip maestro case validate` reports as a `TASK_NOT_CONFIGURED` warning.
+ */
+export type UnresolvedReferenceTaskKind = 'process' | 'agent' | 'rpa' | 'api-workflow' | 'case-management' | 'function' | 'action';
 /**
  * A `wait-for-connector` subscription: suspend on an Integration Service event.
  * Omit `connectorKey`/`operation` for a bare **placeholder** (for a connector not
@@ -514,7 +519,14 @@ export interface ActionField {
     subType?: string;
     /** Human-facing label (defaults to `name` in the UI when omitted). */
     displayName?: string;
-    /** Input literal/expression, or the readable variable name for an output field. */
+    /**
+     * Input literal/expression, or the case variable an output field writes. An
+     * output without `value` writes the camelCased field name, made unique across
+     * the plan (`Comment` → `comment`, a second `Comment` → `comment2`), as the
+     * Case Designer does. Set `value` on any output another step reads: the
+     * default suffix depends on task order, so adding an earlier task with the
+     * same output name would move the unsuffixed variable to that task.
+     */
     value?: string;
     /** Require `value` to be non-empty at validation time. */
     required?: boolean;
@@ -846,15 +858,18 @@ declare class TaskBuilder {
         folder?: string;
     }): this;
     /**
-     * Preserve an explicitly unresolved published-resource task as a typed
-     * skeleton whose serialized `data` is `{}`.
+     * Preserve an explicitly unresolved task as a typed skeleton whose serialized
+     * `data` is `{}`.
      *
      * @remarks
      * Use this only when the requested resource identity cannot be resolved.
      * Do not invent a name or folder. An unresolved task cannot declare input or
      * output bindings because there is no referenced contract to bind against.
+     * `unresolved('action')` is the human-task skeleton: no Action App, title,
+     * recipient or form fields, for an app that is not published yet. Use
+     * `.action({ ... })` instead once the form is known.
      *
-     * @param kind - The published-resource family to preserve.
+     * @param kind - The task kind to preserve: a published-resource family, or `'action'` for a human task.
      * @returns This builder, so calls chain.
      */
     unresolved(kind: UnresolvedReferenceTaskKind): this;

package/dist/case/case-sdk.js

@@ -197,15 +197,18 @@ class TaskBuilder {
         return this.reference('process', name, opts);
     }
     /**
-     * Preserve an explicitly unresolved published-resource task as a typed
-     * skeleton whose serialized `data` is `{}`.
+     * Preserve an explicitly unresolved task as a typed skeleton whose serialized
+     * `data` is `{}`.
      *
      * @remarks
      * Use this only when the requested resource identity cannot be resolved.
      * Do not invent a name or folder. An unresolved task cannot declare input or
      * output bindings because there is no referenced contract to bind against.
+     * `unresolved('action')` is the human-task skeleton: no Action App, title,
+     * recipient or form fields, for an app that is not published yet. Use
+     * `.action({ ... })` instead once the form is known.
      *
-     * @param kind - The published-resource family to preserve.
+     * @param kind - The task kind to preserve: a published-resource family, or `'action'` for a human task.
      * @returns This builder, so calls chain.
      */
     unresolved(kind) {

package/dist/case/decompile.js

@@ -708,6 +708,11 @@ function emitTaskKind(task, refs, library) {
     if (isAuthorableBusinessRule(task))
         return businessRuleCall(task, refs);
     if (kind === 'action') {
+        // The skeleton human task (v1's placeholder, validate's TASK_NOT_CONFIGURED):
+        // nothing configured, so `.action({})` would recompile with a default
+        // `priority` the source never had.
+        if (Object.keys(data).length === 0)
+            return `.unresolved(${tsLiteral('action')})`;
         let recipient;
         if (data.recipient) {
             const type = Number(data.recipient.Type);

package/dist/case/serialize.js

@@ -11,6 +11,7 @@
 import { IdGen, offlineBindingSeed } from './ids.js';
 import { isUnrestorableSlotId } from './preserve.js';
 import { v31TaskSets } from './task-sets.js';
+import { camelizeName, defaultActionOutputVar } from './action-output-var.js';
 import { buildConnectorInputs, nestConnectorBody, replayInputsOf, transportHttpMethod } from '../core/connector-inputs.js';
 import { buildEssentialConfiguration } from '../core/connector-configuration.js';
 import { EQUALS_EXPR_DIALECT } from '../core/connector-checks.js';
@@ -961,6 +962,11 @@ function taskData(task, resolver, taskId, stageId, ids) {
         case 'business-rule':
             return businessRuleTaskData(task, resolver, `${stageId}-${taskId}`, ids);
         case 'action': {
+            // `.unresolved('action')`: the skeleton human task, `data: {}` like an
+            // unresolved resource task (validate warns TASK_NOT_CONFIGURED). `.action()`
+            // always sets `task.action`, so only the skeleton reaches here without one.
+            if (!task.action && !task.ref)
+                return {};
             const a = task.action ?? {};
             const data = {};
             if (a.title)
@@ -1167,10 +1173,17 @@ function stableUuid(seed) {
 // extracts a result field (`source`) into a case variable (`var`), registering a
 // root `inputOutputs` companion (`id === var`) so `=vars.<var>` resolves.
 /**
- * One action-task form field → a schema `InputOutput` row. Unlike reference-mode
- * io-binding, most form fields carry only a name + type plus optional Action
- * Center metadata. A designer output with `value` names its readable case
- * variable and therefore also carries the standard output identity fields.
+ * One action-task form field → a schema `InputOutput` row. Inputs carry only a
+ * name + type plus optional Action Center metadata. Every OUTPUT also carries
+ * the standard output identity fields (`id`, `var`, `source`, `target`,
+ * `elementId`): the Designer writes them on every output it saves, and
+ * `uip maestro case validate` refuses an output without an id
+ * (`CASE_MGMT_OUTPUT_ID_MISSING`).
+ *
+ * An output's `value` names the case variable it writes. With no `value`, the
+ * variable is the Designer's default: the camelCased field name, made unique
+ * across the plan (`Comment` → `comment`, a second `Comment` → `comment2`), as
+ * its own variable — never a reassignment of the first one.
  */
 function emitActionField(f, outputElementId, resolver) {
     const row = { name: f.name, type: f.type ?? 'string' };
@@ -1178,27 +1191,33 @@ function emitActionField(f, outputElementId, resolver) {
         row.subType = f.subType;
     if (f.displayName !== undefined)
         row.displayName = f.displayName;
-    if (f.value !== undefined)
-        row.value = f.value;
-    if (outputElementId !== undefined && f.value !== undefined) {
-        // `id == var` like the Designer; a second form output into the same case
-        // variable takes a suffixed id and becomes a reassigned row (`originalVar`).
-        const id = resolver ? claimOutputId(resolver, f.value) : f.value;
+    if (outputElementId === undefined) {
+        if (f.value !== undefined)
+            row.value = f.value;
+    }
+    else {
+        // An explicit `value` keeps its variable: `id == var` like the Designer, and
+        // a second form output into the same case variable takes a suffixed id and
+        // becomes a reassigned row (`originalVar`). A defaulted one claims its own.
+        const base = f.value ?? defaultActionOutputVar(f.name);
+        const id = resolver ? claimOutputId(resolver, base) : base;
+        const variable = f.value ?? id;
+        row.value = variable;
         row.id = id;
-        row.var = f.value;
-        if (id !== f.value)
+        row.var = variable;
+        if (id !== variable)
             row.originalVar = id;
         row.source = `=${f.name}`;
         row.target = `=${id}`;
         row.elementId = outputElementId;
-        // `id == value`: the row is the variable (the Designer writes no root entry
+        // `id == var`: the row is the variable (the Designer writes no root entry
         // for it). Only a suffixed, reassigned row needs the readable companion.
-        if (resolver && id === f.value)
-            addOwnNameRow(resolver, f.value, row);
-        else if (resolver && !resolver.varCompanions.has(f.value)) {
-            resolver.varCompanions.set(f.value, {
-                id: f.value,
-                name: f.value,
+        if (resolver && id === variable)
+            addOwnNameRow(resolver, variable, row);
+        else if (resolver && !resolver.varCompanions.has(variable)) {
+            resolver.varCompanions.set(variable, {
+                id: variable,
+                name: variable,
                 type: f.type ?? 'string',
                 elementId: 'root',
                 custom: true,
@@ -1704,8 +1723,7 @@ function ownOutputVars(built) {
                     if (isOwnNameOutput(o))
                         vars.add(o.var);
                 for (const f of task.action?.outputs ?? [])
-                    if (f.value !== undefined)
-                        vars.add(f.value);
+                    vars.add(f.value ?? defaultActionOutputVar(f.name));
             }
     return vars;
 }
@@ -1726,15 +1744,6 @@ function keepsOwnName(name, field) {
         return false;
     return [field, camelizeName(field)].some((base) => name === base || (name.startsWith(base) && /^(?:[2-9]|[1-9]\d+)$/.test(name.slice(base.length))));
 }
-/**
- * The Designer's `camelizeDisplayName`: drop non-identifier characters, split on
- * spaces/underscores, lower the first letter of the first word and upper the
- * first letter of the rest (`APIOutput1` → `aPIOutput1`).
- */
-function camelizeName(name) {
-    const words = name.replace(/[^a-zA-Z0-9_ ]/g, '').split(/[\s_]+/).filter(Boolean);
-    return words.map((w, i) => (i === 0 ? w.charAt(0).toLowerCase() : w.charAt(0).toUpperCase()) + w.slice(1)).join('');
-}
 /** The `Error` output's schema: the designer's (and the CLI's) `ERROR_OUTPUT_SCHEMA`. */
 const ERROR_OUTPUT_SCHEMA = {
     type: 'object',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@uipath/maestro-builder-sdk",
-  "version": "6.52.1",
+  "version": "6.53.0",
   "description": "Build UiPath Flow, Case, and BPMN artifacts by writing TypeScript.",
   "license": "MIT",
   "homepage": "https://docs.uipath.com/maestro",
@@ -96,5 +96,5 @@
     "@types/node": "^22.7.0",
     "esbuild": "^0.28.1"
   },
-  "gitref": "d3566b616cb3addce005fe0b6962aa504adb79a3"
+  "gitref": "b271a259a3f380839348c118f296f9ec060f1598"
 }