@pnp/cli-microsoft365 11.9.0-beta.8c1ee05 → 11.9.0-beta.9bd71dd

package/dist/m365/spe/commands/container/container-get.js

@@ -1,12 +1,16 @@
-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 _SpeContainerGetCommand_instances, _SpeContainerGetCommand_initOptions, _SpeContainerGetCommand_initTypes;
+import { z } from 'zod';
+import { globalOptionsZod } from '../../../../Command.js';
 import GraphCommand from '../../../base/GraphCommand.js';
 import commands from '../../commands.js';
 import request from '../../../../request.js';
+import { spe } from '../../../../utils/spe.js';
+export const options = z.strictObject({
+    ...globalOptionsZod.shape,
+    id: z.string().alias('i').optional(),
+    name: z.string().alias('n').optional(),
+    containerTypeId: z.uuid().optional(),
+    containerTypeName: z.string().optional()
+});
 class SpeContainerGetCommand extends GraphCommand {
     get name() {
         return commands.CONTAINER_GET;
@@ -14,24 +18,34 @@ class SpeContainerGetCommand extends GraphCommand {
     get description() {
         return 'Gets a container of a specific container type';
     }
-    constructor() {
-        super();
-        _SpeContainerGetCommand_instances.add(this);
-        __classPrivateFieldGet(this, _SpeContainerGetCommand_instances, "m", _SpeContainerGetCommand_initOptions).call(this);
-        __classPrivateFieldGet(this, _SpeContainerGetCommand_instances, "m", _SpeContainerGetCommand_initTypes).call(this);
+    get schema() {
+        return options;
+    }
+    getRefinedSchema(schema) {
+        return schema
+            .refine((opts) => [opts.id, opts.name].filter(value => value !== undefined).length === 1, {
+            message: 'Specify either id or name, but not both.'
+        })
+            .refine((options) => !options.name || [options.containerTypeId, options.containerTypeName].filter(o => o !== undefined).length === 1, {
+            error: 'Use one of the following options when specifying the container name: containerTypeId or containerTypeName.'
+        })
+            .refine((options) => options.name || [options.containerTypeId, options.containerTypeName].filter(o => o !== undefined).length === 0, {
+            error: 'Options containerTypeId and containerTypeName are only required when retrieving a container by name.'
+        });
     }
     async commandAction(logger, args) {
-        if (this.verbose) {
-            await logger.logToStderr(`Getting a container with id '${args.options.id}'...`);
-        }
-        const requestOptions = {
-            url: `${this.resource}/v1.0/storage/fileStorage/containers/${args.options.id}`,
-            headers: {
-                accept: 'application/json;odata.metadata=none'
-            },
-            responseType: 'json'
-        };
         try {
+            const containerId = await this.resolveContainerId(args.options, logger);
+            if (this.verbose) {
+                await logger.logToStderr(`Getting a container with id '${containerId}'...`);
+            }
+            const requestOptions = {
+                url: `${this.resource}/v1.0/storage/fileStorage/containers/${containerId}`,
+                headers: {
+                    accept: 'application/json;odata.metadata=none'
+                },
+                responseType: 'json'
+            };
             const res = await request.get(requestOptions);
             await logger.log(res);
         }
@@ -39,11 +53,25 @@ class SpeContainerGetCommand extends GraphCommand {
             this.handleRejectedODataJsonPromise(err);
         }
     }
+    async resolveContainerId(options, logger) {
+        if (options.id) {
+            return options.id;
+        }
+        if (this.verbose) {
+            await logger.logToStderr(`Resolving container id from name '${options.name}'...`);
+        }
+        const containerTypeId = await this.getContainerTypeId(options, logger);
+        return spe.getContainerIdByName(containerTypeId, options.name);
+    }
+    async getContainerTypeId(options, logger) {
+        if (options.containerTypeId) {
+            return options.containerTypeId;
+        }
+        if (this.verbose) {
+            await logger.logToStderr(`Getting container type with name '${options.containerTypeName}'...`);
+        }
+        return spe.getContainerTypeIdByName(options.containerTypeName);
+    }
 }
-_SpeContainerGetCommand_instances = new WeakSet(), _SpeContainerGetCommand_initOptions = function _SpeContainerGetCommand_initOptions() {
-    this.options.unshift({ option: '-i, --id <id>' });
-}, _SpeContainerGetCommand_initTypes = function _SpeContainerGetCommand_initTypes() {
-    this.types.string.push('id');
-};
 export default new SpeContainerGetCommand();
 //# sourceMappingURL=container-get.js.map

package/dist/m365/spe/commands/container/container-permission-list.js

@@ -1,13 +1,17 @@
 import { cli } from '../../../../cli/cli.js';
 import { z } from 'zod';
-import { globalOptionsZod } from '../../../../Command.js';
+import { CommandError, globalOptionsZod } from '../../../../Command.js';
 import commands from '../../commands.js';
 import GraphCommand from '../../../base/GraphCommand.js';
 import { odata } from '../../../../utils/odata.js';
 import { formatting } from '../../../../utils/formatting.js';
+import { spe } from '../../../../utils/spe.js';
 export const options = z.strictObject({
     ...globalOptionsZod.shape,
-    containerId: z.string().alias('i')
+    containerId: z.string().alias('i').optional(),
+    containerName: z.string().alias('n').optional(),
+    containerTypeId: z.uuid().optional(),
+    containerTypeName: z.string().optional()
 });
 class SpeContainerPermissionListCommand extends GraphCommand {
     get name() {
@@ -22,12 +26,25 @@ class SpeContainerPermissionListCommand extends GraphCommand {
     get schema() {
         return options;
     }
+    getRefinedSchema(schema) {
+        return schema
+            .refine((opts) => [opts.containerId, opts.containerName].filter(value => value !== undefined).length === 1, {
+            message: 'Specify either id or name, but not both.'
+        })
+            .refine((options) => !options.containerName || [options.containerTypeId, options.containerTypeName].filter(o => o !== undefined).length === 1, {
+            error: 'Use one of the following options when specifying the container name: containerTypeId or containerTypeName.'
+        })
+            .refine((options) => options.containerName || [options.containerTypeId, options.containerTypeName].filter(o => o !== undefined).length === 0, {
+            error: 'Options containerTypeId and containerTypeName are only required when retrieving a container by name.'
+        });
+    }
     async commandAction(logger, args) {
         try {
+            const containerId = await this.resolveContainerId(args.options, logger);
             if (this.verbose) {
-                await logger.logToStderr(`Retrieving permissions of a SharePoint Embedded Container with id '${args.options.containerId}'...`);
+                await logger.logToStderr(`Retrieving permissions of a SharePoint Embedded Container with id '${containerId}'...`);
             }
-            const containerPermission = await odata.getAllItems(`${this.resource}/v1.0/storage/fileStorage/containers/${formatting.encodeQueryParameter(args.options.containerId)}/permissions`);
+            const containerPermission = await odata.getAllItems(`${this.resource}/v1.0/storage/fileStorage/containers/${formatting.encodeQueryParameter(containerId)}/permissions`);
             if (!cli.shouldTrimOutput(args.options.output)) {
                 await logger.log(containerPermission);
             }
@@ -42,9 +59,31 @@ class SpeContainerPermissionListCommand extends GraphCommand {
             }
         }
         catch (err) {
+            if (err instanceof CommandError) {
+                throw err;
+            }
             this.handleRejectedODataJsonPromise(err);
         }
     }
+    async resolveContainerId(options, logger) {
+        if (options.containerId) {
+            return options.containerId;
+        }
+        if (this.verbose) {
+            await logger.logToStderr(`Resolving container id from name '${options.containerName}'...`);
+        }
+        const containerTypeId = await this.getContainerTypeId(options, logger);
+        return spe.getContainerIdByName(containerTypeId, options.containerName);
+    }
+    async getContainerTypeId(options, logger) {
+        if (options.containerTypeId) {
+            return options.containerTypeId;
+        }
+        if (this.verbose) {
+            await logger.logToStderr(`Getting container type with name '${options.containerTypeName}'...`);
+        }
+        return spe.getContainerTypeIdByName(options.containerTypeName);
+    }
 }
 export default new SpeContainerPermissionListCommand();
 //# sourceMappingURL=container-permission-list.js.map

package/dist/m365/spe/commands/container/container-set.js

@@ -0,0 +1,77 @@
+import { z } from 'zod';
+import { globalOptionsZod } from '../../../../Command.js';
+import GraphCommand from '../../../base/GraphCommand.js';
+import commands from '../../commands.js';
+import request from '../../../../request.js';
+import { validation } from '../../../../utils/validation.js';
+export const options = z.strictObject({
+    ...globalOptionsZod.shape,
+    id: z.string().alias('i'),
+    newName: z.string().optional(),
+    description: z.string().optional(),
+    isOcrEnabled: z.boolean().optional(),
+    isItemVersioningEnabled: z.boolean().optional(),
+    itemMajorVersionLimit: z.number()
+        .refine(numb => validation.isValidPositiveInteger(numb), {
+        error: e => `'${e.input}' is not a valid positive integer.`
+    }).optional()
+});
+class SpeContainerSetCommand extends GraphCommand {
+    get name() {
+        return commands.CONTAINER_SET;
+    }
+    get description() {
+        return 'Updates a SharePoint Embedded container';
+    }
+    get schema() {
+        return options;
+    }
+    getRefinedSchema(schema) {
+        return schema
+            .refine(o => o.newName !== undefined || o.description !== undefined || o.isOcrEnabled !== undefined || o.isItemVersioningEnabled !== undefined || o.itemMajorVersionLimit !== undefined, {
+            error: 'Specify at least one of newName, description, isOcrEnabled, isItemVersioningEnabled, or itemMajorVersionLimit.'
+        });
+    }
+    async commandAction(logger, args) {
+        if (this.verbose) {
+            await logger.logToStderr(`Updating container '${args.options.id}'...`);
+        }
+        try {
+            const data = {};
+            if (args.options.newName !== undefined) {
+                data.displayName = args.options.newName;
+            }
+            if (args.options.description !== undefined) {
+                data.description = args.options.description;
+            }
+            const settings = {};
+            if (args.options.isOcrEnabled !== undefined) {
+                settings.isOcrEnabled = args.options.isOcrEnabled;
+            }
+            if (args.options.isItemVersioningEnabled !== undefined) {
+                settings.isItemVersioningEnabled = args.options.isItemVersioningEnabled;
+            }
+            if (args.options.itemMajorVersionLimit !== undefined) {
+                settings.itemMajorVersionLimit = args.options.itemMajorVersionLimit;
+            }
+            if (Object.keys(settings).length > 0) {
+                data.settings = settings;
+            }
+            const requestOptions = {
+                url: `${this.resource}/v1.0/storage/fileStorage/containers/${args.options.id}`,
+                headers: {
+                    accept: 'application/json;odata.metadata=none'
+                },
+                responseType: 'json',
+                data
+            };
+            const container = await request.patch(requestOptions);
+            await logger.log(container);
+        }
+        catch (err) {
+            this.handleRejectedODataJsonPromise(err);
+        }
+    }
+}
+export default new SpeContainerSetCommand();
+//# sourceMappingURL=container-set.js.map

package/dist/m365/spe/commands.js

@@ -5,6 +5,7 @@ export default {
     CONTAINER_GET: `${prefix} container get`,
     CONTAINER_LIST: `${prefix} container list`,
     CONTAINER_REMOVE: `${prefix} container remove`,
+    CONTAINER_SET: `${prefix} container set`,
     CONTAINER_PERMISSION_LIST: `${prefix} container permission list`,
     CONTAINER_RECYCLEBINITEM_LIST: `${prefix} container recyclebinitem list`,
     CONTAINER_RECYCLEBINITEM_REMOVE: `${prefix} container recyclebinitem remove`,

package/dist/m365/spo/commands/file/file-unarchive.js

@@ -0,0 +1,83 @@
+import commands from '../../commands.js';
+import SpoCommand from '../../../base/SpoCommand.js';
+import { globalOptionsZod } from '../../../../Command.js';
+import { z } from 'zod';
+import { validation } from '../../../../utils/validation.js';
+import { cli } from '../../../../cli/cli.js';
+import { urlUtil } from '../../../../utils/urlUtil.js';
+import request from '../../../../request.js';
+import { formatting } from '../../../../utils/formatting.js';
+export const options = z.strictObject({
+    ...globalOptionsZod.shape,
+    webUrl: z.string()
+        .refine(url => validation.isValidSharePointUrl(url) === true, {
+        error: e => `'${e.input}' is not a valid SharePoint Online site URL.`
+    })
+        .alias('u'),
+    url: z.string().optional(),
+    id: z.uuid().optional().alias('i'),
+    force: z.boolean().optional().alias('f')
+});
+class SpoFileUnarchiveCommand extends SpoCommand {
+    get name() {
+        return commands.FILE_UNARCHIVE;
+    }
+    get description() {
+        return 'Unarchives a file';
+    }
+    get schema() {
+        return options;
+    }
+    getRefinedSchema(schema) {
+        return schema
+            .refine(options => [options.url, options.id].filter(o => o !== undefined).length === 1, {
+            error: `Specify 'url' or 'id', but not both.`
+        });
+    }
+    getExcludedOptionsWithUrls() {
+        return ['url'];
+    }
+    async commandAction(logger, args) {
+        const { webUrl, url, id, force, verbose } = args.options;
+        if (!force) {
+            const result = await cli.promptForConfirmation({ message: `Reactivation could take up to 24 hours. Files that are reactivated cannot be archived again for 30 days. Are you sure you would like to unarchive this item?` });
+            if (!result) {
+                return;
+            }
+        }
+        try {
+            if (verbose) {
+                await logger.logToStderr(`Unarchiving file '${url || id}' at site '${webUrl}'...`);
+            }
+            let requestUrl = `${webUrl}/_api/web`;
+            if (id) {
+                requestUrl += `/GetFileById('${formatting.encodeQueryParameter(id)}')`;
+            }
+            else if (url) {
+                const serverRelativePath = urlUtil.getServerRelativePath(webUrl, url);
+                requestUrl += `/GetFileByServerRelativePath(DecodedUrl='${formatting.encodeQueryParameter(serverRelativePath)}')`;
+            }
+            requestUrl += '?$select=ListId,ListItemAllFields/Id&$expand=ListItemAllFields';
+            const fileInfo = await request.get({
+                url: requestUrl,
+                headers: {
+                    accept: 'application/json;odata=nometadata'
+                },
+                responseType: 'json'
+            });
+            const requestOptions = {
+                url: `${webUrl}/_api/Lists(guid'${fileInfo.ListId}')/items(${fileInfo.ListItemAllFields.Id})/UnArchive`,
+                headers: {
+                    accept: 'application/json;odata=nometadata'
+                },
+                responseType: 'json'
+            };
+            await request.post(requestOptions);
+        }
+        catch (err) {
+            this.handleRejectedODataJsonPromise(err);
+        }
+    }
+}
+export default new SpoFileUnarchiveCommand();
+//# sourceMappingURL=file-unarchive.js.map

package/dist/m365/spo/commands/folder/folder-archive.js

@@ -0,0 +1,89 @@
+import commands from '../../commands.js';
+import SpoCommand from '../../../base/SpoCommand.js';
+import { globalOptionsZod } from '../../../../Command.js';
+import { z } from 'zod';
+import { validation } from '../../../../utils/validation.js';
+import { cli } from '../../../../cli/cli.js';
+import { urlUtil } from '../../../../utils/urlUtil.js';
+import request from '../../../../request.js';
+import { formatting } from '../../../../utils/formatting.js';
+export const options = z.strictObject({
+    ...globalOptionsZod.shape,
+    webUrl: z.string()
+        .refine(url => validation.isValidSharePointUrl(url) === true, {
+        error: e => `'${e.input}' is not a valid SharePoint Online site URL.`
+    })
+        .alias('u'),
+    url: z.string().optional(),
+    id: z.uuid().optional().alias('i'),
+    force: z.boolean().optional().alias('f')
+});
+class SpoFolderArchiveCommand extends SpoCommand {
+    get name() {
+        return commands.FOLDER_ARCHIVE;
+    }
+    get description() {
+        return 'Archives a folder';
+    }
+    get schema() {
+        return options;
+    }
+    getRefinedSchema(schema) {
+        return schema
+            .refine(options => [options.url, options.id].filter(o => o !== undefined).length === 1, {
+            error: `Specify 'url' or 'id', but not both.`
+        });
+    }
+    getExcludedOptionsWithUrls() {
+        return ['url'];
+    }
+    async commandAction(logger, args) {
+        const { webUrl, url, id, force } = args.options;
+        if (!force) {
+            const result = await cli.promptForConfirmation({ message: `Are you sure you would like to archive this item? You will be able to reactivate it instantly for the first 7 days. After that, it will take up to 24 hours to reactivate.` });
+            if (!result) {
+                return;
+            }
+        }
+        try {
+            if (this.verbose) {
+                await logger.logToStderr(`Archiving folder ${url || id} at site ${webUrl}...`);
+            }
+            let requestUrl = `${webUrl}/_api/web`;
+            if (id) {
+                requestUrl += `/GetFolderById('${formatting.encodeQueryParameter(id)}')`;
+            }
+            else if (url) {
+                const serverRelativePath = urlUtil.getServerRelativePath(webUrl, url);
+                requestUrl += `/GetFolderByServerRelativePath(DecodedUrl='${formatting.encodeQueryParameter(serverRelativePath)}')`;
+            }
+            requestUrl += '?$select=Exists,ListItemAllFields/Id,ListItemAllFields/ParentList/Id&$expand=ListItemAllFields,ListItemAllFields/ParentList';
+            const folderInfo = await request.get({
+                url: requestUrl,
+                headers: {
+                    accept: 'application/json;odata=nometadata'
+                },
+                responseType: 'json'
+            });
+            if (!folderInfo.Exists) {
+                throw `The folder '${url || id}' does not exist.`;
+            }
+            if (!folderInfo.ListItemAllFields?.ParentList) {
+                throw `The folder '${url || id}' is the root folder of a document library and cannot be archived. Archive a subfolder instead.`;
+            }
+            const requestOptions = {
+                url: `${webUrl}/_api/Lists(guid'${folderInfo.ListItemAllFields.ParentList.Id}')/items(${folderInfo.ListItemAllFields.Id})/Archive`,
+                headers: {
+                    accept: 'application/json;odata=nometadata'
+                },
+                responseType: 'json'
+            };
+            await request.post(requestOptions);
+        }
+        catch (err) {
+            this.handleRejectedODataJsonPromise(err);
+        }
+    }
+}
+export default new SpoFolderArchiveCommand();
+//# sourceMappingURL=folder-archive.js.map

package/dist/m365/spo/commands/list/list-sensitivitylabel-remove.js

@@ -0,0 +1,83 @@
+import { z } from 'zod';
+import { globalOptionsZod } from '../../../../Command.js';
+import request from '../../../../request.js';
+import { formatting } from '../../../../utils/formatting.js';
+import { urlUtil } from '../../../../utils/urlUtil.js';
+import { validation } from '../../../../utils/validation.js';
+import SpoCommand from '../../../base/SpoCommand.js';
+import commands from '../../commands.js';
+import { cli } from '../../../../cli/cli.js';
+export const options = z.strictObject({
+    ...globalOptionsZod.shape,
+    webUrl: z.string()
+        .refine(url => validation.isValidSharePointUrl(url) === true, {
+        error: 'Specify a valid SharePoint site URL.'
+    })
+        .alias('u'),
+    listTitle: z.string().optional().alias('t'),
+    listId: z.uuid().optional().alias('l'),
+    listUrl: z.string().optional(),
+    force: z.boolean().optional().alias('f')
+});
+class SpoListSensitivityLabelRemoveCommand extends SpoCommand {
+    get name() {
+        return commands.LIST_SENSITIVITYLABEL_REMOVE;
+    }
+    get description() {
+        return 'Clears a default sensitivity label from a document library';
+    }
+    get schema() {
+        return options;
+    }
+    getRefinedSchema(schema) {
+        return schema
+            .refine(options => [options.listId, options.listTitle, options.listUrl].filter(o => o !== undefined).length === 1, {
+            error: 'Use one of the following options: listId, listTitle, or listUrl.'
+        });
+    }
+    async commandAction(logger, args) {
+        const removeSensitivityLabel = async () => {
+            try {
+                if (this.verbose) {
+                    await logger.logToStderr(`Removing the sensitivity label from list '${args.options.listId || args.options.listTitle || args.options.listUrl}' in site at ${args.options.webUrl}...`);
+                }
+                let requestUrl = `${args.options.webUrl}/_api/web`;
+                if (args.options.listId) {
+                    requestUrl += `/lists(guid'${formatting.encodeQueryParameter(args.options.listId)}')`;
+                }
+                else if (args.options.listTitle) {
+                    requestUrl += `/lists/getByTitle('${formatting.encodeQueryParameter(args.options.listTitle)}')`;
+                }
+                else if (args.options.listUrl) {
+                    const listServerRelativeUrl = urlUtil.getServerRelativePath(args.options.webUrl, args.options.listUrl);
+                    requestUrl += `/GetList('${formatting.encodeQueryParameter(listServerRelativeUrl)}')`;
+                }
+                const requestOptions = {
+                    url: requestUrl,
+                    headers: {
+                        accept: 'application/json;odata=nometadata',
+                        'content-type': 'application/json;odata=nometadata',
+                        'if-match': '*'
+                    },
+                    data: { 'DefaultSensitivityLabelForLibrary': '' },
+                    responseType: 'json'
+                };
+                await request.patch(requestOptions);
+            }
+            catch (err) {
+                this.handleRejectedODataJsonPromise(err);
+            }
+        };
+        if (args.options.force) {
+            await removeSensitivityLabel();
+        }
+        else {
+            const result = await cli.promptForConfirmation({ message: `Are you sure you want to remove the sensitivity label from list '${args.options.listId || args.options.listTitle || args.options.listUrl}'?` });
+            if (result) {
+                await removeSensitivityLabel();
+            }
+        }
+    }
+}
+export default new SpoListSensitivityLabelRemoveCommand();
+//# sourceMappingURL=list-sensitivitylabel-remove.js.map

package/dist/m365/spo/commands.js

@@ -85,6 +85,7 @@ export default {
     FILE_SHARINGLINK_LIST: `${prefix} file sharinglink list`,
     FILE_SHARINGLINK_REMOVE: `${prefix} file sharinglink remove`,
     FILE_SHARINGLINK_SET: `${prefix} file sharinglink set`,
+    FILE_UNARCHIVE: `${prefix} file unarchive`,
     FILE_VERSION_CLEAR: `${prefix} file version clear`,
     FILE_VERSION_GET: `${prefix} file version get`,
     FILE_VERSION_KEEP: `${prefix} file version keep`,
@@ -92,6 +93,7 @@ export default {
     FILE_VERSION_REMOVE: `${prefix} file version remove`,
     FILE_VERSION_RESTORE: `${prefix} file version restore`,
     FOLDER_ADD: `${prefix} folder add`,
+    FOLDER_ARCHIVE: `${prefix} folder archive`,
     FOLDER_COPY: `${prefix} folder copy`,
     FOLDER_GET: `${prefix} folder get`,
     FOLDER_LIST: `${prefix} folder list`,
@@ -160,6 +162,7 @@ export default {
     LIST_ROLEINHERITANCE_BREAK: `${prefix} list roleinheritance break`,
     LIST_ROLEINHERITANCE_RESET: `${prefix} list roleinheritance reset`,
     LIST_SENSITIVITYLABEL_ENSURE: `${prefix} list sensitivitylabel ensure`,
+    LIST_SENSITIVITYLABEL_REMOVE: `${prefix} list sensitivitylabel remove`,
     LIST_SET: `${prefix} list set`,
     LIST_SITESCRIPT_GET: `${prefix} list sitescript get`,
     LIST_VIEW_ADD: `${prefix} list view add`,

package/dist/m365/viva/commands/engage/engage-role-member-add.js

@@ -0,0 +1,79 @@
+import { z } from 'zod';
+import { globalOptionsZod } from '../../../../Command.js';
+import GraphCommand from '../../../base/GraphCommand.js';
+import commands from '../../commands.js';
+import { vivaEngage } from '../../../../utils/vivaEngage.js';
+import { entraUser } from '../../../../utils/entraUser.js';
+import request from '../../../../request.js';
+import { validation } from '../../../../utils/validation.js';
+export const options = z.strictObject({
+    ...globalOptionsZod.shape,
+    roleId: z.uuid().optional().refine(id => validation.isValidGuid(id), {
+        error: e => `'${e.input}' is not a valid GUID.`
+    }),
+    roleName: z.string().optional(),
+    userId: z.uuid().optional().refine(id => validation.isValidGuid(id), {
+        error: e => `'${e.input}' is not a valid GUID.`
+    }),
+    userName: z.string().refine(upn => validation.isValidUserPrincipalName(upn), {
+        error: e => `'${e.input}' is not a valid UPN.`
+    }).optional()
+});
+class VivaEngageRoleMemberAddCommand extends GraphCommand {
+    get name() {
+        return commands.ENGAGE_ROLE_MEMBER_ADD;
+    }
+    get description() {
+        return 'Assign a Viva Engage role to a user';
+    }
+    get schema() {
+        return options;
+    }
+    getRefinedSchema(schema) {
+        return schema
+            .refine(options => [options.roleId, options.roleName].filter(x => x !== undefined).length === 1, {
+            error: 'Specify either roleId, or roleName, but not both.'
+        })
+            .refine(options => [options.userId, options.userName].filter(x => x !== undefined).length === 1, {
+            error: 'Specify either userId, or userName, but not both.'
+        });
+    }
+    async commandAction(logger, args) {
+        try {
+            let roleId = args.options.roleId;
+            let userId = args.options.userId;
+            if (args.options.roleName) {
+                if (this.verbose) {
+                    await logger.logToStderr(`Retrieving Viva Engage role ID for role name '${args.options.roleName}'...`);
+                }
+                roleId = await vivaEngage.getRoleIdByName(args.options.roleName);
+            }
+            if (args.options.userName) {
+                if (this.verbose) {
+                    await logger.logToStderr(`Retrieving Viva Engage user ID for user name '${args.options.userName}'...`);
+                }
+                userId = await entraUser.getUserIdByUpn(args.options.userName);
+            }
+            if (this.verbose) {
+                await logger.logToStderr(`Assigning user ${userId} to a Viva Engage role ${roleId}...`);
+            }
+            const requestOptions = {
+                url: `${this.resource}/beta/employeeExperience/roles/${roleId}/members`,
+                headers: {
+                    'content-type': 'application/json;odata=nometadata',
+                    'accept': 'application/json;odata.metadata=none'
+                },
+                responseType: 'json',
+                data: {
+                    'user@odata.bind': `${this.resource}/beta/users('${userId}')`
+                }
+            };
+            await request.post(requestOptions);
+        }
+        catch (err) {
+            this.handleRejectedODataJsonPromise(err);
+        }
+    }
+}
+export default new VivaEngageRoleMemberAddCommand();
+//# sourceMappingURL=engage-role-member-add.js.map

package/dist/m365/viva/commands.js

@@ -25,6 +25,7 @@ export default {
     ENGAGE_REPORT_GROUPSACTIVITYDETAIL: `${prefix} engage report groupsactivitydetail`,
     ENGAGE_REPORT_GROUPSACTIVITYGROUPCOUNTS: `${prefix} engage report groupsactivitygroupcounts`,
     ENGAGE_ROLE_LIST: `${prefix} engage role list`,
+    ENGAGE_ROLE_MEMBER_ADD: `${prefix} engage role member add`,
     ENGAGE_ROLE_MEMBER_LIST: `${prefix} engage role member list`,
     ENGAGE_ROLE_MEMBER_REMOVE: `${prefix} engage role member remove`,
     ENGAGE_SEARCH: `${prefix} engage search`,

package/docs/docs/cmd/outlook/calendar/calendar-get.mdx

@@ -41,16 +41,16 @@ m365 outlook calendar get [options]
 <Tabs>
   <TabItem value="Delegated">
 
-  | Resource        | Permissions        |
-  |-----------------|--------------------|
-  | Microsoft Graph | Calendar.ReadBasic |
+  | Resource        | Permissions    |
+  |-----------------|----------------|
+  | Microsoft Graph | Calendars.Read |
 
   </TabItem>
   <TabItem value="Application">
 
-  | Resource        | Permissions        |
-  |-----------------|--------------------|
-  | Microsoft Graph | Calendar.ReadBasic |
+  | Resource        | Permissions    |
+  |-----------------|----------------|
+  | Microsoft Graph | Calendars.Read |
 
   </TabItem>
 </Tabs>
@@ -162,4 +162,4 @@ m365 outlook calendar get --userId b743445a-112c-4fda-9afd-05943f9c7b36 --calend
   ```
 
   </TabItem>
-</Tabs>
+</Tabs>