@uipath/maestro-builder-sdk 6.25.0 → 6.25.1

package/dist/case/compile-cli.js

@@ -10,7 +10,8 @@
  * Output defaults to the plan file the project in the working directory ships
  * (`caseplan.case` for a project `uip maestro case init` scaffolded), else
  * `caseplan.json`. An `-o` that names a different plan file than the project
- * ships is refused (CASE_OUTPUT_NOT_SHIPPED).
+ * ships is refused (CASE_OUTPUT_NOT_SHIPPED), and so is a plan file written into
+ * a solution directory above its Case project (CASE_OUTPUT_OUTSIDE_PROJECT).
  */
 import { reportDiagnostics, reportResult, thrownDiagnostic } from '../cli-result.js';
 import { writeJsonFile } from '../core/json-file.js';
@@ -67,7 +68,7 @@ export async function run(argv) {
     const out = flagValue(argv, '-o') ?? shippedCasePlanName('.') ?? 'caseplan.json';
     const shadow = shadowedOutputDiagnostic(out);
     if (shadow) {
-        console.error(`  ✗ [${shadow.code}] ${shadow.message}`);
+        console.error(`  ✗ [${shadow.code}] ${shadow.message} Fix: ${shadow.suggestion}.`);
         reportDiagnostics([...diags, shadow]);
         console.error('compile: 1 error(s); not emitting.');
         return 1;
@@ -96,6 +97,9 @@ export async function run(argv) {
  * `uip maestro case init` scaffolds `caseplan.case` since uipath-cli#5004.
  */
 const CASE_PLAN_FILE_NAMES = ['caseplan.case', 'caseplan.json', 'case.stage.json', 'default.stage.json'];
+/** The file that makes a directory a project, and the `ProjectType` a Case project declares in it. */
+const PROJECT_FILE = 'project.uiproj';
+const CASE_PROJECT_TYPE = 'CaseManagement';
 /**
  * The plan file the project in `dir` ships, or undefined when `dir` is not a
  * Case project. Decided as the packager decides: the first plan file present in
@@ -126,6 +130,11 @@ function shadowedOutputDiagnostic(outPath) {
     if (!CASE_PLAN_FILE_NAMES.includes(name.toLowerCase()))
         return undefined;
     const dir = dirname(outPath);
+    // First: a plan file already in a solution directory would otherwise make it
+    // look like a project that ships that file.
+    const outside = outsideProjectDiagnostic(outPath);
+    if (outside)
+        return outside;
     const shipped = shippedCasePlanName(dir);
     if (!shipped || shipped === name)
         return undefined;
@@ -138,6 +147,53 @@ function shadowedOutputDiagnostic(outPath) {
         suggestion: `compile with -o ${target}`,
     };
 }
+/**
+ * A plan file in a non-project dir that holds Case projects (a solution dir) is
+ * packed by none. A directory that is itself a project, or holds no Case
+ * project, is not checked.
+ */
+function outsideProjectDiagnostic(outPath) {
+    const dir = dirname(outPath);
+    if (existsSync(join(dir, PROJECT_FILE)))
+        return undefined;
+    const projects = childCaseProjects(dir);
+    if (projects.length === 0)
+        return undefined;
+    const targets = projects.map((p) => join(dir, p, shippedCasePlanName(join(dir, p)) ?? CASE_PLAN_FILE_NAMES[0]));
+    return {
+        level: 'error',
+        code: 'CASE_OUTPUT_OUTSIDE_PROJECT',
+        message: `${outPath} is in a solution directory, not a Case project; no project packs it. ` +
+            `The Case project${projects.length > 1 ? 's here are' : ' here is'} ${projects.map((p) => join(dir, p)).join(', ')}.`,
+        suggestion: projects.length === 1 ? `compile with -o ${targets[0]}` : `compile with -o one of: ${targets.join(', ')}`,
+    };
+}
+/**
+ * Subdirectories of `dir` (or links to one) whose `project.uiproj` declares a
+ * CaseManagement project.
+ */
+function childCaseProjects(dir) {
+    let entries;
+    try {
+        entries = readdirSync(dir, { withFileTypes: true });
+    }
+    catch {
+        return [];
+    }
+    return entries
+        // A link counts: the read below fails for a link to a file.
+        .filter((e) => e.isDirectory() || e.isSymbolicLink())
+        .map((e) => e.name)
+        .filter((name) => {
+        try {
+            return JSON.parse(readFileSync(join(dir, name, PROJECT_FILE), 'utf8'))?.ProjectType === CASE_PROJECT_TYPE;
+        }
+        catch {
+            return false;
+        }
+    })
+        .sort();
+}
 /** The case file `package-descriptor.json` in `dir` ships, if it names one. */
 function describedCaseFileName(dir) {
     const descriptorPath = join(dir, 'package-descriptor.json');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@uipath/maestro-builder-sdk",
-  "version": "6.25.0",
+  "version": "6.25.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": "119258f247ce3ff7e3b3b3faf21ab2e2b13eca5a"
+  "gitref": "384f76113bc43067b5ec5ea700534e9611e664ff"
 }