@pnp/cli-microsoft365 6.0.0 → 6.1.0-beta.825554

package/dist/m365/planner/commands/plan/plan-set.js

@@ -0,0 +1,305 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    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");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+};
+var _PlannerPlanSetCommand_instances, _PlannerPlanSetCommand_initTelemetry, _PlannerPlanSetCommand_initOptions, _PlannerPlanSetCommand_initValidators, _PlannerPlanSetCommand_initOptionSets;
+Object.defineProperty(exports, "__esModule", { value: true });
+const Auth_1 = require("../../../../Auth");
+const request_1 = require("../../../../request");
+const accessToken_1 = require("../../../../utils/accessToken");
+const formatting_1 = require("../../../../utils/formatting");
+const validation_1 = require("../../../../utils/validation");
+const aadGroup_1 = require("../../../../utils/aadGroup");
+const planner_1 = require("../../../../utils/planner");
+const GraphCommand_1 = require("../../../base/GraphCommand");
+const commands_1 = require("../../commands");
+class PlannerPlanSetCommand extends GraphCommand_1.default {
+    constructor() {
+        super();
+        _PlannerPlanSetCommand_instances.add(this);
+        __classPrivateFieldGet(this, _PlannerPlanSetCommand_instances, "m", _PlannerPlanSetCommand_initTelemetry).call(this);
+        __classPrivateFieldGet(this, _PlannerPlanSetCommand_instances, "m", _PlannerPlanSetCommand_initOptions).call(this);
+        __classPrivateFieldGet(this, _PlannerPlanSetCommand_instances, "m", _PlannerPlanSetCommand_initValidators).call(this);
+        __classPrivateFieldGet(this, _PlannerPlanSetCommand_instances, "m", _PlannerPlanSetCommand_initOptionSets).call(this);
+    }
+    get name() {
+        return commands_1.default.PLAN_SET;
+    }
+    get description() {
+        return 'Updates a Microsoft Planner plan';
+    }
+    defaultProperties() {
+        return ['id', 'title', 'createdDateTime', 'owner'];
+    }
+    allowUnknownOptions() {
+        return true;
+    }
+    getGroupId(args) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const { ownerGroupId, ownerGroupName } = args.options;
+            if (ownerGroupId) {
+                return ownerGroupId;
+            }
+            const group = yield aadGroup_1.aadGroup.getGroupByDisplayName(ownerGroupName);
+            return group.id;
+        });
+    }
+    getPlanId(args) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const { id, title } = args.options;
+            if (id) {
+                return id;
+            }
+            const groupId = yield this.getGroupId(args);
+            const plan = yield planner_1.planner.getPlanByTitle(title, groupId);
+            return plan.id;
+        });
+    }
+    getUserIds(options) {
+        if (options.shareWithUserIds) {
+            return Promise.resolve(options.shareWithUserIds.split(','));
+        }
+        const userNames = options.shareWithUserNames;
+        const userArr = userNames.split(',').map(o => o.trim());
+        const promises = userArr.map(user => {
+            const requestOptions = {
+                url: `${this.resource}/v1.0/users?$filter=userPrincipalName eq '${formatting_1.formatting.encodeQueryParameter(user)}'&$select=id,userPrincipalName`,
+                headers: {
+                    'content-type': 'application/json'
+                },
+                responseType: 'json'
+            };
+            return request_1.default.get(requestOptions);
+        });
+        return Promise
+            .all(promises)
+            .then((usersRes) => {
+            const userUpns = usersRes.map(res => { var _a; return (_a = res.value[0]) === null || _a === void 0 ? void 0 : _a.userPrincipalName; });
+            const userIds = usersRes.map(res => { var _a; return (_a = res.value[0]) === null || _a === void 0 ? void 0 : _a.id; });
+            // Find the members where no graph response was found
+            const invalidUsers = userArr.filter(user => !userUpns.some((upn) => (upn === null || upn === void 0 ? void 0 : upn.toLowerCase()) === user.toLowerCase()));
+            if (invalidUsers && invalidUsers.length > 0) {
+                return Promise.reject(`Cannot proceed with planner plan creation. The following users provided are invalid: ${invalidUsers.join(',')}`);
+            }
+            return Promise.resolve(userIds);
+        });
+    }
+    generateSharedWith(options) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const sharedWith = {};
+            const userIds = yield this.getUserIds(options);
+            userIds.map(x => sharedWith[x] = true);
+            return sharedWith;
+        });
+    }
+    getPlanEtag(planId) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const requestOptions = {
+                url: `${this.resource}/v1.0/planner/plans/${planId}`,
+                headers: {
+                    accept: 'application/json'
+                },
+                responseType: 'json'
+            };
+            const response = yield request_1.default.get(requestOptions);
+            return response['@odata.etag'];
+        });
+    }
+    getPlanDetailsEtag(planId) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const requestOptions = {
+                url: `${this.resource}/v1.0/planner/plans/${planId}/details`,
+                headers: {
+                    accept: 'application/json'
+                },
+                responseType: 'json'
+            };
+            const response = yield request_1.default.get(requestOptions);
+            return response['@odata.etag'];
+        });
+    }
+    getPlanDetails(plan) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const requestOptionsTaskDetails = {
+                url: `${this.resource}/v1.0/planner/plans/${plan.id}/details`,
+                headers: {
+                    'accept': 'application/json;odata.metadata=none',
+                    'Prefer': 'return=representation'
+                },
+                responseType: 'json'
+            };
+            const planDetails = yield request_1.default.get(requestOptionsTaskDetails);
+            return Object.assign(Object.assign({}, plan), planDetails);
+        });
+    }
+    updatePlanDetails(options, planId) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const plan = yield planner_1.planner.getPlanById(planId);
+            const categories = {};
+            let categoriesCount = 0;
+            Object.keys(options).forEach(key => {
+                if (key.indexOf('category') !== -1) {
+                    categories[key] = options[key];
+                    categoriesCount++;
+                }
+            });
+            if (!options.shareWithUserIds && !options.shareWithUserNames && categoriesCount === 0) {
+                return this.getPlanDetails(plan);
+            }
+            const requestBody = {};
+            if (options.shareWithUserIds || options.shareWithUserNames) {
+                const sharedWith = yield this.generateSharedWith(options);
+                requestBody['sharedWith'] = sharedWith;
+            }
+            if (categoriesCount > 0) {
+                requestBody['categoryDescriptions'] = categories;
+            }
+            const etag = yield this.getPlanDetailsEtag(planId);
+            const requestOptionsPlanDetails = {
+                url: `${this.resource}/v1.0/planner/plans/${planId}/details`,
+                headers: {
+                    'accept': 'application/json;odata.metadata=none',
+                    'If-Match': etag,
+                    'Prefer': 'return=representation'
+                },
+                responseType: 'json',
+                data: requestBody
+            };
+            const planDetails = yield request_1.default.patch(requestOptionsPlanDetails);
+            return Object.assign(Object.assign({}, plan), planDetails);
+        });
+    }
+    commandAction(logger, args) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (accessToken_1.accessToken.isAppOnlyAccessToken(Auth_1.default.service.accessTokens[this.resource].accessToken)) {
+                this.handleError('This command does not support application permissions.');
+                return;
+            }
+            try {
+                const planId = yield this.getPlanId(args);
+                if (args.options.newTitle) {
+                    const etag = yield this.getPlanEtag(planId);
+                    const requestOptions = {
+                        url: `${this.resource}/v1.0/planner/plans/${planId}`,
+                        headers: {
+                            accept: 'application/json;odata.metadata=none',
+                            'If-Match': etag,
+                            'Prefer': 'return=representation'
+                        },
+                        responseType: 'json',
+                        data: {
+                            "title": args.options.newTitle
+                        }
+                    };
+                    yield request_1.default.patch(requestOptions);
+                }
+                const result = yield this.updatePlanDetails(args.options, planId);
+                logger.log(result);
+            }
+            catch (err) {
+                this.handleRejectedODataJsonPromise(err);
+            }
+        });
+    }
+}
+_PlannerPlanSetCommand_instances = new WeakSet(), _PlannerPlanSetCommand_initTelemetry = function _PlannerPlanSetCommand_initTelemetry() {
+    this.telemetry.push((args) => {
+        Object.assign(this.telemetryProperties, {
+            id: typeof args.options.id !== 'undefined',
+            title: typeof args.options.title !== 'undefined',
+            ownerGroupId: typeof args.options.ownerGroupId !== 'undefined',
+            ownerGroupName: typeof args.options.ownerGroupName !== 'undefined',
+            newTitle: typeof args.options.newTitle !== 'undefined',
+            shareWithUserIds: typeof args.options.shareWithUserIds !== 'undefined',
+            shareWithUserNames: typeof args.options.shareWithUserNames !== 'undefined'
+        });
+    });
+}, _PlannerPlanSetCommand_initOptions = function _PlannerPlanSetCommand_initOptions() {
+    this.options.unshift({
+        option: '-i, --id [id]'
+    }, {
+        option: '-t, --title [title]'
+    }, {
+        option: '--ownerGroupId [ownerGroupId]'
+    }, {
+        option: '--ownerGroupName [ownerGroupName]'
+    }, {
+        option: '--newTitle [newTitle]'
+    }, {
+        option: '--shareWithUserIds [shareWithUserIds]'
+    }, {
+        option: '--shareWithUserNames [shareWithUserNames]'
+    });
+}, _PlannerPlanSetCommand_initValidators = function _PlannerPlanSetCommand_initValidators() {
+    this.validators.push((args) => __awaiter(this, void 0, void 0, function* () {
+        if (args.options.title) {
+            if (args.options.ownerGroupId && !validation_1.validation.isValidGuid(args.options.ownerGroupId)) {
+                return `${args.options.ownerGroupId} is not a valid GUID`;
+            }
+            if (!args.options.ownerGroupId && !args.options.ownerGroupName) {
+                return 'Specify either ownerGroupId or ownerGroupName when using title';
+            }
+            if (args.options.ownerGroupId && args.options.ownerGroupName) {
+                return 'Specify either ownerGroupId or ownerGroupName when using title but not both';
+            }
+        }
+        if (args.options.shareWithUserIds && args.options.shareWithUserNames) {
+            return 'Specify either shareWithUserIds or shareWithUserNames but not both';
+        }
+        if (args.options.shareWithUserIds && !validation_1.validation.isValidGuidArray(args.options.shareWithUserIds.split(','))) {
+            return 'shareWithUserIds contains invalid GUID';
+        }
+        const allowedCategories = [
+            'category1',
+            'category2',
+            'category3',
+            'category4',
+            'category5',
+            'category6',
+            'category7',
+            'category8',
+            'category9',
+            'category10',
+            'category11',
+            'category12',
+            'category13',
+            'category14',
+            'category15',
+            'category16',
+            'category17',
+            'category18',
+            'category19',
+            'category20',
+            'category21',
+            'category22',
+            'category23',
+            'category24',
+            'category25'
+        ];
+        let invalidCategoryOptions = false;
+        Object.keys(args.options).forEach(key => {
+            if (key.indexOf('category') !== -1 && allowedCategories.indexOf(key) === -1) {
+                invalidCategoryOptions = true;
+            }
+        });
+        if (invalidCategoryOptions) {
+            return 'Specify category values between category1 to category25';
+        }
+        return true;
+    }));
+}, _PlannerPlanSetCommand_initOptionSets = function _PlannerPlanSetCommand_initOptionSets() {
+    this.optionSets.push({ options: ['id', 'title'] });
+};
+module.exports = new PlannerPlanSetCommand();
+//# sourceMappingURL=plan-set.js.map

package/dist/m365/planner/commands.js

@@ -11,6 +11,7 @@ exports.default = {
     PLAN_GET: `${prefix} plan get`,
     PLAN_LIST: `${prefix} plan list`,
     PLAN_REMOVE: `${prefix} plan remove`,
+    PLAN_SET: `${prefix} plan set`,
     TASK_ADD: `${prefix} task add`,
     TASK_CHECKLISTITEM_ADD: `${prefix} task checklistitem add`,
     TASK_CHECKLISTITEM_LIST: `${prefix} task checklistitem list`,

package/dist/m365/spo/commands/contenttype/contenttype-set.js

@@ -21,6 +21,7 @@ const validation_1 = require("../../../../utils/validation");
 const SpoCommand_1 = require("../../../base/SpoCommand");
 const commands_1 = require("../../commands");
 const request_1 = require("../../../../request");
+const config_1 = require("../../../../config");
 class SpoContentTypeSetCommand extends SpoCommand_1.default {
     constructor() {
         super();
@@ -35,46 +36,32 @@ class SpoContentTypeSetCommand extends SpoCommand_1.default {
         return commands_1.default.CONTENTTYPE_SET;
     }
     get description() {
-        return 'Updates existing content type';
+        return 'Update an existing content type';
     }
     allowUnknownOptions() {
         return true;
     }
     commandAction(logger, args) {
         return __awaiter(this, void 0, void 0, function* () {
-            const requestOptions = {
-                url: `${args.options.webUrl}/_api/Web`,
-                headers: {
-                    accept: 'application/json;odata=nometadata'
-                },
-                responseType: 'json',
-                data: this.getRequestPayload(args.options)
-            };
-            if (args.options.listId) {
-                requestOptions.url += `/Lists/GetById('${formatting_1.formatting.encodeQueryParameter(args.options.listId)}')`;
-            }
-            else if (args.options.listTitle) {
-                requestOptions.url += `/Lists/GetByTitle('${formatting_1.formatting.encodeQueryParameter(args.options.listTitle)}')`;
-            }
-            else if (args.options.listUrl) {
-                requestOptions.url += `/GetList('${formatting_1.formatting.encodeQueryParameter(urlUtil_1.urlUtil.getServerRelativePath(args.options.webUrl, args.options.listUrl))}')`;
-            }
-            requestOptions.url += '/ContentTypes';
             try {
-                const contentTypeId = yield this.getContentTypeId(args.options);
-                requestOptions.url += `/GetById('${formatting_1.formatting.encodeQueryParameter(contentTypeId)}')`;
-                yield request_1.default.patch(requestOptions);
+                const contentTypeId = yield this.getContentTypeId(logger, args.options);
+                const siteId = yield this.getSiteId(logger, args.options.webUrl);
+                const webId = yield this.getWebId(logger, args.options.webUrl);
+                yield this.updateContentType(logger, siteId, webId, contentTypeId, args.options);
             }
             catch (err) {
-                this.handleRejectedPromise(err);
+                this.handleRejectedODataJsonPromise(err);
             }
         });
     }
-    getContentTypeId(options) {
+    getContentTypeId(logger, options) {
         return __awaiter(this, void 0, void 0, function* () {
             if (options.id) {
                 return options.id;
             }
+            if (this.verbose) {
+                logger.logToStderr(`Retrieving content type to update...`);
+            }
             const requestOptions = {
                 url: `${options.webUrl}/_api/Web`,
                 headers: {
@@ -99,6 +86,27 @@ class SpoContentTypeSetCommand extends SpoCommand_1.default {
             return res.value[0].Id.StringValue;
         });
     }
+    updateContentType(logger, siteId, webId, contentTypeId, options) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (this.verbose) {
+                logger.logToStderr(`Updating content type...`);
+            }
+            const payload = this.getRequestPayload(options);
+            const requestOptions = {
+                url: `${options.webUrl}/_vti_bin/client.svc/ProcessQuery`,
+                headers: {
+                    'Content-Type': 'text/xml'
+                },
+                data: `<Request AddExpandoFieldTypeSuffix="true" SchemaVersion="15.0.0.0" LibraryVersion="16.0.0.0" ApplicationName="${config_1.default.applicationName}" xmlns="http://schemas.microsoft.com/sharepoint/clientquery/2009"><Actions>${payload}</Actions><ObjectPaths><Identity Id="9" Name="fc4179a0-e0d7-5000-c38b-bc3506fbab6f|740c6a0b-85e2-48a0-a494-e0f1759d4aa7:site:${siteId}:web:${webId}:contenttype:${formatting_1.formatting.escapeXml(contentTypeId)}" /></ObjectPaths></Request>`
+            };
+            const res = yield request_1.default.post(requestOptions);
+            const json = JSON.parse(res);
+            const response = json[0];
+            if (response.ErrorInfo) {
+                throw response.ErrorInfo.ErrorMessage;
+            }
+        });
+    }
     getRequestPayload(options) {
         const excludeOptions = [
             'webUrl',
@@ -110,15 +118,51 @@ class SpoContentTypeSetCommand extends SpoCommand_1.default {
             'query',
             'debug',
             'verbose',
-            'output'
+            'output',
+            'updateChildren'
         ];
+        let i = 12;
         const payload = Object.keys(options)
             .filter(key => excludeOptions.indexOf(key) === -1)
-            .reduce((object, key) => {
-            object[key] = options[key];
-            return object;
-        }, {});
-        return payload;
+            .map(key => {
+            return `<SetProperty Id="${i++}" ObjectPathId="9" Name="${key}"><Parameter Type="String">${formatting_1.formatting.escapeXml(options[key])}</Parameter></SetProperty>`;
+        });
+        if (options.updateChildren) {
+            payload.push(`<Method Name="Update" Id="${i++}" ObjectPathId="9"><Parameters><Parameter Type="Boolean">true</Parameter></Parameters></Method>`);
+        }
+        return payload.join('');
+    }
+    getSiteId(logger, webUrl) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (this.verbose) {
+                logger.logToStderr(`Retrieving site collection id...`);
+            }
+            const requestOptions = {
+                url: `${webUrl}/_api/site?$select=Id`,
+                headers: {
+                    accept: 'application/json;odata=nometadata'
+                },
+                responseType: 'json'
+            };
+            const site = yield request_1.default.get(requestOptions);
+            return site.Id;
+        });
+    }
+    getWebId(logger, webUrl) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (this.verbose) {
+                logger.logToStderr(`Retrieving web id...`);
+            }
+            const requestOptions = {
+                url: `${webUrl}/_api/web?$select=Id`,
+                headers: {
+                    accept: 'application/json;odata=nometadata'
+                },
+                responseType: 'json'
+            };
+            const web = yield request_1.default.get(requestOptions);
+            return web.Id;
+        });
     }
 }
 _SpoContentTypeSetCommand_instances = new WeakSet(), _SpoContentTypeSetCommand_initTelemetry = function _SpoContentTypeSetCommand_initTelemetry() {
@@ -128,7 +172,8 @@ _SpoContentTypeSetCommand_instances = new WeakSet(), _SpoContentTypeSetCommand_i
             name: typeof args.options.name !== 'undefined',
             listTitle: typeof args.options.listTitle !== 'undefined',
             listId: typeof args.options.listId !== 'undefined',
-            listUrl: typeof args.options.listUrl !== 'undefined'
+            listUrl: typeof args.options.listUrl !== 'undefined',
+            updateChildren: args.options.updateChildren
         });
     });
 }, _SpoContentTypeSetCommand_initOptions = function _SpoContentTypeSetCommand_initOptions() {
@@ -144,6 +189,8 @@ _SpoContentTypeSetCommand_instances = new WeakSet(), _SpoContentTypeSetCommand_i
         option: '--listId [listId]'
     }, {
         option: '--listUrl [listUrl]'
+    }, {
+        option: '--updateChildren'
     });
 }, _SpoContentTypeSetCommand_initValidators = function _SpoContentTypeSetCommand_initValidators() {
     this.validators.push((args) => __awaiter(this, void 0, void 0, function* () {

package/dist/m365/spo/commands/file/file-get.js

@@ -21,9 +21,7 @@ const request_1 = require("../../../../request");
 const formatting_1 = require("../../../../utils/formatting");
 const validation_1 = require("../../../../utils/validation");
 const SpoCommand_1 = require("../../../base/SpoCommand");
-const base_permissions_1 = require("../../base-permissions");
 const commands_1 = require("../../commands");
-const RoleType_1 = require("../roledefinition/RoleType");
 class SpoFileGetCommand extends SpoCommand_1.default {
     constructor() {
         super();
@@ -107,10 +105,12 @@ class SpoFileGetCommand extends SpoCommand_1.default {
                         if (args.options.withPermissions) {
                             requestOptions.url = `${args.options.webUrl}/_api/web/GetFileByServerRelativePath(DecodedUrl='${file.ServerRelativeUrl}')/ListItemAllFields/RoleAssignments?$expand=Member,RoleDefinitionBindings`;
                             const response = yield request_1.default.get(requestOptions);
-                            const roleAssignments = this.setFriendlyPermissions(response.value);
-                            fileProperties.RoleAssignments = roleAssignments;
+                            response.value.forEach((r) => {
+                                r.RoleDefinitionBindings = formatting_1.formatting.setFriendlyPermissions(r.RoleDefinitionBindings);
+                            });
+                            fileProperties.RoleAssignments = response.value;
                             if (args.options.asListItem) {
-                                fileProperties.ListItemAllFields.RoleAssignments = roleAssignments;
+                                fileProperties.ListItemAllFields.RoleAssignments = response.value;
                             }
                         }
                         logger.log(args.options.asListItem ? fileProperties.ListItemAllFields : fileProperties);
@@ -122,18 +122,6 @@ class SpoFileGetCommand extends SpoCommand_1.default {
             }
         });
     }
-    setFriendlyPermissions(response) {
-        response.forEach((r) => {
-            r.RoleDefinitionBindings.forEach((r) => {
-                const permissions = new base_permissions_1.BasePermissions();
-                permissions.high = r.BasePermissions.High;
-                permissions.low = r.BasePermissions.Low;
-                r.BasePermissionsValue = permissions.parse();
-                r.RoleTypeKindValue = RoleType_1.RoleType[r.RoleTypeKind];
-            });
-        });
-        return response;
-    }
 }
 _SpoFileGetCommand_instances = new WeakSet(), _SpoFileGetCommand_initTelemetry = function _SpoFileGetCommand_initTelemetry() {
     this.telemetry.push((args) => {

package/dist/m365/spo/commands/folder/folder-get.js

@@ -23,8 +23,6 @@ const validation_1 = require("../../../../utils/validation");
 const SpoCommand_1 = require("../../../base/SpoCommand");
 const commands_1 = require("../../commands");
 const ListPrincipalType_1 = require("../list/ListPrincipalType");
-const base_permissions_1 = require("../../base-permissions");
-const RoleType_1 = require("../../commands/roledefinition/RoleType");
 class SpoFolderGetCommand extends SpoCommand_1.default {
     constructor() {
         super();
@@ -72,13 +70,7 @@ class SpoFolderGetCommand extends SpoCommand_1.default {
                     }
                     listItemAllFields.RoleAssignments.forEach(r => {
                         r.Member.PrincipalTypeString = ListPrincipalType_1.ListPrincipalType[r.Member.PrincipalType];
-                        r.RoleDefinitionBindings.forEach(rb => {
-                            const permissions = new base_permissions_1.BasePermissions();
-                            permissions.high = rb.BasePermissions.High;
-                            permissions.low = rb.BasePermissions.Low;
-                            rb.BasePermissionsValue = permissions.parse();
-                            rb.RoleTypeKindValue = RoleType_1.RoleType[rb.RoleTypeKind];
-                        });
+                        r.RoleDefinitionBindings = formatting_1.formatting.setFriendlyPermissions(r.RoleDefinitionBindings);
                     });
                 }
                 logger.log(folder);

package/dist/m365/spo/commands/listitem/listitem-get.js

@@ -20,9 +20,7 @@ const formatting_1 = require("../../../../utils/formatting");
 const urlUtil_1 = require("../../../../utils/urlUtil");
 const validation_1 = require("../../../../utils/validation");
 const SpoCommand_1 = require("../../../base/SpoCommand");
-const base_permissions_1 = require("../../base-permissions");
 const commands_1 = require("../../commands");
-const RoleType_1 = require("../roledefinition/RoleType");
 class SpoListItemGetCommand extends SpoCommand_1.default {
     constructor() {
         super();
@@ -72,8 +70,10 @@ class SpoListItemGetCommand extends SpoCommand_1.default {
                 if (args.options.withPermissions) {
                     requestOptions.url = `${requestUrl}/items(${args.options.id})/RoleAssignments?$expand=Member,RoleDefinitionBindings`;
                     const response = yield request_1.default.get(requestOptions);
-                    const roleAssignments = this.setFriendlyPermissions(response.value);
-                    itemProperties.RoleAssignments = roleAssignments;
+                    response.value.forEach((r) => {
+                        r.RoleDefinitionBindings = formatting_1.formatting.setFriendlyPermissions(r.RoleDefinitionBindings);
+                    });
+                    itemProperties.RoleAssignments = response.value;
                 }
                 delete itemProperties['ID'];
                 logger.log(itemProperties);
@@ -83,18 +83,6 @@ class SpoListItemGetCommand extends SpoCommand_1.default {
             }
         });
     }
-    setFriendlyPermissions(response) {
-        response.forEach((r) => {
-            r.RoleDefinitionBindings.forEach((r) => {
-                const permissions = new base_permissions_1.BasePermissions();
-                permissions.high = r.BasePermissions.High;
-                permissions.low = r.BasePermissions.Low;
-                r.BasePermissionsValue = permissions.parse();
-                r.RoleTypeKindValue = RoleType_1.RoleType[r.RoleTypeKind];
-            });
-        });
-        return response;
-    }
 }
 _SpoListItemGetCommand_instances = new WeakSet(), _SpoListItemGetCommand_initTelemetry = function _SpoListItemGetCommand_initTelemetry() {
     this.telemetry.push((args) => {

package/dist/m365/spo/commands/listitem/listitem-set.js

@@ -127,16 +127,17 @@ class SpoListItemSetCommand extends SpoCommand_1.default {
                     objectIdentity = yield this.requestObjectIdentity(args.options.webUrl, logger, formDigestValue);
                 }
                 const additionalContentType = (args.options.systemUpdate && args.options.contentType && contentTypeName !== '') ? `
+          <Method Name="ParseAndSetFieldValue" Id="1" ObjectPathId="147">
             <Parameters>
               <Parameter Type="String">ContentType</Parameter>
               <Parameter Type="String">${contentTypeName}</Parameter>
-            </Parameters>`
+            </Parameters>
+          </Method>`
                     : ``;
                 const requestBody = args.options.systemUpdate ?
                     `<Request AddExpandoFieldTypeSuffix="true" SchemaVersion="15.0.0.0" LibraryVersion="16.0.0.0" ApplicationName="${config_1.default.applicationName}" xmlns="http://schemas.microsoft.com/sharepoint/clientquery/2009">
           <Actions>
-            <Method Name="ParseAndSetFieldValue" Id="1" ObjectPathId="147">${this.mapRequestBody(args.options).join()}${additionalContentType}
-            </Method>
+            ${this.mapRequestBody(args.options).join('')}${additionalContentType}
             <Method Name="SystemUpdate" Id="2" ObjectPathId="147" />
           </Actions>
           <ObjectPaths>
@@ -231,10 +232,12 @@ class SpoListItemSetCommand extends SpoCommand_1.default {
             if (excludeOptions.indexOf(key) === -1) {
                 if (options.systemUpdate) {
                     requestBody.push(`
+          <Method Name="ParseAndSetFieldValue" Id="1" ObjectPathId="147">
             <Parameters>
               <Parameter Type="String">${key}</Parameter>
               <Parameter Type="String">${options[key].toString()}</Parameter>
-            </Parameters>`);
+            </Parameters>
+          </Method>`);
                 }
                 else {
                     requestBody.push({ FieldName: key, FieldValue: options[key].toString() });

package/dist/m365/spo/commands/navigation/navigation-node-add.js

@@ -13,7 +13,7 @@ var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (
     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");
     return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
 };
-var _SpoNavigationNodeAddCommand_instances, _SpoNavigationNodeAddCommand_initTelemetry, _SpoNavigationNodeAddCommand_initOptions, _SpoNavigationNodeAddCommand_initValidators;
+var _SpoNavigationNodeAddCommand_instances, _SpoNavigationNodeAddCommand_initTelemetry, _SpoNavigationNodeAddCommand_initOptions, _SpoNavigationNodeAddCommand_initValidators, _SpoNavigationNodeAddCommand_initOptionSets;
 Object.defineProperty(exports, "__esModule", { value: true });
 const request_1 = require("../../../../request");
 const validation_1 = require("../../../../utils/validation");
@@ -26,6 +26,7 @@ class SpoNavigationNodeAddCommand extends SpoCommand_1.default {
         __classPrivateFieldGet(this, _SpoNavigationNodeAddCommand_instances, "m", _SpoNavigationNodeAddCommand_initTelemetry).call(this);
         __classPrivateFieldGet(this, _SpoNavigationNodeAddCommand_instances, "m", _SpoNavigationNodeAddCommand_initOptions).call(this);
         __classPrivateFieldGet(this, _SpoNavigationNodeAddCommand_instances, "m", _SpoNavigationNodeAddCommand_initValidators).call(this);
+        __classPrivateFieldGet(this, _SpoNavigationNodeAddCommand_instances, "m", _SpoNavigationNodeAddCommand_initOptionSets).call(this);
     }
     get name() {
         return commands_1.default.NAVIGATION_NODE_ADD;
@@ -71,6 +72,7 @@ _SpoNavigationNodeAddCommand_instances = new WeakSet(), _SpoNavigationNodeAddCom
     this.telemetry.push((args) => {
         Object.assign(this.telemetryProperties, {
             isExternal: args.options.isExternal,
+            location: typeof args.options.location !== 'undefined',
             parentNodeId: typeof args.options.parentNodeId !== 'undefined'
         });
     });
@@ -108,6 +110,8 @@ _SpoNavigationNodeAddCommand_instances = new WeakSet(), _SpoNavigationNodeAddCom
         }
         return true;
     }));
+}, _SpoNavigationNodeAddCommand_initOptionSets = function _SpoNavigationNodeAddCommand_initOptionSets() {
+    this.optionSets.push({ options: ['location', 'parentNodeId'] });
 };
 module.exports = new SpoNavigationNodeAddCommand();
 //# sourceMappingURL=navigation-node-add.js.map

package/dist/m365/spo/commands/roledefinition/roledefinition-list.js

@@ -16,11 +16,10 @@ var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (
 var _SpoRoleDefinitionListCommand_instances, _SpoRoleDefinitionListCommand_initOptions, _SpoRoleDefinitionListCommand_initValidators;
 Object.defineProperty(exports, "__esModule", { value: true });
 const odata_1 = require("../../../../utils/odata");
+const formatting_1 = require("../../../../utils/formatting");
 const validation_1 = require("../../../../utils/validation");
 const SpoCommand_1 = require("../../../base/SpoCommand");
-const base_permissions_1 = require("../../base-permissions");
 const commands_1 = require("../../commands");
-const RoleType_1 = require("./RoleType");
 class SpoRoleDefinitionListCommand extends SpoCommand_1.default {
     constructor() {
         super();
@@ -44,7 +43,7 @@ class SpoRoleDefinitionListCommand extends SpoCommand_1.default {
             }
             try {
                 const res = yield odata_1.odata.getAllItems(`${args.options.webUrl}/_api/web/roledefinitions`);
-                const response = this.setFriendlyPermissions(res);
+                const response = formatting_1.formatting.setFriendlyPermissions(res);
                 logger.log(response);
             }
             catch (err) {
@@ -52,16 +51,6 @@ class SpoRoleDefinitionListCommand extends SpoCommand_1.default {
             }
         });
     }
-    setFriendlyPermissions(response) {
-        response.forEach((r) => {
-            const permissions = new base_permissions_1.BasePermissions();
-            permissions.high = r.BasePermissions.High;
-            permissions.low = r.BasePermissions.Low;
-            r.BasePermissionsValue = permissions.parse();
-            r.RoleTypeKindValue = RoleType_1.RoleType[r.RoleTypeKind];
-        });
-        return response;
-    }
 }
 _SpoRoleDefinitionListCommand_instances = new WeakSet(), _SpoRoleDefinitionListCommand_initOptions = function _SpoRoleDefinitionListCommand_initOptions() {
     this.options.unshift({

package/dist/m365/spo/commands/web/web-get.js

@@ -16,11 +16,10 @@ var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (
 var _SpoWebGetCommand_instances, _SpoWebGetCommand_initTelemetry, _SpoWebGetCommand_initOptions, _SpoWebGetCommand_initValidators;
 Object.defineProperty(exports, "__esModule", { value: true });
 const request_1 = require("../../../../request");
+const formatting_1 = require("../../../../utils/formatting");
 const validation_1 = require("../../../../utils/validation");
 const SpoCommand_1 = require("../../../base/SpoCommand");
-const base_permissions_1 = require("../../base-permissions");
 const commands_1 = require("../../commands");
-const RoleType_1 = require("../roledefinition/RoleType");
 class SpoWebGetCommand extends SpoCommand_1.default {
     constructor() {
         super();
@@ -53,8 +52,10 @@ class SpoWebGetCommand extends SpoCommand_1.default {
                 if (args.options.withPermissions) {
                     requestOptions.url = `${args.options.url}/_api/web/RoleAssignments?$expand=Member,RoleDefinitionBindings`;
                     const response = yield request_1.default.get(requestOptions);
-                    const roleAssignments = this.setFriendlyPermissions(response.value);
-                    webProperties.RoleAssignments = roleAssignments;
+                    response.value.forEach((r) => {
+                        r.RoleDefinitionBindings = formatting_1.formatting.setFriendlyPermissions(r.RoleDefinitionBindings);
+                    });
+                    webProperties.RoleAssignments = response.value;
                 }
                 logger.log(webProperties);
             }
@@ -63,18 +64,6 @@ class SpoWebGetCommand extends SpoCommand_1.default {
             }
         });
     }
-    setFriendlyPermissions(response) {
-        response.forEach((r) => {
-            r.RoleDefinitionBindings.forEach((r) => {
-                const permissions = new base_permissions_1.BasePermissions();
-                permissions.high = r.BasePermissions.High;
-                permissions.low = r.BasePermissions.Low;
-                r.BasePermissionsValue = permissions.parse();
-                r.RoleTypeKindValue = RoleType_1.RoleType[r.RoleTypeKind];
-            });
-        });
-        return response;
-    }
 }
 _SpoWebGetCommand_instances = new WeakSet(), _SpoWebGetCommand_initTelemetry = function _SpoWebGetCommand_initTelemetry() {
     this.telemetry.push((args) => {

package/dist/utils/formatting.js

@@ -2,6 +2,8 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.formatting = void 0;
 const stripJsonComments = require("strip-json-comments");
+const base_permissions_1 = require("../m365/spo/base-permissions");
+const RoleType_1 = require("../m365/spo/commands/roledefinition/RoleType");
 exports.formatting = {
     escapeXml(s) {
         if (!s) {
@@ -38,6 +40,16 @@ exports.formatting = {
             return filtered;
         }, {});
     },
+    setFriendlyPermissions(response) {
+        response.forEach((r) => {
+            const permissions = new base_permissions_1.BasePermissions();
+            permissions.high = r.BasePermissions.High;
+            permissions.low = r.BasePermissions.Low;
+            r.BasePermissionsValue = permissions.parse();
+            r.RoleTypeKindValue = RoleType_1.RoleType[r.RoleTypeKind];
+        });
+        return response;
+    },
     parseCsvToJson(s, quoteChar = '"', delimiter = ',') {
         const regex = new RegExp(`\\s*(${quoteChar})?(.*?)\\1\\s*(?:${delimiter}|$)`, 'gs');
         const lines = s.split('\n');

package/docs/docs/cmd/planner/plan/plan-set.md

@@ -0,0 +1,144 @@
+# planner plan set
+
+Updates a Microsoft Planner plan
+
+## Usage
+
+```sh
+m365 planner plan set [options]
+```
+
+## Options
+
+`-i, --id [id]`
+: ID of the plan. Specify either `id` or `title` but not both.
+
+`-t, --title [title]`
+: Title of the plan. Specify either `id` or `title` but not both.
+
+`--ownerGroupId [ownerGroupId]`
+: ID of the group to which the plan belongs. Specify either `ownerGroupId` or `ownerGroupName` when using `title`.
+
+`--ownerGroupName [ownerGroupName]`
+: Name of the Group to which the plan belongs. Specify either `ownerGroupId` or `ownerGroupName` when using `title`.
+
+`--newTitle [newTitle]`
+: New title of the plan.
+
+`--shareWithUserIds [shareWithUserIds]`
+: The comma-separated IDs of the users with whom you want to share the plan. Specify either `shareWithUserIds` or `shareWithUserNames` but not both.
+
+`--shareWithUserNames [shareWithUserNames]`
+: The comma-separated UPNs of the users with whom you want to share the plan. Specify either `shareWithUserIds` or `shareWithUserNames` but not both.
+
+--8<-- "docs/cmd/_global.md"
+
+## Remarks
+
+This command allows using unknown options. 
+
+`--category1 [category1]`
+: New label for a category. Define the category key within your option to update the related label. Category 1 to 25 are available. E.g., `--category4`, `--category12`.
+
+## Examples
+
+Updates a Microsoft Planner plan title to New Title
+
+```sh
+m365 planner plan set --id 'gndWOTSK60GfPQfiDDj43JgACDCb' --newTitle 'New Title'
+```
+
+Share a Microsoft Planner plan owned by the group, with the users
+
+```sh
+m365 planner plan set --title 'Plan Title' --ownerGroupName 'My Group' --shareWithUserNames 'user1@contoso.com,user2@contoso.com'
+```
+
+Updates a Microsoft Planner plan category labels
+
+```sh
+m365 planner plan set --id 'gndWOTSK60GfPQfiDDj43JgACDCb' --category21 'ToDo' --category25 'Urgent'
+```
+
+## More information
+
+- Update plannerPlan: [https://learn.microsoft.com/en-us/graph/api/plannerplan-update?view=graph-rest-1.0&tabs=http](https://learn.microsoft.com/en-us/graph/api/plannerplan-update?view=graph-rest-1.0&tabs=http)
+- plannerPlanDetails resource type: [https://learn.microsoft.com/en-us/graph/api/resources/plannerplandetails?view=graph-rest-1.0](https://learn.microsoft.com/en-us/graph/api/resources/plannerplandetails?view=graph-rest-1.0)
+- plannerCategoryDescriptions resource type: [https://learn.microsoft.com/en-us/graph/api/resources/plannercategorydescriptions?view=graph-rest-1.0](https://learn.microsoft.com/en-us/graph/api/resources/plannercategorydescriptions?view=graph-rest-1.0)
+
+
+## Response
+
+=== "JSON"
+
+    ```json
+    {
+      "createdDateTime": "2015-03-30T18:36:49.2407981Z",
+      "owner": "ebf3b108-5234-4e22-b93d-656d7dae5874",
+      "title": "My Planner Plan",
+      "id": "xqQg5FS2LkCp935s-FIFm2QAFkHM",
+      "createdBy": {
+        "user": {
+          "displayName": null,
+          "id": "95e27074-6c4a-447a-aa24-9d718a0b86fa"
+        },
+        "application": {
+          "displayName": null,
+          "id": "ebf3b108-5234-4e22-b93d-656d7dae5874"
+        }
+      },
+      "container": {
+        "containerId": "ebf3b108-5234-4e22-b93d-656d7dae5874",
+        "type": "group",
+        "url": "https://graph.microsoft.com/v1.0/groups/ebf3b108-5234-4e22-b93d-656d7dae5874"
+      },
+      "sharedWith": {
+        "ebf3b108-5234-4e22-b93d-656d7dae5874": true,
+        "6463a5ce-2119-4198-9f2a-628761df4a62": true
+      },
+      "categoryDescriptions": {
+        "category1": null,
+        "category2": null,
+        "category3": null,
+        "category4": null,
+        "category5": null,
+        "category6": null,
+        "category7": null,
+        "category8": null,
+        "category9": null,
+        "category10": null,
+        "category11": null,
+        "category12": null,
+        "category13": null,
+        "category14": null,
+        "category15": null,
+        "category16": null,
+        "category17": null,
+        "category18": null,
+        "category19": null,
+        "category20": null,
+        "category21": null,
+        "category22": null,
+        "category23": null,
+        "category24": null,
+        "category25": null
+      }
+    }
+    ```
+
+=== "Text"
+
+    ```text
+    createdDateTime: 2015-03-30T18:36:49.2407981Z
+    id             : xqQg5FS2LkCp935s-FIFm2QAFkHM
+    owner          : ebf3b108-5234-4e22-b93d-656d7dae5874
+    title          : My Planner Plan
+    ```
+
+=== "CSV"
+
+    ```csv
+    id,title,createdDateTime,owner
+    xqQg5FS2LkCp935s-FIFm2QAFkHM,My Planner Plan,2015-03-30T18:36:49.2407981Z,ebf3b108-5234-4e22-b93d-656d7dae5874
+    ```
+

package/docs/docs/cmd/spo/contenttype/contenttype-set.md

@@ -1,6 +1,6 @@
 # spo contenttype set
 
-Update existing content type
+Update an existing content type
 
 ## Usage
 
@@ -28,8 +28,16 @@ m365 spo contenttype set [options]
 `--listUrl [listUrl]`
 : URL of the list if you want to update a list content type. Specify either `listTitle`, `listId` or `listUrl`.
 
+`--updateChildren`
+: Specify if you want to push updates to child content types.
+
 --8<-- "docs/cmd/_global.md"
 
+## Remarks
+
+!!! important "Updating child content types"
+    When specifying the `--updateChildren` flag, SharePoint will only propagate the changes that are made in the current request. If you want to know more about updating a content type and propagating changes to child content types, be sure to [read more here](https://learn.microsoft.com/en-us/previous-versions/office/developer/sharepoint-2010/ms442695(v=office.14)#considerations-when-updating-child-content-types). 
+
 ## Examples
 
 Move site content type to a different group
@@ -43,3 +51,9 @@ Rename list content type
 ```sh
 m365 spo contenttype set --name "My old item" --webUrl https://contoso.sharepoint.com --listTitle "My list" --Name "My item"
 ```
+
+Configure a form customizer with manifest ID _19890cce-15d8-4af9-bfcb-72da06d13ed8_ on a site content type and push changes to child content types.
+
+```sh
+m365 spo contenttype set --name "My content type" --webUrl https://contoso.sharepoint.com --DisplayFormClientSideComponentId "19890cce-15d8-4af9-bfcb-72da06d13ed8" --EditFormClientSideComponentId "19890cce-15d8-4af9-bfcb-72da06d13ed8" --NewFormClientSideComponentId "19890cce-15d8-4af9-bfcb-72da06d13ed8" --updateChildren
+```

package/docs/docs/cmd/spo/navigation/navigation-node-add.md

@@ -11,22 +11,22 @@ m365 spo navigation node add [options]
 ## Options
 
 `-u, --webUrl <webUrl>`
-: Absolute URL of the site to which navigation should be modified
+: Absolute URL of the site to which navigation should be modified.
 
 `-l, --location [location]`
-: Navigation type where the node should be added. Available options: `QuickLaunch`, `TopNavigationBar`
+: Navigation type where the node should be added. Available options: `QuickLaunch`, `TopNavigationBar`. Specify either `location` or `parentNodeId` but not both.
 
 `-t, --title <title>`
-: Navigation node title
+: Navigation node title.
 
 `--url <url>`
-: Navigation node URL
+: Navigation node URL.
 
 `--parentNodeId [parentNodeId]`
-: ID of the node below which the node should be added
+: ID of the node below which the node should be added. Specify either `location` or `parentNodeId` but not both.
 
 `--isExternal`
-: Set, if the navigation node points to an external URL
+: Set, if the navigation node points to an external URL.
 
 --8<-- "docs/cmd/_global.md"
 

package/npm-shrinkwrap.json

@@ -1,12 +1,12 @@
 {
   "name": "@pnp/cli-microsoft365",
-  "version": "6.0.0",
+  "version": "6.1.0",
   "lockfileVersion": 2,
   "requires": true,
   "packages": {
     "": {
       "name": "@pnp/cli-microsoft365",
-      "version": "6.0.0",
+      "version": "6.1.0",
       "license": "MIT",
       "dependencies": {
         "@azure/msal-node": "^1.14.2",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pnp/cli-microsoft365",
-  "version": "6.0.0",
+  "version": "6.1.0-beta.0825554",
   "description": "Manage Microsoft 365 and SharePoint Framework projects on any platform",
   "license": "MIT",
   "main": "./dist/api.js",
@@ -269,4 +269,4 @@
     "sinon": "^14.0.1",
     "source-map-support": "^0.5.21"
   }
-}
+}