@pnp/cli-microsoft365 7.8.0-beta.5f64790 → 7.8.0-beta.a83837a

package/dist/m365/spo/commands/listitem/listitem-batch-remove.js

@@ -0,0 +1,222 @@
+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 _SpoListItemBatchRemoveCommand_instances, _SpoListItemBatchRemoveCommand_initTelemetry, _SpoListItemBatchRemoveCommand_initOptions, _SpoListItemBatchRemoveCommand_initValidators, _SpoListItemBatchRemoveCommand_initTypes, _SpoListItemBatchRemoveCommand_initOptionSets;
+import fs from 'fs';
+import os from 'os';
+import SpoCommand from '../../../base/SpoCommand.js';
+import commands from '../../commands.js';
+import { formatting } from '../../../../utils/formatting.js';
+import { urlUtil } from '../../../../utils/urlUtil.js';
+import { v4 } from 'uuid';
+import request from '../../../../request.js';
+import { validation } from '../../../../utils/validation.js';
+import { cli } from '../../../../cli/cli.js';
+class SpoListItemBatchRemoveCommand extends SpoCommand {
+    get name() {
+        return commands.LISTITEM_BATCH_REMOVE;
+    }
+    get description() {
+        return 'Removes items from a list in batch';
+    }
+    constructor() {
+        super();
+        _SpoListItemBatchRemoveCommand_instances.add(this);
+        __classPrivateFieldGet(this, _SpoListItemBatchRemoveCommand_instances, "m", _SpoListItemBatchRemoveCommand_initTelemetry).call(this);
+        __classPrivateFieldGet(this, _SpoListItemBatchRemoveCommand_instances, "m", _SpoListItemBatchRemoveCommand_initOptions).call(this);
+        __classPrivateFieldGet(this, _SpoListItemBatchRemoveCommand_instances, "m", _SpoListItemBatchRemoveCommand_initValidators).call(this);
+        __classPrivateFieldGet(this, _SpoListItemBatchRemoveCommand_instances, "m", _SpoListItemBatchRemoveCommand_initTypes).call(this);
+        __classPrivateFieldGet(this, _SpoListItemBatchRemoveCommand_instances, "m", _SpoListItemBatchRemoveCommand_initOptionSets).call(this);
+    }
+    async commandAction(logger, args) {
+        const removeListItems = async () => {
+            try {
+                if (this.verbose) {
+                    logger.logToStderr('Removing the listitems from SharePoint...');
+                }
+                let idsToRemove = [];
+                if (args.options.filePath) {
+                    const csvContent = fs.readFileSync(args.options.filePath, 'utf-8');
+                    const jsonContent = formatting.parseCsvToJson(csvContent);
+                    idsToRemove = jsonContent.map((item) => item['ID']);
+                }
+                else {
+                    idsToRemove = formatting.splitAndTrim(args.options.ids);
+                }
+                await this.removeItemsAsBatch(idsToRemove, args.options, logger);
+            }
+            catch (err) {
+                this.handleRejectedODataJsonPromise(err);
+            }
+        };
+        if (args.options.force) {
+            await removeListItems();
+        }
+        else {
+            const result = await cli.promptForConfirmation({ message: `Are you sure you want to ${args.options.recycle ? "recycle" : "remove"} the list items from list ${args.options.listId || args.options.listTitle || args.options.listUrl} located in site ${args.options.webUrl}?` });
+            if (result) {
+                await removeListItems();
+            }
+        }
+    }
+    async removeItemsAsBatch(items, options, logger) {
+        const itemsChunks = this.getChunkedArray(items, 10);
+        for (const [index, chunk] of itemsChunks.entries()) {
+            if (this.verbose) {
+                await logger.logToStderr(`Processing chunk ${index + 1} of ${itemsChunks.length}...`);
+            }
+            await this.postBatchData(chunk, options.webUrl, options);
+        }
+    }
+    async postBatchData(chunk, webUrl, options) {
+        const batchId = v4();
+        const requestBody = this.getRequestBody(chunk, batchId, options);
+        const requestOptions = {
+            url: `${webUrl}/_api/$batch`,
+            headers: {
+                'Content-Type': `multipart/mixed; boundary=batch_${batchId}`,
+                'Accept': 'application/json;odata=verbose'
+            },
+            data: requestBody.join('')
+        };
+        const response = await request.post(requestOptions);
+        const errors = this.parseBatchResponseBody(response, chunk);
+        if (errors.length > 0) {
+            throw `Creating some items failed with the following errors: ${os.EOL}${errors.map(error => { return `- ${error}`; }).join(os.EOL)}`;
+        }
+    }
+    getRequestBody(chunk, batchId, options) {
+        const changeSetId = v4();
+        const batchBody = [];
+        batchBody.push(`--batch_${batchId}\n`);
+        batchBody.push(`Content-Type: multipart/mixed; boundary="changeset_${changeSetId}"\n\n`);
+        batchBody.push('Content-Transfer-Encoding: binary\n\n');
+        for (const item of chunk) {
+            const actionUrl = this.getActionUrl(options, item);
+            batchBody.push(`--changeset_${changeSetId}\n`);
+            batchBody.push('Content-Type: application/http\n');
+            batchBody.push('Content-Transfer-Encoding: binary\n\n');
+            batchBody.push(`DELETE ${actionUrl} HTTP/1.1\n`);
+            batchBody.push(`Accept: application/json;odata=nometadata\n`);
+            batchBody.push(`If-Match: *\n\n`);
+        }
+        batchBody.push(`\n\n`);
+        batchBody.push(`--changeset_${changeSetId}--\n\n`);
+        batchBody.push(`--batch_${batchId}--\n`);
+        return batchBody;
+    }
+    parseBatchResponseBody(response, chunk) {
+        const errors = [];
+        response.split('\r\n')
+            .filter((line) => line.startsWith('{'))
+            .forEach((line, index) => {
+            const parsedResponse = JSON.parse(line);
+            if (parsedResponse.error) {
+                const error = parsedResponse.error;
+                errors.push(`Item ID ${chunk[index]}: ${error.message.value}`);
+            }
+        });
+        return errors;
+    }
+    ;
+    getChunkedArray(inputArray, chunkSize) {
+        const result = [];
+        for (let i = 0; i < inputArray.length; i += chunkSize) {
+            result.push(inputArray.slice(i, i + chunkSize));
+        }
+        return result;
+    }
+    getActionUrl(options, item) {
+        let requestUrl = '';
+        if (options.listId) {
+            requestUrl += `lists(guid'${formatting.encodeQueryParameter(options.listId)}')`;
+        }
+        else if (options.listTitle) {
+            requestUrl += `lists/getByTitle('${formatting.encodeQueryParameter(options.listTitle)}')`;
+        }
+        else if (options.listUrl) {
+            const listServerRelativeUrl = urlUtil.getServerRelativePath(options.webUrl, options.listUrl);
+            requestUrl += `GetList('${formatting.encodeQueryParameter(listServerRelativeUrl)}')`;
+        }
+        requestUrl += `/items(${item})`;
+        if (options.recycle) {
+            requestUrl += '/recycle()';
+        }
+        return requestUrl;
+    }
+}
+_SpoListItemBatchRemoveCommand_instances = new WeakSet(), _SpoListItemBatchRemoveCommand_initTelemetry = function _SpoListItemBatchRemoveCommand_initTelemetry() {
+    this.telemetry.push((args) => {
+        Object.assign(this.telemetryProperties, {
+            filePath: typeof args.options.filePath !== 'undefined',
+            ids: typeof args.options.ids !== 'undefined',
+            listId: typeof args.options.listId !== 'undefined',
+            listTitle: typeof args.options.listTitle !== 'undefined',
+            listUrl: typeof args.options.listUrl !== 'undefined',
+            recycle: !!args.options.recycle,
+            force: !!args.options.force
+        });
+    });
+}, _SpoListItemBatchRemoveCommand_initOptions = function _SpoListItemBatchRemoveCommand_initOptions() {
+    this.options.unshift({
+        option: '-u, --webUrl <webUrl>'
+    }, {
+        option: '-l, --listId [listId]'
+    }, {
+        option: '-t, --listTitle [listTitle]'
+    }, {
+        option: '--listUrl [listUrl]'
+    }, {
+        option: '-p, --filePath [filePath]'
+    }, {
+        option: '-i, --ids [ids]'
+    }, {
+        option: '-r, --recycle'
+    }, {
+        option: '-f, --force'
+    });
+}, _SpoListItemBatchRemoveCommand_initValidators = function _SpoListItemBatchRemoveCommand_initValidators() {
+    this.validators.push(async (args) => {
+        const isValidSharePointUrl = validation.isValidSharePointUrl(args.options.webUrl);
+        if (isValidSharePointUrl !== true) {
+            return isValidSharePointUrl;
+        }
+        if (args.options.listId &&
+            !validation.isValidGuid(args.options.listId)) {
+            return `${args.options.listId} in option listId is not a valid GUID.`;
+        }
+        if (args.options.filePath) {
+            if (!fs.existsSync(args.options.filePath)) {
+                return `File with path ${args.options.filePath} does not exist.`;
+            }
+            const fileContent = fs.readFileSync(args.options.filePath, 'utf-8');
+            const jsonContent = formatting.parseCsvToJson(fileContent);
+            if (!jsonContent[0].hasOwnProperty('ID')) {
+                return `The file does not contain the required header row with the column name 'ID'.`;
+            }
+            const nonNumbers = jsonContent.filter(element => isNaN(Number(element['ID'].toString().trim()))).map(element => element['ID']);
+            if (nonNumbers.length > 0) {
+                return `The specified ids '${nonNumbers.join(', ')}' are invalid numbers.`;
+            }
+        }
+        if (args.options.ids) {
+            const nonNumbers = formatting.splitAndTrim(args.options.ids).filter(element => isNaN(Number(element)));
+            if (nonNumbers.length > 0) {
+                return `The specified ids '${nonNumbers.join(', ')}' are invalid numbers.`;
+            }
+        }
+        return true;
+    });
+}, _SpoListItemBatchRemoveCommand_initTypes = function _SpoListItemBatchRemoveCommand_initTypes() {
+    this.types.string.push('webUrl', 'listId', 'listTitle', 'listUrl', 'ids', 'filePath');
+}, _SpoListItemBatchRemoveCommand_initOptionSets = function _SpoListItemBatchRemoveCommand_initOptionSets() {
+    this.optionSets.push({
+        options: ['listId', 'listTitle', 'listUrl']
+    }, {
+        options: ['filePath', 'ids']
+    });
+};
+export default new SpoListItemBatchRemoveCommand();
+//# sourceMappingURL=listitem-batch-remove.js.map

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

@@ -135,8 +135,9 @@ _SpoNavigationNodeAddCommand_instances = new WeakSet(), _SpoNavigationNodeAddCom
             if (audienceIdsSplitted.length > 10) {
                 return 'The maximum amount of audienceIds per navigation node exceeded. The maximum amount of auciendeIds is 10.';
             }
-            if (!validation.isValidGuidArray(audienceIdsSplitted)) {
-                return 'The option audienceIds contains one or more invalid GUIDs';
+            const isValidGUIDArrayResult = validation.isValidGuidArray(args.options.audienceIds);
+            if (isValidGUIDArrayResult !== true) {
+                return `The following GUIDs are invalid for the option 'audienceIds': ${isValidGUIDArrayResult}.`;
             }
         }
         return true;

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

@@ -127,8 +127,9 @@ _SpoNavigationNodeSetCommand_instances = new WeakSet(), _SpoNavigationNodeSetCom
             if (audienceIdsSplitted.length > 10) {
                 return 'The maximum amount of audienceIds per navigation node exceeded. The maximum amount of audienceIds is 10.';
             }
-            if (!validation.isValidGuidArray(audienceIdsSplitted)) {
-                return `The option audienceIds contains one or more invalid GUIDs`;
+            const isValidGUIDArrayResult = validation.isValidGuidArray(args.options.audienceIds);
+            if (isValidGUIDArrayResult !== true) {
+                return `The following GUIDs are invalid for the option 'audienceIds': ${isValidGUIDArrayResult}.`;
             }
         }
         return true;

package/dist/m365/spo/commands/site/site-recyclebinitem-move.js

@@ -89,8 +89,11 @@ _SpoSiteRecycleBinItemMoveCommand_instances = new WeakSet(), _SpoSiteRecycleBinI
         if (isValidSharePointUrl !== true) {
             return isValidSharePointUrl;
         }
-        if (args.options.ids && !validation.isValidGuidArray(args.options.ids.split(','))) {
-            return 'The option ids contains one or more invalid GUIDs';
+        if (args.options.ids) {
+            const isValidGUIDArrayResult = validation.isValidGuidArray(args.options.ids);
+            if (isValidGUIDArrayResult !== true) {
+                return `The following GUIDs are invalid for the option 'ids': ${isValidGUIDArrayResult}.`;
+            }
         }
         return true;
     });

package/dist/m365/spo/commands/site/site-recyclebinitem-remove.js

@@ -76,8 +76,9 @@ _SpoSiteRecycleBinItemRemoveCommand_instances = new WeakSet(), _SpoSiteRecycleBi
         if (isValidSharePointUrl !== true) {
             return isValidSharePointUrl;
         }
-        if (!validation.isValidGuidArray(args.options.ids.split(','))) {
-            return 'The option ids contains one or more invalid GUIDs.';
+        const isValidGUIDArrayResult = validation.isValidGuidArray(args.options.ids);
+        if (isValidGUIDArrayResult !== true) {
+            return `The following GUIDs are invalid for the option 'ids': ${isValidGUIDArrayResult}.`;
         }
         return true;
     });

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

@@ -3,8 +3,9 @@ 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 _SpoSetCommand_instances, _SpoSetCommand_initOptions, _SpoSetCommand_initValidators;
+var _SpoSetCommand_instances, _SpoSetCommand_initOptions, _SpoSetCommand_initValidators, _SpoSetCommand_initTypes;
 import auth from '../../../Auth.js';
+import { urlUtil } from '../../../utils/urlUtil.js';
 import { validation } from '../../../utils/validation.js';
 import SpoCommand from '../../base/SpoCommand.js';
 import commands from '../commands.js';
@@ -20,9 +21,10 @@ class SpoSetCommand extends SpoCommand {
         _SpoSetCommand_instances.add(this);
         __classPrivateFieldGet(this, _SpoSetCommand_instances, "m", _SpoSetCommand_initOptions).call(this);
         __classPrivateFieldGet(this, _SpoSetCommand_instances, "m", _SpoSetCommand_initValidators).call(this);
+        __classPrivateFieldGet(this, _SpoSetCommand_instances, "m", _SpoSetCommand_initTypes).call(this);
     }
     async commandAction(logger, args) {
-        auth.connection.spoUrl = args.options.url;
+        auth.connection.spoUrl = urlUtil.removeTrailingSlashes(args.options.url);
         try {
             await auth.storeConnectionInfo();
         }
@@ -37,6 +39,8 @@ _SpoSetCommand_instances = new WeakSet(), _SpoSetCommand_initOptions = function
     });
 }, _SpoSetCommand_initValidators = function _SpoSetCommand_initValidators() {
     this.validators.push(async (args) => validation.isValidSharePointUrl(args.options.url));
+}, _SpoSetCommand_initTypes = function _SpoSetCommand_initTypes() {
+    this.types.string.push('url');
 };
 export default new SpoSetCommand();
 //# sourceMappingURL=spo-set.js.map

package/dist/m365/spo/commands.js

@@ -164,6 +164,7 @@ export default {
     LISTITEM_ATTACHMENT_REMOVE: `${prefix} listitem attachment remove`,
     LISTITEM_ATTACHMENT_SET: `${prefix} listitem attachment set`,
     LISTITEM_BATCH_ADD: `${prefix} listitem batch add`,
+    LISTITEM_BATCH_REMOVE: `${prefix} listitem batch remove`,
     LISTITEM_BATCH_SET: `${prefix} listitem batch set`,
     LISTITEM_GET: `${prefix} listitem get`,
     LISTITEM_ISRECORD: `${prefix} listitem isrecord`,

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

@@ -136,9 +136,9 @@ _TeamsMeetingAddCommand_instances = new WeakSet(), _TeamsMeetingAddCommand_initT
             return 'The endTime value must be in the future.';
         }
         if (args.options.participantUserNames) {
-            const participants = args.options.participantUserNames.trim().toLowerCase().split(',').filter(e => e && e !== '');
-            if (!participants || participants.length === 0 || participants.some(e => !validation.isValidUserPrincipalName(e))) {
-                return `'${args.options.participantUserNames}' contains one or more invalid UPN.`;
+            const isValidUPNArrayResult = validation.isValidUserPrincipalNameArray(args.options.participantUserNames);
+            if (isValidUPNArrayResult !== true) {
+                return `The following user principal names are invalid for the option 'participantUserNames': ${isValidUPNArrayResult}.`;
             }
         }
         if (args.options.organizerEmail && !validation.isValidUserPrincipalName(args.options.organizerEmail)) {

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

@@ -226,34 +226,40 @@ _TeamsTeamAddCommand_instances = new WeakSet(), _TeamsTeamAddCommand_initTelemet
 }, _TeamsTeamAddCommand_initValidators = function _TeamsTeamAddCommand_initValidators() {
     this.validators.push(async (args) => {
         if (args.options.ownerUserNames) {
-            const isValidUserPrincipalNameArray = validation.isValidUserPrincipalNameArray(formatting.splitAndTrim(args.options.ownerUserNames));
-            if (isValidUserPrincipalNameArray !== true) {
-                return `Owner username '${isValidUserPrincipalNameArray}' is invalid for option 'ownerUserNames'.`;
+            const isValidUPNArrayResult = validation.isValidUserPrincipalNameArray(args.options.ownerUserNames);
+            if (isValidUPNArrayResult !== true) {
+                return `The following user principal names are invalid for the option 'ownerUserNames': ${isValidUPNArrayResult}.`;
             }
         }
         if (args.options.ownerEmails) {
-            const isValidUserPrincipalNameArray = validation.isValidUserPrincipalNameArray(formatting.splitAndTrim(args.options.ownerEmails));
-            if (isValidUserPrincipalNameArray !== true) {
-                return `Owner email '${isValidUserPrincipalNameArray}' is invalid for option 'ownerEmails'.`;
+            const isValidUPNArrayResult = validation.isValidUserPrincipalNameArray(args.options.ownerEmails);
+            if (isValidUPNArrayResult !== true) {
+                return `The following user principal names are invalid for the option 'ownerEmails': ${isValidUPNArrayResult}.`;
             }
         }
-        if (args.options.ownerIds && !validation.isValidGuidArray(formatting.splitAndTrim(args.options.ownerIds))) {
-            return `The option 'ownerIds' contains one or more invalid GUIDs.`;
+        if (args.options.ownerIds) {
+            const isValidGUIDArrayResult = validation.isValidGuidArray(args.options.ownerIds);
+            if (isValidGUIDArrayResult !== true) {
+                return `The following GUIDs are invalid for the option 'ownerIds': ${isValidGUIDArrayResult}.`;
+            }
         }
         if (args.options.memberUserNames) {
-            const isValidUserPrincipalNameArray = validation.isValidUserPrincipalNameArray(formatting.splitAndTrim(args.options.memberUserNames));
-            if (isValidUserPrincipalNameArray !== true) {
-                return `Member username '${isValidUserPrincipalNameArray}' is invalid for option 'memberUserNames'.`;
+            const isValidUPNArrayResult = validation.isValidUserPrincipalNameArray(args.options.memberUserNames);
+            if (isValidUPNArrayResult !== true) {
+                return `The following user principal names are invalid for the option 'memberUserNames': ${isValidUPNArrayResult}.`;
             }
         }
         if (args.options.memberEmails) {
-            const isValidUserPrincipalNameArray = validation.isValidUserPrincipalNameArray(formatting.splitAndTrim(args.options.memberEmails));
-            if (isValidUserPrincipalNameArray !== true) {
-                return `Member email '${isValidUserPrincipalNameArray}' is invalid for option 'memberEmails'.`;
+            const isValidUPNArrayResult = validation.isValidUserPrincipalNameArray(args.options.memberEmails);
+            if (isValidUPNArrayResult !== true) {
+                return `The following user principal names are invalid for the option 'memberEmails': ${isValidUPNArrayResult}.`;
             }
         }
-        if (args.options.memberIds && !validation.isValidGuidArray(formatting.splitAndTrim(args.options.memberIds))) {
-            return `The option 'memberIds' contains one or more invalid GUIDs`;
+        if (args.options.memberIds) {
+            const isValidGUIDArrayResult = validation.isValidGuidArray(args.options.memberIds);
+            if (isValidGUIDArrayResult !== true) {
+                return `The following GUIDs are invalid for the option 'memberIds': ${isValidGUIDArrayResult}.`;
+            }
         }
         return true;
     });

package/dist/utils/planner.js

@@ -1,4 +1,6 @@
+import { cli } from "../cli/cli.js";
 import request from "../request.js";
+import { formatting } from "./formatting.js";
 import { odata } from "./odata.js";
 const graphResource = 'https://graph.microsoft.com';
 const getRequestOptions = (url, metadata) => ({
@@ -12,7 +14,8 @@ export const planner = {
     /**
      * Get Planner plan by ID.
      * @param id Planner ID.
-     * @param metadata OData metadata level. Default is none
+     * @param metadata OData metadata level. Default is none.
+     * @throws Error when the plan is not found.
      */
     async getPlanById(id, metadata = 'none') {
         const requestOptions = getRequestOptions(`${graphResource}/v1.0/planner/plans/${id}`, metadata);
@@ -26,6 +29,7 @@ export const planner = {
     /**
      * Get all Planner plans for a specific group.
      * @param groupId Group ID.
+     * @param metadata OData metadata level. Default is none.
      */
     getPlansByGroupId(groupId, metadata = 'none') {
         return odata.getAllItems(`${graphResource}/v1.0/groups/${groupId}/planner/plans`, metadata);
@@ -33,30 +37,105 @@ export const planner = {
     /**
      * Get the Planner plan for a specific Roster.
      * @param rosterId Roster ID.
+     * @param metadata OData metadata level. Default is none.
+     * @throws Error when the roster has no plan.
      */
     async getPlanByRosterId(rosterId, metadata = 'none') {
         const plans = await odata.getAllItems(`${graphResource}/beta/planner/rosters/${rosterId}/plans`, metadata);
+        if (plans.length === 0) {
+            throw Error(`The specified roster '${rosterId}' does not have a plan.`);
+        }
         return plans[0];
     },
+    /**
+     * Get the Planner plan ID for a specific Roster.
+     * @param rosterId Roster ID.
+     * @throws Error when the roster has no plan.
+     */
+    async getPlanIdByRosterId(rosterId) {
+        const plans = await odata.getAllItems(`${graphResource}/beta/planner/rosters/${rosterId}/plans?$select=id`);
+        if (plans.length === 0) {
+            throw Error(`The specified roster '${rosterId}' does not have a plan.`);
+        }
+        return plans[0].id;
+    },
     /**
      * Get Planner plan by title in a specific group.
      * @param title Title of the Planner plan. Case insensitive.
      * @param groupId Owner group ID.
-     * @param rosterId Roster ID.
+     * @param metadata OData metadata level. Default is none.
+     * @throws Error when the plan is not found.
      */
     async getPlanByTitle(title, groupId, metadata = 'none') {
-        let plans = [];
-        if (groupId) {
-            plans = await this.getPlansByGroupId(groupId, metadata);
-        }
+        const plans = await this.getPlansByGroupId(groupId, metadata);
         const filteredPlans = plans.filter(p => p.title && p.title.toLowerCase() === title.toLowerCase());
-        if (!filteredPlans.length) {
+        if (filteredPlans.length === 0) {
             throw Error(`The specified plan '${title}' does not exist.`);
         }
         if (filteredPlans.length > 1) {
-            throw Error(`Multiple plans with title '${title}' found: ${filteredPlans.map(x => x.id)}.`);
+            const plansKeyValuePair = formatting.convertArrayToHashTable('id', filteredPlans);
+            const plan = await cli.handleMultipleResultsFound(`Multiple plans with title '${title}' found.`, plansKeyValuePair);
+            return plan;
         }
         return filteredPlans[0];
+    },
+    /**
+     * Get Planner plan ID by title in a specific group.
+     * @param title Title of the Planner plan. Case insensitive.
+     * @param groupId Owner group ID.
+     * @throws Error when the plan is not found.
+     */
+    async getPlanIdByTitle(title, groupId) {
+        const plans = await odata.getAllItems(`${graphResource}/v1.0/groups/${groupId}/planner/plans?$select=id,title`);
+        const filteredPlans = plans.filter(p => p.title && p.title.toLowerCase() === title.toLowerCase());
+        if (filteredPlans.length === 0) {
+            throw Error(`The specified plan '${title}' does not exist.`);
+        }
+        if (filteredPlans.length > 1) {
+            const plansKeyValuePair = formatting.convertArrayToHashTable('id', filteredPlans);
+            const plan = await cli.handleMultipleResultsFound(`Multiple plans with title '${title}' found.`, plansKeyValuePair);
+            return plan.id;
+        }
+        return filteredPlans[0].id;
+    },
+    /**
+     * Get Planner bucket by title in a specific plan.
+     * @param title Title of the Planner bucket. Case insensitive.
+     * @param planId ID of the plan that contains the bucket.
+     * @param metadata OData metadata level. Default is none.
+     * @throws Error when the bucket is not found.
+     */
+    async getBucketByTitle(title, planId, metadata = 'none') {
+        const buckets = await odata.getAllItems(`${graphResource}/v1.0/planner/plans/${planId}/buckets`, metadata);
+        const filteredBuckets = buckets.filter(b => b.name && b.name.toLowerCase() === title.toLowerCase());
+        if (filteredBuckets.length === 0) {
+            throw Error(`The specified bucket '${title}' does not exist.`);
+        }
+        if (filteredBuckets.length > 1) {
+            const bucketsKeyValuePair = formatting.convertArrayToHashTable('id', filteredBuckets);
+            const bucket = await cli.handleMultipleResultsFound(`Multiple buckets with name '${title}' found.`, bucketsKeyValuePair);
+            return bucket;
+        }
+        return filteredBuckets[0];
+    },
+    /**
+     * Get Planner bucket ID by title in a specific plan.
+     * @param title Title of the Planner bucket. Case insensitive.
+     * @param planId ID of the plan that contains the bucket.
+     * @throws Error when the bucket is not found.
+     */
+    async getBucketIdByTitle(title, planId) {
+        const buckets = await odata.getAllItems(`${graphResource}/v1.0/planner/plans/${planId}/buckets?$select=id,name`);
+        const filteredBuckets = buckets.filter(b => b.name && b.name.toLowerCase() === title.toLowerCase());
+        if (filteredBuckets.length === 0) {
+            throw Error(`The specified bucket '${title}' does not exist.`);
+        }
+        if (filteredBuckets.length > 1) {
+            const bucketsKeyValuePair = formatting.convertArrayToHashTable('id', filteredBuckets);
+            const bucket = await cli.handleMultipleResultsFound(`Multiple buckets with name '${title}' found.`, bucketsKeyValuePair);
+            return bucket.id;
+        }
+        return filteredBuckets[0].id;
     }
 };
 //# sourceMappingURL=planner.js.map

package/dist/utils/validation.js

@@ -1,6 +1,8 @@
 export const validation = {
-    isValidGuidArray(guids) {
-        return guids.every(guid => this.isValidGuid(guid));
+    isValidGuidArray(guidsString) {
+        const guids = guidsString.split(',').map(guid => guid.trim());
+        const invalidGuids = guids.filter(guid => !this.isValidGuid(guid));
+        return invalidGuids.length > 0 ? invalidGuids.join(', ') : true;
     },
     isValidGuid(guid) {
         if (!guid) {
@@ -21,9 +23,10 @@ export const validation = {
         const guidRegEx = new RegExp(/^19:[0-9a-zA-Z-_]+(@thread\.v2|@unq\.gbl\.spaces)$/i);
         return guidRegEx.test(guid);
     },
-    isValidUserPrincipalNameArray(upns) {
-        const invalidGuid = upns.find(upn => !this.isValidUserPrincipalName(upn));
-        return invalidGuid || true;
+    isValidUserPrincipalNameArray(upnsString) {
+        const upns = upnsString.split(',').map(upn => upn.trim());
+        const invalidUPNs = upns.filter(upn => !this.isValidUserPrincipalName(upn));
+        return invalidUPNs.length > 0 ? invalidUPNs.join(', ') : true;
     },
     isValidUserPrincipalName(upn) {
         const upnRegEx = new RegExp(/^[a-zA-Z0-9.!#$%&'*+/=?^_`{|}~-]+@[a-zA-Z0-9-]+(?:\.[a-zA-Z0-9-]+)*$/i);

package/docs/docs/cmd/entra/app/app-permission-add.mdx

@@ -23,10 +23,13 @@ m365 entra appregistration permission add [options]
 
 ```md definition-list
 `-i, --appId [appId]`
-: Client ID of the Microsoft Entra app to add the API permissions to. Specify `appId` or `appObjectId` but not both.
+: Client ID of the Microsoft Entra app to add the API permissions to. Specify either `appId`, `appName` or `appObjectId`.
+
+`-n, --appName [appName]`
+: Display name of the Microsoft Entra app to add the API permissions to. Specify either `appId`, `appName` or `appObjectId`.
 
 `--appObjectId [appObjectId]`
-: Object ID of the Microsoft Entra app to add the API permissions to. Specify `appId` or `appObjectId` but not both.
+: Object ID of the Microsoft Entra app to add the API permissions to. Specify either `appId`, `appName` or `appObjectId`.
 
 `-a, --applicationPermissions [applicationPermissions]`
 : Space-separated list of application permissions to add. Specify at least `applicationPermissions` or `delegatedPermissions`.
@@ -58,10 +61,10 @@ Grant multiple delegated API permissions to a Microsoft Entra app specified by o
 m365 entra app permission add --appObjectId 'e0306bb2-bf0b-4cc5-a845-a0b2cf11f690' --delegatedPermissions 'https://management.azure.com/user_impersonation https://service.flow.microsoft.com/Flows.Read.All https://graph.microsoft.com/Agreement.Read.All'
 ```
 
-Grant multiple app-only permissions to a Microsoft Entra app specified by client id and grant admin consent.
+Grant multiple app-only permissions to a Microsoft Entra app specified by app display name and grant admin consent.
 
 ```sh
-m365 entra app permission add --appId 'f1417aa3-bf0b-4cc5-a845-a0b2cf11f690' --applicationPermissions 'https://graph.microsoft.com/Sites.FullControl.All https://microsoft.sharepoint-df.com/Sites.FullControl.All' --grantAdminConsent
+m365 entra app permission add --appName 'Contoso App' --applicationPermissions 'https://graph.microsoft.com/Sites.FullControl.All https://microsoft.sharepoint-df.com/Sites.FullControl.All' --grantAdminConsent
 ```
 
 ## Response

package/docs/docs/cmd/entra/app/app-permission-list.mdx

@@ -22,10 +22,13 @@ m365 aad app permission list [options]
 
 ```md definition-list
 `-i, --appId [appId]`
-: Client ID of the Application Registration to retrieve the permissions for. Specify `appId` or `appObjectId` but not both.
+: Client ID of the Entra application registration to retrieve the permissions for. Specify either `appId`, `appName` or `appObjectId`.
+
+`-n, --appName [appName]`
+: Display name of the Entra application registration to add the API permissions to. Specify either `appId`, `appName` or `appObjectId`.
 
 `--appObjectId [appObjectId]`
-: Object ID of the Application Registration to retrieve the permissions for. Specify `appId` or `appObjectId` but not both.
+: Object ID of the Entra application registration to retrieve the permissions for. Specify either `appId`, `appName` or `appObjectId`.
 
 `--type [type]`
 : The type of permissions to retrieve. Allowed values: `delegated`, `application`, `all`. Defaults to `all`.
@@ -39,16 +42,22 @@ For best performance use the `objectId` option to reference the Entra applicatio
 
 ## Examples
 
-Retrieves all permissions for an Entra app registration
+Retrieves all permissions for an Entra application registration specified by client id.
 
 ```sh
 m365 entra app permission list --appId 'f1417aa3-bf0b-4cc5-a845-a0b2cf11f690'
 ```
 
-Retrieves all delegated permissions for an Entra app registration
+Retrieves all permissions for an Entra application registration by specified by app display name.
+
+```sh
+m365 entra app permission list --appName 'Contoso App'
+```
+
+Retrieves all delegated permissions for an Entra application registration specified by object id.
 
 ```sh
-m365 entra app permission list --appId 'f1417aa3-bf0b-4cc5-a845-a0b2cf11f690' --type delegated
+m365 entra app permission list --appObjectId '64381cda-d40d-4fb0-bce2-bece391546a2' --type delegated
 ```
 
 ## Response