@uipath/uipath-typescript 1.3.0 → 1.3.2

package/dist/conversational-agent/index.d.ts

@@ -230,6 +230,8 @@ declare class BaseService {
      *
      * @param instance - UiPath SDK instance providing authentication and configuration.
      *                    Services receive this via dependency injection in the modular pattern.
+     * @param headers - Optional default headers to include in every request (e.g. `x-uipath-external-user-id` for
+     *                  CAS external-app auth)
      *
      * @example
      * ```typescript
@@ -249,7 +251,7 @@ declare class BaseService {
      * const entities = new Entities(sdk);
      * ```
      */
-    constructor(instance: IUiPath);
+    constructor(instance: IUiPath, headers?: Record<string, string>);
     /**
      * Gets a valid authentication token, refreshing if necessary.
      * Use this when you need to manually add Authorization headers (e.g., direct uploads).
@@ -4634,7 +4636,11 @@ interface ConversationalAgentServiceModel {
  * Options for ConversationalAgentService constructor
  */
 interface ConversationalAgentOptions {
-    /** External User ID (optional) */
+    /**
+     * External user ID required when authenticating via an app-scoped external app
+     * (client credential grant). Must be set when the access token was issued for an
+     * external app client; omit for standard UiPath user tokens.
+     */
     externalUserId?: string;
     /** Log level for debugging */
     logLevel?: LogLevel;
@@ -6093,8 +6099,9 @@ declare class ConversationService extends BaseService implements ConversationSer
      * Creates an instance of the Conversations service.
      *
      * @param instance - UiPath SDK instance providing authentication and configuration
+     * @param options - Optional configuration (e.g. externalUserId for external app auth)
      */
-    constructor(instance: IUiPath$1);
+    constructor(instance: IUiPath$1, options?: ConversationalAgentOptions);
     /**
      * Creates a new conversation
      *
@@ -6338,6 +6345,13 @@ declare class ConversationService extends BaseService implements ConversationSer
  * ```
  */
 declare class ExchangeService extends BaseService implements ExchangeServiceModel {
+    /**
+     * Creates an instance of the ExchangeService.
+     *
+     * @param instance - UiPath SDK instance providing authentication and configuration
+     * @param options - Optional configuration (e.g. externalUserId for external app auth)
+     */
+    constructor(instance: IUiPath$1, options?: ConversationalAgentOptions);
     /**
      * Gets all exchanges for a conversation with optional filtering and pagination
      *
@@ -6452,6 +6466,13 @@ declare class ExchangeService extends BaseService implements ExchangeServiceMode
  * ```
  */
 declare class MessageService extends BaseService implements MessageServiceModel {
+    /**
+     * Creates an instance of the MessageService.
+     *
+     * @param instance - UiPath SDK instance providing authentication and configuration
+     * @param options - Optional configuration (e.g. externalUserId for external app auth)
+     */
+    constructor(instance: IUiPath$1, options?: ConversationalAgentOptions);
     /**
      * Gets a message by ID
      *
@@ -6513,8 +6534,9 @@ declare class ConversationalAgentService extends BaseService implements Conversa
      * Creates an instance of the ConversationalAgent service.
      *
      * @param instance - UiPath SDK instance providing authentication and configuration
+     * @param options - Optional configuration (e.g. externalUserId for external app auth)
      */
-    constructor(instance: IUiPath$1);
+    constructor(instance: IUiPath$1, options?: ConversationalAgentOptions);
     /**
      * Registers a handler that is called whenever the WebSocket connection status changes.
      *

package/dist/conversational-agent/index.mjs

@@ -49,7 +49,7 @@ typeof SuppressedError === "function" ? SuppressedError : function (error, suppr
 // Connection string placeholder that will be replaced during build
 const CONNECTION_STRING = "InstrumentationKey=a6efa11d-1feb-4508-9738-e13e12dcae5e;IngestionEndpoint=https://westeurope-5.in.applicationinsights.azure.com/;LiveEndpoint=https://westeurope.livediagnostics.monitor.azure.com/;ApplicationId=7c58eb1c-9581-4ba6-839e-11725848a037";
 // SDK Version placeholder 
-const SDK_VERSION = "1.3.0";
+const SDK_VERSION = "1.3.2";
 const VERSION = "Version";
 const SERVICE = "Service";
 const CLOUD_ORGANIZATION_NAME = "CloudOrganizationName";
@@ -796,26 +796,27 @@ const RESPONSE_TYPES = {
     BLOB: 'blob',
     ARRAYBUFFER: 'arraybuffer'
 };
+/**
+ * Header key for external user ID (used in both HTTP and WebSocket for external app auth
+ * in Conversational Agents Service)
+ */
+const EXTERNAL_USER_ID = 'x-uipath-external-user-id';
 /**
  * Query parameter keys sent during WebSocket connection
  */
 const WEBSOCKET_QUERY_PARAMS = {
     ORGANIZATION_ID: 'x-uipath-internal-accountid',
     TENANT_ID: 'x-uipath-internal-tenantid',
-    EXTERNAL_USER_ID: 'x-uipath-external-user-id'
+    EXTERNAL_USER_ID,
 };
 
 class ApiClient {
     constructor(config, executionContext, tokenManager, clientConfig = {}) {
-        this.defaultHeaders = {};
         this.config = config;
         this.executionContext = executionContext;
         this.clientConfig = clientConfig;
         this.tokenManager = tokenManager;
     }
-    setDefaultHeaders(headers) {
-        this.defaultHeaders = { ...this.defaultHeaders, ...headers };
-    }
     /**
      * Gets a valid authentication token, refreshing if necessary.
      * Used internally for API requests and exposed for services that need manual auth headers.
@@ -831,7 +832,6 @@ class ApiClient {
         return {
             'Authorization': `Bearer ${token}`,
             'Content-Type': CONTENT_TYPES.JSON,
-            ...this.defaultHeaders,
             ...this.clientConfig.headers
         };
     }
@@ -1695,6 +1695,8 @@ class BaseService {
      *
      * @param instance - UiPath SDK instance providing authentication and configuration.
      *                    Services receive this via dependency injection in the modular pattern.
+     * @param headers - Optional default headers to include in every request (e.g. `x-uipath-external-user-id` for
+     *                  CAS external-app auth)
      *
      * @example
      * ```typescript
@@ -1714,11 +1716,11 @@ class BaseService {
      * const entities = new Entities(sdk);
      * ```
      */
-    constructor(instance) {
+    constructor(instance, headers) {
         // Private field - not visible via Object.keys() or any reflection
         _BaseService_apiClient.set(this, void 0);
         const { config, context, tokenManager } = SDKInternalsRegistry.get(instance);
-        __classPrivateFieldSet(this, _BaseService_apiClient, new ApiClient(config, context, tokenManager), "f");
+        __classPrivateFieldSet(this, _BaseService_apiClient, new ApiClient(config, context, tokenManager, headers ? { headers } : {}), "f");
     }
     /**
      * Gets a valid authentication token, refreshing if necessary.
@@ -5009,6 +5011,15 @@ function transformMessage(message) {
  * ```
  */
 class ExchangeService extends BaseService {
+    /**
+     * Creates an instance of the ExchangeService.
+     *
+     * @param instance - UiPath SDK instance providing authentication and configuration
+     * @param options - Optional configuration (e.g. externalUserId for external app auth)
+     */
+    constructor(instance, options) {
+        super(instance, options?.externalUserId ? { [EXTERNAL_USER_ID]: options.externalUserId } : undefined);
+    }
     /**
      * Gets all exchanges for a conversation with optional filtering and pagination
      *
@@ -5981,13 +5992,14 @@ class ConversationService extends BaseService {
      * Creates an instance of the Conversations service.
      *
      * @param instance - UiPath SDK instance providing authentication and configuration
+     * @param options - Optional configuration (e.g. externalUserId for external app auth)
      */
-    constructor(instance) {
-        super(instance);
+    constructor(instance, options) {
+        super(instance, options?.externalUserId ? { [EXTERNAL_USER_ID]: options.externalUserId } : undefined);
         /** Event helper for conversation events */
         this._eventHelper = null;
-        this._sessionManager = new SessionManager(instance);
-        this._exchangeService = new ExchangeService(instance);
+        this._sessionManager = new SessionManager(instance, options);
+        this._exchangeService = new ExchangeService(instance, options);
     }
     // ==================== Conversation CRUD Operations ====================
     /**
@@ -6369,6 +6381,15 @@ __decorate([
  * ```
  */
 class MessageService extends BaseService {
+    /**
+     * Creates an instance of the MessageService.
+     *
+     * @param instance - UiPath SDK instance providing authentication and configuration
+     * @param options - Optional configuration (e.g. externalUserId for external app auth)
+     */
+    constructor(instance, options) {
+        super(instance, options?.externalUserId ? { [EXTERNAL_USER_ID]: options.externalUserId } : undefined);
+    }
     /**
      * Gets a message by ID
      *
@@ -6439,11 +6460,12 @@ class ConversationalAgentService extends BaseService {
      * Creates an instance of the ConversationalAgent service.
      *
      * @param instance - UiPath SDK instance providing authentication and configuration
+     * @param options - Optional configuration (e.g. externalUserId for external app auth)
      */
-    constructor(instance) {
-        super(instance);
+    constructor(instance, options) {
+        super(instance, options?.externalUserId ? { [EXTERNAL_USER_ID]: options.externalUserId } : undefined);
         // Create conversation service with WebSocket support
-        this.conversations = new ConversationService(instance);
+        this.conversations = new ConversationService(instance, options);
     }
     /**
      * Registers a handler that is called whenever the WebSocket connection status changes.

package/dist/core/index.cjs

@@ -4851,6 +4851,7 @@ class TokenManager {
     }
 }
 
+const GUID_REGEX = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
 class AuthService {
     constructor(config, executionContext) {
         // Only use stored OAuth context when completing an active callback (URL has ?code=).
@@ -5134,6 +5135,8 @@ class AuthService {
      */
     getAuthorizationUrl(params) {
         const orgName = this.config.orgName;
+        const isGuid = GUID_REGEX.test(orgName);
+        const acrValues = isGuid ? `tenant:${orgName}` : `tenantName:${orgName}`;
         const queryParams = new URLSearchParams({
             response_type: 'code',
             client_id: params.clientId,
@@ -5143,13 +5146,12 @@ class AuthService {
             scope: params.scope + ' offline_access',
             state: params.state || this.generateCodeVerifier().slice(0, 16)
         });
-        return `${this.config.baseUrl}/${orgName}/${IDENTITY_ENDPOINTS.AUTHORIZE}?${queryParams.toString()}`;
+        return `${this.config.baseUrl}/${IDENTITY_ENDPOINTS.AUTHORIZE}?${queryParams.toString()}&acr_values=${acrValues}`;
     }
     /**
      * Exchanges the authorization code for an access token and automatically updates the current token
      */
     async _getAccessToken(params) {
-        const orgName = this.config.orgName;
         const body = new URLSearchParams({
             grant_type: 'authorization_code',
             client_id: params.clientId,
@@ -5157,7 +5159,7 @@ class AuthService {
             redirect_uri: params.redirectUri,
             code_verifier: params.codeVerifier
         });
-        const response = await fetch(`${this.config.baseUrl}/${orgName}/${IDENTITY_ENDPOINTS.TOKEN}`, {
+        const response = await fetch(`${this.config.baseUrl}/${IDENTITY_ENDPOINTS.TOKEN}`, {
             method: 'POST',
             headers: {
                 'Content-Type': 'application/x-www-form-urlencoded'
@@ -5278,7 +5280,7 @@ function normalizeBaseUrl(url) {
 // Connection string placeholder that will be replaced during build
 const CONNECTION_STRING = "InstrumentationKey=a6efa11d-1feb-4508-9738-e13e12dcae5e;IngestionEndpoint=https://westeurope-5.in.applicationinsights.azure.com/;LiveEndpoint=https://westeurope.livediagnostics.monitor.azure.com/;ApplicationId=7c58eb1c-9581-4ba6-839e-11725848a037";
 // SDK Version placeholder 
-const SDK_VERSION = "1.3.0";
+const SDK_VERSION = "1.3.2";
 const VERSION = "Version";
 const SERVICE = "Service";
 const CLOUD_ORGANIZATION_NAME = "CloudOrganizationName";
@@ -5667,7 +5669,7 @@ var _UiPath_instances, _UiPath_config, _UiPath_authService, _UiPath_initialized,
  *
  * Supports two usage patterns:
  * 1. Full config in constructor — for server-side or explicit configuration
- * 2. No config / partial config — loads from meta tags injected by @uipath/coded-apps plugin
+ * 2. No config / partial config — loads from meta tags injected by @uipath/coded-apps-dev plugin
  *
  * @example
  * ```typescript

package/dist/core/index.d.ts

@@ -91,7 +91,7 @@ interface IUiPath {
  *
  * Supports two usage patterns:
  * 1. Full config in constructor — for server-side or explicit configuration
- * 2. No config / partial config — loads from meta tags injected by @uipath/coded-apps plugin
+ * 2. No config / partial config — loads from meta tags injected by @uipath/coded-apps-dev plugin
  *
  * @example
  * ```typescript
@@ -519,7 +519,7 @@ declare const telemetryClient: TelemetryClient;
  * SDK Telemetry constants
  */
 declare const CONNECTION_STRING = "InstrumentationKey=a6efa11d-1feb-4508-9738-e13e12dcae5e;IngestionEndpoint=https://westeurope-5.in.applicationinsights.azure.com/;LiveEndpoint=https://westeurope.livediagnostics.monitor.azure.com/;ApplicationId=7c58eb1c-9581-4ba6-839e-11725848a037";
-declare const SDK_VERSION = "1.3.0";
+declare const SDK_VERSION = "1.3.2";
 declare const VERSION = "Version";
 declare const SERVICE = "Service";
 declare const CLOUD_ORGANIZATION_NAME = "CloudOrganizationName";

package/dist/core/index.mjs

@@ -4849,6 +4849,7 @@ class TokenManager {
     }
 }
 
+const GUID_REGEX = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
 class AuthService {
     constructor(config, executionContext) {
         // Only use stored OAuth context when completing an active callback (URL has ?code=).
@@ -5132,6 +5133,8 @@ class AuthService {
      */
     getAuthorizationUrl(params) {
         const orgName = this.config.orgName;
+        const isGuid = GUID_REGEX.test(orgName);
+        const acrValues = isGuid ? `tenant:${orgName}` : `tenantName:${orgName}`;
         const queryParams = new URLSearchParams({
             response_type: 'code',
             client_id: params.clientId,
@@ -5141,13 +5144,12 @@ class AuthService {
             scope: params.scope + ' offline_access',
             state: params.state || this.generateCodeVerifier().slice(0, 16)
         });
-        return `${this.config.baseUrl}/${orgName}/${IDENTITY_ENDPOINTS.AUTHORIZE}?${queryParams.toString()}`;
+        return `${this.config.baseUrl}/${IDENTITY_ENDPOINTS.AUTHORIZE}?${queryParams.toString()}&acr_values=${acrValues}`;
     }
     /**
      * Exchanges the authorization code for an access token and automatically updates the current token
      */
     async _getAccessToken(params) {
-        const orgName = this.config.orgName;
         const body = new URLSearchParams({
             grant_type: 'authorization_code',
             client_id: params.clientId,
@@ -5155,7 +5157,7 @@ class AuthService {
             redirect_uri: params.redirectUri,
             code_verifier: params.codeVerifier
         });
-        const response = await fetch(`${this.config.baseUrl}/${orgName}/${IDENTITY_ENDPOINTS.TOKEN}`, {
+        const response = await fetch(`${this.config.baseUrl}/${IDENTITY_ENDPOINTS.TOKEN}`, {
             method: 'POST',
             headers: {
                 'Content-Type': 'application/x-www-form-urlencoded'
@@ -5276,7 +5278,7 @@ function normalizeBaseUrl(url) {
 // Connection string placeholder that will be replaced during build
 const CONNECTION_STRING = "InstrumentationKey=a6efa11d-1feb-4508-9738-e13e12dcae5e;IngestionEndpoint=https://westeurope-5.in.applicationinsights.azure.com/;LiveEndpoint=https://westeurope.livediagnostics.monitor.azure.com/;ApplicationId=7c58eb1c-9581-4ba6-839e-11725848a037";
 // SDK Version placeholder 
-const SDK_VERSION = "1.3.0";
+const SDK_VERSION = "1.3.2";
 const VERSION = "Version";
 const SERVICE = "Service";
 const CLOUD_ORGANIZATION_NAME = "CloudOrganizationName";
@@ -5665,7 +5667,7 @@ var _UiPath_instances, _UiPath_config, _UiPath_authService, _UiPath_initialized,
  *
  * Supports two usage patterns:
  * 1. Full config in constructor — for server-side or explicit configuration
- * 2. No config / partial config — loads from meta tags injected by @uipath/coded-apps plugin
+ * 2. No config / partial config — loads from meta tags injected by @uipath/coded-apps-dev plugin
  *
  * @example
  * ```typescript