@pnp/cli-microsoft365 6.1.0-beta.1da0a1d → 6.1.0-beta.a927083

package/dist/m365/spfx/commands/spfx-doctor.js

@@ -443,6 +443,21 @@ class SpfxDoctorCommand extends AnonymousCommand_1.default {
                     range: '^4',
                     fix: 'npm i -g yo@4'
                 }
+            },
+            '1.16.1': {
+                gulpCli: {
+                    range: '^1 || ^2',
+                    fix: 'npm i -g gulp-cli@2'
+                },
+                node: {
+                    range: '>=16.13.0 <17.0.0',
+                    fix: 'Install Node.js >=16.13.0 <17.0.0'
+                },
+                sp: SharePointVersion.SPO,
+                yo: {
+                    range: '^4',
+                    fix: 'npm i -g yo@4'
+                }
             }
         };
         __classPrivateFieldGet(this, _SpfxDoctorCommand_instances, "m", _SpfxDoctorCommand_initTelemetry).call(this);

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');
@@ -73,6 +85,31 @@ exports.formatting = {
             .replace(/:/g, '%3A')
             .replace(/@/g, '%40')
             .replace(/#/g, '%23');
+    },
+    /**
+     * Rewrites boolean values according to the definition:
+     * Booleans are case-insensitive, and are represented by the following values.
+     *   True: 1, yes, true, on
+     *   False: 0, no, false, off
+     * @value Stringified Boolean value to rewrite
+     * @returns A stringified boolean with the value 'true' or 'false'. Returns the original value if it does not comply with the definition.
+     */
+    rewriteBooleanValue(value) {
+        const argValue = value.toLowerCase();
+        switch (argValue) {
+            case '1':
+            case 'true':
+            case 'yes':
+            case 'on':
+                return 'true';
+            case '0':
+            case 'false':
+            case 'no':
+            case 'off':
+                return 'false';
+            default:
+                return value;
+        }
     }
 };
 //# sourceMappingURL=formatting.js.map

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
+    ```
+