@uipath/common 1.0.4 → 1.1.0

package/dist/attachment-binding.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Commander collector for repeatable string options. Use with `.option(...,
+ * appendOption, [] as string[])` to accumulate values across multiple flag
+ * occurrences (e.g. `--attachment a=b --attachment c=d`).
+ */
+export declare function appendOption(value: string, previous: string[] | undefined): string[];
+/** A parsed `name=path` --attachment spec. */
+export interface ParsedAttachmentSpec {
+    name: string;
+    path: string;
+}
+/**
+ * Standard `Instructions` text for an OutputFormatter error when the user's
+ * `--attachment` spec is malformed.
+ */
+export declare const ATTACHMENT_INSTRUCTIONS = "Provide --attachment as 'name=path' where 'name' matches a file-typed workflow input variable and 'path' points at a readable local file. Repeat the flag to attach multiple files.";
+/**
+ * Standard `Instructions` text when `--attachment` upload fails (auth, network,
+ * permissions). Pair with the underlying error message in `Message`.
+ */
+export declare const ATTACHMENT_UPLOAD_INSTRUCTIONS = "Check that the active tenant has Orchestrator access and the file is readable, then retry.";
+/**
+ * Parse a `name=path` --attachment spec for Maestro-engine file-variable
+ * binding (used by `flow debug` and `flow process run`).
+ *
+ * `name=` is mandatory: the engine resolves `=js:($vars.<scope>.input.<name>)`
+ * expressions in connector multipart slots against the uploaded
+ * `JobAttachmentReference`, so it needs the explicit workflow-variable name
+ * as the binding key. A bare path has no binding target and is rejected.
+ *
+ * Distinct from `or jobs run --attachment` which auto-derives a name from
+ * the basename when '=' is absent (no binding key required there).
+ */
+export declare function parseAttachmentSpec(spec: string): ParsedAttachmentSpec;
+/**
+ * Read each spec's bytes (fail-fast on any error), then upload all via the
+ * caller-supplied `upload` function (e.g. `uploadJobAttachment` from
+ * `@uipath/orchestrator-sdk`) in parallel. Returns references in input order.
+ *
+ * Two-phase to avoid orphaned attachments when a local path is bad: phase 1
+ * reads + validates every file before any network write. A read failure
+ * short-circuits before any upload begins. A mid-upload failure on one spec
+ * can still leave a sibling's attachment orphaned — accepted trade-off;
+ * Orchestrator has no atomic-batch endpoint.
+ *
+ * The `fileName` passed to `upload` is the local basename (not the LHS of
+ * `name=path`) so users recognize their uploaded file in the Orchestrator
+ * UI. The spec's `name` is preserved on the returned record for callers to
+ * use as the binding key in their inputs payload.
+ */
+export declare function resolveAttachmentInputs<R>(specs: ParsedAttachmentSpec[], upload: (bytes: Uint8Array, fileName: string) => Promise<R>): Promise<{
+    name: string;
+    path: string;
+    reference: R;
+}[]>;

package/dist/formatter.d.ts

@@ -75,6 +75,7 @@ export interface ErrorContext {
 }
 export declare class FailureOutput {
     Result: FailureResultType;
+    Code?: string;
     Message: string;
     Instructions: string;
     Context?: ErrorContext;

package/dist/index.browser.d.ts

@@ -0,0 +1,23 @@
+export * from "./catch-error";
+export * from "./command-examples";
+export * from "./command-help";
+export * from "./command-walker";
+export * from "./completer";
+export { installConsoleGuard, restoreConsole } from "./console-guard";
+export * from "./constants";
+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 "./polling";
+export * from "./screen-logger";
+export * from "./singleton";
+export * from "./telemetry/telemetry-events.js";
+export * from "./tool-provider";