@uipath/common 1.195.0 → 1.196.0

package/dist/interactivity-context.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Process-wide interactivity mode.
+ *
+ * The CLI is non-interactive by default: an automation agent or CI runner can
+ * never answer a `y/N` prompt, so a hidden prompt hangs the caller forever.
+ * Commands consult {@link canPrompt} before showing any optional/selection
+ * prompt; when it returns `false` they must fall back to a flag-driven path or
+ * fail fast with a structured error naming the flag to pass.
+ *
+ * Modes:
+ *   - "never"  — never prompt (the default; the safe machine-first contract).
+ *   - "auto"   — prompt only when stdout is a TTY (opt-in via config for humans).
+ *   - "always" — always prompt (assume a prompt-capable terminal).
+ *
+ * Stored via {@link singleton} so the value set once by the CLI host is visible
+ * from every tool bundle's own copy of `@uipath/common`.
+ *
+ * Note: destructive confirmation does NOT use this — it is flag-only and
+ * fail-closed (see `confirmation.ts`). Interactivity governs *optional* prompts.
+ */
+export type InteractivityMode = "never" | "auto" | "always";
+/** Set the process-wide interactivity mode. Called once at CLI startup. */
+export declare function setInteractivityMode(mode: InteractivityMode): void;
+/** Get the current interactivity mode, defaulting to "never". */
+export declare function getInteractivityMode(): InteractivityMode;
+/**
+ * True when the CLI may show an interactive prompt right now.
+ *
+ * "always" always prompts; "never" never does; "auto" prompts only when the
+ * output sink reports an interactive (TTY) terminal — the canonical signal also
+ * used by `login` and `completion`.
+ */
+export declare function canPrompt(): boolean;

package/dist/package-metadata-options.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Shared package-traceability metadata options for `pack` commands.
+ *
+ */
+import type { Command } from "commander";
+/**
+ * Raw camelCased values commander produces for the shared metadata options.
+ * Commands extend their own option interface with this.
+ */
+export interface PackageMetadataCliOptions {
+    repositoryUrl?: string;
+    repositoryCommit?: string;
+    repositoryBranch?: string;
+    repositoryType?: string;
+    releaseNotes?: string;
+    projectUrl?: string;
+}
+/**
+ * Subset of `NugetPackageInfo` fields produced from the metadata options.
+ * Only defined fields are present so spreading this into a package literal
+ * never clobbers existing defaults with `undefined`.
+ */
+export type PackageMetadataFields = PackageMetadataCliOptions;
+/**
+ * Register the shared package-metadata options on a commander command.
+ * Returns the command for chaining.
+ */
+export declare function registerPackageMetadataOptions(command: Command): Command;
+/**
+ * Map parsed metadata options to the `NugetPackageInfo` fields the packager
+ * understands. Returns only fields the user actually supplied, and defaults
+ * `repositoryType` to `"git"` when a `repositoryUrl` is given but no type —
+ * the nuspec generator only emits the `<repository>` element when both type
+ * and url are present.
+ */
+export declare function mapPackageMetadataOptions(opts: PackageMetadataCliOptions): PackageMetadataFields;

package/dist/package-metadata-options.js

@@ -0,0 +1,27 @@
+// src/package-metadata-options.ts
+function registerPackageMetadataOptions(command) {
+  return command.option("--repository-url <url>", "Source repository URL (recorded in the package for traceability)").option("--repository-commit <sha>", "Source repository commit hash (recorded in the package for traceability)").option("--repository-branch <branch>", "Source repository branch").option("--repository-type <type>", "Source repository type (defaults to 'git' when --repository-url is set)").option("--release-notes <text>", "Release notes for the package").option("--project-url <url>", "Automation Hub idea URL");
+}
+function mapPackageMetadataOptions(opts) {
+  const fields = {};
+  if (opts.releaseNotes !== undefined)
+    fields.releaseNotes = opts.releaseNotes;
+  if (opts.projectUrl !== undefined)
+    fields.projectUrl = opts.projectUrl;
+  if (opts.repositoryUrl !== undefined)
+    fields.repositoryUrl = opts.repositoryUrl;
+  if (opts.repositoryCommit !== undefined)
+    fields.repositoryCommit = opts.repositoryCommit;
+  if (opts.repositoryBranch !== undefined)
+    fields.repositoryBranch = opts.repositoryBranch;
+  if (opts.repositoryType !== undefined)
+    fields.repositoryType = opts.repositoryType;
+  if (fields.repositoryUrl !== undefined && fields.repositoryType === undefined) {
+    fields.repositoryType = "git";
+  }
+  return fields;
+}
+export {
+  registerPackageMetadataOptions,
+  mapPackageMetadataOptions
+};

package/dist/stdin.d.ts

@@ -0,0 +1 @@
+export declare function readStdin(): Promise<string | null>;

package/dist/telemetry/global-telemetry-properties.d.ts

@@ -0,0 +1,8 @@
+import type { TelemetryProperties } from "./telemetry-service.js";
+/**
+ * Merge `properties` into the shared global base properties.
+ * Existing keys are preserved unless overwritten by `properties`, so callers
+ * can contribute base props incrementally (e.g. agent first, then auth context).
+ */
+export declare function setGlobalTelemetryProperties(properties: TelemetryProperties): void;
+export declare function getGlobalTelemetryProperties(): TelemetryProperties | undefined;

package/dist/telemetry/index.js

@@ -159,6 +159,42 @@ function redactProperties(properties) {
   }
   return out;
 }
+// src/singleton.ts
+var PREFIX = "@uipath/common/";
+var _g = globalThis;
+function singleton(ctorOrName) {
+  const name = typeof ctorOrName === "string" ? ctorOrName : ctorOrName.name;
+  const key = Symbol.for(PREFIX + name);
+  return {
+    get(fallback) {
+      return _g[key] ?? fallback;
+    },
+    set(value) {
+      _g[key] = value;
+    },
+    clear() {
+      delete _g[key];
+    },
+    getOrInit(factory, guard) {
+      const existing = _g[key];
+      if (existing != null && typeof existing === "object") {
+        if (!guard || guard(existing)) {
+          return existing;
+        }
+      }
+      const instance = factory();
+      _g[key] = instance;
+      return instance;
+    }
+  };
+}
+
+// src/telemetry/global-telemetry-properties.ts
+var telemetryPropsSlot = singleton("TelemetryDefaultProps");
+function getGlobalTelemetryProperties() {
+  return telemetryPropsSlot.get();
+}
+
 // src/telemetry/telemetry-service.ts
 class TelemetryService {
   telemetryProvider;
@@ -176,7 +212,7 @@ class TelemetryService {
     this.telemetryProvider = provider;
   }
   setDefaultProperties(properties) {
-    this.defaultProperties = properties;
+    this.defaultProperties = properties === undefined ? undefined : { ...this.defaultProperties, ...properties };
   }
   trackEvent(name, properties) {
     const context = this.getCurrentContext();
@@ -238,6 +274,7 @@ class TelemetryService {
   }
   enrichPropertiesWithContext(properties, context) {
     return {
+      ...getGlobalTelemetryProperties(),
       ...this.defaultProperties,
       ...properties,
       ...context

package/dist/telemetry/node-appinsights-telemetry-provider.d.ts

@@ -1,7 +1,6 @@
 import type { ITelemetryProvider } from "./telemetry-provider.js";
 import type { TelemetryProperties } from "./telemetry-service.js";
-export declare function setGlobalTelemetryProperties(properties: TelemetryProperties): void;
-export declare function getGlobalTelemetryProperties(): TelemetryProperties | undefined;
+export { getGlobalTelemetryProperties, setGlobalTelemetryProperties, } from "./global-telemetry-properties.js";
 /**
  * Node.js Application Insights telemetry provider.
  * Uses the `applicationinsights` Node SDK (not the browser SDK).

package/dist/telemetry/telemetry-service.d.ts

@@ -147,7 +147,15 @@ export declare class TelemetryService implements ITelemetryService {
      */
     private getCurrentContext;
     /**
-     * Enriches properties with context information (operationId, parentId, id)
+     * Enriches properties with the shared base properties, this service's
+     * default properties, and context information (operationId, parentId, id).
+     *
+     * The global base properties (app version, detected agent, authenticated
+     * user/tenant/org) are merged here — at the service level — rather than
+     * inside a specific provider, so EVERY event carries them regardless of
+     * which provider is active (AppInsights, logger fallback, or a tool
+     * bundle's early local instance). Precedence, lowest to highest: global
+     * base props → per-service defaults → per-call props → correlation context.
      */
     private enrichPropertiesWithContext;
     /**

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@uipath/common",
   "license": "MIT",
-  "version": "1.195.0",
+  "version": "1.196.0",
   "description": "Common infrastructure needed by uip tools.",
   "repository": {
     "type": "git",
@@ -28,6 +28,10 @@
       "types": "./dist/sdk-user-agent.d.ts",
       "default": "./dist/sdk-user-agent.js"
     },
+    "./package-metadata-options": {
+      "types": "./dist/package-metadata-options.d.ts",
+      "default": "./dist/package-metadata-options.js"
+    },
     "./telemetry": {
       "types": "./dist/telemetry/index.d.ts",
       "default": "./dist/telemetry/index.js"
@@ -41,5 +45,5 @@
     "mihaigirleanu",
     "vlad-uipath"
   ],
-  "gitHead": "65fabb84552758b2710d8ca68470e70a9b1d19bc"
+  "gitHead": "94d71f9c52214980a1f0ae62b3f5372095788553"
 }