@uipath/maestro-builder-sdk 6.9.4 → 6.9.5

package/README.md

@@ -161,7 +161,6 @@ The UiPath CLI is the authoring front door. Beyond the two verbs the quick start
 uses:
 
 ```bash
-uip maestro flow check HelloWorld.flow --compiled   # deep validation of the ARTIFACT
 uip maestro flow validate HelloWorld.flow           # the product validator
 uip maestro flow debug HelloWorld.flow              # run it
 ```
@@ -193,11 +192,6 @@ argv grammar, or exit meanings are semver-governed. The package also declares th
 `@uipath/maestro-builder-sdk/cli` export for tooling that needs to verify this surface; normal
 authors should invoke it through `uip maestro`.
 
-For `uip maestro flow check --compiled --uip`, the SDK's checker starts a nested
-`uip maestro flow registry get` process to resolve missing schemas. This is
-intentional and does not recurse into `check`. Set `UIP_BIN` to an alternate uip
-executable when the desired binary is not the one on `PATH`.
-
 ## What you can express
 
 Every node type the platform runs has a builder form. Control flow and data:

package/dist/cli/commands/bpmn.js

@@ -1,4 +1,4 @@
-import { addValue, inferCheckMode, invoke, loadTool } from '../common.js';
+import { addValue, inferCheckMode, invoke, loadTool, retiredCompiledOption } from '../common.js';
 export function registerBpmnCommands(program) {
     const family = program.command('bpmn').description('Build, inspect, and merge BPMN artifacts.');
     family.command('compile')
@@ -15,10 +15,10 @@ export function registerBpmnCommands(program) {
         await invoke('bpmn compile', () => loadTool(import.meta.url, '../../bpmn/compile-cli.js'), argv);
     });
     family.command('check')
-        .description('Check authored TypeScript; use the product CLI for compiled BPMN.')
-        .argument('<input>', 'source or .bpmn artifact')
+        .description('Check authored TypeScript. Check a .bpmn with `uip maestro bpmn validate`.')
+        .argument('<input>', 'a .bpmn.ts path or bare name')
         .option('--source', 'check authored TypeScript')
-        .option('--compiled', 'identify a compiled artifact')
+        .addOption(retiredCompiledOption())
         .action(async (input, options) => {
         let mode;
         try {

package/dist/cli/commands/case.js

@@ -1,4 +1,4 @@
-import { addValue, inferCheckMode, invoke, loadTool } from '../common.js';
+import { addValue, inferCheckMode, invoke, loadTool, retiredCompiledOption } from '../common.js';
 export function registerCaseCommands(program) {
     const family = program.command('case').description('Build, check, and merge Case artifacts.');
     family.command('compile')
@@ -17,10 +17,10 @@ export function registerCaseCommands(program) {
         await invoke('case compile', () => loadTool(import.meta.url, '../../case/compile-cli.js'), argv);
     });
     family.command('check')
-        .description('Check authored TypeScript; use the product CLI for caseplan.json.')
-        .argument('<input>', 'source or caseplan.json')
+        .description('Check authored TypeScript. Check a caseplan.json with `uip maestro case validate`.')
+        .argument('<input>', 'a .case.ts path or bare name')
         .option('--source', 'check authored TypeScript')
-        .option('--compiled', 'identify a compiled artifact')
+        .addOption(retiredCompiledOption())
         .action(async (input, options) => {
         let mode;
         try {

package/dist/cli/commands/flow.d.ts

@@ -1,2 +1,2 @@
-import type { Command } from 'commander';
+import { type Command } from 'commander';
 export declare function registerFlowCommands(program: Command): void;

package/dist/cli/commands/flow.js

@@ -1,4 +1,20 @@
-import { addValue, emitOnlyEnabled, inferCheckMode, invoke, loadTool } from '../common.js';
+import { Option } from 'commander';
+import { addValue, emitOnlyEnabled, inferCheckMode, invoke, loadTool, retiredCompiledOption } from '../common.js';
+/** The retired compiled check's flags: `[commander flags, option key, description]`. One table, so hiding and warning cannot drift. */
+const RETIRED_COMPILED_CHECK_FLAGS = [
+    ['--json', 'json', 'retired: compiled-check diagnostics as JSON'],
+    ['--uip', 'uip', 'retired: resolve missing schemas with the UiPath CLI'],
+    ['--max-errors <count>', 'maxErrors', 'retired: stop after this many compiled-check errors'],
+    ['--script-determinism', 'scriptDeterminism', 'retired: check script blocks for non-deterministic calls'],
+    ['--quiet', 'quiet', 'retired: suppress warnings and information'],
+    ['--debug-internal', 'debugInternal', 'retired: include internal compile context'],
+    ['--dump-ir', 'dumpIr', 'retired: print the generated intermediate representation'],
+];
+function retiredFlagsPassed(options) {
+    return RETIRED_COMPILED_CHECK_FLAGS
+        .filter(([, key]) => options[key] !== undefined && options[key] !== false)
+        .map(([flags]) => flags.split(' ')[0]);
+}
 export function registerFlowCommands(program) {
     const flow = program.command('flow').description('Build and check Flow artifacts.');
     flow.command('compile')
@@ -19,20 +35,18 @@ export function registerFlowCommands(program) {
             argv.push('--no-check');
         await invoke('flow compile', () => loadTool(import.meta.url, '../../compile-cli.js'), argv);
     });
-    flow.command('check')
-        .description('Check authored TypeScript or a compiled .flow artifact.')
-        .argument('<input>', 'source or compiled artifact')
+    const check = flow.command('check')
+        .description('Check authored TypeScript. Check a compiled .flow with `uip maestro flow validate`.')
+        .argument('<input>', 'a .flow.ts path or bare name')
         .option('--source', 'check authored TypeScript')
-        .option('--compiled', 'check the emitted artifact')
+        .addOption(retiredCompiledOption())
         .option('--library <dir>', 'connector library directory')
-        .option('--connectors-local <dir>', 'connection-resolved connector overlay')
-        .option('--json', 'print compiled-check diagnostics as JSON')
-        .option('--uip', 'resolve missing schemas with the UiPath CLI')
-        .option('--max-errors <count>', 'stop after this many compiled-check errors')
-        .option('--script-determinism', 'check script blocks for non-deterministic calls')
-        .option('--quiet', 'suppress warnings and information')
-        .option('--debug-internal', 'include internal compile context')
-        .option('--dump-ir', 'print the generated intermediate representation')
+        .option('--connectors-local <dir>', 'connection-resolved connector overlay');
+    // Hidden, not removed: scripts that pass these keep parsing.
+    for (const [flags, , description] of RETIRED_COMPILED_CHECK_FLAGS) {
+        check.addOption(new Option(flags, description).hideHelp());
+    }
+    check
         .action(async (input, options) => {
         if (emitOnlyEnabled()) {
             console.error('flow-sdk flow check: disabled by emit-only mode; use `uip maestro flow validate` or `uip maestro flow debug`');
@@ -49,6 +63,12 @@ export function registerFlowCommands(program) {
             return;
         }
         if (mode === 'source') {
+            const ignored = retiredFlagsPassed(options);
+            // Not under `--quiet`: a caller asking for less output (an older
+            // `uip` still forwards it) must not get a new line because of it.
+            if (ignored.length > 0 && options.quiet !== true) {
+                console.error(`flow-sdk flow check: ignoring ${ignored.join(', ')} (used only by the retired compiled check)`);
+            }
             const argv = [input];
             addValue(argv, '--library', options.library);
             addValue(argv, '--connectors-local', options.connectorsLocal);

package/dist/cli/common.d.ts

@@ -1,3 +1,4 @@
+import { Option } from 'commander';
 export type ToolRun = (argv: string[]) => Promise<number> | number;
 export declare function loadTool(baseUrl: string, relativePath: string): Promise<{
     run: ToolRun;
@@ -28,3 +29,8 @@ export declare function addValue(argv: string[], flag: string, value: unknown):
 export declare function emitOnlyEnabled(cwd?: string, env?: NodeJS.ProcessEnv): boolean;
 export type CheckMode = 'source' | 'compiled';
 export declare function inferCheckMode(family: 'flow' | 'case' | 'bpmn', input: string, source: boolean, compiled: boolean): CheckMode;
+/**
+ * `--compiled` on `<family> check`: hidden from `--help`, still accepted so a
+ * script that passes it gets the redirect to `uip maestro <family> validate`.
+ */
+export declare function retiredCompiledOption(): Option;

package/dist/cli/common.js

@@ -1,5 +1,6 @@
 import { existsSync, readFileSync } from 'node:fs';
 import { dirname, join, resolve } from 'node:path';
+import { Option } from 'commander';
 export function loadTool(baseUrl, relativePath) {
     return import(new URL(relativePath, baseUrl).href);
 }
@@ -90,3 +91,10 @@ export function inferCheckMode(family, input, source, compiled) {
     }
     return source ? 'source' : compiled ? 'compiled' : inferred;
 }
+/**
+ * `--compiled` on `<family> check`: hidden from `--help`, still accepted so a
+ * script that passes it gets the redirect to `uip maestro <family> validate`.
+ */
+export function retiredCompiledOption() {
+    return new Option('--compiled', 'retired: a compiled artifact is checked by `uip maestro <family> validate`').hideHelp();
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@uipath/maestro-builder-sdk",
-  "version": "6.9.4",
+  "version": "6.9.5",
   "description": "Build UiPath Flow, Case, and BPMN artifacts by writing TypeScript.",
   "license": "MIT",
   "homepage": "https://docs.uipath.com/maestro",
@@ -87,5 +87,5 @@
     "@types/node": "^22.7.0",
     "esbuild": "^0.28.1"
   },
-  "gitref": "ca9f8350a07eaf7ec145b315ad37e75e00a23049"
+  "gitref": "00c45d3d66df22a4df5cacf627baa308f7d43532"
 }