@uipath/common 1.197.0 → 1.198.0-preview.80

package/dist/error-handler.d.ts

@@ -45,15 +45,19 @@ export interface ConnectivityError {
     /** Actionable, user-facing remediation steps. */
     instructions: string;
 }
+export declare function formatErrorChain(error: unknown): string;
 /**
- * Classify an outbound connectivity failure by walking the `cause` chain.
+ * Classify an outbound connectivity failure by walking the error graph.
  *
  * Node's native `fetch` wraps the real failure (a TLS or socket error) inside
  * a generic `TypeError: fetch failed`, so the useful code/message lives on
- * `error.cause` (sometimes nested deeper). This unwraps that chain and, when
- * it finds a known TLS or network code, returns the specific message plus
- * remediation steps. Returns `undefined` for anything that isn't a recognised
- * connectivity failure so callers can fall back to their normal handling.
+ * `error.cause` (sometimes nested deeper). When fetch races several addresses
+ * (IPv4/IPv6, or proxy fallbacks) it instead collects the per-attempt failures
+ * in an `AggregateError.errors` array — so the code can hide there rather than
+ * on a single `.cause`. This walks both edges and, when it finds a known TLS
+ * or network code, returns the specific message plus remediation steps.
+ * Returns `undefined` for anything that isn't a recognised connectivity
+ * failure so callers can fall back to their normal handling.
  */
 export declare function describeConnectivityError(error: unknown): ConnectivityError | undefined;
 export declare function isHtmlDocument(body: string): boolean;

package/dist/formatter.d.ts

@@ -179,6 +179,7 @@ export declare namespace OutputFormatter {
     function emitList<T extends DataRecord>(code: string, items: T[], opts?: {
         emptyInstructions?: string;
         warning?: string;
+        pagination?: Pagination;
     }): void;
     /**
      * Log an informational/progress message to stderr.

package/dist/index.browser.js

@@ -21051,9 +21051,47 @@ 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.";
+function formatErrorChain(error) {
+  const lines = [];
+  const seen = new Set;
+  const visit = (value, depth) => {
+    if (lines.length >= 32)
+      return;
+    const indent = "  ".repeat(depth);
+    if (value === null || typeof value !== "object") {
+      lines.push(`${indent}${String(value)}`);
+      return;
+    }
+    if (seen.has(value))
+      return;
+    seen.add(value);
+    const cur = value;
+    const name = typeof cur.name === "string" ? cur.name : "Error";
+    const message = typeof cur.message === "string" ? cur.message : String(value);
+    const code2 = typeof cur.code === "string" ? ` [${cur.code}]` : "";
+    lines.push(`${indent}${name}: ${message}${code2}`);
+    if (cur.cause !== undefined)
+      visit(cur.cause, depth + 1);
+    if (Array.isArray(cur.errors)) {
+      for (const nested of cur.errors) {
+        visit(nested, depth + 1);
+      }
+    }
+  };
+  visit(error, 0);
+  return lines.join(`
+`);
+}
 function describeConnectivityError(error) {
-  let current = error;
-  for (let depth = 0;depth < 5 && current !== null && typeof current === "object"; depth++) {
+  const queue2 = [error];
+  const seen = new Set;
+  for (let steps = 0;queue2.length > 0 && steps < 32; steps++) {
+    const current = queue2.shift();
+    if (current === null || typeof current !== "object")
+      continue;
+    if (seen.has(current))
+      continue;
+    seen.add(current);
     const cur = current;
     const code2 = typeof cur.code === "string" ? cur.code : undefined;
     const message = typeof cur.message === "string" ? cur.message : undefined;
@@ -21073,7 +21111,10 @@ function describeConnectivityError(error) {
         instructions: NETWORK_INSTRUCTIONS
       };
     }
-    current = cur.cause;
+    if (cur.cause !== undefined)
+      queue2.push(cur.cause);
+    if (Array.isArray(cur.errors))
+      queue2.push(...cur.errors);
   }
   return;
 }
@@ -21668,6 +21709,7 @@ function buildActionCenterTaskUrl(baseUrl, org, tenant, taskId) {
 // src/output-format-context.ts
 var formatSlot = singleton("OutputFormat");
 var formatExplicitSlot = singleton("OutputFormatExplicit");
+var helpRequestedSlot = singleton("HelpRequested");
 var filterSlot = singleton("OutputFilter");
 function setOutputFormat(format4) {
   formatSlot.set(format4);
@@ -21681,6 +21723,12 @@ function setOutputFormatExplicit(explicit) {
 function getOutputFormatExplicit() {
   return formatExplicitSlot.get(false) ?? false;
 }
+function setHelpRequested(requested) {
+  helpRequestedSlot.set(requested);
+}
+function getHelpRequested() {
+  return helpRequestedSlot.get(false) ?? false;
+}
 function setOutputFilter(filter) {
   filterSlot.set(filter);
 }
@@ -23049,6 +23097,7 @@ export {
   setOutputFormatExplicit,
   setOutputFormat,
   setOutputFilter,
+  setHelpRequested,
   setGlobalSink,
   setGlobalLogFilePath,
   runWithSink,
@@ -23087,10 +23136,12 @@ export {
   getOutputFormat,
   getOutputFilter,
   getLogFilePath,
+  getHelpRequested,
   getGlobalLogFilePath,
   getConfiguredTelemetrySessionId,
   getCompleter,
   getCommandExamples,
+  formatErrorChain,
   extractFormatFromArgs,
   extractErrorMessageSync,
   extractErrorMessage,
@@ -23135,4 +23186,4 @@ export {
   AUTH_FILENAME
 };
 
-//# debugId=ACC353BBF445886C64756E2164756E21
+//# debugId=1ABA04740FFFD86664756E2164756E21

package/dist/index.js

@@ -3022,9 +3022,47 @@ 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.";
+function formatErrorChain(error) {
+  const lines = [];
+  const seen = new Set;
+  const visit = (value, depth) => {
+    if (lines.length >= 32)
+      return;
+    const indent = "  ".repeat(depth);
+    if (value === null || typeof value !== "object") {
+      lines.push(`${indent}${String(value)}`);
+      return;
+    }
+    if (seen.has(value))
+      return;
+    seen.add(value);
+    const cur = value;
+    const name = typeof cur.name === "string" ? cur.name : "Error";
+    const message = typeof cur.message === "string" ? cur.message : String(value);
+    const code = typeof cur.code === "string" ? ` [${cur.code}]` : "";
+    lines.push(`${indent}${name}: ${message}${code}`);
+    if (cur.cause !== undefined)
+      visit(cur.cause, depth + 1);
+    if (Array.isArray(cur.errors)) {
+      for (const nested of cur.errors) {
+        visit(nested, depth + 1);
+      }
+    }
+  };
+  visit(error, 0);
+  return lines.join(`
+`);
+}
 function describeConnectivityError(error) {
-  let current = error;
-  for (let depth = 0;depth < 5 && current !== null && typeof current === "object"; depth++) {
+  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;
     const code = typeof cur.code === "string" ? cur.code : undefined;
     const message = typeof cur.message === "string" ? cur.message : undefined;
@@ -3044,7 +3082,10 @@ function describeConnectivityError(error) {
         instructions: NETWORK_INSTRUCTIONS
       };
     }
-    current = cur.cause;
+    if (cur.cause !== undefined)
+      queue.push(cur.cause);
+    if (Array.isArray(cur.errors))
+      queue.push(...cur.errors);
   }
   return;
 }
@@ -8456,6 +8497,7 @@ function configureLogger(config) {
 // src/output-format-context.ts
 var formatSlot = singleton("OutputFormat");
 var formatExplicitSlot = singleton("OutputFormatExplicit");
+var helpRequestedSlot = singleton("HelpRequested");
 var filterSlot = singleton("OutputFilter");
 function setOutputFormat(format) {
   formatSlot.set(format);
@@ -8469,6 +8511,12 @@ function setOutputFormatExplicit(explicit) {
 function getOutputFormatExplicit() {
   return formatExplicitSlot.get(false) ?? false;
 }
+function setHelpRequested(requested) {
+  helpRequestedSlot.set(requested);
+}
+function getHelpRequested() {
+  return helpRequestedSlot.get(false) ?? false;
+}
 function setOutputFilter(filter) {
   filterSlot.set(filter);
 }
@@ -10073,6 +10121,9 @@ var OutputFormatter;
     if (opts?.warning) {
       data.Warning = opts.warning;
     }
+    if (opts?.pagination) {
+      data.Pagination = opts.pagination;
+    }
     success(data);
   }
   OutputFormatter.emitList = emitList;
@@ -10730,12 +10781,19 @@ function isGuid(value) {
 }
 // src/interactivity-context.ts
 var modeSlot = singleton("InteractivityMode");
+var interactiveFlagSlot = singleton("InteractiveFlag");
 function setInteractivityMode(mode) {
   modeSlot.set(mode);
 }
 function getInteractivityMode() {
   return modeSlot.get("auto") ?? "auto";
 }
+function setInteractiveFlag(passed) {
+  interactiveFlagSlot.set(passed);
+}
+function wasInteractiveFlagPassed() {
+  return interactiveFlagSlot.get(false) ?? false;
+}
 function canPrompt() {
   const mode = getInteractivityMode();
   if (mode === "always") {
@@ -11611,6 +11669,7 @@ async function ensurePackagerFactory(verb) {
 }
 export {
   withCompleter,
+  wasInteractiveFlagPassed,
   warnDeprecatedTenantOption,
   warnDeprecatedOptionAlias,
   validateOutputFilter,
@@ -11628,6 +11687,8 @@ export {
   setOutputFormat,
   setOutputFilter,
   setInteractivityMode,
+  setInteractiveFlag,
+  setHelpRequested,
   setGlobalTelemetryProperties,
   setGlobalSink,
   setGlobalLogFilePath,
@@ -11683,11 +11744,13 @@ export {
   getOutputFilter,
   getLogFilePath,
   getInteractivityMode,
+  getHelpRequested,
   getGlobalLogFilePath,
   getExecutionContextTelemetryProperties,
   getConfiguredTelemetrySessionId,
   getCompleter,
   getCommandExamples,
+  formatErrorChain,
   extractFormatFromArgs,
   extractErrorMessageSync,
   extractErrorMessage,
@@ -11757,4 +11820,4 @@ export {
   ATTACHMENT_INSTRUCTIONS
 };
 
-//# debugId=619EF92A7A37ECCD64756E2164756E21
+//# debugId=B968F19E94F17CAD64756E2164756E21

package/dist/interactivity-context.d.ts

@@ -24,6 +24,13 @@ export type InteractivityMode = "never" | "auto" | "always";
 export declare function setInteractivityMode(mode: InteractivityMode): void;
 /** Get the current interactivity mode, defaulting to "auto". */
 export declare function getInteractivityMode(): InteractivityMode;
+/**
+ * Record whether the global `--interactive` flag was explicitly passed on the
+ * command line. Called once at CLI startup, alongside {@link setInteractivityMode}.
+ */
+export declare function setInteractiveFlag(passed: boolean): void;
+/** True when the user explicitly passed `--interactive` (see {@link setInteractiveFlag}). */
+export declare function wasInteractiveFlagPassed(): boolean;
 /**
  * True when the CLI may show an interactive prompt right now.
  *

package/dist/output-format-context.d.ts

@@ -27,6 +27,18 @@ export declare function setOutputFormatExplicit(explicit: boolean): void;
  * Defaults to false (i.e. resolved value is the default).
  */
 export declare function getOutputFormatExplicit(): boolean;
+/**
+ * Record whether the user asked for help explicitly (`-h`/`--help`).
+ * Kept separate from the output format so that the help renderer can force
+ * the table layout without hijacking the format used for error output —
+ * errors always follow the real format (json by default). Set once at CLI
+ * startup.
+ */
+export declare function setHelpRequested(requested: boolean): void;
+/**
+ * True when `-h`/`--help` was passed on the command line. Defaults to false.
+ */
+export declare function getHelpRequested(): boolean;
 /**
  * Set the process-wide output filter expression.
  * Called once at CLI startup after parsing the global --output-filter option.

package/dist/singleton.d.ts

@@ -38,5 +38,5 @@ export interface Singleton<T> {
  *
  * The key is auto-prefixed with `@uipath/common/`.
  */
-export declare function singleton<T>(ctor: abstract new (...args: any[]) => T): Singleton<T>;
+export declare function singleton<T>(ctor: abstract new (...args: never[]) => T): Singleton<T>;
 export declare function singleton<T>(name: string): Singleton<T>;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@uipath/common",
   "license": "MIT",
-  "version": "1.197.0",
+  "version": "1.198.0-preview.80",
   "description": "Common infrastructure needed by uip tools.",
   "repository": {
     "type": "git",
@@ -67,5 +67,5 @@
     "mihaigirleanu",
     "vlad-uipath"
   ],
-  "gitHead": "56f68b263cec4ea1f2a39d738bd99ecf52f88fea"
+  "gitHead": "9b2c3c0f21a256d2f38dd28bc97e72e6f7b10a9c"
 }