@pnp/cli-microsoft365 9.0.0-beta.2f8dd1e → 9.0.0-beta.33615bd

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 (118) hide show
  1. package/.eslintrc.cjs +1 -0
  2. package/allCommands.json +1 -1
  3. package/allCommandsFull.json +1 -1
  4. package/dist/Auth.js +10 -18
  5. package/dist/Command.js +49 -2
  6. package/dist/chili/chili.js +0 -23
  7. package/dist/cli/cli.js +61 -101
  8. package/dist/m365/app/commands/permission/permission-add.js +9 -9
  9. package/dist/m365/commands/login.js +44 -96
  10. package/dist/m365/commands/setup.js +0 -4
  11. package/dist/m365/connection/commands/connection-remove.js +6 -2
  12. package/dist/m365/connection/commands/connection-set.js +4 -1
  13. package/dist/m365/connection/commands/connection-use.js +25 -4
  14. package/dist/m365/entra/commands/group/group-user-list.js +4 -4
  15. package/dist/m365/entra/commands/m365group/m365group-conversation-post-list.js +4 -4
  16. package/dist/m365/entra/commands/m365group/m365group-recyclebinitem-list.js +3 -3
  17. package/dist/m365/entra/commands/m365group/m365group-set.js +66 -29
  18. package/dist/m365/entra/commands/m365group/m365group-user-list.js +6 -9
  19. package/dist/m365/entra/commands/multitenant/MultitenantOrganization.js +2 -0
  20. package/dist/m365/entra/commands/multitenant/multitenant-add.js +65 -0
  21. package/dist/m365/entra/commands/multitenant/multitenant-get.js +32 -0
  22. package/dist/m365/entra/commands/multitenant/multitenant-remove.js +118 -0
  23. package/dist/m365/entra/commands/multitenant/multitenant-set.js +72 -0
  24. package/dist/m365/entra/commands.js +4 -0
  25. package/dist/m365/external/commands/connection/connection-doctor.js +10 -24
  26. package/dist/m365/flow/commands/flow-list.js +23 -24
  27. package/dist/m365/graph/commands/subscription/subscription-add.js +4 -2
  28. package/dist/m365/outlook/commands/message/message-get.js +11 -11
  29. package/dist/m365/spe/ContainerTypeProperties.js +2 -0
  30. package/dist/m365/spe/commands/containertype/containertype-list.js +49 -0
  31. package/dist/m365/spe/commands.js +2 -1
  32. package/dist/m365/spfx/commands/project/base-project-command.js +36 -126
  33. package/dist/m365/spo/commands/applicationcustomizer/applicationcustomizer-get.js +16 -21
  34. package/dist/m365/spo/commands/cdn/cdn-get.js +12 -15
  35. package/dist/m365/spo/commands/cdn/cdn-set.js +6 -4
  36. package/dist/m365/spo/commands/commandset/commandset-get.js +31 -17
  37. package/dist/m365/spo/commands/contenttype/contenttype-field-list.js +124 -0
  38. package/dist/m365/spo/commands/field/field-list.js +1 -1
  39. package/dist/m365/spo/commands/file/file-roleassignment-add.js +1 -1
  40. package/dist/m365/spo/commands/file/file-roleinheritance-break.js +1 -1
  41. package/dist/m365/spo/commands/file/file-roleinheritance-reset.js +1 -1
  42. package/dist/m365/spo/commands/folder/folder-retentionlabel-ensure.js +1 -1
  43. package/dist/m365/spo/commands/group/group-member-add.js +103 -99
  44. package/dist/m365/spo/commands/list/list-list.js +1 -4
  45. package/dist/m365/spo/commands/list/list-roleassignment-add.js +46 -21
  46. package/dist/m365/spo/commands/list/list-roleassignment-remove.js +48 -46
  47. package/dist/m365/spo/commands/page/page-clientsidewebpart-add.js +2 -3
  48. package/dist/m365/spo/commands/page/page-text-add.js +2 -3
  49. package/dist/m365/spo/commands/site/site-appcatalog-remove.js +48 -24
  50. package/dist/m365/spo/commands/spo-search.js +3 -4
  51. package/dist/m365/spo/commands/tenant/tenant-applicationcustomizer-get.js +19 -5
  52. package/dist/m365/spo/commands/tenant/tenant-commandset-get.js +20 -6
  53. package/dist/m365/spo/commands/tenant/tenant-recyclebinitem-restore.js +2 -22
  54. package/dist/m365/spo/commands.js +1 -0
  55. package/dist/m365/teams/commands/meeting/meeting-attendancereport-get.js +119 -0
  56. package/dist/m365/teams/commands/message/message-remove.js +112 -0
  57. package/dist/m365/teams/commands.js +2 -0
  58. package/dist/m365/viva/commands/engage/engage-community-add.js +166 -0
  59. package/dist/m365/viva/commands.js +1 -0
  60. package/dist/utils/formatting.js +30 -1
  61. package/dist/utils/spo.js +37 -6
  62. package/dist/utils/teams.js +49 -0
  63. package/dist/utils/validation.js +19 -0
  64. package/dist/utils/zod.js +124 -0
  65. package/docs/docs/cmd/app/permission/permission-add.mdx +5 -5
  66. package/docs/docs/cmd/connection/connection-use.mdx +8 -2
  67. package/docs/docs/cmd/entra/group/group-user-list.mdx +7 -7
  68. package/docs/docs/cmd/entra/m365group/m365group-conversation-post-list.mdx +5 -5
  69. package/docs/docs/cmd/entra/m365group/m365group-recyclebinitem-list.mdx +3 -3
  70. package/docs/docs/cmd/entra/m365group/m365group-set.mdx +37 -7
  71. package/docs/docs/cmd/entra/m365group/m365group-user-list.mdx +1 -1
  72. package/docs/docs/cmd/entra/multitenant/multitenant-add.mdx +107 -0
  73. package/docs/docs/cmd/entra/multitenant/multitenant-get.mdx +94 -0
  74. package/docs/docs/cmd/entra/multitenant/multitenant-remove.mdx +58 -0
  75. package/docs/docs/cmd/entra/multitenant/multitenant-set.mdx +53 -0
  76. package/docs/docs/cmd/external/connection/connection-doctor.mdx +9 -9
  77. package/docs/docs/cmd/flow/flow-list.mdx +114 -56
  78. package/docs/docs/cmd/graph/subscription/subscription-add.mdx +18 -0
  79. package/docs/docs/cmd/outlook/message/message-get.mdx +5 -5
  80. package/docs/docs/cmd/planner/plan/plan-remove.mdx +1 -1
  81. package/docs/docs/cmd/spe/containertype/containertype-list.mdx +102 -0
  82. package/docs/docs/cmd/spo/applicationcustomizer/applicationcustomizer-get.mdx +87 -38
  83. package/docs/docs/cmd/spo/applicationcustomizer/applicationcustomizer-list.mdx +22 -28
  84. package/docs/docs/cmd/spo/cdn/cdn-set.mdx +3 -3
  85. package/docs/docs/cmd/spo/commandset/commandset-get.mdx +75 -24
  86. package/docs/docs/cmd/spo/commandset/commandset-list.mdx +26 -32
  87. package/docs/docs/cmd/spo/contenttype/contenttype-field-list.mdx +172 -0
  88. package/docs/docs/cmd/spo/contenttype/contenttype-list.mdx +3 -3
  89. package/docs/docs/cmd/spo/field/field-list.mdx +3 -3
  90. package/docs/docs/cmd/spo/file/file-retentionlabel-ensure.mdx +1 -1
  91. package/docs/docs/cmd/spo/file/file-roleassignment-add.mdx +2 -2
  92. package/docs/docs/cmd/spo/file/file-roleassignment-remove.mdx +1 -1
  93. package/docs/docs/cmd/spo/file/file-roleinheritance-break.mdx +1 -1
  94. package/docs/docs/cmd/spo/file/file-roleinheritance-reset.mdx +1 -1
  95. package/docs/docs/cmd/spo/folder/folder-retentionlabel-ensure.mdx +2 -2
  96. package/docs/docs/cmd/spo/group/group-member-add.mdx +34 -27
  97. package/docs/docs/cmd/spo/list/list-list.mdx +5 -7
  98. package/docs/docs/cmd/spo/list/list-roleassignment-add.mdx +15 -3
  99. package/docs/docs/cmd/spo/list/list-roleassignment-remove.mdx +15 -3
  100. package/docs/docs/cmd/spo/listitem/listitem-retentionlabel-ensure.mdx +4 -4
  101. package/docs/docs/cmd/spo/listitem/listitem-retentionlabel-remove.mdx +1 -1
  102. package/docs/docs/cmd/spo/listitem/listitem-roleassignment-add.mdx +9 -9
  103. package/docs/docs/cmd/spo/listitem/listitem-roleassignment-remove.mdx +7 -7
  104. package/docs/docs/cmd/spo/site/site-appcatalog-remove.mdx +11 -2
  105. package/docs/docs/cmd/spo/site/site-recyclebinitem-list.mdx +1 -1
  106. package/docs/docs/cmd/spo/tenant/tenant-applicationcustomizer-get.mdx +79 -30
  107. package/docs/docs/cmd/spo/tenant/tenant-applicationcustomizer-list.mdx +20 -19
  108. package/docs/docs/cmd/spo/tenant/tenant-commandset-get.mdx +84 -38
  109. package/docs/docs/cmd/spo/tenant/tenant-commandset-list.mdx +20 -19
  110. package/docs/docs/cmd/spo/tenant/tenant-recyclebinitem-restore.mdx +2 -49
  111. package/docs/docs/cmd/spo/web/web-roleassignment-add.mdx +1 -1
  112. package/docs/docs/cmd/spo/web/web-roleassignment-remove.mdx +1 -1
  113. package/docs/docs/cmd/teams/meeting/meeting-attendancereport-get.mdx +138 -0
  114. package/docs/docs/cmd/teams/meeting/meeting-list.mdx +7 -3
  115. package/docs/docs/cmd/teams/message/message-remove.mdx +63 -0
  116. package/docs/docs/cmd/viva/engage/engage-community-add.mdx +168 -0
  117. package/npm-shrinkwrap.json +588 -1022
  118. package/package.json +7 -3
@@ -83,7 +83,7 @@ _SpoFolderRetentionLabelEnsureCommand_instances = new WeakSet(), _SpoFolderReten
83
83
  }, {
84
84
  option: '--folderUrl [folderUrl]'
85
85
  }, {
86
- option: 'i, --folderId [folderId]'
86
+ option: '-i, --folderId [folderId]'
87
87
  });
88
88
  }, _SpoFolderRetentionLabelEnsureCommand_initValidators = function _SpoFolderRetentionLabelEnsureCommand_initValidators() {
89
89
  this.validators.push(async (args) => {
@@ -3,12 +3,10 @@ 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 _SpoGroupMemberAddCommand_instances, _SpoGroupMemberAddCommand_initTelemetry, _SpoGroupMemberAddCommand_initOptions, _SpoGroupMemberAddCommand_initValidators, _SpoGroupMemberAddCommand_initOptionSets;
6
+ var _SpoGroupMemberAddCommand_instances, _SpoGroupMemberAddCommand_initTelemetry, _SpoGroupMemberAddCommand_initOptions, _SpoGroupMemberAddCommand_initValidators, _SpoGroupMemberAddCommand_initOptionSets, _SpoGroupMemberAddCommand_initTypes;
7
7
  import request from '../../../../request.js';
8
8
  import { entraGroup } from '../../../../utils/entraGroup.js';
9
- import { entraUser } from '../../../../utils/entraUser.js';
10
9
  import { formatting } from '../../../../utils/formatting.js';
11
- import { spo } from '../../../../utils/spo.js';
12
10
  import { validation } from '../../../../utils/validation.js';
13
11
  import SpoCommand from '../../../base/SpoCommand.js';
14
12
  import commands from '../../commands.js';
@@ -20,7 +18,7 @@ class SpoGroupMemberAddCommand extends SpoCommand {
20
18
  return 'Add members to a SharePoint Group';
21
19
  }
22
20
  defaultProperties() {
23
- return ['DisplayName', 'Email'];
21
+ return ['Title', 'UserPrincipalName'];
24
22
  }
25
23
  constructor() {
26
24
  super();
@@ -29,110 +27,100 @@ class SpoGroupMemberAddCommand extends SpoCommand {
29
27
  __classPrivateFieldGet(this, _SpoGroupMemberAddCommand_instances, "m", _SpoGroupMemberAddCommand_initOptions).call(this);
30
28
  __classPrivateFieldGet(this, _SpoGroupMemberAddCommand_instances, "m", _SpoGroupMemberAddCommand_initValidators).call(this);
31
29
  __classPrivateFieldGet(this, _SpoGroupMemberAddCommand_instances, "m", _SpoGroupMemberAddCommand_initOptionSets).call(this);
30
+ __classPrivateFieldGet(this, _SpoGroupMemberAddCommand_instances, "m", _SpoGroupMemberAddCommand_initTypes).call(this);
32
31
  }
33
32
  async commandAction(logger, args) {
34
33
  try {
35
34
  if (args.options.aadGroupIds) {
36
35
  args.options.entraGroupIds = args.options.aadGroupIds;
37
- await this.warn(logger, `Option 'aadGroupIds' is deprecated. Please use 'entraGroupIds' instead`);
36
+ await this.warn(logger, `Option 'aadGroupIds' is deprecated. Please use 'entraGroupIds' instead.`);
38
37
  }
39
38
  if (args.options.aadGroupNames) {
40
39
  args.options.entraGroupNames = args.options.aadGroupNames;
41
- await this.warn(logger, `Option 'aadGroupNames' is deprecated. Please use 'entraGroupNames' instead`);
40
+ await this.warn(logger, `Option 'aadGroupNames' is deprecated. Please use 'entraGroupNames' instead.`);
42
41
  }
43
- const groupId = await this.getGroupId(args, logger);
44
- const resolvedUsernameList = await this.getValidUsers(args, logger);
42
+ const loginNames = await this.getLoginNames(logger, args.options);
43
+ let apiUrl = `${args.options.webUrl}/_api/web/SiteGroups`;
44
+ if (args.options.groupId) {
45
+ apiUrl += `/GetById(${args.options.groupId})`;
46
+ }
47
+ else {
48
+ apiUrl += `/GetByName('${formatting.encodeQueryParameter(args.options.groupName)}')`;
49
+ }
50
+ apiUrl += '/users';
45
51
  if (this.verbose) {
46
- await logger.logToStderr(`Adding resource(s) to SharePoint Group ${args.options.groupId || args.options.groupName}`);
47
- }
48
- const requestOptions = {
49
- url: `${args.options.webUrl}/_api/SP.Web.ShareObject`,
50
- headers: {
51
- accept: 'application/json;odata=nometadata',
52
- 'content-type': 'application/json;odata=nometadata'
53
- },
54
- responseType: 'json',
55
- data: {
56
- url: args.options.webUrl,
57
- peoplePickerInput: this.getFormattedUserList(resolvedUsernameList),
58
- roleValue: `group:${groupId}`
59
- }
60
- };
61
- const sharingResult = await request.post(requestOptions);
62
- if (sharingResult.ErrorMessage !== null) {
63
- throw sharingResult.ErrorMessage;
52
+ await logger.logToStderr('Adding members to group...');
53
+ }
54
+ const result = [];
55
+ for (const loginName of loginNames) {
56
+ const requestOptions = {
57
+ url: apiUrl,
58
+ headers: {
59
+ accept: 'application/json;odata=nometadata'
60
+ },
61
+ responseType: 'json',
62
+ data: {
63
+ LoginName: loginName
64
+ }
65
+ };
66
+ const response = await request.post(requestOptions);
67
+ result.push(response);
64
68
  }
65
- await logger.log(sharingResult.UsersAddedToGroup);
69
+ await logger.log(result);
66
70
  }
67
71
  catch (err) {
68
72
  this.handleRejectedODataJsonPromise(err);
69
73
  }
70
74
  }
71
- async getGroupId(args, logger) {
72
- if (this.verbose) {
73
- await logger.logToStderr(`Getting group Id for SharePoint Group ${args.options.groupId ? args.options.groupId : args.options.groupName}`);
74
- }
75
- const getGroupMethod = args.options.groupName ?
76
- `GetByName('${formatting.encodeQueryParameter(args.options.groupName)}')` :
77
- `GetById('${args.options.groupId}')`;
78
- const requestOptions = {
79
- url: `${args.options.webUrl}/_api/web/sitegroups/${getGroupMethod}?$select=Id`,
80
- headers: {
81
- 'accept': 'application/json;odata=nometadata'
82
- },
83
- responseType: 'json'
84
- };
85
- const response = await request.get(requestOptions);
86
- return response.Id;
87
- }
88
- async getValidUsers(args, logger) {
89
- if (this.verbose) {
90
- await logger.logToStderr('Checking if the specified users and groups exist');
75
+ async getLoginNames(logger, options) {
76
+ const loginNames = [];
77
+ if (options.userNames || options.emails) {
78
+ loginNames.push(...formatting.splitAndTrim(options.userNames || options.emails).map(u => `i:0#.f|membership|${u}`));
91
79
  }
92
- const validUserNames = [];
93
- const identifiers = args.options.userNames ?? args.options.emails ?? args.options.entraGroupIds ?? args.options.entraGroupNames ?? args.options.userIds.toString();
94
- await Promise.all(identifiers.split(',').map(async (identifier) => {
95
- const trimmedIdentifier = identifier.trim();
96
- try {
97
- if (args.options.userIds) {
98
- if (this.verbose) {
99
- await logger.logToStderr(`Getting AAD ID of user with ID ${trimmedIdentifier}`);
100
- }
101
- const spoUserAzureId = await spo.getUserAzureIdBySpoId(args.options.webUrl, trimmedIdentifier);
102
- validUserNames.push(spoUserAzureId);
103
- }
104
- else if (args.options.userNames) {
105
- validUserNames.push(trimmedIdentifier);
106
- }
107
- else if (args.options.entraGroupIds) {
108
- validUserNames.push(trimmedIdentifier);
109
- }
110
- else if (args.options.entraGroupNames) {
111
- if (this.verbose) {
112
- await logger.logToStderr(`Getting ID of Microsoft Entra group ${trimmedIdentifier}`);
113
- }
114
- const groupId = await entraGroup.getGroupIdByDisplayName(trimmedIdentifier);
115
- validUserNames.push(groupId);
80
+ else if (options.entraGroupIds || options.entraGroupNames) {
81
+ if (this.verbose) {
82
+ await logger.logToStderr(`Resolving ${(options.entraGroupIds || options.entraGroupNames).length} group(s)...`);
83
+ }
84
+ const groups = [];
85
+ if (options.entraGroupIds) {
86
+ const groupIds = formatting.splitAndTrim(options.entraGroupIds);
87
+ for (const groupId of groupIds) {
88
+ const group = await entraGroup.getGroupById(groupId);
89
+ groups.push(group);
116
90
  }
117
- else {
118
- if (this.verbose) {
119
- await logger.logToStderr(`Getting Microsoft Entra ID for user ${trimmedIdentifier}`);
120
- }
121
- const upn = await entraUser.getUserIdByEmail(trimmedIdentifier);
122
- validUserNames.push(upn);
91
+ }
92
+ else {
93
+ const groupNames = formatting.splitAndTrim(options.entraGroupNames);
94
+ for (const groupName of groupNames) {
95
+ const group = await entraGroup.getGroupByDisplayName(groupName);
96
+ groups.push(group);
123
97
  }
124
98
  }
125
- catch (err) {
126
- throw `Resource '${trimmedIdentifier}' does not exist.`;
99
+ // Check if group is M365 group or security group
100
+ loginNames.push(...groups.map(g => g.mailEnabled ? `c:0o.c|federateddirectoryclaimprovider|${g.id}` : `c:0t.c|tenant|${g.id}`));
101
+ }
102
+ else if (options.userIds) {
103
+ const userIds = formatting.splitAndTrim(options.userIds);
104
+ if (this.verbose) {
105
+ await logger.logToStderr(`Resolving ${userIds.length} user(s)...`);
127
106
  }
128
- }));
129
- return validUserNames;
107
+ for (const userId of userIds) {
108
+ const loginName = await this.getUserLoginNameById(options.webUrl, parseInt(userId));
109
+ loginNames.push(loginName);
110
+ }
111
+ }
112
+ return loginNames;
130
113
  }
131
- getFormattedUserList(activeUserList) {
132
- const generatedPeoplePicker = JSON.stringify(activeUserList.map(singleUsername => {
133
- return { Key: singleUsername.trim() };
134
- }));
135
- return generatedPeoplePicker;
114
+ async getUserLoginNameById(webUrl, userId) {
115
+ const requestOptions = {
116
+ url: `${webUrl}/_api/web/SiteUsers/GetById(${userId})?$select=LoginName`,
117
+ headers: {
118
+ accept: 'application/json;odata=nometadata'
119
+ },
120
+ responseType: 'json'
121
+ };
122
+ const user = await request.get(requestOptions);
123
+ return user.LoginName;
136
124
  }
137
125
  }
138
126
  _SpoGroupMemberAddCommand_instances = new WeakSet(), _SpoGroupMemberAddCommand_initTelemetry = function _SpoGroupMemberAddCommand_initTelemetry() {
@@ -177,29 +165,45 @@ _SpoGroupMemberAddCommand_instances = new WeakSet(), _SpoGroupMemberAddCommand_i
177
165
  if (isValidSharePointUrl !== true) {
178
166
  return isValidSharePointUrl;
179
167
  }
180
- if (args.options.groupId && isNaN(args.options.groupId)) {
181
- return `Specified groupId ${args.options.groupId} is not a number`;
168
+ if (args.options.groupId && !validation.isValidPositiveInteger(args.options.groupId)) {
169
+ return `Specified groupId ${args.options.groupId} is not a positive number.`;
182
170
  }
183
- const userIdReg = new RegExp(/^[0-9,]*$/);
184
- if (args.options.userIds && !userIdReg.test(args.options.userIds)) {
185
- return `${args.options.userIds} is not a number or a comma separated value`;
171
+ if (args.options.userIds) {
172
+ const isValidArray = validation.isValidPositiveIntegerArray(args.options.userIds);
173
+ if (isValidArray !== true) {
174
+ return `Option 'userIds' contains one or more invalid numbers: ${isValidArray}.`;
175
+ }
186
176
  }
187
- if (args.options.userNames && args.options.userNames.split(',').some(e => !validation.isValidUserPrincipalName(e))) {
188
- return `${args.options.userNames} contains one or more invalid usernames`;
177
+ if (args.options.userNames) {
178
+ const isValidArray = validation.isValidUserPrincipalNameArray(args.options.userNames);
179
+ if (isValidArray !== true) {
180
+ return `Option 'userNames' contains one or more invalid UPNs: ${isValidArray}.`;
181
+ }
189
182
  }
190
- if (args.options.emails && args.options.emails.split(',').some(e => !validation.isValidUserPrincipalName(e))) {
191
- return `${args.options.emails} contains one or more invalid email addresses`;
183
+ if (args.options.emails) {
184
+ const isValidArray = validation.isValidUserPrincipalNameArray(args.options.emails);
185
+ if (isValidArray !== true) {
186
+ return `Option 'emails' contains one or more invalid UPNs: ${isValidArray}.`;
187
+ }
192
188
  }
193
- if (args.options.entraGroupIds && args.options.entraGroupIds.split(',').some(e => !validation.isValidGuid(e))) {
194
- return `${args.options.entraGroupIds} contains one or more invalid GUIDs`;
189
+ if (args.options.entraGroupIds) {
190
+ const isValidArray = validation.isValidGuidArray(args.options.entraGroupIds);
191
+ if (isValidArray !== true) {
192
+ return `Option 'entraGroupIds' contains one or more invalid GUIDs: ${isValidArray}.`;
193
+ }
195
194
  }
196
- if (args.options.aadGroupIds && args.options.aadGroupIds.split(',').some(e => !validation.isValidGuid(e))) {
197
- return `${args.options.aadGroupIds} contains one or more invalid GUIDs`;
195
+ if (args.options.aadGroupIds) {
196
+ const isValidArray = validation.isValidGuidArray(args.options.aadGroupIds);
197
+ if (isValidArray !== true) {
198
+ return `Option 'aadGroupIds' contains one or more invalid GUIDs: ${isValidArray}.`;
199
+ }
198
200
  }
199
201
  return true;
200
202
  });
201
203
  }, _SpoGroupMemberAddCommand_initOptionSets = function _SpoGroupMemberAddCommand_initOptionSets() {
202
204
  this.optionSets.push({ options: ['groupId', 'groupName'] }, { options: ['userNames', 'emails', 'userIds', 'entraGroupIds', 'aadGroupIds', 'entraGroupNames', 'aadGroupNames'] });
205
+ }, _SpoGroupMemberAddCommand_initTypes = function _SpoGroupMemberAddCommand_initTypes() {
206
+ this.types.string.push('webUrl', 'groupName', 'userNames', 'emails', 'userIds', 'entraGroupIds', 'aadGroupIds', 'entraGroupNames', 'aadGroupNames');
203
207
  };
204
208
  export default new SpoGroupMemberAddCommand();
205
209
  //# sourceMappingURL=group-member-add.js.map
@@ -16,7 +16,7 @@ class SpoListListCommand extends SpoCommand {
16
16
  return 'Lists all available list in the specified site';
17
17
  }
18
18
  defaultProperties() {
19
- return ['Title', 'Url', 'Id'];
19
+ return ['Title', 'Id'];
20
20
  }
21
21
  constructor() {
22
22
  super();
@@ -36,9 +36,6 @@ class SpoListListCommand extends SpoCommand {
36
36
  queryParams.push(`$filter=${args.options.filter}`);
37
37
  }
38
38
  const listInstances = await odata.getAllItems(`${args.options.webUrl}/_api/web/lists?${queryParams.join('&')}`);
39
- listInstances.forEach(l => {
40
- l.Url = l.RootFolder.ServerRelativeUrl;
41
- });
42
39
  await logger.log(listInstances);
43
40
  }
44
41
  catch (err) {
@@ -3,8 +3,9 @@ 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 _SpoListRoleAssignmentAddCommand_instances, _SpoListRoleAssignmentAddCommand_initTelemetry, _SpoListRoleAssignmentAddCommand_initOptions, _SpoListRoleAssignmentAddCommand_initValidators, _SpoListRoleAssignmentAddCommand_initOptionSets;
6
+ var _SpoListRoleAssignmentAddCommand_instances, _SpoListRoleAssignmentAddCommand_initTelemetry, _SpoListRoleAssignmentAddCommand_initOptions, _SpoListRoleAssignmentAddCommand_initValidators, _SpoListRoleAssignmentAddCommand_initOptionSets, _SpoListRoleAssignmentAddCommand_initTypes;
7
7
  import request from '../../../../request.js';
8
+ import { entraGroup } from '../../../../utils/entraGroup.js';
8
9
  import { formatting } from '../../../../utils/formatting.js';
9
10
  import { spo } from '../../../../utils/spo.js';
10
11
  import { urlUtil } from '../../../../utils/urlUtil.js';
@@ -25,6 +26,7 @@ class SpoListRoleAssignmentAddCommand extends SpoCommand {
25
26
  __classPrivateFieldGet(this, _SpoListRoleAssignmentAddCommand_instances, "m", _SpoListRoleAssignmentAddCommand_initOptions).call(this);
26
27
  __classPrivateFieldGet(this, _SpoListRoleAssignmentAddCommand_instances, "m", _SpoListRoleAssignmentAddCommand_initValidators).call(this);
27
28
  __classPrivateFieldGet(this, _SpoListRoleAssignmentAddCommand_instances, "m", _SpoListRoleAssignmentAddCommand_initOptionSets).call(this);
29
+ __classPrivateFieldGet(this, _SpoListRoleAssignmentAddCommand_instances, "m", _SpoListRoleAssignmentAddCommand_initTypes).call(this);
28
30
  }
29
31
  async commandAction(logger, args) {
30
32
  if (this.verbose) {
@@ -42,39 +44,48 @@ class SpoListRoleAssignmentAddCommand extends SpoCommand {
42
44
  const listServerRelativeUrl = urlUtil.getServerRelativePath(args.options.webUrl, args.options.listUrl);
43
45
  requestUrl += `GetList('${formatting.encodeQueryParameter(listServerRelativeUrl)}')/`;
44
46
  }
45
- args.options.roleDefinitionId = await this.getRoleDefinitionId(args.options, logger);
47
+ const roleDefinitionId = await this.getRoleDefinitionId(args.options, logger);
48
+ let principalId = args.options.principalId;
46
49
  if (args.options.upn) {
47
- const user = await spo.getUserByEmail(args.options.webUrl, args.options.upn, logger, this.verbose);
48
- args.options.principalId = user.Id;
49
- await this.addRoleAssignment(requestUrl, logger, args.options);
50
+ const user = await spo.ensureUser(args.options.webUrl, args.options.upn);
51
+ principalId = user.Id;
50
52
  }
51
53
  else if (args.options.groupName) {
52
54
  const group = await spo.getGroupByName(args.options.webUrl, args.options.groupName, logger, this.verbose);
53
- args.options.principalId = group.Id;
54
- await this.addRoleAssignment(requestUrl, logger, args.options);
55
+ principalId = group.Id;
55
56
  }
56
- else {
57
- await this.addRoleAssignment(requestUrl, logger, args.options);
57
+ else if (args.options.entraGroupId || args.options.entraGroupName) {
58
+ if (this.verbose) {
59
+ await logger.logToStderr('Retrieving group information...');
60
+ }
61
+ let group;
62
+ if (args.options.entraGroupId) {
63
+ group = await entraGroup.getGroupById(args.options.entraGroupId);
64
+ }
65
+ else {
66
+ group = await entraGroup.getGroupByDisplayName(args.options.entraGroupName);
67
+ }
68
+ const siteUser = await spo.ensureEntraGroup(args.options.webUrl, group);
69
+ principalId = siteUser.Id;
58
70
  }
71
+ await this.addRoleAssignment(requestUrl, principalId, roleDefinitionId);
59
72
  }
60
73
  catch (err) {
61
74
  this.handleRejectedODataJsonPromise(err);
62
75
  }
63
76
  }
64
- async addRoleAssignment(requestUrl, logger, options) {
77
+ async addRoleAssignment(requestUrl, principalId, roleDefinitionId) {
65
78
  const requestOptions = {
66
- url: `${requestUrl}roleassignments/addroleassignment(principalid='${options.principalId}',roledefid='${options.roleDefinitionId}')`,
67
- method: 'POST',
79
+ url: `${requestUrl}roleassignments/addroleassignment(principalid='${principalId}',roledefid='${roleDefinitionId}')`,
68
80
  headers: {
69
- 'accept': 'application/json;odata=nometadata',
70
- 'content-type': 'application/json'
81
+ accept: 'application/json;odata=nometadata'
71
82
  },
72
83
  responseType: 'json'
73
84
  };
74
85
  return request.post(requestOptions);
75
86
  }
76
87
  async getRoleDefinitionId(options, logger) {
77
- if (!options.roleDefinitionName) {
88
+ if (options.roleDefinitionId) {
78
89
  return options.roleDefinitionId;
79
90
  }
80
91
  const roleDefinition = await spo.getRoleDefinitionByName(options.webUrl, options.roleDefinitionName, logger, this.verbose);
@@ -90,6 +101,8 @@ _SpoListRoleAssignmentAddCommand_instances = new WeakSet(), _SpoListRoleAssignme
90
101
  principalId: typeof args.options.principalId !== 'undefined',
91
102
  upn: typeof args.options.upn !== 'undefined',
92
103
  groupName: typeof args.options.groupName !== 'undefined',
104
+ entraGroupId: typeof args.options.entraGroupId !== 'undefined',
105
+ entraGroupName: typeof args.options.entraGroupName !== 'undefined',
93
106
  roleDefinitionId: typeof args.options.roleDefinitionId !== 'undefined',
94
107
  roleDefinitionName: typeof args.options.roleDefinitionName !== 'undefined'
95
108
  });
@@ -109,6 +122,10 @@ _SpoListRoleAssignmentAddCommand_instances = new WeakSet(), _SpoListRoleAssignme
109
122
  option: '--upn [upn]'
110
123
  }, {
111
124
  option: '--groupName [groupName]'
125
+ }, {
126
+ option: '--entraGroupId [entraGroupId]'
127
+ }, {
128
+ option: '--entraGroupName [entraGroupName]'
112
129
  }, {
113
130
  option: '--roleDefinitionId [roleDefinitionId]'
114
131
  }, {
@@ -121,18 +138,26 @@ _SpoListRoleAssignmentAddCommand_instances = new WeakSet(), _SpoListRoleAssignme
121
138
  return isValidSharePointUrl;
122
139
  }
123
140
  if (args.options.listId && !validation.isValidGuid(args.options.listId)) {
124
- return `${args.options.listId} is not a valid GUID`;
141
+ return `'${args.options.listId}' is not a valid GUID for option listId.`;
142
+ }
143
+ if (args.options.upn && !validation.isValidUserPrincipalName(args.options.upn)) {
144
+ return `'${args.options.upn}' is not a valid user principal name for option upn.`;
145
+ }
146
+ if (args.options.principalId && !validation.isValidPositiveInteger(args.options.principalId)) {
147
+ return `Specified principalId '${args.options.principalId}' is not a valid number.`;
125
148
  }
126
- if (args.options.principalId && isNaN(args.options.principalId)) {
127
- return `Specified principalId ${args.options.principalId} is not a number`;
149
+ if (args.options.entraGroupId && !validation.isValidGuid(args.options.entraGroupId)) {
150
+ return `'${args.options.entraGroupId}' is not a valid GUID for option entraGroupId.`;
128
151
  }
129
- if (args.options.roleDefinitionId && isNaN(args.options.roleDefinitionId)) {
130
- return `Specified roleDefinitionId ${args.options.roleDefinitionId} is not a number`;
152
+ if (args.options.roleDefinitionId && !validation.isValidPositiveInteger(args.options.roleDefinitionId)) {
153
+ return `Specified roleDefinitionId '${args.options.roleDefinitionId}' is not a valid number.`;
131
154
  }
132
155
  return true;
133
156
  });
134
157
  }, _SpoListRoleAssignmentAddCommand_initOptionSets = function _SpoListRoleAssignmentAddCommand_initOptionSets() {
135
- this.optionSets.push({ options: ['listId', 'listTitle', 'listUrl'] }, { options: ['principalId', 'upn', 'groupName'] }, { options: ['roleDefinitionId', 'roleDefinitionName'] });
158
+ this.optionSets.push({ options: ['listId', 'listTitle', 'listUrl'] }, { options: ['principalId', 'upn', 'groupName', 'entraGroupId', 'entraGroupName'] }, { options: ['roleDefinitionId', 'roleDefinitionName'] });
159
+ }, _SpoListRoleAssignmentAddCommand_initTypes = function _SpoListRoleAssignmentAddCommand_initTypes() {
160
+ this.types.string.push('webUrl', 'listId', 'listTitle', 'listUrl', 'upn', 'groupName', 'entraGroupId', 'entraGroupName', 'roleDefinitionName');
136
161
  };
137
162
  export default new SpoListRoleAssignmentAddCommand();
138
163
  //# sourceMappingURL=list-roleassignment-add.js.map
@@ -3,16 +3,16 @@ 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 _SpoListRoleAssignmentRemoveCommand_instances, _SpoListRoleAssignmentRemoveCommand_initTelemetry, _SpoListRoleAssignmentRemoveCommand_initOptions, _SpoListRoleAssignmentRemoveCommand_initValidators, _SpoListRoleAssignmentRemoveCommand_initOptionSets;
6
+ var _SpoListRoleAssignmentRemoveCommand_instances, _SpoListRoleAssignmentRemoveCommand_initTelemetry, _SpoListRoleAssignmentRemoveCommand_initOptions, _SpoListRoleAssignmentRemoveCommand_initValidators, _SpoListRoleAssignmentRemoveCommand_initOptionSets, _SpoListRoleAssignmentRemoveCommand_initTypes;
7
7
  import { cli } from '../../../../cli/cli.js';
8
8
  import request from '../../../../request.js';
9
9
  import { formatting } from '../../../../utils/formatting.js';
10
+ import { spo } from '../../../../utils/spo.js';
10
11
  import { urlUtil } from '../../../../utils/urlUtil.js';
11
12
  import { validation } from '../../../../utils/validation.js';
12
13
  import SpoCommand from '../../../base/SpoCommand.js';
13
14
  import commands from '../../commands.js';
14
- import spoGroupGetCommand from '../group/group-get.js';
15
- import spoUserGetCommand from '../user/user-get.js';
15
+ import { entraGroup } from '../../../../utils/entraGroup.js';
16
16
  class SpoListRoleAssignmentRemoveCommand extends SpoCommand {
17
17
  get name() {
18
18
  return commands.LIST_ROLEASSIGNMENT_REMOVE;
@@ -27,11 +27,12 @@ class SpoListRoleAssignmentRemoveCommand extends SpoCommand {
27
27
  __classPrivateFieldGet(this, _SpoListRoleAssignmentRemoveCommand_instances, "m", _SpoListRoleAssignmentRemoveCommand_initOptions).call(this);
28
28
  __classPrivateFieldGet(this, _SpoListRoleAssignmentRemoveCommand_instances, "m", _SpoListRoleAssignmentRemoveCommand_initValidators).call(this);
29
29
  __classPrivateFieldGet(this, _SpoListRoleAssignmentRemoveCommand_instances, "m", _SpoListRoleAssignmentRemoveCommand_initOptionSets).call(this);
30
+ __classPrivateFieldGet(this, _SpoListRoleAssignmentRemoveCommand_instances, "m", _SpoListRoleAssignmentRemoveCommand_initTypes).call(this);
30
31
  }
31
32
  async commandAction(logger, args) {
32
33
  const removeRoleAssignment = async () => {
33
34
  if (this.verbose) {
34
- await logger.logToStderr(`Removing role assignment from list in site at ${args.options.webUrl}...`);
35
+ await logger.logToStderr(`Removing role assignment from list '${args.options.listId || args.options.listTitle || args.options.listUrl}' of site ${args.options.webUrl}...`);
35
36
  }
36
37
  try {
37
38
  let requestUrl = `${args.options.webUrl}/_api/web/`;
@@ -45,17 +46,30 @@ class SpoListRoleAssignmentRemoveCommand extends SpoCommand {
45
46
  const listServerRelativeUrl = urlUtil.getServerRelativePath(args.options.webUrl, args.options.listUrl);
46
47
  requestUrl += `GetList('${formatting.encodeQueryParameter(listServerRelativeUrl)}')/`;
47
48
  }
49
+ let principalId = args.options.principalId;
48
50
  if (args.options.upn) {
49
- args.options.principalId = await this.getUserPrincipalId(args.options);
50
- await this.removeRoleAssignment(requestUrl, logger, args.options);
51
+ const user = await spo.ensureUser(args.options.webUrl, args.options.upn);
52
+ principalId = user.Id;
51
53
  }
52
54
  else if (args.options.groupName) {
53
- args.options.principalId = await this.getGroupPrincipalId(args.options);
54
- await this.removeRoleAssignment(requestUrl, logger, args.options);
55
+ const spGroup = await spo.getGroupByName(args.options.webUrl, args.options.groupName, logger, this.verbose);
56
+ principalId = spGroup.Id;
55
57
  }
56
- else {
57
- await this.removeRoleAssignment(requestUrl, logger, args.options);
58
+ else if (args.options.entraGroupId || args.options.entraGroupName) {
59
+ if (this.verbose) {
60
+ await logger.logToStderr('Retrieving group information...');
61
+ }
62
+ let group;
63
+ if (args.options.entraGroupId) {
64
+ group = await entraGroup.getGroupById(args.options.entraGroupId);
65
+ }
66
+ else {
67
+ group = await entraGroup.getGroupByDisplayName(args.options.entraGroupName);
68
+ }
69
+ const siteUser = await spo.ensureEntraGroup(args.options.webUrl, group);
70
+ principalId = siteUser.Id;
58
71
  }
72
+ await this.removeRoleAssignment(requestUrl, principalId);
59
73
  }
60
74
  catch (err) {
61
75
  this.handleRejectedODataJsonPromise(err);
@@ -65,49 +79,22 @@ class SpoListRoleAssignmentRemoveCommand extends SpoCommand {
65
79
  await removeRoleAssignment();
66
80
  }
67
81
  else {
68
- const result = await cli.promptForConfirmation({ message: `Are you sure you want to remove role assignment from list ${args.options.listId || args.options.listTitle} from site ${args.options.webUrl}?` });
82
+ const result = await cli.promptForConfirmation({ message: `Are you sure you want to remove role assignment from the specified user of list '${args.options.listId || args.options.listTitle || args.options.listUrl}'?` });
69
83
  if (result) {
70
84
  await removeRoleAssignment();
71
85
  }
72
86
  }
73
87
  }
74
- async removeRoleAssignment(requestUrl, logger, options) {
88
+ async removeRoleAssignment(requestUrl, principalId) {
75
89
  const requestOptions = {
76
- url: `${requestUrl}roleassignments/removeroleassignment(principalid='${options.principalId}')`,
77
- method: 'POST',
90
+ url: `${requestUrl}roleassignments/removeroleassignment(principalid='${principalId}')`,
78
91
  headers: {
79
- 'accept': 'application/json;odata=nometadata',
80
- 'content-type': 'application/json'
92
+ accept: 'application/json;odata=nometadata'
81
93
  },
82
94
  responseType: 'json'
83
95
  };
84
96
  return request.post(requestOptions);
85
97
  }
86
- async getGroupPrincipalId(options) {
87
- const groupGetCommandOptions = {
88
- webUrl: options.webUrl,
89
- name: options.groupName,
90
- output: 'json',
91
- debug: this.debug,
92
- verbose: this.verbose
93
- };
94
- const output = await cli.executeCommandWithOutput(spoGroupGetCommand, { options: { ...groupGetCommandOptions, _: [] } });
95
- const getGroupOutput = JSON.parse(output.stdout);
96
- return getGroupOutput.Id;
97
- }
98
- async getUserPrincipalId(options) {
99
- const userGetCommandOptions = {
100
- webUrl: options.webUrl,
101
- email: options.upn,
102
- id: undefined,
103
- output: 'json',
104
- debug: this.debug,
105
- verbose: this.verbose
106
- };
107
- const output = await cli.executeCommandWithOutput(spoUserGetCommand, { options: { ...userGetCommandOptions, _: [] } });
108
- const getUserOutput = JSON.parse(output.stdout);
109
- return getUserOutput.Id;
110
- }
111
98
  }
112
99
  _SpoListRoleAssignmentRemoveCommand_instances = new WeakSet(), _SpoListRoleAssignmentRemoveCommand_initTelemetry = function _SpoListRoleAssignmentRemoveCommand_initTelemetry() {
113
100
  this.telemetry.push((args) => {
@@ -118,7 +105,9 @@ _SpoListRoleAssignmentRemoveCommand_instances = new WeakSet(), _SpoListRoleAssig
118
105
  principalId: typeof args.options.principalId !== 'undefined',
119
106
  upn: typeof args.options.upn !== 'undefined',
120
107
  groupName: typeof args.options.groupName !== 'undefined',
121
- force: (!(!args.options.force)).toString()
108
+ entraGroupId: typeof args.options.entraGroupId !== 'undefined',
109
+ entraGroupName: typeof args.options.entraGroupName !== 'undefined',
110
+ force: !!args.options.force
122
111
  });
123
112
  });
124
113
  }, _SpoListRoleAssignmentRemoveCommand_initOptions = function _SpoListRoleAssignmentRemoveCommand_initOptions() {
@@ -136,6 +125,10 @@ _SpoListRoleAssignmentRemoveCommand_instances = new WeakSet(), _SpoListRoleAssig
136
125
  option: '--upn [upn]'
137
126
  }, {
138
127
  option: '--groupName [groupName]'
128
+ }, {
129
+ option: '--entraGroupId [entraGroupId]'
130
+ }, {
131
+ option: '--entraGroupName [entraGroupName]'
139
132
  }, {
140
133
  option: '-f, --force'
141
134
  });
@@ -146,15 +139,24 @@ _SpoListRoleAssignmentRemoveCommand_instances = new WeakSet(), _SpoListRoleAssig
146
139
  return isValidSharePointUrl;
147
140
  }
148
141
  if (args.options.listId && !validation.isValidGuid(args.options.listId)) {
149
- return `${args.options.listId} is not a valid GUID`;
142
+ return `'${args.options.listId}' is not a valid GUID for option listId.`;
143
+ }
144
+ if (args.options.upn && !validation.isValidUserPrincipalName(args.options.upn)) {
145
+ return `'${args.options.upn}' is not a valid user principal name for option upn.`;
146
+ }
147
+ if (args.options.principalId && !validation.isValidPositiveInteger(args.options.principalId)) {
148
+ return `'${args.options.principalId}' is not a valid number for option principalId.`;
150
149
  }
151
- if (args.options.principalId && isNaN(args.options.principalId)) {
152
- return `Specified principalId ${args.options.principalId} is not a number`;
150
+ if (args.options.entraGroupId && !validation.isValidGuid(args.options.entraGroupId)) {
151
+ return `'${args.options.entraGroupId}' is not a valid GUID for option entraGroupId.`;
153
152
  }
154
153
  return true;
155
154
  });
156
155
  }, _SpoListRoleAssignmentRemoveCommand_initOptionSets = function _SpoListRoleAssignmentRemoveCommand_initOptionSets() {
157
- this.optionSets.push({ options: ['listId', 'listTitle', 'listUrl'] }, { options: ['principalId', 'upn', 'groupName'] });
156
+ this.optionSets.push({ options: ['listId', 'listTitle', 'listUrl'] }, { options: ['principalId', 'upn', 'groupName', 'entraGroupId', 'entraGroupName'] });
157
+ }, _SpoListRoleAssignmentRemoveCommand_initTypes = function _SpoListRoleAssignmentRemoveCommand_initTypes() {
158
+ this.types.string.push('webUrl', 'listId', 'listTitle', 'listUrl', 'upn', 'groupName', 'entraGroupId', 'entraGroupName');
159
+ this.types.boolean.push('force');
158
160
  };
159
161
  export default new SpoListRoleAssignmentRemoveCommand();
160
162
  //# sourceMappingURL=list-roleassignment-remove.js.map
@@ -4,7 +4,6 @@ var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (
4
4
  return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
5
5
  };
6
6
  var _SpoPageClientSideWebPartAddCommand_instances, _SpoPageClientSideWebPartAddCommand_initTelemetry, _SpoPageClientSideWebPartAddCommand_initOptions, _SpoPageClientSideWebPartAddCommand_initValidators, _SpoPageClientSideWebPartAddCommand_initOptionSets;
7
- import { isNumber } from 'util';
8
7
  import { v4 } from 'uuid';
9
8
  import request from '../../../../request.js';
10
9
  import { formatting } from '../../../../utils/formatting.js';
@@ -370,10 +369,10 @@ _SpoPageClientSideWebPartAddCommand_instances = new WeakSet(), _SpoPageClientSid
370
369
  .webPartData}. Error: ${e}`;
371
370
  }
372
371
  }
373
- if (args.options.section && (!isNumber(args.options.section) || args.options.section < 1)) {
372
+ if (args.options.section && (!Number.isInteger(args.options.section) || args.options.section < 1)) {
374
373
  return 'The value of parameter section must be 1 or higher';
375
374
  }
376
- if (args.options.column && (!isNumber(args.options.column) || args.options.column < 1)) {
375
+ if (args.options.column && (!Number.isInteger(args.options.column) || args.options.column < 1)) {
377
376
  return 'The value of parameter column must be 1 or higher';
378
377
  }
379
378
  return validation.isValidSharePointUrl(args.options.webUrl);