@uipath/common 1.202.0 → 1.203.0-preview.160

package/dist/THIRD-PARTY-NOTICES.md

@@ -5,13 +5,14 @@ compiled into its `dist/` output rather than installed alongside it.
 Their licences and copyright notices are reproduced here in full, as
 those licences require.
 
-15 bundled dependencies:
+16 bundled dependencies:
 
 - bundle-name@4.1.0 — MIT
 - commander@14.0.3 — MIT
 - default-browser@5.5.0 — MIT
 - default-browser-id@5.0.1 — MIT
 - define-lazy-prop@3.0.0 — MIT
+- fflate@0.8.3 — MIT
 - is-docker@3.0.0 — MIT
 - is-in-ssh@1.0.0 — MIT
 - is-inside-container@1.0.0 — MIT
@@ -128,6 +129,36 @@ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLI
 
 ---
 
+## fflate@0.8.3
+
+SPDX: MIT
+
+```
+MIT License
+
+Copyright (c) 2026 Arjun Barrett
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+```
+
+---
+
 ## is-docker@3.0.0
 
 SPDX: MIT

package/dist/catch-error.js

@@ -1,3 +1,19 @@
+var __defProp = Object.defineProperty;
+var __returnValue = (v) => v;
+function __exportSetter(name, newValue) {
+  this[name] = __returnValue.bind(null, newValue);
+}
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, {
+      get: all[name],
+      enumerable: true,
+      configurable: true,
+      set: __exportSetter.bind(all, name)
+    });
+};
+var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
+
 // src/telemetry/pseudonymize.ts
 var SHA256_K = new Uint32Array([
   1116352408,
@@ -278,4 +294,4 @@ export {
   describeThrownValue
 };
 
-//# debugId=523FB0079E2C37BE64756E2164756E21
+//# debugId=DE1DC90C72EC55C764756E2164756E21

package/dist/command-help.d.ts

@@ -1,6 +1,6 @@
 import type { Command, Help } from "commander";
 import { type CommandExample } from "./command-examples";
-import type { OutputFormat } from "./formatter";
+import { type OutputFormat } from "./output-formats";
 export interface CommandHelpOption {
     Flags: string;
     Description: string;

package/dist/entity-name-rules.js

@@ -1,3 +1,19 @@
+var __defProp = Object.defineProperty;
+var __returnValue = (v) => v;
+function __exportSetter(name, newValue) {
+  this[name] = __returnValue.bind(null, newValue);
+}
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, {
+      get: all[name],
+      enumerable: true,
+      configurable: true,
+      set: __exportSetter.bind(all, name)
+    });
+};
+var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
+
 // src/entity-name-rules.ts
 var RESERVED_SQL_KEYWORDS_LOWER = new Set(["group", "order"]);
 var ENTITY_NAME_PATTERN = /^[a-zA-Z][a-zA-Z0-9_]{2,99}$/;
@@ -238,4 +254,4 @@ export {
   validateName
 };
 
-//# debugId=DEFF72153B22EA2764756E2164756E21
+//# debugId=BC3BF446F31CC06D64756E2164756E21

package/dist/formatter.d.ts

@@ -1,5 +1,6 @@
+import { isOutputFormat, OUTPUT_FORMATS, type OutputFormat } from "./output-formats";
 import { type CommandErrorClass, type TerminalOutcome } from "./telemetry/command-terminal.js";
-export type OutputFormat = "table" | "json" | "yaml" | "plain";
+export { isOutputFormat, OUTPUT_FORMATS, type OutputFormat };
 /**
  * Per-row highlight for interactive TABLE output only. Applied line-level
  * AFTER column padding, so width math never sees escape bytes; json/yaml/plain
@@ -24,6 +25,23 @@ export type RetryHint = (typeof RETRY_HINTS)[number];
 export declare function isCliErrorCode(value: unknown): value is CliErrorCode;
 /** Narrow an arbitrary value to a {@link RetryHint}. See {@link isCliErrorCode}. */
 export declare function isRetryHint(value: unknown): value is RetryHint;
+/**
+ * The `ErrorCode` an error carries, when it classified itself.
+ *
+ * Companion to `carriedInstructions` (error-handler): a thrower that knows its
+ * failure mode can say so, and the renderer uses it instead of defaulting to
+ * `unknown_error`. Duck-typed and validated for the same reason — the error may
+ * have crossed a bundle boundary, and an unrecognised string must not reach the
+ * envelope as a code no consumer can branch on.
+ *
+ * Lives here, beside {@link isCliErrorCode}, rather than next to
+ * `carriedInstructions`: error-handler reaches formatter type-only on purpose,
+ * and a runtime edge from there pulls this module's telemetry imports into the
+ * browser bundle, which cannot require node builtins.
+ */
+export declare function carriedErrorCode(error: unknown): CliErrorCode | undefined;
+/** The `Retry` hint an error carries. See {@link carriedErrorCode}. */
+export declare function carriedRetry(error: unknown): RetryHint | undefined;
 /** Canonical string constants for {@link ResultType} values. */
 export declare const RESULTS: {
     readonly Success: "Success";
@@ -167,6 +185,19 @@ export type StructuredOutput = SuccessOutput | FailureOutput;
  * with the exact same escaping the CLI applies on the wire.
  */
 export declare function escapeNonAscii(jsonText: string): string;
+/**
+ * The text of a `{ message: "…" }` payload — a tool that returned prose rather
+ * than a record — or `null` for any other shape.
+ *
+ * Key casing varies: most tools go through PascalCase normalization, while ones
+ * that opt out with `preserveDataKeys` keep their own, so either is matched.
+ * Exported because every renderer that passes prose through untouched needs the
+ * same test, in this package and in the tool packages built on it.
+ *
+ * @param payload Candidate `Data` payload, of any shape.
+ * @returns The message text, or `null` when the payload is not a lone message.
+ */
+export declare function extractSingleMessage(payload: unknown): string | null;
 /**
  * Check whether `filter` is a syntactically valid JMESPath expression.
  * Returns `null` when valid, otherwise the parser error.
@@ -223,6 +254,24 @@ export declare class FilterImplicitLimitError extends Error {
     readonly result: FailureResultType;
     constructor(defaultLimit: string);
 }
+/**
+ * Thrown when connection configuration is missing or invalid — no base URL,
+ * no access token, GUIDs that don't parse, etc. Command reporters classify
+ * via {@link isConfigurationError} so they can emit a `ConfigError` envelope
+ * without matching on `error.message`.
+ *
+ * Uses a duck-type `__brand` rather than relying on `instanceof`, because each
+ * tool bundles its own copy of `@uipath/common` and class identity differs
+ * across bundle boundaries.
+ */
+export declare class ConfigurationError extends Error {
+    readonly __brand: "ConfigurationError";
+    readonly errorCode: CliErrorCode;
+    readonly retry: RetryHint;
+    readonly result: FailureResultType;
+    constructor(message: string);
+}
+export declare function isConfigurationError(error: unknown): error is ConfigurationError;
 /**
  * OutputFormatter namespace for formatting and displaying output.
  */

package/dist/guid.js

@@ -1,3 +1,19 @@
+var __defProp = Object.defineProperty;
+var __returnValue = (v) => v;
+function __exportSetter(name, newValue) {
+  this[name] = __returnValue.bind(null, newValue);
+}
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, {
+      get: all[name],
+      enumerable: true,
+      configurable: true,
+      set: __exportSetter.bind(all, name)
+    });
+};
+var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
+
 // src/guid.ts
 var GUID_REGEX = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
 function isGuid(value) {
@@ -7,4 +23,4 @@ export {
   isGuid
 };
 
-//# debugId=F25023E1915C1B3664756E2164756E21
+//# debugId=13FF8B3F125159DD64756E2164756E21

package/dist/index.browser.d.ts

@@ -17,6 +17,7 @@ export * from "./option-validators";
 export * from "./orchestrator-urls";
 export * from "./output-context";
 export * from "./output-format-context";
+export * from "./output-formats";
 export * from "./output-sink";
 export * from "./package-metadata-options";
 export * from "./polling";

package/dist/index.browser.js

@@ -20948,7 +20948,7 @@ var UUID_PATTERN = /\b[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{1
 var EMAIL_PATTERN = /\b[A-Za-z0-9._%+-]+@[A-Za-z0-9.-]+\.[A-Za-z]{2,}\b/g;
 var JWT_PATTERN = /\beyJ[A-Za-z0-9_-]{10,}\.[A-Za-z0-9_-]+\.[A-Za-z0-9_-]+/g;
 var LONG_TOKEN_PATTERN = /\b[A-Za-z0-9_-]{40,}\b/g;
-var PADDED_BASE64_PATTERN = /[A-Za-z0-9+/]{16,}={1,2}(?![A-Za-z0-9+/=])/g;
+var PADDED_BASE64_PATTERN = /(?<![A-Za-z0-9+/])[A-Za-z0-9+/]{16,}={1,2}(?![A-Za-z0-9+/=])/g;
 var BASE64_WITH_PLUS_PATTERN = /[A-Za-z0-9+/]{40,}/g;
 var USER_HOME_PATTERN = /(?<![A-Za-z0-9._-])([/\\])(Users|home|Profiles)([/\\])([^/\\]+)/gi;
 var UNC_PATH_PATTERN = /(^|[\s"'<>|=,;([{])(\\\\[^\s"'<>|]+)/g;
@@ -20995,7 +20995,7 @@ var QUOTED_LITERAL_PATTERN = new RegExp([
   `(?<![A-Za-z0-9])"(?:[^\\
 ]|\\.){2,${QUOTED_LITERAL_MAX_SPAN}}?"(?![A-Za-z0-9])`
 ].join("|"), "g");
-var JSON_BODY_PATTERN = /[{[][^{}[\]]*[:,][^{}[\]]*[\]}]/g;
+var JSON_BODY_PATTERN = /[{[][^{}[\]:,]*[:,][^{}[\]]*[\]}]/g;
 var COLLAPSED_BODY = "{…}";
 var COLLAPSED_BODY_MARKER = "\x01body\x01";
 var MAX_BODY_NESTING = 8;
@@ -21010,10 +21010,13 @@ function collapseJsonBodies(text) {
   }
   return out.split(COLLAPSED_BODY_MARKER).join(COLLAPSED_BODY);
 }
-var TRAILING_PROSE_PUNCT = /[.,;:!?)\]}>'"]+$/;
+var TRAILING_PROSE_PUNCT = `.,;:!?)]}>'"`;
 function peelTrailingPunctuation(match) {
-  const trailing = match.match(TRAILING_PROSE_PUNCT)?.[0] ?? "";
-  return trailing ? [match.slice(0, -trailing.length), trailing] : [match, ""];
+  let end = match.length;
+  while (end > 0 && TRAILING_PROSE_PUNCT.includes(match[end - 1])) {
+    end -= 1;
+  }
+  return [match.slice(0, end), match.slice(end)];
 }
 function redactUrl(raw) {
   try {
@@ -21261,6 +21264,18 @@ function setGlobalSink(sink) {
   sinkSlot.set(sink);
 }
 
+// src/output-formats.ts
+var OUTPUT_FORMATS = [
+  "table",
+  "json",
+  "yaml",
+  "plain",
+  "markdown"
+];
+function isOutputFormat(value) {
+  return OUTPUT_FORMATS.includes(value);
+}
+
 // src/command-help.ts
 function extractCommandHelp(cmd, helper) {
   const usage = helper.commandUsage(cmd);
@@ -21300,18 +21315,17 @@ function extractCommandHelp(cmd, helper) {
   }
   return result;
 }
-var VALID_FORMATS = ["table", "json", "yaml", "plain"];
 function extractFormatFromArgs(args) {
   for (let i2 = 0;i2 < args.length; i2++) {
     if (args[i2] === "--output" && i2 + 1 < args.length) {
       const value = args[i2 + 1];
-      if (VALID_FORMATS.includes(value)) {
+      if (isOutputFormat(value)) {
         return value;
       }
     }
     if (args[i2]?.startsWith("--output=")) {
       const value = args[i2].substring("--output=".length);
-      if (VALID_FORMATS.includes(value)) {
+      if (isOutputFormat(value)) {
         return value;
       }
     }
@@ -21867,6 +21881,22 @@ function parseHttpStatusFromMessage(message) {
   const status = Number(match[1]);
   return Number.isInteger(status) && status >= 100 && status <= 599 ? status : undefined;
 }
+function findHttpStatusInGraph(error) {
+  for (const node of walkErrorGraph(error)) {
+    const response = node.response;
+    const explicit = typeof node.status === "number" ? node.status : response?.status;
+    if (typeof explicit === "number" && explicit >= 400 && explicit <= 599) {
+      return explicit;
+    }
+    if (typeof node.message === "string") {
+      const parsed = parseHttpStatusFromMessage(node.message);
+      if (parsed !== undefined && parsed >= 400) {
+        return parsed;
+      }
+    }
+  }
+  return;
+}
 function isHtmlDocument(body) {
   return /^\s*(<!doctype html|<html\b)/i.test(body);
 }
@@ -21980,7 +22010,8 @@ async function extractErrorDetails(error, options) {
   }
   let message;
   let result = "Failure";
-  const classification = classifyError(status, error);
+  const classificationStatus = status ?? findHttpStatusInGraph(error);
+  const classification = classifyError(classificationStatus, error);
   let retry = classification.retry;
   if (status === 401) {
     message = DEFAULT_401;
@@ -22056,8 +22087,8 @@ async function extractErrorDetails(error, options) {
     details = describeThrownValue(error);
   }
   const context = {};
-  if (status) {
-    context.httpStatus = status;
+  if (classificationStatus) {
+    context.httpStatus = classificationStatus;
   }
   if (parsedBody?.errorCode && typeof parsedBody.errorCode === "string") {
     context.errorCode = parsedBody.errorCode;
@@ -24048,7 +24079,9 @@ class TelemetryService {
   }
 }
 // src/timings.ts
+import { getFileSystem as getFileSystem2 } from "@uipath/filesystem";
 var TIMINGS_ENV_VAR = "UIP_TIMINGS";
+var TIMINGS_FILE_ENV_VAR = "UIP_TIMINGS_FILE";
 var TIMINGS_LINE_PREFIX = "[timing]";
 function createStorage2() {
   const [error, mod] = catchError(() => (() => ({})));
@@ -24115,7 +24148,7 @@ async function runWithTimings(fallbackCommand, fn) {
         }
       }
       if (timingsEnabled()) {
-        emitTimingReport(state, fallbackCommand);
+        await emitTimingReport(state, fallbackCommand);
       }
     }
   });
@@ -24131,6 +24164,13 @@ function timingsEnabled() {
   const normalized = value.trim().toLowerCase();
   return normalized === "1" || normalized === "true";
 }
+function timingsFile() {
+  if (typeof process === "undefined") {
+    return;
+  }
+  const value = process.env?.[TIMINGS_FILE_ENV_VAR]?.trim();
+  return value === undefined || value === "" ? undefined : value;
+}
 function setTimingCommand(command) {
   if (!timingsEnabled()) {
     return;
@@ -24217,12 +24257,12 @@ function formatTimingReport(args) {
   parts.push(`flush=${total - startup - command}ms`);
   return parts.join(" ");
 }
-function emitTimingReport(state, fallbackCommand) {
+async function emitTimingReport(state, fallbackCommand) {
   if (state.suppressed) {
     return;
   }
   const now = performance.now();
-  logger.report(formatTimingReport({
+  const line = formatTimingReport({
     command: state.command ?? fallbackCommand,
     exitCode: state.exitCode ?? 0,
     totalMs: now - state.baseline,
@@ -24234,7 +24274,17 @@ function emitTimingReport(state, fallbackCommand) {
     },
     httpMs: state.httpMs,
     httpCalls: state.httpCalls
-  }));
+  });
+  const file = timingsFile();
+  if (file === undefined) {
+    logger.report(line);
+    return;
+  }
+  const [error] = await catchError(() => getFileSystem2().appendFile(file, `${line}
+`));
+  if (error) {
+    logger.report(line);
+  }
 }
 // src/packager-tool-import.ts
 var REGISTER_EXPORT = "registerPackagerFactories";
@@ -24294,12 +24344,14 @@ export {
   ErrorDecision,
   LogLevel,
   MIN_INTERVAL_MS,
+  OUTPUT_FORMATS,
   POLL_DEFAULTS,
   PollOutcome,
   ScreenLogger,
   TELEMETRY_SESSION_ID_ENV,
   TELEMETRY_SESSION_SOURCE_PROPERTY,
   TIMINGS_ENV_VAR,
+  TIMINGS_FILE_ENV_VAR,
   TIMINGS_LINE_PREFIX,
   TelemetryService,
   UIPATH_HOME_DIR,
@@ -24354,6 +24406,7 @@ export {
   isFailureStatus,
   isGuid,
   isHtmlDocument,
+  isOutputFormat,
   isSuccessStatus,
   isTerminalStatus,
   logger,
@@ -24397,8 +24450,9 @@ export {
   suppressTimingReport,
   takeRecordedCommandFailureTelemetry,
   timingsEnabled,
+  timingsFile,
   validateName,
   withCompleter
 };
 
-//# debugId=0481BE8702F1F3FB64756E2164756E21
+//# debugId=37F07319EF673DA664756E2164756E21