@uipath/common 1.0.4 → 1.1.0

package/dist/option-aliases.d.ts

@@ -0,0 +1,19 @@
+import { type Command, Option } from "commander";
+export interface OptionAliasResult<T> {
+    value: T | undefined;
+    usedDeprecated: boolean;
+    error?: {
+        message: string;
+        instructions: string;
+    };
+}
+export declare function resolveDeprecatedOptionAlias<T>({ preferredValue, deprecatedValue, preferredFlag, deprecatedFlag, }: {
+    preferredValue: T | undefined;
+    deprecatedValue: T | undefined;
+    preferredFlag: string;
+    deprecatedFlag: string;
+}): OptionAliasResult<T>;
+export declare function warnDeprecatedOptionAlias(deprecatedFlag: string, preferredFlag: string): void;
+export declare function createHiddenDeprecatedTenantOption(flags?: string): Option;
+export declare function addHiddenDeprecatedTenantOption<T extends Command>(command: T, flags?: string): T;
+export declare function warnDeprecatedTenantOption(tenant?: string): void;

package/dist/sdk-user-agent.d.ts

@@ -0,0 +1,12 @@
+export interface SdkUserAgentPackageInfo {
+    name: string;
+    version: string;
+}
+export type SdkHttpHeaders = Record<string, string>;
+export declare function getSdkUserAgentToken(pkg: SdkUserAgentPackageInfo): string;
+export declare function setSdkUserAgentHostToken(token: string | undefined): void;
+export declare function addSdkUserAgentHeader(headers: SdkHttpHeaders | undefined, userAgent: string): SdkHttpHeaders;
+export declare function withSdkUserAgentHeader(headers: unknown, userAgent: string): unknown;
+export declare function installSdkUserAgentHeader(BaseApiClass: {
+    prototype: unknown;
+}, userAgent: string): void;

package/dist/sdk-user-agent.js

@@ -0,0 +1,143 @@
+// 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/sdk-user-agent.ts
+var USER_AGENT_HEADER = "User-Agent";
+var sdkUserAgentHostToken = singleton("SdkUserAgentHostToken");
+function userAgentPatchKey(userAgent) {
+  return Symbol.for(`@uipath/common/sdk-user-agent/${userAgent}`);
+}
+function splitUserAgentTokens(value) {
+  return value?.trim().split(/\s+/).filter(Boolean) ?? [];
+}
+function appendUserAgentToken(value, userAgent) {
+  const tokens = splitUserAgentTokens(value);
+  const seen = new Set(tokens);
+  for (const token of splitUserAgentTokens(userAgent)) {
+    if (!seen.has(token)) {
+      tokens.push(token);
+      seen.add(token);
+    }
+  }
+  return tokens.join(" ");
+}
+function getEffectiveUserAgent(userAgent) {
+  return appendUserAgentToken(sdkUserAgentHostToken.get(), userAgent);
+}
+function isHeadersLike(headers) {
+  return typeof headers === "object" && headers !== null && "get" in headers && typeof headers.get === "function" && "set" in headers && typeof headers.set === "function";
+}
+function getSdkUserAgentToken(pkg) {
+  const packageName = pkg.name.replace(/^@uipath\//, "");
+  return getEffectiveUserAgent(`${packageName}/${pkg.version}`);
+}
+function setSdkUserAgentHostToken(token) {
+  if (token === undefined) {
+    sdkUserAgentHostToken.clear();
+    return;
+  }
+  sdkUserAgentHostToken.set(token);
+}
+function addSdkUserAgentHeader(headers, userAgent) {
+  const result = { ...headers ?? {} };
+  const effectiveUserAgent = getEffectiveUserAgent(userAgent);
+  const headerName = Object.keys(result).find((key) => key.toLowerCase() === USER_AGENT_HEADER.toLowerCase());
+  if (headerName) {
+    result[headerName] = appendUserAgentToken(result[headerName], effectiveUserAgent);
+  } else {
+    result[USER_AGENT_HEADER] = effectiveUserAgent;
+  }
+  return result;
+}
+function withSdkUserAgentHeader(headers, userAgent) {
+  const effectiveUserAgent = getEffectiveUserAgent(userAgent);
+  if (isHeadersLike(headers)) {
+    headers.set(USER_AGENT_HEADER, appendUserAgentToken(headers.get(USER_AGENT_HEADER), effectiveUserAgent));
+    return headers;
+  }
+  if (Array.isArray(headers)) {
+    const result = headers.map((entry) => {
+      const [key, value] = entry;
+      return [key, value];
+    });
+    const headerIndex = result.findIndex(([key]) => key.toLowerCase() === USER_AGENT_HEADER.toLowerCase());
+    if (headerIndex >= 0) {
+      const [key, value] = result[headerIndex];
+      result[headerIndex] = [
+        key,
+        appendUserAgentToken(value, effectiveUserAgent)
+      ];
+    } else {
+      result.push([USER_AGENT_HEADER, effectiveUserAgent]);
+    }
+    return result;
+  }
+  return addSdkUserAgentHeader(typeof headers === "object" && headers !== null ? { ...headers } : {}, effectiveUserAgent);
+}
+function withUserAgentInitOverride(initOverrides, userAgent) {
+  return async (requestContext) => {
+    const initWithUserAgent = {
+      ...requestContext.init,
+      headers: withSdkUserAgentHeader(requestContext.init.headers, userAgent)
+    };
+    const override = typeof initOverrides === "function" ? await initOverrides({
+      ...requestContext,
+      init: initWithUserAgent
+    }) : initOverrides;
+    return {
+      ...override ?? {},
+      headers: withSdkUserAgentHeader(override?.headers ?? initWithUserAgent.headers, userAgent)
+    };
+  };
+}
+function installSdkUserAgentHeader(BaseApiClass, userAgent) {
+  const prototype = BaseApiClass.prototype;
+  const patchKey = userAgentPatchKey(userAgent);
+  if (prototype[patchKey]) {
+    return;
+  }
+  if (typeof prototype.request !== "function") {
+    throw new Error("Generated BaseAPI request function not found.");
+  }
+  const originalRequest = prototype.request;
+  prototype.request = function requestWithUserAgent(context, initOverrides) {
+    return originalRequest.call(this, context, withUserAgentInitOverride(initOverrides, userAgent));
+  };
+  Object.defineProperty(prototype, patchKey, {
+    value: true
+  });
+}
+export {
+  withSdkUserAgentHeader,
+  setSdkUserAgentHostToken,
+  installSdkUserAgentHeader,
+  getSdkUserAgentToken,
+  addSdkUserAgentHeader
+};

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@uipath/common",
-    "version": "1.0.4",
+    "version": "1.1.0",
     "description": "Common infrastructure needed by uip tools.",
     "repository": {
         "type": "git",
@@ -14,8 +14,14 @@
     "main": "./dist/index.js",
     "exports": {
         ".": {
-            "types": "./dist/index.d.ts",
-            "default": "./dist/index.js"
+            "browser": {
+                "types": "./dist/index.browser.d.ts",
+                "default": "./dist/index.browser.js"
+            },
+            "default": {
+                "types": "./dist/index.d.ts",
+                "default": "./dist/index.js"
+            }
         },
         "./telemetry": {
             "types": "./dist/telemetry/index.d.ts",
@@ -30,22 +36,15 @@
         "mihaigirleanu",
         "vlad-uipath"
     ],
-    "scripts": {
-        "build": "bun build ./src/index.ts --outdir dist --format esm --target node --external applicationinsights && bun build ./src/telemetry/index.ts --outfile dist/telemetry/index.js --format esm --target browser && tsc -p tsconfig.build.json --noCheck",
-        "typecheck": "tsc --noEmit",
-        "lint": "biome check .",
-        "test": "vitest run",
-        "test:coverage": "vitest run --coverage"
-    },
     "devDependencies": {
         "@jmespath-community/jmespath": "^1.3.0",
         "@types/js-yaml": "^4.0.9",
         "@types/node": "^25.5.2",
-        "@uipath/filesystem": "1.0.4",
+        "@uipath/filesystem": "1.1.0",
         "commander": "^14.0.3",
         "js-yaml": "^4.1.0",
         "jsonpath-plus": "^10.4.0",
         "typescript": "^6.0.2"
     },
-    "gitHead": "e496ee5b65951c8047259ab50d7d6a284eea58a9"
+    "gitHead": "06e8c8f566df4b87da4a008635483c62f64f33f0"
 }