@uipath/maestro-builder-sdk 6.40.0 → 6.41.0

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

@@ -2725,9 +2725,10 @@ declare abstract class ScopeBuilder {
      * therefore proves the graph runs and the artifact validates — nothing about the
      * message actually arriving. See Phase 5 in `docs/BPMN_COVERAGE_DESIGN.md`.
      *
-     * The throw side (`Maestro.SendMessageEvent`) is deliberately NOT authored: its
-     * required `Reference` payload field cannot be expressed in a way the platform
-     * validator accepts. See `unsatisfiableRequiredInputs`.
+     * The throw side (`Maestro.SendMessageEvent`) has no builder method yet; author it
+     * as `.activity('send', 'Maestro.SendMessageEvent', { context: { name, inputSchema },
+     * inputs: { Reference } })` — it validates on uip 1.205 (Phase 6 in
+     * `docs/BPMN_COVERAGE_DESIGN.md`).
      *
      * @example
      * **Wait for another process to signal a shipment**

package/dist/bpmn/bpmn-sdk.js

@@ -344,6 +344,15 @@ class ScopeBuilder {
      * @returns This builder, so calls chain.
      */
     pushActivity(node, body) {
+        // An `outputVar` names the variable the type's own output row lands in; a type
+        // with no output row (the fire-and-forget Async starts) would accept it and emit
+        // nothing, so the author reads a variable nothing ever writes.
+        if (node.kind === 'typed' && node.outputVar !== undefined && !node.outputRows && !registryType(node.type, node.spec).output) {
+            throw new Error(`"${node.id}" (${node.type}) publishes no output row, so outputVar "${node.outputVar}" would bind nothing. ` +
+                (node.type.endsWith('Async')
+                    ? 'The Async start returns before the job does: drop outputVar, or use the waiting form (async: false) to read the response.'
+                    : 'Drop outputVar, or spell the rows with outputRows.'));
+        }
         this.place(node);
         if (body)
             body(new ActivityBuilder(this, node.id));
@@ -1620,9 +1629,10 @@ class ScopeBuilder {
      * therefore proves the graph runs and the artifact validates — nothing about the
      * message actually arriving. See Phase 5 in `docs/BPMN_COVERAGE_DESIGN.md`.
      *
-     * The throw side (`Maestro.SendMessageEvent`) is deliberately NOT authored: its
-     * required `Reference` payload field cannot be expressed in a way the platform
-     * validator accepts. See `unsatisfiableRequiredInputs`.
+     * The throw side (`Maestro.SendMessageEvent`) has no builder method yet; author it
+     * as `.activity('send', 'Maestro.SendMessageEvent', { context: { name, inputSchema },
+     * inputs: { Reference } })` — it validates on uip 1.205 (Phase 6 in
+     * `docs/BPMN_COVERAGE_DESIGN.md`).
      *
      * @example
      * **Wait for another process to signal a shipment**

package/dist/bpmn/check.js

@@ -3,7 +3,7 @@ import { allNodes, folderCompanionKeys, implicitNodeVars, processId } from './se
 import { KNOWN_METHOD_SET } from './known-methods.js';
 import { EQUALS_EXPR_DIALECT, checkConnectorContract, checkConnectorLookups, checkConnectorSchema, checkBindingLabels, } from '../core/connector-checks.js';
 import { checkEventResolution, checkEventSubscription, eventParamsFor, } from '../core/event-checks.js';
-import { bindingRequiredFields, missingRequiredContext, missingRequiredInputs, REGISTRY_GAPS, registryType, unsatisfiableRequiredInputs, } from './typed-node.js';
+import { bindingRequiredFields, CASE_RUNTIME_INTERNAL_TYPES, missingRequiredContext, missingRequiredInputs, REGISTRY_GAPS, registryType, } from './typed-node.js';
 import { ownEntry } from '../core/own-entry.js';
 /**
  * The job-start family — the types whose engine handler switches addressing on the
@@ -1427,20 +1427,20 @@ inEventSubProcess = false) {
                     where: n.id,
                 });
             }
-            // A type whose required payload fields cannot be expressed at all. Warning,
-            // not error: the node is as correct as the registry allows, so refusing it
-            // would block work the platform, not the author, has to fix. Saying nothing
-            // is worse — the artifact validates here and is rejected by the CLI.
-            const unsatisfiable = unsatisfiableRequiredInputs(n.type, n.spec);
-            if (unsatisfiable.length) {
+            // A type the case-management runtime writes for itself. Warning, not error:
+            // the platform validates it, and nobody designs a process around it. The one
+            // legitimate authored form is a preserved import, which `decompile` writes as
+            // `contextVerbatim: true` — that node is left alone, so a brownfield edit that
+            // keeps the platform's nodes as they were is not told off on every check.
+            if (CASE_RUNTIME_INTERNAL_TYPES.has(n.type) && n.contextVerbatim !== true) {
                 diags.push({
                     level: 'warning',
-                    code: 'REQUIRED_INPUT_UNSATISFIABLE',
-                    message: `"${n.id}" (${n.type}) declares required input(s) ${unsatisfiable.map((f) => `"${f}"`).join(', ')}, ` +
-                        `but its "${registryType(n.type, n.spec).inputPattern}" pattern merges every input into one row, so the ` +
-                        `platform's required-field rule cannot see them. \`uip maestro bpmn validate\` will report ` +
-                        `EMPTY_REQUIRED_FIELD whatever this node carries — a platform defect, not an authoring error. ` +
-                        `See docs/BPMN_COVERAGE_DESIGN.md D13.`,
+                    code: 'TYPE_RUNTIME_INTERNAL',
+                    message: `"${n.id}" (${n.type}) is a node the case-management runtime writes for itself when it materializes a ` +
+                        `case plan (scheduler state only the platform produces); the canvas offers it nowhere, and a process is not ` +
+                        `designed around one — author the case in the Case SDK instead. To preserve an imported one as it was, keep ` +
+                        `the form \`decompile\` writes (\`contextVerbatim: true\`), which this check leaves alone. ` +
+                        `See its row in typescript/sdk/bpmn-coverage.json.`,
                     where: n.id,
                 });
             }

package/dist/bpmn/registry-fallback.js

@@ -159,7 +159,11 @@ export function shapeExtensionType(spec) {
         output,
         eventDefinition: eventDefinitionOf(spec.XmlTemplate),
         requiresDiscovery: Boolean(spec.RequiresDiscovery),
+        isDynamic: Boolean(spec.IsDynamic),
         bindingPattern: spec.BindingPattern ?? 'none',
+        placements: Object.fromEntries(Object.entries((spec.Placements ?? {}))
+            .sort(([a], [b]) => a.localeCompare(b))
+            .map(([name, p]) => [name, { element: p?.Type ?? null, eventDefinition: p?.EventDefinition?.Type ?? null }])),
     };
 }
 /** `registry get <type>`, shaped, or `undefined` when the registry has no such type. */