@uipath/common 1.195.0 → 1.197.0-preview.59

package/dist/catch-error.js

@@ -0,0 +1,32 @@
+// src/catch-error.ts
+function isPromiseLike(value) {
+  return value !== null && typeof value === "object" && typeof value.then === "function";
+}
+function catchError(fnOrPromise) {
+  if (isPromiseLike(fnOrPromise)) {
+    return settlePromiseLike(fnOrPromise);
+  }
+  try {
+    const result = fnOrPromise();
+    if (isPromiseLike(result)) {
+      return settlePromiseLike(result);
+    }
+    return [undefined, result];
+  } catch (error) {
+    return [
+      error instanceof Error ? error : new Error(String(error)),
+      undefined
+    ];
+  }
+}
+function settlePromiseLike(thenable) {
+  return Promise.resolve(thenable).then((data) => [undefined, data]).catch((error) => [
+    error instanceof Error ? error : new Error(String(error)),
+    undefined
+  ]);
+}
+export {
+  catchError
+};
+
+//# debugId=246638ED7A60E04D64756E2164756E21

package/dist/confirmation.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Flags that affirm a destructive operation. `--yes` is the canonical flag for
+ * delete/remove commands; `--force` is the established alias used by overwrite
+ * commands (`init`, `pull`). Either one satisfies the guard.
+ *
+ * Add the flag to a command with
+ * `.option("-y, --yes", "Confirm this irreversible operation (required; the CLI never prompts)")`
+ * and gate the handler with {@link requireConfirmation}.
+ */
+export interface ConfirmationFlags {
+    yes?: boolean;
+    force?: boolean;
+}
+/**
+ * Guard a destructive operation. Returns `true` when the caller passed `--yes`
+ * (or `--force`). Otherwise emits a structured failure naming the flag to pass,
+ * sets a non-zero exit code via {@link processContext}, and returns `false` so
+ * the handler can bail in one line:
+ *
+ * ```ts
+ * if (!requireConfirmation(options, `delete folder '${id}'`)) return;
+ * ```
+ *
+ * @param flags - the parsed command options (must carry `yes`/`force`).
+ * @param operation - a short description of what will happen, e.g.
+ *   `"delete folder 'Finance'"`. Surfaced in the error message.
+ */
+export declare function requireConfirmation(flags: ConfirmationFlags, operation: string): boolean;

package/dist/content-hash.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Generate a SHA-256 hex hash of content for change detection.
+ * Prefers the Web Crypto API; falls back to node:crypto outside the browser.
+ *
+ * @param content - String content to hash
+ * @returns Hex string of the hash
+ */
+export declare function hashContent(content: string): Promise<string>;

package/dist/error-handler.d.ts

@@ -1,12 +1,16 @@
-import type { ErrorContext, FailureResultType } from "./formatter";
+import type { CliErrorCode, ErrorContext, FailureResultType, RetryHint } from "./formatter";
 /**
  * Structured error details returned by {@link extractErrorDetails}.
  */
 export interface ErrorDetails {
     /** Categorised failure type suitable for OutputFormatter.error() Result field */
     result: FailureResultType;
+    /** Stable CLI-owned error code suitable for agent control flow */
+    errorCode: CliErrorCode;
     /** Human-readable error message suitable for OutputFormatter.error() */
     message: string;
+    /** Stable retry guidance suitable for agent control flow */
+    retry: RetryHint;
     /** Raw details from the response body or error object for debugging */
     details: string;
     /** Machine-readable context for agents (HTTP status, request ID, retry-after, etc.) */
@@ -27,6 +31,31 @@ export interface ExtractErrorOptions {
     /** Custom message for HTTP 403 Forbidden errors. Uses a generic default if omitted. */
     forbiddenMessage?: string;
 }
+/**
+ * A connectivity failure (TLS trust or socket/DNS), already classified with
+ * actionable guidance. Returned by {@link describeConnectivityError}.
+ */
+export interface ConnectivityError {
+    /** The OS/TLS error code, e.g. `SELF_SIGNED_CERT_IN_CHAIN`. */
+    code: string;
+    /** Whether the failure is a TLS trust problem or a plain network problem. */
+    kind: "tls" | "network";
+    /** The most specific message found while walking the cause chain. */
+    message: string;
+    /** Actionable, user-facing remediation steps. */
+    instructions: string;
+}
+/**
+ * Classify an outbound connectivity failure by walking the `cause` chain.
+ *
+ * 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.
+ */
+export declare function describeConnectivityError(error: unknown): ConnectivityError | undefined;
 export declare function isHtmlDocument(body: string): boolean;
 /**
  * Extract a structured error message and details from an unknown thrown value.

package/dist/formatter.d.ts

@@ -1,6 +1,10 @@
 export type OutputFormat = "table" | "json" | "yaml" | "plain";
 export type ResultType = "Success" | "Failure" | "ConfigError" | "AuthenticationError" | "ValidationError" | "TimeoutError";
 export type FailureResultType = Exclude<ResultType, "Success">;
+export declare const CLI_ERROR_CODES: readonly ["invalid_argument", "authentication_required", "permission_denied", "not_found", "rate_limited", "network_error", "timeout", "server_error", "method_not_allowed", "configuration_error", "unknown_error"];
+export type CliErrorCode = (typeof CLI_ERROR_CODES)[number];
+export declare const RETRY_HINTS: readonly ["RetryWillNotFix", "RetryLater", "RetryAfter1Second", "RetryAfter10Seconds", "RetryAfter30Seconds", "RetryAfter60Seconds"];
+export type RetryHint = (typeof RETRY_HINTS)[number];
 /** Canonical string constants for {@link ResultType} values. */
 export declare const RESULTS: {
     readonly Success: "Success";
@@ -76,8 +80,10 @@ export interface ErrorContext {
 export declare class FailureOutput {
     Result: FailureResultType;
     Code?: string;
+    ErrorCode?: CliErrorCode;
     Message: string;
     Instructions: string;
+    Retry?: RetryHint;
     Context?: ErrorContext;
     Log?: string;
     /**
@@ -88,7 +94,13 @@ export declare class FailureOutput {
      * across success / failure paths.
      */
     Data?: DataRecord | DataRecord[];
-    constructor(result: FailureResultType, message: string, instructions: string, context?: ErrorContext);
+    /**
+     * Print the error and set the exit code, but don't emit the `uip.error`
+     * telemetry event — rate-limits high-frequency identical failures (e.g. a
+     * stuck auth-refresh loop). Stripped before the envelope is rendered.
+     */
+    SuppressTelemetry?: boolean;
+    constructor(result: FailureResultType, message: string, instructions: string, context?: ErrorContext, errorCode?: CliErrorCode, retry?: RetryHint);
 }
 export type StructuredOutput = SuccessOutput | FailureOutput;
 /**
@@ -119,7 +131,9 @@ export declare function validateOutputFilter(filter: string): Error | null;
 export declare class FilterEvaluationError extends Error {
     readonly __brand: "FilterEvaluationError";
     readonly filter: string;
+    readonly errorCode: CliErrorCode;
     readonly instructions: string;
+    readonly retry: RetryHint;
     readonly result: FailureResultType;
     constructor(filter: string, cause: unknown);
 }

package/dist/index.browser.d.ts

@@ -5,19 +5,27 @@ export * from "./command-walker";
 export * from "./completer";
 export { installConsoleGuard, restoreConsole } from "./console-guard";
 export * from "./constants";
+export * from "./content-hash";
 export * from "./env-reference";
 export * from "./error-handler";
 export * from "./error-instructions";
 export * from "./guid";
-export * from "./jsonpath";
 export * from "./logger";
 export * from "./option-validators";
 export * from "./orchestrator-urls";
 export * from "./output-context";
 export * from "./output-format-context";
 export * from "./output-sink";
+export * from "./package-metadata-options";
 export * from "./polling";
 export * from "./screen-logger";
+export * from "./sdk-user-agent";
 export * from "./singleton";
+export { BrowserContextStorage } from "./telemetry/browser-context-storage.js";
+export { ConsoleTelemetryProvider } from "./telemetry/console-telemetry-provider.js";
+export type { IContextStorage } from "./telemetry/context-storage.js";
 export * from "./telemetry/telemetry-events.js";
+export type { ITelemetryProvider } from "./telemetry/telemetry-provider.js";
+export type { ITelemetryService, TelemetryContext, TelemetryProperties, } from "./telemetry/telemetry-service.js";
+export { TelemetryService } from "./telemetry/telemetry-service.js";
 export * from "./tool-provider";