@uipath/common 1.202.1 → 1.203.0-preview.180

package/dist/timings.d.ts

@@ -9,6 +9,9 @@
  * sum inside `command`, not a fourth slice, so parallel calls can push `http`
  * past `command`.
  *
+ * The report goes to stderr, or to the file named by `UIP_TIMINGS_FILE` when a
+ * caller cannot afford to write on the stream something else is reading.
+ *
  * State is reached through `Symbol.for()` slots (each tool bundles its own copy
  * of this package) and bound to the invocation's async context, so the MCP
  * bridge's concurrent in-process commands can't overwrite each other's numbers.
@@ -18,6 +21,8 @@
  */
 /** Environment variable that turns the report on (`1` or `true`). */
 export declare const TIMINGS_ENV_VAR = "UIP_TIMINGS";
+/** Environment variable naming a file to append the report to. */
+export declare const TIMINGS_FILE_ENV_VAR = "UIP_TIMINGS_FILE";
 /** Prefix every report line carries, so a pipeline can grep them out. */
 export declare const TIMINGS_LINE_PREFIX = "[timing]";
 /**
@@ -41,6 +46,20 @@ export declare function markLongLivedHost(): void;
 export declare function runWithTimings<T>(fallbackCommand: string, fn: () => Promise<T>): Promise<T>;
 /** Only `1` and `true` count, matching how the logger reads `DEBUG`. */
 export declare function timingsEnabled(): boolean;
+/**
+ * File the report is appended to, when one is named. Read only once the report
+ * is already on.
+ *
+ * Its own variable rather than a path value on {@link TIMINGS_ENV_VAR}, whose
+ * contract is that only `1` and `true` count: overloading it would turn a stray
+ * `UIP_TIMINGS=yes` from "off" into a relative file named `yes`.
+ *
+ * For a caller whose stderr is not free to write on: a harness timing the CLI
+ * while the process under measurement reads that same stream, or a wrapper that
+ * reads any stderr as failure. `--log-file` does not serve them, since it moves
+ * every log line and the caller stops seeing the diagnostics it had before.
+ */
+export declare function timingsFile(): string | undefined;
 /** Name the command being timed, once the parser has resolved it. */
 export declare function setTimingCommand(command: string): void;
 /**

package/dist/zip.d.ts

@@ -0,0 +1,14 @@
+import { type IFileSystem } from "@uipath/filesystem";
+/**
+ * Extract an in-memory zip archive into `destinationDir`.
+ *
+ * Rejects entries that escape the destination, both lexically and through a
+ * symlink already present at the destination. One residual gap: a *dangling*
+ * symlink as the final path component is not detectable through
+ * `IFileSystem`, which exposes `realpath` but no `lstat`. Callers extracting
+ * into a directory other processes can write to should hand this a freshly
+ * created destination rather than a reused one.
+ */
+export declare function extractZipDataToDir(fs: IFileSystem, zipData: Uint8Array, destinationDir: string): Promise<void>;
+/** Extract the zip archive at `archivePath` into `destinationDir`. */
+export declare function extractArchive(archivePath: string, destinationDir: string): Promise<void>;