@uipath/common 0.9.1 → 1.0.0

package/dist/option-validators.d.ts

@@ -31,3 +31,5 @@ export declare function parseBoundedInt(raw: string, optionName: string, bounds:
     min: number;
     max: number;
 }): number;
+export declare function parsePositiveInteger(raw: string): number | undefined;
+export declare function parseNonNegativeInteger(raw: string): number | undefined;

package/dist/orchestrator-urls.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Canonical Orchestrator / Action Center URL builders.
+ *
+ * Centralizes construction of `{baseUrl}/{org}/{tenant}/orchestrator_…` and
+ * `{baseUrl}/{org}/{tenant}/actions_/current-task/tasks/{taskId}` URLs so
+ * every CLI / SDK caller goes through one helper that:
+ *
+ *   1. **Requires the tenant slug** at the type level *and* validates it at
+ *      runtime (rejects `""` / whitespace). This is the contract from
+ *      [MST-9322](https://uipath.atlassian.net/browse/MST-9322): a URL like
+ *      `/popoc/orchestrator_/actions/inbox/<taskKey>` (missing the tenant)
+ *      is misclassified by the portal-UI as "Orchestrator not enabled" —
+ *      no helper in this codebase should ever be able to produce one.
+ *   2. URL-encodes the `org`, `tenant`, and `taskKey/taskId` segments
+ *      consistently — no callsite needs to remember to call
+ *      `encodeURIComponent` itself for these.
+ *   3. Normalizes a base URL with a trailing slash so the caller can pass
+ *      either form without producing `//`.
+ *
+ * The `path` argument on {@link buildOrchestratorUrl} is left as a string
+ * **without** automatic encoding so callers can include OData filter syntax
+ * and existing URL-encoded query strings; this matches the existing inline
+ * pattern used in `solution-tool/src/services/apps-binding-sync.ts`.
+ *
+ * For the Studio Web URL pattern (`/{org}/studio_/...`) — which has no
+ * tenant segment by design — see `packages/maestro-sdk` instead. That
+ * surface is structurally different and out of scope here.
+ */
+/**
+ * Build a canonical Orchestrator URL of the form
+ * `{baseUrl}/{org}/{tenant}/orchestrator_{path}`.
+ *
+ * @param baseUrl  e.g. `https://alpha.uipath.com` (with or without trailing slash)
+ * @param org      Organization name or ID — segment after the host.
+ * @param tenant   Tenant **name** (not ID). Required, non-empty.
+ *                 Empty/whitespace throws — see MST-9322.
+ * @param path     Path appended verbatim after `orchestrator_`. By convention
+ *                 starts with `/` (e.g. `/odata/Processes`); query strings
+ *                 (`?q=…`) are also accepted. Not encoded — caller controls
+ *                 path-internal encoding (e.g. OData escapes).
+ */
+export declare function buildOrchestratorUrl(baseUrl: string, org: string, tenant: string, path: string): string;
+/**
+ * Build the Action Center *inbox* deep-link URL —
+ * `{baseUrl}/{org}/{tenant}/orchestrator_/actions/inbox/{taskKey}`.
+ *
+ * This is the form that MST-9322 specifically called out as broken when
+ * the tenant slug is missing. Any code surfacing an Action Center task
+ * link should go through this helper.
+ */
+export declare function buildActionCenterInboxUrl(baseUrl: string, org: string, tenant: string, taskKey: string): string;
+/**
+ * Build the Action Center standalone task URL —
+ * `{baseUrl}/{org}/{tenant}/actions_/current-task/tasks/{taskId}`.
+ *
+ * This form (under `actions_/`, not `orchestrator_/`) is what Coded Action
+ * Apps and the Action Center portal use for direct task navigation. Same
+ * tenant-required contract as {@link buildActionCenterInboxUrl}.
+ *
+ * Orchestrator task IDs are positive integers — `0` (and the string `"0"`)
+ * are sentinel/uninitialized values, never real task IDs, and are
+ * rejected here so callers fail fast rather than producing a navigable
+ * URL that lands on the wrong task.
+ */
+export declare function buildActionCenterTaskUrl(baseUrl: string, org: string, tenant: string, taskId: string | number): string;

package/dist/output-format-context.d.ts

@@ -16,6 +16,17 @@ export declare function setOutputFormat(format: OutputFormat): void;
  * Get the current output format, defaulting to "json" if not set.
  */
 export declare function getOutputFormat(): OutputFormat;
+/**
+ * Record whether `--output` was passed explicitly. Lets command handlers
+ * distinguish "user asked for json" from "json by default" without
+ * re-scanning argv themselves.
+ */
+export declare function setOutputFormatExplicit(explicit: boolean): void;
+/**
+ * True when `--output` was passed explicitly on the command line.
+ * Defaults to false (i.e. resolved value is the default).
+ */
+export declare function getOutputFormatExplicit(): boolean;
 /**
  * Set the process-wide output filter expression.
  * Called once at CLI startup after parsing the global --output-filter option.

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@uipath/common",
-    "version": "0.9.1",
+    "version": "1.0.0",
     "description": "Common infrastructure needed by uip tools.",
     "repository": {
         "type": "git",
@@ -40,12 +40,12 @@
     "devDependencies": {
         "@jmespath-community/jmespath": "^1.3.0",
         "@types/js-yaml": "^4.0.9",
-        "@types/node": "^25.5.0",
-        "@uipath/filesystem": "0.9.1",
+        "@types/node": "^25.5.2",
+        "@uipath/filesystem": "1.0.0",
         "commander": "^14.0.3",
         "js-yaml": "^4.1.0",
         "jsonpath-plus": "^10.4.0",
-        "typescript": "^5"
+        "typescript": "^6.0.2"
     },
-    "gitHead": "e8da2857e37a9495c4907cd39f47c9d6ed1a5566"
+    "gitHead": "d982977e86057fd9d0846c955595c64865aeecab"
 }