@uipath/maestro-builder-sdk 6.26.0 → 6.27.1

package/dist/flow-sdk.js

@@ -612,11 +612,23 @@ class StepList {
      * ], (other) => other.step('unknown', script({ code: 'return "Unknown";' })))
      * ```
      *
+     * @example
+     * **Cases with their own conditions** (`on` is `undefined`)
+     * ```ts
+     * .switch('route', undefined, [
+     *   { when: js`$vars.start.output.amount > 100`, label: 'High', body: (b) => b.step('review', script({ code: 'return 1;' })) },
+     *   { when: js`$vars.start.output.amount <= 100`, label: 'Low', body: (b) => b.step('auto', script({ code: 'return 2;' })) },
+     * ])
+     * ```
+     *
      * @param name - The switch node's id.
-     * @param on - The value to compare each case against.
-     * @param cases - One entry per arm, evaluated top to bottom; the first strict
-     * match wins. `label` names the arm's outgoing edge. `id` keeps a case's wire
-     * id (`inputs.cases[].id`, port `case-<id>`); omitted, it is `case_<n>`.
+     * @param on - The value to compare each `value` case against; `undefined`
+     * when every case carries its own `when` condition.
+     * @param cases - One entry per arm, evaluated top to bottom; the first match
+     * wins. A case is `{ value }` (strict `on === value`) or `{ when }` (its own
+     * boolean expression). `label` names the arm's outgoing edge. `id` keeps a
+     * case's wire id (`inputs.cases[].id`, port `case-<id>`); omitted, it is
+     * `case_<n>`.
      * @param defaultFn - Receives a sub-builder for the arm taken when nothing
      * matches. Omit it and an unmatched value simply continues.
      * @param options - Node options; `version` selects the exact definition
@@ -634,7 +646,14 @@ class StepList {
             // An arm's own `.label(...)` wins over the case config's `label`; either
             // overrides the serializer's derived `Case "<value>"`.
             const label = arm.armLabel ?? c.label;
-            return { value: c.value, ...(label !== undefined ? { label } : {}), ...(c.id !== undefined ? { id: c.id } : {}), body: arm.steps };
+            return {
+                // Both kept as given, so check can refuse a case with both or neither.
+                ...(c.value !== undefined ? { value: c.value } : {}),
+                ...(c.when !== undefined ? { when: toExpr(c.when) } : {}),
+                ...(label !== undefined ? { label } : {}),
+                ...(c.id !== undefined ? { id: c.id } : {}),
+                body: arm.steps,
+            };
         });
         let dflt;
         if (defaultFn) {
@@ -649,7 +668,7 @@ class StepList {
         this.steps.push({
             kind: 'switch',
             name,
-            on: toExpr(on),
+            ...(on !== undefined ? { on: toExpr(on) } : {}),
             cases: arms,
             ...(dflt !== undefined ? { default: dflt } : {}),
             ...(options ? { options } : {}),

package/dist/sdk-resolve.d.ts

@@ -4,8 +4,10 @@
  * `sdk-resolve-hook.ts` for why. Idempotent; call it before importing authored
  * source.
  *
- * Does nothing when the compiled hook is absent, which is the case only when
- * the SDK runs from its TypeScript source under the test runner. The runner
- * resolves imports itself, so no hook is needed there.
+ * Does nothing when the SDK runs from its TypeScript source under the test
+ * runner, which resolves imports itself. Anywhere else a missing hook means the
+ * SDK was bundled: authored source would then load a second copy of the
+ * package, its expressions would fail this copy's `instanceof` checks, and the
+ * `.flow` would come out wrong with no error. That throws instead.
  */
 export declare function useThisSdkForAuthoredSource(): void;

package/dist/sdk-resolve.js

@@ -2,6 +2,7 @@
 import { existsSync } from 'node:fs';
 import { register } from 'node:module';
 import { fileURLToPath } from 'node:url';
+import { PACKAGE_NAME } from './package-name.js';
 let registered = false;
 /**
  * Make `import … from '@uipath/maestro-builder-sdk'` in authored source resolve
@@ -9,16 +10,24 @@ let registered = false;
  * `sdk-resolve-hook.ts` for why. Idempotent; call it before importing authored
  * source.
  *
- * Does nothing when the compiled hook is absent, which is the case only when
- * the SDK runs from its TypeScript source under the test runner. The runner
- * resolves imports itself, so no hook is needed there.
+ * Does nothing when the SDK runs from its TypeScript source under the test
+ * runner, which resolves imports itself. Anywhere else a missing hook means the
+ * SDK was bundled: authored source would then load a second copy of the
+ * package, its expressions would fail this copy's `instanceof` checks, and the
+ * `.flow` would come out wrong with no error. That throws instead.
  */
 export function useThisSdkForAuthoredSource() {
     if (registered)
         return;
-    registered = true;
     const hook = new URL('./sdk-resolve-hook.js', import.meta.url);
-    if (!existsSync(fileURLToPath(hook)))
-        return;
+    if (!existsSync(fileURLToPath(hook))) {
+        if (import.meta.url.endsWith('.ts')) {
+            registered = true;
+            return;
+        }
+        throw new Error(`cannot point authored source at this copy of ${PACKAGE_NAME}: ${fileURLToPath(hook)} is missing, as in a bundle, `
+            + 'so its imports would load a second copy and serialize wrong. Run the installed package, or load authored source yourself.');
+    }
     register(hook);
+    registered = true;
 }

package/dist/serialize.js

@@ -6,9 +6,7 @@
  * resolved from the connector library (entry + v1def sidecar), matching what
  * the platform emits, so the result passes `uip maestro flow validate`.
  */
-import { readFileSync } from 'node:fs';
-import { fileURLToPath } from 'node:url';
-import { dirname, join } from 'node:path';
+import ixpDefinition from './ixp-definition.json' with { type: 'json' };
 import { BUNDLED_DEFINITIONS, bundledVersions } from './flow-definitions.js';
 import { Expr, toExpr, SCHEDULE_PRESETS, parseIxpProjectType, flatNameOf, flatNameSegmentsOf } from './flow-sdk.js';
 import { FlowAction, FlowTrigger } from './core/node-classes.js';
@@ -65,7 +63,6 @@ import { types } from './core/expr.js';
 import { SUBFLOW_START_LABEL } from './core/subflow-start.js';
 import { ownEntry } from './core/own-entry.js';
 import { jsonClone } from './core/json-file.js';
-const HERE = dirname(fileURLToPath(import.meta.url));
 // core-definitions.json is an object keyed by "<nodeType>@<version>".
 const DEFS = BUNDLED_DEFINITIONS;
 // FIRST occurrence wins: with multiple bundled versions of one family (HITL
@@ -2592,7 +2589,7 @@ function promptTokens(content) {
  * ["fileRef"]` (the pre-pull answer) instead of the three the platform's
  * `ixp-node` validator actually enforces.
  */
-const IXP_DEF = JSON.parse(readFileSync(join(HERE, 'ixp-definition.json'), 'utf8'));
+const IXP_DEF = ixpDefinition;
 /**
  * Build the definition for one published IxP project.
  *
@@ -6171,8 +6168,12 @@ export function serialize(built, opts = {}) {
                 // must leave from ITS handles), else positional (#1130).
                 const cases = step.cases.map((c, i) => ({
                     id: c.id ?? `case_${i + 1}`,
-                    label: c.label ?? `Case ${caseLiteral(c.value)}`,
-                    expression: `${renameRefs(step.on.js, scope.rename)} === ${caseLiteral(c.value)}`,
+                    // A `when` case writes its own condition — the product's per-case form,
+                    // first truthy case wins (#1131). A `value` case compares with `on`.
+                    label: c.label ?? (c.when !== undefined ? `Case ${i + 1}` : `Case ${caseLiteral(c.value)}`),
+                    expression: c.when !== undefined
+                        ? renameRefs(c.when.js, scope.rename)
+                        : `${renameRefs(step.on?.js ?? 'undefined', scope.rename)} === ${caseLiteral(c.value)}`,
                 }));
                 node.inputs = { cases, hasDefault: step.default !== undefined };
                 scope.nodes.push(node);

package/package.json

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