@uipath/test-manager-tool 1.201.0-preview.115 → 1.201.0-preview.122

package/dist/index.js

@@ -3,7 +3,7 @@ import {
   Command,
   metadata,
   registerCommands
-} from "./tool-f9cxs2yf.js";
+} from "./tool-gr7rnsea.js";
 import"./tool-9qecd4wb.js";
 import"./tool-7eva0peq.js";
 import"./tool-5arsyj36.js";

package/dist/{tool-f9cxs2yf.js → tool-gr7rnsea.js}

@@ -11191,7 +11191,7 @@ var require_lib3 = __commonJS((exports, module) => {
 var package_default = {
   name: "@uipath/test-manager-tool",
   license: "MIT",
-  version: "1.201.0-preview.115",
+  version: "1.201.0-preview.122",
   description: "Manage test cases, test sets, executions, and results.",
   private: false,
   repository: {
@@ -11295,17 +11295,18 @@ var TLS_ERROR_CODES = new Set([
 ]);
 var TLS_INSTRUCTIONS = "The server's TLS certificate could not be verified. Most often a " + "corporate proxy/firewall re-signs HTTPS with a root CA that Node does " + "not trust — set NODE_EXTRA_CA_CERTS to that CA's PEM file (and HTTPS_PROXY " + "if you connect through a proxy). If the certificate is instead expired or " + "its hostname does not match, fix the endpoint URL or the system clock. " + "Then retry.";
 var NETWORK_INSTRUCTIONS = "Could not reach the UiPath service. Check your network connection and " + "VPN, confirm any HTTP_PROXY/HTTPS_PROXY/NO_PROXY settings are correct, " + "then retry.";
+var LOCAL_PERMISSION_ERROR_CODES = new Set(["EACCES", "EPERM", "EROFS"]);
+var LOCAL_PERMISSION_MESSAGE_PATTERN = /\b(EACCES|EPERM|EROFS)\b/;
+function localPermissionInstructions(code, path) {
+  const target = path !== undefined ? `'${path}'` : "a local file or resource";
+  if (code === "EROFS") {
+    return `The filesystem containing ${target} is read-only (EROFS), so the ` + "CLI could not write to it. This is a local environment problem, " + "not a UiPath service error — retrying will not help. Use a " + "writable location, or give this environment write access to the " + "path.";
+  }
+  const remedy = process.platform === "win32" ? "Re-run from an elevated terminal, close any program holding " + "the file open, or grant your user access to the path." : "Grant this user (or the sandbox the command runs in) access " + "to the path, or run the command outside the sandbox.";
+  return `The operating system denied access to ${target} (${code}). This is ` + "a local permission problem, not a UiPath service error — retrying " + `without a permission change will not help. ${remedy}`;
+}
 function describeConnectivityError(error) {
-  const queue = [error];
-  const seen = new Set;
-  for (let steps = 0;queue.length > 0 && steps < 32; steps++) {
-    const current = queue.shift();
-    if (current === null || typeof current !== "object")
-      continue;
-    if (seen.has(current))
-      continue;
-    seen.add(current);
-    const cur = current;
+  for (const cur of walkErrorGraph(error)) {
     const code = typeof cur.code === "string" ? cur.code : undefined;
     const message = typeof cur.message === "string" ? cur.message : undefined;
     if (code && TLS_ERROR_CODES.has(code)) {
@@ -11324,6 +11325,49 @@ function describeConnectivityError(error) {
         instructions: NETWORK_INSTRUCTIONS
       };
     }
+  }
+  return;
+}
+function describePermissionError(error) {
+  for (const cur of walkErrorGraph(error)) {
+    const message = typeof cur.message === "string" ? cur.message : undefined;
+    const code = matchLocalPermissionCode(cur.code, message);
+    if (!code)
+      continue;
+    const path = localPermissionPath(cur.path, message);
+    return {
+      code,
+      message: message ?? code,
+      ...path !== undefined ? { path } : {},
+      instructions: localPermissionInstructions(code, path)
+    };
+  }
+  return;
+}
+function matchLocalPermissionCode(code, message) {
+  if (typeof code === "string" && LOCAL_PERMISSION_ERROR_CODES.has(code)) {
+    return code;
+  }
+  const match = message ? LOCAL_PERMISSION_MESSAGE_PATTERN.exec(message) : null;
+  return match ? match[1] : undefined;
+}
+function localPermissionPath(path, message) {
+  if (typeof path === "string")
+    return path;
+  return message ? /'([^']+)'/.exec(message)?.[1] : undefined;
+}
+function* walkErrorGraph(error) {
+  const queue = [error];
+  const seen = new Set;
+  for (let steps = 0;queue.length > 0 && steps < 32; steps++) {
+    const current = queue.shift();
+    if (current === null || typeof current !== "object")
+      continue;
+    if (seen.has(current))
+      continue;
+    seen.add(current);
+    const cur = current;
+    yield cur;
     if (cur.cause !== undefined)
       queue.push(cur.cause);
     if (Array.isArray(cur.errors))
@@ -11384,6 +11428,12 @@ function classifyError(status, error) {
   if (status !== undefined && status >= 500 && status < 600) {
     return { errorCode: "server_error", retry: "RetryLater" };
   }
+  if (status === undefined && describePermissionError(error)) {
+    return {
+      errorCode: "local_permission_denied",
+      retry: "RetryWillNotFix"
+    };
+  }
   const connectivity = describeConnectivityError(error);
   if (connectivity) {
     return {
@@ -11486,6 +11536,16 @@ async function extractErrorDetails(error, options) {
       message = `${message}: ${connectivity.message}`;
     }
   }
+  const permission = status === undefined ? describePermissionError(error) : undefined;
+  if (permission) {
+    if (permission.message !== message && !message.includes(permission.message)) {
+      message = `${message}: ${permission.message}`;
+    }
+    if (!message.includes(permission.instructions)) {
+      const punctuated = message.endsWith(".") ? message : `${message}.`;
+      message = `${punctuated} ${permission.instructions}`;
+    }
+  }
   let details = rawMessage;
   if (rawBody) {
     if (parsedBody) {
@@ -11525,6 +11585,9 @@ async function extractErrorDetails(error, options) {
   if (parsedBody?.traceId && typeof parsedBody.traceId === "string") {
     context.traceId = parsedBody.traceId;
   }
+  if (permission?.path !== undefined) {
+    context.path = permission.path;
+  }
   if (status === 429) {
     const resp = response;
     const headersObj = resp?.headers;
@@ -12784,6 +12847,7 @@ var CLI_ERROR_CODES = [
   "invalid_argument",
   "authentication_required",
   "permission_denied",
+  "local_permission_denied",
   "not_found",
   "rate_limited",
   "network_error",
@@ -13219,12 +13283,16 @@ function defaultErrorCodeForHttpStatus(status) {
     return "server_error";
   return;
 }
+var LOCAL_PERMISSION_TEXT_PATTERN = /(?:\b|\()(?:EACCES|EPERM|EROFS)(?::\s|\))/;
 function defaultErrorCodeForFailure(data) {
   if (data.Result === RESULTS.Failure) {
     const status = data.Context?.httpStatus ?? parseHttpStatusFromMessage2(data.Message);
     const errorCode = defaultErrorCodeForHttpStatus(status);
     if (errorCode)
       return errorCode;
+    if (status === undefined && (LOCAL_PERMISSION_TEXT_PATTERN.test(data.Message) || LOCAL_PERMISSION_TEXT_PATTERN.test(data.Instructions))) {
+      return "local_permission_denied";
+    }
   }
   return defaultErrorCodeForResult(data.Result);
 }
@@ -13668,7 +13736,10 @@ function extractHttpStatus(err) {
   if (!err || typeof err !== "object")
     return;
   const e = err;
-  return e.response?.status ?? e.status ?? e.statusCode;
+  const structured = e.response?.status ?? e.status ?? e.statusCode;
+  if (structured !== undefined)
+    return structured;
+  return typeof e.message === "string" ? parseHttpStatusFromMessage(e.message) : undefined;
 }
 var GENERIC = "Check authentication and parameters";
 function instructionsFor(ctx, err) {
@@ -13702,6 +13773,10 @@ function instructionsFor(ctx, err) {
       if (status !== undefined && status >= 500 && status < 600) {
         return "Orchestrator returned a server error — retry; if it persists, check service status";
       }
+      const permission = describePermissionError(err);
+      if (permission) {
+        return permission.instructions;
+      }
       const connectivity = describeConnectivityError(err);
       if (connectivity) {
         return connectivity.instructions;
@@ -14320,11 +14395,10 @@ function installSdkUserAgentHeader(BaseApiClass, userAgent) {
 function installSdkCodingAgentHeader(BaseApiClass) {
   installRequestHeaderForwarding(BaseApiClass, codingAgentPatchKey(), (headers) => addSdkCodingAgentHeader(headers));
 }
-// ../common/src/tool-provider.ts
-var factorySlot = singleton("PackagerFactoryProvider");
-var moduleSlot = singleton("ToolModuleProvider");
 // ../common/src/telemetry/ship-succeeded.ts
 var shippedKeysSlot = singleton("ShipSucceededDedupeKeys");
+// ../common/src/tool-provider.ts
+var factorySlot = singleton("PackagerFactoryProvider");
 // ../test-manager-sdk/generated/src/runtime.ts
 var BASE_PATH = "/{organizationId}/{tenantName}/testmanager_".replace(/\/+$/, "");
 
@@ -22641,6 +22715,9 @@ var getAuthContext = async (options = {}) => {
     tenantName
   };
 };
+// ../auth/src/tenantSelection.ts
+var IDENTIFIER_STATUSES = new Set([400, 403, 404]);
+
 // ../auth/src/selectTenant.ts
 var TENANT_SELECTION_REQUIRED_CODE = "TENANT_SELECTION_REQUIRED";
 var INVALID_TENANT_CODE = "INVALID_TENANT";
@@ -26002,6 +26079,8 @@ var MESSAGES = {
     LOCKFILE_MISSING: "No supported lockfile found at the project root (package-lock.json, npm-shrinkwrap.json, bun.lock, bun.lockb, yarn.lock, or pnpm-lock.yaml). The robot uses the lockfile for a deterministic install — commit one before packing.",
     runnerDependencyMissing: (keys) => `None of the framework's test-runner packages (${keys.join(", ")}) is declared in package.json dependencies or devDependencies. Add the runner to your project before packing.`,
     TMH_PROJECT_KEY_REQUIRED: "--project-key is required when --create-test-cases is enabled (the default). Pass --project-key <ProjectKey> with the destination TestManager project's URL prefix, or pass --no-create-test-cases to skip auto-creation.",
+    tmhProjectKeyInvalid: (key) => `--project-key '${key}' is not a valid Test Manager project key. Keys are uppercase letters and digits only (A-Z, 0-9) — check the URL prefix of the destination project. Packing is offline, so a key that is well-formed but does not exist is only detected when the package is ingested.`,
+    PLAYWRIGHT_CONFIG_MISSING: "No playwright.config file found at the project root (looked for playwright.config.{ts,js,mts,cts,mjs,cjs}). Playwright projects are read from that config; without it every test packs with an empty projects list and --playwright-projects has nothing to select at run time.",
     PACK_FAILED: "Failed to create package"
   },
   SUCCESS: {
@@ -26015,58 +26094,6 @@ var MESSAGES = {
   }
 };
 
-// src/pack/actions/pack-manifest.ts
-async function detectBuildTool(projectPath, buildTools) {
-  const fs = getFileSystem();
-  for (const tool of buildTools) {
-    const present = await Promise.all(tool.lockfiles.map((name) => fs.exists(fs.path.join(projectPath, name))));
-    if (present.some(Boolean)) {
-      return tool;
-    }
-  }
-  return null;
-}
-async function validatePackageManifest(projectPath, buildTools, runnerDependencyKeys) {
-  const fs = getFileSystem();
-  const packageJsonPath = fs.path.join(projectPath, "package.json");
-  if (!await fs.exists(packageJsonPath)) {
-    return { ok: false, message: MESSAGES.ERRORS.PACKAGE_JSON_MISSING };
-  }
-  const buildTool = await detectBuildTool(projectPath, buildTools);
-  if (buildTool === null) {
-    return { ok: false, message: MESSAGES.ERRORS.LOCKFILE_MISSING };
-  }
-  const raw = await fs.readFile(packageJsonPath, "utf-8");
-  if (raw === null) {
-    return { ok: false, message: MESSAGES.ERRORS.PACKAGE_JSON_MISSING };
-  }
-  let parsed;
-  try {
-    parsed = JSON.parse(raw);
-  } catch {
-    return { ok: false, message: MESSAGES.ERRORS.PACKAGE_JSON_INVALID };
-  }
-  if (typeof parsed !== "object" || parsed === null) {
-    return { ok: false, message: MESSAGES.ERRORS.PACKAGE_JSON_INVALID };
-  }
-  const pkg = parsed;
-  for (const key of runnerDependencyKeys) {
-    const version = pkg.dependencies?.[key] ?? pkg.devDependencies?.[key];
-    if (typeof version === "string" && version.length > 0) {
-      return {
-        ok: true,
-        runnerPackage: key,
-        runnerVersion: version,
-        buildTool: buildTool.name
-      };
-    }
-  }
-  return {
-    ok: false,
-    message: MESSAGES.ERRORS.runnerDependencyMissing(runnerDependencyKeys)
-  };
-}
-
 // src/pack/discovery/run-subprocess.ts
 import { spawn } from "node:child_process";
 function runSubprocess(command, args, options) {
@@ -26242,6 +26269,58 @@ function normalizeStringArray(value) {
   return;
 }
 
+// src/pack/actions/pack-manifest.ts
+async function detectBuildTool(projectPath, buildTools) {
+  const fs = getFileSystem();
+  for (const tool of buildTools) {
+    const present = await Promise.all(tool.lockfiles.map((name) => fs.exists(fs.path.join(projectPath, name))));
+    if (present.some(Boolean)) {
+      return tool;
+    }
+  }
+  return null;
+}
+async function validatePackageManifest(projectPath, buildTools, runnerDependencyKeys) {
+  const fs = getFileSystem();
+  const packageJsonPath = fs.path.join(projectPath, "package.json");
+  if (!await fs.exists(packageJsonPath)) {
+    return { ok: false, message: MESSAGES.ERRORS.PACKAGE_JSON_MISSING };
+  }
+  const buildTool = await detectBuildTool(projectPath, buildTools);
+  if (buildTool === null) {
+    return { ok: false, message: MESSAGES.ERRORS.LOCKFILE_MISSING };
+  }
+  const raw = await fs.readFile(packageJsonPath, "utf-8");
+  if (raw === null) {
+    return { ok: false, message: MESSAGES.ERRORS.PACKAGE_JSON_MISSING };
+  }
+  let parsed;
+  try {
+    parsed = JSON.parse(raw);
+  } catch {
+    return { ok: false, message: MESSAGES.ERRORS.PACKAGE_JSON_INVALID };
+  }
+  if (typeof parsed !== "object" || parsed === null) {
+    return { ok: false, message: MESSAGES.ERRORS.PACKAGE_JSON_INVALID };
+  }
+  const pkg = parsed;
+  for (const key of runnerDependencyKeys) {
+    const version = pkg.dependencies?.[key] ?? pkg.devDependencies?.[key];
+    if (typeof version === "string" && version.length > 0) {
+      return {
+        ok: true,
+        runnerPackage: key,
+        runnerVersion: version,
+        buildTool: buildTool.name
+      };
+    }
+  }
+  return {
+    ok: false,
+    message: MESSAGES.ERRORS.runnerDependencyMissing(runnerDependencyKeys)
+  };
+}
+
 // src/pack/discovery/playwright-list.ts
 var SPAWN_TIMEOUT_MS = 60000;
 var WIN_CLI_REL = [
@@ -26578,6 +26657,8 @@ function isSecretFile(entryName) {
 }
 
 // src/pack/actions/pack.ts
+var TMH_PROJECT_KEY_PATTERN = /^[A-Z0-9]+$/;
+var TMH_PROJECT_KEY_MAX_LENGTH = 255;
 async function executePack(options) {
   const fs = getFileSystem();
   const absoluteProjectPath = fs.path.resolve(options.projectPath);
@@ -26606,12 +26687,18 @@ async function executePack(options) {
       message: MESSAGES.ERRORS.INVALID_PROJECT_PATH
     };
   }
-  if (!options.dryRun && options.createTestCases && (options.tmhProjectKey === undefined || options.tmhProjectKey.trim().length === 0)) {
+  if (options.createTestCases && (options.tmhProjectKey === undefined || options.tmhProjectKey.trim().length === 0)) {
     return {
       success: false,
       message: MESSAGES.ERRORS.TMH_PROJECT_KEY_REQUIRED
     };
   }
+  if (options.tmhProjectKey !== undefined && options.tmhProjectKey.trim().length > 0 && (!TMH_PROJECT_KEY_PATTERN.test(options.tmhProjectKey.trim()) || options.tmhProjectKey.trim().length > TMH_PROJECT_KEY_MAX_LENGTH)) {
+    return {
+      success: false,
+      message: MESSAGES.ERRORS.tmhProjectKeyInvalid(options.tmhProjectKey.trim())
+    };
+  }
   const stat = await fs.stat(absoluteProjectPath);
   if (!stat?.isDirectory()) {
     return {
@@ -26624,6 +26711,12 @@ async function executePack(options) {
     return { success: false, message: manifest.message };
   }
   logger.info(`Detected build tool: ${manifest.buildTool}`);
+  if (framework.type === "playwright" && await findConfigFile(absoluteProjectPath) === null) {
+    return {
+      success: false,
+      message: MESSAGES.ERRORS.PLAYWRIGHT_CONFIG_MISSING
+    };
+  }
   logger.info(MESSAGES.INFO.DISCOVERING_TESTS);
   const { tests } = await language.discoverTests(absoluteProjectPath, packageName);
   if (tests.length === 0) {
@@ -26907,7 +27000,7 @@ var PACK_EXAMPLES = [
   },
   {
     Description: "Preview what would be discovered and packaged, without writing anything",
-    Command: "uip tm pack --project-path ./e2e --type playwright --dry-run",
+    Command: "uip tm pack --project-path ./e2e --type playwright --project-key DEMO --dry-run",
     Output: {
       Code: "ExternalTestPackDryRun",
       Data: {
@@ -26918,7 +27011,7 @@ var PACK_EXAMPLES = [
   }
 ];
 var registerPackCommand = (program2) => {
-  program2.command("pack").description("Pack a Playwright test suite into a UiPath .nupkg for Test Manager. " + "For UiPath Studio test automation projects, use `rpa-legacy pack` instead.").requiredOption("--project-path <path>", "Path to the test project root (for playwright: the directory containing package.json, a lockfile, and playwright.config)").addOption(new Option("--type <type>", "Test framework").choices(SUPPORTED_TYPES).makeOptionMandatory()).option("-n, --name <name>", "Package name (default: project folder name)").option("--package-version <version>", "Package version", DEFAULT_VERSION).option("-o, --output <dir>", "Output directory", DEFAULT_OUTPUT_DIR).option("--author <author>", "Package author", DEFAULT_AUTHOR).option("--description <desc>", "Package description").option("--no-create-test-cases", "Do not auto-create Test Cases in Test Manager when this package is uploaded. Per-test label metadata is still embedded, so labels can be applied later when Test Cases are created.").option("--project-key <key>", "Test Manager project key that auto-created Test Cases land in (e.g. MYPROJ). Required when --create-test-cases is on (the default).").option("--dry-run", "Preview what would be packaged without creating").examples(PACK_EXAMPLES).trackedAction(processContext, async (options) => {
+  program2.command("pack").description("Pack a Playwright test suite into a UiPath .nupkg for Test Manager. " + "For UiPath Studio test automation projects, use `rpa-legacy pack` instead.").requiredOption("--project-path <path>", "Path to the test project root (for playwright: the directory containing package.json, a lockfile, and playwright.config). All three are required — the config is what defines the Playwright projects that --playwright-projects can later select.").addOption(new Option("--type <type>", "Test framework").choices(SUPPORTED_TYPES).makeOptionMandatory()).option("-n, --name <name>", "Package name (default: project folder name)").option("--package-version <version>", "Package version", DEFAULT_VERSION).option("-o, --output <dir>", "Output directory", DEFAULT_OUTPUT_DIR).option("--author <author>", "Package author", DEFAULT_AUTHOR).option("--description <desc>", "Package description").option("--no-create-test-cases", "Do not auto-create Test Cases in Test Manager when this package is uploaded. Per-test label metadata is still embedded, so labels can be applied later when Test Cases are created.").option("--project-key <key>", "Test Manager project key that auto-created Test Cases land in (e.g. MYPROJ) - uppercase letters and digits only. Required when --create-test-cases is on (the default). Packing is offline, so the format is checked here; whether the project exists is confirmed when the package is ingested.").option("--dry-run", "Preview what would be packaged without creating it. Applies the same validation as a real pack, so a dry run that succeeds will pack.").examples(PACK_EXAMPLES).trackedAction(processContext, async (options) => {
     const [error, result] = await catchError2(executePack({
       projectPath: options.projectPath,
       type: options.type,
@@ -34519,4 +34612,4 @@ var registerCommands = async (program2) => {
 
 export { Command, metadata, registerCommands };
 
-//# debugId=4D037C1E04CD6E5E64756E2164756E21
+//# debugId=ACC3CC627A5318FD64756E2164756E21

package/dist/tool.js

@@ -1,7 +1,7 @@
 import {
   metadata,
   registerCommands
-} from "./tool-f9cxs2yf.js";
+} from "./tool-gr7rnsea.js";
 import"./tool-9qecd4wb.js";
 import"./tool-7eva0peq.js";
 import"./tool-5arsyj36.js";

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@uipath/test-manager-tool",
   "license": "MIT",
-  "version": "1.201.0-preview.115",
+  "version": "1.201.0-preview.122",
   "description": "Manage test cases, test sets, executions, and results.",
   "private": false,
   "repository": {
@@ -26,5 +26,5 @@
   "files": [
     "dist"
   ],
-  "gitHead": "f1086b73654d7728cb71f280588b3e0c77d535fc"
+  "gitHead": "6c56f56100be96231fccbaa59e99d64d94808d58"
 }