@types/office-js 1.0.448 → 1.0.450

office-js/README.md

@@ -8,7 +8,7 @@ This package contains type definitions for office-js (https://github.com/OfficeD
 Files were exported from https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/office-js.
 
 ### Additional Details
- * Last updated: Tue, 19 Nov 2024 21:02:30 GMT
+ * Last updated: Tue, 03 Dec 2024 09:35:08 GMT
  * Dependencies: none
 
 # Credits

office-js/index.d.ts

@@ -3515,8 +3515,6 @@ declare namespace Office {
          *
          * **Important**: In Outlook, this API isn't supported if the add-in is loaded in an Outlook.com or Gmail mailbox.
          *
-         * **Warning**: `getAccessTokenAsync` has been deprecated. Use `Office.auth.getAccessToken` instead.
-         *
          * @deprecated Use `Office.auth.getAccessToken` instead.
          *
          * @remarks
@@ -3540,8 +3538,6 @@ declare namespace Office {
          *
          * **Important**: In Outlook, this API isn't supported if the add-in is loaded in an Outlook.com or Gmail mailbox.
          *
-         * **Warning**: `getAccessTokenAsync` has been deprecated. Use `Office.auth.getAccessToken` instead.
-         *
          * @deprecated Use `Office.auth.getAccessToken` instead.
          *
          * @remarks
@@ -3612,8 +3608,6 @@ declare namespace Office {
         /**
          * Prompts the user to add their Office account (or to switch to it, if it is already added). Default value is `false`.
          *
-         * **Warning**: `forceAddAccount` has been deprecated. Use `allowSignInPrompt` instead.
-         *
          * @deprecated Use `allowSignInPrompt` instead.
          */
         forceAddAccount?: boolean;
@@ -3621,8 +3615,6 @@ declare namespace Office {
          * Causes Office to display the add-in consent experience. Useful if the add-in's Azure permissions have changed or if the user's consent has
          * been revoked. Default value is `false`.
          *
-         * **Warning**: `forceConsent` has been deprecated. Use `allowConsentPrompt` instead.
-         *
          * @deprecated Use `allowConsentPrompt` instead.
          */
         forceConsent?: boolean;
@@ -7161,8 +7153,6 @@ declare namespace Office {
         /**
          * Check if the specified requirement set is supported by the Office application.
          *
-         * **Warning**: This overload of `isSetSupported` (where `minVersionNumber` is a number) has been deprecated. Use the string overload of `isSetSupported` instead.
-         *
          * @deprecated Use the string overload of `isSetSupported` instead.
          * @param name - The requirement set name (e.g., "ExcelApi").
          * @param minVersionNumber - The minimum required version (e.g., 1.4).
@@ -9335,9 +9325,9 @@ declare namespace Office {
          * method. If you're on an Outlook on Windows version that only supports the `postProcessingAction` property,
          * you must assign it different string values. For a list of supported string values, see
          * {@link https://learn.microsoft.com/javascript/api/outlook/office.spamreportingeventcompletedoptions#outlook-office-spamreportingeventcompletedoptions-postprocessingaction-member |
-        * Office.SpamReportingEventCompletedOptions.postProcessingAction}.
-        */
-       enum MoveSpamItemTo {
+         * Office.SpamReportingEventCompletedOptions.postProcessingAction}.
+         */
+        enum MoveSpamItemTo {
            /**
             * Specifies that a reported message is moved to a custom folder in the mailbox.
             */
@@ -9354,7 +9344,49 @@ declare namespace Office {
             * Specifies that a reported message remains in its current folder in the mailbox.
             */
            NoMove = "noMove"
-       }
+        }
+        /**
+         * Specifies the location from which an add-in wants to access data.
+         *
+         * @remarks
+         *
+         * **{@link https://learn.microsoft.com/office/dev/add-ins/outlook/outlook-add-ins-overview#extension-points | Applicable Outlook mode}**: Compose, Read
+         *
+         * **Important**: This enum is only supported in Outlook on Android and on iOS starting in Version 4.2443.0. To learn more about APIs supported in Outlook on mobile devices, see
+         * {@link https://learn.microsoft.com/office/dev/add-ins/outlook/outlook-mobile-apis | Outlook JavaScript APIs supported in Outlook on mobile devices}.
+         */
+        enum OpenLocation {
+            /**
+             * A location associated with an account within an add-in.
+             */
+            AccountDocument,
+            /**
+             * The device's camera.
+             */
+            Camera,
+            /**
+             * Local storage on a device.
+             */
+            Local,
+            /**
+             * OneDrive for Business.
+             *
+             * **Important**: For OneDrive Personal, use OTHER.
+             */
+            OnedriveForBusiness,
+            /**
+             * Other cloud storage providers, including OneDrive Personal.
+             */
+            Other,
+            /**
+             * The device's photo library.
+             */
+            PhotoLibrary,
+            /**
+             * SharePoint. Includes both SharePoint Online and SharePoint on-premises (if accessed with a Microsoft Entra ID account).
+             */
+            SharePoint
+        }
         /**
          * Represents the current view of Outlook on the web.
          */
@@ -10061,6 +10093,56 @@ declare namespace Office {
              */
             Beta = "beta"
         }
+        /**
+         * Specifies the location in which an add-in wants to save data.
+         *
+         * @remarks
+         *
+         * **{@link https://learn.microsoft.com/office/dev/add-ins/outlook/outlook-add-ins-overview#extension-points | Applicable Outlook mode}**: Compose, Read
+         *
+         * **Important**: This enum is only supported in Outlook on Android and on iOS starting in Version 4.2443.0. To learn more about APIs supported in Outlook on mobile devices, see
+         * {@link https://learn.microsoft.com/office/dev/add-ins/outlook/outlook-mobile-apis | Outlook JavaScript APIs supported in Outlook on mobile devices}.
+         */
+        enum SaveLocation {
+            /**
+             * A location associated with an account within an add-in.
+             */
+            AccountDocument,
+            /**
+             * Box.
+             */
+            Box,
+            /**
+             * Dropbox.
+             */
+            Dropbox,
+            /**
+             * Google Drive.
+             */
+            GoogleDrive,
+            /**
+             * Local storage on a device.
+             */
+            Local,
+            /**
+             * OneDrive for Business.
+             *
+             * **Important**: For OneDrive Personal, use OTHER.
+             */
+            OnedriveForBusiness,
+            /**
+             * Other cloud storage providers, including OneDrive Personal.
+             */
+            Other,
+            /**
+             * The device's photo library.
+             */
+            PhotoLibrary,
+            /**
+             * SharePoint. Includes both SharePoint Online and SharePoint on-premises (if accessed with a Microsoft Entra ID account).
+             */
+            SharePoint
+        }
         /**
          * Specifies the {@link https://learn.microsoft.com/office/dev/add-ins/outlook/onmessagesend-onappointmentsend-events#available-send-mode-options | send mode option}
          * that overrides the option set in the manifest at runtime.
@@ -15597,6 +15679,73 @@ declare namespace Office {
          * @param userContext - Optional. Any state data that is passed to the asynchronous method.
          */
         getCallbackTokenAsync(callback: (asyncResult: Office.AsyncResult<string>) => void, userContext?: any): void;
+        /**
+         * Returns true if the current mailbox is managed by {@link https://learn.microsoft.com/mem/intune/fundamentals/what-is-intune | Microsoft Intune}.
+         *
+         * @remarks
+         *
+         * **{@link https://learn.microsoft.com/office/dev/add-ins/outlook/understanding-outlook-add-in-permissions | Minimum permission level}**: **read item**
+         *
+         * **{@link https://learn.microsoft.com/office/dev/add-ins/outlook/outlook-add-ins-overview#extension-points | Applicable Outlook mode}**: Compose, Read
+         *
+         * **Important**: This method is only supported in Outlook on Android and on iOS starting in Version 4.2443.0.To learn more about APIs supported in Outlook on mobile devices, see
+         * {@link https://learn.microsoft.com/office/dev/add-ins/outlook/outlook-mobile-apis | Outlook JavaScript APIs supported in Outlook on mobile devices}.
+         *
+         * **Errors**:
+         *
+         * - `MAMServiceNotAvailable`: The client is unable to fetch the mobile application management (MAM) policy.
+         *
+         * @returns True if the current mailbox is managed by Microsoft Intune.
+         */
+        getIsIdentityManaged(): boolean;
+        /**
+         * Returns true if an organization's {@link https://learn.microsoft.com/mem/intune/apps/app-management | Intune mobile application management (MAM) policy}
+         * allows an add-in to access data from the specified location.
+         *
+         * @remarks
+         *
+         * **{@link https://learn.microsoft.com/office/dev/add-ins/outlook/understanding-outlook-add-in-permissions | Minimum permission level}**: **read item**
+         *
+         * **{@link https://learn.microsoft.com/office/dev/add-ins/outlook/outlook-add-ins-overview#extension-points | Applicable Outlook mode}**: Compose, Read
+         *
+         * **Important**: This method is only supported in Outlook on Android and on iOS starting in Version 4.2443.0. To learn more about APIs supported in Outlook on mobile devices, see
+         * {@link https://learn.microsoft.com/office/dev/add-ins/outlook/outlook-mobile-apis | Outlook JavaScript APIs supported in Outlook on mobile devices}.
+         *
+         * **Errors**:
+         *
+         * - `InvalidOpenLocationInput`: The value of the specified location is invalid.
+         *
+         * - `MAMServiceNotAvailable`: The client is unable to fetch the MAM policy.
+         *
+         * @param openLocation - The location from which the add-in is attempting to access data.
+         *
+         * @returns True if an organization's Intune MAM policy allows an add-in to access data from the specified location.
+         */
+        getIsOpenFromLocationAllowed(openLocation: MailboxEnums.OpenLocation): boolean;
+        /**
+         * Returns true if an organization's {@link https://learn.microsoft.com/mem/intune/apps/app-management | Intune mobile application management (MAM) policy}
+         * allows an add-in to save data to the specified location.
+         *
+         * @remarks
+         *
+         * **{@link https://learn.microsoft.com/office/dev/add-ins/outlook/understanding-outlook-add-in-permissions | Minimum permission level}**: **read item**
+         *
+         * **{@link https://learn.microsoft.com/office/dev/add-ins/outlook/outlook-add-ins-overview#extension-points | Applicable Outlook mode}**: Compose, Read
+         *
+         * **Important**: This method is only supported in Outlook on Android and on iOS starting in Version 4.2443.0. To learn more about APIs supported in Outlook on mobile devices, see
+         * {@link https://learn.microsoft.com/office/dev/add-ins/outlook/outlook-mobile-apis | Outlook JavaScript APIs supported in Outlook on mobile devices}.
+         *
+         * **Errors**:
+         *
+         * - `InvalidSaveLocationInput`: The value of the specified location is invalid.
+         *
+         * - `MAMServiceNotAvailable`: The client is unable to fetch the MAM policy.
+         *
+         * @param saveLocation - The location in which the add-in is attempting to save data.
+         *
+         * @returns True if an organization's Intune MAM policy allows an add-in to save data to the specified location.
+         */
+        getIsSaveToLocationAllowed(saveLocation: MailboxEnums.SaveLocation): boolean;
         /**
          * Gets currently selected messages on which an add-in can activate and perform operations. An add-in can activate on a maximum of 100 messages at a time.
          * To learn more about item multi-select, see

office-js/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@types/office-js",
-    "version": "1.0.448",
+    "version": "1.0.450",
     "description": "TypeScript definitions for office-js",
     "homepage": "https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/office-js",
     "license": "MIT",
@@ -46,6 +46,6 @@
     "scripts": {},
     "dependencies": {},
     "peerDependencies": {},
-    "typesPublisherContentHash": "f5f3dd019545f4602c3c34a1e72602e3ee054c899f86d498709074bb14c1588e",
-    "typeScriptVersion": "4.9"
+    "typesPublisherContentHash": "fc948d86f1849a9edfc8565c7d32360a7ef1828586216a244b6b35c8d855cf15",
+    "typeScriptVersion": "5.0"
 }