@microsoft/teams-js 2.0.0-beta.2-dev.7 → 2.0.0-beta.3-dev.3

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.
@@ -395,7 +395,7 @@ __webpack_require__.d(__webpack_exports__, {
395
395
  });
396
396
 
397
397
  ;// CONCATENATED MODULE: ./src/internal/constants.ts
398
- var version = '2.0.0-beta.2-dev.7';
398
+ var version = '2.0.0-beta.3-dev.3';
399
399
  /**
400
400
  * @hidden
401
401
  * The SDK version when all SDK APIs started to check platform compatibility for the APIs was 1.6.0.
@@ -1197,7 +1197,8 @@ var HostClientType;
1197
1197
  HostClientType["android"] = "android";
1198
1198
  HostClientType["ios"] = "ios";
1199
1199
  /**
1200
- * @deprecated Use teamsRoomsWindows instead.
1200
+ * @deprecated
1201
+ * As of 2.0.0-beta.1, please use {@link teamsRoomsWindows} instead.
1201
1202
  */
1202
1203
  HostClientType["rigel"] = "rigel";
1203
1204
  HostClientType["surfaceHub"] = "surfaceHub";
@@ -1256,7 +1257,8 @@ var DialogDimension;
1256
1257
  DialogDimension["Small"] = "small";
1257
1258
  })(DialogDimension || (DialogDimension = {}));
1258
1259
  /**
1259
- * @deprecated with TeamsJS v2 upgrades
1260
+ * @deprecated
1261
+ * As of 2.0.0-beta.1, please use {@link DialogDimension} instead.
1260
1262
  */
1261
1263
  // eslint-disable-next-line @typescript-eslint/no-unused-vars
1262
1264
  var TaskModuleDimension = DialogDimension;
@@ -1294,7 +1296,8 @@ var authentication;
1294
1296
  authentication.initialize = initialize;
1295
1297
  var authParams;
1296
1298
  /**
1297
- * @deprecated with Teams JS v2 upgrades
1299
+ * @deprecated
1300
+ * As of 2.0.0-beta.1.
1298
1301
  *
1299
1302
  * Registers the authentication Communication.handlers
1300
1303
  *
@@ -4619,27 +4622,32 @@ var call;
4619
4622
  ;// CONCATENATED MODULE: ./src/public/appInitialization.ts
4620
4623
 
4621
4624
  /**
4622
- * @deprecated with TeamsJS v2 upgrades
4625
+ * @deprecated
4626
+ * As of 2.0.0-beta.1, please use {@link app} namespace instead.
4623
4627
  */
4624
4628
  var appInitialization;
4625
4629
  (function (appInitialization) {
4626
4630
  /**
4627
- * @deprecated with TeamsJS v2 upgrades
4631
+ * @deprecated
4632
+ * As of 2.0.0-beta.1, please use {@link app.Messages} instead.
4628
4633
  */
4629
4634
  // eslint-disable-next-line @typescript-eslint/no-unused-vars
4630
4635
  appInitialization.Messages = app_app.Messages;
4631
4636
  /**
4632
- * @deprecated with TeamsJS v2 upgrades
4637
+ * @deprecated
4638
+ * As of 2.0.0-beta.1, please use {@link app.FailedReason} instead.
4633
4639
  */
4634
4640
  // eslint-disable-next-line @typescript-eslint/no-unused-vars
4635
4641
  appInitialization.FailedReason = app_app.FailedReason;
4636
4642
  /**
4637
- * @deprecated with TeamsJS v2 upgrades
4643
+ * @deprecated
4644
+ * As of 2.0.0-beta.1, please use {@link app.ExpectedFailureReason} instead.
4638
4645
  */
4639
4646
  // eslint-disable-next-line @typescript-eslint/no-unused-vars
4640
4647
  appInitialization.ExpectedFailureReason = app_app.ExpectedFailureReason;
4641
4648
  /**
4642
- * @deprecated with TeamsJS v2 upgrades
4649
+ * @deprecated
4650
+ * As of 2.0.0-beta.1, please use {@link app.notifyAppLoaded app.notifyAppLoaded(): void} instead.
4643
4651
  * Notifies the frame that app has loaded and to hide the loading indicator if one is shown.
4644
4652
  */
4645
4653
  function notifyAppLoaded() {
@@ -4647,7 +4655,8 @@ var appInitialization;
4647
4655
  }
4648
4656
  appInitialization.notifyAppLoaded = notifyAppLoaded;
4649
4657
  /**
4650
- * @deprecated with TeamsJS v2 upgrades
4658
+ * @deprecated
4659
+ * As of 2.0.0-beta.1, please use {@link app.notifySuccess app.notifySuccess(): void} instead.
4651
4660
  * Notifies the frame that app initialization is successful and is ready for user interaction.
4652
4661
  */
4653
4662
  function notifySuccess() {
@@ -4655,7 +4664,8 @@ var appInitialization;
4655
4664
  }
4656
4665
  appInitialization.notifySuccess = notifySuccess;
4657
4666
  /**
4658
- * @deprecated with TeamsJS v2 upgrades
4667
+ * @deprecated
4668
+ * As of 2.0.0-beta.1, please use {@link app.notifyFailure app.notifyFailure(appInitializationFailedRequest: IFailedRequest): void} instead.
4659
4669
  * Notifies the frame that app initialization has failed and to show an error page in its place.
4660
4670
  */
4661
4671
  function notifyFailure(appInitializationFailedRequest) {
@@ -4663,7 +4673,8 @@ var appInitialization;
4663
4673
  }
4664
4674
  appInitialization.notifyFailure = notifyFailure;
4665
4675
  /**
4666
- * @deprecated with TeamsJS v2 upgrades
4676
+ * @deprecated
4677
+ * As of 2.0.0-beta.1, please use {@link app.notifyExpectedFailure app.notifyExpectedFailure(expectedFailureRequest: IExpectedFailureRequest): void} instead.
4667
4678
  * Notifies the frame that app initialized with some expected errors.
4668
4679
  */
4669
4680
  function notifyExpectedFailure(expectedFailureRequest) {
@@ -4679,7 +4690,8 @@ var appInitialization;
4679
4690
 
4680
4691
 
4681
4692
  /**
4682
- * @deprecated with TeamsJS v2 upgrades
4693
+ * @deprecated
4694
+ * As of 2.0.0-beta.1, please use {@link app.initialize app.initialize(validMessageOrigins?: string[]): Promise\<void\>} instead.
4683
4695
  *
4684
4696
  * Initializes the library. This must be called before any other SDK calls
4685
4697
  * but after the frame is loaded successfully.
@@ -4695,7 +4707,8 @@ function initialize(callback, validMessageOrigins) {
4695
4707
  });
4696
4708
  }
4697
4709
  /**
4698
- * @deprecated with Teams JS v2 upgrades
4710
+ * @deprecated
4711
+ * As of 2.0.0-beta.1, please use {@link app._initialize app._initialize(hostWindow: any): void} instead.
4699
4712
  *
4700
4713
  * @hidden
4701
4714
  * Hide from docs.
@@ -4709,7 +4722,8 @@ function _initialize(hostWindow) {
4709
4722
  app._initialize(hostWindow);
4710
4723
  }
4711
4724
  /**
4712
- * @deprecated with Teams JS v2 upgrades
4725
+ * @deprecated
4726
+ * As of 2.0.0-beta.1, please use {@link app._uninitialize app._uninitialize(): void} instead.
4713
4727
  *
4714
4728
  * @hidden
4715
4729
  * Hide from docs.
@@ -4722,7 +4736,8 @@ function _uninitialize() {
4722
4736
  app._uninitialize();
4723
4737
  }
4724
4738
  /**
4725
- * @deprecated with Teams JS v2 upgrades
4739
+ * @deprecated
4740
+ * As of 2.0.0-beta.1, please use {@link teamsCore.enablePrintCapability teamsCore.enablePrintCapability(): void} instead.
4726
4741
  *
4727
4742
  * Enable print capability to support printing page using Ctrl+P and cmd+P
4728
4743
  */
@@ -4730,7 +4745,8 @@ function enablePrintCapability() {
4730
4745
  teamsCore.enablePrintCapability();
4731
4746
  }
4732
4747
  /**
4733
- * @deprecated with Teams JS v2 upgrades
4748
+ * @deprecated
4749
+ * As of 2.0.0-beta.1, please use {@link teamsCore.print teamsCore.print(): void} instead.
4734
4750
  *
4735
4751
  * Default print handler
4736
4752
  */
@@ -4738,7 +4754,8 @@ function print() {
4738
4754
  teamsCore.print();
4739
4755
  }
4740
4756
  /**
4741
- * @deprecated with Teams JS v2 upgrades
4757
+ * @deprecated
4758
+ * As of 2.0.0-beta.1, please use {@link app.getContext app.getContext(): Promise\<app.Context\>} instead.
4742
4759
  *
4743
4760
  * Retrieves the current context the frame is running in.
4744
4761
  *
@@ -4753,7 +4770,8 @@ function getContext(callback) {
4753
4770
  });
4754
4771
  }
4755
4772
  /**
4756
- * @deprecated with Teams JS v2 upgrades
4773
+ * @deprecated
4774
+ * As of 2.0.0-beta.1, please use {@link app.registerOnThemeChangeHandler app.registerOnThemeChangeHandler(handler: (theme: string) => void): void} instead.
4757
4775
  *
4758
4776
  * Registers a handler for theme changes.
4759
4777
  * Only one handler can be registered at a time. A subsequent registration replaces an existing registration.
@@ -4764,7 +4782,8 @@ function registerOnThemeChangeHandler(handler) {
4764
4782
  app_app.registerOnThemeChangeHandler(handler);
4765
4783
  }
4766
4784
  /**
4767
- * @deprecated with Teams JS v2 upgrades
4785
+ * @deprecated
4786
+ * As of 2.0.0-beta.1, please use {@link pages.registerFullScreenHandler pages.registerFullScreenHandler(handler: (isFullScreen: boolean) => void): void} instead.
4768
4787
  *
4769
4788
  * Registers a handler for changes from or to full-screen view for a tab.
4770
4789
  * Only one handler can be registered at a time. A subsequent registration replaces an existing registration.
@@ -4775,7 +4794,8 @@ function registerFullScreenHandler(handler) {
4775
4794
  pages.registerFullScreenHandler(handler);
4776
4795
  }
4777
4796
  /**
4778
- * @deprecated with Teams JS v2 upgrades
4797
+ * @deprecated
4798
+ * As of 2.0.0-beta.1, please use {@link pages.appButton.onClick pages.appButton.onClick(handler: () => void): void} instead.
4779
4799
  *
4780
4800
  * Registers a handler for clicking the app button.
4781
4801
  * Only one handler can be registered at a time. A subsequent registration replaces an existing registration.
@@ -4786,7 +4806,8 @@ function registerAppButtonClickHandler(handler) {
4786
4806
  pages.appButton.onClick(handler);
4787
4807
  }
4788
4808
  /**
4789
- * @deprecated with Teams JS v2 upgrades
4809
+ * @deprecated
4810
+ * As of 2.0.0-beta.1, please use {@link pages.appButton.onHoverEnter pages.appButton.onHoverEnter(handler: () => void): void} instead.
4790
4811
  *
4791
4812
  * Registers a handler for entering hover of the app button.
4792
4813
  * Only one handler can be registered at a time. A subsequent registration replaces an existing registration.
@@ -4797,7 +4818,8 @@ function registerAppButtonHoverEnterHandler(handler) {
4797
4818
  pages.appButton.onHoverEnter(handler);
4798
4819
  }
4799
4820
  /**
4800
- * @deprecated with Teams JS v2 upgrades
4821
+ * @deprecated
4822
+ * As of 2.0.0-beta.1, please use {@link pages.appButton.onHoverLeave pages.appButton.onHoverLeave(handler: () => void): void} instead.
4801
4823
  *
4802
4824
  * Registers a handler for exiting hover of the app button.
4803
4825
  * Only one handler can be registered at a time. A subsequent registration replaces an existing registration.
@@ -4808,7 +4830,8 @@ function registerAppButtonHoverLeaveHandler(handler) {
4808
4830
  pages.appButton.onHoverLeave(handler);
4809
4831
  }
4810
4832
  /**
4811
- * @deprecated with Teams JS v2 upgrades
4833
+ * @deprecated
4834
+ * As of 2.0.0-beta.1, please use {@link pages.backStack.registerBackButtonHandler pages.backStack.registerBackButtonHandler(handler: () => boolean): void} instead.
4812
4835
  *
4813
4836
  * Registers a handler for user presses of the Team client's back button. Experiences that maintain an internal
4814
4837
  * navigation stack should use this handler to navigate the user back within their frame. If an app finds
@@ -4821,7 +4844,8 @@ function registerBackButtonHandler(handler) {
4821
4844
  pages.backStack.registerBackButtonHandler(handler);
4822
4845
  }
4823
4846
  /**
4824
- * @deprecated with Teams JS v2 upgrades
4847
+ * @deprecated
4848
+ * As of 2.0.0-beta.1, please use {@link teamsCore.registerOnLoadHandler teamsCore.registerOnLoadHandler(handler: (context: LoadContext) => void): void} instead.
4825
4849
  *
4826
4850
  * @hidden
4827
4851
  * Registers a handler to be called when the page has been requested to load.
@@ -4832,7 +4856,8 @@ function registerOnLoadHandler(handler) {
4832
4856
  teamsCore.registerOnLoadHandler(handler);
4833
4857
  }
4834
4858
  /**
4835
- * @deprecated with Teams JS v2 upgrades
4859
+ * @deprecated
4860
+ * As of 2.0.0-beta.1, please use {@link teamsCore.registerBeforeUnloadHandler teamsCore.registerBeforeUnloadHandler(handler: (readyToUnload: () => void) => boolean): void} instead.
4836
4861
  *
4837
4862
  * @hidden
4838
4863
  * Registers a handler to be called before the page is unloaded.
@@ -4844,7 +4869,8 @@ function registerBeforeUnloadHandler(handler) {
4844
4869
  teamsCore.registerBeforeUnloadHandler(handler);
4845
4870
  }
4846
4871
  /**
4847
- * @deprecated with Teams JS v2 upgrades
4872
+ * @deprecated
4873
+ * As of 2.0.0-beta.1, please use {@link teamsCore.registerFocusEnterHandler teamsCore.registerFocusEnterHandler(handler: (navigateForward: boolean) => void): void} instead.
4848
4874
  *
4849
4875
  * @hidden
4850
4876
  * Registers a handler when focus needs to be passed from teams to the place of choice on app.
@@ -4855,7 +4881,8 @@ function registerFocusEnterHandler(handler) {
4855
4881
  teamsCore.registerFocusEnterHandler(handler);
4856
4882
  }
4857
4883
  /**
4858
- * @deprecated with Teams JS v2 upgrades
4884
+ * @deprecated
4885
+ * As of 2.0.0-beta.1, please use {@link pages.config.registerChangeConfigHandler pages.config.registerChangeConfigHandler(handler: () => void): void} instead.
4859
4886
  *
4860
4887
  * Registers a handler for when the user reconfigurated tab.
4861
4888
  *
@@ -4865,7 +4892,8 @@ function registerEnterSettingsHandler(handler) {
4865
4892
  pages.config.registerChangeConfigHandler(handler);
4866
4893
  }
4867
4894
  /**
4868
- * @deprecated with Teams JS v2 upgrades
4895
+ * @deprecated
4896
+ * As of 2.0.0-beta.1, please use {@link pages.tabs.getTabInstances pages.tabs.getTabInstances(tabInstanceParameters?: TabInstanceParameters): Promise\<TabInformation\>} instead.
4869
4897
  *
4870
4898
  * Allows an app to retrieve for this user tabs that are owned by this app.
4871
4899
  * If no TabInstanceParameters are passed, the app defaults to favorite teams and favorite channels.
@@ -4880,7 +4908,8 @@ function getTabInstances(callback, tabInstanceParameters) {
4880
4908
  });
4881
4909
  }
4882
4910
  /**
4883
- * @deprecated with Teams JS v2 upgrades
4911
+ * @deprecated
4912
+ * As of 2.0.0-beta.1, please use {@link pages.tabs.getMruTabInstances pages.tabs.getMruTabInstances(tabInstanceParameters?: TabInstanceParameters): Promise\<TabInformation\>} instead.
4884
4913
  *
4885
4914
  * Allows an app to retrieve the most recently used tabs for this user.
4886
4915
  *
@@ -4894,7 +4923,8 @@ function getMruTabInstances(callback, tabInstanceParameters) {
4894
4923
  });
4895
4924
  }
4896
4925
  /**
4897
- * @deprecated with Teams JS v2 upgrades
4926
+ * @deprecated
4927
+ * As of 2.0.0-beta.1, please use {@link core.shareDeepLink core.shareDeepLink(deepLinkParameters: DeepLinkParameters): void} instead.
4898
4928
  *
4899
4929
  * Shares a deep link that a user can use to navigate back to a specific state in this page.
4900
4930
  *
@@ -4904,7 +4934,8 @@ function shareDeepLink(deepLinkParameters) {
4904
4934
  core.shareDeepLink(deepLinkParameters);
4905
4935
  }
4906
4936
  /**
4907
- * @deprecated with Teams JS v2 upgrades
4937
+ * @deprecated
4938
+ * As of 2.0.0-beta.1, please use {@link core.executeDeepLink core.executeDeepLink(deepLink: string): Promise\<void\>} instead.
4908
4939
  *
4909
4940
  * Execute deep link API.
4910
4941
  *
@@ -4925,7 +4956,8 @@ function executeDeepLink(deepLink, onComplete) {
4925
4956
  });
4926
4957
  }
4927
4958
  /**
4928
- * @deprecated with Teams JS v2 upgrades
4959
+ * @deprecated
4960
+ * As of 2.0.0-beta.1, please use {@link pages.setCurrentFrame pages.setCurrentFrame(frameInfo: FrameInfo): void} instead.
4929
4961
  *
4930
4962
  * Set the current Frame Context
4931
4963
  *
@@ -4935,7 +4967,8 @@ function setFrameContext(frameContext) {
4935
4967
  pages.setCurrentFrame(frameContext);
4936
4968
  }
4937
4969
  /**
4938
- * @deprecated with Teams JS v2 upgrades
4970
+ * @deprecated
4971
+ * As of 2.0.0-beta.1, please use {@link pages.initializeWithFrameContext pages.initializeWithFrameContext(frameInfo: FrameInfo, callback?: () => void, validMessageOrigins?: string[],): void} instead.
4939
4972
  *
4940
4973
  * Initilize with FrameContext
4941
4974
  *
@@ -5030,7 +5063,8 @@ function transformAppContextToLegacyContext(appContext) {
5030
5063
  * Navigation specific part of the SDK.
5031
5064
  */
5032
5065
  /**
5033
- * @deprecated with Teams JS v2 upgrades
5066
+ * @deprecated
5067
+ * As of 2.0.0-beta.1, please use {@link pages.returnFocus pages.returnFocus(navigateForward?: boolean): void} instead.
5034
5068
  *
5035
5069
  * Return focus to the main Teams app. Will focus search bar if navigating foward and app bar if navigating back.
5036
5070
  *
@@ -5040,7 +5074,8 @@ function returnFocus(navigateForward) {
5040
5074
  pages.returnFocus(navigateForward);
5041
5075
  }
5042
5076
  /**
5043
- * @deprecated with Teams JS v2 upgrades
5077
+ * @deprecated
5078
+ * As of 2.0.0-beta.1, please use {@link pages.tabs.navigateToTab pages.tabs.navigateToTab(tabInstance: TabInstance): Promise\<void\>} instead.
5044
5079
  *
5045
5080
  * Navigates the Microsoft Teams app to the specified tab instance.
5046
5081
  *
@@ -5062,7 +5097,8 @@ function navigateToTab(tabInstance, onComplete) {
5062
5097
  });
5063
5098
  }
5064
5099
  /**
5065
- * @deprecated with Teams JS v2 upgrades
5100
+ * @deprecated
5101
+ * As of 2.0.0-beta.1, please use {@link pages.navigateCrossDomain pages.navigateCrossDomain(url: string): Promise\<void\>} instead.
5066
5102
  *
5067
5103
  * Navigates the frame to a new cross-domain URL. The domain of this URL must match at least one of the
5068
5104
  * valid domains specified in the validDomains block of the manifest; otherwise, an exception will be
@@ -5088,7 +5124,8 @@ function navigateCrossDomain(url, onComplete) {
5088
5124
  });
5089
5125
  }
5090
5126
  /**
5091
- * @deprecated with Teams JS v2 upgrades
5127
+ * @deprecated
5128
+ * As of 2.0.0-beta.1, please use {@link pages.backStack.navigateBack pages.backStack.navigateBack(): Promise\<void\>} instead.
5092
5129
  *
5093
5130
  * Navigates back in the Teams client.
5094
5131
  * See registerBackButtonHandler for more information on when it's appropriate to use this method.
@@ -5115,7 +5152,8 @@ function navigateBack(onComplete) {
5115
5152
 
5116
5153
 
5117
5154
  /**
5118
- * @deprecated with Teams JS v2 upgrades
5155
+ * @deprecated
5156
+ * As of 2.0.0-beta.1, please use {@link pages.config} namespace instead.
5119
5157
  *
5120
5158
  * Namespace to interact with the settings-specific part of the SDK.
5121
5159
  * This object is usable only on the settings frame.
@@ -5123,7 +5161,8 @@ function navigateBack(onComplete) {
5123
5161
  var settings;
5124
5162
  (function (settings) {
5125
5163
  /**
5126
- * @deprecated with Teams JS v2 upgrades
5164
+ * @deprecated
5165
+ * As of 2.0.0-beta.1, please use {@link pages.config.setValidityState pages.config.setValidityState(validityState: boolean): void} instead.
5127
5166
  *
5128
5167
  * Sets the validity state for the settings.
5129
5168
  * The initial value is false, so the user cannot save the settings until this is called with true.
@@ -5135,7 +5174,8 @@ var settings;
5135
5174
  }
5136
5175
  settings.setValidityState = setValidityState;
5137
5176
  /**
5138
- * @deprecated with Teams JS v2 upgrades
5177
+ * @deprecated
5178
+ * As of 2.0.0-beta.1, please use {@link pages.config.getConfig pages.config.getConfig(): Promise\<Config\>} instead.
5139
5179
  *
5140
5180
  * Gets the settings for the current instance.
5141
5181
  *
@@ -5149,7 +5189,8 @@ var settings;
5149
5189
  }
5150
5190
  settings.getSettings = getSettings;
5151
5191
  /**
5152
- * @deprecated with Teams JS v2 upgrades
5192
+ * @deprecated
5193
+ * As of 2.0.0-beta.1, please use {@link pages.config.setConfig pages.config.setConfig(instanceSettings: Config): Promise\<void\>} instead.
5153
5194
  *
5154
5195
  * Sets the settings for the current instance.
5155
5196
  * This is an asynchronous operation; calls to getSettings are not guaranteed to reflect the changed state.
@@ -5172,7 +5213,8 @@ var settings;
5172
5213
  }
5173
5214
  settings.setSettings = setSettings;
5174
5215
  /**
5175
- * @deprecated with Teams JS v2 upgrades
5216
+ * @deprecated
5217
+ * As of 2.0.0-beta.1, please use {@link pages.config.registerOnSaveHandler pages.config.registerOnSaveHandler(handler: (evt: SaveEvent) => void): void} instead.
5176
5218
  *
5177
5219
  * Registers a handler for when the user attempts to save the settings. This handler should be used
5178
5220
  * to create or update the underlying resource powering the content.
@@ -5186,7 +5228,8 @@ var settings;
5186
5228
  }
5187
5229
  settings.registerOnSaveHandler = registerOnSaveHandler;
5188
5230
  /**
5189
- * @deprecated with Teams JS v2 upgrades
5231
+ * @deprecated
5232
+ * As of 2.0.0-beta.1, please use {@link pages.config.registerOnRemoveHandler pages.config.registerOnRemoveHandler(handler: (evt: RemoveEvent) => void): void} instead.
5190
5233
  *
5191
5234
  * Registers a handler for user attempts to remove content. This handler should be used
5192
5235
  * to remove the underlying resource powering the content.
@@ -5206,7 +5249,8 @@ var settings;
5206
5249
 
5207
5250
 
5208
5251
  /**
5209
- * @deprecated with TeamsJS v2 upgrades
5252
+ * @deprecated
5253
+ * As of 2.0.0-beta.1, please use {@link dialog} namespace instead.
5210
5254
  *
5211
5255
  * Namespace to interact with the task module-specific part of the SDK.
5212
5256
  * This object is usable only on the content frame.
@@ -5215,7 +5259,8 @@ var settings;
5215
5259
  var tasks;
5216
5260
  (function (tasks) {
5217
5261
  /**
5218
- * @deprecated with TeamsJS v2 upgrades
5262
+ * @deprecated
5263
+ * As of 2.0.0-beta.1, please use {@link dialog.open dialog.open(dialogInfo: DialogInfo, submitHandler?: (err: string, result: string) => void): IAppWindow} instead.
5219
5264
  *
5220
5265
  * Allows an app to open the task module.
5221
5266
  *
@@ -5227,7 +5272,8 @@ var tasks;
5227
5272
  }
5228
5273
  tasks.startTask = startTask;
5229
5274
  /**
5230
- * @deprecated with TeamsJS v2 upgrades
5275
+ * @deprecated
5276
+ * As of 2.0.0-beta.1, please use {@link dialog.resize dialog.resize(dialogInfo: DialogInfo): void} instead.
5231
5277
  *
5232
5278
  * Update height/width task info properties.
5233
5279
  *
@@ -5238,7 +5284,8 @@ var tasks;
5238
5284
  }
5239
5285
  tasks.updateTask = updateTask;
5240
5286
  /**
5241
- * @deprecated with TeamsJS v2 upgrades
5287
+ * @deprecated
5288
+ * As of 2.0.0-beta.1, please use {@link dialog.submit dialog.submit(result?: string | object, appIds?: string | string[]): void} instead.
5242
5289
  *
5243
5290
  * Submit the task module.
5244
5291
  *
@@ -5334,19 +5381,47 @@ var files;
5334
5381
  CloudStorageProvider["Sharefile"] = "SHAREFILE";
5335
5382
  CloudStorageProvider["GoogleDrive"] = "GOOGLEDRIVE";
5336
5383
  CloudStorageProvider["Egnyte"] = "EGNYTE";
5384
+ CloudStorageProvider["SharePoint"] = "SharePoint";
5337
5385
  })(CloudStorageProvider = files.CloudStorageProvider || (files.CloudStorageProvider = {}));
5338
5386
  /**
5339
5387
  * @hidden
5340
5388
  * Hide from docs
5341
- * ------
5342
- * Cloud storage provider integration type
5389
+ *
5390
+ * Cloud storage provider type enums
5343
5391
  */
5344
5392
  var CloudStorageProviderType;
5345
5393
  (function (CloudStorageProviderType) {
5346
5394
  CloudStorageProviderType[CloudStorageProviderType["Sharepoint"] = 0] = "Sharepoint";
5347
5395
  CloudStorageProviderType[CloudStorageProviderType["WopiIntegration"] = 1] = "WopiIntegration";
5348
5396
  CloudStorageProviderType[CloudStorageProviderType["Google"] = 2] = "Google";
5397
+ CloudStorageProviderType[CloudStorageProviderType["OneDrive"] = 3] = "OneDrive";
5398
+ CloudStorageProviderType[CloudStorageProviderType["Recent"] = 4] = "Recent";
5399
+ CloudStorageProviderType[CloudStorageProviderType["Aggregate"] = 5] = "Aggregate";
5400
+ CloudStorageProviderType[CloudStorageProviderType["FileSystem"] = 6] = "FileSystem";
5401
+ CloudStorageProviderType[CloudStorageProviderType["Search"] = 7] = "Search";
5402
+ CloudStorageProviderType[CloudStorageProviderType["AllFiles"] = 8] = "AllFiles";
5403
+ CloudStorageProviderType[CloudStorageProviderType["SharedWithMe"] = 9] = "SharedWithMe";
5349
5404
  })(CloudStorageProviderType = files.CloudStorageProviderType || (files.CloudStorageProviderType = {}));
5405
+ /**
5406
+ * @hidden
5407
+ * Hide from docs
5408
+ *
5409
+ * Special Document Library enum
5410
+ */
5411
+ var SpecialDocumentLibraryType;
5412
+ (function (SpecialDocumentLibraryType) {
5413
+ SpecialDocumentLibraryType["ClassMaterials"] = "classMaterials";
5414
+ })(SpecialDocumentLibraryType = files.SpecialDocumentLibraryType || (files.SpecialDocumentLibraryType = {}));
5415
+ /**
5416
+ * @hidden
5417
+ * Hide from docs
5418
+ *
5419
+ * Document Library Access enum
5420
+ */
5421
+ var DocumentLibraryAccessType;
5422
+ (function (DocumentLibraryAccessType) {
5423
+ DocumentLibraryAccessType["Readonly"] = "readonly";
5424
+ })(DocumentLibraryAccessType = files.DocumentLibraryAccessType || (files.DocumentLibraryAccessType = {}));
5350
5425
  /**
5351
5426
  * @hidden
5352
5427
  * Hide from docs
@@ -5358,7 +5433,7 @@ var files;
5358
5433
  function getCloudStorageFolders(channelId) {
5359
5434
  return new Promise(function (resolve) {
5360
5435
  ensureInitialized(FrameContexts.content);
5361
- if (!channelId || channelId.length == 0) {
5436
+ if (!channelId || channelId.length === 0) {
5362
5437
  throw new Error('[files.getCloudStorageFolders] channelId name cannot be null or empty');
5363
5438
  }
5364
5439
  resolve(sendAndHandleSdkError('files.getCloudStorageFolders', channelId));
@@ -5375,7 +5450,7 @@ var files;
5375
5450
  function addCloudStorageFolder(channelId) {
5376
5451
  return new Promise(function (resolve) {
5377
5452
  ensureInitialized(FrameContexts.content);
5378
- if (!channelId || channelId.length == 0) {
5453
+ if (!channelId || channelId.length === 0) {
5379
5454
  throw new Error('[files.addCloudStorageFolder] channelId name cannot be null or empty');
5380
5455
  }
5381
5456
  resolve(sendMessageToParentAsync('files.addCloudStorageFolder', [channelId]));
@@ -5484,6 +5559,46 @@ var files;
5484
5559
  sendMessageToParent('openFilePreview', params);
5485
5560
  }
5486
5561
  files.openFilePreview = openFilePreview;
5562
+ /**
5563
+ * @hidden
5564
+ * Allow 1st party apps to call this function to get the external
5565
+ * third party cloud storage accounts that the tenant supports
5566
+ * @param excludeAddedProviders: return a list of support third party
5567
+ * cloud storages that hasn't been added yet.
5568
+ */
5569
+ function getExternalProviders(excludeAddedProviders) {
5570
+ if (excludeAddedProviders === void 0) { excludeAddedProviders = false; }
5571
+ return new Promise(function (resolve) {
5572
+ ensureInitialized(FrameContexts.content);
5573
+ resolve(sendAndHandleSdkError('files.getExternalProviders', excludeAddedProviders));
5574
+ });
5575
+ }
5576
+ files.getExternalProviders = getExternalProviders;
5577
+ /**
5578
+ * @hidden
5579
+ * Allow 1st party apps to call this function to move files
5580
+ * among SharePoint and third party cloud storages.
5581
+ */
5582
+ function copyMoveFiles(selectedFiles, providerCode, destinationFolder, destinationProviderCode, isMove) {
5583
+ if (isMove === void 0) { isMove = false; }
5584
+ return new Promise(function (resolve) {
5585
+ ensureInitialized(FrameContexts.content);
5586
+ if (!selectedFiles || selectedFiles.length === 0) {
5587
+ throw new Error('[files.copyMoveFiles] selectedFiles cannot be null or empty');
5588
+ }
5589
+ if (!providerCode) {
5590
+ throw new Error('[files.copyMoveFiles] providerCode cannot be null or empty');
5591
+ }
5592
+ if (!destinationFolder) {
5593
+ throw new Error('[files.copyMoveFiles] destinationFolder cannot be null or empty');
5594
+ }
5595
+ if (!destinationProviderCode) {
5596
+ throw new Error('[files.copyMoveFiles] destinationProviderCode cannot be null or empty');
5597
+ }
5598
+ resolve(sendAndHandleSdkError('files.copyMoveFiles', selectedFiles, providerCode, destinationFolder, destinationProviderCode, isMove));
5599
+ });
5600
+ }
5601
+ files.copyMoveFiles = copyMoveFiles;
5487
5602
  function isSupported() {
5488
5603
  return runtime.supports.files ? true : false;
5489
5604
  }