@pnp/cli-microsoft365 7.9.0-beta.d3d4146 → 7.9.0

package/dist/m365/entra/commands/user/user-list.js

@@ -3,7 +3,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 _EntraUserListCommand_instances, _EntraUserListCommand_initTelemetry, _EntraUserListCommand_initOptions;
+var _EntraUserListCommand_instances, _a, _EntraUserListCommand_initTelemetry, _EntraUserListCommand_initOptions, _EntraUserListCommand_initValidators, _EntraUserListCommand_initTypes;
 import { formatting } from '../../../../utils/formatting.js';
 import { odata } from '../../../../utils/odata.js';
 import GraphCommand from '../../../base/GraphCommand.js';
@@ -22,31 +22,36 @@ class EntraUserListCommand extends GraphCommand {
     allowUnknownOptions() {
         return true;
     }
+    defaultProperties() {
+        return ['id', 'displayName', 'mail', 'userPrincipalName'];
+    }
     constructor() {
         super();
         _EntraUserListCommand_instances.add(this);
         __classPrivateFieldGet(this, _EntraUserListCommand_instances, "m", _EntraUserListCommand_initTelemetry).call(this);
         __classPrivateFieldGet(this, _EntraUserListCommand_instances, "m", _EntraUserListCommand_initOptions).call(this);
+        __classPrivateFieldGet(this, _EntraUserListCommand_instances, "m", _EntraUserListCommand_initValidators).call(this);
+        __classPrivateFieldGet(this, _EntraUserListCommand_instances, "m", _EntraUserListCommand_initTypes).call(this);
     }
     async commandAction(logger, args) {
         await this.showDeprecationWarning(logger, aadCommands.USER_LIST, commands.USER_LIST);
         try {
-            const selectProperties = args.options.properties ? args.options.properties : 'id,displayName,mail,userPrincipalName';
-            const allSelectProperties = selectProperties.split(',');
-            const propertiesWithSlash = allSelectProperties.filter(item => item.includes('/'));
-            const fieldExpand = propertiesWithSlash
-                .map(p => `${p.split('/')[0]}($select=${p.split('/')[1]})`)
-                .join(',');
-            const expandParam = fieldExpand.length > 0 ? `&$expand=${fieldExpand}` : '';
-            const selectParam = allSelectProperties.filter(item => !item.includes('/'));
-            let filter = '';
-            try {
-                filter = this.getFilter(args.options);
+            let url = `${this.resource}/v1.0/users`;
+            if (args.options.properties) {
+                const selectProperties = args.options.properties;
+                const allSelectProperties = selectProperties.split(',');
+                const propertiesWithSlash = allSelectProperties.filter(item => item.includes('/'));
+                const fieldExpand = propertiesWithSlash
+                    .map(p => `${p.split('/')[0]}($select=${p.split('/')[1]})`)
+                    .join(',');
+                const expandParam = fieldExpand.length > 0 ? `&$expand=${fieldExpand}` : '';
+                const selectParam = allSelectProperties.filter(item => !item.includes('/'));
+                url += `?$select=${selectParam}${expandParam}`;
             }
-            catch (ex) {
-                throw ex;
+            const filter = this.getFilter(args.options);
+            if (filter) {
+                url += `${args.options.properties ? '&' : '?'}${filter}`;
             }
-            const url = `${this.resource}/v1.0/users?$select=${selectParam}${expandParam}${(filter.length > 0 ? '&' + filter : '')}&$top=100`;
             const users = await odata.getAllItems(url);
             await logger.log(users);
         }
@@ -55,38 +60,24 @@ class EntraUserListCommand extends GraphCommand {
         }
     }
     getFilter(options) {
-        const filters = {};
-        const excludeOptions = [
-            'type',
-            'properties',
-            'p',
-            'd',
-            'debug',
-            'verbose',
-            'output',
-            'o',
-            'query',
-            '_'
-        ];
-        Object.keys(options).forEach(key => {
-            if (excludeOptions.indexOf(key) === -1) {
-                if (typeof options[key] === 'boolean') {
-                    throw `Specify value for the ${key} property`;
-                }
-                filters[key] = formatting.encodeQueryParameter(options[key].toString());
+        const filters = [];
+        const unknownOptions = this.getUnknownOptions(options);
+        Object.keys(unknownOptions).forEach(key => {
+            if (typeof options[key] === 'boolean') {
+                throw `Specify value for the ${key} property`;
             }
+            filters.push(`startsWith(${key}, '${formatting.encodeQueryParameter(options[key].toString())}')`);
         });
-        let filter = Object.keys(filters).map(key => `startsWith(${key}, '${filters[key]}')`).join(' and ');
-        if (filter.length > 0) {
-            filter = `$filter=${filter}`;
-        }
         if (options.type) {
-            filter += filter.length > 0 ? ` and userType eq '${options.type}'` : `$filter=userType eq '${options.type}'`;
+            filters.push(`userType eq '${options.type}'`);
         }
-        return filter;
+        if (filters.length > 0) {
+            return `$filter=${filters.join(' and ')}`;
+        }
+        return null;
     }
 }
-_EntraUserListCommand_instances = new WeakSet(), _EntraUserListCommand_initTelemetry = function _EntraUserListCommand_initTelemetry() {
+_a = EntraUserListCommand, _EntraUserListCommand_instances = new WeakSet(), _EntraUserListCommand_initTelemetry = function _EntraUserListCommand_initTelemetry() {
     this.telemetry.push((args) => {
         Object.assign(this.telemetryProperties, {
             type: typeof args.options.type !== 'undefined',
@@ -95,9 +86,21 @@ _EntraUserListCommand_instances = new WeakSet(), _EntraUserListCommand_initTelem
     });
 }, _EntraUserListCommand_initOptions = function _EntraUserListCommand_initOptions() {
     this.options.unshift({
-        option: "--type [type]",
-        autocomplete: ["Member", "Guest"]
-    }, { option: '-p, --properties [properties]' });
+        option: '--type [type]',
+        autocomplete: _a.allowedTypes
+    }, {
+        option: '-p, --properties [properties]'
+    });
+}, _EntraUserListCommand_initValidators = function _EntraUserListCommand_initValidators() {
+    this.validators.push(async (args) => {
+        if (args.options.type && !_a.allowedTypes.some(t => t.toLowerCase() === args.options.type.toLowerCase())) {
+            return `'${args.options.type}' is not a valid value for option 'type'. Allowed values are: ${_a.allowedTypes.join(', ')}.`;
+        }
+        return true;
+    });
+}, _EntraUserListCommand_initTypes = function _EntraUserListCommand_initTypes() {
+    this.types.string.push('type', 'properties');
 };
+EntraUserListCommand.allowedTypes = ['Member', 'Guest'];
 export default new EntraUserListCommand();
 //# sourceMappingURL=user-list.js.map

package/dist/m365/entra/commands.js

@@ -40,6 +40,7 @@ export default {
     GROUP_REMOVE: `${prefix} group remove`,
     GROUP_USER_ADD: `${prefix} group user add`,
     GROUP_USER_LIST: `${prefix} group user list`,
+    GROUP_USER_SET: `${prefix} group user set`,
     GROUPSETTING_ADD: `${prefix} groupsetting add`,
     GROUPSETTING_GET: `${prefix} groupsetting get`,
     GROUPSETTING_LIST: `${prefix} groupsetting list`,
@@ -87,6 +88,7 @@ export default {
     USER_ADD: `${prefix} user add`,
     USER_GET: `${prefix} user get`,
     USER_GUEST_ADD: `${prefix} user guest add`,
+    USER_GROUPMEMBERSHIP_LIST: `${prefix} user groupmembership list`,
     USER_HIBP: `${prefix} user hibp`,
     USER_LICENSE_ADD: `${prefix} user license add`,
     USER_LICENSE_LIST: `${prefix} user license list`,

package/dist/m365/outlook/commands/message/message-move.js

@@ -6,11 +6,11 @@ var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (
 var _OutlookMessageMoveCommand_instances, _OutlookMessageMoveCommand_initTelemetry, _OutlookMessageMoveCommand_initOptions, _OutlookMessageMoveCommand_initOptionSets;
 import request from '../../../../request.js';
 import { formatting } from '../../../../utils/formatting.js';
-import GraphCommand from '../../../base/GraphCommand.js';
 import commands from '../../commands.js';
 import { Outlook } from '../../Outlook.js';
 import { cli } from '../../../../cli/cli.js';
-class OutlookMessageMoveCommand extends GraphCommand {
+import DelegatedGraphCommand from '../../../base/DelegatedGraphCommand.js';
+class OutlookMessageMoveCommand extends DelegatedGraphCommand {
     get name() {
         return commands.MESSAGE_MOVE;
     }

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

@@ -563,8 +563,8 @@ class SpfxDoctorCommand extends BaseProjectCommand {
             },
             '1.19.0': {
                 gulpCli: {
-                    range: '^1 || ^2',
-                    fix: 'npm i -g gulp-cli@2'
+                    range: '^1 || ^2 || ^3',
+                    fix: 'npm i -g gulp-cli@3'
                 },
                 node: {
                     range: '>=18.17.1 <19.0.0',

package/dist/m365/spo/commands/tenant/tenant-recyclebinitem-restore.js

@@ -3,13 +3,15 @@ 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 _SpoTenantRecycleBinItemRestoreCommand_instances, _SpoTenantRecycleBinItemRestoreCommand_initTelemetry, _SpoTenantRecycleBinItemRestoreCommand_initOptions, _SpoTenantRecycleBinItemRestoreCommand_initValidators;
+var _SpoTenantRecycleBinItemRestoreCommand_instances, _SpoTenantRecycleBinItemRestoreCommand_initTelemetry, _SpoTenantRecycleBinItemRestoreCommand_initOptions, _SpoTenantRecycleBinItemRestoreCommand_initValidators, _SpoTenantRecycleBinItemRestoreCommand_initTypes;
 import request from '../../../../request.js';
+import { formatting } from '../../../../utils/formatting.js';
+import { odata } from '../../../../utils/odata.js';
 import { spo } from '../../../../utils/spo.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 { setTimeout } from 'timers/promises';
 class SpoTenantRecycleBinItemRestoreCommand extends SpoCommand {
     get name() {
         return commands.TENANT_RECYCLEBINITEM_RESTORE;
@@ -23,48 +25,64 @@ class SpoTenantRecycleBinItemRestoreCommand extends SpoCommand {
         __classPrivateFieldGet(this, _SpoTenantRecycleBinItemRestoreCommand_instances, "m", _SpoTenantRecycleBinItemRestoreCommand_initTelemetry).call(this);
         __classPrivateFieldGet(this, _SpoTenantRecycleBinItemRestoreCommand_instances, "m", _SpoTenantRecycleBinItemRestoreCommand_initOptions).call(this);
         __classPrivateFieldGet(this, _SpoTenantRecycleBinItemRestoreCommand_instances, "m", _SpoTenantRecycleBinItemRestoreCommand_initValidators).call(this);
+        __classPrivateFieldGet(this, _SpoTenantRecycleBinItemRestoreCommand_instances, "m", _SpoTenantRecycleBinItemRestoreCommand_initTypes).call(this);
     }
     async commandAction(logger, args) {
+        if (args.options.wait) {
+            await this.warn(logger, `Option 'wait' is deprecated and will be removed in the next major release.`);
+        }
         try {
+            if (this.verbose) {
+                await logger.logToStderr(`Restoring site collection '${args.options.siteUrl}' from recycle bin.`);
+            }
+            const siteUrl = urlUtil.removeTrailingSlashes(args.options.siteUrl);
             const adminUrl = await spo.getSpoAdminUrl(logger, this.debug);
             const requestOptions = {
-                url: `${adminUrl}/_api/SPOInternalUseOnly.Tenant/RestoreDeletedSite`,
+                url: `${adminUrl}/_api/SPO.Tenant/RestoreDeletedSite`,
                 headers: {
                     accept: 'application/json;odata=nometadata',
                     'content-type': 'application/json;charset=utf-8'
                 },
-                data: {
-                    siteUrl: args.options.siteUrl
-                }
+                data: { siteUrl },
+                responseType: 'json'
             };
-            const response = await request.post(requestOptions);
-            let responseContent = JSON.parse(response);
-            if (args.options.wait && !responseContent.IsComplete) {
-                responseContent = await this.waitUntilTenantRestoreFinished(responseContent.PollingInterval, requestOptions, logger);
+            await request.post(requestOptions);
+            const groupId = await this.getSiteGroupId(adminUrl, siteUrl);
+            if (groupId && groupId !== '00000000-0000-0000-0000-000000000000') {
+                if (this.verbose) {
+                    await logger.logToStderr(`Restoring Microsoft 365 group with ID '${groupId}' from recycle bin.`);
+                }
+                const restoreOptions = {
+                    url: `https://graph.microsoft.com/v1.0/directory/deletedItems/${groupId}/restore`,
+                    headers: {
+                        accept: 'application/json;odata.metadata=none',
+                        'content-type': 'application/json'
+                    },
+                    responseType: 'json'
+                };
+                await request.post(restoreOptions);
             }
-            await logger.log(responseContent);
+            // Here, we return a fixed response because this new API endpoint doesn't return a response while the previous API did.
+            // This has to be removed in the next major release.
+            await logger.log({
+                HasTimedout: false,
+                IsComplete: !!args.options.wait,
+                PollingInterval: 15000
+            });
         }
         catch (err) {
             this.handleRejectedODataJsonPromise(err);
         }
     }
-    async waitUntilTenantRestoreFinished(pollingInterval, requestOptions, logger) {
-        if (this.verbose) {
-            await logger.logToStderr(`Site collection still restoring. Retrying in ${pollingInterval / 1000} seconds...`);
-        }
-        await setTimeout(pollingInterval);
-        const response = await request.post(requestOptions);
-        const responseContent = JSON.parse(response);
-        if (responseContent.IsComplete) {
-            return responseContent;
-        }
-        return await this.waitUntilTenantRestoreFinished(responseContent.PollingInterval, requestOptions, logger);
+    async getSiteGroupId(adminUrl, url) {
+        const sites = await odata.getAllItems(`${adminUrl}/_api/web/lists/GetByTitle('DO_NOT_DELETE_SPLIST_TENANTADMIN_AGGREGATED_SITECOLLECTIONS')/items?$filter=SiteUrl eq '${formatting.encodeQueryParameter(url)}'&$select=GroupId`);
+        return sites[0].GroupId;
     }
 }
 _SpoTenantRecycleBinItemRestoreCommand_instances = new WeakSet(), _SpoTenantRecycleBinItemRestoreCommand_initTelemetry = function _SpoTenantRecycleBinItemRestoreCommand_initTelemetry() {
     this.telemetry.push((args) => {
         Object.assign(this.telemetryProperties, {
-            wait: args.options.wait
+            wait: !!args.options.wait
         });
     });
 }, _SpoTenantRecycleBinItemRestoreCommand_initOptions = function _SpoTenantRecycleBinItemRestoreCommand_initOptions() {
@@ -75,6 +93,9 @@ _SpoTenantRecycleBinItemRestoreCommand_instances = new WeakSet(), _SpoTenantRecy
     });
 }, _SpoTenantRecycleBinItemRestoreCommand_initValidators = function _SpoTenantRecycleBinItemRestoreCommand_initValidators() {
     this.validators.push(async (args) => validation.isValidSharePointUrl(args.options.siteUrl));
+}, _SpoTenantRecycleBinItemRestoreCommand_initTypes = function _SpoTenantRecycleBinItemRestoreCommand_initTypes() {
+    this.types.string.push('siteUrl');
+    this.types.boolean.push('wait');
 };
 export default new SpoTenantRecycleBinItemRestoreCommand();
 //# sourceMappingURL=tenant-recyclebinitem-restore.js.map

package/dist/m365/teams/commands/chat/chat-message-send.js

@@ -8,12 +8,12 @@ import auth from '../../../../Auth.js';
 import request from '../../../../request.js';
 import { accessToken } from '../../../../utils/accessToken.js';
 import { validation } from '../../../../utils/validation.js';
-import GraphCommand from '../../../base/GraphCommand.js';
 import commands from '../../commands.js';
 import { chatUtil } from './chatUtil.js';
 import { cli } from '../../../../cli/cli.js';
 import { formatting } from '../../../../utils/formatting.js';
-class TeamsChatMessageSendCommand extends GraphCommand {
+import DelegatedGraphCommand from '../../../base/DelegatedGraphCommand.js';
+class TeamsChatMessageSendCommand extends DelegatedGraphCommand {
     get name() {
         return commands.CHAT_MESSAGE_SEND;
     }

package/dist/m365/todo/commands/list/list-add.js

@@ -5,9 +5,9 @@ var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (
 };
 var _TodoListAddCommand_instances, _TodoListAddCommand_initOptions;
 import request from '../../../../request.js';
-import GraphCommand from '../../../base/GraphCommand.js';
+import DelegatedGraphCommand from '../../../base/DelegatedGraphCommand.js';
 import commands from '../../commands.js';
-class TodoListAddCommand extends GraphCommand {
+class TodoListAddCommand extends DelegatedGraphCommand {
     get name() {
         return commands.LIST_ADD;
     }

package/dist/m365/todo/commands/list/list-get.js

@@ -6,9 +6,9 @@ var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (
 var _TodoListGetCommand_instances, _TodoListGetCommand_initTelemetry, _TodoListGetCommand_initOptions, _TodoListGetCommand_initOptionSets;
 import request from '../../../../request.js';
 import { formatting } from '../../../../utils/formatting.js';
-import GraphCommand from '../../../base/GraphCommand.js';
+import DelegatedGraphCommand from '../../../base/DelegatedGraphCommand.js';
 import commands from '../../commands.js';
-class TodoListGetCommand extends GraphCommand {
+class TodoListGetCommand extends DelegatedGraphCommand {
     get name() {
         return commands.LIST_GET;
     }

package/dist/m365/todo/commands/list/list-list.js

@@ -1,7 +1,7 @@
 import { odata } from '../../../../utils/odata.js';
-import GraphCommand from '../../../base/GraphCommand.js';
+import DelegatedGraphCommand from '../../../base/DelegatedGraphCommand.js';
 import commands from '../../commands.js';
-class TodoListListCommand extends GraphCommand {
+class TodoListListCommand extends DelegatedGraphCommand {
     get name() {
         return commands.LIST_LIST;
     }

package/dist/m365/todo/commands/list/list-remove.js

@@ -6,9 +6,9 @@ var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (
 var _TodoListRemoveCommand_instances, _TodoListRemoveCommand_initTelemetry, _TodoListRemoveCommand_initOptions, _TodoListRemoveCommand_initOptionSets;
 import { cli } from '../../../../cli/cli.js';
 import request from '../../../../request.js';
-import GraphCommand from '../../../base/GraphCommand.js';
+import DelegatedGraphCommand from '../../../base/DelegatedGraphCommand.js';
 import commands from '../../commands.js';
-class TodoListRemoveCommand extends GraphCommand {
+class TodoListRemoveCommand extends DelegatedGraphCommand {
     get name() {
         return commands.LIST_REMOVE;
     }

package/dist/m365/todo/commands/list/list-set.js

@@ -5,9 +5,9 @@ var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (
 };
 var _TodoListSetCommand_instances, _TodoListSetCommand_initTelemetry, _TodoListSetCommand_initOptions, _TodoListSetCommand_initOptionSets;
 import request from '../../../../request.js';
-import GraphCommand from '../../../base/GraphCommand.js';
+import DelegatedGraphCommand from '../../../base/DelegatedGraphCommand.js';
 import commands from '../../commands.js';
-class TodoListSetCommand extends GraphCommand {
+class TodoListSetCommand extends DelegatedGraphCommand {
     get name() {
         return commands.LIST_SET;
     }

package/dist/m365/todo/commands/task/task-add.js

@@ -6,9 +6,9 @@ var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (
 var _TodoTaskAddCommand_instances, _a, _TodoTaskAddCommand_initTelemetry, _TodoTaskAddCommand_initOptions, _TodoTaskAddCommand_initValidators, _TodoTaskAddCommand_initOptionSets;
 import request from '../../../../request.js';
 import { validation } from '../../../../utils/validation.js';
-import GraphCommand from '../../../base/GraphCommand.js';
+import DelegatedGraphCommand from '../../../base/DelegatedGraphCommand.js';
 import commands from '../../commands.js';
-class TodoTaskAddCommand extends GraphCommand {
+class TodoTaskAddCommand extends DelegatedGraphCommand {
     get name() {
         return commands.TASK_ADD;
     }

package/dist/m365/todo/commands/task/task-get.js

@@ -6,9 +6,9 @@ var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (
 var _TodoTaskGetCommand_instances, _TodoTaskGetCommand_initTelemetry, _TodoTaskGetCommand_initOptions, _TodoTaskGetCommand_initOptionSets;
 import { cli } from '../../../../cli/cli.js';
 import request from '../../../../request.js';
-import GraphCommand from '../../../base/GraphCommand.js';
+import DelegatedGraphCommand from '../../../base/DelegatedGraphCommand.js';
 import commands from '../../commands.js';
-class TodoTaskGetCommand extends GraphCommand {
+class TodoTaskGetCommand extends DelegatedGraphCommand {
     get name() {
         return commands.TASK_GET;
     }

package/dist/m365/todo/commands/task/task-list.js

@@ -7,9 +7,9 @@ var _TodoTaskListCommand_instances, _TodoTaskListCommand_initTelemetry, _TodoTas
 import { cli } from '../../../../cli/cli.js';
 import request from '../../../../request.js';
 import { odata } from '../../../../utils/odata.js';
-import GraphCommand from '../../../base/GraphCommand.js';
+import DelegatedGraphCommand from '../../../base/DelegatedGraphCommand.js';
 import commands from '../../commands.js';
-class TodoTaskListCommand extends GraphCommand {
+class TodoTaskListCommand extends DelegatedGraphCommand {
     get name() {
         return commands.TASK_LIST;
     }

package/dist/m365/todo/commands/task/task-remove.js

@@ -6,9 +6,9 @@ var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (
 var _TodoTaskRemoveCommand_instances, _TodoTaskRemoveCommand_initTelemetry, _TodoTaskRemoveCommand_initOptions, _TodoTaskRemoveCommand_initOptionSets;
 import { cli } from '../../../../cli/cli.js';
 import request from '../../../../request.js';
-import GraphCommand from '../../../base/GraphCommand.js';
+import DelegatedGraphCommand from '../../../base/DelegatedGraphCommand.js';
 import commands from '../../commands.js';
-class TodoTaskRemoveCommand extends GraphCommand {
+class TodoTaskRemoveCommand extends DelegatedGraphCommand {
     get name() {
         return commands.TASK_REMOVE;
     }

package/dist/m365/todo/commands/task/task-set.js

@@ -7,9 +7,9 @@ var _TodoTaskSetCommand_instances, _TodoTaskSetCommand_initTelemetry, _TodoTaskS
 import request from '../../../../request.js';
 import { formatting } from '../../../../utils/formatting.js';
 import { validation } from '../../../../utils/validation.js';
-import GraphCommand from '../../../base/GraphCommand.js';
+import DelegatedGraphCommand from '../../../base/DelegatedGraphCommand.js';
 import commands from '../../commands.js';
-class TodoTaskSetCommand extends GraphCommand {
+class TodoTaskSetCommand extends DelegatedGraphCommand {
     get name() {
         return commands.TASK_SET;
     }

package/dist/m365/viva/commands/engage/engage-community-get.js

@@ -0,0 +1,49 @@
+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 _VivaEngageCommunityGetCommand_instances, _VivaEngageCommunityGetCommand_initOptions, _VivaEngageCommunityGetCommand_initTypes;
+import GraphCommand from '../../../base/GraphCommand.js';
+import commands from '../../commands.js';
+import request from '../../../../request.js';
+class VivaEngageCommunityGetCommand extends GraphCommand {
+    get name() {
+        return commands.ENGAGE_COMMUNITY_GET;
+    }
+    get description() {
+        return 'Gets information of a Viva Engage community';
+    }
+    constructor() {
+        super();
+        _VivaEngageCommunityGetCommand_instances.add(this);
+        __classPrivateFieldGet(this, _VivaEngageCommunityGetCommand_instances, "m", _VivaEngageCommunityGetCommand_initOptions).call(this);
+        __classPrivateFieldGet(this, _VivaEngageCommunityGetCommand_instances, "m", _VivaEngageCommunityGetCommand_initTypes).call(this);
+    }
+    async commandAction(logger, args) {
+        if (this.verbose) {
+            logger.logToStderr(`Getting the information of Viva Engage community with id '${args.options.id}'...`);
+        }
+        const requestOptions = {
+            url: `${this.resource}/beta/employeeExperience/communities/${args.options.id}`,
+            headers: {
+                accept: 'application/json;odata.metadata=none'
+            },
+            responseType: 'json'
+        };
+        try {
+            const res = await request.get(requestOptions);
+            await logger.log(res);
+        }
+        catch (err) {
+            this.handleRejectedODataJsonPromise(err);
+        }
+    }
+}
+_VivaEngageCommunityGetCommand_instances = new WeakSet(), _VivaEngageCommunityGetCommand_initOptions = function _VivaEngageCommunityGetCommand_initOptions() {
+    this.options.unshift({ option: '-i, --id <id>' });
+}, _VivaEngageCommunityGetCommand_initTypes = function _VivaEngageCommunityGetCommand_initTypes() {
+    this.types.string.push('id');
+};
+export default new VivaEngageCommunityGetCommand();
+//# sourceMappingURL=engage-community-get.js.map

package/dist/m365/viva/commands.js

@@ -1,6 +1,7 @@
 const prefix = 'viva';
 export default {
     CONNECTIONS_APP_CREATE: `${prefix} connections app create`,
+    ENGAGE_COMMUNITY_GET: `${prefix} engage community get`,
     ENGAGE_GROUP_LIST: `${prefix} engage group list`,
     ENGAGE_GROUP_USER_ADD: `${prefix} engage group user add`,
     ENGAGE_GROUP_USER_REMOVE: `${prefix} engage group user remove`,

package/dist/utils/accessToken.js

@@ -1,3 +1,5 @@
+import auth from "../Auth.js";
+import { CommandError } from "../Command.js";
 export const accessToken = {
     isAppOnlyAccessToken(accessToken) {
         let isAppOnlyAccessToken;
@@ -72,6 +74,20 @@ export const accessToken = {
         catch {
         }
         return userId;
+    },
+    /**
+     * Asserts the presence of a delegated access token.
+     * @throws {CommandError} Will throw an error if the access token is not available.
+     * @throws {CommandError} Will throw an error if the access token is an application-only access token.
+     */
+    assertDelegatedAccessToken() {
+        const accessToken = auth?.connection?.accessTokens?.[auth.defaultResource]?.accessToken;
+        if (!accessToken) {
+            throw new CommandError('No access token found.');
+        }
+        if (this.isAppOnlyAccessToken(accessToken)) {
+            throw new CommandError('This command does not support application-only permissions.');
+        }
     }
 };
 //# sourceMappingURL=accessToken.js.map

package/dist/utils/validation.js

@@ -305,11 +305,11 @@ export const validation = {
         return true;
     },
     isValidSharePointUrl(url) {
-        if (!url) {
-            return false;
+        if (typeof url !== 'string') {
+            return 'SharePoint Online site URL must be a string.';
         }
         if (url.indexOf('https://') !== 0) {
-            return `${url} is not a valid SharePoint Online site URL`;
+            return `'${url}' is not a valid SharePoint Online site URL.`;
         }
         else {
             return true;

package/docs/docs/cmd/entra/group/group-user-set.mdx

@@ -0,0 +1,62 @@
+import Global from '/docs/cmd/_global.mdx';
+
+# entra group user set
+
+Updates role of users in a Microsoft Entra ID group
+
+## Usage
+
+```sh
+m365 entra group user set [options]
+```
+
+## Options
+
+```md definition-list
+`-i, --groupId [groupId]`
+: The ID of the Entra ID group. Specify `groupId` or `groupDisplayName` but not both.
+
+`-n, --groupDisplayName [groupDisplayName]`
+: The display name of the Entra ID group. Specify `groupId` or `groupDisplayName` but not both.
+
+`--ids [ids]`
+: Comma-separated list of user IDs. Specify either `ids` or `userNames` but not both.
+
+`--userNames [userNames]`
+: The user principal names of users. You can also pass a comma-separated list of UPNs. Specify either `ids` or `userNames` but not both.
+
+`-r, --role <role>`
+: The new role to be assigned to the users. Valid values: `Owner`, `Member`.
+```
+
+<Global />
+
+## Examples
+
+Update a single user specified by ID to a member of a group specified by display name
+
+```sh
+m365 entra group user set --groupDisplayName Developers --ids 098b9f52-f48c-4401-819f-29c33794c3f5 --role Member
+```
+
+Update multiple users specified by ID to members of a group specified by ID
+
+```sh
+m365 entra group user set --groupId a03c0c35-ef9a-419b-8cab-f89e0a8d2d2a --ids "098b9f52-f48c-4401-819f-29c33794c3f5,f1e06e31-3abf-4746-83c2-1513d71f38b8" --role Member
+```
+
+Update a single user specified by UPN to an owner of a group specified by display name
+
+```sh
+m365 entra group user set --groupDisplayName Developers --userNames john.doe@contoso.com --role Owner
+```
+
+Update multiple users specified by UPN to owners of a group specified by ID
+
+```sh
+m365 entra group user set --groupId a03c0c35-ef9a-419b-8cab-f89e0a8d2d2a --userNames "john.doe@contoso.com,adele.vance@contoso.com" --role Owner
+```
+
+## Response
+
+The command won't return a response on success.