@pnp/cli-microsoft365 10.10.0-beta.bd186ba → 10.10.0-beta.eb74779

package/dist/m365/spo/commands/page/Page.js

@@ -25,7 +25,7 @@ export class Page {
         }
         return ClientSidePage.fromHtml(res.ListItemAllFields.CanvasContent1);
     }
-    static async checkout(name, webUrl, logger, debug, verbose) {
+    static async checkout(name, webUrl, logger, verbose) {
         if (verbose) {
             await logger.log(`Checking out ${name} page...`);
         }
@@ -77,6 +77,21 @@ export class Page {
             columns: section.columns.map(column => this.getColumnsInformation(column, isJSONOutput))
         };
     }
+    /**
+     * Publish a modern page in SharePoint Online
+     * @param webUrl Absolute URL of the SharePoint site where the page is located
+     * @param pageName List relative url of the page to publish
+     */
+    static async publishPage(webUrl, pageName) {
+        const filePath = `${urlUtil.getServerRelativeSiteUrl(webUrl)}/SitePages/${pageName}`;
+        const requestOptions = {
+            url: `${webUrl}/_api/web/GetFileByServerRelativePath(DecodedUrl='${formatting.encodeQueryParameter(filePath)}')/Publish()`,
+            headers: {
+                accept: 'application/json;odata=nometadata'
+            }
+        };
+        await request.post(requestOptions);
+    }
     static getPageNameWithExtension(name) {
         let pageName = name;
         if (pageName.indexOf('.aspx') < 0) {

package/dist/m365/spo/commands/page/page-add.js

@@ -63,7 +63,7 @@ class SpoPageAddCommand extends SpoCommand {
             itemId = template.UniqueId;
             const file = await spo.getFileAsListItemByUrl(args.options.webUrl, serverRelativeFileUrl, logger, this.verbose);
             const listItemId = file.Id;
-            const pageProps = await Page.checkout(pageName, args.options.webUrl, logger, this.debug, this.verbose);
+            const pageProps = await Page.checkout(pageName, args.options.webUrl, logger, this.verbose);
             if (pageProps) {
                 pageId = pageProps.Id;
                 bannerImageUrl = pageProps.BannerImageUrl;

package/dist/m365/spo/commands/page/page-clientsidewebpart-add.js

@@ -11,6 +11,7 @@ import { validation } from '../../../../utils/validation.js';
 import SpoCommand from '../../../base/SpoCommand.js';
 import commands from '../../commands.js';
 import { StandardWebPartUtils } from '../../StandardWebPartTypes.js';
+import { Page } from './Page.js';
 class SpoPageClientSideWebPartAddCommand extends SpoCommand {
     get name() {
         return commands.PAGE_CLIENTSIDEWEBPART_ADD;
@@ -52,14 +53,7 @@ class SpoPageClientSideWebPartAddCommand extends SpoCommand {
             };
             let page = await request.get(requestOptions);
             if (!page.IsPageCheckedOutToCurrentUser) {
-                const requestOptions = {
-                    url: `${args.options.webUrl}/_api/sitepages/pages/GetByUrl('sitepages/${formatting.encodeQueryParameter(pageFullName)}')/checkoutpage`,
-                    headers: {
-                        'accept': 'application/json;odata=nometadata'
-                    },
-                    responseType: 'json'
-                };
-                page = await request.post(requestOptions);
+                page = await Page.checkout(pageFullName, args.options.webUrl, logger, this.verbose);
             }
             if (page) {
                 layoutWebpartsContent = page.LayoutWebpartsContent;

package/dist/m365/spo/commands/page/page-control-remove.js

@@ -0,0 +1,99 @@
+import { globalOptionsZod } from '../../../../Command.js';
+import { z } from 'zod';
+import commands from '../../commands.js';
+import { validation } from '../../../../utils/validation.js';
+import SpoCommand from '../../../base/SpoCommand.js';
+import { zod } from '../../../../utils/zod.js';
+import { cli } from '../../../../cli/cli.js';
+import request from '../../../../request.js';
+import { formatting } from '../../../../utils/formatting.js';
+import { Page } from './Page.js';
+import { urlUtil } from '../../../../utils/urlUtil.js';
+const options = globalOptionsZod
+    .extend({
+    webUrl: zod.alias('u', z.string())
+        .refine(url => validation.isValidSharePointUrl(url) === true, url => ({
+        message: `'${url}' is not a valid SharePoint URL.`
+    })),
+    pageName: zod.alias('n', z.string()),
+    id: zod.alias('i', z.string())
+        .refine(id => validation.isValidGuid(id), id => ({
+        message: `'${id}' is not a valid GUID.`
+    })),
+    draft: z.boolean().optional(),
+    force: zod.alias('f', z.boolean().optional())
+})
+    .strict();
+class SpoPageControlRemoveCommand extends SpoCommand {
+    get name() {
+        return commands.PAGE_CONTROL_REMOVE;
+    }
+    get description() {
+        return 'Removes a control from a modern page';
+    }
+    get schema() {
+        return options;
+    }
+    async commandAction(logger, args) {
+        if (!args.options.force) {
+            const result = await cli.promptForConfirmation({ message: `Are you sure you want to delete control '${args.options.id}' on page '${args.options.pageName}'?` });
+            if (!result) {
+                return;
+            }
+        }
+        try {
+            if (this.verbose) {
+                await logger.logToStderr(`Getting page properties for page '${args.options.pageName}'...`);
+            }
+            const pageName = urlUtil.removeLeadingSlashes(args.options.pageName.toLowerCase().endsWith('.aspx') ? args.options.pageName : `${args.options.pageName}.aspx`);
+            let requestOptions = {
+                url: `${args.options.webUrl}/_api/SitePages/Pages/GetByUrl('SitePages/${formatting.encodeQueryParameter(pageName)}')?$select=CanvasContent1`,
+                headers: {
+                    accept: 'application/json;odata=nometadata'
+                },
+                responseType: 'json'
+            };
+            const pageProps = await request.get(requestOptions);
+            if (!pageProps.CanvasContent1) {
+                throw `Page '${pageName}' doesn't contain canvas control '${args.options.id}'.`;
+            }
+            const pageControls = JSON.parse(pageProps.CanvasContent1);
+            const hasControl = pageControls.some(control => control.id?.toLowerCase() === args.options.id.toLowerCase());
+            if (!hasControl) {
+                throw `Control with ID '${args.options.id}' was not found on page '${pageName}'.`;
+            }
+            if (this.verbose) {
+                await logger.logToStderr('Checking out page...');
+            }
+            const page = await Page.checkout(pageName, args.options.webUrl, logger, this.verbose);
+            const canvasContent = JSON.parse(page.CanvasContent1);
+            if (this.verbose) {
+                await logger.logToStderr(`Removing control with ID '${args.options.id}' from page...`);
+            }
+            const pageContent = canvasContent.filter(control => !control.id || control.id.toLowerCase() !== args.options.id.toLowerCase());
+            requestOptions = {
+                url: `${args.options.webUrl}/_api/SitePages/Pages/GetByUrl('SitePages/${formatting.encodeQueryParameter(pageName)}')/SavePageAsDraft`,
+                headers: {
+                    'content-type': 'application/json;odata=nometadata',
+                    accept: 'application/json;odata=nometadata'
+                },
+                responseType: 'json',
+                data: {
+                    CanvasContent1: JSON.stringify(pageContent)
+                }
+            };
+            await request.patch(requestOptions);
+            if (!args.options.draft) {
+                if (this.verbose) {
+                    await logger.logToStderr(`Republishing page...`);
+                }
+                await Page.publishPage(args.options.webUrl, pageName);
+            }
+        }
+        catch (err) {
+            this.handleRejectedODataJsonPromise(err);
+        }
+    }
+}
+export default new SpoPageControlRemoveCommand();
+//# sourceMappingURL=page-control-remove.js.map

package/dist/m365/spo/commands/page/page-control-set.js

@@ -50,7 +50,7 @@ class SpoPageControlSetCommand extends SpoCommand {
                 await logger.logToStderr(`Control with ID ${args.options.id} found on the page`);
             }
             // Check out the page
-            const page = await Page.checkout(pageName, args.options.webUrl, logger, this.debug, this.verbose);
+            const page = await Page.checkout(pageName, args.options.webUrl, logger, this.verbose);
             // Update the web part data
             const canvasContent = JSON.parse(page.CanvasContent1);
             if (this.debug) {

package/dist/m365/spo/commands/page/page-header-set.js

@@ -6,9 +6,11 @@ var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (
 var _SpoPageHeaderSetCommand_instances, _SpoPageHeaderSetCommand_initTelemetry, _SpoPageHeaderSetCommand_initOptions, _SpoPageHeaderSetCommand_initValidators;
 import request from '../../../../request.js';
 import { formatting } from '../../../../utils/formatting.js';
+import { spo } from '../../../../utils/spo.js';
 import { validation } from '../../../../utils/validation.js';
 import SpoCommand from '../../../base/SpoCommand.js';
 import commands from '../../commands.js';
+import { Page } from './Page.js';
 const BannerWebPartId = 'cbe7b0a9-3504-44dd-a3a3-0e5cacd07788';
 class SpoPageHeaderSetCommand extends SpoCommand {
     get name() {
@@ -148,14 +150,7 @@ class SpoPageHeaderSetCommand extends SpoCommand {
                 pageData = await request.get(requestOptions);
             }
             else {
-                const requestOptions = {
-                    url: `${args.options.webUrl}/_api/sitepages/pages/GetByUrl('sitepages/${formatting.encodeQueryParameter(pageFullName)}')/checkoutpage`,
-                    headers: {
-                        'accept': 'application/json;odata=nometadata'
-                    },
-                    responseType: 'json'
-                };
-                pageData = await request.post(requestOptions);
+                pageData = await Page.checkout(pageFullName, args.options.webUrl, logger, this.verbose);
             }
             switch (args.options.type) {
                 case 'None':
@@ -220,23 +215,23 @@ class SpoPageHeaderSetCommand extends SpoCommand {
                 }
                 else {
                     const res = await Promise.all([
-                        this.getSiteId(args.options.webUrl, this.verbose, logger),
-                        this.getWebId(args.options.webUrl, this.verbose, logger),
+                        spo.getSiteIdBySPApi(args.options.webUrl, logger, this.verbose),
+                        spo.getWebId(args.options.webUrl, logger, this.verbose),
                         this.getImageInfo(args.options.webUrl, args.options.imageUrl, this.verbose, logger)
                     ]);
                     header.serverProcessedContent.customMetadata = {
                         imageSource: {
-                            siteId: res[0].Id,
-                            webId: res[1].Id,
+                            siteId: res[0],
+                            webId: res[1],
                             listId: res[2].ListId,
                             uniqueId: res[2].UniqueId
                         }
                     };
                     const properties = header.properties;
                     properties.listId = res[2].ListId;
-                    properties.siteId = res[0].Id;
+                    properties.siteId = res[0];
                     properties.uniqueId = res[2].UniqueId;
-                    properties.webId = res[1].Id;
+                    properties.webId = res[1];
                     header.properties = properties;
                 }
             }
@@ -306,32 +301,6 @@ class SpoPageHeaderSetCommand extends SpoCommand {
             this.handleRejectedODataJsonPromise(err);
         }
     }
-    async getSiteId(siteUrl, verbose, logger) {
-        if (verbose) {
-            await logger.logToStderr(`Retrieving information about the site collection...`);
-        }
-        const requestOptions = {
-            url: `${siteUrl}/_api/site?$select=Id`,
-            headers: {
-                accept: 'application/json;odata=nometadata'
-            },
-            responseType: 'json'
-        };
-        return request.get(requestOptions);
-    }
-    async getWebId(siteUrl, verbose, logger) {
-        if (verbose) {
-            await logger.logToStderr(`Retrieving information about the site...`);
-        }
-        const requestOptions = {
-            url: `${siteUrl}/_api/web?$select=Id`,
-            headers: {
-                accept: 'application/json;odata=nometadata'
-            },
-            responseType: 'json'
-        };
-        return request.get(requestOptions);
-    }
     async getImageInfo(siteUrl, imageUrl, verbose, logger) {
         if (verbose) {
             await logger.logToStderr(`Retrieving information about the header image...`);

package/dist/m365/spo/commands/page/page-publish.js

@@ -1,12 +1,11 @@
 import { z } from 'zod';
 import { zod } from '../../../../utils/zod.js';
 import { globalOptionsZod } from '../../../../Command.js';
-import request from '../../../../request.js';
-import { formatting } from '../../../../utils/formatting.js';
 import { urlUtil } from '../../../../utils/urlUtil.js';
 import { validation } from '../../../../utils/validation.js';
 import SpoCommand from '../../../base/SpoCommand.js';
 import commands from '../../commands.js';
+import { Page } from './Page.js';
 const options = globalOptionsZod
     .extend({
     webUrl: zod.alias('u', z.string()
@@ -36,14 +35,7 @@ class SpoPagePublishCommand extends SpoCommand {
             if (this.verbose) {
                 await logger.logToStderr(`Publishing page ${pageName}...`);
             }
-            const filePath = `${urlUtil.getServerRelativeSiteUrl(args.options.webUrl)}/SitePages/${pageName}`;
-            const requestOptions = {
-                url: `${args.options.webUrl}/_api/web/GetFileByServerRelativePath(DecodedUrl='${formatting.encodeQueryParameter(filePath)}')/Publish()`,
-                headers: {
-                    accept: 'application/json;odata=nometadata'
-                }
-            };
-            await request.post(requestOptions);
+            await Page.publishPage(args.options.webUrl, pageName);
         }
         catch (err) {
             this.handleRejectedODataJsonPromise(err);

package/dist/m365/spo/commands/page/page-section-add.js

@@ -11,6 +11,7 @@ import { validation } from '../../../../utils/validation.js';
 import SpoCommand from '../../../base/SpoCommand.js';
 import commands from '../../commands.js';
 import { CanvasSectionTemplate } from './clientsidepages.js';
+import { Page } from './Page.js';
 class SpoPageSectionAddCommand extends SpoCommand {
     get name() {
         return commands.PAGE_SECTION_ADD;
@@ -50,14 +51,7 @@ class SpoPageSectionAddCommand extends SpoCommand {
             const res = await request.get(requestOptions);
             canvasContent = JSON.parse(res.CanvasContent1 || "[{\"controlType\":0,\"pageSettingsSlice\":{\"isDefaultDescription\":true,\"isDefaultThumbnail\":true}}]");
             if (!res.IsPageCheckedOutToCurrentUser) {
-                requestOptions = {
-                    url: `${args.options.webUrl}/_api/sitepages/pages/GetByUrl('sitepages/${formatting.encodeQueryParameter(pageFullName)}')/checkoutpage`,
-                    headers: {
-                        'accept': 'application/json;odata=nometadata'
-                    },
-                    responseType: 'json'
-                };
-                await request.post(requestOptions);
+                await Page.checkout(pageFullName, args.options.webUrl, logger, this.verbose);
             }
             // get unique zoneIndex values given each section can have 1 or more
             // columns each assigned to the zoneIndex of the corresponding section

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

@@ -52,7 +52,7 @@ class SpoPageSetCommand extends SpoCommand {
         try {
             const requestDigestResult = await spo.getRequestDigest(args.options.webUrl);
             const requestDigest = requestDigestResult.FormDigestValue;
-            const page = await Page.checkout(args.options.name, args.options.webUrl, logger, this.debug, this.verbose);
+            const page = await Page.checkout(args.options.name, args.options.webUrl, logger, this.verbose);
             if (page) {
                 pageTitle = pageTitle || page.Title;
                 pageId = page.Id;

package/dist/m365/spo/commands/site/site-admin-add.js

@@ -125,7 +125,7 @@ class SpoSiteAdminAddCommand extends SpoCommand {
         const ensuredUserData = await this.ensureUser(args, loginNameToAdd);
         await this.setSiteAdmin(args.options.siteUrl, loginNameToAdd);
         if (args.options.primary) {
-            const siteId = await this.getSiteId(args.options.siteUrl);
+            const siteId = await spo.getSiteIdBySPApi(args.options.siteUrl, logger, this.verbose);
             const previousPrimaryOwner = await this.getSiteOwnerLoginName(args.options.siteUrl);
             await this.setPrimaryOwnerLoginFromSite(logger, args.options.siteUrl, siteId, ensuredUserData);
             await this.setSiteAdmin(args.options.siteUrl, previousPrimaryOwner);
@@ -157,17 +157,6 @@ class SpoSiteAdminAddCommand extends SpoCommand {
         };
         return request.post(requestOptions);
     }
-    async getSiteId(siteUrl) {
-        const requestOptions = {
-            url: `${siteUrl}/_api/site?$select=Id`,
-            headers: {
-                accept: 'application/json;odata=nometadata'
-            },
-            responseType: 'json'
-        };
-        const response = await request.get(requestOptions);
-        return response.Id;
-    }
     async getSiteOwnerLoginName(siteUrl) {
         const requestOptions = {
             url: `${siteUrl}/_api/site/owner?$select=LoginName`,

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

@@ -62,7 +62,7 @@ class SpoSiteSetCommand extends SpoCommand {
         if (this.debug) {
             await logger.logToStderr(`Setting the site its logo...`);
         }
-        const logoUrl = args.options.siteLogoUrl ? urlUtil.getServerRelativePath(args.options.url, args.options.siteLogoUrl) : "";
+        const logoUrl = args.options.siteLogoUrl ? urlUtil.getUrlRelativePath(args.options.siteLogoUrl) : "";
         const requestOptions = {
             url: `${args.options.url}/_api/siteiconmanager/setsitelogo`,
             headers: {
@@ -84,7 +84,7 @@ class SpoSiteSetCommand extends SpoCommand {
         if (this.debug) {
             await logger.logToStderr(`Setting the site thumbnail...`);
         }
-        const thumbnailUrl = args.options.siteThumbnailUrl ? urlUtil.getServerRelativePath(args.options.url, args.options.siteThumbnailUrl) : "";
+        const thumbnailUrl = args.options.siteThumbnailUrl ? urlUtil.getUrlRelativePath(args.options.siteThumbnailUrl) : "";
         const requestOptions = {
             url: `${args.options.url}/_api/siteiconmanager/setsitelogo`,
             headers: {

package/dist/m365/spo/commands.js

@@ -217,6 +217,7 @@ export default {
     PAGE_COLUMN_LIST: `${prefix} page column list`,
     PAGE_CONTROL_GET: `${prefix} page control get`,
     PAGE_CONTROL_LIST: `${prefix} page control list`,
+    PAGE_CONTROL_REMOVE: `${prefix} page control remove`,
     PAGE_CONTROL_SET: `${prefix} page control set`,
     PAGE_HEADER_SET: `${prefix} page header set`,
     PAGE_SECTION_ADD: `${prefix} page section add`,

package/dist/utils/entraServicePrincipal.js

@@ -1,6 +1,7 @@
 import { odata } from './odata.js';
 import { formatting } from './formatting.js';
 import { cli } from '../cli/cli.js';
+import request from '../request.js';
 export const entraServicePrincipal = {
     /**
      * Get service principal by its appId
@@ -52,6 +53,26 @@ export const entraServicePrincipal = {
             url += `?$select=${properties}`;
         }
         return odata.getAllItems(url);
+    },
+    /**
+     * Create a new service principal for the specified application.
+     * @param appId Application ID of the application for which to create a service principal.
+     * @returns The created service principal.
+     */
+    async createServicePrincipal(appId) {
+        const url = `https://graph.microsoft.com/v1.0/servicePrincipals`;
+        const requestOptions = {
+            url: url,
+            headers: {
+                accept: 'application/json;odata.metadata=none',
+                'content-type': 'application/json;odata=nometadata'
+            },
+            data: {
+                appId
+            },
+            responseType: 'json'
+        };
+        return await request.post(requestOptions);
     }
 };
 //# sourceMappingURL=entraServicePrincipal.js.map

package/dist/utils/md.js

@@ -13,8 +13,8 @@ function convertHeadings(md) {
     });
 }
 function convertAdmonitions(md) {
-    const regex = new RegExp(/^:::(\w+)(?:\[([^\]]+)\])?([\s\S]*?):::$/, 'gm');
-    return md.replace(regex, (_, label, title, content) => label.toLocaleUpperCase() + (title ? EOL + EOL + title : '') + EOL + EOL + content.trim());
+    const regex = new RegExp(/^([ \t]*):::(\w+)(?:\[([^\]]+)\])?([\s\S]*?)^\1:::$/, 'gm');
+    return md.replace(regex, (_, indent, label, title, content) => indent + label.toLocaleUpperCase() + (title ? EOL + EOL + indent + title : '') + EOL + EOL + indent + content.trim());
 }
 function includeContent(md, rootFolder) {
     const mdxImports = [
@@ -49,7 +49,7 @@ function convertHyperlinks(md) {
 function convertContentTabs(md) {
     return md
         .replace(/<TabItem value="([^"]+)">/gm, '$1')
-        .replace(/.*<\/?(Tabs|TabItem)>.*\n?/g, '')
+        .replace(/.*\n?<\/?(Tabs|TabItem)>.*\n?/g, '')
         .replace(/```(?:\w+)?\s*([\s\S]*?)\s*```/g, '$1')
         .trim();
 }

package/dist/utils/spo.js

@@ -1403,13 +1403,13 @@ export const spo = {
         await request.post(requestOptions);
     },
     /**
-     * Retrieves the site ID for a given web URL.
+     * Retrieves the site ID for a given web URL by the MS Graph.
      * @param webUrl The web URL for which to retrieve the site ID.
      * @param logger The logger object.
      * @param verbose Set for verbose logging
-     * @returns A promise that resolves to the site ID.
+     * @returns The site ID as a string.
      */
-    async getSiteId(webUrl, logger, verbose) {
+    async getSiteIdByMSGraph(webUrl, logger, verbose) {
         if (verbose && logger) {
             await logger.logToStderr(`Getting site id for URL: ${webUrl}...`);
         }
@@ -1424,6 +1424,90 @@ export const spo = {
         const site = await request.get(requestOptions);
         return site.id;
     },
+    /**
+     * Retrieves the SharePoint Online site ID for the specified web URL by the SharePoint REST API.
+     * @param webUrl The web URL of the SharePoint Online site to retrieve the site ID for.
+     * @param logger The logger object.
+     * @param verbose Set for verbose logging
+     * @returns The site ID as a string.
+     */
+    async getSiteIdBySPApi(webUrl, logger, verbose) {
+        if (verbose && logger) {
+            await logger.logToStderr(`Getting site id for URL: ${webUrl}...`);
+        }
+        const requestOptions = {
+            url: `${webUrl}/_api/site?$select=Id`,
+            headers: {
+                accept: 'application/json;odata=nometadata'
+            },
+            responseType: 'json'
+        };
+        const siteResponse = await request.get(requestOptions);
+        return siteResponse.Id;
+    },
+    /**
+     * Retrieves the id of a SharePoint web for the specified web URL.
+     * @param webUrl The web URL for which to retrieve the web ID.
+     * @param logger The logger object for logging messages.
+     * @param verbose Set to true for verbose logging.
+     * @returns The web ID as a string.
+     */
+    async getWebId(webUrl, logger, verbose) {
+        if (verbose && logger) {
+            await logger.logToStderr(`Getting web id for URL: ${webUrl}...`);
+        }
+        const requestOptions = {
+            url: `${webUrl}/_api/web?$select=Id`,
+            headers: {
+                accept: 'application/json;odata=nometadata'
+            },
+            responseType: 'json'
+        };
+        const webResponse = await request.get(requestOptions);
+        return webResponse.Id;
+    },
+    /**
+     * Retrieves the ID of a SharePoint list by its title or URL.
+     * @param webUrl The base URL of the SharePoint site.
+     * @param listTitle The title of the list (optional).
+     * @param listUrl The server-relative URL of the list (optional).
+     * @param logger The logger object for logging messages (optional).
+     * @param verbose Set to true for verbose logging (optional).
+     * @returns The list ID as a string.
+     */
+    async getListId(webUrl, listTitle, listUrl, logger, verbose) {
+        if (verbose && logger) {
+            await logger.logToStderr(`Retrieving list id...`);
+        }
+        if (!listTitle && !listUrl) {
+            throw new Error('Either listTitle or listUrl must be provided.');
+        }
+        let listId = '';
+        if (listTitle) {
+            const requestOptions = {
+                url: `${webUrl}/_api/web/lists/getByTitle('${formatting.encodeQueryParameter(listTitle)}')?$select=Id`,
+                headers: {
+                    accept: 'application/json;odata=nometadata'
+                },
+                responseType: 'json'
+            };
+            const listResponse = await request.get(requestOptions);
+            listId = listResponse.Id;
+        }
+        else if (listUrl) {
+            const listServerRelativeUrl = urlUtil.getServerRelativePath(webUrl, listUrl);
+            const requestOptions = {
+                url: `${webUrl}/_api/web/GetList('${formatting.encodeQueryParameter(listServerRelativeUrl)}')?$select=Id`,
+                headers: {
+                    accept: 'application/json;odata=nometadata'
+                },
+                responseType: 'json'
+            };
+            const listResponse = await request.get(requestOptions);
+            listId = listResponse.Id;
+        }
+        return listId;
+    },
     /**
      * Retrieves the server-relative URL of a folder.
      * @param webUrl Web URL

package/docs/docs/cmd/_global.mdx

@@ -1,6 +1,6 @@
 ```md definition-list
 `-h, --help [help]`
-: Output usage information. Optionally, specify which section of command's help you want to see. Allowed values are `options`, `examples`, `remarks`, `response`, `full`. Default is `options`.
+: Output usage information. Optionally, specify which section of command's help you want to see. Allowed values are `options`, `examples`, `remarks`, `permissions`, `response`, `full`. Default is `options`.
 
 `--query [query]`
 : JMESPath query string. See [http://jmespath.org/](http://jmespath.org/) for more information and examples.

package/docs/docs/cmd/planner/bucket/bucket-add.mdx

@@ -47,6 +47,25 @@ When using `rosterId`, the command is based on an API that is currently in previ
 
 :::
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions                           |
+  |-----------------|---------------------------------------|
+  | Microsoft Graph | Tasks.ReadWrite, GroupMember.Read.All |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions                               |
+  |-----------------|-------------------------------------------|
+  | Microsoft Graph | Tasks.ReadWrite.All, GroupMember.Read.All |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Adds a Microsoft Planner bucket for a plan based on its ID with an order hint

package/docs/docs/cmd/planner/bucket/bucket-get.mdx

@@ -47,6 +47,25 @@ When using `rosterId`, the command is based on an API that is currently in previ
 
 :::
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions                      |
+  |-----------------|----------------------------------|
+  | Microsoft Graph | Tasks.Read, GroupMember.Read.All |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions                          |
+  |-----------------|--------------------------------------|
+  | Microsoft Graph | Tasks.Read.All, GroupMember.Read.All |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Gets the specified Microsoft Planner bucket 

package/docs/docs/cmd/planner/bucket/bucket-list.mdx

@@ -41,6 +41,25 @@ When using `rosterId`, the command is based on an API that is currently in previ
 
 :::
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions                      |
+  |-----------------|----------------------------------|
+  | Microsoft Graph | Tasks.Read, GroupMember.Read.All |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions                          |
+  |-----------------|--------------------------------------|
+  | Microsoft Graph | Tasks.Read.All, GroupMember.Read.All |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Lists the Microsoft Planner buckets based on its plan ID