@pnp/cli-microsoft365 11.1.0-beta.317d8bb → 11.1.0-beta.43467d2

package/dist/m365/spo/commands/site/site-alert-list.js

@@ -0,0 +1,107 @@
+import commands from '../../commands.js';
+import SpoCommand from '../../../base/SpoCommand.js';
+import { globalOptionsZod } from '../../../../Command.js';
+import { z } from 'zod';
+import { zod } from '../../../../utils/zod.js';
+import { validation } from '../../../../utils/validation.js';
+import { spo } from '../../../../utils/spo.js';
+import { entraUser } from '../../../../utils/entraUser.js';
+import { formatting } from '../../../../utils/formatting.js';
+import { odata } from '../../../../utils/odata.js';
+import { cli } from '../../../../cli/cli.js';
+export const options = globalOptionsZod
+    .extend({
+    webUrl: zod.alias('u', z.string()
+        .refine(url => validation.isValidSharePointUrl(url) === true, url => ({
+        message: `'${url}' is not a valid SharePoint site URL.`
+    }))),
+    listId: z.string()
+        .refine(id => validation.isValidGuid(id), id => ({
+        message: `'${id}' is not a valid GUID.`
+    })).optional(),
+    listUrl: z.string().optional(),
+    listTitle: z.string().optional(),
+    userName: z.string().refine(upn => validation.isValidUserPrincipalName(upn), upn => ({
+        message: `'${upn}' is not a valid UPN.`
+    })).optional(),
+    userId: z.string().refine(id => validation.isValidGuid(id), id => ({
+        message: `'${id}' is not a valid GUID.`
+    })).optional()
+})
+    .strict();
+class SpoSiteAlertListCommand extends SpoCommand {
+    get name() {
+        return commands.SITE_ALERT_LIST;
+    }
+    get description() {
+        return 'Lists all SharePoint list alerts';
+    }
+    defaultProperties() {
+        return ['ID', 'Title', 'UserPrincipalName'];
+    }
+    get schema() {
+        return options;
+    }
+    getRefinedSchema(schema) {
+        return schema
+            .refine(options => [options.listId, options.listUrl, options.listTitle].filter(x => x !== undefined).length <= 1, {
+            message: `Specify either listId, listUrl, or listTitle, but not more than one.`
+        })
+            .refine(options => [options.userName, options.userId].filter(x => x !== undefined).length <= 1, {
+            message: `Specify either userName or userId, but not both.`
+        });
+    }
+    async commandAction(logger, args) {
+        if (this.verbose) {
+            const listParams = args.options.listId || args.options.listTitle || args.options.listUrl;
+            const userParams = args.options.userName || args.options.userId;
+            let message = `Retrieving alerts from site '${args.options.webUrl}'`;
+            if (listParams) {
+                message += ` for list '${listParams}'`;
+            }
+            if (userParams) {
+                message += `${listParams ? ' and' : ''} for user '${userParams}'`;
+            }
+            await logger.logToStderr(`${message}...`);
+        }
+        let requestUrl = `${args.options.webUrl}/_api/web/alerts?$expand=List,User,List/Rootfolder,Item&$select=*,List/Id,List/Title,List/Rootfolder/ServerRelativeUrl,Item/ID,Item/FileRef,Item/Guid`;
+        const filters = [];
+        let listId;
+        if (args.options.listId) {
+            listId = args.options.listId;
+        }
+        else if (args.options.listUrl || args.options.listTitle) {
+            listId = await spo.getListId(args.options.webUrl, args.options.listTitle, args.options.listUrl, logger, this.verbose);
+        }
+        if (listId) {
+            filters.push(`List/Id eq guid'${formatting.encodeQueryParameter(listId)}'`);
+        }
+        if (args.options.userName) {
+            filters.push(`User/UserPrincipalName eq '${formatting.encodeQueryParameter(args.options.userName)}'`);
+        }
+        else if (args.options.userId) {
+            const userPrincipalName = await entraUser.getUpnByUserId(args.options.userId);
+            filters.push(`User/UserPrincipalName eq '${formatting.encodeQueryParameter(userPrincipalName)}'`);
+        }
+        if (filters.length > 0) {
+            requestUrl += `&$filter=${filters.join(' and ')}`;
+        }
+        try {
+            const res = await odata.getAllItems(requestUrl);
+            res.forEach(alert => {
+                if (alert.Item) {
+                    delete alert.Item['ID'];
+                }
+                if (cli.shouldTrimOutput(args.options.output)) {
+                    alert.UserPrincipalName = alert.User?.UserPrincipalName;
+                }
+            });
+            await logger.log(res);
+        }
+        catch (err) {
+            this.handleRejectedODataJsonPromise(err);
+        }
+    }
+}
+export default new SpoSiteAlertListCommand();
+//# sourceMappingURL=site-alert-list.js.map

package/dist/m365/spo/commands/theme/theme-apply.js

@@ -125,7 +125,7 @@ class SpoThemeApplyCommand extends SpoCommand {
         }
         return `{
       'name': '${themeName}' ,
-      'themeJson': '{\"palette\": {${palette}}}'
+      'themeJson': '{"palette": {${palette}}}'
     }`;
     }
 }

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

@@ -67,24 +67,19 @@ class SpoWebReindexCommand extends SpoCommand {
         }
     }
     async reindexLists(webUrl, requestDigest, logger, webIdentityResp) {
-        try {
-            if (this.debug) {
-                await logger.logToStderr(`Retrieving information about lists...`);
-            }
-            const requestOptions = {
-                url: `${webUrl}/_api/web/lists?$select=NoCrawl,Title,RootFolder/Properties,RootFolder/ServerRelativeUrl&$expand=RootFolder/Properties`,
-                headers: {
-                    'accept': 'application/json;odata=nometadata'
-                },
-                responseType: 'json'
-            };
-            const lists = await request.get(requestOptions);
-            const promises = lists.value.map(l => this.reindexList(l, webUrl, requestDigest, webIdentityResp, logger));
-            await Promise.all(promises);
-        }
-        catch (err) {
-            throw err;
+        if (this.debug) {
+            await logger.logToStderr(`Retrieving information about lists...`);
         }
+        const requestOptions = {
+            url: `${webUrl}/_api/web/lists?$select=NoCrawl,Title,RootFolder/Properties,RootFolder/ServerRelativeUrl&$expand=RootFolder/Properties`,
+            headers: {
+                'accept': 'application/json;odata=nometadata'
+            },
+            responseType: 'json'
+        };
+        const lists = await request.get(requestOptions);
+        const promises = lists.value.map(l => this.reindexList(l, webUrl, requestDigest, webIdentityResp, logger));
+        await Promise.all(promises);
     }
     async reindexList(list, webUrl, requestDigest, webIdentityResp, logger) {
         if (list.NoCrawl) {
@@ -93,16 +88,11 @@ class SpoWebReindexCommand extends SpoCommand {
             }
             return;
         }
-        try {
-            const folderIdentityResp = await spo.getFolderIdentity(webIdentityResp.objectIdentity, webUrl, list.RootFolder.ServerRelativeUrl, requestDigest);
-            let searchversion = list.RootFolder.Properties.vti_x005f_searchversion || 0;
-            searchversion++;
-            await SpoPropertyBagBaseCommand.setProperty('vti_searchversion', searchversion.toString(), webUrl, requestDigest, folderIdentityResp, logger, this.debug, list.RootFolder.ServerRelativeUrl);
-            return;
-        }
-        catch (err) {
-            throw (err);
-        }
+        const folderIdentityResp = await spo.getFolderIdentity(webIdentityResp.objectIdentity, webUrl, list.RootFolder.ServerRelativeUrl, requestDigest);
+        let searchversion = list.RootFolder.Properties.vti_x005f_searchversion || 0;
+        searchversion++;
+        await SpoPropertyBagBaseCommand.setProperty('vti_searchversion', searchversion.toString(), webUrl, requestDigest, folderIdentityResp, logger, this.debug, list.RootFolder.ServerRelativeUrl);
+        return;
     }
 }
 _SpoWebReindexCommand_instances = new WeakSet(), _SpoWebReindexCommand_initOptions = function _SpoWebReindexCommand_initOptions() {

package/dist/m365/spo/commands.js

@@ -257,6 +257,7 @@ export default {
     SITE_ADMIN_ADD: `${prefix} site admin add`,
     SITE_ADMIN_LIST: `${prefix} site admin list`,
     SITE_ADMIN_REMOVE: `${prefix} site admin remove`,
+    SITE_ALERT_LIST: `${prefix} site alert list`,
     SITE_APPCATALOG_ADD: `${prefix} site appcatalog add`,
     SITE_APPCATALOG_LIST: `${prefix} site appcatalog list`,
     SITE_APPCATALOG_REMOVE: `${prefix} site appcatalog remove`,

package/dist/m365/teams/commands/tab/tab-add.js

@@ -70,9 +70,15 @@ class TeamsTabAddCommand extends GraphCommand {
         if (options.contentUrl) {
             requestBody.configuration.contentUrl = options.contentUrl;
         }
-        options.entityId ? requestBody.configuration.entityId = options.entityId : null;
-        options.removeUrl ? requestBody.configuration.removeUrl = options.removeUrl : null;
-        options.websiteUrl ? requestBody.configuration.websiteUrl = options.websiteUrl : null;
+        if (options.entityId) {
+            requestBody.configuration.entityId = options.entityId;
+        }
+        if (options.removeUrl) {
+            requestBody.configuration.removeUrl = options.removeUrl;
+        }
+        if (options.websiteUrl) {
+            requestBody.configuration.websiteUrl = options.websiteUrl;
+        }
         Object.keys(options).forEach(key => {
             if (excludeOptions.indexOf(key) === -1) {
                 requestBody.configuration[key] = `${options[key]}`;

package/dist/m365/viva/commands/connections/connections-app-create.js

@@ -44,7 +44,7 @@ class VivaConnectionsAppCreateCommand extends AnonymousCommand {
             const appPortalUrl = `${args.options.portalUrl}${args.options.portalUrl.indexOf('?') > -1 ? '&' : '?'}app=portals`;
             let searchUrlPath = portalUrl.hostname;
             if (portalUrl.pathname.indexOf('/teams') > -1 || portalUrl.pathname.indexOf('/sites') > -1) {
-                const firstTwoUrlSegments = portalUrl.pathname.match(/^\/[^\/]+\/[^\/]+/);
+                const firstTwoUrlSegments = portalUrl.pathname.match(/^\/[^/]+\/[^/]+/);
                 if (firstTwoUrlSegments) {
                     searchUrlPath += firstTwoUrlSegments[0];
                 }

package/dist/m365/viva/commands/engage/engage-community-user-add.js

@@ -48,7 +48,7 @@ class VivaEngageCommunityUserAddCommand extends GraphCommand {
             .refine(options => options.ids || options.userNames, {
             message: 'Specify either of ids or userNames.'
         })
-            .refine(options => typeof options.userNames !== undefined && typeof options.ids !== undefined, {
+            .refine(options => options.userNames !== undefined || options.ids !== undefined, {
             message: 'Specify either ids or userNames, but not both.'
         });
     }

package/dist/m365/viva/commands/engage/engage-community-user-remove.js

@@ -48,7 +48,7 @@ class VivaEngageCommunityUserRemoveCommand extends GraphCommand {
             .refine(options => options.id || options.userName, {
             message: 'Specify either of id or userName.'
         })
-            .refine(options => typeof options.userName !== undefined && typeof options.id !== undefined, {
+            .refine(options => options.userName !== undefined || options.id !== undefined, {
             message: 'Specify either id or userName, but not both.'
         });
     }

package/dist/telemetry.js

@@ -21,7 +21,9 @@ async function trackTelemetry(object) {
         }
         await appInsights.flush();
     }
-    catch { }
+    catch {
+        // Do nothing
+    }
 }
 export const telemetry = {
     trackEvent: async (commandName, properties, exception) => {

package/dist/utils/accessToken.js

@@ -16,6 +16,7 @@ export const accessToken = {
             isAppOnlyAccessToken = token.idtyp === 'app';
         }
         catch {
+            // Do nothing
         }
         return isAppOnlyAccessToken;
     },
@@ -34,6 +35,7 @@ export const accessToken = {
             tenantId = token.tid;
         }
         catch {
+            // Do nothing
         }
         return tenantId;
     },
@@ -54,6 +56,7 @@ export const accessToken = {
             userName = token.upn || token.app_displayname;
         }
         catch {
+            // Do nothing
         }
         return userName;
     },
@@ -72,6 +75,7 @@ export const accessToken = {
             userId = token.oid;
         }
         catch {
+            // Do nothing
         }
         return userId;
     },

package/dist/utils/cache.js

@@ -28,7 +28,9 @@ export const cache = {
             // eslint-disable-next-line @typescript-eslint/no-empty-function
             fs.writeFile(cacheFilePath, value, () => { });
         }
-        catch { }
+        catch {
+            // Do nothing
+        }
     },
     clearExpired(cb) {
         // we don't need to wait for this to complete
@@ -58,7 +60,6 @@ export const cache = {
                     // remove files that haven't been accessed in the last 24 hours
                     if (stats.atime.getTime() < Date.now() - 24 * 60 * 60 * 1000) {
                         // we don't need to wait for the file to be deleted
-                        // eslint-disable-next-line @typescript-eslint/no-empty-function
                         fs.unlink(path.join(cacheFolderPath, file), () => {
                             if (cb && index === numFiles - 1) {
                                 cb();

package/dist/utils/customAppScope.js

@@ -16,7 +16,7 @@ export const customAppScope = {
         }
         const customAppScopes = await odata.getAllItems(url);
         if (customAppScopes.length === 0) {
-            throw `The specified custom application scope '${displayName}' does not exist.`;
+            throw new Error(`The specified custom application scope '${displayName}' does not exist.`);
         }
         if (customAppScopes.length > 1) {
             const resultAsKeyValuePair = formatting.convertArrayToHashTable('id', customAppScopes);

package/dist/utils/directoryExtension.js

@@ -16,7 +16,7 @@ export const directoryExtension = {
         }
         const extensionProperties = await odata.getAllItems(url);
         if (extensionProperties.length === 0) {
-            throw `The specified directory extension '${name}' does not exist.`;
+            throw new Error(`The specified directory extension '${name}' does not exist.`);
         }
         // there can be only one directory extension with a given name
         return extensionProperties[0];

package/dist/utils/entraAdministrativeUnit.js

@@ -24,7 +24,7 @@ export const entraAdministrativeUnit = {
         const graphResource = 'https://graph.microsoft.com';
         const administrativeUnits = await odata.getAllItems(`${graphResource}/v1.0/directory/administrativeUnits?$filter=displayName eq '${formatting.encodeQueryParameter(displayName)}'${queryString}`);
         if (administrativeUnits.length === 0) {
-            throw `The specified administrative unit '${displayName}' does not exist.`;
+            throw new Error(`The specified administrative unit '${displayName}' does not exist.`);
         }
         if (administrativeUnits.length > 1) {
             const resultAsKeyValuePair = formatting.convertArrayToHashTable('id', administrativeUnits);

package/dist/utils/entraApp.js

@@ -305,7 +305,7 @@ export const entraApp = {
         }
         const apps = await odata.getAllItems(url);
         if (apps.length === 0) {
-            throw `App with appId '${appId}' not found in Microsoft Entra ID`;
+            throw new Error(`App with appId '${appId}' not found in Microsoft Entra ID.`);
         }
         return apps[0];
     },
@@ -316,7 +316,7 @@ export const entraApp = {
         }
         const apps = await odata.getAllItems(url);
         if (apps.length === 0) {
-            throw `App with name '${appName}' not found in Microsoft Entra ID`;
+            throw new Error(`App with name '${appName}' not found in Microsoft Entra ID.`);
         }
         if (apps.length > 1) {
             const resultAsKeyValuePair = formatting.convertArrayToHashTable('id', apps);

package/dist/utils/entraDevice.js

@@ -12,7 +12,7 @@ export const entraDevice = {
     async getDeviceByDisplayName(displayName) {
         const devices = await odata.getAllItems(`${graphResource}/v1.0/devices?$filter=displayName eq '${formatting.encodeQueryParameter(displayName)}'`);
         if (devices.length === 0) {
-            throw `The specified device '${displayName}' does not exist.`;
+            throw new Error(`The specified device '${displayName}' does not exist.`);
         }
         if (devices.length > 1) {
             const resultAsKeyValuePair = formatting.convertArrayToHashTable('id', devices);

package/dist/utils/entraServicePrincipal.js

@@ -17,7 +17,7 @@ export const entraServicePrincipal = {
         }
         const apps = await odata.getAllItems(url);
         if (apps.length === 0) {
-            throw `Service principal with appId '${appId}' not found in Microsoft Entra ID`;
+            throw new Error(`Service principal with appId '${appId}' not found in Microsoft Entra ID.`);
         }
         return apps[0];
     },
@@ -35,7 +35,7 @@ export const entraServicePrincipal = {
         }
         const apps = await odata.getAllItems(url);
         if (apps.length === 0) {
-            throw `Service principal with name '${appName}' not found in Microsoft Entra ID`;
+            throw new Error(`Service principal with name '${appName}' not found in Microsoft Entra ID.`);
         }
         if (apps.length > 1) {
             const resultAsKeyValuePair = formatting.convertArrayToHashTable('id', apps);

package/dist/utils/formatting.js

@@ -99,7 +99,7 @@ export const formatting = {
     },
     openTypesEncoder(value) {
         return value
-            .replace(/\%/g, '%25')
+            .replace(/%/g, '%25')
             .replace(/\./g, '%2E')
             .replace(/:/g, '%3A')
             .replace(/@/g, '%40')

package/dist/utils/md.js

@@ -32,7 +32,7 @@ function convertDd(md) {
     });
 }
 function convertHyperlinks(md) {
-    return md.replace(/(?!\[1m)(?!\[22m)\[([^\]]+)\]\(([^\)]+)\)/gm, (match, label, url) => {
+    return md.replace(/(?!\[1m)(?!\[22m)\[([^\]]+)\]\(([^)]+)\)/gm, (match, label, url) => {
         // if the link is the same as the content, return just the link
         if (label === url) {
             return url;
@@ -54,7 +54,7 @@ function convertContentTabs(md) {
         .trim();
 }
 function convertCodeFences(md) {
-    const regex = new RegExp('^```.*?(?:\r?\n)(.*?)```(?:\r?\n)', 'gms');
+    const regex = /^```.*?(?:\r?\n)(.*?)```(?:\r?\n)/gms;
     return md.replace(regex, (match, code) => {
         return `${code.replace(/^(.+)$/gm, '  $1')}${EOL}`;
     });

package/dist/utils/odata.js

@@ -1,4 +1,6 @@
 import request from "../request.js";
+/* eslint-enable no-redeclare */
+// eslint-disable-next-line no-redeclare
 async function getAllItems(param1, metadata) {
     let items = [];
     const requestOptions = typeof param1 !== 'string' ? param1 : {

package/dist/utils/planner.js

@@ -22,7 +22,7 @@ export const planner = {
         try {
             return await request.get(requestOptions);
         }
-        catch (ex) {
+        catch {
             throw Error(`Planner plan with id '${id}' was not found.`);
         }
     },

package/dist/utils/powerPlatform.js

@@ -39,7 +39,7 @@ export const powerPlatform = {
             const response = await request.get(requestOptions);
             return response;
         }
-        catch (ex) {
+        catch {
             throw Error(`The specified Power Page website with id '${id}' does not exist.`);
         }
     },
@@ -97,7 +97,7 @@ export const powerPlatform = {
    */
     async getSolutionByName(dynamicsApiUrl, name) {
         const requestOptions = {
-            url: `${dynamicsApiUrl}/api/data/v9.0/solutions?$filter=isvisible eq true and uniquename eq \'${name}\'&$expand=publisherid($select=friendlyname)&$select=solutionid,uniquename,version,publisherid,installedon,solutionpackageversion,friendlyname,versionnumber&api-version=9.1`,
+            url: `${dynamicsApiUrl}/api/data/v9.0/solutions?$filter=isvisible eq true and uniquename eq '${name}'&$expand=publisherid($select=friendlyname)&$select=solutionid,uniquename,version,publisherid,installedon,solutionpackageversion,friendlyname,versionnumber&api-version=9.1`,
             headers: {
                 accept: 'application/json;odata.metadata=none'
             },

package/dist/utils/roleDefinition.js

@@ -17,7 +17,7 @@ export const roleDefinition = {
         }
         const roleDefinitions = await odata.getAllItems(url);
         if (roleDefinitions.length === 0) {
-            throw `The specified role definition '${displayName}' does not exist.`;
+            throw new Error(`The specified role definition '${displayName}' does not exist.`);
         }
         if (roleDefinitions.length > 1) {
             const resultAsKeyValuePair = formatting.convertArrayToHashTable('id', roleDefinitions);
@@ -61,7 +61,7 @@ export const roleDefinition = {
         }
         const roleDefinitions = await odata.getAllItems(url);
         if (roleDefinitions.length === 0) {
-            throw `The specified role definition '${displayName}' does not exist.`;
+            throw new Error(`The specified role definition '${displayName}' does not exist.`);
         }
         if (roleDefinitions.length > 1) {
             const resultAsKeyValuePair = formatting.convertArrayToHashTable('id', roleDefinitions);

package/dist/utils/spo.js

@@ -114,7 +114,7 @@ export const spo = {
         try {
             await auth.storeConnectionInfo();
         }
-        catch (e) {
+        catch {
             if (debug) {
                 await logger.logToStderr('Error while storing connection info');
             }
@@ -123,7 +123,7 @@ export const spo = {
     },
     async getSpoAdminUrl(logger, debug) {
         const spoUrl = await spo.getSpoUrl(logger, debug);
-        return (spoUrl.replace(/(https:\/\/)([^\.]+)(.*)/, '$1$2-admin$3'));
+        return (spoUrl.replace(/(https:\/\/)([^.]+)(.*)/, '$1$2-admin$3'));
     },
     async getTenantId(logger, debug) {
         if (auth.connection.spoTenantId) {
@@ -151,7 +151,7 @@ export const spo = {
         try {
             await auth.storeConnectionInfo();
         }
-        catch (e) {
+        catch {
             if (debug) {
                 await logger.logToStderr('Error while storing connection info');
             }
@@ -749,10 +749,7 @@ export const spo = {
                 }
             }
             else {
-                if (siteDesignId) {
-                    siteDesignId = siteDesignId;
-                }
-                else {
+                if (!siteDesignId) {
                     if (siteDesign) {
                         switch (siteDesign) {
                             case 'Topic':
@@ -1592,10 +1589,12 @@ export const spo = {
         const requestBody = {
             formValues: requestBodyOptions
         };
-        contentTypeName && requestBody.formValues.push({
-            FieldName: 'ContentType',
-            FieldValue: contentTypeName
-        });
+        if (contentTypeName) {
+            requestBody.formValues.push({
+                FieldName: 'ContentType',
+                FieldValue: contentTypeName
+            });
+        }
         const requestOptions = {
             url: `${absoluteListUrl}/items(${itemId})/ValidateUpdateListItem()`,
             headers: {

package/dist/utils/urlUtil.js

@@ -176,7 +176,7 @@ export const urlUtil = {
     getTargetSiteAbsoluteUrl(webUrl, url) {
         const fullUrl = url.startsWith('https://') ? url : urlUtil.getAbsoluteUrl(webUrl, url);
         // Pattern to match SharePoint URLs
-        const urlPattern = /https:\/\/[\w\-]+\.sharepoint\.com\/(teams|sites|personal)\/([\w\-]+)/;
+        const urlPattern = /https:\/\/[\w-]+\.sharepoint\.com\/(teams|sites|personal)\/([\w-]+)/;
         const match = fullUrl.match(urlPattern);
         if (match) {
             // If a match is found, return the matched URL

package/dist/utils/validation.js

@@ -309,7 +309,7 @@ export const validation = {
             return false;
         }
         const hasInvalidProperties = validThemeProperties.map((property) => {
-            return theme.hasOwnProperty(property);
+            return Object.prototype.hasOwnProperty.call(theme, property);
         }).includes(false);
         if (hasInvalidProperties) {
             return false;

package/dist/utils/vivaEngage.js

@@ -19,7 +19,7 @@ export const vivaEngage = {
         };
         const community = await request.get(requestOptions);
         if (!community) {
-            throw `The specified Viva Engage community with ID '${communityId}' does not exist.`;
+            throw new Error(`The specified Viva Engage community with ID '${communityId}' does not exist.`);
         }
         return community;
     },
@@ -32,7 +32,7 @@ export const vivaEngage = {
     async getCommunityByDisplayName(displayName, selectProperties) {
         const communities = await odata.getAllItems(`https://graph.microsoft.com/v1.0/employeeExperience/communities?$filter=displayName eq '${formatting.encodeQueryParameter(displayName)}'&$select=${selectProperties.join(',')}`);
         if (communities.length === 0) {
-            throw `The specified Viva Engage community '${displayName}' does not exist.`;
+            throw new Error(`The specified Viva Engage community '${displayName}' does not exist.`);
         }
         if (communities.length > 1) {
             const resultAsKeyValuePair = formatting.convertArrayToHashTable('id', communities);
@@ -53,7 +53,7 @@ export const vivaEngage = {
         const communities = await odata.getAllItems(`https://graph.microsoft.com/v1.0/employeeExperience/communities?$select=${properties.join(',')}`);
         const filteredCommunity = communities.find(c => c.groupId === entraGroupId);
         if (!filteredCommunity) {
-            throw `The Microsoft Entra group with id '${entraGroupId}' is not associated with any Viva Engage community.`;
+            throw new Error(`The Microsoft Entra group with id '${entraGroupId}' is not associated with any Viva Engage community.`);
         }
         return filteredCommunity;
     },

package/docs/docs/cmd/entra/approleassignment/approleassignment-add.mdx

@@ -43,6 +43,24 @@ Autocomplete values for the `resource` option do not mean allowed values. The au
 
 This command can also be used to assign permissions to system or user-assigned managed identity.
 
+## Permissions
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions                                           |
+  |-----------------|-------------------------------------------------------|
+  | Microsoft Graph | AppRoleAssignment.ReadWrite.All, Application.Read.All |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions                                           |
+  |-----------------|-------------------------------------------------------|
+  | Microsoft Graph | AppRoleAssignment.ReadWrite.All, Application.Read.All |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Adds SharePoint _Sites.Read.All_ application permissions to Entra application with app id _57907bf8-73fa-43a6-89a5-1f603e29e451_

package/docs/docs/cmd/entra/approleassignment/approleassignment-list.mdx

@@ -31,6 +31,24 @@ m365 entra approleassignment list [options]
 
 Specify either the `appId`, `appObjectId` or `appDisplayName`. If you specify more than one option value, the command will fail with an error.
 
+## Permissions
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions          |
+  |-----------------|----------------------|
+  | Microsoft Graph | Application.Read.All |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions          |
+  |-----------------|----------------------|
+  | Microsoft Graph | Application.Read.All |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 List app roles assigned to service principal with Application (client) ID _b2307a39-e878-458b-bc90-03bc578531d6_.