@types/office-js 1.0.379 → 1.0.381

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.
office-js/README.md CHANGED
@@ -8,7 +8,7 @@ This package contains type definitions for office-js (https://github.com/OfficeD
8
8
  Files were exported from https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/office-js.
9
9
 
10
10
  ### Additional Details
11
- * Last updated: Mon, 08 Apr 2024 18:09:13 GMT
11
+ * Last updated: Thu, 11 Apr 2024 20:07:16 GMT
12
12
  * Dependencies: none
13
13
 
14
14
  # Credits
office-js/index.d.ts CHANGED
@@ -422,10 +422,6 @@ declare namespace Office {
422
422
  Project,
423
423
  /**
424
424
  * The Office application is Microsoft Access.
425
- *
426
- * **Important**: We no longer recommend that you create and use Access web apps and databases in SharePoint.
427
- * As an alternative, we recommend that you use {@link https://powerapps.microsoft.com/ | Microsoft PowerApps}
428
- * to build no-code business solutions for web and mobile devices.
429
425
  */
430
426
  Access
431
427
  }
@@ -1727,10 +1723,6 @@ declare namespace Office {
1727
1723
  filterType?: Office.FilterType | string
1728
1724
  /**
1729
1725
  * Only for table bindings in content add-ins for Access. Specifies the pre-defined string "thisRow" to get data in the currently selected row.
1730
- *
1731
- * **Important**: We no longer recommend that you create and use Access web apps and databases in SharePoint.
1732
- * As an alternative, we recommend that you use {@link https://powerapps.microsoft.com/ | Microsoft PowerApps}
1733
- * to build no-code business solutions for web and mobile devices.
1734
1726
  */
1735
1727
  rows?: string
1736
1728
  /**
@@ -1759,18 +1751,10 @@ declare namespace Office {
1759
1751
  coercionType?: Office.CoercionType | string
1760
1752
  /**
1761
1753
  * Only for table bindings in content add-ins for Access. Array of strings. Specifies the column names.
1762
- *
1763
- * **Important**: We no longer recommend that you create and use Access web apps and databases in SharePoint.
1764
- * As an alternative, we recommend that you use {@link https://powerapps.microsoft.com/ | Microsoft PowerApps}
1765
- * to build no-code business solutions for web and mobile devices.
1766
1754
  */
1767
1755
  columns?: string[]
1768
1756
  /**
1769
1757
  * Only for table bindings in content add-ins for Access. Specifies the pre-defined string "thisRow" to get data in the currently selected row.
1770
- *
1771
- * **Important**: We no longer recommend that you create and use Access web apps and databases in SharePoint.
1772
- * As an alternative, we recommend that you use {@link https://powerapps.microsoft.com/ | Microsoft PowerApps}
1773
- * to build no-code business solutions for web and mobile devices.
1774
1758
  */
1775
1759
  rows?: string
1776
1760
  /**
@@ -1865,10 +1849,6 @@ declare namespace Office {
1865
1849
  * The headers provided in the TableData object specify the labels used in the field selection UI.
1866
1850
  *
1867
1851
  * **Note**: This parameter is used only in add-ins for Access. It is ignored if provided when calling the method in an add-in for Excel.
1868
- *
1869
- * **Important**: We no longer recommend that you create and use Access web apps and databases in SharePoint.
1870
- * As an alternative, we recommend that you use {@link https://powerapps.microsoft.com/ | Microsoft PowerApps}
1871
- * to build no-code business solutions for web and mobile devices.
1872
1852
  */
1873
1853
  sampleData?: Office.TableData
1874
1854
  /**
@@ -14784,6 +14764,29 @@ declare namespace Office {
14784
14764
  *
14785
14765
  * **{@link https://learn.microsoft.com/office/dev/add-ins/outlook/outlook-add-ins-overview#extension-points | Applicable Outlook mode}**: Compose or Read
14786
14766
  *
14767
+ * **Important**:
14768
+ *
14769
+ * - In October 2024, legacy Exchange {@link https://learn.microsoft.com/office/dev/add-ins/outlook/authentication#exchange-user-identity-token | user identity} and
14770
+ * {@link https://learn.microsoft.com/office/dev/add-ins/outlook/authentication#callback-tokens | callback} tokens will be turned off by default for all Exchange Online tenants.
14771
+ * This is part of {@link https://blogs.microsoft.com/on-the-issues/2023/11/02/secure-future-initiative-sfi-cybersecurity-cyberattacks/ | Microsoft's Secure Future Initiative},
14772
+ * which gives organizations the tools needed to respond to the current threat landscape. Exchange user identity tokens will still work for Exchange on-premises.
14773
+ * Nested app authentication is the recommended approach for tokens going forward. For more information, see our {@link https://aka.ms/NAApreviewblog | blog post} and
14774
+ * {@link https://learn.microsoft.com/office/dev/add-ins/outlook/faq-nested-app-auth-outlook-legacy-tokens | FAQ page}.
14775
+ *
14776
+ * - This method is only supported in read mode in Outlook on Android and on iOS. For more information on supported APIs in Outlook mobile, see
14777
+ * {@link https://learn.microsoft.com/office/dev/add-ins/outlook/outlook-mobile-apis | Outlook JavaScript APIs supported in Outlook on mobile devices}.
14778
+ *
14779
+ * - EWS operations aren't supported in add-ins running in Outlook on iOS and on Android. A REST token is always returned in Outlook
14780
+ * mobile clients even if `options.isRest` is set to `false`.
14781
+ *
14782
+ *- Calling the `getCallbackTokenAsync` method in read mode requires a minimum permission level of **read item**.
14783
+ *
14784
+ * - Calling the `getCallbackTokenAsync` method in compose mode requires you to have saved the item.
14785
+ * The `saveAsync` method requires a minimum permission level of **read/write item**.
14786
+ *
14787
+ * - For guidance on delegate or shared scenarios, see the
14788
+ * {@link https://learn.microsoft.com/office/dev/add-ins/outlook/delegate-access | shared folders and shared mailbox} article.
14789
+ *
14787
14790
  * *REST Tokens*
14788
14791
  *
14789
14792
  * When a REST token is requested (`options.isRest` = `true`), the resulting token won't work to authenticate EWS calls.
@@ -14818,22 +14821,6 @@ declare namespace Office {
14818
14821
  * attachment or item. For example, you can create a remote service to
14819
14822
  * {@link https://learn.microsoft.com/office/dev/add-ins/outlook/get-attachments-of-an-outlook-item | get attachments from the selected item}.
14820
14823
  *
14821
- * **Important**:
14822
- *
14823
- * - This method is only supported in read mode in Outlook on Android and on iOS. For more information on supported APIs in Outlook mobile, see
14824
- * {@link https://learn.microsoft.com/office/dev/add-ins/outlook/outlook-mobile-apis | Outlook JavaScript APIs supported in Outlook on mobile devices}.
14825
- *
14826
- * - EWS operations aren't supported in add-ins running in Outlook on iOS and on Android. A REST token is always returned in Outlook
14827
- * mobile clients even if `options.isRest` is set to `false`.
14828
- *
14829
- *- Calling the `getCallbackTokenAsync` method in read mode requires a minimum permission level of **read item**.
14830
- *
14831
- * - Calling the `getCallbackTokenAsync` method in compose mode requires you to have saved the item.
14832
- * The `saveAsync` method requires a minimum permission level of **read/write item**.
14833
- *
14834
- * - For guidance on delegate or shared scenarios, see the
14835
- * {@link https://learn.microsoft.com/office/dev/add-ins/outlook/delegate-access | shared folders and shared mailbox} article.
14836
- *
14837
14824
  * **Errors**:
14838
14825
  *
14839
14826
  * - `HTTPRequestFailure`: The request has failed. Please look at the diagnostics object for the HTTP error code.
@@ -14867,6 +14854,13 @@ declare namespace Office {
14867
14854
  *
14868
14855
  * **Important**:
14869
14856
  *
14857
+ * - In October 2024, legacy Exchange {@link https://learn.microsoft.com/office/dev/add-ins/outlook/authentication#exchange-user-identity-token | user identity} and
14858
+ * {@link https://learn.microsoft.com/office/dev/add-ins/outlook/authentication#callback-tokens | callback} tokens will be turned off by default for all Exchange Online tenants.
14859
+ * This is part of {@link https://blogs.microsoft.com/on-the-issues/2023/11/02/secure-future-initiative-sfi-cybersecurity-cyberattacks/ | Microsoft's Secure Future Initiative},
14860
+ * which gives organizations the tools needed to respond to the current threat landscape. Exchange user identity tokens will still work for Exchange on-premises.
14861
+ * Nested app authentication is the recommended approach for tokens going forward. For more information, see our {@link https://aka.ms/NAApreviewblog | blog post} and
14862
+ * {@link https://learn.microsoft.com/office/dev/add-ins/outlook/faq-nested-app-auth-outlook-legacy-tokens | FAQ page}.
14863
+ *
14870
14864
  * - You can pass both the token and either an attachment identifier or item identifier to an external system. That system uses
14871
14865
  * the token as a bearer authorization token to call the Exchange Web Services (EWS)
14872
14866
  * {@link https://learn.microsoft.com/exchange/client-developer/web-service-reference/getattachment-operation | GetAttachment} or
@@ -14955,7 +14949,16 @@ declare namespace Office {
14955
14949
  *
14956
14950
  * **{@link https://learn.microsoft.com/office/dev/add-ins/outlook/outlook-add-ins-overview#extension-points | Applicable Outlook mode}**: Compose or Read
14957
14951
  *
14958
- * The `getUserIdentityTokenAsync` method returns a token that you can use to identify and
14952
+ * **Important**:
14953
+ *
14954
+ * - In October 2024, legacy Exchange {@link https://learn.microsoft.com/office/dev/add-ins/outlook/authentication#exchange-user-identity-token | user identity} and
14955
+ * {@link https://learn.microsoft.com/office/dev/add-ins/outlook/authentication#callback-tokens | callback} tokens will be turned off by default for all Exchange Online tenants.
14956
+ * This is part of {@link https://blogs.microsoft.com/on-the-issues/2023/11/02/secure-future-initiative-sfi-cybersecurity-cyberattacks/ | Microsoft's Secure Future Initiative},
14957
+ * which gives organizations the tools needed to respond to the current threat landscape. Exchange user identity tokens will still work for Exchange on-premises.
14958
+ * Nested app authentication is the recommended approach for tokens going forward. For more information, see our {@link https://aka.ms/NAApreviewblog | blog post} and
14959
+ * {@link https://learn.microsoft.com/office/dev/add-ins/outlook/faq-nested-app-auth-outlook-legacy-tokens | FAQ page}.
14960
+ *
14961
+ * - The `getUserIdentityTokenAsync` method returns a token that you can use to identify and
14959
14962
  * {@link https://learn.microsoft.com/office/dev/add-ins/outlook/authentication | authenticate the add-in and user with an external system}.
14960
14963
  *
14961
14964
  * **Errors**:
@@ -14987,6 +14990,13 @@ declare namespace Office {
14987
14990
  *
14988
14991
  * **Important**:
14989
14992
  *
14993
+ * - In October 2024, legacy Exchange {@link https://learn.microsoft.com/office/dev/add-ins/outlook/authentication#exchange-user-identity-token | user identity} and
14994
+ * {@link https://learn.microsoft.com/office/dev/add-ins/outlook/authentication#callback-tokens | callback} tokens will be turned off by default for all Exchange Online tenants.
14995
+ * This is part of {@link https://blogs.microsoft.com/on-the-issues/2023/11/02/secure-future-initiative-sfi-cybersecurity-cyberattacks/ | Microsoft's Secure Future Initiative},
14996
+ * which gives organizations the tools needed to respond to the current threat landscape. Exchange user identity tokens will still work for Exchange on-premises.
14997
+ * Nested app authentication is the recommended approach for tokens going forward. For more information, see our {@link https://aka.ms/NAApreviewblog | blog post} and
14998
+ * {@link https://learn.microsoft.com/office/dev/add-ins/outlook/faq-nested-app-auth-outlook-legacy-tokens | FAQ page}.
14999
+ *
14990
15000
  * - To enable the `makeEwsRequestAsync` method to make EWS requests, the server administrator must set `OAuthAuthentication` to `true` on the
14991
15001
  * Client Access Server EWS directory .
14992
15002
  *
@@ -16681,10 +16691,7 @@ declare namespace Office {
16681
16691
  */
16682
16692
  internetMessageId: string;
16683
16693
  /**
16684
- * Gets the Exchange Web Services item class of the selected item.
16685
- *
16686
- * You can create custom message classes that extends a default message class, for example, a custom appointment message class
16687
- * `IPM.Appointment.Contoso`.
16694
+ * Gets the Exchange Web Services item class of the selected message.
16688
16695
  *
16689
16696
  * @remarks
16690
16697
  *
@@ -16692,27 +16699,42 @@ declare namespace Office {
16692
16699
  *
16693
16700
  * **{@link https://learn.microsoft.com/office/dev/add-ins/outlook/outlook-add-ins-overview#extension-points | Applicable Outlook mode}**: Message Read
16694
16701
  *
16695
- * The `itemClass` property specifies the message class of the selected item.
16696
- * The following are the default message classes for the message or appointment item.
16702
+ * **Important**:
16703
+ *
16704
+ * The following table lists the default item classes for messages.
16697
16705
  *
16698
16706
  * <table>
16699
16707
  * <tr>
16700
- * <th>Type</th>
16708
+ * <th>Item class</th>
16701
16709
  * <th>Description</th>
16702
- * <th>Item Class</th>
16703
16710
  * </tr>
16704
16711
  * <tr>
16705
- * <td>Appointment items</td>
16706
- * <td>These are calendar items of the item class IPM.Appointment or IPM.Appointment.Occurrence.</td>
16707
- * <td>IPM.Appointment, IPM.Appointment.Occurrence</td>
16712
+ * <td>IPM.Note</td>
16713
+ * <td>New messages and message replies</td>
16714
+ * </tr>
16715
+ * <tr>
16716
+ * <td>IPM.Schedule.Meeting.Request</td>
16717
+ * <td>Meeting requests</td>
16718
+ * </tr>
16719
+ * <tr>
16720
+ * <td>IPM.Schedule.Meeting.Canceled</td>
16721
+ * <td>Meeting cancellations</td>
16722
+ * </tr>
16723
+ * <tr>
16724
+ * <td>IPM.Schedule.Meeting.Resp.Neg</td>
16725
+ * <td>Responses to decline meeting requests</td>
16726
+ * </tr>
16727
+ * <tr>
16728
+ * <td>IPM.Schedule.Meeting.Resp.Pos</td>
16729
+ * <td>Responses to accept meeting requests</td>
16708
16730
  * </tr>
16709
16731
  * <tr>
16710
- * <td>Message items</td>
16711
- * <td>These include email messages that have the default message class IPM.Note, and meeting requests, responses, and cancellations, that use IPM.Schedule.Meeting as the base message class.</td>
16712
- * <td>IPM.Note, IPM.Schedule.Meeting.Request, IPM.Schedule.Meeting.Neg, IPM.Schedule.Meeting.Pos, IPM.Schedule.Meeting.Tent, IPM.Schedule.Meeting.Canceled</td>
16732
+ * <td>IPM.Schedule.Meeting.Resp.Tent</td>
16733
+ * <td>Responses to tentatively accept meeting requests</td>
16713
16734
  * </tr>
16714
16735
  * </table>
16715
16736
  *
16737
+ * You can create custom classes that extend a default item class. For example, `IPM.Note.Contoso`.
16716
16738
  */
16717
16739
  itemClass: string;
16718
16740
  /**
office-js/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@types/office-js",
3
- "version": "1.0.379",
3
+ "version": "1.0.381",
4
4
  "description": "TypeScript definitions for office-js",
5
5
  "homepage": "https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/office-js",
6
6
  "license": "MIT",
@@ -45,6 +45,6 @@
45
45
  },
46
46
  "scripts": {},
47
47
  "dependencies": {},
48
- "typesPublisherContentHash": "5b0b65f0c0486d834f60da0e572ddbf3dbd627bfaa42badc0293ee8a8feacaf3",
48
+ "typesPublisherContentHash": "888871b17bc2dced97a4bb0bb5874087a6b1c0bdda1d0683e042c552a75889c5",
49
49
  "typeScriptVersion": "4.7"
50
50
  }