@microsoft/teams-js 2.31.0-beta.0 → 2.31.0-beta.1

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.
Files changed (80) hide show
  1. package/dist/esm/packages/teams-js/dts/internal/appHelpers.d.ts +1 -1
  2. package/dist/esm/packages/teams-js/dts/internal/dialogHelpers.d.ts +32 -0
  3. package/dist/esm/packages/teams-js/dts/internal/marketplaceUtils.d.ts +1 -1
  4. package/dist/esm/packages/teams-js/dts/internal/mediaUtil.d.ts +2 -2
  5. package/dist/esm/packages/teams-js/dts/public/{app.d.ts → app/app.d.ts} +13 -44
  6. package/dist/esm/packages/teams-js/dts/public/app/lifecycle.d.ts +40 -0
  7. package/dist/esm/packages/teams-js/dts/public/appInitialization.d.ts +1 -1
  8. package/dist/esm/packages/teams-js/dts/public/chat.d.ts +26 -28
  9. package/dist/esm/packages/teams-js/dts/public/dialog/adaptiveCard/adaptiveCard.d.ts +30 -0
  10. package/dist/esm/packages/teams-js/dts/public/dialog/adaptiveCard/bot.d.ts +26 -0
  11. package/dist/esm/packages/teams-js/dts/public/dialog/dialog.d.ts +69 -0
  12. package/dist/esm/packages/teams-js/dts/public/dialog/update.d.ts +23 -0
  13. package/dist/esm/packages/teams-js/dts/public/dialog/url/bot.d.ts +29 -0
  14. package/dist/esm/packages/teams-js/dts/public/dialog/url/parentCommunication.d.ts +49 -0
  15. package/dist/esm/packages/teams-js/dts/public/dialog/url/url.d.ts +60 -0
  16. package/dist/esm/packages/teams-js/dts/public/geoLocation/geoLocation.d.ts +67 -0
  17. package/dist/esm/packages/teams-js/dts/public/geoLocation/map.d.ts +27 -0
  18. package/dist/esm/packages/teams-js/dts/public/index.d.ts +20 -18
  19. package/dist/esm/packages/teams-js/dts/public/interfaces.d.ts +12 -1
  20. package/dist/esm/packages/teams-js/dts/public/liveShareHost.d.ts +134 -136
  21. package/dist/esm/packages/teams-js/dts/public/location.d.ts +72 -74
  22. package/dist/esm/packages/teams-js/dts/public/mail.d.ts +79 -81
  23. package/dist/esm/packages/teams-js/dts/public/marketplace.d.ts +314 -316
  24. package/dist/esm/packages/teams-js/dts/public/media.d.ts +425 -427
  25. package/dist/esm/packages/teams-js/dts/public/menus.d.ts +164 -166
  26. package/dist/esm/packages/teams-js/dts/public/monetization.d.ts +48 -50
  27. package/dist/esm/packages/teams-js/dts/public/nestedAppAuth.d.ts +9 -11
  28. package/dist/esm/packages/teams-js/dts/public/people.d.ts +61 -63
  29. package/dist/esm/packages/teams-js/dts/public/search.d.ts +76 -86
  30. package/dist/esm/packages/teams-js/dts/public/secondaryBrowser.d.ts +25 -27
  31. package/dist/esm/packages/teams-js/dts/public/tasks.d.ts +52 -54
  32. package/dist/esm/packages/teams-js/dts/public/teamsAPIs.d.ts +74 -76
  33. package/dist/esm/packages/teams-js/dts/public/thirdPartyCloudStorage.d.ts +96 -98
  34. package/dist/esm/packages/teams-js/src/index.js +1 -1
  35. package/dist/esm/packages/teams-js/src/internal/appHelpers.js +1 -1
  36. package/dist/esm/packages/teams-js/src/internal/deepLinkUtilities.js +1 -1
  37. package/dist/esm/packages/teams-js/src/internal/dialogHelpers.js +1 -0
  38. package/dist/esm/packages/teams-js/src/internal/marketplaceUtils.js +1 -1
  39. package/dist/esm/packages/teams-js/src/internal/mediaUtil.js +1 -1
  40. package/dist/esm/packages/teams-js/src/public/app/app.js +1 -0
  41. package/dist/esm/packages/teams-js/src/public/app/lifecycle.js +1 -0
  42. package/dist/esm/packages/teams-js/src/public/appInitialization.js +1 -1
  43. package/dist/esm/packages/teams-js/src/public/chat.js +1 -1
  44. package/dist/esm/packages/teams-js/src/public/dialog/adaptiveCard/adaptiveCard.js +1 -0
  45. package/dist/esm/packages/teams-js/src/public/dialog/adaptiveCard/bot.js +1 -0
  46. package/dist/esm/packages/teams-js/src/public/dialog/dialog.js +1 -0
  47. package/dist/esm/packages/teams-js/src/public/dialog/update.js +1 -0
  48. package/dist/esm/packages/teams-js/src/public/dialog/url/bot.js +1 -0
  49. package/dist/esm/packages/teams-js/src/public/dialog/url/parentCommunication.js +1 -0
  50. package/dist/esm/packages/teams-js/src/public/dialog/url/url.js +1 -0
  51. package/dist/esm/packages/teams-js/src/public/geoLocation/geoLocation.js +1 -0
  52. package/dist/esm/packages/teams-js/src/public/geoLocation/map.js +1 -0
  53. package/dist/esm/packages/teams-js/src/public/liveShareHost.js +1 -1
  54. package/dist/esm/packages/teams-js/src/public/location.js +1 -1
  55. package/dist/esm/packages/teams-js/src/public/mail.js +1 -1
  56. package/dist/esm/packages/teams-js/src/public/marketplace.js +1 -1
  57. package/dist/esm/packages/teams-js/src/public/media.js +1 -1
  58. package/dist/esm/packages/teams-js/src/public/menus.js +1 -1
  59. package/dist/esm/packages/teams-js/src/public/monetization.js +1 -1
  60. package/dist/esm/packages/teams-js/src/public/nestedAppAuth.js +1 -1
  61. package/dist/esm/packages/teams-js/src/public/people.js +1 -1
  62. package/dist/esm/packages/teams-js/src/public/publicAPIs.js +1 -1
  63. package/dist/esm/packages/teams-js/src/public/search.js +1 -1
  64. package/dist/esm/packages/teams-js/src/public/secondaryBrowser.js +1 -1
  65. package/dist/esm/packages/teams-js/src/public/tasks.js +1 -1
  66. package/dist/esm/packages/teams-js/src/public/teamsAPIs.js +1 -1
  67. package/dist/esm/packages/teams-js/src/public/thirdPartyCloudStorage.js +1 -1
  68. package/dist/esm/packages/teams-js/src/public/version.js +1 -1
  69. package/dist/esm/packages/teams-js/src/public/webStorage.js +1 -1
  70. package/dist/umd/MicrosoftTeams.d.ts +2219 -2022
  71. package/dist/umd/MicrosoftTeams.js +2397 -2244
  72. package/dist/umd/MicrosoftTeams.js.map +1 -1
  73. package/dist/umd/MicrosoftTeams.min.js +1 -1
  74. package/dist/umd/MicrosoftTeams.min.js.map +1 -1
  75. package/package.json +1 -1
  76. package/dist/esm/packages/teams-js/dts/public/dialog.d.ts +0 -286
  77. package/dist/esm/packages/teams-js/dts/public/geoLocation.d.ts +0 -100
  78. package/dist/esm/packages/teams-js/src/public/app.js +0 -1
  79. package/dist/esm/packages/teams-js/src/public/dialog.js +0 -1
  80. package/dist/esm/packages/teams-js/src/public/geoLocation.js +0 -1
@@ -1,188 +1,186 @@
1
1
  /**
2
- * Namespace to interact with the menu-specific part of the SDK.
2
+ * Module to interact with the menu-specific part of the SDK.
3
3
  * This object is used to show View Configuration, Action Menu and Navigation Bar Menu.
4
4
  */
5
- export declare namespace menus {
5
+ /**
6
+ * @hidden
7
+ * Represents information about item in View Configuration.
8
+ *
9
+ * @internal
10
+ * Limited to Microsoft-internal use
11
+ */
12
+ export interface ViewConfiguration {
6
13
  /**
7
14
  * @hidden
8
- * Represents information about item in View Configuration.
15
+ * Unique identifier of view.
9
16
  *
10
17
  * @internal
11
18
  * Limited to Microsoft-internal use
12
19
  */
13
- interface ViewConfiguration {
14
- /**
15
- * @hidden
16
- * Unique identifier of view.
17
- *
18
- * @internal
19
- * Limited to Microsoft-internal use
20
- */
21
- id: string;
22
- /**
23
- * @hidden
24
- * Display title of the view.
25
- *
26
- * @internal
27
- * Limited to Microsoft-internal use
28
- */
29
- title: string;
30
- /**
31
- * @hidden
32
- * Additional information for accessibility.
33
- *
34
- * @internal
35
- * Limited to Microsoft-internal use
36
- */
37
- contentDescription?: string;
38
- }
39
- /**
40
- * Defines how a menu item should appear in the NavBar.
41
- */
42
- enum DisplayMode {
43
- /**
44
- * Only place this item in the NavBar if there's room for it.
45
- * If there's no room, item is shown in the overflow menu.
46
- */
47
- ifRoom = 0,
48
- /**
49
- * Never place this item in the NavBar.
50
- * The item would always be shown in NavBar's overflow menu.
51
- */
52
- overflowOnly = 1
53
- }
54
- /**
55
- * @hidden
56
- * Represents information about menu item for Action Menu and Navigation Bar Menu.
57
- */
58
- class MenuItem {
59
- /**
60
- * @hidden
61
- * Unique identifier for the menu item.
62
- */
63
- id: string;
64
- /**
65
- * @hidden
66
- * Display title of the menu item.
67
- */
68
- title: string;
69
- /**
70
- * @hidden
71
- * Display icon of the menu item. The icon value must be a string having SVG icon content.
72
- */
73
- icon: string;
74
- /**
75
- * @hidden
76
- * Selected state display icon of the menu item. The icon value must be a string having SVG icon content.
77
- */
78
- iconSelected?: string;
79
- /**
80
- * @hidden
81
- * Additional information for accessibility.
82
- */
83
- contentDescription?: string;
84
- /**
85
- * @hidden
86
- * State of the menu item
87
- */
88
- enabled: boolean;
89
- /**
90
- * @hidden
91
- * Interface to show list of items on selection of menu item.
92
- */
93
- viewData?: ViewData;
94
- /**
95
- * @hidden
96
- * Whether the menu item is selected or not
97
- */
98
- selected: boolean;
99
- /**
100
- * The Display Mode of the menu item.
101
- * Default Behaviour would be DisplayMode.ifRoom if null.
102
- * Refer {@link DisplayMode}
103
- */
104
- displayMode?: DisplayMode;
105
- }
106
- /**
107
- * @hidden
108
- * Represents information about view to show on Navigation Bar Menu item selection
109
- */
110
- interface ViewData {
111
- /**
112
- * @hidden
113
- * Display header title of the item list.
114
- */
115
- listTitle?: string;
116
- /**
117
- * @hidden
118
- * Type of the menu item.
119
- */
120
- listType: MenuListType;
121
- /**
122
- * @hidden
123
- * Array of MenuItem. Icon value will be required for all items in the list.
124
- */
125
- listItems: MenuItem[];
126
- }
127
- /**
128
- * @hidden
129
- * Represents information about type of list to display in Navigation Bar Menu.
130
- */
131
- enum MenuListType {
132
- dropDown = "dropDown",
133
- popOver = "popOver"
134
- }
135
- /**
136
- * @hidden
137
- * Register navBarMenuItemPress, actionMenuItemPress, setModuleView handlers.
20
+ id: string;
21
+ /**
22
+ * @hidden
23
+ * Display title of the view.
138
24
  *
139
25
  * @internal
140
- * Limited to Microsoft-internal use.
26
+ * Limited to Microsoft-internal use
141
27
  */
142
- function initialize(): void;
28
+ title: string;
143
29
  /**
144
30
  * @hidden
145
- * Registers list of view configurations and it's handler.
146
- * Handler is responsible for listening selection of View Configuration.
31
+ * Additional information for accessibility.
147
32
  *
148
- * @param viewConfig - List of view configurations. Minimum 1 value is required.
149
- * @param handler - The handler to invoke when the user selects view configuration.
33
+ * @internal
34
+ * Limited to Microsoft-internal use
150
35
  */
151
- function setUpViews(viewConfig: ViewConfiguration[], handler: (id: string) => boolean): void;
36
+ contentDescription?: string;
37
+ }
38
+ /**
39
+ * Defines how a menu item should appear in the NavBar.
40
+ */
41
+ export declare enum DisplayMode {
42
+ /**
43
+ * Only place this item in the NavBar if there's room for it.
44
+ * If there's no room, item is shown in the overflow menu.
45
+ */
46
+ ifRoom = 0,
47
+ /**
48
+ * Never place this item in the NavBar.
49
+ * The item would always be shown in NavBar's overflow menu.
50
+ */
51
+ overflowOnly = 1
52
+ }
53
+ /**
54
+ * @hidden
55
+ * Represents information about menu item for Action Menu and Navigation Bar Menu.
56
+ */
57
+ export declare class MenuItem {
152
58
  /**
153
59
  * @hidden
154
- * Used to set menu items on the Navigation Bar. If icon is available, icon will be shown, otherwise title will be shown.
155
- *
156
- * @param items List of MenuItems for Navigation Bar Menu.
157
- * @param handler The handler to invoke when the user selects menu item.
158
- */
159
- function setNavBarMenu(items: MenuItem[], handler: (id: string) => boolean): void;
160
- /** Parameters used to create an action menu within an app */
161
- interface ActionMenuParameters {
162
- /**
163
- * @hidden
164
- * Display title for Action Menu
165
- */
166
- title: string;
167
- /**
168
- * @hidden
169
- * List of MenuItems for Action Menu
170
- */
171
- items: MenuItem[];
172
- }
173
- /**
174
- * @hidden
175
- * Used to show Action Menu.
176
- *
177
- * @param params - Parameters for Menu Parameters
178
- * @param handler - The handler to invoke when the user selects menu item.
60
+ * Unique identifier for the menu item.
179
61
  */
180
- function showActionMenu(params: ActionMenuParameters, handler: (id: string) => boolean): void;
62
+ id: string;
181
63
  /**
182
- * Checks if the menus capability is supported by the host
183
- * @returns boolean to represent whether the menus capability is supported
184
- *
185
- * @throws Error if {@linkcode app.initialize} has not successfully completed
64
+ * @hidden
65
+ * Display title of the menu item.
66
+ */
67
+ title: string;
68
+ /**
69
+ * @hidden
70
+ * Display icon of the menu item. The icon value must be a string having SVG icon content.
71
+ */
72
+ icon: string;
73
+ /**
74
+ * @hidden
75
+ * Selected state display icon of the menu item. The icon value must be a string having SVG icon content.
76
+ */
77
+ iconSelected?: string;
78
+ /**
79
+ * @hidden
80
+ * Additional information for accessibility.
81
+ */
82
+ contentDescription?: string;
83
+ /**
84
+ * @hidden
85
+ * State of the menu item
186
86
  */
187
- function isSupported(): boolean;
87
+ enabled: boolean;
88
+ /**
89
+ * @hidden
90
+ * Interface to show list of items on selection of menu item.
91
+ */
92
+ viewData?: ViewData;
93
+ /**
94
+ * @hidden
95
+ * Whether the menu item is selected or not
96
+ */
97
+ selected: boolean;
98
+ /**
99
+ * The Display Mode of the menu item.
100
+ * Default Behaviour would be DisplayMode.ifRoom if null.
101
+ * Refer {@link DisplayMode}
102
+ */
103
+ displayMode?: DisplayMode;
104
+ }
105
+ /**
106
+ * @hidden
107
+ * Represents information about view to show on Navigation Bar Menu item selection
108
+ */
109
+ export interface ViewData {
110
+ /**
111
+ * @hidden
112
+ * Display header title of the item list.
113
+ */
114
+ listTitle?: string;
115
+ /**
116
+ * @hidden
117
+ * Type of the menu item.
118
+ */
119
+ listType: MenuListType;
120
+ /**
121
+ * @hidden
122
+ * Array of MenuItem. Icon value will be required for all items in the list.
123
+ */
124
+ listItems: MenuItem[];
125
+ }
126
+ /**
127
+ * @hidden
128
+ * Represents information about type of list to display in Navigation Bar Menu.
129
+ */
130
+ export declare enum MenuListType {
131
+ dropDown = "dropDown",
132
+ popOver = "popOver"
133
+ }
134
+ /**
135
+ * @hidden
136
+ * Register navBarMenuItemPress, actionMenuItemPress, setModuleView handlers.
137
+ *
138
+ * @internal
139
+ * Limited to Microsoft-internal use.
140
+ */
141
+ export declare function initialize(): void;
142
+ /**
143
+ * @hidden
144
+ * Registers list of view configurations and it's handler.
145
+ * Handler is responsible for listening selection of View Configuration.
146
+ *
147
+ * @param viewConfig - List of view configurations. Minimum 1 value is required.
148
+ * @param handler - The handler to invoke when the user selects view configuration.
149
+ */
150
+ export declare function setUpViews(viewConfig: ViewConfiguration[], handler: (id: string) => boolean): void;
151
+ /**
152
+ * @hidden
153
+ * Used to set menu items on the Navigation Bar. If icon is available, icon will be shown, otherwise title will be shown.
154
+ *
155
+ * @param items List of MenuItems for Navigation Bar Menu.
156
+ * @param handler The handler to invoke when the user selects menu item.
157
+ */
158
+ export declare function setNavBarMenu(items: MenuItem[], handler: (id: string) => boolean): void;
159
+ /** Parameters used to create an action menu within an app */
160
+ export interface ActionMenuParameters {
161
+ /**
162
+ * @hidden
163
+ * Display title for Action Menu
164
+ */
165
+ title: string;
166
+ /**
167
+ * @hidden
168
+ * List of MenuItems for Action Menu
169
+ */
170
+ items: MenuItem[];
188
171
  }
172
+ /**
173
+ * @hidden
174
+ * Used to show Action Menu.
175
+ *
176
+ * @param params - Parameters for Menu Parameters
177
+ * @param handler - The handler to invoke when the user selects menu item.
178
+ */
179
+ export declare function showActionMenu(params: ActionMenuParameters, handler: (id: string) => boolean): void;
180
+ /**
181
+ * Checks if the menus capability is supported by the host
182
+ * @returns boolean to represent whether the menus capability is supported
183
+ *
184
+ * @throws Error if {@linkcode app.initialize} has not successfully completed
185
+ */
186
+ export declare function isSupported(): boolean;
@@ -1,58 +1,56 @@
1
1
  import { SdkError } from './interfaces';
2
- export declare namespace monetization {
2
+ /**
3
+ * @hidden
4
+ * Data structure to represent a subscription plan.
5
+ *
6
+ * @internal
7
+ * Limited to Microsoft-internal use
8
+ */
9
+ export interface PlanInfo {
3
10
  /**
4
11
  * @hidden
5
- * Data structure to represent a subscription plan.
6
- *
7
- * @internal
8
- * Limited to Microsoft-internal use
12
+ * plan id
9
13
  */
10
- interface PlanInfo {
11
- /**
12
- * @hidden
13
- * plan id
14
- */
15
- planId: string;
16
- /**
17
- * @hidden
18
- * term of the plan
19
- */
20
- term: string;
21
- }
14
+ planId: string;
22
15
  /**
23
16
  * @hidden
24
- * Open dialog to start user's purchase experience
25
- *
26
- * @param planInfo optional parameter. It contains info of the subscription plan pushed to users.
27
- * error can either contain an error of type SdkError, incase of an error, or null when get is successful
28
- * @returns Promise that will be resolved when the operation has completed or rejected with SdkError value
29
- *
30
- * @internal
31
- * Limited to Microsoft-internal use
17
+ * term of the plan
32
18
  */
33
- function openPurchaseExperience(planInfo?: PlanInfo): Promise<void>;
34
- /**
35
- * @deprecated
36
- * As of TeamsJS v2.0.0, please use {@link monetization.openPurchaseExperience monetization.openPurchaseExperience(planInfo?: PlanInfo): Promise\<void\>} instead.
37
- *
38
- * @hidden
39
- * Open dialog to start user's purchase experience
40
- *
41
- * @param callback Callback contains 1 parameters, error.
42
- * @param planInfo optional parameter. It contains info of the subscription plan pushed to users.
43
- * error can either contain an error of type SdkError, incase of an error, or null when get is successful
44
- *
45
- * @internal
46
- * Limited to Microsoft-internal use
47
- */
48
- function openPurchaseExperience(callback: (error: SdkError | null) => void, planInfo?: PlanInfo): void;
49
- /**
50
- * @hidden
51
- *
52
- * Checks if the monetization capability is supported by the host
53
- * @returns boolean to represent whether the monetization capability is supported
54
- *
55
- * @throws Error if {@linkcode app.initialize} has not successfully completed
56
- */
57
- function isSupported(): boolean;
19
+ term: string;
58
20
  }
21
+ /**
22
+ * @hidden
23
+ * Open dialog to start user's purchase experience
24
+ *
25
+ * @param planInfo optional parameter. It contains info of the subscription plan pushed to users.
26
+ * error can either contain an error of type SdkError, incase of an error, or null when get is successful
27
+ * @returns Promise that will be resolved when the operation has completed or rejected with SdkError value
28
+ *
29
+ * @internal
30
+ * Limited to Microsoft-internal use
31
+ */
32
+ export declare function openPurchaseExperience(planInfo?: PlanInfo): Promise<void>;
33
+ /**
34
+ * @deprecated
35
+ * As of TeamsJS v2.0.0, please use {@link monetization.openPurchaseExperience monetization.openPurchaseExperience(planInfo?: PlanInfo): Promise\<void\>} instead.
36
+ *
37
+ * @hidden
38
+ * Open dialog to start user's purchase experience
39
+ *
40
+ * @param callback Callback contains 1 parameters, error.
41
+ * @param planInfo optional parameter. It contains info of the subscription plan pushed to users.
42
+ * error can either contain an error of type SdkError, incase of an error, or null when get is successful
43
+ *
44
+ * @internal
45
+ * Limited to Microsoft-internal use
46
+ */
47
+ export declare function openPurchaseExperience(callback: (error: SdkError | null) => void, planInfo?: PlanInfo): void;
48
+ /**
49
+ * @hidden
50
+ *
51
+ * Checks if the monetization capability is supported by the host
52
+ * @returns boolean to represent whether the monetization capability is supported
53
+ *
54
+ * @throws Error if {@linkcode app.initialize} has not successfully completed
55
+ */
56
+ export declare function isSupported(): boolean;
@@ -2,14 +2,12 @@
2
2
  * @beta
3
3
  * Nested app auth capabilities
4
4
  */
5
- export declare namespace nestedAppAuth {
6
- /**
7
- * Checks if MSAL-NAA channel recommended by the host
8
- * @returns true if host is recommending NAA channel and false otherwise
9
- *
10
- * @throws Error if {@linkcode app.initialize} has not successfully completed
11
- *
12
- * @beta
13
- */
14
- function isNAAChannelRecommended(): boolean;
15
- }
5
+ /**
6
+ * Checks if MSAL-NAA channel recommended by the host
7
+ * @returns true if host is recommending NAA channel and false otherwise
8
+ *
9
+ * @throws Error if {@linkcode app.initialize} has not successfully completed
10
+ *
11
+ * @beta
12
+ */
13
+ export declare function isNAAChannelRecommended(): boolean;
@@ -1,75 +1,73 @@
1
1
  import { SdkError } from './interfaces';
2
- export declare namespace people {
3
- /** Select people callback function type */
4
- type selectPeopleCallbackFunctionType = (error: SdkError, people: PeoplePickerResult[]) => void;
2
+ /** Select people callback function type */
3
+ export type selectPeopleCallbackFunctionType = (error: SdkError, people: PeoplePickerResult[]) => void;
4
+ /**
5
+ * Launches a people picker and allows the user to select one or more people from the list
6
+ * If the app is added to personal app scope the people picker launched is org wide and if the app is added to a chat/channel, people picker launched is also limited to the members of chat/channel
7
+
8
+ * @param callback - Returns list of JSON object of type PeoplePickerResult which consists of Microsoft Entra IDs, display names and emails of the selected users
9
+ * @param peoplePickerInputs - Input parameters to launch customized people picker
10
+ * @returns Promise that will be fulfilled when the operation has completed
11
+ */
12
+ export declare function selectPeople(peoplePickerInputs?: PeoplePickerInputs): Promise<PeoplePickerResult[]>;
13
+ /**
14
+ * @deprecated
15
+ * As of TeamsJS v2.0.0, please use {@link people.selectPeople people.selectPeople(peoplePickerInputs?: PeoplePickerInputs): Promise\<PeoplePickerResult[]\>} instead.
16
+ *
17
+ * Launches a people picker and allows the user to select one or more people from the list
18
+ * If the app is added to personal app scope the people picker launched is org wide and if the app is added to a chat/channel, people picker launched is also limited to the members of chat/channel
19
+
20
+ * @param callback - Returns list of JSON object of type PeoplePickerResult which consists of Microsoft Entra IDs, display names and emails of the selected users
21
+ * @param peoplePickerInputs - Input parameters to launch customized people picker
22
+ */
23
+ export declare function selectPeople(callback: selectPeopleCallbackFunctionType, peoplePickerInputs?: PeoplePickerInputs): void;
24
+ /**
25
+ * Input parameter supplied to the People Picker API
26
+ */
27
+ export interface PeoplePickerInputs {
5
28
  /**
6
- * Launches a people picker and allows the user to select one or more people from the list
7
- * If the app is added to personal app scope the people picker launched is org wide and if the app is added to a chat/channel, people picker launched is also limited to the members of chat/channel
8
-
9
- * @param callback - Returns list of JSON object of type PeoplePickerResult which consists of Microsoft Entra IDs, display names and emails of the selected users
10
- * @param peoplePickerInputs - Input parameters to launch customized people picker
11
- * @returns Promise that will be fulfilled when the operation has completed
29
+ * Optional; Set title for the people picker
30
+ * Default value is "Select people" for multiselect and "Select a person" for single select
12
31
  */
13
- function selectPeople(peoplePickerInputs?: PeoplePickerInputs): Promise<PeoplePickerResult[]>;
32
+ title?: string;
14
33
  /**
15
- * @deprecated
16
- * As of TeamsJS v2.0.0, please use {@link people.selectPeople people.selectPeople(peoplePickerInputs?: PeoplePickerInputs): Promise\<PeoplePickerResult[]\>} instead.
17
- *
18
- * Launches a people picker and allows the user to select one or more people from the list
19
- * If the app is added to personal app scope the people picker launched is org wide and if the app is added to a chat/channel, people picker launched is also limited to the members of chat/channel
20
-
21
- * @param callback - Returns list of JSON object of type PeoplePickerResult which consists of Microsoft Entra IDs, display names and emails of the selected users
22
- * @param peoplePickerInputs - Input parameters to launch customized people picker
34
+ * Optional; Microsoft Entra IDs of the users to be pre-populated in the search box of people picker control
35
+ * If single select is enabled this value, only the first user in the list will be pre-populated
36
+ * Default value is null
23
37
  */
24
- function selectPeople(callback: selectPeopleCallbackFunctionType, peoplePickerInputs?: PeoplePickerInputs): void;
38
+ setSelected?: string[];
25
39
  /**
26
- * Input parameter supplied to the People Picker API
40
+ * Optional; launches the people picker in org wide scope even if the app is added to a chat or channel
41
+ * Default value is false
27
42
  */
28
- interface PeoplePickerInputs {
29
- /**
30
- * Optional; Set title for the people picker
31
- * Default value is "Select people" for multiselect and "Select a person" for single select
32
- */
33
- title?: string;
34
- /**
35
- * Optional; Microsoft Entra IDs of the users to be pre-populated in the search box of people picker control
36
- * If single select is enabled this value, only the first user in the list will be pre-populated
37
- * Default value is null
38
- */
39
- setSelected?: string[];
40
- /**
41
- * Optional; launches the people picker in org wide scope even if the app is added to a chat or channel
42
- * Default value is false
43
- */
44
- openOrgWideSearchInChatOrChannel?: boolean;
45
- /**
46
- * Optional; launches the people picker for which only 1 person can be selected
47
- * Default value is false
48
- */
49
- singleSelect?: boolean;
50
- }
43
+ openOrgWideSearchInChatOrChannel?: boolean;
51
44
  /**
52
- * Output user object of people picker API
45
+ * Optional; launches the people picker for which only 1 person can be selected
46
+ * Default value is false
53
47
  */
54
- interface PeoplePickerResult {
55
- /**
56
- * user object ID (also known as Microsoft Entra ID) of the selected user
57
- */
58
- objectId: string;
59
- /**
60
- * Optional; display name of the selected user
61
- */
62
- displayName?: string;
63
- /**
64
- * Optional; email of the selected user
65
- */
66
- email?: string;
67
- }
48
+ singleSelect?: boolean;
49
+ }
50
+ /**
51
+ * Output user object of people picker API
52
+ */
53
+ export interface PeoplePickerResult {
54
+ /**
55
+ * user object ID (also known as Microsoft Entra ID) of the selected user
56
+ */
57
+ objectId: string;
58
+ /**
59
+ * Optional; display name of the selected user
60
+ */
61
+ displayName?: string;
68
62
  /**
69
- * Checks if the people capability is supported by the host
70
- * @returns boolean to represent whether the people capability is supported
71
- *
72
- * @throws Error if {@linkcode app.initialize} has not successfully completed
63
+ * Optional; email of the selected user
73
64
  */
74
- function isSupported(): boolean;
65
+ email?: string;
75
66
  }
67
+ /**
68
+ * Checks if the people capability is supported by the host
69
+ * @returns boolean to represent whether the people capability is supported
70
+ *
71
+ * @throws Error if {@linkcode app.initialize} has not successfully completed
72
+ */
73
+ export declare function isSupported(): boolean;