@microsoft/agents-hosting 1.1.0-alpha.9.g154c2c8a32 → 1.1.4-g8d884129e7

package/dist/src/index.d.ts

@@ -16,7 +16,6 @@ export * from './activityHandler';
 export * from './baseAdapter';
 export * from './cloudAdapter';
 export * from './middlewareSet';
-export * from './claimsIdentity';
 export * from './messageFactory';
 export * from './statusCodes';
 export * from './turnContext';

package/dist/src/index.js

@@ -34,7 +34,6 @@ __exportStar(require("./activityHandler"), exports);
 __exportStar(require("./baseAdapter"), exports);
 __exportStar(require("./cloudAdapter"), exports);
 __exportStar(require("./middlewareSet"), exports);
-__exportStar(require("./claimsIdentity"), exports);
 __exportStar(require("./messageFactory"), exports);
 __exportStar(require("./statusCodes"), exports);
 __exportStar(require("./turnContext"), exports);

package/dist/src/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;;;;;;;;;;;;;;;AAEH,0CAAuB;AACvB,wDAAoD;AAA3C,8GAAA,YAAY,OAAA;AAErB,wCAAqB;AACrB,0CAAuB;AACvB,qDAAkC;AAClC,2CAAwB;AACxB,0CAAuB;AACvB,0CAAuB;AACvB,4CAAyB;AACzB,+CAA4B;AAE5B,oDAAiC;AACjC,gDAA6B;AAC7B,iDAA8B;AAC9B,kDAA+B;AAC/B,mDAAgC;AAChC,mDAAgC;AAChC,gDAA6B;AAC7B,gDAA6B;AAC7B,+DAA4C;AAC5C,oDAAiC;AACjC,sDAAmC;AAEnC,iDAA8B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;;;;;;;;;;;;;;;AAEH,0CAAuB;AACvB,wDAAoD;AAA3C,8GAAA,YAAY,OAAA;AAErB,wCAAqB;AACrB,0CAAuB;AACvB,qDAAkC;AAClC,2CAAwB;AACxB,0CAAuB;AACvB,0CAAuB;AACvB,4CAAyB;AACzB,+CAA4B;AAE5B,oDAAiC;AACjC,gDAA6B;AAC7B,iDAA8B;AAC9B,kDAA+B;AAC/B,mDAAgC;AAChC,gDAA6B;AAC7B,gDAA6B;AAC7B,+DAA4C;AAC5C,oDAAiC;AACjC,sDAAmC;AAEnC,iDAA8B"}

package/dist/src/oauth/customUserTokenAPI.d.ts

@@ -0,0 +1 @@
+export declare const getTokenServiceEndpoint: () => string;

package/dist/src/oauth/customUserTokenAPI.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getTokenServiceEndpoint = void 0;
+// Copyright (c) Microsoft Corporation. All rights reserved.
+// Licensed under the MIT License.
+const getTokenServiceEndpoint = () => {
+    var _a;
+    return (_a = process.env.TOKEN_SERVICE_ENDPOINT) !== null && _a !== void 0 ? _a : 'https://api.botframework.com';
+};
+exports.getTokenServiceEndpoint = getTokenServiceEndpoint;
+//# sourceMappingURL=customUserTokenAPI.js.map

package/dist/src/oauth/customUserTokenAPI.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"customUserTokenAPI.js","sourceRoot":"","sources":["../../../src/oauth/customUserTokenAPI.ts"],"names":[],"mappings":";;;AAAA,4DAA4D;AAC5D,kCAAkC;AAC3B,MAAM,uBAAuB,GAAG,GAAW,EAAE;;IAClD,OAAO,MAAA,OAAO,CAAC,GAAG,CAAC,sBAAsB,mCAAI,8BAA8B,CAAA;AAC7E,CAAC,CAAA;AAFY,QAAA,uBAAuB,2BAEnC"}

package/dist/src/oauth/index.d.ts

@@ -1,3 +1,2 @@
 export * from './userTokenClient';
-export * from './oAuthFlow';
 export * from './userTokenClient.types';

package/dist/src/oauth/index.js

@@ -15,6 +15,5 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./userTokenClient"), exports);
-__exportStar(require("./oAuthFlow"), exports);
 __exportStar(require("./userTokenClient.types"), exports);
 //# sourceMappingURL=index.js.map

package/dist/src/oauth/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/oauth/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,oDAAiC;AACjC,8CAA2B;AAC3B,0DAAuC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/oauth/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,oDAAiC;AACjC,0DAAuC"}

package/dist/src/oauth/userTokenClient.d.ts

@@ -1,34 +1,51 @@
 import { AxiosInstance } from 'axios';
 import { ConversationReference } from '@microsoft/agents-activity';
 import { AadResourceUrls, SignInResource, TokenExchangeRequest, TokenOrSinginResourceResponse, TokenResponse, TokenStatus } from './userTokenClient.types';
+import { AuthProvider } from '../auth';
+import { HeaderPropagationCollection } from '../headerPropagation';
 /**
  * Client for managing user tokens.
  */
 export declare class UserTokenClient {
-    private msAppId;
     client: AxiosInstance;
+    private msAppId;
     /**
      * Creates a new instance of UserTokenClient.
      * @param msAppId The Microsoft application ID.
      */
     constructor(msAppId: string);
+    /**
+     * Creates a new instance of UserTokenClient.
+     * @param axiosInstance The axios instance.
+     */
+    constructor(axiosInstance: AxiosInstance);
+    /**
+     * Creates a new instance of UserTokenClient with authentication.
+     * @param baseURL - The base URL for the API.
+     * @param authConfig - The authentication configuration.
+     * @param authProvider - The authentication provider.
+     * @param scope - The scope for the authentication token.
+     * @param headers - Optional headers to propagate in the request.
+     * @returns A new instance of ConnectorClient.
+     */
+    static createClientWithScope(baseURL: string, authProvider: AuthProvider, scope: string, headers?: HeaderPropagationCollection): Promise<UserTokenClient>;
     /**
      * Gets the user token.
      * @param connectionName The connection name.
-     * @param channelId The channel ID.
+     * @param channelIdComposite The channel ID.
      * @param userId The user ID.
      * @param code The optional code.
      * @returns A promise that resolves to the user token.
      */
-    getUserToken(connectionName: string, channelId: string, userId: string, code?: string): Promise<TokenResponse>;
+    getUserToken(connectionName: string, channelIdComposite: string, userId: string, code?: string): Promise<TokenResponse>;
     /**
      * Signs the user out.
      * @param userId The user ID.
      * @param connectionName The connection name.
-     * @param channelId The channel ID.
+     * @param channelIdComposite The channel ID.
      * @returns A promise that resolves when the sign-out operation is complete.
      */
-    signOut(userId: string, connectionName: string, channelId: string): Promise<void>;
+    signOut(userId: string, connectionName: string, channelIdComposite: string): Promise<void>;
     /**
      * Gets the sign-in resource.
      * @param msAppId The application ID.
@@ -42,16 +59,16 @@ export declare class UserTokenClient {
      * Exchanges the token.
      * @param userId The user ID.
      * @param connectionName The connection name.
-     * @param channelId The channel ID.
+     * @param channelIdComposite The channel ID.
      * @param tokenExchangeRequest The token exchange request.
      * @returns A promise that resolves to the exchanged token.
      */
-    exchangeTokenAsync(userId: string, connectionName: string, channelId: string, tokenExchangeRequest: TokenExchangeRequest): Promise<TokenResponse>;
+    exchangeTokenAsync(userId: string, connectionName: string, channelIdComposite: string, tokenExchangeRequest: TokenExchangeRequest): Promise<TokenResponse>;
     /**
      * Gets the token or sign-in resource.
      * @param userId The user ID.
      * @param connectionName The connection name.
-     * @param channelId The channel ID.
+     * @param channelIdComposite The channel ID.
      * @param conversation The conversation reference.
      * @param relatesTo The related conversation reference.
      * @param code The code.
@@ -59,23 +76,23 @@ export declare class UserTokenClient {
      * @param fwdUrl The forward URL.
      * @returns A promise that resolves to the token or sign-in resource response.
      */
-    getTokenOrSignInResource(userId: string, connectionName: string, channelId: string, conversation: ConversationReference, relatesTo: ConversationReference, code: string, finalRedirect?: string, fwdUrl?: string): Promise<TokenOrSinginResourceResponse>;
+    getTokenOrSignInResource(userId: string, connectionName: string, channelIdComposite: string, conversation: ConversationReference, relatesTo: ConversationReference, code: string, finalRedirect?: string, fwdUrl?: string): Promise<TokenOrSinginResourceResponse>;
     /**
      * Gets the token status.
      * @param userId The user ID.
-     * @param channelId The channel ID.
+     * @param channelIdComposite The channel ID.
      * @param include The optional include parameter.
      * @returns A promise that resolves to the token status.
      */
-    getTokenStatus(userId: string, channelId: string, include?: string): Promise<TokenStatus[]>;
+    getTokenStatus(userId: string, channelIdComposite: string, include?: string): Promise<TokenStatus[]>;
     /**
      * Gets the AAD tokens.
      * @param userId The user ID.
      * @param connectionName The connection name.
-     * @param channelId The channel ID.
+     * @param channelIdComposite The channel ID.
      * @param resourceUrls The resource URLs.
      * @returns A promise that resolves to the AAD tokens.
      */
-    getAadTokens(userId: string, connectionName: string, channelId: string, resourceUrls: AadResourceUrls): Promise<Record<string, TokenResponse>>;
+    getAadTokens(userId: string, connectionName: string, channelIdComposite: string, resourceUrls: AadResourceUrls): Promise<Record<string, TokenResponse>>;
     updateAuthToken(token: string): void;
 }

package/dist/src/oauth/userTokenClient.js

@@ -7,28 +7,31 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.UserTokenClient = void 0;
 const axios_1 = __importDefault(require("axios"));
+const agents_activity_1 = require("@microsoft/agents-activity");
 const logger_1 = require("@microsoft/agents-activity/logger");
 const activityWireCompat_1 = require("../activityWireCompat");
 const getProductInfo_1 = require("../getProductInfo");
+const customUserTokenAPI_1 = require("./customUserTokenAPI");
 const logger = (0, logger_1.debug)('agents:user-token-client');
 /**
  * Client for managing user tokens.
  */
 class UserTokenClient {
-    /**
-     * Creates a new instance of UserTokenClient.
-     * @param msAppId The Microsoft application ID.
-     */
-    constructor(msAppId) {
-        this.msAppId = msAppId;
-        const baseURL = 'https://api.botframework.com';
-        this.client = axios_1.default.create({
-            baseURL,
-            headers: {
-                Accept: 'application/json',
-                'User-Agent': (0, getProductInfo_1.getProductInfo)(),
-            }
-        });
+    constructor(param) {
+        this.msAppId = '';
+        if (typeof param === 'string') {
+            const baseURL = (0, customUserTokenAPI_1.getTokenServiceEndpoint)();
+            this.client = axios_1.default.create({
+                baseURL,
+                headers: {
+                    Accept: 'application/json',
+                    'User-Agent': (0, getProductInfo_1.getProductInfo)(),
+                }
+            });
+        }
+        else {
+            this.client = param;
+        }
         this.client.interceptors.request.use((config) => {
             const { method, url, data, headers, params } = config;
             const { Authorization, authorization, ...headersToLog } = headers || {};
@@ -75,15 +78,43 @@ class UserTokenClient {
             }
         });
     }
+    /**
+     * Creates a new instance of UserTokenClient with authentication.
+     * @param baseURL - The base URL for the API.
+     * @param authConfig - The authentication configuration.
+     * @param authProvider - The authentication provider.
+     * @param scope - The scope for the authentication token.
+     * @param headers - Optional headers to propagate in the request.
+     * @returns A new instance of ConnectorClient.
+     */
+    static async createClientWithScope(baseURL, authProvider, scope, headers) {
+        // TODO: add header propagation logic
+        const axiosInstance = axios_1.default.create({
+            baseURL,
+            headers: {
+                Accept: 'application/json',
+                'Content-Type': 'application/json', // Required by transformRequest
+                'User-Agent': (0, getProductInfo_1.getProductInfo)(),
+            },
+        });
+        if (authProvider) {
+            const token = await authProvider.getAccessToken(scope);
+            if (token.length > 1) {
+                axiosInstance.defaults.headers.common.Authorization = `Bearer ${token}`;
+            }
+        }
+        return new UserTokenClient(axiosInstance);
+    }
     /**
      * Gets the user token.
      * @param connectionName The connection name.
-     * @param channelId The channel ID.
+     * @param channelIdComposite The channel ID.
      * @param userId The user ID.
      * @param code The optional code.
      * @returns A promise that resolves to the user token.
      */
-    async getUserToken(connectionName, channelId, userId, code) {
+    async getUserToken(connectionName, channelIdComposite, userId, code) {
+        const [channelId] = agents_activity_1.Activity.parseChannelId(channelIdComposite);
         const params = { connectionName, channelId, userId, code };
         const response = await this.client.get('/api/usertoken/GetToken', { params });
         if (response === null || response === void 0 ? void 0 : response.data) {
@@ -95,10 +126,11 @@ class UserTokenClient {
      * Signs the user out.
      * @param userId The user ID.
      * @param connectionName The connection name.
-     * @param channelId The channel ID.
+     * @param channelIdComposite The channel ID.
      * @returns A promise that resolves when the sign-out operation is complete.
      */
-    async signOut(userId, connectionName, channelId) {
+    async signOut(userId, connectionName, channelIdComposite) {
+        const [channelId] = agents_activity_1.Activity.parseChannelId(channelIdComposite);
         const params = { userId, connectionName, channelId };
         const response = await this.client.delete('/api/usertoken/SignOut', { params });
         if (response.status !== 200) {
@@ -130,11 +162,12 @@ class UserTokenClient {
      * Exchanges the token.
      * @param userId The user ID.
      * @param connectionName The connection name.
-     * @param channelId The channel ID.
+     * @param channelIdComposite The channel ID.
      * @param tokenExchangeRequest The token exchange request.
      * @returns A promise that resolves to the exchanged token.
      */
-    async exchangeTokenAsync(userId, connectionName, channelId, tokenExchangeRequest) {
+    async exchangeTokenAsync(userId, connectionName, channelIdComposite, tokenExchangeRequest) {
+        const [channelId] = agents_activity_1.Activity.parseChannelId(channelIdComposite);
         const params = { userId, connectionName, channelId };
         const response = await this.client.post('/api/usertoken/exchange', tokenExchangeRequest, { params });
         if (response === null || response === void 0 ? void 0 : response.data) {
@@ -148,7 +181,7 @@ class UserTokenClient {
      * Gets the token or sign-in resource.
      * @param userId The user ID.
      * @param connectionName The connection name.
-     * @param channelId The channel ID.
+     * @param channelIdComposite The channel ID.
      * @param conversation The conversation reference.
      * @param relatesTo The related conversation reference.
      * @param code The code.
@@ -156,7 +189,8 @@ class UserTokenClient {
      * @param fwdUrl The forward URL.
      * @returns A promise that resolves to the token or sign-in resource response.
      */
-    async getTokenOrSignInResource(userId, connectionName, channelId, conversation, relatesTo, code, finalRedirect = '', fwdUrl = '') {
+    async getTokenOrSignInResource(userId, connectionName, channelIdComposite, conversation, relatesTo, code, finalRedirect = '', fwdUrl = '') {
+        const [channelId] = agents_activity_1.Activity.parseChannelId(channelIdComposite);
         const state = Buffer.from(JSON.stringify({ conversation, relatesTo, connectionName, msAppId: this.msAppId })).toString('base64');
         const params = { userId, connectionName, channelId, state, code, finalRedirect, fwdUrl };
         const response = await this.client.get('/api/usertoken/GetTokenOrSignInResource', { params });
@@ -165,11 +199,12 @@ class UserTokenClient {
     /**
      * Gets the token status.
      * @param userId The user ID.
-     * @param channelId The channel ID.
+     * @param channelIdComposite The channel ID.
      * @param include The optional include parameter.
      * @returns A promise that resolves to the token status.
      */
-    async getTokenStatus(userId, channelId, include = null) {
+    async getTokenStatus(userId, channelIdComposite, include = null) {
+        const [channelId] = agents_activity_1.Activity.parseChannelId(channelIdComposite);
         const params = { userId, channelId, include };
         const response = await this.client.get('/api/usertoken/GetTokenStatus', { params });
         return response.data;
@@ -178,11 +213,12 @@ class UserTokenClient {
      * Gets the AAD tokens.
      * @param userId The user ID.
      * @param connectionName The connection name.
-     * @param channelId The channel ID.
+     * @param channelIdComposite The channel ID.
      * @param resourceUrls The resource URLs.
      * @returns A promise that resolves to the AAD tokens.
      */
-    async getAadTokens(userId, connectionName, channelId, resourceUrls) {
+    async getAadTokens(userId, connectionName, channelIdComposite, resourceUrls) {
+        const [channelId] = agents_activity_1.Activity.parseChannelId(channelIdComposite);
         const params = { userId, connectionName, channelId };
         const response = await this.client.post('/api/usertoken/GetAadTokens', resourceUrls, { params });
         return response.data;

package/dist/src/oauth/userTokenClient.js.map

@@ -1 +1 @@
-{"version":3,"file":"userTokenClient.js","sourceRoot":"","sources":["../../../src/oauth/userTokenClient.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"userTokenClient.js","sourceRoot":"","sources":["../../../src/oauth/userTokenClient.ts"],"names":[],"mappings":"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"}

package/dist/src/oauth/userTokenClient.types.d.ts

@@ -15,17 +15,30 @@ export interface TokenResponse {
  */
 export interface TokenExchangeRequest {
     /**
-       * The URI for the token exchange request.
-       */
+     * The URI for the token exchange request.
+     */
     uri?: string;
     /**
-       * The token to be exchanged.
-       */
+     * The token to be exchanged.
+     */
     token?: string;
+}
+/**
+ * Represents the response for a token exchange invoke operation.
+ */
+export interface TokenExchangeInvokeResponse {
     /**
-       * The ID associated with the token exchange request.
-       */
+     * The connection name associated with the token exchange response.
+     */
+    connectionName: string;
+    /**
+     * The ID associated with the token exchange response.
+     */
     id?: string;
+    /**
+     * (Optional) Details about any failure that occurred during the token exchange.
+     */
+    failureDetail?: string;
 }
 /**
  * Represents a resource for exchanging tokens.

package/dist/src/transcript/fileTranscriptLogger.d.ts

@@ -0,0 +1,109 @@
+/**
+ * Copyright (c) Microsoft Corporation. All rights reserved.
+ * Licensed under the MIT License.
+ */
+import { PagedResult, TranscriptInfo } from './transcriptLogger';
+import { TranscriptStore } from './transcriptStore';
+import { Activity } from '@microsoft/agents-activity';
+/**
+ * FileTranscriptLogger which creates a .transcript file for each conversationId.
+ * @remarks
+ * This is a useful class for unit tests.
+ *
+ * Concurrency Safety:
+ * - Uses an in-memory promise chain to serialize writes within the same Node.js process
+ * - Prevents race conditions and file corruption when multiple concurrent writes occur
+ * - Optimized for performance with minimal overhead (no file-based locking)
+ *
+ * Note: This implementation is designed for single-process scenarios. For multi-server
+ * deployments, consider using a database-backed transcript store.
+ */
+export declare class FileTranscriptLogger implements TranscriptStore {
+    private static readonly TRANSCRIPT_FILE_EXTENSION;
+    private static readonly MAX_FILE_NAME_SIZE;
+    private readonly _folder;
+    private readonly _fileLocks;
+    /**
+     * Initializes a new instance of the FileTranscriptLogger class.
+     * @param folder - Folder to place the transcript files (Default current directory).
+     */
+    constructor(folder?: string);
+    /**
+     * Log an activity to the transcript.
+     * @param activity - The activity to transcribe.
+     * @returns A promise that represents the work queued to execute.
+     */
+    logActivity(activity: Activity): Promise<void>;
+    /**
+     * Gets from the store activities that match a set of criteria.
+     * @param channelId - The ID of the channel the conversation is in.
+     * @param conversationId - The ID of the conversation.
+     * @param continuationToken - The continuation token (if available).
+     * @param startDate - A cutoff date. Activities older than this date are not included.
+     * @returns A promise that resolves with the matching activities.
+     */
+    getTranscriptActivities(channelId: string, conversationId: string, continuationToken?: string, startDate?: Date): Promise<PagedResult<Activity>>;
+    /**
+     * Gets the conversations on a channel from the store.
+     * @param channelId - The ID of the channel.
+     * @param continuationToken - Continuation token (if available).
+     * @returns A promise that resolves with all transcripts for the given ChannelID.
+     */
+    listTranscripts(channelId: string, continuationToken?: string): Promise<PagedResult<TranscriptInfo>>;
+    /**
+     * Deletes conversation data from the store.
+     * @param channelId - The ID of the channel the conversation is in.
+     * @param conversationId - The ID of the conversation to delete.
+     * @returns A promise that represents the work queued to execute.
+     */
+    deleteTranscript(channelId: string, conversationId: string): Promise<void>;
+    /**
+     * Loads a transcript from a file.
+     */
+    private loadTranscriptAsync;
+    /**
+     * Executes a file operation with exclusive locking per file.
+     * This ensures that concurrent writes to the same transcript file are serialized.
+     */
+    private withFileLock;
+    /**
+     * Performs the actual write operation to the transcript file.
+     */
+    private logActivityToFile;
+    /**
+     * Updates a message in the transcript.
+     */
+    private messageUpdateAsync;
+    /**
+     * Deletes a message from the transcript (tombstones it).
+     */
+    private messageDeleteAsync;
+    /**
+     * Sanitizes a string by removing invalid characters.
+     */
+    private static sanitizeString;
+    /**
+     * Gets the transcript file path for a conversation.
+     */
+    private getTranscriptFile;
+    /**
+     * Gets the channel folder path, creating it if necessary.
+     */
+    private getChannelFolder;
+    /**
+     * Checks if a file or directory exists.
+     */
+    private pathExists;
+    /**
+     * Gets invalid filename characters for the current platform.
+     */
+    private getInvalidFileNameChars;
+    /**
+     * Gets invalid path characters for the current platform.
+     */
+    private getInvalidPathChars;
+    /**
+     * Adds file:// protocol to a file path.
+     */
+    private protocol;
+}