@microsoft/teams-js 2.2.0 → 2.2.1-beta.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1127,7 +1127,7 @@ __webpack_require__.d(__webpack_exports__, {
1127
1127
  });
1128
1128
 
1129
1129
  ;// CONCATENATED MODULE: ./src/internal/constants.ts
1130
- var version = "2.2.0";
1130
+ var version = "2.2.1-beta.0";
1131
1131
  /**
1132
1132
  * @hidden
1133
1133
  * The client version when all SDK APIs started to check platform compatibility for the APIs was 1.6.0.
@@ -1135,6 +1135,7 @@ var version = "2.2.0";
1135
1135
  * Mobile clients are passing versions, hence will be applicable to web and desktop clients only.
1136
1136
  *
1137
1137
  * @internal
1138
+ * Limited to Microsoft-internal use
1138
1139
  */
1139
1140
  var defaultSDKVersionForCompatCheck = '2.0.1';
1140
1141
  /**
@@ -1142,14 +1143,23 @@ var defaultSDKVersionForCompatCheck = '2.0.1';
1142
1143
  * This is the client version when selectMedia API - VideoAndImage is supported on mobile.
1143
1144
  *
1144
1145
  * @internal
1146
+ * Limited to Microsoft-internal use
1145
1147
  */
1146
1148
  var videoAndImageMediaAPISupportVersion = '2.0.2';
1147
1149
  /**
1150
+ * @hidden
1148
1151
  * This is the client version when selectMedia API - Video with non-full screen mode is supported on mobile.
1152
+ *
1153
+ * @internal
1154
+ * Limited to Microsoft-internal use
1149
1155
  */
1150
1156
  var nonFullScreenVideoModeAPISupportVersion = '2.0.3';
1151
1157
  /**
1158
+ * @hidden
1152
1159
  * This is the client version when selectMedia API - ImageOutputFormats is supported on mobile.
1160
+ *
1161
+ * @internal
1162
+ * Limited to Microsoft-internal use
1153
1163
  */
1154
1164
  var imageOutputFormatsAPISupportVersion = '2.0.4';
1155
1165
  /**
@@ -1157,6 +1167,7 @@ var imageOutputFormatsAPISupportVersion = '2.0.4';
1157
1167
  * Minimum required client supported version for {@link getUserJoinedTeams} to be supported on {@link HostClientType.android}
1158
1168
  *
1159
1169
  * @internal
1170
+ * Limited to Microsoft-internal use
1160
1171
  */
1161
1172
  var getUserJoinedTeamsSupportedAndroidClientVersion = '2.0.1';
1162
1173
  /**
@@ -1164,6 +1175,7 @@ var getUserJoinedTeamsSupportedAndroidClientVersion = '2.0.1';
1164
1175
  * This is the client version when location APIs (getLocation and showLocation) are supported.
1165
1176
  *
1166
1177
  * @internal
1178
+ * Limited to Microsoft-internal use
1167
1179
  */
1168
1180
  var locationAPIsRequiredVersion = '1.9.0';
1169
1181
  /**
@@ -1171,6 +1183,7 @@ var locationAPIsRequiredVersion = '1.9.0';
1171
1183
  * This is the client version when permisisons are supported
1172
1184
  *
1173
1185
  * @internal
1186
+ * Limited to Microsoft-internal use
1174
1187
  */
1175
1188
  var permissionsAPIsRequiredVersion = '2.0.1';
1176
1189
  /**
@@ -1178,6 +1191,7 @@ var permissionsAPIsRequiredVersion = '2.0.1';
1178
1191
  * This is the client version when people picker API is supported on mobile.
1179
1192
  *
1180
1193
  * @internal
1194
+ * Limited to Microsoft-internal use
1181
1195
  */
1182
1196
  var peoplePickerRequiredVersion = '2.0.0';
1183
1197
  /**
@@ -1185,6 +1199,7 @@ var peoplePickerRequiredVersion = '2.0.0';
1185
1199
  * This is the client version when captureImage API is supported on mobile.
1186
1200
  *
1187
1201
  * @internal
1202
+ * Limited to Microsoft-internal use
1188
1203
  */
1189
1204
  var captureImageMobileSupportVersion = '1.7.0';
1190
1205
  /**
@@ -1192,6 +1207,7 @@ var captureImageMobileSupportVersion = '1.7.0';
1192
1207
  * This is the client version when media APIs are supported on all three platforms ios, android and web.
1193
1208
  *
1194
1209
  * @internal
1210
+ * Limited to Microsoft-internal use
1195
1211
  */
1196
1212
  var mediaAPISupportVersion = '1.8.0';
1197
1213
  /**
@@ -1199,6 +1215,7 @@ var mediaAPISupportVersion = '1.8.0';
1199
1215
  * This is the client version when getMedia API is supported via Callbacks on all three platforms ios, android and web.
1200
1216
  *
1201
1217
  * @internal
1218
+ * Limited to Microsoft-internal use
1202
1219
  */
1203
1220
  var getMediaCallbackSupportVersion = '2.0.0';
1204
1221
  /**
@@ -1206,6 +1223,7 @@ var getMediaCallbackSupportVersion = '2.0.0';
1206
1223
  * This is the client version when scanBarCode API is supported on mobile.
1207
1224
  *
1208
1225
  * @internal
1226
+ * Limited to Microsoft-internal use
1209
1227
  */
1210
1228
  var scanBarCodeAPIMobileSupportVersion = '1.9.0';
1211
1229
  /**
@@ -1213,6 +1231,7 @@ var scanBarCodeAPIMobileSupportVersion = '1.9.0';
1213
1231
  * List of supported Host origins
1214
1232
  *
1215
1233
  * @internal
1234
+ * Limited to Microsoft-internal use
1216
1235
  */
1217
1236
  var validOrigins = [
1218
1237
  'teams.microsoft.com',
@@ -1248,6 +1267,7 @@ var validOrigins = [
1248
1267
  * USer specified message origins should satisfy this test
1249
1268
  *
1250
1269
  * @internal
1270
+ * Limited to Microsoft-internal use
1251
1271
  */
1252
1272
  var userOriginUrlValidationRegExp = /^https:\/\//;
1253
1273
  /**
@@ -1255,6 +1275,7 @@ var userOriginUrlValidationRegExp = /^https:\/\//;
1255
1275
  * The protocol used for deep links into Teams
1256
1276
  *
1257
1277
  * @internal
1278
+ * Limited to Microsoft-internal use
1258
1279
  */
1259
1280
  var teamsDeepLinkProtocol = 'https';
1260
1281
  /**
@@ -1262,6 +1283,7 @@ var teamsDeepLinkProtocol = 'https';
1262
1283
  * The host used for deep links into Teams
1263
1284
  *
1264
1285
  * @internal
1286
+ * Limited to Microsoft-internal use
1265
1287
  */
1266
1288
  var teamsDeepLinkHost = 'teams.microsoft.com';
1267
1289
 
@@ -1484,6 +1506,7 @@ var uuid = __webpack_require__(22);
1484
1506
  * validateHostAgainstPattern('teams.microsoft.com', 'team.microsoft.com') returns false
1485
1507
  *
1486
1508
  * @internal
1509
+ * Limited to Microsoft-internal use
1487
1510
  */
1488
1511
  function validateHostAgainstPattern(pattern, host) {
1489
1512
  if (pattern.substring(0, 2) === '*.') {
@@ -1499,7 +1522,10 @@ function validateHostAgainstPattern(pattern, host) {
1499
1522
  }
1500
1523
  return false;
1501
1524
  }
1502
- /**@internal */
1525
+ /**
1526
+ * @internal
1527
+ * Limited to Microsoft-internal use
1528
+ */
1503
1529
  function validateOrigin(messageOrigin) {
1504
1530
  // Check whether the url is in the pre-known allowlist or supplied by user
1505
1531
  if (messageOrigin.protocol !== 'https:') {
@@ -1518,7 +1544,10 @@ function validateOrigin(messageOrigin) {
1518
1544
  }
1519
1545
  return false;
1520
1546
  }
1521
- /**@internal */
1547
+ /**
1548
+ * @internal
1549
+ * Limited to Microsoft-internal use
1550
+ */
1522
1551
  function getGenericOnCompleteHandler(errorMessage) {
1523
1552
  return function (success, reason) {
1524
1553
  if (!success) {
@@ -1544,6 +1573,7 @@ function getGenericOnCompleteHandler(errorMessage) {
1544
1573
  * compareSDKVersions('2.0', 2.0) returns NaN
1545
1574
  *
1546
1575
  * @internal
1576
+ * Limited to Microsoft-internal use
1547
1577
  */
1548
1578
  function compareSDKVersions(v1, v2) {
1549
1579
  if (typeof v1 !== 'string' || typeof v2 !== 'string') {
@@ -1584,10 +1614,15 @@ function compareSDKVersions(v1, v2) {
1584
1614
  * Generates a GUID
1585
1615
  *
1586
1616
  * @internal
1617
+ * Limited to Microsoft-internal use
1587
1618
  */
1588
1619
  function generateGUID() {
1589
1620
  return uuid.v4();
1590
1621
  }
1622
+ /**
1623
+ * @internal
1624
+ * Limited to Microsoft-internal use
1625
+ */
1591
1626
  function deepFreeze(obj) {
1592
1627
  Object.keys(obj).forEach(function (prop) {
1593
1628
  if (typeof obj[prop] === 'object') {
@@ -1604,6 +1639,7 @@ function deepFreeze(obj) {
1604
1639
  * @returns
1605
1640
  *
1606
1641
  * @internal
1642
+ * Limited to Microsoft-internal use
1607
1643
  */
1608
1644
  function callCallbackWithErrorOrResultFromPromiseAndReturnPromise(funcHelper, callback) {
1609
1645
  // eslint-disable-next-line @typescript-eslint/no-explicit-any
@@ -1638,6 +1674,7 @@ function callCallbackWithErrorOrResultFromPromiseAndReturnPromise(funcHelper, ca
1638
1674
  * @param args
1639
1675
  * @returns
1640
1676
  * @internal
1677
+ * Limited to Microsoft-internal use
1641
1678
  */
1642
1679
  function callCallbackWithErrorOrBooleanFromPromiseAndReturnPromise(funcHelper, callback) {
1643
1680
  // eslint-disable-next-line @typescript-eslint/no-explicit-any
@@ -1670,7 +1707,9 @@ function callCallbackWithErrorOrBooleanFromPromiseAndReturnPromise(funcHelper, c
1670
1707
  * @param callback
1671
1708
  * @param args
1672
1709
  * @returns
1710
+ *
1673
1711
  * @internal
1712
+ * Limited to Microsoft-internal use
1674
1713
  */
1675
1714
  function callCallbackWithSdkErrorFromPromiseAndReturnPromise(funcHelper, callback) {
1676
1715
  // eslint-disable-next-line @typescript-eslint/no-explicit-any
@@ -1705,6 +1744,7 @@ function callCallbackWithSdkErrorFromPromiseAndReturnPromise(funcHelper, callbac
1705
1744
  * @returns
1706
1745
  *
1707
1746
  * @internal
1747
+ * Limited to Microsoft-internal use
1708
1748
  */
1709
1749
  function callCallbackWithErrorOrResultOrNullFromPromiseAndReturnPromise(funcHelper, callback) {
1710
1750
  // eslint-disable-next-line @typescript-eslint/no-explicit-any
@@ -1741,6 +1781,7 @@ function callCallbackWithErrorOrResultOrNullFromPromiseAndReturnPromise(funcHelp
1741
1781
  * if the initial action didn't complete within provided timeout.
1742
1782
  *
1743
1783
  * @internal
1784
+ * Limited to Microsoft-internal use
1744
1785
  */
1745
1786
  function runWithTimeout(action, timeoutInMs, timeoutError) {
1746
1787
  return new Promise(function (resolve, reject) {
@@ -1756,6 +1797,10 @@ function runWithTimeout(action, timeoutInMs, timeoutError) {
1756
1797
  });
1757
1798
  });
1758
1799
  }
1800
+ /**
1801
+ * @internal
1802
+ * Limited to Microsoft-internal use
1803
+ */
1759
1804
  function createTeamsAppLink(params) {
1760
1805
  var url = new URL('https://teams.microsoft.com/l/entity/' +
1761
1806
  encodeURIComponent(params.appId) +
@@ -1776,7 +1821,10 @@ function createTeamsAppLink(params) {
1776
1821
 
1777
1822
 
1778
1823
 
1779
- /** @internal */
1824
+ /**
1825
+ * @internal
1826
+ * Limited to Microsoft-internal use
1827
+ */
1780
1828
  function ensureInitialized() {
1781
1829
  var expectedFrameContexts = [];
1782
1830
  for (var _i = 0; _i < arguments.length; _i++) {
@@ -1807,6 +1855,7 @@ function ensureInitialized() {
1807
1855
  * @param requiredVersion - SDK version required by the API
1808
1856
  *
1809
1857
  * @internal
1858
+ * Limited to Microsoft-internal use
1810
1859
  */
1811
1860
  function isCurrentSDKVersionAtLeast(requiredVersion) {
1812
1861
  if (requiredVersion === void 0) { requiredVersion = defaultSDKVersionForCompatCheck; }
@@ -1821,6 +1870,7 @@ function isCurrentSDKVersionAtLeast(requiredVersion) {
1821
1870
  * Helper function to identify if host client is either android or ios
1822
1871
  *
1823
1872
  * @internal
1873
+ * Limited to Microsoft-internal use
1824
1874
  */
1825
1875
  function isHostClientMobile() {
1826
1876
  return GlobalVars.hostClientType == HostClientType.android || GlobalVars.hostClientType == HostClientType.ios;
@@ -1832,6 +1882,7 @@ function isHostClientMobile() {
1832
1882
  * supported by platform or not. Null is returned in case of success.
1833
1883
  *
1834
1884
  * @internal
1885
+ * Limited to Microsoft-internal use
1835
1886
  */
1836
1887
  function throwExceptionIfMobileApiIsNotSupported(requiredVersion) {
1837
1888
  if (requiredVersion === void 0) { requiredVersion = defaultSDKVersionForCompatCheck; }
@@ -1850,6 +1901,7 @@ function throwExceptionIfMobileApiIsNotSupported(requiredVersion) {
1850
1901
  * which is used later for message source/origin validation
1851
1902
  *
1852
1903
  * @internal
1904
+ * Limited to Microsoft-internal use
1853
1905
  */
1854
1906
  function processAdditionalValidOrigins(validMessageOrigins) {
1855
1907
  var combinedOriginUrls = GlobalVars.additionalValidOrigins.concat(validMessageOrigins.filter(function (_origin) {
@@ -1866,137 +1918,6 @@ function processAdditionalValidOrigins(validMessageOrigins) {
1866
1918
  GlobalVars.additionalValidOrigins = combinedOriginUrls;
1867
1919
  }
1868
1920
 
1869
- ;// CONCATENATED MODULE: ./src/private/privateAPIs.ts
1870
- /* eslint-disable @typescript-eslint/no-explicit-any */
1871
-
1872
-
1873
-
1874
-
1875
-
1876
- /**
1877
- * @internal
1878
- */
1879
- function initializePrivateApis() {
1880
- // To maintain backwards compatability, this function cannot be deleted as it is callable
1881
- }
1882
- /**
1883
- * @hidden
1884
- * Hide from docs.
1885
- * ------
1886
- * Upload a custom App manifest directly to both team and personal scopes.
1887
- * This method works just for the first party Apps.
1888
- *
1889
- * @internal
1890
- */
1891
- function uploadCustomApp(manifestBlob, onComplete) {
1892
- ensureInitialized();
1893
- sendMessageToParent('uploadCustomApp', [manifestBlob], onComplete ? onComplete : getGenericOnCompleteHandler());
1894
- }
1895
- /**
1896
- * @hidden
1897
- * Internal use only
1898
- * Sends a custom action MessageRequest to host or parent window
1899
- *
1900
- * @param actionName - Specifies name of the custom action to be sent
1901
- * @param args - Specifies additional arguments passed to the action
1902
- * @param callback - Optionally specify a callback to receive response parameters from the parent
1903
- * @returns id of sent message
1904
- *
1905
- * @internal
1906
- */
1907
- function sendCustomMessage(actionName,
1908
- // tslint:disable-next-line:no-any
1909
- args,
1910
- // tslint:disable-next-line:no-any
1911
- callback) {
1912
- ensureInitialized();
1913
- sendMessageToParent(actionName, args, callback);
1914
- }
1915
- /**
1916
- * @hidden
1917
- * Internal use only
1918
- * Sends a custom action MessageEvent to a child iframe/window, only if you are not using auth popup.
1919
- * Otherwise it will go to the auth popup (which becomes the child)
1920
- *
1921
- * @param actionName - Specifies name of the custom action to be sent
1922
- * @param args - Specifies additional arguments passed to the action
1923
- * @returns id of sent message
1924
- *
1925
- * @internal
1926
- */
1927
- function sendCustomEvent(actionName,
1928
- // tslint:disable-next-line:no-any
1929
- args) {
1930
- ensureInitialized();
1931
- //validate childWindow
1932
- if (!Communication.childWindow) {
1933
- throw new Error('The child window has not yet been initialized or is not present');
1934
- }
1935
- sendMessageEventToChild(actionName, args);
1936
- }
1937
- /**
1938
- * @hidden
1939
- * Internal use only
1940
- * Adds a handler for an action sent by a child window or parent window
1941
- *
1942
- * @param actionName - Specifies name of the action message to handle
1943
- * @param customHandler - The callback to invoke when the action message is received. The return value is sent to the child
1944
- *
1945
- * @internal
1946
- */
1947
- function registerCustomHandler(actionName, customHandler) {
1948
- var _this = this;
1949
- ensureInitialized();
1950
- registerHandler(actionName, function () {
1951
- var args = [];
1952
- for (var _i = 0; _i < arguments.length; _i++) {
1953
- args[_i] = arguments[_i];
1954
- }
1955
- return customHandler.apply(_this, args);
1956
- });
1957
- }
1958
- /**
1959
- * @hidden
1960
- * register a handler to be called when a user setting changes. The changed setting type & value is provided in the callback.
1961
- *
1962
- * @param settingTypes - List of user setting changes to subscribe
1963
- * @param handler - When a subscribed setting is updated this handler is called
1964
- *
1965
- * @internal
1966
- */
1967
- function registerUserSettingsChangeHandler(settingTypes, handler) {
1968
- ensureInitialized();
1969
- registerHandler('userSettingsChange', handler, true, [settingTypes]);
1970
- }
1971
- /**
1972
- * @hidden
1973
- * Hide from docs.
1974
- * ------
1975
- * Opens a client-friendly preview of the specified file.
1976
- *
1977
- * @param file - The file to preview.
1978
- */
1979
- function openFilePreview(filePreviewParameters) {
1980
- ensureInitialized(FrameContexts.content, FrameContexts.task);
1981
- var params = [
1982
- filePreviewParameters.entityId,
1983
- filePreviewParameters.title,
1984
- filePreviewParameters.description,
1985
- filePreviewParameters.type,
1986
- filePreviewParameters.objectUrl,
1987
- filePreviewParameters.downloadUrl,
1988
- filePreviewParameters.webPreviewUrl,
1989
- filePreviewParameters.webEditUrl,
1990
- filePreviewParameters.baseUrl,
1991
- filePreviewParameters.editFile,
1992
- filePreviewParameters.subEntityId,
1993
- filePreviewParameters.viewerAction,
1994
- filePreviewParameters.fileOpenPreference,
1995
- filePreviewParameters.conversationId,
1996
- ];
1997
- sendMessageToParent('openFilePreview', params);
1998
- }
1999
-
2000
1921
  ;// CONCATENATED MODULE: ./src/public/authentication.ts
2001
1922
 
2002
1923
 
@@ -2501,21 +2422,29 @@ var versionConstants = {
2501
2422
  capability: { teams: { fullTrust: { joinedTeams: {} } } },
2502
2423
  hostClientTypes: [
2503
2424
  HostClientType.android,
2425
+ HostClientType.desktop,
2426
+ HostClientType.ios,
2504
2427
  HostClientType.teamsRoomsAndroid,
2505
2428
  HostClientType.teamsPhones,
2506
2429
  HostClientType.teamsDisplays,
2430
+ HostClientType.web,
2507
2431
  ],
2508
2432
  },
2433
+ {
2434
+ capability: { webStorage: {} },
2435
+ hostClientTypes: [HostClientType.desktop],
2436
+ },
2509
2437
  ],
2510
2438
  '2.0.5': [
2511
2439
  {
2512
2440
  capability: { webStorage: {} },
2513
- hostClientTypes: [HostClientType.android, HostClientType.ios],
2441
+ hostClientTypes: [HostClientType.android, HostClientType.desktop, HostClientType.ios],
2514
2442
  },
2515
2443
  ],
2516
2444
  };
2517
2445
  /**
2518
2446
  * @internal
2447
+ * Limited to Microsoft-internal use
2519
2448
  *
2520
2449
  * Generates and returns a runtime configuration for host clients which are not on the latest host SDK version
2521
2450
  * and do not provide their own runtime config. Their supported capabilities are based on the highest
@@ -2547,12 +2476,11 @@ function applyRuntimeConfig(runtimeConfig) {
2547
2476
  }
2548
2477
  /**
2549
2478
  * @hidden
2550
- * Hide from docs.
2551
- * ------
2552
2479
  * Constant used to set minimum runtime configuration
2553
2480
  * while un-initializing an app in unit test case.
2554
2481
  *
2555
2482
  * @internal
2483
+ * Limited to Microsoft-internal use
2556
2484
  */
2557
2485
  var _minRuntimeConfigToUninitialize = {
2558
2486
  apiVersion: 1,
@@ -2590,10 +2518,11 @@ var dialog;
2590
2518
  /**
2591
2519
  * @hidden
2592
2520
  * Hide from docs because this function is only used during initialization
2593
- * ------------------
2521
+ *
2594
2522
  * Adds register handlers for messageForChild upon initialization and only in the tasks FrameContext. {@link FrameContexts.task}
2595
2523
  * Function is called during app initialization
2596
2524
  * @internal
2525
+ * Limited to Microsoft-internal use
2597
2526
  */
2598
2527
  function initialize() {
2599
2528
  registerHandler('messageForChild', handleDialogMessage, false);
@@ -2790,11 +2719,11 @@ var dialog;
2790
2719
  })(bot = dialog.bot || (dialog.bot = {}));
2791
2720
  /**
2792
2721
  * @hidden
2793
- * Hide from docs
2794
- * --------
2722
+ *
2795
2723
  * Convert UrlDialogInfo to DialogInfo to send the information to host in {@linkcode open} API.
2796
2724
  *
2797
2725
  * @internal
2726
+ * Limited to Microsoft-internal use
2798
2727
  */
2799
2728
  function getDialogInfoFromUrlDialogInfo(urlDialogInfo) {
2800
2729
  var dialogInfo = {
@@ -2809,11 +2738,11 @@ var dialog;
2809
2738
  dialog.getDialogInfoFromUrlDialogInfo = getDialogInfoFromUrlDialogInfo;
2810
2739
  /**
2811
2740
  * @hidden
2812
- * Hide from docs
2813
- * --------
2741
+ *
2814
2742
  * Convert BotUrlDialogInfo to DialogInfo to send the information to host in {@linkcode bot.open} API.
2815
2743
  *
2816
2744
  * @internal
2745
+ * Limited to Microsoft-internal use
2817
2746
  */
2818
2747
  function getDialogInfoFromBotUrlDialogInfo(botUrlDialogInfo) {
2819
2748
  var dialogInfo = {
@@ -3070,7 +2999,6 @@ var teamsCore;
3070
2999
 
3071
3000
 
3072
3001
 
3073
-
3074
3002
  /**
3075
3003
  * Namespace to interact with app initialization and lifecycle.
3076
3004
  *
@@ -3227,7 +3155,6 @@ var app_app;
3227
3155
  menus.initialize();
3228
3156
  pages.config.initialize();
3229
3157
  dialog.initialize();
3230
- initializePrivateApis();
3231
3158
  }
3232
3159
  // Handle additional valid message origins if specified
3233
3160
  if (Array.isArray(validMessageOrigins)) {
@@ -3238,11 +3165,10 @@ var app_app;
3238
3165
  }
3239
3166
  /**
3240
3167
  * @hidden
3241
- * Hide from docs.
3242
- * ------
3243
3168
  * Undocumented function used to set a mock window for unit tests
3244
3169
  *
3245
3170
  * @internal
3171
+ * Limited to Microsoft-internal use
3246
3172
  */
3247
3173
  function _initialize(hostWindow) {
3248
3174
  Communication.currentWindow = hostWindow;
@@ -3250,11 +3176,10 @@ var app_app;
3250
3176
  app._initialize = _initialize;
3251
3177
  /**
3252
3178
  * @hidden
3253
- * Hide from docs.
3254
- * ------
3255
3179
  * Undocumented function used to clear state between unit tests
3256
3180
  *
3257
3181
  * @internal
3182
+ * Limited to Microsoft-internal use
3258
3183
  */
3259
3184
  function _uninitialize() {
3260
3185
  if (!GlobalVars.initializeCalled) {
@@ -3368,6 +3293,7 @@ var app_app;
3368
3293
  * Transforms the Legacy Context object received from Messages to the structured app.Context object
3369
3294
  *
3370
3295
  * @internal
3296
+ * Limited to Microsoft-internal use
3371
3297
  */
3372
3298
  function transformLegacyContextToAppContext(legacyContext) {
3373
3299
  var context = {
@@ -3499,6 +3425,7 @@ var pages;
3499
3425
  * @param handler - The handler for placing focus within the application.
3500
3426
  *
3501
3427
  * @internal
3428
+ * Limited to Microsoft-internal use
3502
3429
  */
3503
3430
  function registerFocusEnterHandler(handler) {
3504
3431
  ensureInitialized();
@@ -3707,9 +3634,10 @@ var pages;
3707
3634
  /**
3708
3635
  * @hidden
3709
3636
  * Hide from docs because this function is only used during initialization
3710
- * ------------------
3637
+ *
3711
3638
  * Adds register handlers for settings.save and settings.remove upon initialization. Function is called in {@link app.initializeHelper}
3712
3639
  * @internal
3640
+ * Limited to Microsoft-internal use
3713
3641
  */
3714
3642
  function initialize() {
3715
3643
  registerHandler('settings.save', handleSave, false);
@@ -4038,6 +3966,7 @@ var browser = __webpack_require__(227);
4038
3966
  var topLevelLogger = (0,browser.debug)('teamsJs');
4039
3967
  /**
4040
3968
  * @internal
3969
+ * Limited to Microsoft-internal use
4041
3970
  *
4042
3971
  * Returns a logger for a given namespace, within the pre-defined top-level teamsJs namespace
4043
3972
  */
@@ -4060,14 +3989,20 @@ var __spreadArray = (undefined && undefined.__spreadArray) || function (to, from
4060
3989
 
4061
3990
 
4062
3991
  var handlersLogger = getLogger('handlers');
4063
- /** @internal */
3992
+ /**
3993
+ * @internal
3994
+ * Limited to Microsoft-internal use
3995
+ */
4064
3996
  var HandlersPrivate = /** @class */ (function () {
4065
3997
  function HandlersPrivate() {
4066
3998
  }
4067
3999
  HandlersPrivate.handlers = {};
4068
4000
  return HandlersPrivate;
4069
4001
  }());
4070
- /** @internal */
4002
+ /**
4003
+ * @internal
4004
+ * Limited to Microsoft-internal use
4005
+ */
4071
4006
  function initializeHandlers() {
4072
4007
  // ::::::::::::::::::::MicrosoftTeams SDK Internal :::::::::::::::::
4073
4008
  HandlersPrivate.handlers['themeChange'] = handleThemeChange;
@@ -4076,7 +4011,10 @@ function initializeHandlers() {
4076
4011
  pages.backStack._initialize();
4077
4012
  }
4078
4013
  var callHandlerLogger = handlersLogger.extend('callHandler');
4079
- /** @internal */
4014
+ /**
4015
+ * @internal
4016
+ * Limited to Microsoft-internal use
4017
+ */
4080
4018
  function callHandler(name, args) {
4081
4019
  var handler = HandlersPrivate.handlers[name];
4082
4020
  if (handler) {
@@ -4089,7 +4027,10 @@ function callHandler(name, args) {
4089
4027
  return [false, undefined];
4090
4028
  }
4091
4029
  }
4092
- /** @internal */
4030
+ /**
4031
+ * @internal
4032
+ * Limited to Microsoft-internal use
4033
+ */
4093
4034
  function registerHandler(name, handler, sendMessage, args) {
4094
4035
  if (sendMessage === void 0) { sendMessage = true; }
4095
4036
  if (args === void 0) { args = []; }
@@ -4101,7 +4042,10 @@ function registerHandler(name, handler, sendMessage, args) {
4101
4042
  delete HandlersPrivate.handlers[name];
4102
4043
  }
4103
4044
  }
4104
- /** @internal */
4045
+ /**
4046
+ * @internal
4047
+ * Limited to Microsoft-internal use
4048
+ */
4105
4049
  function removeHandler(name) {
4106
4050
  delete HandlersPrivate.handlers[name];
4107
4051
  }
@@ -4109,12 +4053,18 @@ function removeHandler(name) {
4109
4053
  function doesHandlerExist(name) {
4110
4054
  return HandlersPrivate.handlers[name] != null;
4111
4055
  }
4112
- /** @internal */
4056
+ /**
4057
+ * @internal
4058
+ * Limited to Microsoft-internal use
4059
+ */
4113
4060
  function handlers_registerOnThemeChangeHandler(handler) {
4114
4061
  HandlersPrivate.themeChangeHandler = handler;
4115
4062
  handler && sendMessageToParent('registerHandler', ['themeChange']);
4116
4063
  }
4117
- /** @internal */
4064
+ /**
4065
+ * @internal
4066
+ * Limited to Microsoft-internal use
4067
+ */
4118
4068
  function handleThemeChange(theme) {
4119
4069
  if (HandlersPrivate.themeChangeHandler) {
4120
4070
  HandlersPrivate.themeChangeHandler(theme);
@@ -4123,12 +4073,18 @@ function handleThemeChange(theme) {
4123
4073
  sendMessageEventToChild('themeChange', [theme]);
4124
4074
  }
4125
4075
  }
4126
- /** @internal */
4076
+ /**
4077
+ * @internal
4078
+ * Limited to Microsoft-internal use
4079
+ */
4127
4080
  function handlers_registerOnLoadHandler(handler) {
4128
4081
  HandlersPrivate.loadHandler = handler;
4129
4082
  handler && sendMessageToParent('registerHandler', ['load']);
4130
4083
  }
4131
- /** @internal */
4084
+ /**
4085
+ * @internal
4086
+ * Limited to Microsoft-internal use
4087
+ */
4132
4088
  function handleLoad(context) {
4133
4089
  if (HandlersPrivate.loadHandler) {
4134
4090
  HandlersPrivate.loadHandler(context);
@@ -4137,12 +4093,18 @@ function handleLoad(context) {
4137
4093
  sendMessageEventToChild('load', [context]);
4138
4094
  }
4139
4095
  }
4140
- /** @internal */
4096
+ /**
4097
+ * @internal
4098
+ * Limited to Microsoft-internal use
4099
+ */
4141
4100
  function handlers_registerBeforeUnloadHandler(handler) {
4142
4101
  HandlersPrivate.beforeUnloadHandler = handler;
4143
4102
  handler && sendMessageToParent('registerHandler', ['beforeUnload']);
4144
4103
  }
4145
- /** @internal */
4104
+ /**
4105
+ * @internal
4106
+ * Limited to Microsoft-internal use
4107
+ */
4146
4108
  function handleBeforeUnload() {
4147
4109
  var readyToUnload = function () {
4148
4110
  sendMessageToParent('readyToUnload', []);
@@ -4170,14 +4132,20 @@ var communication_spreadArray = (undefined && undefined.__spreadArray) || functi
4170
4132
 
4171
4133
 
4172
4134
  var communicationLogger = getLogger('communication');
4173
- /**@internal */
4135
+ /**
4136
+ * @internal
4137
+ * Limited to Microsoft-internal use
4138
+ */
4174
4139
  var Communication = /** @class */ (function () {
4175
4140
  function Communication() {
4176
4141
  }
4177
4142
  return Communication;
4178
4143
  }());
4179
4144
 
4180
- /**@internal */
4145
+ /**
4146
+ * @internal
4147
+ * Limited to Microsoft-internal use
4148
+ */
4181
4149
  var CommunicationPrivate = /** @class */ (function () {
4182
4150
  function CommunicationPrivate() {
4183
4151
  }
@@ -4188,7 +4156,10 @@ var CommunicationPrivate = /** @class */ (function () {
4188
4156
  CommunicationPrivate.promiseCallbacks = {};
4189
4157
  return CommunicationPrivate;
4190
4158
  }());
4191
- /**@internal */
4159
+ /**
4160
+ * @internal
4161
+ * Limited to Microsoft-internal use
4162
+ */
4192
4163
  function initializeCommunication(validMessageOrigins) {
4193
4164
  // Listen for messages post to our window
4194
4165
  CommunicationPrivate.messageListener = function (evt) { return processMessage(evt); };
@@ -4228,7 +4199,10 @@ function initializeCommunication(validMessageOrigins) {
4228
4199
  Communication.parentOrigin = null;
4229
4200
  }
4230
4201
  }
4231
- /**@internal */
4202
+ /**
4203
+ * @internal
4204
+ * Limited to Microsoft-internal use
4205
+ */
4232
4206
  function uninitializeCommunication() {
4233
4207
  Communication.currentWindow.removeEventListener('message', CommunicationPrivate.messageListener, false);
4234
4208
  Communication.parentWindow = null;
@@ -4240,7 +4214,10 @@ function uninitializeCommunication() {
4240
4214
  CommunicationPrivate.nextMessageId = 0;
4241
4215
  CommunicationPrivate.callbacks = {};
4242
4216
  }
4243
- /**@internal */
4217
+ /**
4218
+ * @internal
4219
+ * Limited to Microsoft-internal use
4220
+ */
4244
4221
  function sendAndUnwrap(actionName) {
4245
4222
  var args = [];
4246
4223
  for (var _i = 1; _i < arguments.length; _i++) {
@@ -4263,7 +4240,10 @@ function sendAndHandleStatusAndReason(actionName) {
4263
4240
  }
4264
4241
  });
4265
4242
  }
4266
- /**@internal */
4243
+ /**
4244
+ * @internal
4245
+ * Limited to Microsoft-internal use
4246
+ */
4267
4247
  function sendAndHandleStatusAndReasonWithDefaultError(actionName, defaultError) {
4268
4248
  var args = [];
4269
4249
  for (var _i = 2; _i < arguments.length; _i++) {
@@ -4276,7 +4256,10 @@ function sendAndHandleStatusAndReasonWithDefaultError(actionName, defaultError)
4276
4256
  }
4277
4257
  });
4278
4258
  }
4279
- /**@internal */
4259
+ /**
4260
+ * @internal
4261
+ * Limited to Microsoft-internal use
4262
+ */
4280
4263
  function sendAndHandleSdkError(actionName) {
4281
4264
  var args = [];
4282
4265
  for (var _i = 1; _i < arguments.length; _i++) {
@@ -4295,6 +4278,7 @@ function sendAndHandleSdkError(actionName) {
4295
4278
  * Send a message to parent. Uses nativeInterface on mobile to communicate with parent context
4296
4279
  *
4297
4280
  * @internal
4281
+ * Limited to Microsoft-internal use
4298
4282
  */
4299
4283
  function sendMessageToParentAsync(actionName, args) {
4300
4284
  if (args === void 0) { args = undefined; }
@@ -4303,13 +4287,19 @@ function sendMessageToParentAsync(actionName, args) {
4303
4287
  resolve(waitForResponse(request.id));
4304
4288
  });
4305
4289
  }
4306
- /**@internal */
4290
+ /**
4291
+ * @internal
4292
+ * Limited to Microsoft-internal use
4293
+ */
4307
4294
  function waitForResponse(requestId) {
4308
4295
  return new Promise(function (resolve) {
4309
4296
  CommunicationPrivate.promiseCallbacks[requestId] = resolve;
4310
4297
  });
4311
4298
  }
4312
- /**@internal */
4299
+ /**
4300
+ * @internal
4301
+ * Limited to Microsoft-internal use
4302
+ */
4313
4303
  function sendMessageToParent(actionName, argsOrCallback, callback) {
4314
4304
  var args;
4315
4305
  if (argsOrCallback instanceof Function) {
@@ -4324,7 +4314,10 @@ function sendMessageToParent(actionName, argsOrCallback, callback) {
4324
4314
  }
4325
4315
  }
4326
4316
  var sendMessageToParentHelperLogger = communicationLogger.extend('sendMessageToParentHelper');
4327
- /**@internal */
4317
+ /**
4318
+ * @internal
4319
+ * Limited to Microsoft-internal use
4320
+ */
4328
4321
  function sendMessageToParentHelper(actionName, args) {
4329
4322
  var logger = sendMessageToParentHelperLogger;
4330
4323
  var targetWindow = Communication.parentWindow;
@@ -4351,7 +4344,10 @@ function sendMessageToParentHelper(actionName, args) {
4351
4344
  }
4352
4345
  return request;
4353
4346
  }
4354
- /**@internal */
4347
+ /**
4348
+ * @internal
4349
+ * Limited to Microsoft-internal use
4350
+ */
4355
4351
  function processMessage(evt) {
4356
4352
  // Process only if we received a valid message
4357
4353
  if (!evt || !evt.data || typeof evt.data !== 'object') {
@@ -4379,6 +4375,7 @@ function processMessage(evt) {
4379
4375
  * Validates the message source and origin, if it should be processed
4380
4376
  *
4381
4377
  * @internal
4378
+ * Limited to Microsoft-internal use
4382
4379
  */
4383
4380
  function shouldProcessMessage(messageSource, messageOrigin) {
4384
4381
  // Process if message source is a different window and if origin is either in
@@ -4396,7 +4393,10 @@ function shouldProcessMessage(messageSource, messageOrigin) {
4396
4393
  return validateOrigin(new URL(messageOrigin));
4397
4394
  }
4398
4395
  }
4399
- /**@internal */
4396
+ /**
4397
+ * @internal
4398
+ * Limited to Microsoft-internal use
4399
+ */
4400
4400
  function updateRelationships(messageSource, messageOrigin) {
4401
4401
  // Determine whether the source of the message is our parent or child and update our
4402
4402
  // window and origin pointer accordingly
@@ -4426,7 +4426,10 @@ function updateRelationships(messageSource, messageOrigin) {
4426
4426
  flushMessageQueue(Communication.childWindow);
4427
4427
  }
4428
4428
  var handleParentMessageLogger = communicationLogger.extend('handleParentMessage');
4429
- /**@internal */
4429
+ /**
4430
+ * @internal
4431
+ * Limited to Microsoft-internal use
4432
+ */
4430
4433
  function handleParentMessage(evt) {
4431
4434
  var logger = handleParentMessageLogger;
4432
4435
  if ('id' in evt.data && typeof evt.data.id === 'number') {
@@ -4461,11 +4464,17 @@ function handleParentMessage(evt) {
4461
4464
  logger('Received an unknown message: %O', evt);
4462
4465
  }
4463
4466
  }
4464
- /**@internal */
4467
+ /**
4468
+ * @internal
4469
+ * Limited to Microsoft-internal use
4470
+ */
4465
4471
  function isPartialResponse(evt) {
4466
4472
  return evt.data.isPartialResponse === true;
4467
4473
  }
4468
- /**@internal */
4474
+ /**
4475
+ * @internal
4476
+ * Limited to Microsoft-internal use
4477
+ */
4469
4478
  function handleChildMessage(evt) {
4470
4479
  if ('id' in evt.data && 'func' in evt.data) {
4471
4480
  // Try to delegate the request to the proper handler, if defined
@@ -4490,7 +4499,10 @@ function handleChildMessage(evt) {
4490
4499
  }
4491
4500
  }
4492
4501
  }
4493
- /**@internal */
4502
+ /**
4503
+ * @internal
4504
+ * Limited to Microsoft-internal use
4505
+ */
4494
4506
  function getTargetMessageQueue(targetWindow) {
4495
4507
  return targetWindow === Communication.parentWindow
4496
4508
  ? CommunicationPrivate.parentMessageQueue
@@ -4498,7 +4510,10 @@ function getTargetMessageQueue(targetWindow) {
4498
4510
  ? CommunicationPrivate.childMessageQueue
4499
4511
  : [];
4500
4512
  }
4501
- /**@internal */
4513
+ /**
4514
+ * @internal
4515
+ * Limited to Microsoft-internal use
4516
+ */
4502
4517
  function getTargetOrigin(targetWindow) {
4503
4518
  return targetWindow === Communication.parentWindow
4504
4519
  ? Communication.parentOrigin
@@ -4507,7 +4522,10 @@ function getTargetOrigin(targetWindow) {
4507
4522
  : null;
4508
4523
  }
4509
4524
  var flushMessageQueueLogger = communicationLogger.extend('flushMessageQueue');
4510
- /**@internal */
4525
+ /**
4526
+ * @internal
4527
+ * Limited to Microsoft-internal use
4528
+ */
4511
4529
  function flushMessageQueue(targetWindow) {
4512
4530
  var targetOrigin = getTargetOrigin(targetWindow);
4513
4531
  var targetMessageQueue = getTargetMessageQueue(targetWindow);
@@ -4518,7 +4536,10 @@ function flushMessageQueue(targetWindow) {
4518
4536
  targetWindow.postMessage(request, targetOrigin);
4519
4537
  }
4520
4538
  }
4521
- /**@internal */
4539
+ /**
4540
+ * @internal
4541
+ * Limited to Microsoft-internal use
4542
+ */
4522
4543
  function waitForMessageQueue(targetWindow, callback) {
4523
4544
  var messageQueueMonitor = Communication.currentWindow.setInterval(function () {
4524
4545
  if (getTargetMessageQueue(targetWindow).length === 0) {
@@ -4532,6 +4553,7 @@ function waitForMessageQueue(targetWindow, callback) {
4532
4553
  * Send a response to child for a message request that was from child
4533
4554
  *
4534
4555
  * @internal
4556
+ * Limited to Microsoft-internal use
4535
4557
  */
4536
4558
  function sendMessageResponseToChild(id,
4537
4559
  // tslint:disable-next-line:no-any
@@ -4549,6 +4571,7 @@ args, isPartialResponse) {
4549
4571
  * instead of a response message to a child
4550
4572
  *
4551
4573
  * @internal
4574
+ * Limited to Microsoft-internal use
4552
4575
  */
4553
4576
  function sendMessageEventToChild(actionName,
4554
4577
  // tslint:disable-next-line: no-any
@@ -4565,7 +4588,10 @@ args) {
4565
4588
  getTargetMessageQueue(targetWindow).push(customEvent);
4566
4589
  }
4567
4590
  }
4568
- /**@internal */
4591
+ /**
4592
+ * @internal
4593
+ * Limited to Microsoft-internal use
4594
+ */
4569
4595
  // tslint:disable-next-line:no-any
4570
4596
  function createMessageRequest(func, args) {
4571
4597
  return {
@@ -4575,7 +4601,10 @@ function createMessageRequest(func, args) {
4575
4601
  args: args || [],
4576
4602
  };
4577
4603
  }
4578
- /**@internal */
4604
+ /**
4605
+ * @internal
4606
+ * Limited to Microsoft-internal use
4607
+ */
4579
4608
  // tslint:disable-next-line:no-any
4580
4609
  function createMessageResponse(id, args, isPartialResponse) {
4581
4610
  return {
@@ -4589,6 +4618,7 @@ function createMessageResponse(id, args, isPartialResponse) {
4589
4618
  * Creates a message object without any id, used for custom actions being sent to child frame/window
4590
4619
  *
4591
4620
  * @internal
4621
+ * Limited to Microsoft-internal use
4592
4622
  */
4593
4623
  // tslint:disable-next-line:no-any
4594
4624
  function createMessageEvent(func, args) {
@@ -4609,19 +4639,20 @@ function createMessageEvent(func, args) {
4609
4639
  * Namespace to interact with the logging part of the SDK.
4610
4640
  * This object is used to send the app logs on demand to the host client
4611
4641
  *
4612
- * Hide from docs
4613
- *
4614
4642
  * @internal
4643
+ * Limited to Microsoft-internal use
4615
4644
  */
4616
4645
  var logs;
4617
4646
  (function (logs) {
4618
4647
  /**
4619
4648
  * @hidden
4620
- * Hide from docs
4621
- * ------
4649
+ *
4622
4650
  * Registers a handler for getting app log
4623
4651
  *
4624
4652
  * @param handler - The handler to invoke to get the app log
4653
+ *
4654
+ * @internal
4655
+ * Limited to Microsoft-internal use
4625
4656
  */
4626
4657
  function registerGetLogHandler(handler) {
4627
4658
  ensureInitialized();
@@ -4639,6 +4670,14 @@ var logs;
4639
4670
  }
4640
4671
  }
4641
4672
  logs.registerGetLogHandler = registerGetLogHandler;
4673
+ /**
4674
+ * @hidden
4675
+ *
4676
+ * @returns boolean to represent whether the logs capability is supported
4677
+ *
4678
+ * @internal
4679
+ * Limited to Microsoft-internal use
4680
+ */
4642
4681
  function isSupported() {
4643
4682
  return runtime.supports.logs ? true : false;
4644
4683
  }
@@ -4646,6 +4685,12 @@ var logs;
4646
4685
  })(logs || (logs = {}));
4647
4686
 
4648
4687
  ;// CONCATENATED MODULE: ./src/private/interfaces.ts
4688
+ /**
4689
+ * @hidden
4690
+ *
4691
+ * @internal
4692
+ * Limited to Microsoft-internal use
4693
+ */
4649
4694
  var NotificationTypes;
4650
4695
  (function (NotificationTypes) {
4651
4696
  NotificationTypes["fileDownloadStart"] = "fileDownloadStart";
@@ -4653,33 +4698,166 @@ var NotificationTypes;
4653
4698
  })(NotificationTypes || (NotificationTypes = {}));
4654
4699
  /**
4655
4700
  * @hidden
4656
- * Hide from docs.
4701
+ *
4702
+ * @internal
4703
+ * Limited to Microsoft-internal use
4704
+ */
4705
+ var ViewerActionTypes;
4706
+ (function (ViewerActionTypes) {
4707
+ ViewerActionTypes["view"] = "view";
4708
+ ViewerActionTypes["edit"] = "edit";
4709
+ ViewerActionTypes["editNew"] = "editNew";
4710
+ })(ViewerActionTypes || (ViewerActionTypes = {}));
4711
+ /**
4712
+ * @hidden
4713
+ *
4714
+ * User setting changes that can be subscribed to
4715
+ */
4716
+ var UserSettingTypes;
4717
+ (function (UserSettingTypes) {
4718
+ /**
4719
+ * @hidden
4720
+ * Use this key to subscribe to changes in user's file open preference
4721
+ *
4722
+ * @internal
4723
+ * Limited to Microsoft-internal use
4724
+ */
4725
+ UserSettingTypes["fileOpenPreference"] = "fileOpenPreference";
4726
+ /**
4727
+ * @hidden
4728
+ * Use this key to subscribe to theme changes
4729
+ *
4730
+ * @internal
4731
+ * Limited to Microsoft-internal use
4732
+ */
4733
+ UserSettingTypes["theme"] = "theme";
4734
+ })(UserSettingTypes || (UserSettingTypes = {}));
4735
+
4736
+ ;// CONCATENATED MODULE: ./src/private/privateAPIs.ts
4737
+ /* eslint-disable @typescript-eslint/no-explicit-any */
4738
+
4739
+
4740
+
4741
+
4742
+
4743
+ /**
4744
+ * @hidden
4745
+ * Upload a custom App manifest directly to both team and personal scopes.
4746
+ * This method works just for the first party Apps.
4747
+ *
4748
+ * @internal
4749
+ * Limited to Microsoft-internal use
4750
+ */
4751
+ function uploadCustomApp(manifestBlob, onComplete) {
4752
+ ensureInitialized();
4753
+ sendMessageToParent('uploadCustomApp', [manifestBlob], onComplete ? onComplete : getGenericOnCompleteHandler());
4754
+ }
4755
+ /**
4756
+ * @hidden
4757
+ * Sends a custom action MessageRequest to host or parent window
4758
+ *
4759
+ * @param actionName - Specifies name of the custom action to be sent
4760
+ * @param args - Specifies additional arguments passed to the action
4761
+ * @param callback - Optionally specify a callback to receive response parameters from the parent
4762
+ * @returns id of sent message
4763
+ *
4764
+ * @internal
4765
+ * Limited to Microsoft-internal use
4766
+ */
4767
+ function sendCustomMessage(actionName,
4768
+ // tslint:disable-next-line:no-any
4769
+ args,
4770
+ // tslint:disable-next-line:no-any
4771
+ callback) {
4772
+ ensureInitialized();
4773
+ sendMessageToParent(actionName, args, callback);
4774
+ }
4775
+ /**
4776
+ * @hidden
4777
+ * Sends a custom action MessageEvent to a child iframe/window, only if you are not using auth popup.
4778
+ * Otherwise it will go to the auth popup (which becomes the child)
4779
+ *
4780
+ * @param actionName - Specifies name of the custom action to be sent
4781
+ * @param args - Specifies additional arguments passed to the action
4782
+ * @returns id of sent message
4783
+ *
4784
+ * @internal
4785
+ * Limited to Microsoft-internal use
4786
+ */
4787
+ function sendCustomEvent(actionName,
4788
+ // tslint:disable-next-line:no-any
4789
+ args) {
4790
+ ensureInitialized();
4791
+ //validate childWindow
4792
+ if (!Communication.childWindow) {
4793
+ throw new Error('The child window has not yet been initialized or is not present');
4794
+ }
4795
+ sendMessageEventToChild(actionName, args);
4796
+ }
4797
+ /**
4798
+ * @hidden
4799
+ * Adds a handler for an action sent by a child window or parent window
4800
+ *
4801
+ * @param actionName - Specifies name of the action message to handle
4802
+ * @param customHandler - The callback to invoke when the action message is received. The return value is sent to the child
4803
+ *
4804
+ * @internal
4805
+ * Limited to Microsoft-internal use
4806
+ */
4807
+ function registerCustomHandler(actionName, customHandler) {
4808
+ var _this = this;
4809
+ ensureInitialized();
4810
+ registerHandler(actionName, function () {
4811
+ var args = [];
4812
+ for (var _i = 0; _i < arguments.length; _i++) {
4813
+ args[_i] = arguments[_i];
4814
+ }
4815
+ return customHandler.apply(_this, args);
4816
+ });
4817
+ }
4818
+ /**
4819
+ * @hidden
4820
+ * register a handler to be called when a user setting changes. The changed setting type & value is provided in the callback.
4821
+ *
4822
+ * @param settingTypes - List of user setting changes to subscribe
4823
+ * @param handler - When a subscribed setting is updated this handler is called
4824
+ *
4825
+ * @internal
4826
+ * Limited to Microsoft-internal use
4657
4827
  */
4658
- var ViewerActionTypes;
4659
- (function (ViewerActionTypes) {
4660
- ViewerActionTypes["view"] = "view";
4661
- ViewerActionTypes["edit"] = "edit";
4662
- ViewerActionTypes["editNew"] = "editNew";
4663
- })(ViewerActionTypes || (ViewerActionTypes = {}));
4828
+ function registerUserSettingsChangeHandler(settingTypes, handler) {
4829
+ ensureInitialized();
4830
+ registerHandler('userSettingsChange', handler, true, [settingTypes]);
4831
+ }
4664
4832
  /**
4665
4833
  * @hidden
4666
- * Hide from docs.
4667
- * ------
4668
- * User setting changes that can be subscribed to
4834
+ * Opens a client-friendly preview of the specified file.
4835
+ *
4836
+ * @param file - The file to preview.
4837
+ *
4838
+ * @internal
4839
+ * Limited to Microsoft-internal use
4669
4840
  */
4670
- var UserSettingTypes;
4671
- (function (UserSettingTypes) {
4672
- /**
4673
- * @hidden
4674
- * Use this key to subscribe to changes in user's file open preference
4675
- */
4676
- UserSettingTypes["fileOpenPreference"] = "fileOpenPreference";
4677
- /**
4678
- * @hidden
4679
- * Use this key to subscribe to theme changes
4680
- */
4681
- UserSettingTypes["theme"] = "theme";
4682
- })(UserSettingTypes || (UserSettingTypes = {}));
4841
+ function openFilePreview(filePreviewParameters) {
4842
+ ensureInitialized(FrameContexts.content, FrameContexts.task);
4843
+ var params = [
4844
+ filePreviewParameters.entityId,
4845
+ filePreviewParameters.title,
4846
+ filePreviewParameters.description,
4847
+ filePreviewParameters.type,
4848
+ filePreviewParameters.objectUrl,
4849
+ filePreviewParameters.downloadUrl,
4850
+ filePreviewParameters.webPreviewUrl,
4851
+ filePreviewParameters.webEditUrl,
4852
+ filePreviewParameters.baseUrl,
4853
+ filePreviewParameters.editFile,
4854
+ filePreviewParameters.subEntityId,
4855
+ filePreviewParameters.viewerAction,
4856
+ filePreviewParameters.fileOpenPreference,
4857
+ filePreviewParameters.conversationId,
4858
+ ];
4859
+ sendMessageToParent('openFilePreview', params);
4860
+ }
4683
4861
 
4684
4862
  ;// CONCATENATED MODULE: ./src/private/conversations.ts
4685
4863
 
@@ -4690,6 +4868,9 @@ var UserSettingTypes;
4690
4868
  /**
4691
4869
  * @hidden
4692
4870
  * Namespace to interact with the conversational subEntities inside the tab
4871
+ *
4872
+ * @internal
4873
+ * Limited to Microsoft-internal use
4693
4874
  */
4694
4875
  var conversations;
4695
4876
  (function (conversations) {
@@ -4700,6 +4881,9 @@ var conversations;
4700
4881
  * Allows the user to start or continue a conversation with each subentity inside the tab
4701
4882
  *
4702
4883
  * @returns Promise resolved upon completion
4884
+ *
4885
+ * @internal
4886
+ * Limited to Microsoft-internal use
4703
4887
  */
4704
4888
  function openConversation(openConversationRequest) {
4705
4889
  return new Promise(function (resolve) {
@@ -4740,9 +4924,11 @@ var conversations;
4740
4924
  conversations.openConversation = openConversation;
4741
4925
  /**
4742
4926
  * @hidden
4743
- * Hide from docs
4744
- * --------------
4927
+ *
4745
4928
  * Allows the user to close the conversation in the right pane
4929
+ *
4930
+ * @internal
4931
+ * Limited to Microsoft-internal use
4746
4932
  */
4747
4933
  function closeConversation() {
4748
4934
  ensureInitialized(FrameContexts.content);
@@ -4765,6 +4951,7 @@ var conversations;
4765
4951
  * @returns Promise resolved with information on all chat members
4766
4952
  *
4767
4953
  * @internal
4954
+ * Limited to Microsoft-internal use
4768
4955
  */
4769
4956
  function getChatMembers() {
4770
4957
  return new Promise(function (resolve) {
@@ -4776,6 +4963,12 @@ var conversations;
4776
4963
  });
4777
4964
  }
4778
4965
  conversations.getChatMembers = getChatMembers;
4966
+ /**
4967
+ * @returns boolean to represent whether conversations capability is supported
4968
+ *
4969
+ * @internal
4970
+ * Limited to Microsoft-internal use
4971
+ */
4779
4972
  function isSupported() {
4780
4973
  return runtime.supports.conversations ? true : false;
4781
4974
  }
@@ -5328,6 +5521,7 @@ var media;
5328
5521
  * Helper function to create a blob from media chunks based on their sequence
5329
5522
  *
5330
5523
  * @internal
5524
+ * Limited to Microsoft-internal use
5331
5525
  */
5332
5526
  function createFile(assembleAttachment, mimeType) {
5333
5527
  if (assembleAttachment == null || mimeType == null || assembleAttachment.length <= 0) {
@@ -5355,6 +5549,7 @@ function createFile(assembleAttachment, mimeType) {
5355
5549
  * Converts base 64 encoded string to byte array and then into an array of blobs
5356
5550
  *
5357
5551
  * @internal
5552
+ * Limited to Microsoft-internal use
5358
5553
  */
5359
5554
  function decodeAttachment(attachment, mimeType) {
5360
5555
  if (attachment == null || mimeType == null) {
@@ -5376,8 +5571,11 @@ function decodeAttachment(attachment, mimeType) {
5376
5571
  /**
5377
5572
  * @hidden
5378
5573
  * Function throws an SdkError if the media call is not supported on current mobile version, else undefined.
5574
+ *
5379
5575
  * @throws an SdkError if the media call is not supported
5576
+ *
5380
5577
  * @internal
5578
+ * Limited to Microsoft-internal use
5381
5579
  */
5382
5580
  function throwExceptionIfMediaCallIsNotSupportedOnMobile(mediaInputs) {
5383
5581
  if (isMediaCallForVideoAndImageInputs(mediaInputs)) {
@@ -5395,6 +5593,7 @@ function throwExceptionIfMediaCallIsNotSupportedOnMobile(mediaInputs) {
5395
5593
  * Function returns true if the app has registered to listen to video controller events, else false.
5396
5594
  *
5397
5595
  * @internal
5596
+ * Limited to Microsoft-internal use
5398
5597
  */
5399
5598
  function isVideoControllerRegistered(mediaInputs) {
5400
5599
  if (mediaInputs.mediaType == media.MediaType.Video &&
@@ -5409,6 +5608,7 @@ function isVideoControllerRegistered(mediaInputs) {
5409
5608
  * Returns true if the mediaInput params are valid and false otherwise
5410
5609
  *
5411
5610
  * @internal
5611
+ * Limited to Microsoft-internal use
5412
5612
  */
5413
5613
  function validateSelectMediaInputs(mediaInputs) {
5414
5614
  if (mediaInputs == null || mediaInputs.maxMediaCount > 10) {
@@ -5417,7 +5617,11 @@ function validateSelectMediaInputs(mediaInputs) {
5417
5617
  return true;
5418
5618
  }
5419
5619
  /**
5620
+ * @hidden
5420
5621
  * Returns true if the mediaInput params are called for mediatype Image and contains Image outputs formats, false otherwise
5622
+ *
5623
+ * @internal
5624
+ * Limited to Microsoft-internal use
5421
5625
  */
5422
5626
  function isMediaCallForImageOutputFormats(mediaInputs) {
5423
5627
  var _a;
@@ -6056,8 +6260,6 @@ var meeting;
6056
6260
  meeting.toggleIncomingClientAudio = toggleIncomingClientAudio;
6057
6261
  /**
6058
6262
  * @hidden
6059
- * Hide from docs
6060
- *
6061
6263
  * Allows an app to get the meeting details for the meeting
6062
6264
  *
6063
6265
  * @param callback - Callback contains 2 parameters, error and meetingDetailsResponse.
@@ -6065,6 +6267,7 @@ var meeting;
6065
6267
  * result can either contain a IMeetingDetailsResponse value, in case of a successful get or null when the get fails
6066
6268
  *
6067
6269
  * @internal
6270
+ * Limited to Microsoft-internal use
6068
6271
  */
6069
6272
  function getMeetingDetails(callback) {
6070
6273
  if (!callback) {
@@ -6083,6 +6286,7 @@ var meeting;
6083
6286
  * authenticationTokenOfAnonymousUser can either contain a string value, incase of a successful get or null when the get fails
6084
6287
  *
6085
6288
  * @internal
6289
+ * Limited to Microsoft-internal use
6086
6290
  */
6087
6291
  function getAuthenticationTokenForAnonymousUser(callback) {
6088
6292
  if (!callback) {
@@ -6465,6 +6669,7 @@ var people;
6465
6669
  * @returns true if the parameters are valid, false otherwise
6466
6670
  *
6467
6671
  * @internal
6672
+ * Limited to Microsoft-internal use
6468
6673
  */
6469
6674
  function validateShowProfileRequest(showProfileRequest) {
6470
6675
  if (!showProfileRequest) {
@@ -6492,6 +6697,7 @@ function validateShowProfileRequest(showProfileRequest) {
6492
6697
  * @returns true if the persona is valid, false otherwise
6493
6698
  *
6494
6699
  * @internal
6700
+ * Limited to Microsoft-internal use
6495
6701
  */
6496
6702
  function validatePersona(persona) {
6497
6703
  if (!persona) {
@@ -6816,8 +7022,6 @@ var stageView;
6816
7022
  ;// CONCATENATED MODULE: ./src/public/webStorage.ts
6817
7023
 
6818
7024
 
6819
-
6820
-
6821
7025
  /**
6822
7026
  * Contains functionality to allow web apps to store data in webview cache
6823
7027
  *
@@ -6834,10 +7038,6 @@ var webStorage;
6834
7038
  */
6835
7039
  function isWebStorageClearedOnUserLogOut() {
6836
7040
  ensureInitialized();
6837
- // return true as web storage is always cleared on desktop.
6838
- if (GlobalVars.hostClientType === HostClientType.desktop) {
6839
- return true;
6840
- }
6841
7041
  return isSupported();
6842
7042
  }
6843
7043
  webStorage.isWebStorageClearedOnUserLogOut = isWebStorageClearedOnUserLogOut;
@@ -6999,11 +7199,10 @@ function initialize(callback, validMessageOrigins) {
6999
7199
  * As of 2.0.0, please use {@link app._initialize app._initialize(hostWindow: any): void} instead.
7000
7200
  *
7001
7201
  * @hidden
7002
- * Hide from docs.
7003
- * ------
7004
7202
  * Undocumented function used to set a mock window for unit tests
7005
7203
  *
7006
7204
  * @internal
7205
+ * Limited to Microsoft-internal use
7007
7206
  */
7008
7207
  // eslint-disable-next-line
7009
7208
  function _initialize(hostWindow) {
@@ -7014,11 +7213,10 @@ function _initialize(hostWindow) {
7014
7213
  * As of 2.0.0, please use {@link app._uninitialize app._uninitialize(): void} instead.
7015
7214
  *
7016
7215
  * @hidden
7017
- * Hide from docs.
7018
- * ------
7019
7216
  * Undocumented function used to clear state between unit tests
7020
7217
  *
7021
7218
  * @internal
7219
+ * Limited to Microsoft-internal use
7022
7220
  */
7023
7221
  function _uninitialize() {
7024
7222
  app._uninitialize();
@@ -7707,17 +7905,21 @@ var tasks;
7707
7905
 
7708
7906
  /**
7709
7907
  * @hidden
7710
- * Hide from docs
7711
- * ------
7908
+ *
7712
7909
  * Namespace to interact with the files specific part of the SDK.
7910
+ *
7911
+ * @internal
7912
+ * Limited to Microsoft-internal use
7713
7913
  */
7714
7914
  var files;
7715
7915
  (function (files_1) {
7716
7916
  /**
7717
7917
  * @hidden
7718
- * Hide from docs
7719
- * ------
7918
+ *
7720
7919
  * Cloud storage providers registered with Microsoft Teams
7920
+ *
7921
+ * @internal
7922
+ * Limited to Microsoft-internal use
7721
7923
  */
7722
7924
  var CloudStorageProvider;
7723
7925
  (function (CloudStorageProvider) {
@@ -7730,9 +7932,11 @@ var files;
7730
7932
  })(CloudStorageProvider = files_1.CloudStorageProvider || (files_1.CloudStorageProvider = {}));
7731
7933
  /**
7732
7934
  * @hidden
7733
- * Hide from docs
7734
7935
  *
7735
7936
  * Cloud storage provider type enums
7937
+ *
7938
+ * @internal
7939
+ * Limited to Microsoft-internal use
7736
7940
  */
7737
7941
  var CloudStorageProviderType;
7738
7942
  (function (CloudStorageProviderType) {
@@ -7749,9 +7953,11 @@ var files;
7749
7953
  })(CloudStorageProviderType = files_1.CloudStorageProviderType || (files_1.CloudStorageProviderType = {}));
7750
7954
  /**
7751
7955
  * @hidden
7752
- * Hide from docs
7753
7956
  *
7754
7957
  * Special Document Library enum
7958
+ *
7959
+ * @internal
7960
+ * Limited to Microsoft-internal use
7755
7961
  */
7756
7962
  var SpecialDocumentLibraryType;
7757
7963
  (function (SpecialDocumentLibraryType) {
@@ -7759,9 +7965,11 @@ var files;
7759
7965
  })(SpecialDocumentLibraryType = files_1.SpecialDocumentLibraryType || (files_1.SpecialDocumentLibraryType = {}));
7760
7966
  /**
7761
7967
  * @hidden
7762
- * Hide from docs
7763
7968
  *
7764
7969
  * Document Library Access enum
7970
+ *
7971
+ * @internal
7972
+ * Limited to Microsoft-internal use
7765
7973
  */
7766
7974
  var DocumentLibraryAccessType;
7767
7975
  (function (DocumentLibraryAccessType) {
@@ -7769,9 +7977,11 @@ var files;
7769
7977
  })(DocumentLibraryAccessType = files_1.DocumentLibraryAccessType || (files_1.DocumentLibraryAccessType = {}));
7770
7978
  /**
7771
7979
  * @hidden
7772
- * Hide from docs
7773
7980
  *
7774
7981
  * Download status enum
7982
+ *
7983
+ * @internal
7984
+ * Limited to Microsoft-internal use
7775
7985
  */
7776
7986
  var FileDownloadStatus;
7777
7987
  (function (FileDownloadStatus) {
@@ -7784,6 +7994,9 @@ var files;
7784
7994
  * Hide from docs
7785
7995
  *
7786
7996
  * Actions specific to 3P cloud storage provider file and / or account
7997
+ *
7998
+ * @internal
7999
+ * Limited to Microsoft-internal use
7787
8000
  */
7788
8001
  var CloudStorageProviderFileAction;
7789
8002
  (function (CloudStorageProviderFileAction) {
@@ -7798,6 +8011,9 @@ var files;
7798
8011
  * Gets a list of cloud storage folders added to the channel
7799
8012
  * @param channelId - ID of the channel whose cloud storage folders should be retrieved
7800
8013
  * @param callback - Callback that will be triggered post folders load
8014
+ *
8015
+ * @internal
8016
+ * Limited to Microsoft-internal use
7801
8017
  */
7802
8018
  function getCloudStorageFolders(channelId, callback) {
7803
8019
  ensureInitialized(FrameContexts.content);
@@ -7818,6 +8034,9 @@ var files;
7818
8034
  *
7819
8035
  * @param channelId - ID of the channel to add cloud storage folder
7820
8036
  * @param callback - Callback that will be triggered post add folder flow is compelete
8037
+ *
8038
+ * @internal
8039
+ * Limited to Microsoft-internal use
7821
8040
  */
7822
8041
  function addCloudStorageFolder(channelId, callback) {
7823
8042
  ensureInitialized(FrameContexts.content);
@@ -7840,6 +8059,9 @@ var files;
7840
8059
  * @param channelId - ID of the channel where folder is to be deleted
7841
8060
  * @param folderToDelete - cloud storage folder to be deleted
7842
8061
  * @param callback - Callback that will be triggered post delete
8062
+ *
8063
+ * @internal
8064
+ * Limited to Microsoft-internal use
7843
8065
  */
7844
8066
  function deleteCloudStorageFolder(channelId, folderToDelete, callback) {
7845
8067
  ensureInitialized(FrameContexts.content);
@@ -7865,6 +8087,9 @@ var files;
7865
8087
  * @param folder - Cloud storage folder (CloudStorageFolder) / sub directory (CloudStorageFolderItem)
7866
8088
  * @param providerCode - Code of the cloud storage folder provider
7867
8089
  * @param callback - Callback that will be triggered post contents are loaded
8090
+ *
8091
+ * @internal
8092
+ * Limited to Microsoft-internal use
7868
8093
  */
7869
8094
  function getCloudStorageFolderContents(folder, providerCode, callback) {
7870
8095
  ensureInitialized(FrameContexts.content);
@@ -7890,6 +8115,9 @@ var files;
7890
8115
  * @param file - cloud storage file that should be opened
7891
8116
  * @param providerCode - Code of the cloud storage folder provider
7892
8117
  * @param fileOpenPreference - Whether file should be opened in web/inline
8118
+ *
8119
+ * @internal
8120
+ * Limited to Microsoft-internal use
7893
8121
  */
7894
8122
  function openCloudStorageFile(file, providerCode, fileOpenPreference) {
7895
8123
  ensureInitialized(FrameContexts.content);
@@ -7908,6 +8136,9 @@ var files;
7908
8136
  * third party cloud storage accounts that the tenant supports
7909
8137
  * @param excludeAddedProviders: return a list of support third party
7910
8138
  * cloud storages that hasn't been added yet.
8139
+ *
8140
+ * @internal
8141
+ * Limited to Microsoft-internal use
7911
8142
  */
7912
8143
  function getExternalProviders(excludeAddedProviders, callback) {
7913
8144
  if (excludeAddedProviders === void 0) { excludeAddedProviders = false; }
@@ -7922,6 +8153,9 @@ var files;
7922
8153
  * @hidden
7923
8154
  * Allow 1st party apps to call this function to move files
7924
8155
  * among SharePoint and third party cloud storages.
8156
+ *
8157
+ * @internal
8158
+ * Limited to Microsoft-internal use
7925
8159
  */
7926
8160
  function copyMoveFiles(selectedFiles, providerCode, destinationFolder, destinationProviderCode, isMove, callback) {
7927
8161
  if (isMove === void 0) { isMove = false; }
@@ -7951,6 +8185,9 @@ var files;
7951
8185
  *
7952
8186
  * Gets list of downloads for current user
7953
8187
  * @param callback Callback that will be triggered post downloads load
8188
+ *
8189
+ * @internal
8190
+ * Limited to Microsoft-internal use
7954
8191
  */
7955
8192
  function getFileDownloads(callback) {
7956
8193
  ensureInitialized(FrameContexts.content);
@@ -7967,6 +8204,9 @@ var files;
7967
8204
  * Open download preference folder if fileObjectId value is undefined else open folder containing the file with id fileObjectId
7968
8205
  * @param fileObjectId - Id of the file whose containing folder should be opened
7969
8206
  * @param callback Callback that will be triggered post open download folder/path
8207
+ *
8208
+ * @internal
8209
+ * Limited to Microsoft-internal use
7970
8210
  */
7971
8211
  function openDownloadFolder(fileObjectId, callback) {
7972
8212
  if (fileObjectId === void 0) { fileObjectId = undefined; }
@@ -7986,6 +8226,9 @@ var files;
7986
8226
  * for selected 3P provider is performed on success of which the selected 3P provider support is added for user
7987
8227
  *
7988
8228
  * @param callback Callback that will be triggered post add 3P cloud storage provider action
8229
+ *
8230
+ * @internal
8231
+ * Limited to Microsoft-internal use
7989
8232
  */
7990
8233
  function addCloudStorageProvider(callback) {
7991
8234
  ensureInitialized(FrameContexts.content);
@@ -8005,6 +8248,9 @@ var files;
8005
8248
  *
8006
8249
  * @param logoutRequest 3P cloud storage provider remove action request content
8007
8250
  * @param callback Callback that will be triggered post signout of 3P cloud storage provider action
8251
+ *
8252
+ * @internal
8253
+ * Limited to Microsoft-internal use
8008
8254
  */
8009
8255
  function removeCloudStorageProvider(logoutRequest, callback) {
8010
8256
  ensureInitialized(FrameContexts.content);
@@ -8025,6 +8271,9 @@ var files;
8025
8271
  *
8026
8272
  * @param addNewFileRequest 3P cloud storage provider add action request content
8027
8273
  * @param callback Callback that will be triggered post adding a new file flow is finished
8274
+ *
8275
+ * @internal
8276
+ * Limited to Microsoft-internal use
8028
8277
  */
8029
8278
  function addCloudStorageProviderFile(addNewFileRequest, callback) {
8030
8279
  ensureInitialized(FrameContexts.content);
@@ -8045,6 +8294,9 @@ var files;
8045
8294
  *
8046
8295
  * @param renameFileRequest 3P cloud storage provider rename action request content
8047
8296
  * @param callback Callback that will be triggered post renaming an existing file flow is finished
8297
+ *
8298
+ * @internal
8299
+ * Limited to Microsoft-internal use
8048
8300
  */
8049
8301
  function renameCloudStorageProviderFile(renameFileRequest, callback) {
8050
8302
  ensureInitialized(FrameContexts.content);
@@ -8066,6 +8318,9 @@ var files;
8066
8318
  *
8067
8319
  * @param deleteFileRequest 3P cloud storage provider delete action request content
8068
8320
  * @param callback Callback that will be triggered post deleting existing file(s) flow is finished
8321
+ *
8322
+ * @internal
8323
+ * Limited to Microsoft-internal use
8069
8324
  */
8070
8325
  function deleteCloudStorageProviderFile(deleteFileRequest, callback) {
8071
8326
  ensureInitialized(FrameContexts.content);
@@ -8090,6 +8345,9 @@ var files;
8090
8345
  *
8091
8346
  * @param downloadFileRequest 3P cloud storage provider download file(s) action request content
8092
8347
  * @param callback Callback that will be triggered post downloading existing file(s) flow is finished
8348
+ *
8349
+ * @internal
8350
+ * Limited to Microsoft-internal use
8093
8351
  */
8094
8352
  function downloadCloudStorageProviderFile(downloadFileRequest, callback) {
8095
8353
  ensureInitialized(FrameContexts.content);
@@ -8113,6 +8371,9 @@ var files;
8113
8371
  *
8114
8372
  * @param uploadFileRequest 3P cloud storage provider upload file(s) action request content
8115
8373
  * @param callback Callback that will be triggered post uploading file(s) flow is finished
8374
+ *
8375
+ * @internal
8376
+ * Limited to Microsoft-internal use
8116
8377
  */
8117
8378
  function uploadCloudStorageProviderFile(uploadFileRequest, callback) {
8118
8379
  ensureInitialized(FrameContexts.content);
@@ -8144,6 +8405,7 @@ var files;
8144
8405
  *
8145
8406
  * @param handler - When 3P cloud storage provider list is updated this handler is called
8146
8407
  *
8408
+ * @internal Limited to Microsoft-internal use
8147
8409
  */
8148
8410
  function registerCloudStorageProviderListChangeHandler(handler) {
8149
8411
  ensureInitialized();
@@ -8162,6 +8424,8 @@ var files;
8162
8424
  *
8163
8425
  * @param handler - When 3P cloud storage provider content is updated this handler is called
8164
8426
  *
8427
+ * @internal
8428
+ * Limited to Microsoft-internal use
8165
8429
  */
8166
8430
  function registerCloudStorageProviderContentChangeHandler(handler) {
8167
8431
  ensureInitialized();
@@ -8186,15 +8450,22 @@ var files;
8186
8450
 
8187
8451
 
8188
8452
 
8453
+ /**
8454
+ * @hidden
8455
+ *
8456
+ * @internal
8457
+ * Limited to Microsoft-internal use
8458
+ */
8189
8459
  var meetingRoom;
8190
8460
  (function (meetingRoom) {
8191
8461
  /**
8192
8462
  * @hidden
8193
- * Hide from docs
8194
- * ------
8195
8463
  * Fetch the meeting room info that paired with current client.
8196
8464
  *
8197
8465
  * @returns Promise resolved with meeting room info or rejected with SdkError value
8466
+ *
8467
+ * @internal
8468
+ * Limited to Microsoft-internal use
8198
8469
  */
8199
8470
  function getPairedMeetingRoomInfo() {
8200
8471
  return new Promise(function (resolve) {
@@ -8208,12 +8479,13 @@ var meetingRoom;
8208
8479
  meetingRoom.getPairedMeetingRoomInfo = getPairedMeetingRoomInfo;
8209
8480
  /**
8210
8481
  * @hidden
8211
- * Hide from docs
8212
- * ------
8213
8482
  * Send a command to paired meeting room.
8214
8483
  *
8215
8484
  * @param commandName The command name.
8216
8485
  * @returns Promise resolved upon completion or rejected with SdkError value
8486
+ *
8487
+ * @internal
8488
+ * Limited to Microsoft-internal use
8217
8489
  */
8218
8490
  function sendCommandToPairedMeetingRoom(commandName) {
8219
8491
  return new Promise(function (resolve) {
@@ -8230,12 +8502,13 @@ var meetingRoom;
8230
8502
  meetingRoom.sendCommandToPairedMeetingRoom = sendCommandToPairedMeetingRoom;
8231
8503
  /**
8232
8504
  * @hidden
8233
- * Hide from docs
8234
- * ------
8235
8505
  * Registers a handler for meeting room capabilities update.
8236
8506
  * Only one handler can be registered at a time. A subsequent registration replaces an existing registration.
8237
8507
  *
8238
8508
  * @param handler The handler to invoke when the capabilities of meeting room update.
8509
+ *
8510
+ * @internal
8511
+ * Limited to Microsoft-internal use
8239
8512
  */
8240
8513
  function registerMeetingRoomCapabilitiesUpdateHandler(handler) {
8241
8514
  if (!handler) {
@@ -8258,6 +8531,9 @@ var meetingRoom;
8258
8531
  * Only one handler can be registered at a time. A subsequent registration replaces an existing registration.
8259
8532
  *
8260
8533
  * @param handler The handler to invoke when the states of meeting room update.
8534
+ *
8535
+ * @internal
8536
+ * Limited to Microsoft-internal use
8261
8537
  */
8262
8538
  function registerMeetingRoomStatesUpdateHandler(handler) {
8263
8539
  if (!handler) {
@@ -8273,6 +8549,14 @@ var meetingRoom;
8273
8549
  });
8274
8550
  }
8275
8551
  meetingRoom.registerMeetingRoomStatesUpdateHandler = registerMeetingRoomStatesUpdateHandler;
8552
+ /**
8553
+ * @hidden
8554
+ *
8555
+ * @returns boolean to represent whether the meetingRoom capability is supported
8556
+ *
8557
+ * @internal
8558
+ * Limited to Microsoft-internal use
8559
+ */
8276
8560
  function isSupported() {
8277
8561
  return runtime.supports.meetingRoom ? true : false;
8278
8562
  }
@@ -8288,14 +8572,13 @@ var notifications;
8288
8572
  (function (notifications) {
8289
8573
  /**
8290
8574
  * @hidden
8291
- * Hide from docs.
8292
- * ------
8293
8575
  * display notification API.
8294
8576
  *
8295
8577
  * @param message - Notification message.
8296
8578
  * @param notificationType - Notification type
8297
8579
  *
8298
8580
  * @internal
8581
+ * Limited to Microsoft-internal use
8299
8582
  */
8300
8583
  function showNotification(showNotificationParameters) {
8301
8584
  ensureInitialized(FrameContexts.content);
@@ -8305,6 +8588,13 @@ var notifications;
8305
8588
  sendMessageToParent('notifications.showNotification', [showNotificationParameters]);
8306
8589
  }
8307
8590
  notifications.showNotification = showNotification;
8591
+ /**
8592
+ * @hidden
8593
+ * @returns boolean to represent whether the notifications capability is supported
8594
+ *
8595
+ * @internal
8596
+ * Limited to Microsoft-internal use
8597
+ */
8308
8598
  function isSupported() {
8309
8599
  return runtime.supports.notifications ? true : false;
8310
8600
  }
@@ -8317,13 +8607,20 @@ var notifications;
8317
8607
 
8318
8608
 
8319
8609
 
8610
+ /**
8611
+ * @hidden
8612
+ *
8613
+ * @internal
8614
+ * Limited to Microsoft-internal use
8615
+ */
8320
8616
  var remoteCamera;
8321
8617
  (function (remoteCamera) {
8322
8618
  /**
8323
8619
  * @hidden
8324
- * Hide from docs
8325
- * ------
8326
8620
  * Enum used to indicate possible camera control commands.
8621
+ *
8622
+ * @internal
8623
+ * Limited to Microsoft-internal use
8327
8624
  */
8328
8625
  var ControlCommand;
8329
8626
  (function (ControlCommand) {
@@ -8337,9 +8634,10 @@ var remoteCamera;
8337
8634
  })(ControlCommand = remoteCamera.ControlCommand || (remoteCamera.ControlCommand = {}));
8338
8635
  /**
8339
8636
  * @hidden
8340
- * Hide from docs
8341
- * ------
8342
8637
  * Enum used to indicate the reason for the error.
8638
+ *
8639
+ * @internal
8640
+ * Limited to Microsoft-internal use
8343
8641
  */
8344
8642
  var ErrorReason;
8345
8643
  (function (ErrorReason) {
@@ -8354,9 +8652,10 @@ var remoteCamera;
8354
8652
  })(ErrorReason = remoteCamera.ErrorReason || (remoteCamera.ErrorReason = {}));
8355
8653
  /**
8356
8654
  * @hidden
8357
- * Hide from docs
8358
- * ------
8359
8655
  * Enum used to indicate the reason the session was terminated.
8656
+ *
8657
+ * @internal
8658
+ * Limited to Microsoft-internal use
8360
8659
  */
8361
8660
  var SessionTerminatedReason;
8362
8661
  (function (SessionTerminatedReason) {
@@ -8374,14 +8673,15 @@ var remoteCamera;
8374
8673
  })(SessionTerminatedReason = remoteCamera.SessionTerminatedReason || (remoteCamera.SessionTerminatedReason = {}));
8375
8674
  /**
8376
8675
  * @hidden
8377
- * Hide from docs
8378
- * ------
8379
8676
  * Fetch a list of the participants with controllable-cameras in a meeting.
8380
8677
  *
8381
8678
  * @param callback - Callback contains 2 parameters, error and participants.
8382
8679
  * error can either contain an error of type SdkError, incase of an error, or null when fetch is successful
8383
8680
  * participants can either contain an array of Participant objects, incase of a successful fetch or null when it fails
8384
8681
  * participants: object that contains an array of participants with controllable-cameras
8682
+ *
8683
+ * @internal
8684
+ * Limited to Microsoft-internal use
8385
8685
  */
8386
8686
  function getCapableParticipants(callback) {
8387
8687
  if (!callback) {
@@ -8396,8 +8696,6 @@ var remoteCamera;
8396
8696
  remoteCamera.getCapableParticipants = getCapableParticipants;
8397
8697
  /**
8398
8698
  * @hidden
8399
- * Hide from docs
8400
- * ------
8401
8699
  * Request control of a participant's camera.
8402
8700
  *
8403
8701
  * @param participant - Participant specifies the participant to send the request for camera control.
@@ -8405,6 +8703,9 @@ var remoteCamera;
8405
8703
  * error can either contain an error of type SdkError, incase of an error, or null when fetch is successful
8406
8704
  * requestResponse can either contain the true/false value, incase of a successful request or null when it fails
8407
8705
  * requestResponse: True means request was accepted and false means request was denied
8706
+ *
8707
+ * @internal
8708
+ * Limited to Microsoft-internal use
8408
8709
  */
8409
8710
  function requestControl(participant, callback) {
8410
8711
  if (!participant) {
@@ -8422,12 +8723,13 @@ var remoteCamera;
8422
8723
  remoteCamera.requestControl = requestControl;
8423
8724
  /**
8424
8725
  * @hidden
8425
- * Hide from docs
8426
- * ------
8427
8726
  * Send control command to the participant's camera.
8428
8727
  *
8429
8728
  * @param ControlCommand - ControlCommand specifies the command for controling the camera.
8430
8729
  * @param callback - Callback to invoke when the command response returns.
8730
+ *
8731
+ * @internal
8732
+ * Limited to Microsoft-internal use
8431
8733
  */
8432
8734
  function sendControlCommand(ControlCommand, callback) {
8433
8735
  if (!ControlCommand) {
@@ -8445,11 +8747,12 @@ var remoteCamera;
8445
8747
  remoteCamera.sendControlCommand = sendControlCommand;
8446
8748
  /**
8447
8749
  * @hidden
8448
- * Hide from docs
8449
- * ------
8450
8750
  * Terminate the remote session
8451
8751
  *
8452
8752
  * @param callback - Callback to invoke when the command response returns.
8753
+ *
8754
+ * @internal
8755
+ * Limited to Microsoft-internal use
8453
8756
  */
8454
8757
  function terminateSession(callback) {
8455
8758
  if (!callback) {
@@ -8468,6 +8771,9 @@ var remoteCamera;
8468
8771
  * Only one handler can be registered at a time. A subsequent registration replaces an existing registration.
8469
8772
  *
8470
8773
  * @param handler - The handler to invoke when the list of participants with controllable-cameras changes.
8774
+ *
8775
+ * @internal
8776
+ * Limited to Microsoft-internal use
8471
8777
  */
8472
8778
  function registerOnCapableParticipantsChangeHandler(handler) {
8473
8779
  if (!handler) {
@@ -8486,6 +8792,9 @@ var remoteCamera;
8486
8792
  * Only one handler can be registered at a time. A subsequent registration replaces an existing registration.
8487
8793
  *
8488
8794
  * @param handler - The handler to invoke when there is an error from the camera handler.
8795
+ *
8796
+ * @internal
8797
+ * Limited to Microsoft-internal use
8489
8798
  */
8490
8799
  function registerOnErrorHandler(handler) {
8491
8800
  if (!handler) {
@@ -8504,6 +8813,9 @@ var remoteCamera;
8504
8813
  * Only one handler can be registered at a time. A subsequent registration replaces an existing registration.
8505
8814
  *
8506
8815
  * @param handler - The handler to invoke when the controlled device changes state.
8816
+ *
8817
+ * @internal
8818
+ * Limited to Microsoft-internal use
8507
8819
  */
8508
8820
  function registerOnDeviceStateChangeHandler(handler) {
8509
8821
  if (!handler) {
@@ -8522,6 +8834,9 @@ var remoteCamera;
8522
8834
  * Only one handler can be registered at a time. A subsequent registration replaces an existing registration.
8523
8835
  *
8524
8836
  * @param handler - The handler to invoke when the current session status changes.
8837
+ *
8838
+ * @internal
8839
+ * Limited to Microsoft-internal use
8525
8840
  */
8526
8841
  function registerOnSessionStatusChangeHandler(handler) {
8527
8842
  if (!handler) {
@@ -8534,6 +8849,13 @@ var remoteCamera;
8534
8849
  registerHandler('remoteCamera.sessionStatusChange', handler);
8535
8850
  }
8536
8851
  remoteCamera.registerOnSessionStatusChangeHandler = registerOnSessionStatusChangeHandler;
8852
+ /**
8853
+ * @hidden
8854
+ * @returns boolean to represent whether the remoteCamera capability is supported
8855
+ *
8856
+ * @internal
8857
+ * Limited to Microsoft-internal use
8858
+ */
8537
8859
  function isSupported() {
8538
8860
  return runtime.supports.remoteCamera ? true : false;
8539
8861
  }
@@ -8549,6 +8871,9 @@ var remoteCamera;
8549
8871
  /**
8550
8872
  * @hidden
8551
8873
  * Namespace to interact with the application entities specific part of the SDK.
8874
+ *
8875
+ * @internal
8876
+ * Limited to Microsoft-internal use
8552
8877
  */
8553
8878
  var appEntity;
8554
8879
  (function (appEntity_1) {
@@ -8564,6 +8889,9 @@ var appEntity;
8564
8889
  * @param callback Callback that will be triggered once the app entity information is available.
8565
8890
  * The callback takes two arguments: an SdkError in case something happened (i.e.
8566
8891
  * no permissions to execute the API) and the app entity configuration, if available
8892
+ *
8893
+ * @internal
8894
+ * Limited to Microsoft-internal use
8567
8895
  */
8568
8896
  function selectAppEntity(threadId, categories, subEntityId, callback) {
8569
8897
  ensureInitialized(FrameContexts.content);
@@ -8580,9 +8908,14 @@ var appEntity;
8580
8908
  }
8581
8909
  appEntity_1.selectAppEntity = selectAppEntity;
8582
8910
  /**
8911
+ * @hidden
8912
+ *
8583
8913
  * Checks if appEntity capability is supported by the host
8584
8914
  * @returns true if the appEntity capability is enabled in runtime.supports.appEntity and
8585
8915
  * false if it is disabled
8916
+ *
8917
+ * @internal
8918
+ * Limited to Microsoft-internal use
8586
8919
  */
8587
8920
  function isSupported() {
8588
8921
  return runtime.supports.appEntity ? true : false;
@@ -8601,10 +8934,9 @@ var appEntity;
8601
8934
  /**
8602
8935
  * @hidden
8603
8936
  * Namespace to interact with the `teams` specific part of the SDK.
8604
- * ------
8605
- * Hide from docs
8606
8937
  *
8607
8938
  * @internal
8939
+ * Limited to Microsoft-internal use
8608
8940
  */
8609
8941
  var teams;
8610
8942
  (function (teams) {
@@ -8616,11 +8948,12 @@ var teams;
8616
8948
  })(ChannelType = teams.ChannelType || (teams.ChannelType = {}));
8617
8949
  /**
8618
8950
  * @hidden
8619
- * Hide from docs
8620
- * ------
8621
8951
  * Get a list of channels belong to a Team
8622
8952
  *
8623
8953
  * @param groupId - a team's objectId
8954
+ *
8955
+ * @internal
8956
+ * Limited to Microsoft-internal use
8624
8957
  */
8625
8958
  function getTeamChannels(groupId, callback) {
8626
8959
  ensureInitialized(FrameContexts.content);
@@ -8643,6 +8976,9 @@ var teams;
8643
8976
  *
8644
8977
  * @param threadId - ID of the thread where the app entity will be created; if threadId is not
8645
8978
  * provided, the threadId from route params will be used.
8979
+ *
8980
+ * @internal
8981
+ * Limited to Microsoft-internal use
8646
8982
  */
8647
8983
  function refreshSiteUrl(threadId, callback) {
8648
8984
  ensureInitialized();
@@ -8664,6 +9000,9 @@ var teams;
8664
9000
  *
8665
9001
  * @returns true if the teams capability is enabled in runtime.supports.teams and
8666
9002
  * false if it is disabled
9003
+ *
9004
+ * @internal
9005
+ * Limited to Microsoft-internal use
8667
9006
  */
8668
9007
  function isSupported() {
8669
9008
  return runtime.supports.teams ? true : false;
@@ -8671,23 +9010,27 @@ var teams;
8671
9010
  teams.isSupported = isSupported;
8672
9011
  /**
8673
9012
  * @hidden
8674
- * Hide from docs
8675
- * ------
8676
- *
8677
9013
  * @internal
9014
+ * Limited to Microsoft-internal use
8678
9015
  */
8679
9016
  var fullTrust;
8680
9017
  (function (fullTrust) {
9018
+ /**
9019
+ * @hidden
9020
+ * @internal
9021
+ * Limited to Microsoft-internal use
9022
+ */
8681
9023
  var joinedTeams;
8682
9024
  (function (joinedTeams) {
8683
9025
  /**
8684
9026
  * @hidden
8685
- * Hide from docs
8686
- * ------
8687
9027
  * Allows an app to retrieve information of all user joined teams
8688
9028
  *
8689
9029
  * @param teamInstanceParameters - Optional flags that specify whether to scope call to favorite teams
8690
9030
  * @returns Promise that resolves with information about the user joined teams or rejects with an error when the operation has completed
9031
+ *
9032
+ * @internal
9033
+ * Limited to Microsoft-internal use
8691
9034
  */
8692
9035
  function getUserJoinedTeams(teamInstanceParameters) {
8693
9036
  return new Promise(function (resolve) {
@@ -8709,12 +9052,13 @@ var teams;
8709
9052
  joinedTeams.getUserJoinedTeams = getUserJoinedTeams;
8710
9053
  /**
8711
9054
  * @hidden
8712
- * Hide from docs
8713
- * ------
8714
9055
  * Checks if teams.fullTrust.joinedTeams capability is supported by the host
8715
9056
  *
8716
9057
  * @returns true if the teams.fullTrust.joinedTeams capability is enabled in
8717
9058
  * runtime.supports.teams.fullTrust.joinedTeams and false if it is disabled
9059
+ *
9060
+ * @internal
9061
+ * Limited to Microsoft-internal use
8718
9062
  */
8719
9063
  function isSupported() {
8720
9064
  return runtime.supports.teams
@@ -8729,12 +9073,13 @@ var teams;
8729
9073
  })(joinedTeams = fullTrust.joinedTeams || (fullTrust.joinedTeams = {}));
8730
9074
  /**
8731
9075
  * @hidden
8732
- * Hide from docs
8733
- * ------
8734
9076
  * Allows an app to get the configuration setting value
8735
9077
  *
8736
9078
  * @param key - The key for the config setting
8737
9079
  * @returns Promise that resolves with the value for the provided configuration setting or rejects with an error when the operation has completed
9080
+ *
9081
+ * @internal
9082
+ * Limited to Microsoft-internal use
8738
9083
  */
8739
9084
  function getConfigSetting(key) {
8740
9085
  return new Promise(function (resolve) {
@@ -8748,11 +9093,12 @@ var teams;
8748
9093
  fullTrust.getConfigSetting = getConfigSetting;
8749
9094
  /**
8750
9095
  * @hidden
8751
- * Hide from docs
8752
- * ------
8753
9096
  * Checks if teams.fullTrust capability is supported by the host
8754
9097
  * @returns true if the teams.fullTrust capability is enabled in runtime.supports.teams.fullTrust and
8755
9098
  * false if it is disabled
9099
+ *
9100
+ * @internal
9101
+ * Limited to Microsoft-internal use
8756
9102
  */
8757
9103
  function isSupported() {
8758
9104
  return runtime.supports.teams ? (runtime.supports.teams.fullTrust ? true : false) : false;