@uipath/common 1.198.0 → 1.199.0-preview.104

package/dist/body-validators.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Shared contract for body-level (post-parse, pre-SDK) validators.
+ *
+ * Commander option validators live in `option-validators.ts` — those coerce a
+ * single raw string at parse time. These body validators run once the command
+ * has parsed and merged its inputs into a JS object, and check higher-level
+ * rules: name formats, enum blocklists, cross-field invariants, immutable
+ * fields, and anything else the SDK / server rejects with a message a user
+ * would struggle to act on.
+ *
+ * Every validator returns `null` on success, or a `ValidationError` the
+ * command handler can pass straight to its `fail(msg, instr)` helper. This
+ * keeps the contract identical across tools — each tool provides its own set
+ * of validator functions and calls `runValidators()` (or the ergonomic
+ * `runChecks()`) to run them in order.
+ */
+export interface ValidationError {
+    message: string;
+    instructions: string;
+}
+export type Validator<T> = (input: T) => ValidationError | null;
+/**
+ * Run each validator on the input in order. Returns the first error or `null`
+ * if every validator passes. Bind the input by closure or use
+ * `runChecks()` when you want a runnable list of independent checks.
+ */
+export declare function runValidators<T>(input: T, validators: Validator<T>[]): ValidationError | null;
+/**
+ * Run a list of prebound checks and return the first failing one. Each check
+ * is a nullary function so callers can queue heterogeneous validators without
+ * threading a shared input type. Use when several validators each read
+ * different slices of the command's parsed body:
+ *
+ *   const err = runChecks([
+ *       () => validateName(name, "entity"),
+ *       () => findUiBrokenFieldType(fields),
+ *       () => findInvalidFieldName(fields),
+ *   ]);
+ *   if (err) return fail(err.message, err.instructions);
+ */
+export declare function runChecks(checks: Array<() => ValidationError | null>): ValidationError | null;

package/dist/formatter.d.ts

@@ -110,6 +110,26 @@ export declare class FailureOutput {
     constructor(result: FailureResultType, message: string, instructions: string, context?: ErrorContext, errorCode?: CliErrorCode, retry?: RetryHint);
 }
 export type StructuredOutput = SuccessOutput | FailureOutput;
+/**
+ * Escape every non-ASCII codepoint in a JSON-encoded string as `\uXXXX`.
+ *
+ * Why: on Windows, when stdout is piped (not a TTY), Node writes raw UTF-8
+ * bytes which PowerShell decodes using `[Console]::OutputEncoding` (cp 437 /
+ * Shift_JIS / Windows-1252). Non-ASCII bytes get re-decoded incorrectly,
+ * producing mojibake AND structurally invalid JSON (a stray byte from a
+ * multi-byte UTF-8 sequence collides with the closing quote). Emitting pure
+ * ASCII via `\uXXXX` escapes — valid JSON per the spec — survives every
+ * code page intact; `JSON.parse` / `ConvertFrom-Json` etc. all un-escape
+ * correctly. Surrogate pairs (non-BMP codepoints) emit two escapes, which
+ * JSON parsers reconstruct.
+ *
+ * Linux and macOS consumers read pipe bytes as UTF-8 by default, so this
+ * escape is only applied on Windows (see `needsAsciiSafeJson`).
+ *
+ * Exported so the host e2e clean-output test can build its expected bytes
+ * with the exact same escaping the CLI applies on the wire.
+ */
+export declare function escapeNonAscii(jsonText: string): string;
 /**
  * Check whether `filter` is a syntactically valid JMESPath expression.
  * Returns `null` when valid, otherwise the parser error.

package/dist/index.browser.js

@@ -21027,6 +21027,7 @@ function resolveEnvReference(value) {
 var DEFAULT_401 = "Unauthorized (401). Run `uip login` to authenticate.";
 var DEFAULT_403 = "Forbidden (403). Ensure the account has the required permissions.";
 var DEFAULT_405 = "Method Not Allowed (405). The endpoint may not exist or the base URL may be incorrect.";
+var DEFAULT_413 = "Payload too large (413). The upload exceeded the server or CDN size limit. Reduce the package size — for example, exclude unused dependencies or remove large files from the project — and try again.";
 var HTML_RESPONSE_MESSAGE = "Received HTML instead of the expected JSON response.";
 var NETWORK_ERROR_CODES = new Set([
   "ECONNREFUSED",
@@ -21159,6 +21160,9 @@ function classifyError(status, error) {
   if (status === 405) {
     return { errorCode: "method_not_allowed", retry: "RetryWillNotFix" };
   }
+  if (status === 413) {
+    return { errorCode: "invalid_argument", retry: "RetryWillNotFix" };
+  }
   if (status === 408) {
     return { errorCode: "timeout", retry: "RetryLater" };
   }
@@ -21236,6 +21240,8 @@ async function extractErrorDetails(error, options) {
     result = "AuthenticationError";
   } else if (status === 405) {
     message = DEFAULT_405;
+  } else if (status === 413) {
+    message = DEFAULT_413;
   } else if (status === 400 || status === 422) {
     message = formatHttpStatusMessage(status, rawMessage, extractedMessage, inferredStatus);
     result = "ValidationError";
@@ -22464,6 +22470,7 @@ var SKILL_ATTRIBUTION = attributionRecord([
 var KNOWN_SKILL_NAMES = new Set(Object.keys(SKILL_ATTRIBUTION));
 var COMMAND_ATTRIBUTION = commandAttribution([
   ["cli", "troubleshoot", ["uip.feedback"]],
+  ["llm-gateway", "operate", ["uip.llm-gateway"]],
   ["llm-gateway", "operate", ["uip.llm-configuration", "uip.model-hub"]],
   ["context-grounding", "build", ["uip.context-grounding"]],
   ["api-workflow", "build", ["uip.api-workflow"]],
@@ -23414,4 +23421,4 @@ export {
   AUTH_FILENAME
 };
 
-//# debugId=A8F9E8E6B48366FF64756E2164756E21
+//# debugId=5714488353CEE82464756E2164756E21

package/dist/index.d.ts

@@ -1,4 +1,5 @@
 export * from "./attachment-binding";
+export * from "./body-validators";
 export * from "./catch-error";
 export * from "./command-examples";
 export * from "./command-help";

package/dist/index.js

@@ -2998,6 +2998,7 @@ function settlePromiseLike(thenable) {
 var DEFAULT_401 = "Unauthorized (401). Run `uip login` to authenticate.";
 var DEFAULT_403 = "Forbidden (403). Ensure the account has the required permissions.";
 var DEFAULT_405 = "Method Not Allowed (405). The endpoint may not exist or the base URL may be incorrect.";
+var DEFAULT_413 = "Payload too large (413). The upload exceeded the server or CDN size limit. Reduce the package size — for example, exclude unused dependencies or remove large files from the project — and try again.";
 var HTML_RESPONSE_MESSAGE = "Received HTML instead of the expected JSON response.";
 var NETWORK_ERROR_CODES = new Set([
   "ECONNREFUSED",
@@ -3130,6 +3131,9 @@ function classifyError(status, error) {
   if (status === 405) {
     return { errorCode: "method_not_allowed", retry: "RetryWillNotFix" };
   }
+  if (status === 413) {
+    return { errorCode: "invalid_argument", retry: "RetryWillNotFix" };
+  }
   if (status === 408) {
     return { errorCode: "timeout", retry: "RetryLater" };
   }
@@ -3207,6 +3211,8 @@ async function extractErrorDetails(error, options) {
     result = "AuthenticationError";
   } else if (status === 405) {
     message = DEFAULT_405;
+  } else if (status === 413) {
+    message = DEFAULT_413;
   } else if (status === 400 || status === 422) {
     message = formatHttpStatusMessage(status, rawMessage, extractedMessage, inferredStatus);
     result = "ValidationError";
@@ -3384,6 +3390,23 @@ async function resolveAttachmentInputs(specs, upload) {
     return { name: p.name, path: p.path, reference };
   }));
 }
+// src/body-validators.ts
+function runValidators(input, validators) {
+  for (const v of validators) {
+    const err = v(input);
+    if (err !== null)
+      return err;
+  }
+  return null;
+}
+function runChecks(checks) {
+  for (const check of checks) {
+    const err = check();
+    if (err !== null)
+      return err;
+  }
+  return null;
+}
 // ../../node_modules/commander/esm.mjs
 var import__ = __toESM(require_commander(), 1);
 var {
@@ -10950,6 +10973,7 @@ var SKILL_ATTRIBUTION = attributionRecord([
 var KNOWN_SKILL_NAMES = new Set(Object.keys(SKILL_ATTRIBUTION));
 var COMMAND_ATTRIBUTION = commandAttribution([
   ["cli", "troubleshoot", ["uip.feedback"]],
+  ["llm-gateway", "operate", ["uip.llm-gateway"]],
   ["llm-gateway", "operate", ["uip.llm-configuration", "uip.model-hub"]],
   ["context-grounding", "build", ["uip.context-grounding"]],
   ["api-workflow", "build", ["uip.api-workflow"]],
@@ -12319,6 +12343,8 @@ export {
   setGlobalLogFilePath,
   setExecutionContextAuthSignal,
   runWithSink,
+  runValidators,
+  runChecks,
   restoreConsole,
   resolveTelemetrySessionId,
   resolveEnvReference,
@@ -12387,6 +12413,7 @@ export {
   extractErrorMessage,
   extractErrorDetails,
   extractCommandHelp,
+  escapeNonAscii,
   ensurePackagerFactory,
   detectExecutionContext,
   detectAgentVersion,
@@ -12456,4 +12483,4 @@ export {
   ATTACHMENT_INSTRUCTIONS
 };
 
-//# debugId=770AFB2BE9F8C7B964756E2164756E21
+//# debugId=0104AD30EA6F6A7264756E2164756E21

package/dist/telemetry/index.js

@@ -77,6 +77,7 @@ var SKILL_ATTRIBUTION = attributionRecord([
 var KNOWN_SKILL_NAMES = new Set(Object.keys(SKILL_ATTRIBUTION));
 var COMMAND_ATTRIBUTION = commandAttribution([
   ["cli", "troubleshoot", ["uip.feedback"]],
+  ["llm-gateway", "operate", ["uip.llm-gateway"]],
   ["llm-gateway", "operate", ["uip.llm-configuration", "uip.model-hub"]],
   ["context-grounding", "build", ["uip.context-grounding"]],
   ["api-workflow", "build", ["uip.api-workflow"]],
@@ -822,4 +823,4 @@ export {
   BrowserContextStorage
 };
 
-//# debugId=B104F80E6DBFBC9064756E2164756E21
+//# debugId=0CFD50D10461DCC664756E2164756E21

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@uipath/common",
   "license": "MIT",
-  "version": "1.198.0",
+  "version": "1.199.0-preview.104",
   "description": "Common infrastructure needed by uip tools.",
   "repository": {
     "type": "git",
@@ -67,5 +67,5 @@
     "mihaigirleanu",
     "vlad-uipath"
   ],
-  "gitHead": "1fadf03d7a8dd102742571dff569fdac11808afb"
+  "gitHead": "829a8ab8a25bce5b62c284bd1ddc674d2947f647"
 }