@microsoft/teams-js 2.17.0 → 2.17.1-beta.0

package/dist/MicrosoftTeams.d.ts

@@ -1104,7 +1104,7 @@ export namespace files {
             * @internal
             * Limited to Microsoft-internal use
             */
-        export function getExternalProviders(excludeAddedProviders: boolean, callback: (error: SdkError, providers: IExternalProvider[]) => void): void;
+        export function getExternalProviders(excludeAddedProviders: boolean | undefined, callback: (error: SdkError, providers: IExternalProvider[]) => void): void;
         /**
             * @hidden
             * Allow 1st party apps to call this function to move files
@@ -1113,7 +1113,7 @@ export namespace files {
             * @internal
             * Limited to Microsoft-internal use
             */
-        export function copyMoveFiles(selectedFiles: CloudStorageFolderItem[] | ISharePointFile[], providerCode: CloudStorageProvider, destinationFolder: CloudStorageFolderItem | ISharePointFile, destinationProviderCode: CloudStorageProvider, isMove: boolean, callback: (error?: SdkError) => void): void;
+        export function copyMoveFiles(selectedFiles: CloudStorageFolderItem[] | ISharePointFile[], providerCode: CloudStorageProvider, destinationFolder: CloudStorageFolderItem | ISharePointFile, destinationProviderCode: CloudStorageProvider, isMove: boolean | undefined, callback: (error?: SdkError) => void): void;
         /**
             * @hidden
             * Hide from docs
@@ -1137,7 +1137,7 @@ export namespace files {
             * @internal
             * Limited to Microsoft-internal use
             */
-        export function openDownloadFolder(fileObjectId: string, callback: (error?: SdkError) => void): void;
+        export function openDownloadFolder(fileObjectId: string | undefined, callback: (error?: SdkError) => void): void;
         /**
             * @hidden
             * Hide from docs
@@ -3790,6 +3790,9 @@ export interface ClipboardParams {
         content: string;
 }
 
+export function appInitializeHelper(apiVersionTag: string, validMessageOrigins?: string[]): Promise<void>;
+export function registerOnThemeChangeHandlerHelper(apiVersionTag: string, handler: app.themeHandler): void;
+export function openLinkHelper(apiVersionTag: string, deepLink: string): Promise<void>;
 /**
     * Namespace to interact with app initialization and lifecycle.
     */
@@ -4233,7 +4236,7 @@ export namespace app {
             * Gets the Frame Context that the App is running in. See {@link FrameContexts} for the list of possible values.
             * @returns the Frame Context.
             */
-        function getFrameContext(): FrameContexts;
+        function getFrameContext(): FrameContexts | undefined;
         /**
             * Initializes the library.
             *
@@ -4344,14 +4347,6 @@ export namespace app {
                     * @beta
                     */
                 function registerOnResumeHandler(handler: registerOnResumeHandlerFunctionType): void;
-                /**
-                    * Checks if app.lifecycle is supported by the host.
-                    * @returns boolean to represent whether the lifecycle capability is supported
-                    * @throws Error if {@linkcode app.initialize} has not successfully completed
-                    *
-                    * @beta
-                    */
-                function isSupported(): boolean;
         }
 }
 
@@ -4551,6 +4546,10 @@ export namespace clipboard {
         function isSupported(): boolean;
 }
 
+export function updateResizeHelper(apiVersionTag: string, dimensions: DialogSize): void;
+export function urlOpenHelper(apiVersionTag: string, urlDialogInfo: UrlDialogInfo, submitHandler?: dialog.DialogSubmitHandler, messageFromChildHandler?: dialog.PostMessageChannel): void;
+export function botUrlOpenHelper(apiVersionTag: string, urlDialogInfo: BotUrlDialogInfo, submitHandler?: dialog.DialogSubmitHandler, messageFromChildHandler?: dialog.PostMessageChannel): void;
+export function urlSubmitHelper(apiVersionTag: string, result?: string | object, appIds?: string | string[]): void;
 /**
     * This group of capabilities enables apps to show modal dialogs. There are two primary types of dialogs: URL-based dialogs and [Adaptive Card](https://learn.microsoft.com/adaptive-cards/) dialogs.
     * Both types of dialogs are shown on top of your app, preventing interaction with your app while they are displayed.
@@ -4920,6 +4919,14 @@ export namespace geoLocation {
   */
 export function getAdaptiveCardSchemaVersion(): AdaptiveCardVersion | undefined;
 
+export function navigateCrossDomainHelper(apiVersionTag: string, url: string): Promise<void>;
+export function backStackNavigateBackHelper(apiVersionTag: string): Promise<void>;
+export function tabsNavigateToTabHelper(apiVersionTag: string, tabInstance: TabInstance): Promise<void>;
+export function returnFocusHelper(apiVersionTag: string, navigateForward?: boolean): void;
+export function getTabInstancesHelper(apiVersionTag: string, tabInstanceParameters?: TabInstanceParameters): Promise<TabInformation>;
+export function getMruTabInstancesHelper(apiVersionTag: string, tabInstanceParameters?: TabInstanceParameters): Promise<TabInformation>;
+export function shareDeepLinkHelper(apiVersionTag: string, deepLinkParameters: ShareDeepLinkParameters): void;
+export function setCurrentFrameHelper(apiVersionTag: string, frameInfo: FrameInfo): void;
 /**
     * Navigation-specific part of the SDK.
     */
@@ -5255,11 +5262,11 @@ export namespace pages {
                     *
                     * @internal
                     * Limited to Microsoft-internal use
-                    *
+                    * @param apiVersionTag - The tag indicating API version number with name
                     * @param handler - The handler to invoke when the user presses the host client's back button.
                     * @param versionSpecificHelper - The helper function containing logic pertaining to a specific version of the API.
                     */
-                function registerBackButtonHandlerHelper(handler: () => boolean, versionSpecificHelper?: () => void): void;
+                function registerBackButtonHandlerHelper(apiVersionTag: string, handler: () => boolean, versionSpecificHelper?: () => void): void;
                 /**
                     * Checks if the pages.backStack capability is supported by the host
                     * @returns boolean to represent whether the pages.backStack capability is supported
@@ -5637,15 +5644,35 @@ export namespace menus {
     * Interact with media, including capturing and viewing images.
     */
 export namespace media {
-        /** Capture image callback function type. */
+        /**
+            * Function callback type used when calling {@link media.captureImage}.
+            *
+            * @param error - Error encountered during the API call, if any, {@link SdkError}
+            * @param files - Collection of File objects (images) captured by the user. Will be an empty array in the case of an error.
+            * */
         export type captureImageCallbackFunctionType = (error: SdkError, files: File[]) => void;
-        /** Select media callback function type. */
+        /**
+            * Function callback type used when calling {@link media.selectMedia}.
+            *
+            * @param error - Error encountered during the API call, if any, {@link SdkError}
+            * @param attachments - Collection of {@link Media} objects selected by the user. Will be an empty array in the case of an error.
+            * */
         export type selectMediaCallbackFunctionType = (error: SdkError, attachments: Media[]) => void;
         /** Error callback function type. */
         export type errorCallbackFunctionType = (error?: SdkError) => void;
-        /** Scan BarCode callback function type. */
+        /**
+            * Function callback type used when calling {@link media.scanBarCode}.
+            *
+            * @param error - Error encountered during the API call, if any, {@link SdkError}
+            * @param decodedText - Decoded text from the barcode, if any. In the case of an error, this will be the empty string.
+            * */
         export type scanBarCodeCallbackFunctionType = (error: SdkError, decodedText: string) => void;
-        /** Get media callback function type. */
+        /**
+            * Function callback type used when calling {@link media.Media.getMedia}
+            *
+            * @param error - Error encountered during the API call, if any, {@link SdkError}
+            * @param blob - Blob of media returned. Will be a blob with no BlobParts, in the case of an error.
+            * */
         export type getMediaCallbackFunctionType = (error: SdkError, blob: Blob) => void;
         /**
             * Enum for file formats supported
@@ -5858,7 +5885,7 @@ export namespace media {
             */
         abstract class MediaController<T> {
                 /** Callback that can be registered to handle events related to the playback and control of video content. */
-                protected controllerCallback: T;
+                protected controllerCallback?: T;
                 constructor(controllerCallback?: T);
                 protected abstract getMediaType(): MediaType;
                 /**