@pnp/cli-microsoft365 8.1.0-beta.bf59841 → 9.0.0-beta.1516729

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 (54) hide show
  1. package/allCommands.json +1 -1
  2. package/allCommandsFull.json +1 -1
  3. package/dist/Auth.js +11 -12
  4. package/dist/Command.js +1 -3
  5. package/dist/cli/cli.js +68 -14
  6. package/dist/config.js +60 -5
  7. package/dist/m365/base/SpoCommand.js +1 -1
  8. package/dist/m365/cli/commands/cli-consent.js +2 -2
  9. package/dist/m365/cli/commands/cli-doctor.js +2 -2
  10. package/dist/m365/cli/commands/cli-reconsent.js +2 -3
  11. package/dist/m365/cli/commands/config/config-set.js +12 -3
  12. package/dist/m365/commands/login.js +38 -14
  13. package/dist/m365/commands/setup.js +256 -33
  14. package/dist/m365/connection/commands/connection-list.js +4 -4
  15. package/dist/m365/entra/commands/app/app-add.js +52 -288
  16. package/dist/m365/entra/commands/enterpriseapp/enterpriseapp-remove.js +123 -0
  17. package/dist/m365/entra/commands/group/group-set.js +256 -0
  18. package/dist/m365/entra/commands/m365group/m365group-user-add.js +109 -32
  19. package/dist/m365/entra/commands/m365group/m365group-user-set.js +159 -84
  20. package/dist/m365/entra/commands.js +3 -0
  21. package/dist/m365/flow/commands/flow-get.js +1 -1
  22. package/dist/m365/onenote/commands/notebook/notebook-add.js +132 -0
  23. package/dist/m365/onenote/commands.js +1 -0
  24. package/dist/m365/pa/commands/app/app-export.js +13 -7
  25. package/dist/m365/spo/commands/folder/folder-sharinglink-get.js +86 -0
  26. package/dist/m365/spo/commands/folder/folder-sharinglink-list.js +110 -0
  27. package/dist/m365/spo/commands/list/ListInstance.js +6 -1
  28. package/dist/m365/spo/commands/list/list-get.js +9 -3
  29. package/dist/m365/spo/commands/site/site-get.js +12 -16
  30. package/dist/m365/spo/commands.js +2 -0
  31. package/dist/m365/teams/commands/message/message-restore.js +106 -0
  32. package/dist/m365/teams/commands.js +1 -0
  33. package/dist/settingsNames.js +7 -1
  34. package/dist/utils/drive.js +61 -0
  35. package/dist/utils/entraApp.js +283 -0
  36. package/dist/utils/spo.js +32 -0
  37. package/docs/docs/_clisettings.mdx +6 -0
  38. package/docs/docs/cmd/entra/enterpriseapp/enterpriseapp-remove.mdx +65 -0
  39. package/docs/docs/cmd/entra/group/group-add.mdx +0 -4
  40. package/docs/docs/cmd/entra/group/group-set.mdx +89 -0
  41. package/docs/docs/cmd/entra/m365group/m365group-user-add.mdx +28 -10
  42. package/docs/docs/cmd/entra/m365group/m365group-user-set.mdx +35 -11
  43. package/docs/docs/cmd/flow/flow-get.mdx +149 -283
  44. package/docs/docs/cmd/onenote/notebook/notebook-add.mdx +169 -0
  45. package/docs/docs/cmd/pa/app/app-export.mdx +15 -9
  46. package/docs/docs/cmd/setup.mdx +16 -3
  47. package/docs/docs/cmd/spo/app/app-uninstall.mdx +1 -1
  48. package/docs/docs/cmd/spo/folder/folder-sharinglink-get.mdx +110 -0
  49. package/docs/docs/cmd/spo/folder/folder-sharinglink-list.mdx +114 -0
  50. package/docs/docs/cmd/spo/list/list-get.mdx +6 -0
  51. package/docs/docs/cmd/teams/message/message-remove.mdx +2 -1
  52. package/docs/docs/cmd/teams/message/message-restore.mdx +62 -0
  53. package/npm-shrinkwrap.json +574 -480
  54. package/package.json +22 -23
@@ -3,14 +3,15 @@ var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (
3
3
  if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
4
4
  return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
5
5
  };
6
- var _EntraM365GroupUserSetCommand_instances, _EntraM365GroupUserSetCommand_initTelemetry, _EntraM365GroupUserSetCommand_initOptions, _EntraM365GroupUserSetCommand_initValidators, _EntraM365GroupUserSetCommand_initOptionSets;
6
+ var _EntraM365GroupUserSetCommand_instances, _EntraM365GroupUserSetCommand_initTelemetry, _EntraM365GroupUserSetCommand_initOptions, _EntraM365GroupUserSetCommand_initValidators, _EntraM365GroupUserSetCommand_initOptionSets, _EntraM365GroupUserSetCommand_initTypes;
7
7
  import request from '../../../../request.js';
8
- import { odata } from '../../../../utils/odata.js';
9
8
  import { validation } from '../../../../utils/validation.js';
9
+ import { formatting } from '../../../../utils/formatting.js';
10
10
  import GraphCommand from '../../../base/GraphCommand.js';
11
11
  import teamsCommands from '../../../teams/commands.js';
12
12
  import commands from '../../commands.js';
13
13
  import { entraGroup } from '../../../../utils/entraGroup.js';
14
+ import { entraUser } from '../../../../utils/entraUser.js';
14
15
  import aadCommands from '../../aadCommands.js';
15
16
  class EntraM365GroupUserSetCommand extends GraphCommand {
16
17
  get name() {
@@ -25,135 +26,209 @@ class EntraM365GroupUserSetCommand extends GraphCommand {
25
26
  constructor() {
26
27
  super();
27
28
  _EntraM365GroupUserSetCommand_instances.add(this);
29
+ this.allowedRoles = ['owner', 'member'];
28
30
  __classPrivateFieldGet(this, _EntraM365GroupUserSetCommand_instances, "m", _EntraM365GroupUserSetCommand_initTelemetry).call(this);
29
31
  __classPrivateFieldGet(this, _EntraM365GroupUserSetCommand_instances, "m", _EntraM365GroupUserSetCommand_initOptions).call(this);
30
32
  __classPrivateFieldGet(this, _EntraM365GroupUserSetCommand_instances, "m", _EntraM365GroupUserSetCommand_initValidators).call(this);
31
33
  __classPrivateFieldGet(this, _EntraM365GroupUserSetCommand_instances, "m", _EntraM365GroupUserSetCommand_initOptionSets).call(this);
34
+ __classPrivateFieldGet(this, _EntraM365GroupUserSetCommand_instances, "m", _EntraM365GroupUserSetCommand_initTypes).call(this);
32
35
  }
33
36
  async commandAction(logger, args) {
34
37
  await this.showDeprecationWarning(logger, aadCommands.M365GROUP_USER_SET, commands.M365GROUP_USER_SET);
38
+ if (args.options.userName) {
39
+ await this.warn(logger, `Option 'userName' is deprecated. Please use 'ids' or 'userNames' instead.`);
40
+ }
35
41
  try {
36
- const groupId = (typeof args.options.groupId !== 'undefined') ? args.options.groupId : args.options.teamId;
42
+ const userNames = args.options.userNames || args.options.userName;
43
+ const groupId = await this.getGroupId(logger, args);
37
44
  const isUnifiedGroup = await entraGroup.isUnifiedGroup(groupId);
38
45
  if (!isUnifiedGroup) {
39
46
  throw Error(`Specified group with id '${groupId}' is not a Microsoft 365 group.`);
40
47
  }
41
- let users = await this.getOwners(groupId, logger);
42
- const membersAndGuests = await this.getMembersAndGuests(groupId, logger);
43
- users = users.concat(membersAndGuests);
44
- // Filter out duplicate added values for owners (as they are returned as members as well)
45
- users = users.filter((groupUser, index, self) => index === self.findIndex((t) => (t.id === groupUser.id && t.displayName === groupUser.displayName)));
46
- if (this.debug) {
47
- await logger.logToStderr((typeof args.options.groupId !== 'undefined') ? 'Group owners and members:' : 'Team owners and members:');
48
- await logger.logToStderr(users);
49
- await logger.logToStderr('');
50
- }
51
- if (users.filter(i => args.options.userName.toUpperCase() === i.userPrincipalName.toUpperCase()).length <= 0) {
52
- const userNotInGroup = (typeof args.options.groupId !== 'undefined') ?
53
- 'The specified user does not belong to the given Microsoft 365 Group. Please use the \'m365group user add\' command to add new users.' :
54
- 'The specified user does not belong to the given Microsoft Teams team. Please use the \'graph teams user add\' command to add new users.';
55
- throw new Error(userNotInGroup);
56
- }
57
- if (args.options.role === "Owner") {
58
- const foundMember = users.find(e => args.options.userName.toUpperCase() === e.userPrincipalName.toUpperCase() && e.userType === 'Member');
59
- if (foundMember !== undefined) {
60
- const endpoint = `${this.resource}/v1.0/groups/${groupId}/owners/$ref`;
61
- const requestOptions = {
62
- url: endpoint,
63
- headers: {
64
- 'accept': 'application/json;odata.metadata=none'
65
- },
66
- responseType: 'json',
67
- data: { "@odata.id": "https://graph.microsoft.com/v1.0/directoryObjects/" + foundMember.id }
68
- };
69
- await request.post(requestOptions);
70
- }
71
- else {
72
- const userAlreadyOwner = (typeof args.options.groupId !== 'undefined') ?
73
- 'The specified user is already an owner in the specified Microsoft 365 group, and thus cannot be promoted.' :
74
- 'The specified user is already an owner in the specified Microsoft Teams team, and thus cannot be promoted.';
75
- throw new Error(userAlreadyOwner);
76
- }
77
- }
78
- else {
79
- const foundOwner = users.find(e => args.options.userName.toUpperCase() === e.userPrincipalName.toUpperCase() && e.userType === 'Owner');
80
- if (foundOwner !== undefined) {
81
- const endpoint = `${this.resource}/v1.0/groups/${groupId}/owners/${foundOwner.id}/$ref`;
82
- const requestOptions = {
83
- url: endpoint,
84
- headers: {
85
- 'accept': 'application/json;odata.metadata=none'
86
- }
87
- };
88
- await request.delete(requestOptions);
89
- }
90
- else {
91
- const userAlreadyMember = (typeof args.options.groupId !== 'undefined') ?
92
- 'The specified user is already a member in the specified Microsoft 365 group, and thus cannot be demoted.' :
93
- 'The specified user is already a member in the specified Microsoft Teams team, and thus cannot be demoted.';
94
- throw new Error(userAlreadyMember);
95
- }
96
- }
48
+ const userIds = await this.getUserIds(logger, args.options.ids, userNames);
49
+ // we can't simply switch the role
50
+ // first add users to the new role
51
+ await this.addUsers(groupId, userIds, args.options.role);
52
+ // remove users from the old role
53
+ await this.removeUsersFromRole(logger, groupId, userIds, args.options.role);
97
54
  }
98
55
  catch (err) {
99
56
  this.handleRejectedODataJsonPromise(err);
100
57
  }
101
58
  }
102
- async getOwners(groupId, logger) {
59
+ async getGroupId(logger, args) {
60
+ if (args.options.groupId) {
61
+ return args.options.groupId;
62
+ }
63
+ if (args.options.teamId) {
64
+ return args.options.teamId;
65
+ }
66
+ const name = args.options.groupName || args.options.teamName;
103
67
  if (this.verbose) {
104
- await logger.logToStderr(`Retrieving owners of the group with id ${groupId}`);
105
- }
106
- const endpoint = `${this.resource}/v1.0/groups/${groupId}/owners?$select=id,displayName,userPrincipalName,userType`;
107
- const users = await odata.getAllItems(endpoint);
108
- // Currently there is a bug in the Microsoft Graph that returns Owners as
109
- // userType 'member'. We therefore update all returned user as owner
110
- users.forEach(user => {
111
- user.userType = 'Owner';
112
- });
113
- return users;
68
+ await logger.logToStderr('Retrieving Group ID by display name...');
69
+ }
70
+ return entraGroup.getGroupIdByDisplayName(name);
71
+ }
72
+ async getUserIds(logger, userIds, userNames) {
73
+ if (userIds) {
74
+ return formatting.splitAndTrim(userIds);
75
+ }
76
+ if (this.verbose) {
77
+ await logger.logToStderr('Retrieving user ID(s) by username(s)...');
78
+ }
79
+ return entraUser.getUserIdsByUpns(formatting.splitAndTrim(userNames));
114
80
  }
115
- async getMembersAndGuests(groupId, logger) {
81
+ async removeUsersFromRole(logger, groupId, userIds, role) {
82
+ const userIdsToRemove = [];
83
+ const currentRole = (role.toLowerCase() === 'member') ? 'owners' : 'members';
116
84
  if (this.verbose) {
117
- await logger.logToStderr(`Retrieving members of the group with id ${groupId}`);
85
+ await logger.logToStderr(`Removing users from the old role '${currentRole}'.`);
86
+ }
87
+ for (let i = 0; i < userIds.length; i += 20) {
88
+ const userIdsBatch = userIds.slice(i, i + 20);
89
+ const requestOptions = this.getRequestOptions();
90
+ userIdsBatch.map(userId => {
91
+ requestOptions.data.requests.push({
92
+ id: userId,
93
+ method: 'GET',
94
+ url: `/groups/${groupId}/${currentRole}/$count?$filter=id eq '${userId}'`,
95
+ headers: {
96
+ 'ConsistencyLevel': 'eventual'
97
+ }
98
+ });
99
+ });
100
+ // send batch request
101
+ const res = await request.post(requestOptions);
102
+ for (const response of res.responses) {
103
+ if (response.status === 200) {
104
+ if (response.body === 1) {
105
+ // user can be removed from current role
106
+ userIdsToRemove.push(response.id);
107
+ }
108
+ }
109
+ else {
110
+ throw response.body;
111
+ }
112
+ }
113
+ }
114
+ for (let i = 0; i < userIdsToRemove.length; i += 20) {
115
+ const userIdsBatch = userIds.slice(i, i + 20);
116
+ const requestOptions = this.getRequestOptions();
117
+ userIdsBatch.map(userId => {
118
+ requestOptions.data.requests.push({
119
+ id: userId,
120
+ method: 'DELETE',
121
+ url: `/groups/${groupId}/${currentRole}/${userId}/$ref`
122
+ });
123
+ });
124
+ const res = await request.post(requestOptions);
125
+ for (const response of res.responses) {
126
+ if (response.status !== 204) {
127
+ throw response.body;
128
+ }
129
+ }
130
+ }
131
+ }
132
+ async addUsers(groupId, userIds, role) {
133
+ for (let i = 0; i < userIds.length; i += 400) {
134
+ const userIdsBatch = userIds.slice(i, i + 400);
135
+ const requestOptions = this.getRequestOptions();
136
+ for (let j = 0; j < userIdsBatch.length; j += 20) {
137
+ const userIdsChunk = userIdsBatch.slice(j, j + 20);
138
+ requestOptions.data.requests.push({
139
+ id: j + 1,
140
+ method: 'PATCH',
141
+ url: `/groups/${groupId}`,
142
+ headers: {
143
+ 'content-type': 'application/json;odata.metadata=none'
144
+ },
145
+ body: {
146
+ [`${role.toLowerCase() === 'member' ? 'members' : 'owners'}@odata.bind`]: userIdsChunk.map(u => `${this.resource}/v1.0/directoryObjects/${u}`)
147
+ }
148
+ });
149
+ }
150
+ const res = await request.post(requestOptions);
151
+ for (const response of res.responses) {
152
+ if (response.status !== 204) {
153
+ throw response.body;
154
+ }
155
+ }
118
156
  }
119
- const endpoint = `${this.resource}/v1.0/groups/${groupId}/members?$select=id,displayName,userPrincipalName,userType`;
120
- return await odata.getAllItems(endpoint);
157
+ }
158
+ getRequestOptions() {
159
+ const requestOptions = {
160
+ url: `${this.resource}/v1.0/$batch`,
161
+ headers: {
162
+ 'content-type': 'application/json;odata.metadata=none'
163
+ },
164
+ responseType: 'json',
165
+ data: {
166
+ requests: []
167
+ }
168
+ };
169
+ return requestOptions;
121
170
  }
122
171
  }
123
172
  _EntraM365GroupUserSetCommand_instances = new WeakSet(), _EntraM365GroupUserSetCommand_initTelemetry = function _EntraM365GroupUserSetCommand_initTelemetry() {
124
173
  this.telemetry.push((args) => {
125
174
  Object.assign(this.telemetryProperties, {
126
175
  teamId: typeof args.options.teamId !== 'undefined',
176
+ teamName: typeof args.options.teamName !== 'undefined',
127
177
  groupId: typeof args.options.groupId !== 'undefined',
128
- role: args.options.role
178
+ groupName: typeof args.options.groupName !== 'undefined',
179
+ ids: typeof args.options.ids !== 'undefined',
180
+ userNames: typeof args.options.userNames !== 'undefined'
129
181
  });
130
182
  });
131
183
  }, _EntraM365GroupUserSetCommand_initOptions = function _EntraM365GroupUserSetCommand_initOptions() {
132
184
  this.options.unshift({
133
- option: "-i, --groupId [groupId]"
185
+ option: '-n, --userName [userName]'
186
+ }, {
187
+ option: '--ids [ids]'
188
+ }, {
189
+ option: '--userNames [userNames]'
190
+ }, {
191
+ option: '-i, --groupId [groupId]'
134
192
  }, {
135
- option: "--teamId [teamId]"
193
+ option: '--groupName [groupName]'
136
194
  }, {
137
- option: '-n, --userName <userName>'
195
+ option: '--teamId [teamId]'
196
+ }, {
197
+ option: '--teamName [teamName]'
138
198
  }, {
139
199
  option: '-r, --role <role>',
140
- autocomplete: ['Owner', 'Member']
200
+ autocomplete: this.allowedRoles
141
201
  });
142
202
  }, _EntraM365GroupUserSetCommand_initValidators = function _EntraM365GroupUserSetCommand_initValidators() {
143
203
  this.validators.push(async (args) => {
144
204
  if (args.options.teamId && !validation.isValidGuid(args.options.teamId)) {
145
- return `${args.options.teamId} is not a valid GUID`;
205
+ return `'${args.options.teamId}' is not a valid GUID for option 'teamId'.`;
146
206
  }
147
207
  if (args.options.groupId && !validation.isValidGuid(args.options.groupId)) {
148
- return `${args.options.groupId} is not a valid GUID`;
208
+ return `'${args.options.groupId}' is not a valid GUID for option 'groupId'.`;
209
+ }
210
+ if (args.options.ids) {
211
+ const isValidGUIDArrayResult = validation.isValidGuidArray(args.options.ids);
212
+ if (isValidGUIDArrayResult !== true) {
213
+ return `The following GUIDs are invalid for the option 'ids': ${isValidGUIDArrayResult}.`;
214
+ }
215
+ }
216
+ if (args.options.userNames) {
217
+ const isValidUPNArrayResult = validation.isValidUserPrincipalNameArray(args.options.userNames);
218
+ if (isValidUPNArrayResult !== true) {
219
+ return `The following user principal names are invalid for the option 'userNames': ${isValidUPNArrayResult}.`;
220
+ }
149
221
  }
150
- if (['Owner', 'Member'].indexOf(args.options.role) === -1) {
151
- return `${args.options.role} is not a valid role value. Allowed values Owner|Member`;
222
+ if (args.options.role && !this.allowedRoles.some(role => role.toLowerCase() === args.options.role.toLowerCase())) {
223
+ return `'${args.options.role}' is not a valid role. Allowed values are: ${this.allowedRoles.join(',')}`;
152
224
  }
153
225
  return true;
154
226
  });
155
227
  }, _EntraM365GroupUserSetCommand_initOptionSets = function _EntraM365GroupUserSetCommand_initOptionSets() {
156
- this.optionSets.push({ options: ['groupId', 'teamId'] });
228
+ this.optionSets.push({ options: ['groupId', 'groupName', 'teamId', 'teamName'] });
229
+ this.optionSets.push({ options: ['userName', 'ids', 'userNames'] });
230
+ }, _EntraM365GroupUserSetCommand_initTypes = function _EntraM365GroupUserSetCommand_initTypes() {
231
+ this.types.string.push('userName', 'ids', 'userNames', 'groupId', 'groupName', 'teamId', 'teamName', 'role');
157
232
  };
158
233
  export default new EntraM365GroupUserSetCommand();
159
234
  //# sourceMappingURL=m365group-user-set.js.map
@@ -35,10 +35,12 @@ export default {
35
35
  ENTERPRISEAPP_ADD: `${prefix} enterpriseapp add`,
36
36
  ENTERPRISEAPP_GET: `${prefix} enterpriseapp get`,
37
37
  ENTERPRISEAPP_LIST: `${prefix} enterpriseapp list`,
38
+ ENTERPRISEAPP_REMOVE: `${prefix} enterpriseapp remove`,
38
39
  GROUP_ADD: `${prefix} group add`,
39
40
  GROUP_GET: `${prefix} group get`,
40
41
  GROUP_LIST: `${prefix} group list`,
41
42
  GROUP_REMOVE: `${prefix} group remove`,
43
+ GROUP_SET: `${prefix} group set`,
42
44
  GROUP_USER_ADD: `${prefix} group user add`,
43
45
  GROUP_USER_LIST: `${prefix} group user list`,
44
46
  GROUP_USER_SET: `${prefix} group user set`,
@@ -92,6 +94,7 @@ export default {
92
94
  SP_ADD: `${prefix} sp add`,
93
95
  SP_GET: `${prefix} sp get`,
94
96
  SP_LIST: `${prefix} sp list`,
97
+ SP_REMOVE: `${prefix} sp remove`,
95
98
  USER_ADD: `${prefix} user add`,
96
99
  USER_GET: `${prefix} user get`,
97
100
  USER_GUEST_ADD: `${prefix} user guest add`,
@@ -29,7 +29,7 @@ class FlowGetCommand extends PowerAutomateCommand {
29
29
  await logger.logToStderr(`Retrieving information about Microsoft Flow ${args.options.name}...`);
30
30
  }
31
31
  const requestOptions = {
32
- url: `${this.resource}/providers/Microsoft.ProcessSimple/${args.options.asAdmin ? 'scopes/admin/' : ''}environments/${formatting.encodeQueryParameter(args.options.environmentName)}/flows/${formatting.encodeQueryParameter(args.options.name)}?api-version=2016-11-01`,
32
+ url: `${this.resource}/providers/Microsoft.ProcessSimple/${args.options.asAdmin ? 'scopes/admin/' : ''}environments/${formatting.encodeQueryParameter(args.options.environmentName)}/flows/${formatting.encodeQueryParameter(args.options.name)}?api-version=2016-11-01&$expand=swagger,properties.connectionreferences.apidefinition,properties.definitionsummary.operations.apioperation,operationDefinition,plan,properties.throttleData,properties.estimatedsuspensiondata,properties.licenseData`,
33
33
  headers: {
34
34
  accept: 'application/json'
35
35
  },
@@ -0,0 +1,132 @@
1
+ var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
2
+ if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
3
+ if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
4
+ return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
5
+ };
6
+ var _OneNoteNotebookAddCommand_instances, _OneNoteNotebookAddCommand_initTelemetry, _OneNoteNotebookAddCommand_initOptions, _OneNoteNotebookAddCommand_initValidators, _OneNoteNotebookAddCommand_initOptionSets;
7
+ import request from '../../../../request.js';
8
+ import { entraGroup } from '../../../../utils/entraGroup.js';
9
+ import { validation } from '../../../../utils/validation.js';
10
+ import GraphCommand from '../../../base/GraphCommand.js';
11
+ import commands from '../../commands.js';
12
+ import { spo } from '../../../../utils/spo.js';
13
+ class OneNoteNotebookAddCommand extends GraphCommand {
14
+ get name() {
15
+ return commands.NOTEBOOK_ADD;
16
+ }
17
+ get description() {
18
+ return 'Create a new OneNote notebook';
19
+ }
20
+ constructor() {
21
+ super();
22
+ _OneNoteNotebookAddCommand_instances.add(this);
23
+ __classPrivateFieldGet(this, _OneNoteNotebookAddCommand_instances, "m", _OneNoteNotebookAddCommand_initTelemetry).call(this);
24
+ __classPrivateFieldGet(this, _OneNoteNotebookAddCommand_instances, "m", _OneNoteNotebookAddCommand_initOptions).call(this);
25
+ __classPrivateFieldGet(this, _OneNoteNotebookAddCommand_instances, "m", _OneNoteNotebookAddCommand_initValidators).call(this);
26
+ __classPrivateFieldGet(this, _OneNoteNotebookAddCommand_instances, "m", _OneNoteNotebookAddCommand_initOptionSets).call(this);
27
+ }
28
+ async commandAction(logger, args) {
29
+ try {
30
+ if (this.verbose) {
31
+ await logger.logToStderr(`Creating OneNote notebook ${args.options.name}`);
32
+ }
33
+ const requestUrl = await this.getRequestUrl(args);
34
+ const requestOptions = {
35
+ url: requestUrl,
36
+ headers: {
37
+ accept: 'application/json;odata.metadata=none',
38
+ 'content-type': "application/json"
39
+ },
40
+ responseType: 'json',
41
+ data: {
42
+ displayName: args.options.name
43
+ }
44
+ };
45
+ const response = await request.post(requestOptions);
46
+ await logger.log(response);
47
+ }
48
+ catch (err) {
49
+ this.handleRejectedODataJsonPromise(err);
50
+ }
51
+ }
52
+ async getRequestUrl(args) {
53
+ let endpoint = `${this.resource}/v1.0/`;
54
+ if (args.options.userId) {
55
+ endpoint += `users/${args.options.userId}`;
56
+ }
57
+ else if (args.options.userName) {
58
+ endpoint += `users/${args.options.userName}`;
59
+ }
60
+ else if (args.options.groupId) {
61
+ endpoint += `groups/${args.options.groupId}`;
62
+ }
63
+ else if (args.options.groupName) {
64
+ const groupId = await entraGroup.getGroupIdByDisplayName(args.options.groupName);
65
+ endpoint += `groups/${groupId}`;
66
+ }
67
+ else if (args.options.webUrl) {
68
+ const siteId = await spo.getSpoGraphSiteId(args.options.webUrl);
69
+ endpoint += `sites/${siteId}`;
70
+ }
71
+ else {
72
+ endpoint += 'me';
73
+ }
74
+ endpoint += '/onenote/notebooks';
75
+ return endpoint;
76
+ }
77
+ }
78
+ _OneNoteNotebookAddCommand_instances = new WeakSet(), _OneNoteNotebookAddCommand_initTelemetry = function _OneNoteNotebookAddCommand_initTelemetry() {
79
+ this.telemetry.push((args) => {
80
+ Object.assign(this.telemetryProperties, {
81
+ userId: typeof args.options.userId !== 'undefined',
82
+ userName: typeof args.options.userName !== 'undefined',
83
+ groupId: typeof args.options.groupId !== 'undefined',
84
+ groupName: typeof args.options.groupName !== 'undefined',
85
+ webUrl: typeof args.options.webUrl !== 'undefined'
86
+ });
87
+ });
88
+ }, _OneNoteNotebookAddCommand_initOptions = function _OneNoteNotebookAddCommand_initOptions() {
89
+ this.options.unshift({
90
+ option: '-n, --name <name>'
91
+ }, {
92
+ option: '--userId [userId]'
93
+ }, {
94
+ option: '--userName [userName]'
95
+ }, {
96
+ option: '--groupId [groupId]'
97
+ }, {
98
+ option: '--groupName [groupName]'
99
+ }, {
100
+ option: '-u, --webUrl [webUrl]'
101
+ });
102
+ }, _OneNoteNotebookAddCommand_initValidators = function _OneNoteNotebookAddCommand_initValidators() {
103
+ this.validators.push(async (args) => {
104
+ // check name for invalid characters
105
+ if (args.options.name.length > 128) {
106
+ return 'The specified name is too long. It should be less than 128 characters';
107
+ }
108
+ if (/[?*/:<>|'"]/.test(args.options.name)) {
109
+ return `The specified name contains invalid characters. It cannot contain ?*/:<>|'". Please remove them and try again.`;
110
+ }
111
+ if (args.options.userId && !validation.isValidGuid(args.options.userId)) {
112
+ return `${args.options.userId} is not a valid GUID`;
113
+ }
114
+ if (args.options.groupId && !validation.isValidGuid(args.options.groupId)) {
115
+ return `${args.options.groupId} is not a valid GUID`;
116
+ }
117
+ if (args.options.webUrl) {
118
+ return validation.isValidSharePointUrl(args.options.webUrl);
119
+ }
120
+ return true;
121
+ });
122
+ }, _OneNoteNotebookAddCommand_initOptionSets = function _OneNoteNotebookAddCommand_initOptionSets() {
123
+ this.optionSets.push({
124
+ options: ['userId', 'userName', 'groupId', 'groupName', 'webUrl'],
125
+ runsWhen: (args) => {
126
+ const options = [args.options.userId, args.options.userName, args.options.groupId, args.options.groupName, args.options.webUrl];
127
+ return options.some(item => item !== undefined);
128
+ }
129
+ });
130
+ };
131
+ export default new OneNoteNotebookAddCommand();
132
+ //# sourceMappingURL=notebook-add.js.map
@@ -1,5 +1,6 @@
1
1
  const prefix = 'onenote';
2
2
  export default {
3
+ NOTEBOOK_ADD: `${prefix} notebook add`,
3
4
  NOTEBOOK_LIST: `${prefix} notebook list`,
4
5
  PAGE_LIST: `${prefix} page list`
5
6
  };
@@ -3,7 +3,7 @@ var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (
3
3
  if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
4
4
  return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
5
5
  };
6
- var _PaAppExportCommand_instances, _PaAppExportCommand_initTelemetry, _PaAppExportCommand_initOptions, _PaAppExportCommand_initValidators;
6
+ var _PaAppExportCommand_instances, _PaAppExportCommand_initTelemetry, _PaAppExportCommand_initOptions, _PaAppExportCommand_initValidators, _PaAppExportCommand_initTypes;
7
7
  import fs from 'fs';
8
8
  import path from 'path';
9
9
  import { setTimeout } from 'timers/promises';
@@ -26,14 +26,18 @@ class PaAppExportCommand extends PowerPlatformCommand {
26
26
  __classPrivateFieldGet(this, _PaAppExportCommand_instances, "m", _PaAppExportCommand_initTelemetry).call(this);
27
27
  __classPrivateFieldGet(this, _PaAppExportCommand_instances, "m", _PaAppExportCommand_initOptions).call(this);
28
28
  __classPrivateFieldGet(this, _PaAppExportCommand_instances, "m", _PaAppExportCommand_initValidators).call(this);
29
+ __classPrivateFieldGet(this, _PaAppExportCommand_instances, "m", _PaAppExportCommand_initTypes).call(this);
29
30
  }
30
31
  async commandAction(logger, args) {
31
32
  try {
32
33
  const location = await this.exportPackage(args, logger);
33
- const packageLink = await this.getPackageLink(args, logger, location);
34
- //Replace all illegal characters from the file name
35
- const illegalCharsRegEx = /[\\\/:*?"<>|]/g;
36
- const filename = args.options.packageDisplayName.replace(illegalCharsRegEx, '_');
34
+ const packageLink = await this.getPackageLink(logger, location);
35
+ let filename = args.options.name;
36
+ if (args.options.packageDisplayName) {
37
+ //Replace all illegal characters from the file name
38
+ const illegalCharsRegEx = /[\\\/:*?"<>|]/g;
39
+ filename = args.options.packageDisplayName.replace(illegalCharsRegEx, '_');
40
+ }
37
41
  const requestOptions = {
38
42
  url: packageLink,
39
43
  // Set responseType to arraybuffer, otherwise binary data will be encoded
@@ -98,7 +102,7 @@ class PaAppExportCommand extends PowerPlatformCommand {
98
102
  details: {
99
103
  creator: args.options.packageCreatedBy,
100
104
  description: args.options.packageDescription,
101
- displayName: args.options.packageDisplayName,
105
+ displayName: args.options.packageDisplayName || args.options.name,
102
106
  sourceEnvironment: args.options.packageSourceEnvironment
103
107
  },
104
108
  resources: resources
@@ -108,7 +112,7 @@ class PaAppExportCommand extends PowerPlatformCommand {
108
112
  const response = await request.post(requestOptions);
109
113
  return response.headers.location;
110
114
  }
111
- async getPackageLink(args, logger, location) {
115
+ async getPackageLink(logger, location) {
112
116
  if (this.verbose) {
113
117
  await logger.logToStderr('Retrieving the package link and waiting on the exported package.');
114
118
  }
@@ -172,6 +176,8 @@ _PaAppExportCommand_instances = new WeakSet(), _PaAppExportCommand_initTelemetry
172
176
  }
173
177
  return true;
174
178
  });
179
+ }, _PaAppExportCommand_initTypes = function _PaAppExportCommand_initTypes() {
180
+ this.types.string.push('name', 'environmentName', 'packageDisplayName', 'packageDescription', 'packageCreatedBy', 'packageSourceEnvironment', 'path');
175
181
  };
176
182
  export default new PaAppExportCommand();
177
183
  //# sourceMappingURL=app-export.js.map
@@ -0,0 +1,86 @@
1
+ var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
2
+ if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
3
+ if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
4
+ return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
5
+ };
6
+ var _SpoFolderSharingLinkGetCommand_instances, _SpoFolderSharingLinkGetCommand_initTelemetry, _SpoFolderSharingLinkGetCommand_initOptions, _SpoFolderSharingLinkGetCommand_initOptionSets, _SpoFolderSharingLinkGetCommand_initValidators, _SpoFolderSharingLinkGetCommand_initTypes;
7
+ import request from '../../../../request.js';
8
+ import { spo } from '../../../../utils/spo.js';
9
+ import { urlUtil } from '../../../../utils/urlUtil.js';
10
+ import { validation } from '../../../../utils/validation.js';
11
+ import SpoCommand from '../../../base/SpoCommand.js';
12
+ import commands from '../../commands.js';
13
+ import { drive as driveItem } from '../../../../utils/drive.js';
14
+ class SpoFolderSharingLinkGetCommand extends SpoCommand {
15
+ get name() {
16
+ return commands.FOLDER_SHARINGLINK_GET;
17
+ }
18
+ get description() {
19
+ return 'Gets details about a specific sharing link on a folder';
20
+ }
21
+ constructor() {
22
+ super();
23
+ _SpoFolderSharingLinkGetCommand_instances.add(this);
24
+ __classPrivateFieldGet(this, _SpoFolderSharingLinkGetCommand_instances, "m", _SpoFolderSharingLinkGetCommand_initTelemetry).call(this);
25
+ __classPrivateFieldGet(this, _SpoFolderSharingLinkGetCommand_instances, "m", _SpoFolderSharingLinkGetCommand_initOptions).call(this);
26
+ __classPrivateFieldGet(this, _SpoFolderSharingLinkGetCommand_instances, "m", _SpoFolderSharingLinkGetCommand_initOptionSets).call(this);
27
+ __classPrivateFieldGet(this, _SpoFolderSharingLinkGetCommand_instances, "m", _SpoFolderSharingLinkGetCommand_initValidators).call(this);
28
+ __classPrivateFieldGet(this, _SpoFolderSharingLinkGetCommand_instances, "m", _SpoFolderSharingLinkGetCommand_initTypes).call(this);
29
+ }
30
+ async commandAction(logger, args) {
31
+ if (this.verbose) {
32
+ await logger.logToStderr(`Retrieving sharing link on folder ${args.options.folderId || args.options.folderUrl}...`);
33
+ }
34
+ try {
35
+ const relFolderUrl = await spo.getFolderServerRelativeUrl(args.options.webUrl, args.options.folderUrl, args.options.folderId);
36
+ const absoluteFolderUrl = urlUtil.getAbsoluteUrl(args.options.webUrl, relFolderUrl);
37
+ const folderUrl = new URL(absoluteFolderUrl);
38
+ const siteId = await spo.getSiteId(args.options.webUrl);
39
+ const drive = await driveItem.getDriveByUrl(siteId, folderUrl);
40
+ const itemId = await driveItem.getDriveItemId(drive, folderUrl);
41
+ const requestUrl = `https://graph.microsoft.com/v1.0/drives/${drive.id}/items/${itemId}/permissions/${args.options.id}`;
42
+ const requestOptions = {
43
+ url: requestUrl,
44
+ headers: {
45
+ 'accept': 'application/json;odata.metadata=none'
46
+ },
47
+ responseType: 'json'
48
+ };
49
+ const permission = await request.get(requestOptions);
50
+ await logger.log(permission);
51
+ }
52
+ catch (err) {
53
+ this.handleRejectedODataJsonPromise(err);
54
+ }
55
+ }
56
+ }
57
+ _SpoFolderSharingLinkGetCommand_instances = new WeakSet(), _SpoFolderSharingLinkGetCommand_initTelemetry = function _SpoFolderSharingLinkGetCommand_initTelemetry() {
58
+ this.telemetry.push((args) => {
59
+ Object.assign(this.telemetryProperties, {
60
+ folderUrl: typeof args.options.folderUrl !== 'undefined',
61
+ folderId: typeof args.options.folderId !== 'undefined'
62
+ });
63
+ });
64
+ }, _SpoFolderSharingLinkGetCommand_initOptions = function _SpoFolderSharingLinkGetCommand_initOptions() {
65
+ this.options.unshift({ option: '-u, --webUrl <webUrl>' }, { option: '--folderUrl [folderUrl]' }, { option: '--folderId [folderId]' }, { option: '-i, --id <id>' });
66
+ }, _SpoFolderSharingLinkGetCommand_initOptionSets = function _SpoFolderSharingLinkGetCommand_initOptionSets() {
67
+ this.optionSets.push({ options: ['folderUrl', 'folderId'] });
68
+ }, _SpoFolderSharingLinkGetCommand_initValidators = function _SpoFolderSharingLinkGetCommand_initValidators() {
69
+ this.validators.push(async (args) => {
70
+ const isValidSharePointUrl = validation.isValidSharePointUrl(args.options.webUrl);
71
+ if (isValidSharePointUrl !== true) {
72
+ return isValidSharePointUrl;
73
+ }
74
+ if (args.options.folderId && !validation.isValidGuid(args.options.folderId)) {
75
+ return `${args.options.folderId} is not a valid GUID for option 'folderId'.`;
76
+ }
77
+ if (!validation.isValidGuid(args.options.id)) {
78
+ return `${args.options.id} is not a valid GUID for option 'id'.`;
79
+ }
80
+ return true;
81
+ });
82
+ }, _SpoFolderSharingLinkGetCommand_initTypes = function _SpoFolderSharingLinkGetCommand_initTypes() {
83
+ this.types.string.push('webUrl', 'folderUrl', 'folderId', 'id');
84
+ };
85
+ export default new SpoFolderSharingLinkGetCommand();
86
+ //# sourceMappingURL=folder-sharinglink-get.js.map