@microsoft/teams.client 0.2.12 → 0.2.14

package/README.md

@@ -34,4 +34,4 @@ $: npm install @microsoft/teams.client
 
 ## Links
 
-- https://learn.microsoft.com/en-us/microsoftteams/platform/tabs/what-are-tabs?tabs=personal
+-   https://learn.microsoft.com/en-us/microsoftteams/platform/tabs/what-are-tabs?tabs=personal

package/dist/app.d.mts

@@ -1,7 +1,8 @@
 import * as msal from '@azure/msal-browser';
+import * as teamsJs from '@microsoft/teams-js';
 import * as http from '@microsoft/teams.common/http';
 import { ILogger } from '@microsoft/teams.common/logging';
-import * as teamsJs from '@microsoft/teams-js';
+import * as graph from '@microsoft/teams.graph';
 
 type MsalOptions = {
     /**
@@ -10,9 +11,12 @@ type MsalOptions = {
      */
     readonly configuration?: msal.Configuration;
     /**
-     * Default token request options used when acquiring a token.
+     * Options to control scope consent pre-warming. If explicitly set to false, no pre-warming is performed.
+     * If no value is provided, the default scope (i.e. ".default") is pre-warmed. If a set of scopes is
+     * provided, the specified scopes are pre-warmed. The scopes should be for a single resource, and they
+     * should not mix the .default scope with named scopes.
      */
-    readonly defaultSilentRequest?: msal.SilentRequest;
+    readonly prewarmScopes?: false | string[];
 };
 type AppOptions = {
     /**
@@ -56,6 +60,7 @@ type ExecOptions = ({
 declare class App {
     readonly options: AppOptions;
     readonly http: http.Client;
+    readonly graph: graph.Client;
     readonly clientId: string;
     protected _state: AppState;
     /**
@@ -87,6 +92,22 @@ declare class App {
      * @returns The function response
      */
     exec<T = unknown>(name: string, data?: unknown, options?: ExecOptions): Promise<T>;
+    /**
+     * Tests whether the user has consented to the specified scopes without prompting the user for consent.
+     * @param scopes The scopes to check consent for.The scopes should be for a single resource, and they
+     * should not mix the .default scope with named scopes.
+     * @returns A promise that resolves to a boolean indicating whether the user has consented to the scopes.
+     */
+    hasConsentForScopes(scopes: string[]): Promise<boolean>;
+    /**
+     * Tests whether the user has consented to the specified scopes, and prompts them if not. This is useful for ensuring
+     * that the user has consented to the required scopes before calling a graph API or other resource.
+     * @param scopes - The scopes to prewarm consent for. The scopes should be for a single resource, and they
+     * should not mix the .default scope with named scopes.
+     * @returns A value indicating whether consent has been acquired for the specified scopes.
+     */
+    ensureConsentForScopes(scopes: string[]): Promise<boolean>;
+    private appStateGuard;
 }
 
-export { App, type AppOptions, type MsalOptions };
+export { App, type AppOptions, type ExecOptions, type MsalOptions };

package/dist/app.d.ts

@@ -1,7 +1,8 @@
 import * as msal from '@azure/msal-browser';
+import * as teamsJs from '@microsoft/teams-js';
 import * as http from '@microsoft/teams.common/http';
 import { ILogger } from '@microsoft/teams.common/logging';
-import * as teamsJs from '@microsoft/teams-js';
+import * as graph from '@microsoft/teams.graph';
 
 type MsalOptions = {
     /**
@@ -10,9 +11,12 @@ type MsalOptions = {
      */
     readonly configuration?: msal.Configuration;
     /**
-     * Default token request options used when acquiring a token.
+     * Options to control scope consent pre-warming. If explicitly set to false, no pre-warming is performed.
+     * If no value is provided, the default scope (i.e. ".default") is pre-warmed. If a set of scopes is
+     * provided, the specified scopes are pre-warmed. The scopes should be for a single resource, and they
+     * should not mix the .default scope with named scopes.
      */
-    readonly defaultSilentRequest?: msal.SilentRequest;
+    readonly prewarmScopes?: false | string[];
 };
 type AppOptions = {
     /**
@@ -56,6 +60,7 @@ type ExecOptions = ({
 declare class App {
     readonly options: AppOptions;
     readonly http: http.Client;
+    readonly graph: graph.Client;
     readonly clientId: string;
     protected _state: AppState;
     /**
@@ -87,6 +92,22 @@ declare class App {
      * @returns The function response
      */
     exec<T = unknown>(name: string, data?: unknown, options?: ExecOptions): Promise<T>;
+    /**
+     * Tests whether the user has consented to the specified scopes without prompting the user for consent.
+     * @param scopes The scopes to check consent for.The scopes should be for a single resource, and they
+     * should not mix the .default scope with named scopes.
+     * @returns A promise that resolves to a boolean indicating whether the user has consented to the scopes.
+     */
+    hasConsentForScopes(scopes: string[]): Promise<boolean>;
+    /**
+     * Tests whether the user has consented to the specified scopes, and prompts them if not. This is useful for ensuring
+     * that the user has consented to the required scopes before calling a graph API or other resource.
+     * @param scopes - The scopes to prewarm consent for. The scopes should be for a single resource, and they
+     * should not mix the .default scope with named scopes.
+     * @returns A value indicating whether consent has been acquired for the specified scopes.
+     */
+    ensureConsentForScopes(scopes: string[]): Promise<boolean>;
+    private appStateGuard;
 }
 
-export { App, type AppOptions, type MsalOptions };
+export { App, type AppOptions, type ExecOptions, type MsalOptions };

package/dist/app.js

@@ -1,9 +1,10 @@
 'use strict';
 
 var msal = require('@azure/msal-browser');
+var teamsJs = require('@microsoft/teams-js');
 var http = require('@microsoft/teams.common/http');
 var logging = require('@microsoft/teams.common/logging');
-var teamsJs = require('@microsoft/teams-js');
+var graphUtils = require('./graph-utils');
 var msalUtils = require('./msal-utils');
 
 function _interopNamespace(e) {
@@ -25,12 +26,13 @@ function _interopNamespace(e) {
 }
 
 var msal__namespace = /*#__PURE__*/_interopNamespace(msal);
-var http__namespace = /*#__PURE__*/_interopNamespace(http);
 var teamsJs__namespace = /*#__PURE__*/_interopNamespace(teamsJs);
+var http__namespace = /*#__PURE__*/_interopNamespace(http);
 
 class App {
   options;
   http;
+  graph;
   clientId;
   _state = { phase: "stopped" };
   /**
@@ -58,6 +60,7 @@ class App {
     this.options = options;
     this._log = options?.logger || new logging.ConsoleLogger("@teams/client");
     this.http = new http__namespace.Client({ baseUrl: options?.baseUrl });
+    this.graph = graphUtils.buildGraphClient(() => this.appStateGuard(), this._log);
   }
   /**
    * Starts the library and initializes the dependent teams-js and MSAL libraries.
@@ -77,6 +80,11 @@ class App {
     const msalInstance = await msal__namespace.createNestablePublicClientApplication(msalConfig);
     await msalInstance.initialize();
     this._state = { phase: "started", msalInstance, context, startedAt: /* @__PURE__ */ new Date() };
+    if (this.options.msalOptions?.prewarmScopes !== false) {
+      const scopes = this.options.msalOptions?.prewarmScopes ?? [".default"];
+      this._log.debug(`prewarming consent for scopes: ${scopes.join(", ")}`);
+      await this.ensureConsentForScopes(scopes);
+    }
     this._log.debug("app started");
   }
   /**
@@ -90,12 +98,9 @@ class App {
    * @returns The function response
    */
   async exec(name, data, options) {
-    if (this._state.phase !== "started") {
-      throw new Error("App not started");
-    }
-    const { context } = this._state;
+    const { msalInstance, context } = this.appStateGuard();
     const accessToken = await msalUtils.acquireMsalAccessToken(
-      this._state.msalInstance,
+      msalInstance,
       options?.msalTokenRequest ?? msalUtils.getStandardExecSilentRequest(this.clientId, options?.permission),
       this._log
     );
@@ -115,6 +120,38 @@ class App {
     });
     return res.data;
   }
+  /**
+   * Tests whether the user has consented to the specified scopes without prompting the user for consent.
+   * @param scopes The scopes to check consent for.The scopes should be for a single resource, and they
+   * should not mix the .default scope with named scopes.
+   * @returns A promise that resolves to a boolean indicating whether the user has consented to the scopes.
+   */
+  async hasConsentForScopes(scopes) {
+    const { msalInstance } = this.appStateGuard();
+    return await msalUtils.hasConsentForScopes(msalInstance, scopes, this.log);
+  }
+  /**
+   * Tests whether the user has consented to the specified scopes, and prompts them if not. This is useful for ensuring
+   * that the user has consented to the required scopes before calling a graph API or other resource.
+   * @param scopes - The scopes to prewarm consent for. The scopes should be for a single resource, and they
+   * should not mix the .default scope with named scopes.
+   * @returns A value indicating whether consent has been acquired for the specified scopes.
+   */
+  async ensureConsentForScopes(scopes) {
+    const { msalInstance } = this.appStateGuard();
+    try {
+      const token = await msalUtils.acquireMsalAccessToken(msalInstance, { scopes }, this.log);
+      return !!token;
+    } catch (ex) {
+      return false;
+    }
+  }
+  appStateGuard() {
+    if (this._state.phase !== "started") {
+      throw new Error("App not started");
+    }
+    return this._state;
+  }
 }
 
 exports.App = App;

package/dist/app.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/app.ts"],"names":["ConsoleLogger","http","teamsJs","buildMsalConfig","msal","acquireMsalAccessToken","getStandardExecSilentRequest"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAiEO,MAAM,GAAI,CAAA;AAAA,EACN,OAAA;AAAA,EACA,IAAA;AAAA,EACA,QAAA;AAAA,EACC,MAAA,GAAmB,EAAE,KAAA,EAAO,SAAU,EAAA;AAAA;AAAA;AAAA;AAAA,EAKhD,IAAI,GAAM,GAAA;AACR,IAAA,OAAO,IAAK,CAAA,IAAA;AAAA;AACd,EACU,IAAA;AAAA;AAAA;AAAA;AAAA,EAKV,IAAI,SAAY,GAAA;AACd,IAAA,OAAO,KAAK,MAAQ,EAAA,SAAA;AAAA;AACtB;AAAA,EAGA,IAAI,YAAe,GAAA;AACjB,IAAA,OAAO,KAAK,MAAO,CAAA,YAAA;AAAA;AACrB,EAEA,WAAY,CAAA,QAAA,EAAkB,OAAsB,GAAA,EAAI,EAAA;AACtD,IAAA,IAAI,CAAC,QAAU,EAAA;AACb,MAAM,MAAA,IAAI,MAAM,oBAAoB,CAAA;AAAA;AAGtC,IAAA,IAAA,CAAK,QAAW,GAAA,QAAA;AAChB,IAAA,IAAA,CAAK,OAAU,GAAA,OAAA;AACf,IAAA,IAAA,CAAK,IAAO,GAAA,OAAA,EAAS,MAAU,IAAA,IAAIA,sBAAc,eAAe,CAAA;AAChE,IAAK,IAAA,CAAA,IAAA,GAAO,IAAIC,eAAK,CAAA,MAAA,CAAO,EAAE,OAAS,EAAA,OAAA,EAAS,SAAS,CAAA;AAAA;AAC3D;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAM,KAAuB,GAAA;AAC3B,IAAI,IAAA,IAAA,CAAK,MAAO,CAAA,KAAA,KAAU,SAAW,EAAA;AACnC,MAAA,IAAA,CAAK,KAAK,KAAM,CAAA,CAAA,YAAA,EAAe,IAAK,CAAA,MAAA,CAAO,KAAK,CAAE,CAAA,CAAA;AAClD,MAAA;AAAA;AAGF,IAAK,IAAA,CAAA,IAAA,CAAK,MAAM,cAAc,CAAA;AAC9B,IAAK,IAAA,CAAA,MAAA,GAAS,EAAE,KAAA,EAAO,UAAW,EAAA;AAElC,IAAM,MAAAC,kBAAA,CAAQ,IAAI,UAAW,EAAA;AAC7B,IAAA,MAAM,OAAU,GAAA,MAAMA,kBAAQ,CAAA,GAAA,CAAI,UAAW,EAAA;AAE7C,IAAM,MAAA,UAAA,GACJ,KAAK,OAAQ,CAAA,WAAA,EAAa,iBAAiBC,yBAAgB,CAAA,IAAA,CAAK,QAAU,EAAA,IAAA,CAAK,IAAI,CAAA;AACrF,IAAA,MAAM,YAAe,GAAA,MAAMC,eAAK,CAAA,qCAAA,CAAsC,UAAU,CAAA;AAChF,IAAA,MAAM,aAAa,UAAW,EAAA;AAE9B,IAAK,IAAA,CAAA,MAAA,GAAS,EAAE,KAAO,EAAA,SAAA,EAAW,cAAc,OAAS,EAAA,SAAA,kBAAe,IAAA,IAAA,EAAO,EAAA;AAC/E,IAAK,IAAA,CAAA,IAAA,CAAK,MAAM,aAAa,CAAA;AAAA;AAC/B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAYA,MAAM,IAAA,CAAkB,IAAc,EAAA,IAAA,EAAgB,OAAmC,EAAA;AACvF,IAAI,IAAA,IAAA,CAAK,MAAO,CAAA,KAAA,KAAU,SAAW,EAAA;AACnC,MAAM,MAAA,IAAI,MAAM,iBAAiB,CAAA;AAAA;AAGnC,IAAM,MAAA,EAAE,OAAQ,EAAA,GAAI,IAAK,CAAA,MAAA;AACzB,IAAA,MAAM,cAAc,MAAMC,gCAAA;AAAA,MACxB,KAAK,MAAO,CAAA,YAAA;AAAA,MACZ,SAAS,gBAAoB,IAAAC,sCAAA,CAA6B,IAAK,CAAA,QAAA,EAAU,SAAS,UAAU,CAAA;AAAA,MAC5F,IAAK,CAAA;AAAA,KACP;AAEA,IAAM,MAAA,GAAA,GAAM,MAAM,IAAK,CAAA,IAAA,CAAK,KAAQ,CAAkB,eAAA,EAAA,IAAI,IAAI,IAAM,EAAA;AAAA,MAClE,OAAS,EAAA;AAAA,QACP,aAAA,EAAe,UAAU,WAAW,CAAA,CAAA;AAAA,QACpC,wBAAA,EAA0B,QAAQ,GAAI,CAAA,SAAA;AAAA,QACtC,oBAAA,EAAsB,QAAQ,OAAS,EAAA,EAAA;AAAA,QACvC,iBAAA,EAAmB,QAAQ,IAAM,EAAA,EAAA;AAAA,QACjC,oBAAA,EAAsB,QAAQ,OAAS,EAAA,EAAA;AAAA,QACvC,oBAAA,EAAsB,QAAQ,GAAI,CAAA,eAAA;AAAA,QAClC,iBAAA,EAAmB,QAAQ,IAAK,CAAA,EAAA;AAAA,QAChC,qBAAA,EAAuB,QAAQ,IAAK,CAAA,SAAA;AAAA,QACpC,iBAAA,EAAmB,QAAQ,IAAM,EAAA,UAAA;AAAA,QACjC,GAAI,OAAS,EAAA,cAAA,IAAkB;AAAC;AAClC,KACD,CAAA;AAED,IAAA,OAAO,GAAI,CAAA,IAAA;AAAA;AAEf","file":"app.js","sourcesContent":["import * as msal from '@azure/msal-browser';\nimport * as http from '@microsoft/teams.common/http';\nimport { ILogger, ConsoleLogger } from '@microsoft/teams.common/logging';\nimport * as teamsJs from '@microsoft/teams-js';\n\nimport {\n  acquireMsalAccessToken,\n  buildMsalConfig,\n  getStandardExecSilentRequest,\n} from './msal-utils';\n\nexport type MsalOptions = {\n  /**\n   * Optional MSAL configuration. This parameter is used to construct an MSAL instance in order\n   * to make authenticated function calls. If omitted, a default configuration is created.\n   */\n  readonly configuration?: msal.Configuration;\n  /**\n   * Default token request options used when acquiring a token.\n   */\n  readonly defaultSilentRequest?: msal.SilentRequest;\n};\n\nexport type AppOptions = {\n  /**\n   * The app base url.\n   */\n  readonly baseUrl?: string;\n\n  /** App tenant ID */\n  readonly tenantId?: string;\n\n  /**\n   * Logger instance to use.\n   */\n  readonly logger?: ILogger;\n\n  /**\n   * Options to control how MSAL is initialized and used.\n   */\n  readonly msalOptions?: MsalOptions;\n};\n\ntype AppState =\n  | {\n      phase: 'stopped' | 'starting';\n      startedAt?: never;\n      msalInstance?: never;\n      context?: never;\n    }\n  | {\n      phase: 'started';\n      startedAt: Date;\n      msalInstance: msal.IPublicClientApplication;\n      context: teamsJs.app.Context;\n    };\n\ntype ExecOptions = (\n  | { msalTokenRequest: msal.SilentRequest; permission?: never }\n  | { msalTokenRequest?: never; permission: string }\n  | { msalTokenRequest?: never; permission?: never }\n) & {\n  requestHeaders?: Record<string, string>;\n};\n\nexport class App {\n  readonly options: AppOptions;\n  readonly http: http.Client;\n  readonly clientId: string;\n  protected _state: AppState = { phase: 'stopped' };\n\n  /**\n   * the apps logger\n   */\n  get log() {\n    return this._log;\n  }\n  protected _log: ILogger;\n\n  /**\n   * the date/time when the app was successfully started.\n   */\n  get startedAt() {\n    return this._state?.startedAt;\n  }\n\n  /** the msal instance used in this app. undefined until the app is started. */\n  get msalInstance() {\n    return this._state.msalInstance;\n  }\n\n  constructor(clientId: string, options: AppOptions = {}) {\n    if (!clientId) {\n      throw new Error('Invalid client ID.');\n    }\n\n    this.clientId = clientId;\n    this.options = options;\n    this._log = options?.logger || new ConsoleLogger('@teams/client');\n    this.http = new http.Client({ baseUrl: options?.baseUrl });\n  }\n\n  /**\n   * Starts the library and initializes the dependent teams-js and MSAL libraries.\n   * @returns A promise that will be fulfilled when the app has started, or\n   *          rejected if the initialization fails or times out.\n   */\n  async start(): Promise<void> {\n    if (this._state.phase !== 'stopped') {\n      this._log.debug(`app already ${this._state.phase}`);\n      return;\n    }\n\n    this._log.debug('app starting');\n    this._state = { phase: 'starting' };\n\n    await teamsJs.app.initialize();\n    const context = await teamsJs.app.getContext();\n\n    const msalConfig =\n      this.options.msalOptions?.configuration ?? buildMsalConfig(this.clientId, this._log);\n    const msalInstance = await msal.createNestablePublicClientApplication(msalConfig);\n    await msalInstance.initialize();\n\n    this._state = { phase: 'started', msalInstance, context, startedAt: new Date() };\n    this._log.debug('app started');\n  }\n\n  /**\n   * Execute a server-side function\n   * @param name The unique function name\n   * @param data The data to send\n   * @param options Options\n   * @param options.msalTokenRequest Optional MSAL token request.\n   * If omitted, a default token request is used.\n   * @param options.requestHeaders Optional additional request headers.\n   * @returns The function response\n   */\n  async exec<T = unknown>(name: string, data?: unknown, options?: ExecOptions): Promise<T> {\n    if (this._state.phase !== 'started') {\n      throw new Error('App not started');\n    }\n\n    const { context } = this._state;\n    const accessToken = await acquireMsalAccessToken(\n      this._state.msalInstance,\n      options?.msalTokenRequest ?? getStandardExecSilentRequest(this.clientId, options?.permission),\n      this._log\n    );\n\n    const res = await this.http.post<T>(`/api/functions/${name}`, data, {\n      headers: {\n        authorization: `Bearer ${accessToken}`,\n        'x-teams-app-session-id': context.app.sessionId,\n        'x-teams-channel-id': context.channel?.id,\n        'x-teams-chat-id': context.chat?.id,\n        'x-teams-meeting-id': context.meeting?.id,\n        'x-teams-message-id': context.app.parentMessageId,\n        'x-teams-page-id': context.page.id,\n        'x-teams-sub-page-id': context.page.subPageId,\n        'x-teams-team-id': context.team?.internalId,\n        ...(options?.requestHeaders ?? {}),\n      },\n    });\n\n    return res.data;\n  }\n}\n"]}
+{"version":3,"sources":["../src/app.ts"],"names":["ConsoleLogger","http","buildGraphClient","teamsJs","buildMsalConfig","msal","acquireMsalAccessToken","getStandardExecSilentRequest","hasConsentForScopes"],"mappings":"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","file":"app.js","sourcesContent":["import * as msal from '@azure/msal-browser';\n\nimport * as teamsJs from '@microsoft/teams-js';\nimport * as http from '@microsoft/teams.common/http';\nimport { ILogger, ConsoleLogger } from '@microsoft/teams.common/logging';\nimport * as graph from '@microsoft/teams.graph';\n\nimport { buildGraphClient } from './graph-utils';\nimport {\n  acquireMsalAccessToken,\n  buildMsalConfig,\n  getStandardExecSilentRequest,\n  hasConsentForScopes,\n} from './msal-utils';\n\nexport type MsalOptions = {\n  /**\n   * Optional MSAL configuration. This parameter is used to construct an MSAL instance in order\n   * to make authenticated function calls. If omitted, a default configuration is created.\n   */\n  readonly configuration?: msal.Configuration;\n  /**\n   * Options to control scope consent pre-warming. If explicitly set to false, no pre-warming is performed.\n   * If no value is provided, the default scope (i.e. \".default\") is pre-warmed. If a set of scopes is\n   * provided, the specified scopes are pre-warmed. The scopes should be for a single resource, and they\n   * should not mix the .default scope with named scopes.\n   */\n  readonly prewarmScopes?: false | string[];\n};\n\nexport type AppOptions = {\n  /**\n   * The app base url.\n   */\n  readonly baseUrl?: string;\n\n  /** App tenant ID */\n  readonly tenantId?: string;\n\n  /**\n   * Logger instance to use.\n   */\n  readonly logger?: ILogger;\n\n  /**\n   * Options to control how MSAL is initialized and used.\n   */\n  readonly msalOptions?: MsalOptions;\n};\n\ntype AppState =\n  | {\n      phase: 'stopped' | 'starting';\n      startedAt?: never;\n      msalInstance?: never;\n      context?: never;\n    }\n  | {\n      phase: 'started';\n      startedAt: Date;\n      msalInstance: msal.IPublicClientApplication;\n      context: teamsJs.app.Context;\n    };\n\nexport type ExecOptions = (\n  | { msalTokenRequest: msal.SilentRequest; permission?: never }\n  | { msalTokenRequest?: never; permission: string }\n  | { msalTokenRequest?: never; permission?: never }\n) & {\n  requestHeaders?: Record<string, string>;\n};\n\nexport class App {\n  readonly options: AppOptions;\n  readonly http: http.Client;\n  readonly graph: graph.Client;\n  readonly clientId: string;\n  protected _state: AppState = { phase: 'stopped' };\n\n  /**\n   * the apps logger\n   */\n  get log() {\n    return this._log;\n  }\n  protected _log: ILogger;\n\n  /**\n   * the date/time when the app was successfully started.\n   */\n  get startedAt() {\n    return this._state?.startedAt;\n  }\n\n  /** the msal instance used in this app. undefined until the app is started. */\n  get msalInstance() {\n    return this._state.msalInstance;\n  }\n\n  constructor(clientId: string, options: AppOptions = {}) {\n    if (!clientId) {\n      throw new Error('Invalid client ID.');\n    }\n\n    this.clientId = clientId;\n    this.options = options;\n    this._log = options?.logger || new ConsoleLogger('@teams/client');\n    this.http = new http.Client({ baseUrl: options?.baseUrl });\n    this.graph = buildGraphClient(() => this.appStateGuard(), this._log);\n  }\n\n  /**\n   * Starts the library and initializes the dependent teams-js and MSAL libraries.\n   * @returns A promise that will be fulfilled when the app has started, or\n   *          rejected if the initialization fails or times out.\n   */\n  async start(): Promise<void> {\n    if (this._state.phase !== 'stopped') {\n      this._log.debug(`app already ${this._state.phase}`);\n      return;\n    }\n\n    this._log.debug('app starting');\n    this._state = { phase: 'starting' };\n\n    await teamsJs.app.initialize();\n    const context = await teamsJs.app.getContext();\n\n    const msalConfig =\n      this.options.msalOptions?.configuration ?? buildMsalConfig(this.clientId, this._log);\n    const msalInstance = await msal.createNestablePublicClientApplication(msalConfig);\n    await msalInstance.initialize();\n\n    this._state = { phase: 'started', msalInstance, context, startedAt: new Date() };\n\n    // pre-warm consent for the specified scopes\n    if (this.options.msalOptions?.prewarmScopes !== false) {\n      const scopes = this.options.msalOptions?.prewarmScopes ?? ['.default'];\n      this._log.debug(`prewarming consent for scopes: ${scopes.join(', ')}`);\n      await this.ensureConsentForScopes(scopes);\n    }\n\n    this._log.debug('app started');\n  }\n\n  /**\n   * Execute a server-side function\n   * @param name The unique function name\n   * @param data The data to send\n   * @param options Options\n   * @param options.msalTokenRequest Optional MSAL token request.\n   * If omitted, a default token request is used.\n   * @param options.requestHeaders Optional additional request headers.\n   * @returns The function response\n   */\n  async exec<T = unknown>(name: string, data?: unknown, options?: ExecOptions): Promise<T> {\n    const { msalInstance, context } = this.appStateGuard();\n\n    const accessToken = await acquireMsalAccessToken(\n      msalInstance,\n      options?.msalTokenRequest ?? getStandardExecSilentRequest(this.clientId, options?.permission),\n      this._log\n    );\n\n    const res = await this.http.post<T>(`/api/functions/${name}`, data, {\n      headers: {\n        authorization: `Bearer ${accessToken}`,\n        'x-teams-app-session-id': context.app.sessionId,\n        'x-teams-channel-id': context.channel?.id,\n        'x-teams-chat-id': context.chat?.id,\n        'x-teams-meeting-id': context.meeting?.id,\n        'x-teams-message-id': context.app.parentMessageId,\n        'x-teams-page-id': context.page.id,\n        'x-teams-sub-page-id': context.page.subPageId,\n        'x-teams-team-id': context.team?.internalId,\n        ...(options?.requestHeaders ?? {}),\n      },\n    });\n\n    return res.data;\n  }\n\n  /**\n   * Tests whether the user has consented to the specified scopes without prompting the user for consent.\n   * @param scopes The scopes to check consent for.The scopes should be for a single resource, and they\n   * should not mix the .default scope with named scopes.\n   * @returns A promise that resolves to a boolean indicating whether the user has consented to the scopes.\n   */\n  async hasConsentForScopes(scopes: string[]): Promise<boolean> {\n    const { msalInstance } = this.appStateGuard();\n\n    return await hasConsentForScopes(msalInstance, scopes, this.log);\n  }\n\n  /**\n   * Tests whether the user has consented to the specified scopes, and prompts them if not. This is useful for ensuring\n   * that the user has consented to the required scopes before calling a graph API or other resource.\n   * @param scopes - The scopes to prewarm consent for. The scopes should be for a single resource, and they\n   * should not mix the .default scope with named scopes.\n   * @returns A value indicating whether consent has been acquired for the specified scopes.\n   */\n  async ensureConsentForScopes(scopes: string[]): Promise<boolean> {\n    const { msalInstance } = this.appStateGuard();\n\n    try {\n      const token = await acquireMsalAccessToken(msalInstance, { scopes }, this.log);\n      return !!token;\n    } catch (ex) {\n      return false;\n    }\n  }\n\n  private appStateGuard(): AppState & { phase: 'started' } {\n    if (this._state.phase !== 'started') {\n      throw new Error('App not started');\n    }\n    return this._state;\n  }\n}\n"]}

package/dist/app.mjs

@@ -1,12 +1,14 @@
 import * as msal from '@azure/msal-browser';
+import * as teamsJs from '@microsoft/teams-js';
 import * as http from '@microsoft/teams.common/http';
 import { ConsoleLogger } from '@microsoft/teams.common/logging';
-import * as teamsJs from '@microsoft/teams-js';
-import { buildMsalConfig, acquireMsalAccessToken, getStandardExecSilentRequest } from './msal-utils';
+import { buildGraphClient } from './graph-utils';
+import { buildMsalConfig, acquireMsalAccessToken, getStandardExecSilentRequest, hasConsentForScopes } from './msal-utils';
 
 class App {
   options;
   http;
+  graph;
   clientId;
   _state = { phase: "stopped" };
   /**
@@ -34,6 +36,7 @@ class App {
     this.options = options;
     this._log = options?.logger || new ConsoleLogger("@teams/client");
     this.http = new http.Client({ baseUrl: options?.baseUrl });
+    this.graph = buildGraphClient(() => this.appStateGuard(), this._log);
   }
   /**
    * Starts the library and initializes the dependent teams-js and MSAL libraries.
@@ -53,6 +56,11 @@ class App {
     const msalInstance = await msal.createNestablePublicClientApplication(msalConfig);
     await msalInstance.initialize();
     this._state = { phase: "started", msalInstance, context, startedAt: /* @__PURE__ */ new Date() };
+    if (this.options.msalOptions?.prewarmScopes !== false) {
+      const scopes = this.options.msalOptions?.prewarmScopes ?? [".default"];
+      this._log.debug(`prewarming consent for scopes: ${scopes.join(", ")}`);
+      await this.ensureConsentForScopes(scopes);
+    }
     this._log.debug("app started");
   }
   /**
@@ -66,12 +74,9 @@ class App {
    * @returns The function response
    */
   async exec(name, data, options) {
-    if (this._state.phase !== "started") {
-      throw new Error("App not started");
-    }
-    const { context } = this._state;
+    const { msalInstance, context } = this.appStateGuard();
     const accessToken = await acquireMsalAccessToken(
-      this._state.msalInstance,
+      msalInstance,
       options?.msalTokenRequest ?? getStandardExecSilentRequest(this.clientId, options?.permission),
       this._log
     );
@@ -91,6 +96,38 @@ class App {
     });
     return res.data;
   }
+  /**
+   * Tests whether the user has consented to the specified scopes without prompting the user for consent.
+   * @param scopes The scopes to check consent for.The scopes should be for a single resource, and they
+   * should not mix the .default scope with named scopes.
+   * @returns A promise that resolves to a boolean indicating whether the user has consented to the scopes.
+   */
+  async hasConsentForScopes(scopes) {
+    const { msalInstance } = this.appStateGuard();
+    return await hasConsentForScopes(msalInstance, scopes, this.log);
+  }
+  /**
+   * Tests whether the user has consented to the specified scopes, and prompts them if not. This is useful for ensuring
+   * that the user has consented to the required scopes before calling a graph API or other resource.
+   * @param scopes - The scopes to prewarm consent for. The scopes should be for a single resource, and they
+   * should not mix the .default scope with named scopes.
+   * @returns A value indicating whether consent has been acquired for the specified scopes.
+   */
+  async ensureConsentForScopes(scopes) {
+    const { msalInstance } = this.appStateGuard();
+    try {
+      const token = await acquireMsalAccessToken(msalInstance, { scopes }, this.log);
+      return !!token;
+    } catch (ex) {
+      return false;
+    }
+  }
+  appStateGuard() {
+    if (this._state.phase !== "started") {
+      throw new Error("App not started");
+    }
+    return this._state;
+  }
 }
 
 export { App };

package/dist/app.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/app.ts"],"names":[],"mappings":"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","file":"app.mjs","sourcesContent":["import * as msal from '@azure/msal-browser';\nimport * as http from '@microsoft/teams.common/http';\nimport { ILogger, ConsoleLogger } from '@microsoft/teams.common/logging';\nimport * as teamsJs from '@microsoft/teams-js';\n\nimport {\n  acquireMsalAccessToken,\n  buildMsalConfig,\n  getStandardExecSilentRequest,\n} from './msal-utils';\n\nexport type MsalOptions = {\n  /**\n   * Optional MSAL configuration. This parameter is used to construct an MSAL instance in order\n   * to make authenticated function calls. If omitted, a default configuration is created.\n   */\n  readonly configuration?: msal.Configuration;\n  /**\n   * Default token request options used when acquiring a token.\n   */\n  readonly defaultSilentRequest?: msal.SilentRequest;\n};\n\nexport type AppOptions = {\n  /**\n   * The app base url.\n   */\n  readonly baseUrl?: string;\n\n  /** App tenant ID */\n  readonly tenantId?: string;\n\n  /**\n   * Logger instance to use.\n   */\n  readonly logger?: ILogger;\n\n  /**\n   * Options to control how MSAL is initialized and used.\n   */\n  readonly msalOptions?: MsalOptions;\n};\n\ntype AppState =\n  | {\n      phase: 'stopped' | 'starting';\n      startedAt?: never;\n      msalInstance?: never;\n      context?: never;\n    }\n  | {\n      phase: 'started';\n      startedAt: Date;\n      msalInstance: msal.IPublicClientApplication;\n      context: teamsJs.app.Context;\n    };\n\ntype ExecOptions = (\n  | { msalTokenRequest: msal.SilentRequest; permission?: never }\n  | { msalTokenRequest?: never; permission: string }\n  | { msalTokenRequest?: never; permission?: never }\n) & {\n  requestHeaders?: Record<string, string>;\n};\n\nexport class App {\n  readonly options: AppOptions;\n  readonly http: http.Client;\n  readonly clientId: string;\n  protected _state: AppState = { phase: 'stopped' };\n\n  /**\n   * the apps logger\n   */\n  get log() {\n    return this._log;\n  }\n  protected _log: ILogger;\n\n  /**\n   * the date/time when the app was successfully started.\n   */\n  get startedAt() {\n    return this._state?.startedAt;\n  }\n\n  /** the msal instance used in this app. undefined until the app is started. */\n  get msalInstance() {\n    return this._state.msalInstance;\n  }\n\n  constructor(clientId: string, options: AppOptions = {}) {\n    if (!clientId) {\n      throw new Error('Invalid client ID.');\n    }\n\n    this.clientId = clientId;\n    this.options = options;\n    this._log = options?.logger || new ConsoleLogger('@teams/client');\n    this.http = new http.Client({ baseUrl: options?.baseUrl });\n  }\n\n  /**\n   * Starts the library and initializes the dependent teams-js and MSAL libraries.\n   * @returns A promise that will be fulfilled when the app has started, or\n   *          rejected if the initialization fails or times out.\n   */\n  async start(): Promise<void> {\n    if (this._state.phase !== 'stopped') {\n      this._log.debug(`app already ${this._state.phase}`);\n      return;\n    }\n\n    this._log.debug('app starting');\n    this._state = { phase: 'starting' };\n\n    await teamsJs.app.initialize();\n    const context = await teamsJs.app.getContext();\n\n    const msalConfig =\n      this.options.msalOptions?.configuration ?? buildMsalConfig(this.clientId, this._log);\n    const msalInstance = await msal.createNestablePublicClientApplication(msalConfig);\n    await msalInstance.initialize();\n\n    this._state = { phase: 'started', msalInstance, context, startedAt: new Date() };\n    this._log.debug('app started');\n  }\n\n  /**\n   * Execute a server-side function\n   * @param name The unique function name\n   * @param data The data to send\n   * @param options Options\n   * @param options.msalTokenRequest Optional MSAL token request.\n   * If omitted, a default token request is used.\n   * @param options.requestHeaders Optional additional request headers.\n   * @returns The function response\n   */\n  async exec<T = unknown>(name: string, data?: unknown, options?: ExecOptions): Promise<T> {\n    if (this._state.phase !== 'started') {\n      throw new Error('App not started');\n    }\n\n    const { context } = this._state;\n    const accessToken = await acquireMsalAccessToken(\n      this._state.msalInstance,\n      options?.msalTokenRequest ?? getStandardExecSilentRequest(this.clientId, options?.permission),\n      this._log\n    );\n\n    const res = await this.http.post<T>(`/api/functions/${name}`, data, {\n      headers: {\n        authorization: `Bearer ${accessToken}`,\n        'x-teams-app-session-id': context.app.sessionId,\n        'x-teams-channel-id': context.channel?.id,\n        'x-teams-chat-id': context.chat?.id,\n        'x-teams-meeting-id': context.meeting?.id,\n        'x-teams-message-id': context.app.parentMessageId,\n        'x-teams-page-id': context.page.id,\n        'x-teams-sub-page-id': context.page.subPageId,\n        'x-teams-team-id': context.team?.internalId,\n        ...(options?.requestHeaders ?? {}),\n      },\n    });\n\n    return res.data;\n  }\n}\n"]}
+{"version":3,"sources":["../src/app.ts"],"names":[],"mappings":"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","file":"app.mjs","sourcesContent":["import * as msal from '@azure/msal-browser';\n\nimport * as teamsJs from '@microsoft/teams-js';\nimport * as http from '@microsoft/teams.common/http';\nimport { ILogger, ConsoleLogger } from '@microsoft/teams.common/logging';\nimport * as graph from '@microsoft/teams.graph';\n\nimport { buildGraphClient } from './graph-utils';\nimport {\n  acquireMsalAccessToken,\n  buildMsalConfig,\n  getStandardExecSilentRequest,\n  hasConsentForScopes,\n} from './msal-utils';\n\nexport type MsalOptions = {\n  /**\n   * Optional MSAL configuration. This parameter is used to construct an MSAL instance in order\n   * to make authenticated function calls. If omitted, a default configuration is created.\n   */\n  readonly configuration?: msal.Configuration;\n  /**\n   * Options to control scope consent pre-warming. If explicitly set to false, no pre-warming is performed.\n   * If no value is provided, the default scope (i.e. \".default\") is pre-warmed. If a set of scopes is\n   * provided, the specified scopes are pre-warmed. The scopes should be for a single resource, and they\n   * should not mix the .default scope with named scopes.\n   */\n  readonly prewarmScopes?: false | string[];\n};\n\nexport type AppOptions = {\n  /**\n   * The app base url.\n   */\n  readonly baseUrl?: string;\n\n  /** App tenant ID */\n  readonly tenantId?: string;\n\n  /**\n   * Logger instance to use.\n   */\n  readonly logger?: ILogger;\n\n  /**\n   * Options to control how MSAL is initialized and used.\n   */\n  readonly msalOptions?: MsalOptions;\n};\n\ntype AppState =\n  | {\n      phase: 'stopped' | 'starting';\n      startedAt?: never;\n      msalInstance?: never;\n      context?: never;\n    }\n  | {\n      phase: 'started';\n      startedAt: Date;\n      msalInstance: msal.IPublicClientApplication;\n      context: teamsJs.app.Context;\n    };\n\nexport type ExecOptions = (\n  | { msalTokenRequest: msal.SilentRequest; permission?: never }\n  | { msalTokenRequest?: never; permission: string }\n  | { msalTokenRequest?: never; permission?: never }\n) & {\n  requestHeaders?: Record<string, string>;\n};\n\nexport class App {\n  readonly options: AppOptions;\n  readonly http: http.Client;\n  readonly graph: graph.Client;\n  readonly clientId: string;\n  protected _state: AppState = { phase: 'stopped' };\n\n  /**\n   * the apps logger\n   */\n  get log() {\n    return this._log;\n  }\n  protected _log: ILogger;\n\n  /**\n   * the date/time when the app was successfully started.\n   */\n  get startedAt() {\n    return this._state?.startedAt;\n  }\n\n  /** the msal instance used in this app. undefined until the app is started. */\n  get msalInstance() {\n    return this._state.msalInstance;\n  }\n\n  constructor(clientId: string, options: AppOptions = {}) {\n    if (!clientId) {\n      throw new Error('Invalid client ID.');\n    }\n\n    this.clientId = clientId;\n    this.options = options;\n    this._log = options?.logger || new ConsoleLogger('@teams/client');\n    this.http = new http.Client({ baseUrl: options?.baseUrl });\n    this.graph = buildGraphClient(() => this.appStateGuard(), this._log);\n  }\n\n  /**\n   * Starts the library and initializes the dependent teams-js and MSAL libraries.\n   * @returns A promise that will be fulfilled when the app has started, or\n   *          rejected if the initialization fails or times out.\n   */\n  async start(): Promise<void> {\n    if (this._state.phase !== 'stopped') {\n      this._log.debug(`app already ${this._state.phase}`);\n      return;\n    }\n\n    this._log.debug('app starting');\n    this._state = { phase: 'starting' };\n\n    await teamsJs.app.initialize();\n    const context = await teamsJs.app.getContext();\n\n    const msalConfig =\n      this.options.msalOptions?.configuration ?? buildMsalConfig(this.clientId, this._log);\n    const msalInstance = await msal.createNestablePublicClientApplication(msalConfig);\n    await msalInstance.initialize();\n\n    this._state = { phase: 'started', msalInstance, context, startedAt: new Date() };\n\n    // pre-warm consent for the specified scopes\n    if (this.options.msalOptions?.prewarmScopes !== false) {\n      const scopes = this.options.msalOptions?.prewarmScopes ?? ['.default'];\n      this._log.debug(`prewarming consent for scopes: ${scopes.join(', ')}`);\n      await this.ensureConsentForScopes(scopes);\n    }\n\n    this._log.debug('app started');\n  }\n\n  /**\n   * Execute a server-side function\n   * @param name The unique function name\n   * @param data The data to send\n   * @param options Options\n   * @param options.msalTokenRequest Optional MSAL token request.\n   * If omitted, a default token request is used.\n   * @param options.requestHeaders Optional additional request headers.\n   * @returns The function response\n   */\n  async exec<T = unknown>(name: string, data?: unknown, options?: ExecOptions): Promise<T> {\n    const { msalInstance, context } = this.appStateGuard();\n\n    const accessToken = await acquireMsalAccessToken(\n      msalInstance,\n      options?.msalTokenRequest ?? getStandardExecSilentRequest(this.clientId, options?.permission),\n      this._log\n    );\n\n    const res = await this.http.post<T>(`/api/functions/${name}`, data, {\n      headers: {\n        authorization: `Bearer ${accessToken}`,\n        'x-teams-app-session-id': context.app.sessionId,\n        'x-teams-channel-id': context.channel?.id,\n        'x-teams-chat-id': context.chat?.id,\n        'x-teams-meeting-id': context.meeting?.id,\n        'x-teams-message-id': context.app.parentMessageId,\n        'x-teams-page-id': context.page.id,\n        'x-teams-sub-page-id': context.page.subPageId,\n        'x-teams-team-id': context.team?.internalId,\n        ...(options?.requestHeaders ?? {}),\n      },\n    });\n\n    return res.data;\n  }\n\n  /**\n   * Tests whether the user has consented to the specified scopes without prompting the user for consent.\n   * @param scopes The scopes to check consent for.The scopes should be for a single resource, and they\n   * should not mix the .default scope with named scopes.\n   * @returns A promise that resolves to a boolean indicating whether the user has consented to the scopes.\n   */\n  async hasConsentForScopes(scopes: string[]): Promise<boolean> {\n    const { msalInstance } = this.appStateGuard();\n\n    return await hasConsentForScopes(msalInstance, scopes, this.log);\n  }\n\n  /**\n   * Tests whether the user has consented to the specified scopes, and prompts them if not. This is useful for ensuring\n   * that the user has consented to the required scopes before calling a graph API or other resource.\n   * @param scopes - The scopes to prewarm consent for. The scopes should be for a single resource, and they\n   * should not mix the .default scope with named scopes.\n   * @returns A value indicating whether consent has been acquired for the specified scopes.\n   */\n  async ensureConsentForScopes(scopes: string[]): Promise<boolean> {\n    const { msalInstance } = this.appStateGuard();\n\n    try {\n      const token = await acquireMsalAccessToken(msalInstance, { scopes }, this.log);\n      return !!token;\n    } catch (ex) {\n      return false;\n    }\n  }\n\n  private appStateGuard(): AppState & { phase: 'started' } {\n    if (this._state.phase !== 'started') {\n      throw new Error('App not started');\n    }\n    return this._state;\n  }\n}\n"]}

package/dist/graph-utils.d.mts

@@ -0,0 +1,10 @@
+import { ILogger } from '@microsoft/teams.common/logging';
+import * as graph from '@microsoft/teams.graph';
+import { acquireMsalAccessToken } from './msal-utils.mjs';
+import '@azure/msal-browser';
+
+declare function buildGraphClient(getMsalInstance: () => {
+    msalInstance: Parameters<typeof acquireMsalAccessToken>[0];
+}, logger: ILogger): graph.Client;
+
+export { buildGraphClient };

package/dist/graph-utils.d.ts

@@ -0,0 +1,10 @@
+import { ILogger } from '@microsoft/teams.common/logging';
+import * as graph from '@microsoft/teams.graph';
+import { acquireMsalAccessToken } from './msal-utils.js';
+import '@azure/msal-browser';
+
+declare function buildGraphClient(getMsalInstance: () => {
+    msalInstance: Parameters<typeof acquireMsalAccessToken>[0];
+}, logger: ILogger): graph.Client;
+
+export { buildGraphClient };

package/dist/graph-utils.js

@@ -0,0 +1,50 @@
+'use strict';
+
+var http = require('@microsoft/teams.common/http');
+var graph = require('@microsoft/teams.graph');
+var msalUtils = require('./msal-utils');
+
+function _interopNamespace(e) {
+  if (e && e.__esModule) return e;
+  var n = Object.create(null);
+  if (e) {
+    Object.keys(e).forEach(function (k) {
+      if (k !== 'default') {
+        var d = Object.getOwnPropertyDescriptor(e, k);
+        Object.defineProperty(n, k, d.get ? d : {
+          enumerable: true,
+          get: function () { return e[k]; }
+        });
+      }
+    });
+  }
+  n.default = e;
+  return Object.freeze(n);
+}
+
+var http__namespace = /*#__PURE__*/_interopNamespace(http);
+var graph__namespace = /*#__PURE__*/_interopNamespace(graph);
+
+function buildGraphClient(getMsalInstance, logger) {
+  {
+    const graphRequestAccessTokenInterceptor = async (ctx) => {
+      const { msalInstance } = getMsalInstance();
+      const accessToken = await msalUtils.acquireMsalAccessToken(
+        msalInstance,
+        { scopes: [".default"] },
+        logger
+      );
+      ctx.config.headers.set("Authorization", `Bearer ${accessToken}`);
+      return ctx.config;
+    };
+    return new graph__namespace.Client(
+      new http__namespace.Client({
+        interceptors: [{ request: graphRequestAccessTokenInterceptor }]
+      })
+    );
+  }
+}
+
+exports.buildGraphClient = buildGraphClient;
+//# sourceMappingURL=graph-utils.js.map
+//# sourceMappingURL=graph-utils.js.map

package/dist/graph-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/graph-utils.ts"],"names":["acquireMsalAccessToken","graph","http"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;AAMO,SAAS,gBAAA,CACd,iBACA,MACc,EAAA;AACd,EAAA;AACE,IAAM,MAAA,kCAAA,GAAqC,OAAO,GAA6B,KAAA;AAC7E,MAAM,MAAA,EAAE,YAAa,EAAA,GAAI,eAAgB,EAAA;AAIzC,MAAA,MAAM,cAAc,MAAMA,gCAAA;AAAA,QACxB,YAAA;AAAA,QACA,EAAE,MAAA,EAAQ,CAAC,UAAU,CAAE,EAAA;AAAA,QACvB;AAAA,OACF;AAEA,MAAA,GAAA,CAAI,OAAO,OAAQ,CAAA,GAAA,CAAI,eAAiB,EAAA,CAAA,OAAA,EAAU,WAAW,CAAE,CAAA,CAAA;AAC/D,MAAA,OAAO,GAAI,CAAA,MAAA;AAAA,KACb;AAEA,IAAA,OAAO,IAAIC,gBAAM,CAAA,MAAA;AAAA,MACf,IAAIC,gBAAK,MAAO,CAAA;AAAA,QACd,YAAc,EAAA,CAAC,EAAE,OAAA,EAAS,oCAAoC;AAAA,OAC/D;AAAA,KACH;AAAA;AAEJ","file":"graph-utils.js","sourcesContent":["import * as http from '@microsoft/teams.common/http';\nimport { ILogger } from '@microsoft/teams.common/logging';\nimport * as graph from '@microsoft/teams.graph';\n\nimport { acquireMsalAccessToken } from './msal-utils';\n\nexport function buildGraphClient(\n  getMsalInstance: () => { msalInstance: Parameters<typeof acquireMsalAccessToken>[0] },\n  logger: ILogger\n): graph.Client {\n  {\n    const graphRequestAccessTokenInterceptor = async (ctx: http.RequestContext) => {\n      const { msalInstance } = getMsalInstance();\n\n      // The developer should already have made sure that the user has consented to the scope\n      // needed for the graph API they're calling, so requesting '.default' should be sufficient.\n      const accessToken = await acquireMsalAccessToken(\n        msalInstance,\n        { scopes: ['.default'] },\n        logger\n      );\n\n      ctx.config.headers.set('Authorization', `Bearer ${accessToken}`);\n      return ctx.config;\n    };\n\n    return new graph.Client(\n      new http.Client({\n        interceptors: [{ request: graphRequestAccessTokenInterceptor }],\n      })\n    );\n  }\n}\n"]}

package/dist/graph-utils.mjs

@@ -0,0 +1,27 @@
+import * as http from '@microsoft/teams.common/http';
+import * as graph from '@microsoft/teams.graph';
+import { acquireMsalAccessToken } from './msal-utils';
+
+function buildGraphClient(getMsalInstance, logger) {
+  {
+    const graphRequestAccessTokenInterceptor = async (ctx) => {
+      const { msalInstance } = getMsalInstance();
+      const accessToken = await acquireMsalAccessToken(
+        msalInstance,
+        { scopes: [".default"] },
+        logger
+      );
+      ctx.config.headers.set("Authorization", `Bearer ${accessToken}`);
+      return ctx.config;
+    };
+    return new graph.Client(
+      new http.Client({
+        interceptors: [{ request: graphRequestAccessTokenInterceptor }]
+      })
+    );
+  }
+}
+
+export { buildGraphClient };
+//# sourceMappingURL=graph-utils.mjs.map
+//# sourceMappingURL=graph-utils.mjs.map

package/dist/graph-utils.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/graph-utils.ts"],"names":[],"mappings":";;;;AAMO,SAAS,gBAAA,CACd,iBACA,MACc,EAAA;AACd,EAAA;AACE,IAAM,MAAA,kCAAA,GAAqC,OAAO,GAA6B,KAAA;AAC7E,MAAM,MAAA,EAAE,YAAa,EAAA,GAAI,eAAgB,EAAA;AAIzC,MAAA,MAAM,cAAc,MAAM,sBAAA;AAAA,QACxB,YAAA;AAAA,QACA,EAAE,MAAA,EAAQ,CAAC,UAAU,CAAE,EAAA;AAAA,QACvB;AAAA,OACF;AAEA,MAAA,GAAA,CAAI,OAAO,OAAQ,CAAA,GAAA,CAAI,eAAiB,EAAA,CAAA,OAAA,EAAU,WAAW,CAAE,CAAA,CAAA;AAC/D,MAAA,OAAO,GAAI,CAAA,MAAA;AAAA,KACb;AAEA,IAAA,OAAO,IAAI,KAAM,CAAA,MAAA;AAAA,MACf,IAAI,KAAK,MAAO,CAAA;AAAA,QACd,YAAc,EAAA,CAAC,EAAE,OAAA,EAAS,oCAAoC;AAAA,OAC/D;AAAA,KACH;AAAA;AAEJ","file":"graph-utils.mjs","sourcesContent":["import * as http from '@microsoft/teams.common/http';\nimport { ILogger } from '@microsoft/teams.common/logging';\nimport * as graph from '@microsoft/teams.graph';\n\nimport { acquireMsalAccessToken } from './msal-utils';\n\nexport function buildGraphClient(\n  getMsalInstance: () => { msalInstance: Parameters<typeof acquireMsalAccessToken>[0] },\n  logger: ILogger\n): graph.Client {\n  {\n    const graphRequestAccessTokenInterceptor = async (ctx: http.RequestContext) => {\n      const { msalInstance } = getMsalInstance();\n\n      // The developer should already have made sure that the user has consented to the scope\n      // needed for the graph API they're calling, so requesting '.default' should be sufficient.\n      const accessToken = await acquireMsalAccessToken(\n        msalInstance,\n        { scopes: ['.default'] },\n        logger\n      );\n\n      ctx.config.headers.set('Authorization', `Bearer ${accessToken}`);\n      return ctx.config;\n    };\n\n    return new graph.Client(\n      new http.Client({\n        interceptors: [{ request: graphRequestAccessTokenInterceptor }],\n      })\n    );\n  }\n}\n"]}

package/dist/index.d.mts

@@ -1,56 +1,6 @@
-export { App, AppOptions, MsalOptions } from './app.mjs';
-export { Context, mapContext } from './context/index.mjs';
-export { i as types } from './index-DJal_Cxb.mjs';
+export { App, AppOptions, ExecOptions, MsalOptions } from './app.mjs';
 import '@azure/msal-browser';
+import '@microsoft/teams-js';
 import '@microsoft/teams.common/http';
 import '@microsoft/teams.common/logging';
-import '@microsoft/teams-js';
-import './window/types/context.mjs';
-import './window/types/channel-type.mjs';
-import './window/types/file-open-preference.mjs';
-import './window/types/frame-context.mjs';
-import './window/types/host.mjs';
-import './window/types/locale.mjs';
-import './window/types/team-type.mjs';
-import './window/types/theme.mjs';
-import './window/types/user-team-role.mjs';
-import './context/app.mjs';
-import './context/app-host.mjs';
-import './context/channel.mjs';
-import './context/chat.mjs';
-import './context/meeting.mjs';
-import './context/page.mjs';
-import './context/share-point-site.mjs';
-import './context/team.mjs';
-import './context/user.mjs';
-import './context/tenant.mjs';
-import './window/types/user-meeting-role.mjs';
-import './window/types/user-profile.mjs';
-import './window/types/data-residency.mjs';
-import './window/types/bar-code-config.mjs';
-import './window/types/permission.mjs';
-import './window/types/call-modality.mjs';
-import './window/types/file.mjs';
-import './window/types/thread-member.mjs';
-import './window/types/legal-age-group-classification.mjs';
-import './window/types/app-eligibility-info.mjs';
-import './window/types/action-open-url-type.mjs';
-import './window/types/location.mjs';
-import './window/types/notification-type.mjs';
-import './index-7hUkxLxx.mjs';
-import './window/types/liveshare/container-state.mjs';
-import './window/types/liveshare/fluid-container.mjs';
-import './window/types/liveshare/ntp-time.mjs';
-import './window/types/liveshare/fluid-tenant.mjs';
-import './window/types/liveshare/client.mjs';
-import './index-DrTQ_GLN.mjs';
-import './window/types/marketplace/cart.mjs';
-import './window/types/marketplace/cart-info.mjs';
-import './window/types/marketplace/cart-status.mjs';
-import './window/types/marketplace/intent.mjs';
-import './window/types/marketplace/cart-item.mjs';
-import './window/types/marketplace/cart-version.mjs';
-import './index-D6kqtGPa.mjs';
-import './window/types/dialog/dialog-dimension.mjs';
-import './window/types/dialog/dialog-info.mjs';
-import './window/types/dialog/dialog-size.mjs';
+import '@microsoft/teams.graph';

package/dist/index.d.ts

@@ -1,56 +1,6 @@
-export { App, AppOptions, MsalOptions } from './app.js';
-export { Context, mapContext } from './context/index.js';
-export { i as types } from './index-8IcDrPMv.js';
+export { App, AppOptions, ExecOptions, MsalOptions } from './app.js';
 import '@azure/msal-browser';
+import '@microsoft/teams-js';
 import '@microsoft/teams.common/http';
 import '@microsoft/teams.common/logging';
-import '@microsoft/teams-js';
-import './window/types/context.js';
-import './window/types/channel-type.js';
-import './window/types/file-open-preference.js';
-import './window/types/frame-context.js';
-import './window/types/host.js';
-import './window/types/locale.js';
-import './window/types/team-type.js';
-import './window/types/theme.js';
-import './window/types/user-team-role.js';
-import './context/app.js';
-import './context/app-host.js';
-import './context/channel.js';
-import './context/chat.js';
-import './context/meeting.js';
-import './context/page.js';
-import './context/share-point-site.js';
-import './context/team.js';
-import './context/user.js';
-import './context/tenant.js';
-import './window/types/user-meeting-role.js';
-import './window/types/user-profile.js';
-import './window/types/data-residency.js';
-import './window/types/bar-code-config.js';
-import './window/types/permission.js';
-import './window/types/call-modality.js';
-import './window/types/file.js';
-import './window/types/thread-member.js';
-import './window/types/legal-age-group-classification.js';
-import './window/types/app-eligibility-info.js';
-import './window/types/action-open-url-type.js';
-import './window/types/location.js';
-import './window/types/notification-type.js';
-import './index-DtE-Eb9L.js';
-import './window/types/liveshare/container-state.js';
-import './window/types/liveshare/fluid-container.js';
-import './window/types/liveshare/ntp-time.js';
-import './window/types/liveshare/fluid-tenant.js';
-import './window/types/liveshare/client.js';
-import './index-_Hc8oq9_.js';
-import './window/types/marketplace/cart.js';
-import './window/types/marketplace/cart-info.js';
-import './window/types/marketplace/cart-status.js';
-import './window/types/marketplace/intent.js';
-import './window/types/marketplace/cart-item.js';
-import './window/types/marketplace/cart-version.js';
-import './index-5Ok-M8A0.js';
-import './window/types/dialog/dialog-dimension.js';
-import './window/types/dialog/dialog-info.js';
-import './window/types/dialog/dialog-size.js';
+import '@microsoft/teams.graph';