@pnp/cli-microsoft365 4.2.0-beta.eca91f0 → 4.3.0-beta.4655645

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/.devcontainer/Dockerfile +2 -2
  2. package/.eslintrc.js +1 -0
  3. package/README.md +1 -1
  4. package/dist/Utils.js +3 -0
  5. package/dist/appInsights.js +5 -2
  6. package/dist/cli/Cli.js +26 -4
  7. package/dist/m365/aad/commands/app/app-add.js +58 -5
  8. package/dist/m365/aad/commands/app/app-get.js +97 -0
  9. package/dist/m365/aad/commands/o365group/{GroupUser.js → GroupExtended.js} +1 -1
  10. package/dist/m365/aad/commands/o365group/o365group-add.js +56 -50
  11. package/dist/m365/aad/commands/o365group/o365group-user-set.js +3 -3
  12. package/dist/m365/aad/commands/oauth2grant/oauth2grant-add.js +5 -8
  13. package/dist/m365/aad/commands/oauth2grant/oauth2grant-set.js +3 -3
  14. package/dist/m365/aad/commands/sp/sp-add.js +107 -0
  15. package/dist/m365/aad/commands/user/user-get.js +33 -6
  16. package/dist/m365/aad/commands/user/user-password-validate.js +42 -0
  17. package/dist/m365/aad/commands.js +3 -0
  18. package/dist/m365/app/commands/permission/permission-list.js +266 -0
  19. package/dist/m365/app/commands.js +7 -0
  20. package/dist/m365/base/AppCommand.js +76 -0
  21. package/dist/m365/{aad/commands/o365group/Group.js → base/M365RcJson.js} +1 -1
  22. package/dist/m365/cli/commands/cli-doctor.js +2 -0
  23. package/dist/m365/file/commands/file-add.js +32 -13
  24. package/dist/m365/file/commands/file-list.js +181 -0
  25. package/dist/m365/file/commands.js +2 -1
  26. package/dist/m365/pa/commands/app/app-list.js +28 -1
  27. package/dist/m365/planner/commands/task/task-add.js +288 -0
  28. package/dist/m365/planner/commands.js +1 -0
  29. package/dist/m365/search/commands/externalconnection/externalconnection-add.js +99 -0
  30. package/dist/m365/search/commands.js +7 -0
  31. package/dist/m365/spfx/commands/project/project-upgrade/rules/FN006005_CFG_PS_metadata.js +63 -0
  32. package/dist/m365/spfx/commands/project/project-upgrade/rules/FN006006_CFG_PS_features.js +60 -0
  33. package/dist/m365/spfx/commands/project/project-upgrade/upgrade-1.13.1.js +53 -0
  34. package/dist/m365/spfx/commands/project/project-upgrade/upgrade-1.14.0-beta.4.js +57 -0
  35. package/dist/m365/spfx/commands/project/project-upgrade.js +17 -13
  36. package/dist/m365/spfx/commands/spfx-doctor.js +176 -62
  37. package/dist/m365/spo/commands/contenttype/contenttype-list.js +52 -0
  38. package/dist/m365/spo/commands/list/list-get.js +6 -2
  39. package/dist/m365/spo/commands/listitem/listitem-attachment-list.js +90 -0
  40. package/dist/m365/spo/commands/page/Page.js +3 -1
  41. package/dist/m365/spo/commands/page/page-add.js +7 -10
  42. package/dist/m365/spo/commands/page/page-set.js +7 -10
  43. package/dist/m365/spo/commands/site/site-ensure.js +1 -1
  44. package/dist/m365/spo/commands/site/site-remove.js +98 -30
  45. package/dist/m365/spo/commands/web/web-installedlanguage-list.js +48 -0
  46. package/dist/m365/spo/commands.js +4 -1
  47. package/dist/m365/teams/commands/message/message-get.js +1 -1
  48. package/dist/m365/teams/commands/report/report-directroutingcalls.js +1 -1
  49. package/dist/m365/teams/commands/report/report-pstncalls.js +1 -1
  50. package/dist/request.js +9 -4
  51. package/docs/docs/cmd/_global.md +2 -2
  52. package/docs/docs/cmd/aad/app/app-add.md +11 -0
  53. package/docs/docs/cmd/aad/app/app-get.md +48 -0
  54. package/docs/docs/cmd/aad/o365group/o365group-add.md +1 -0
  55. package/docs/docs/cmd/aad/oauth2grant/oauth2grant-set.md +3 -2
  56. package/docs/docs/cmd/aad/sp/sp-add.md +53 -0
  57. package/docs/docs/cmd/aad/user/user-get.md +13 -4
  58. package/docs/docs/cmd/aad/user/user-password-validate.md +29 -0
  59. package/docs/docs/cmd/app/permission/permission-list.md +36 -0
  60. package/docs/docs/cmd/file/file-add.md +11 -0
  61. package/docs/docs/cmd/file/file-list.md +46 -0
  62. package/docs/docs/cmd/pa/app/app-list.md +17 -1
  63. package/docs/docs/cmd/planner/task/task-add.md +78 -0
  64. package/docs/docs/cmd/search/externalconnection/externalconnection-add.md +43 -0
  65. package/docs/docs/cmd/spfx/project/project-externalize.md +1 -1
  66. package/docs/docs/cmd/spfx/project/project-rename.md +1 -1
  67. package/docs/docs/cmd/spfx/project/project-upgrade.md +1 -1
  68. package/docs/docs/cmd/spfx/spfx-doctor.md +1 -1
  69. package/docs/docs/cmd/spo/contenttype/contenttype-list.md +33 -0
  70. package/docs/docs/cmd/spo/list/list-get.md +9 -0
  71. package/docs/docs/cmd/spo/listitem/listitem-attachment-list.md +39 -0
  72. package/docs/docs/cmd/spo/page/page-add.md +2 -2
  73. package/docs/docs/cmd/spo/page/page-set.md +3 -3
  74. package/docs/docs/cmd/spo/site/site-remove.md +3 -1
  75. package/docs/docs/cmd/spo/web/web-installedlanguage-list.md +24 -0
  76. package/docs/docs/cmd/teams/message/message-get.md +0 -3
  77. package/docs/docs/cmd/teams/report/report-directroutingcalls.md +0 -3
  78. package/docs/docs/cmd/teams/report/report-pstncalls.md +4 -3
  79. package/npm-shrinkwrap.json +1050 -1568
  80. package/package.json +30 -24
@@ -20,7 +20,7 @@ class FileAddCommand extends GraphCommand_1.default {
20
20
  folderUrlWithoutTrailingSlash = folderUrlWithoutTrailingSlash.substr(0, folderUrlWithoutTrailingSlash.length - 1);
21
21
  }
22
22
  this
23
- .getGraphFileUrl(logger, `${folderUrlWithoutTrailingSlash}/${path.basename(args.options.filePath)}`)
23
+ .getGraphFileUrl(logger, `${folderUrlWithoutTrailingSlash}/${path.basename(args.options.filePath)}`, args.options.siteUrl)
24
24
  .then(graphFileUrl => this.uploadFile(args.options.filePath, graphFileUrl))
25
25
  .then(_ => cb(), rawRes => this.handleRejectedODataJsonPromise(rawRes, logger, cb));
26
26
  }
@@ -80,20 +80,23 @@ class FileAddCommand extends GraphCommand_1.default {
80
80
  *
81
81
  * @param logger Logger instance
82
82
  * @param fileWebUrl Web URL of the file for which to get drive item URL
83
+ * @param siteUrl URL of the site to which upload the file. Optional. Specify to suppress lookup.
83
84
  * @returns Graph's drive item URL for the specified file
84
85
  */
85
- getGraphFileUrl(logger, fileWebUrl) {
86
+ getGraphFileUrl(logger, fileWebUrl, siteUrl) {
86
87
  if (this.debug) {
87
88
  logger.logToStderr(`Resolving Graph drive item URL for ${fileWebUrl}`);
88
89
  }
89
- const _url = url.parse(fileWebUrl);
90
+ const _fileWebUrl = url.parse(fileWebUrl);
91
+ const _siteUrl = url.parse(siteUrl || fileWebUrl);
92
+ const isSiteUrl = typeof siteUrl !== 'undefined';
90
93
  let siteId = '';
91
94
  let driveRelativeFileUrl = '';
92
95
  return this
93
- .getGraphSiteInfoFromFullUrl(_url.host, _url.path)
96
+ .getGraphSiteInfoFromFullUrl(_siteUrl.host, _siteUrl.path, isSiteUrl)
94
97
  .then(siteInfo => {
95
98
  siteId = siteInfo.id;
96
- let siteRelativeFileUrl = _url.path.replace(siteInfo.serverRelativeUrl, '');
99
+ let siteRelativeFileUrl = _fileWebUrl.path.replace(siteInfo.serverRelativeUrl, '');
97
100
  // normalize site-relative URLs for root site collections and root sites
98
101
  if (!siteRelativeFileUrl.startsWith('/')) {
99
102
  siteRelativeFileUrl = '/' + siteRelativeFileUrl;
@@ -116,13 +119,14 @@ class FileAddCommand extends GraphCommand_1.default {
116
119
  * Automatically detects which path chunks correspond to (sub)site.
117
120
  * @param hostName SharePoint host name, eg. contoso.sharepoint.com
118
121
  * @param urlPath Server-relative file URL, eg. /sites/site/docs/file1.aspx
122
+ * @param isSiteUrl Set to true to indicate that the specified URL is a site URL
119
123
  * @returns ID and server-relative URL of the site denoted by urlPath
120
124
  */
121
- getGraphSiteInfoFromFullUrl(hostName, urlPath) {
125
+ getGraphSiteInfoFromFullUrl(hostName, urlPath, isSiteUrl) {
122
126
  const siteId = '';
123
127
  const urlChunks = urlPath.split('/');
124
128
  return new Promise((resolve, reject) => {
125
- this.getGraphSiteInfo(hostName, urlChunks, 0, siteId, resolve, reject);
129
+ this.getGraphSiteInfo(hostName, urlChunks, isSiteUrl ? urlChunks.length - 1 : 0, siteId, resolve, reject);
126
130
  });
127
131
  }
128
132
  /**
@@ -156,20 +160,28 @@ class FileAddCommand extends GraphCommand_1.default {
156
160
  },
157
161
  responseType: 'json'
158
162
  };
163
+ const getResult = (id, serverRelativeUrl) => {
164
+ return {
165
+ id,
166
+ serverRelativeUrl
167
+ };
168
+ };
159
169
  request_1.default
160
170
  .get(requestOptions)
161
171
  .then((res) => {
162
- this.getGraphSiteInfo(hostName, urlChunks, ++currentChunk, res.id, resolve, reject);
172
+ if (currentChunk === urlChunks.length - 1) {
173
+ resolve(getResult(res.id, currentPath));
174
+ }
175
+ else {
176
+ this.getGraphSiteInfo(hostName, urlChunks, ++currentChunk, res.id, resolve, reject);
177
+ }
163
178
  }, err => {
164
179
  if (lastSiteId) {
165
180
  let serverRelativeUrl = `${urlChunks.slice(0, currentChunk).join('/')}`;
166
181
  if (!serverRelativeUrl.startsWith('/')) {
167
182
  serverRelativeUrl = '/' + serverRelativeUrl;
168
183
  }
169
- resolve({
170
- id: lastSiteId,
171
- serverRelativeUrl: serverRelativeUrl
172
- });
184
+ resolve(getResult(lastSiteId, serverRelativeUrl));
173
185
  }
174
186
  else {
175
187
  reject(err);
@@ -206,7 +218,8 @@ class FileAddCommand extends GraphCommand_1.default {
206
218
  options() {
207
219
  const options = [
208
220
  { option: '-u, --folderUrl <folderUrl>' },
209
- { option: '-p, --filePath <filePath>' }
221
+ { option: '-p, --filePath <filePath>' },
222
+ { option: '--siteUrl [siteUrl]' }
210
223
  ];
211
224
  const parentOptions = super.options();
212
225
  return options.concat(parentOptions);
@@ -215,6 +228,12 @@ class FileAddCommand extends GraphCommand_1.default {
215
228
  if (!fs.existsSync(args.options.filePath)) {
216
229
  return `Specified source file ${args.options.sourceFile} doesn't exist`;
217
230
  }
231
+ if (args.options.siteUrl) {
232
+ const isValidSiteUrl = SpoCommand_1.default.isValidSharePointUrl(args.options.siteUrl);
233
+ if (isValidSiteUrl !== true) {
234
+ return isValidSiteUrl;
235
+ }
236
+ }
218
237
  return SpoCommand_1.default.isValidSharePointUrl(args.options.folderUrl);
219
238
  }
220
239
  }
@@ -0,0 +1,181 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ const request_1 = require("../../../request");
4
+ const GraphItemsListCommand_1 = require("../../base/GraphItemsListCommand");
5
+ const SpoCommand_1 = require("../../base/SpoCommand");
6
+ const commands_1 = require("../commands");
7
+ class FileListCommand extends GraphItemsListCommand_1.GraphItemsListCommand {
8
+ constructor() {
9
+ super(...arguments);
10
+ this.foldersToGetFilesFrom = [];
11
+ }
12
+ get name() {
13
+ return commands_1.default.LIST;
14
+ }
15
+ get description() {
16
+ return 'Retrieves files from the specified folder and site';
17
+ }
18
+ defaultProperties() {
19
+ return ['name', 'lastModifiedByUser'];
20
+ }
21
+ commandAction(logger, args, cb) {
22
+ let webUrl = args.options.webUrl;
23
+ if (!webUrl.endsWith('/')) {
24
+ webUrl += '/';
25
+ }
26
+ const folderUrl = new URL(args.options.folderUrl, webUrl);
27
+ let driveId = '';
28
+ this
29
+ .getSiteId(args.options.webUrl, logger)
30
+ .then((siteId) => this.getDocumentLibrary(siteId, folderUrl, args.options.folderUrl, logger))
31
+ .then((drive) => {
32
+ driveId = drive.id;
33
+ return this.getStartingFolderId(drive, folderUrl, logger);
34
+ })
35
+ .then((folderId) => {
36
+ if (this.verbose) {
37
+ logger.logToStderr(`Loading folders to get files from...`);
38
+ }
39
+ // add the starting folder to the list of folders to get files from
40
+ this.foldersToGetFilesFrom.push(folderId);
41
+ return this.loadFoldersToGetFilesFrom(folderId, driveId, args.options.recursive);
42
+ })
43
+ .then(_ => {
44
+ if (this.debug) {
45
+ logger.logToStderr(`Folders to get files from: ${this.foldersToGetFilesFrom.join(', ')}`);
46
+ }
47
+ return this.loadFilesFromFolders(driveId, this.foldersToGetFilesFrom, logger);
48
+ })
49
+ .then(_ => {
50
+ logger.log(this.items);
51
+ cb();
52
+ }, err => this.handleRejectedODataJsonPromise(err, logger, cb));
53
+ }
54
+ getSiteId(webUrl, logger) {
55
+ if (this.verbose) {
56
+ logger.logToStderr(`Getting site id...`);
57
+ }
58
+ const url = new URL(webUrl);
59
+ const requestOptions = {
60
+ url: `${this.resource}/v1.0/sites/${encodeURIComponent(url.host)}:${url.pathname}?$select=id`,
61
+ headers: {
62
+ accept: 'application/json;odata.metadata=none'
63
+ },
64
+ responseType: 'json'
65
+ };
66
+ return request_1.default
67
+ .get(requestOptions)
68
+ .then((site) => {
69
+ if (this.verbose) {
70
+ logger.logToStderr(`Site id: ${site.id}`);
71
+ }
72
+ return site.id;
73
+ });
74
+ }
75
+ getDocumentLibrary(siteId, folderUrl, folderUrlFromUser, logger) {
76
+ if (this.verbose) {
77
+ logger.logToStderr(`Getting document library...`);
78
+ }
79
+ const requestOptions = {
80
+ url: `${this.resource}/v1.0/sites/${siteId}/drives?$select=webUrl,id`,
81
+ headers: {
82
+ accept: 'application/json;odata.metadata=none'
83
+ },
84
+ responseType: 'json'
85
+ };
86
+ return request_1.default
87
+ .get(requestOptions)
88
+ .then((drives) => {
89
+ const lowerCaseFolderUrl = folderUrl.href.toLowerCase();
90
+ const drive = drives.value
91
+ .sort((a, b) => b.webUrl.localeCompare(a.webUrl))
92
+ .find((d) => {
93
+ const driveUrl = d.webUrl.toLowerCase();
94
+ // ensure that the drive url is a prefix of the folder url
95
+ return lowerCaseFolderUrl.startsWith(driveUrl) &&
96
+ (driveUrl.length === lowerCaseFolderUrl.length ||
97
+ lowerCaseFolderUrl[driveUrl.length] === '/');
98
+ });
99
+ if (!drive) {
100
+ return Promise.reject(`Document library '${folderUrlFromUser}' not found`);
101
+ }
102
+ if (this.verbose) {
103
+ logger.logToStderr(`Document library: ${drive.webUrl}, ${drive.id}`);
104
+ }
105
+ return Promise.resolve(drive);
106
+ });
107
+ }
108
+ getStartingFolderId(documentLibrary, folderUrl, logger) {
109
+ if (this.verbose) {
110
+ logger.logToStderr(`Getting starting folder id...`);
111
+ }
112
+ const documentLibraryRelativeFolderUrl = folderUrl.href.replace(new RegExp(documentLibrary.webUrl, 'i'), '');
113
+ const requestOptions = {
114
+ url: `${this.resource}/v1.0/drives/${documentLibrary.id}/root${documentLibraryRelativeFolderUrl.length > 0 ? `:${documentLibraryRelativeFolderUrl}` : ''}?$select=id`,
115
+ headers: {
116
+ accept: 'application/json;odata.metadata=none'
117
+ },
118
+ responseType: 'json'
119
+ };
120
+ return request_1.default
121
+ .get(requestOptions)
122
+ .then((folder) => {
123
+ if (this.verbose) {
124
+ logger.logToStderr(`Starting folder id: ${folder.id}`);
125
+ }
126
+ return folder.id;
127
+ });
128
+ }
129
+ loadFoldersToGetFilesFrom(folderId, driveId, recursive) {
130
+ if (!recursive) {
131
+ return Promise.resolve();
132
+ }
133
+ const requestOptions = {
134
+ url: `${this.resource}/v1.0/drives/${driveId}/items('${folderId}')/children?$filter=folder ne null&$select=id`,
135
+ headers: {
136
+ accept: 'application/json;odata.metadata=none'
137
+ },
138
+ responseType: 'json'
139
+ };
140
+ return request_1.default
141
+ .get(requestOptions)
142
+ .then((subfolders) => {
143
+ const subfolderIds = subfolders.value.map((subfolder) => subfolder.id);
144
+ this.foldersToGetFilesFrom = this.foldersToGetFilesFrom.concat(subfolderIds);
145
+ return Promise
146
+ .all(subfolderIds.map((subfolderId) => this.loadFoldersToGetFilesFrom(subfolderId, driveId, recursive)))
147
+ .then(_ => Promise.resolve());
148
+ });
149
+ }
150
+ loadFilesFromFolders(driveId, folderIds, logger) {
151
+ if (this.verbose) {
152
+ logger.logToStderr(`Loading files from folders...`);
153
+ }
154
+ this.items = [];
155
+ return Promise
156
+ .all(folderIds.map((folderId) =>
157
+ // get items from folder. Because we can't filter out folders here
158
+ // we need to get all items from the folder and filter them out later
159
+ this.getAllItems(`${this.resource}/v1.0/drives/${driveId}/items/${folderId}/children`, logger, false)))
160
+ .then(_ => {
161
+ // remove folders from the list of files
162
+ this.items = this.items.filter((item) => item.file);
163
+ this.items.forEach(file => { var _a, _b; return file.lastModifiedByUser = (_b = (_a = file.lastModifiedBy) === null || _a === void 0 ? void 0 : _a.user) === null || _b === void 0 ? void 0 : _b.displayName; });
164
+ return Promise.resolve();
165
+ });
166
+ }
167
+ options() {
168
+ const options = [
169
+ { option: '-u, --webUrl <webUrl>' },
170
+ { option: '-f, --folderUrl <folderUrl>' },
171
+ { option: '--recursive' }
172
+ ];
173
+ const parentOptions = super.options();
174
+ return options.concat(parentOptions);
175
+ }
176
+ validate(args) {
177
+ return SpoCommand_1.default.isValidSharePointUrl(args.options.webUrl);
178
+ }
179
+ }
180
+ module.exports = new FileListCommand();
181
+ //# sourceMappingURL=file-list.js.map
@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
3
3
  const prefix = 'file';
4
4
  exports.default = {
5
5
  ADD: `${prefix} add`,
6
- CONVERT_PDF: `${prefix} convert pdf`
6
+ CONVERT_PDF: `${prefix} convert pdf`,
7
+ LIST: `${prefix} list`
7
8
  };
8
9
  //# sourceMappingURL=commands.js.map
@@ -12,8 +12,14 @@ class PaAppListCommand extends AzmgmtItemsListCommand_1.AzmgmtItemsListCommand {
12
12
  defaultProperties() {
13
13
  return ['name', 'displayName'];
14
14
  }
15
+ getTelemetryProperties(args) {
16
+ const telemetryProps = super.getTelemetryProperties(args);
17
+ telemetryProps.asAdmin = args.options.asAdmin === true;
18
+ telemetryProps.environment = typeof args.options.environment !== 'undefined';
19
+ return telemetryProps;
20
+ }
15
21
  commandAction(logger, args, cb) {
16
- const url = `${this.resource}providers/Microsoft.PowerApps/apps?api-version=2017-08-01`;
22
+ const url = `${this.resource}providers/Microsoft.PowerApps${args.options.asAdmin ? '/scopes/admin' : ''}${args.options.environment ? '/environments/' + encodeURIComponent(args.options.environment) : ''}/apps?api-version=2017-08-01`;
17
23
  this
18
24
  .getAllItems(url, logger, true)
19
25
  .then(() => {
@@ -31,6 +37,27 @@ class PaAppListCommand extends AzmgmtItemsListCommand_1.AzmgmtItemsListCommand {
31
37
  cb();
32
38
  }, (rawRes) => this.handleRejectedODataJsonPromise(rawRes, logger, cb));
33
39
  }
40
+ options() {
41
+ const options = [
42
+ {
43
+ option: '-e, --environment [environment]'
44
+ },
45
+ {
46
+ option: '--asAdmin'
47
+ }
48
+ ];
49
+ const parentOptions = super.options();
50
+ return options.concat(parentOptions);
51
+ }
52
+ validate(args) {
53
+ if (args.options.asAdmin && !args.options.environment) {
54
+ return 'When specifying the asAdmin option the environment option is required as well';
55
+ }
56
+ if (args.options.environment && !args.options.asAdmin) {
57
+ return 'When specifying the environment option the asAdmin option is required as well';
58
+ }
59
+ return true;
60
+ }
34
61
  }
35
62
  module.exports = new PaAppListCommand();
36
63
  //# sourceMappingURL=app-list.js.map
@@ -0,0 +1,288 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ const request_1 = require("../../../../request");
4
+ const Utils_1 = require("../../../../Utils");
5
+ const GraphCommand_1 = require("../../../base/GraphCommand");
6
+ const commands_1 = require("../../commands");
7
+ class PlannerTaskAddCommand extends GraphCommand_1.default {
8
+ get name() {
9
+ return commands_1.default.TASK_ADD;
10
+ }
11
+ get description() {
12
+ return 'Adds a new Microsoft Planner Task';
13
+ }
14
+ getTelemetryProperties(args) {
15
+ const telemetryProps = super.getTelemetryProperties(args);
16
+ telemetryProps.planId = typeof args.options.planId !== 'undefined';
17
+ telemetryProps.planName = typeof args.options.planName !== 'undefined';
18
+ telemetryProps.ownerGroupId = typeof args.options.ownerGroupId !== 'undefined';
19
+ telemetryProps.ownerGroupName = typeof args.options.ownerGroupName !== 'undefined';
20
+ telemetryProps.bucketId = typeof args.options.bucketId !== 'undefined';
21
+ telemetryProps.bucketName = typeof args.options.bucketName !== 'undefined';
22
+ telemetryProps.startDateTime = typeof args.options.startDateTime !== 'undefined';
23
+ telemetryProps.dueDateTime = typeof args.options.dueDateTime !== 'undefined';
24
+ telemetryProps.percentComplete = typeof args.options.percentComplete !== 'undefined';
25
+ telemetryProps.assignedToUserIds = typeof args.options.assignedToUserIds !== 'undefined';
26
+ telemetryProps.assignedToUserNames = typeof args.options.assignedToUserNames !== 'undefined';
27
+ telemetryProps.description = typeof args.options.description !== 'undefined';
28
+ telemetryProps.orderHint = typeof args.options.orderHint !== 'undefined';
29
+ return telemetryProps;
30
+ }
31
+ commandAction(logger, args, cb) {
32
+ this
33
+ .getPlanId(args)
34
+ .then(planId => {
35
+ this.planId = planId;
36
+ return this.getBucketId(args, planId);
37
+ })
38
+ .then(bucketId => {
39
+ this.bucketId = bucketId;
40
+ return this.generateUserAssignments(args);
41
+ })
42
+ .then(assignments => {
43
+ const requestOptions = {
44
+ url: `${this.resource}/v1.0/planner/tasks`,
45
+ headers: {
46
+ 'accept': 'application/json;odata.metadata=none'
47
+ },
48
+ responseType: 'json',
49
+ data: {
50
+ planId: this.planId,
51
+ bucketId: this.bucketId,
52
+ title: args.options.title,
53
+ startDateTime: args.options.startDateTime,
54
+ dueDateTime: args.options.dueDateTime,
55
+ percentComplete: args.options.percentComplete,
56
+ assignments: assignments,
57
+ orderHint: args.options.orderHint
58
+ }
59
+ };
60
+ return request_1.default.post(requestOptions);
61
+ })
62
+ .then(newTask => this.updateTaskDetails(args.options, newTask))
63
+ .then((res) => {
64
+ logger.log(res);
65
+ cb();
66
+ }, (err) => this.handleRejectedODataJsonPromise(err, logger, cb));
67
+ }
68
+ getTaskDetailsEtag(taskId) {
69
+ const requestOptions = {
70
+ url: `${this.resource}/v1.0/planner/tasks/${encodeURIComponent(taskId)}/details`,
71
+ headers: {
72
+ accept: 'application/json'
73
+ },
74
+ responseType: 'json'
75
+ };
76
+ return request_1.default
77
+ .get(requestOptions)
78
+ .then((response) => {
79
+ const etag = response ? response['@odata.etag'] : undefined;
80
+ if (!etag) {
81
+ return Promise.reject(`Error fetching task details`);
82
+ }
83
+ return Promise.resolve(etag);
84
+ });
85
+ }
86
+ updateTaskDetails(options, newTask) {
87
+ const taskId = newTask.id;
88
+ if (!options.description) {
89
+ return Promise.resolve(newTask);
90
+ }
91
+ return this
92
+ .getTaskDetailsEtag(taskId)
93
+ .then(etag => {
94
+ const requestOptionsTaskDetails = {
95
+ url: `${this.resource}/v1.0/planner/tasks/${taskId}/details`,
96
+ headers: {
97
+ 'accept': 'application/json;odata.metadata=none',
98
+ 'If-Match': etag,
99
+ 'Prefer': 'return=representation'
100
+ },
101
+ responseType: 'json',
102
+ data: {
103
+ description: options.description
104
+ }
105
+ };
106
+ return request_1.default.patch(requestOptionsTaskDetails);
107
+ })
108
+ .then(taskDetails => {
109
+ return Object.assign(Object.assign({}, newTask), taskDetails);
110
+ });
111
+ }
112
+ generateUserAssignments(args) {
113
+ const assignments = {};
114
+ if (!args.options.assignedToUserIds && !args.options.assignedToUserNames) {
115
+ return Promise.resolve(assignments);
116
+ }
117
+ return this
118
+ .getUserIds(args.options)
119
+ .then((userIds) => {
120
+ userIds.map(x => assignments[x] = {
121
+ '@odata.type': '#microsoft.graph.plannerAssignment',
122
+ orderHint: ' !'
123
+ });
124
+ return Promise.resolve(assignments);
125
+ });
126
+ }
127
+ getBucketId(args, planId) {
128
+ if (args.options.bucketId) {
129
+ return Promise.resolve(args.options.bucketId);
130
+ }
131
+ const requestOptions = {
132
+ url: `${this.resource}/v1.0/planner/plans/${planId}/buckets`,
133
+ headers: {
134
+ accept: 'application/json;odata.metadata=none'
135
+ },
136
+ responseType: 'json'
137
+ };
138
+ return request_1.default
139
+ .get(requestOptions)
140
+ .then((response) => {
141
+ const bucket = response.value.find(val => val.name === args.options.bucketName);
142
+ if (!bucket) {
143
+ return Promise.reject(`The specified bucket does not exist`);
144
+ }
145
+ return Promise.resolve(bucket.id);
146
+ });
147
+ }
148
+ getPlanId(args) {
149
+ if (args.options.planId) {
150
+ return Promise.resolve(args.options.planId);
151
+ }
152
+ return this
153
+ .getGroupId(args)
154
+ .then((groupId) => {
155
+ const requestOptions = {
156
+ url: `${this.resource}/v1.0/planner/plans?$filter=(owner eq '${groupId}')`,
157
+ headers: {
158
+ accept: 'application/json;odata.metadata=none'
159
+ },
160
+ responseType: 'json'
161
+ };
162
+ return request_1.default.get(requestOptions);
163
+ }).then((response) => {
164
+ const plan = response.value.find(val => val.title === args.options.planName);
165
+ if (!plan) {
166
+ return Promise.reject(`The specified plan does not exist`);
167
+ }
168
+ return Promise.resolve(plan.id);
169
+ });
170
+ }
171
+ getGroupId(args) {
172
+ if (args.options.ownerGroupId) {
173
+ return Promise.resolve(args.options.ownerGroupId);
174
+ }
175
+ const requestOptions = {
176
+ url: `${this.resource}/v1.0/groups?$filter=displayName eq '${encodeURIComponent(args.options.ownerGroupName)}'`,
177
+ headers: {
178
+ accept: 'application/json;odata.metadata=none'
179
+ },
180
+ responseType: 'json'
181
+ };
182
+ return request_1.default
183
+ .get(requestOptions)
184
+ .then(response => {
185
+ const group = response.value[0];
186
+ if (!group) {
187
+ return Promise.reject(`The specified owner group does not exist`);
188
+ }
189
+ return Promise.resolve(group.id);
190
+ });
191
+ }
192
+ getUserIds(options) {
193
+ if (options.assignedToUserIds) {
194
+ return Promise.resolve(options.assignedToUserIds.split(','));
195
+ }
196
+ // Hitting this section means assignedToUserNames won't be undefined
197
+ const userNames = options.assignedToUserNames;
198
+ const userArr = userNames.split(',').map(o => o.trim());
199
+ let userIds = [];
200
+ const promises = userArr.map(user => {
201
+ const requestOptions = {
202
+ url: `${this.resource}/v1.0/users?$filter=userPrincipalName eq '${Utils_1.default.encodeQueryParameter(user)}'&$select=id,userPrincipalName`,
203
+ headers: {
204
+ 'content-type': 'application/json'
205
+ },
206
+ responseType: 'json'
207
+ };
208
+ return request_1.default.get(requestOptions);
209
+ });
210
+ return Promise
211
+ .all(promises)
212
+ .then((usersRes) => {
213
+ let userUpns = [];
214
+ userUpns = usersRes.map(res => { var _a; return (_a = res.value[0]) === null || _a === void 0 ? void 0 : _a.userPrincipalName; });
215
+ userIds = usersRes.map(res => { var _a; return (_a = res.value[0]) === null || _a === void 0 ? void 0 : _a.id; });
216
+ // Find the members where no graph response was found
217
+ const invalidUsers = userArr.filter(user => !userUpns.some((upn) => (upn === null || upn === void 0 ? void 0 : upn.toLowerCase()) === user.toLowerCase()));
218
+ if (invalidUsers && invalidUsers.length > 0) {
219
+ return Promise.reject(`Cannot proceed with planner task creation. The following users provided are invalid : ${invalidUsers.join(',')}`);
220
+ }
221
+ return Promise.resolve(userIds);
222
+ });
223
+ }
224
+ options() {
225
+ const options = [
226
+ { option: '-t, --title <title>' },
227
+ { option: '--planId [planId]' },
228
+ { option: '--planName [planName]' },
229
+ { option: '--ownerGroupId [ownerGroupId]' },
230
+ { option: '--ownerGroupName [ownerGroupName]' },
231
+ { option: '--bucketId [bucketId]' },
232
+ { option: '--bucketName [bucketName]' },
233
+ { option: '--startDateTime [startDateTime]' },
234
+ { option: '--dueDateTime [dueDateTime]' },
235
+ { option: '--percentComplete [percentComplete]' },
236
+ { option: '--assignedToUserIds [assignedToUserIds]' },
237
+ { option: '--assignedToUserNames [assignedToUserNames]' },
238
+ { option: '--description [description]' },
239
+ { option: '--orderHint [orderHint]' }
240
+ ];
241
+ const parentOptions = super.options();
242
+ return options.concat(parentOptions);
243
+ }
244
+ validate(args) {
245
+ if (!args.options.planId && !args.options.planName) {
246
+ return 'Specify either planId or planName';
247
+ }
248
+ if (args.options.planId && args.options.planName) {
249
+ return 'Specify either planId or planName but not both';
250
+ }
251
+ if (args.options.planName && !args.options.ownerGroupId && !args.options.ownerGroupName) {
252
+ return 'Specify either ownerGroupId or ownerGroupName when using planName';
253
+ }
254
+ if (args.options.planName && args.options.ownerGroupId && args.options.ownerGroupName) {
255
+ return 'Specify either ownerGroupId or ownerGroupName when using planName but not both';
256
+ }
257
+ if (args.options.ownerGroupId && !Utils_1.default.isValidGuid(args.options.ownerGroupId)) {
258
+ return `${args.options.ownerGroupId} is not a valid GUID`;
259
+ }
260
+ if (!args.options.bucketId && !args.options.bucketName) {
261
+ return 'Specify either bucketId or bucketName';
262
+ }
263
+ if (args.options.bucketId && args.options.bucketName) {
264
+ return 'Specify either bucketId or bucketName but not both';
265
+ }
266
+ if (args.options.startDateTime && !Utils_1.default.isValidISODateTime(args.options.startDateTime)) {
267
+ return 'The startDateTime is not a valid ISO date string';
268
+ }
269
+ if (args.options.dueDateTime && !Utils_1.default.isValidISODateTime(args.options.dueDateTime)) {
270
+ return 'The dueDateTime is not a valid ISO date string';
271
+ }
272
+ if (args.options.percentComplete && isNaN(args.options.percentComplete)) {
273
+ return `percentComplete is not a number`;
274
+ }
275
+ if (args.options.percentComplete && (args.options.percentComplete < 0 || args.options.percentComplete > 100)) {
276
+ return `percentComplete should be between 0 and 100 `;
277
+ }
278
+ if (args.options.assignedToUserIds && !Utils_1.default.isValidGuidArray(args.options.assignedToUserIds.split(','))) {
279
+ return 'assignedToUserIds contains invalid GUID';
280
+ }
281
+ if (args.options.assignedToUserIds && args.options.assignedToUserNames) {
282
+ return 'Specify either assignedToUserIds or assignedToUserNames but not both';
283
+ }
284
+ return true;
285
+ }
286
+ }
287
+ module.exports = new PlannerTaskAddCommand();
288
+ //# sourceMappingURL=task-add.js.map
@@ -7,6 +7,7 @@ exports.default = {
7
7
  PLAN_ADD: `${prefix} plan add`,
8
8
  PLAN_GET: `${prefix} plan get`,
9
9
  PLAN_LIST: `${prefix} plan list`,
10
+ TASK_ADD: `${prefix} task add`,
10
11
  TASK_LIST: `${prefix} task list`
11
12
  };
12
13
  //# sourceMappingURL=commands.js.map