@pnp/cli-microsoft365 11.7.0-beta.b67a258 → 11.7.0-beta.bd906c5

package/dist/config.js

@@ -7,6 +7,7 @@ export default {
         'https://graph.microsoft.com/AuditLog.Read.All',
         'https://graph.microsoft.com/Bookings.Read.All',
         'https://graph.microsoft.com/Calendars.Read',
+        'https://graph.microsoft.com/Calendars.ReadWrite',
         'https://graph.microsoft.com/ChannelMember.ReadWrite.All',
         'https://graph.microsoft.com/ChannelMessage.Read.All',
         'https://graph.microsoft.com/ChannelMessage.ReadWrite',

package/dist/m365/entra/commands/user/user-license-add.js

@@ -5,6 +5,7 @@ var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (
 };
 var _EntraUserLicenseAddCommand_instances, _EntraUserLicenseAddCommand_initTelemetry, _EntraUserLicenseAddCommand_initOptions, _EntraUserLicenseAddCommand_initValidators, _EntraUserLicenseAddCommand_initOptionSets;
 import request from '../../../../request.js';
+import { formatting } from '../../../../utils/formatting.js';
 import { validation } from '../../../../utils/validation.js';
 import GraphCommand from '../../../base/GraphCommand.js';
 import commands from '../../commands.js';
@@ -27,7 +28,7 @@ class EntraUserLicenseAddCommand extends GraphCommand {
         const addLicenses = args.options.ids.split(',').map(x => { return { "disabledPlans": [], "skuId": x }; });
         const requestBody = { "addLicenses": addLicenses, "removeLicenses": [] };
         const requestOptions = {
-            url: `${this.resource}/v1.0/users/${args.options.userId || args.options.userName}/assignLicense`,
+            url: `${this.resource}/v1.0/users/${formatting.encodeQueryParameter(args.options.userId || args.options.userName)}/assignLicense`,
             headers: {
                 accept: 'application/json;odata.metadata=none'
             },

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

@@ -4,13 +4,12 @@ var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (
     return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
 };
 var _EntraUserLicenseListCommand_instances, _EntraUserLicenseListCommand_initTelemetry, _EntraUserLicenseListCommand_initOptions, _EntraUserLicenseListCommand_initValidators, _EntraUserLicenseListCommand_initOptionSets;
-import { accessToken } from '../../../../utils/accessToken.js';
 import { odata } from '../../../../utils/odata.js';
+import { formatting } from '../../../../utils/formatting.js';
 import { validation } from '../../../../utils/validation.js';
-import GraphCommand from '../../../base/GraphCommand.js';
 import commands from '../../commands.js';
-import auth from '../../../../Auth.js';
-class EntraUserLicenseListCommand extends GraphCommand {
+import GraphDelegatedCommand from '../../../base/GraphDelegatedCommand.js';
+class EntraUserLicenseListCommand extends GraphDelegatedCommand {
     get name() {
         return commands.USER_LICENSE_LIST;
     }
@@ -29,16 +28,12 @@ class EntraUserLicenseListCommand extends GraphCommand {
         __classPrivateFieldGet(this, _EntraUserLicenseListCommand_instances, "m", _EntraUserLicenseListCommand_initOptionSets).call(this);
     }
     async commandAction(logger, args) {
-        const isAppOnlyAccessToken = accessToken.isAppOnlyAccessToken(auth.connection.accessTokens[this.resource].accessToken);
-        if (isAppOnlyAccessToken && !args.options.userId && !args.options.userName) {
-            this.handleError(`Specify at least 'userId' or 'userName' when using application permissions.`);
-        }
         if (this.verbose) {
             await logger.logToStderr(`Retrieving licenses from user: ${args.options.userId || args.options.userName || 'current user'}.`);
         }
         let requestUrl = `${this.resource}/v1.0/`;
         if (args.options.userId || args.options.userName) {
-            requestUrl += `users/${args.options.userId || args.options.userName}`;
+            requestUrl += `users/${formatting.encodeQueryParameter(args.options.userId || args.options.userName)}`;
         }
         else {
             requestUrl += 'me';

package/dist/m365/entra/commands/user/user-license-remove.js

@@ -7,6 +7,7 @@ var _EntraUserLicenseRemoveCommand_instances, _EntraUserLicenseRemoveCommand_ini
 import commands from '../../commands.js';
 import request from '../../../../request.js';
 import { validation } from '../../../../utils/validation.js';
+import { formatting } from '../../../../utils/formatting.js';
 import { cli } from '../../../../cli/cli.js';
 import GraphCommand from '../../../base/GraphCommand.js';
 class EntraUserLicenseRemoveCommand extends GraphCommand {
@@ -42,7 +43,7 @@ class EntraUserLicenseRemoveCommand extends GraphCommand {
         const removeLicenses = args.options.ids.split(',');
         const requestBody = { "addLicenses": [], "removeLicenses": removeLicenses };
         const requestOptions = {
-            url: `${this.resource}/v1.0/users/${args.options.userId || args.options.userName}/assignLicense`,
+            url: `${this.resource}/v1.0/users/${formatting.encodeQueryParameter(args.options.userId || args.options.userName)}/assignLicense`,
             headers: {
                 accept: 'application/json;odata.metadata=none'
             },

package/dist/m365/outlook/commands/calendar/calendar-add.js

@@ -0,0 +1,85 @@
+import request from '../../../../request.js';
+import GraphCommand from '../../../base/GraphCommand.js';
+import commands from '../../commands.js';
+import { z } from 'zod';
+import { globalOptionsZod } from '../../../../Command.js';
+import { validation } from '../../../../utils/validation.js';
+import { calendarGroup } from '../../../../utils/calendarGroup.js';
+export const options = z.strictObject({
+    ...globalOptionsZod.shape,
+    userId: z.string()
+        .refine(userId => validation.isValidGuid(userId), {
+        error: e => `'${e.input}' is not a valid GUID.`
+    }).optional(),
+    userName: z.string()
+        .refine(userName => validation.isValidUserPrincipalName(userName), {
+        error: e => `'${e.input}' is not a valid UPN.`
+    }).optional(),
+    name: z.string(),
+    calendarGroupId: z.string().optional(),
+    calendarGroupName: z.string().optional(),
+    color: z.enum(['auto', 'lightBlue', 'lightGreen', 'lightOrange', 'lightGray', 'lightYellow', 'lightTeal', 'lightPink', 'lightBrown', 'lightRed', 'maxColor']).optional().default('auto'),
+    defaultOnlineMeetingProvider: z.enum(['none', 'teamsForBusiness']).optional().default('teamsForBusiness'),
+    default: z.boolean().optional()
+});
+class OutlookCalendarAddCommand extends GraphCommand {
+    get name() {
+        return commands.CALENDAR_ADD;
+    }
+    get description() {
+        return 'Creates a new calendar for a user';
+    }
+    get schema() {
+        return options;
+    }
+    getRefinedSchema(schema) {
+        return schema
+            .refine(options => !(options.userId && options.userName), {
+            error: 'Specify either userId or userName, but not both'
+        })
+            .refine(options => !(options.calendarGroupId && options.calendarGroupName), {
+            error: 'Specify either calendarGroupId or calendarGroupName, but not both'
+        });
+    }
+    async commandAction(logger, args) {
+        try {
+            const userIdentifier = args.options.userId ?? args.options.userName;
+            let requestUrl = `${this.resource}/v1.0/users('${userIdentifier}')/`;
+            if (args.options.calendarGroupId || args.options.calendarGroupName) {
+                let calendarGroupId = args.options.calendarGroupId;
+                if (args.options.calendarGroupName) {
+                    const group = await calendarGroup.getUserCalendarGroupByName(userIdentifier, args.options.calendarGroupName, 'id');
+                    calendarGroupId = group.id;
+                }
+                requestUrl += `calendarGroups/${calendarGroupId}/calendars`;
+            }
+            else {
+                requestUrl += 'calendars';
+            }
+            if (args.options.verbose) {
+                await logger.logToStderr(`Creating a calendar for the user ${userIdentifier}...`);
+            }
+            const requestOptions = {
+                url: requestUrl,
+                headers: {
+                    accept: 'application/json;odata.metadata=none',
+                    'content-type': 'application/json'
+                },
+                responseType: 'json',
+                data: {
+                    name: args.options.name,
+                    color: args.options.color,
+                    defaultOnlineMeetingProvider: args.options.defaultOnlineMeetingProvider,
+                    isDefaultCalendar: args.options.default
+                }
+            };
+            const result = await request.post(requestOptions);
+            await logger.log(result);
+        }
+        catch (err) {
+            this.handleRejectedODataJsonPromise(err);
+        }
+    }
+}
+export default new OutlookCalendarAddCommand();
+//# sourceMappingURL=calendar-add.js.map

package/dist/m365/outlook/commands/calendar/calendar-get.js

@@ -0,0 +1,71 @@
+import GraphCommand from '../../../base/GraphCommand.js';
+import commands from '../../commands.js';
+import { z } from 'zod';
+import { globalOptionsZod } from '../../../../Command.js';
+import { validation } from '../../../../utils/validation.js';
+import { calendarGroup } from '../../../../utils/calendarGroup.js';
+import { calendar } from '../../../../utils/calendar.js';
+export const options = z.strictObject({
+    ...globalOptionsZod.shape,
+    id: z.string().alias('i').optional(),
+    name: z.string().alias('n').optional(),
+    userId: z.string()
+        .refine(userId => validation.isValidGuid(userId), {
+        error: e => `'${e.input}' is not a valid GUID.`
+    }).optional(),
+    userName: z.string()
+        .refine(userName => validation.isValidUserPrincipalName(userName), {
+        error: e => `'${e.input}' is not a valid UPN.`
+    }).optional(),
+    calendarGroupId: z.string().optional(),
+    calendarGroupName: z.string().optional()
+});
+class OutlookCalendarGetCommand extends GraphCommand {
+    get name() {
+        return commands.CALENDAR_GET;
+    }
+    get description() {
+        return 'Retrieves the calendar of a user or a group';
+    }
+    get schema() {
+        return options;
+    }
+    getRefinedSchema(schema) {
+        return schema
+            .refine(options => [options.id, options.name].filter(x => x !== undefined).length === 1, {
+            error: 'Specify either id or name, but not both'
+        })
+            .refine(options => !(options.userId && options.userName), {
+            error: 'Specify either userId or userName, but not both'
+        })
+            .refine(options => !(options.calendarGroupId && options.calendarGroupName), {
+            error: 'Specify either calendarGroupId or calendarGroupName, but not both'
+        });
+    }
+    async commandAction(logger, args) {
+        if (this.verbose) {
+            await logger.logToStderr('Getting calendar...');
+        }
+        try {
+            const userIdentifier = args.options.userId ?? args.options.userName;
+            let calendarGroupId = args.options.calendarGroupId;
+            if (args.options.calendarGroupName) {
+                const group = await calendarGroup.getUserCalendarGroupByName(userIdentifier, args.options.calendarGroupName, 'id');
+                calendarGroupId = group.id;
+            }
+            let result;
+            if (args.options.id) {
+                result = await calendar.getUserCalendarById(userIdentifier, args.options.id, calendarGroupId);
+            }
+            else {
+                result = await calendar.getUserCalendarByName(userIdentifier, args.options.name, calendarGroupId);
+            }
+            await logger.log(result);
+        }
+        catch (err) {
+            this.handleRejectedODataJsonPromise(err);
+        }
+    }
+}
+export default new OutlookCalendarGetCommand();
+//# sourceMappingURL=calendar-get.js.map

package/dist/m365/outlook/commands/calendar/calendar-remove.js

@@ -0,0 +1,100 @@
+import GraphCommand from '../../../base/GraphCommand.js';
+import commands from '../../commands.js';
+import { z } from 'zod';
+import { globalOptionsZod } from '../../../../Command.js';
+import { validation } from '../../../../utils/validation.js';
+import { calendarGroup } from '../../../../utils/calendarGroup.js';
+import { calendar } from '../../../../utils/calendar.js';
+import { cli } from '../../../../cli/cli.js';
+import request from '../../../../request.js';
+export const options = z.strictObject({
+    ...globalOptionsZod.shape,
+    id: z.string().alias('i').optional(),
+    name: z.string().alias('n').optional(),
+    userId: z.string()
+        .refine(userId => validation.isValidGuid(userId), {
+        error: e => `'${e.input}' is not a valid GUID.`
+    }).optional(),
+    userName: z.string()
+        .refine(userName => validation.isValidUserPrincipalName(userName), {
+        error: e => `'${e.input}' is not a valid UPN.`
+    }).optional(),
+    calendarGroupId: z.string().optional(),
+    calendarGroupName: z.string().optional(),
+    permanent: z.boolean().optional(),
+    force: z.boolean().optional().alias('f')
+});
+class OutlookCalendarRemoveCommand extends GraphCommand {
+    get name() {
+        return commands.CALENDAR_REMOVE;
+    }
+    get description() {
+        return 'Removes the calendar of a user';
+    }
+    get schema() {
+        return options;
+    }
+    getRefinedSchema(schema) {
+        return schema
+            .refine(options => [options.id, options.name].filter(x => x !== undefined).length === 1, {
+            error: 'Specify either id or name, but not both'
+        })
+            .refine(options => [options.userId, options.userName].filter(x => x !== undefined).length === 1, {
+            error: 'Specify either userId or userName, but not both'
+        })
+            .refine(options => [options.calendarGroupId, options.calendarGroupName].filter(x => x !== undefined).length !== 2, {
+            error: 'Do not specify both calendarGroupId and calendarGroupName'
+        });
+    }
+    async commandAction(logger, args) {
+        const removeCalendar = async () => {
+            try {
+                const userIdentifier = args.options.userId ?? args.options.userName;
+                let calendarGroupId = args.options.calendarGroupId;
+                if (args.options.calendarGroupName) {
+                    const group = await calendarGroup.getUserCalendarGroupByName(userIdentifier, args.options.calendarGroupName, 'id');
+                    calendarGroupId = group.id;
+                }
+                let calendarId = args.options.id;
+                if (args.options.name) {
+                    const result = await calendar.getUserCalendarByName(userIdentifier, args.options.name, calendarGroupId, 'id');
+                    calendarId = result.id;
+                }
+                if (args.options.verbose) {
+                    await logger.logToStderr(`Removing calendar with ID ${calendarId}...`);
+                }
+                let url = `${this.resource}/v1.0/users('${userIdentifier}')/${calendarGroupId ? `calendarGroups/${calendarGroupId}/` : ''}calendars/${calendarId}`;
+                if (args.options.permanent) {
+                    url += '/permanentDelete';
+                }
+                const requestOptions = {
+                    url: url,
+                    headers: {
+                        accept: 'application/json;odata.metadata=none'
+                    }
+                };
+                if (args.options.permanent) {
+                    await request.post(requestOptions);
+                }
+                else {
+                    await request.delete(requestOptions);
+                }
+            }
+            catch (err) {
+                this.handleRejectedODataJsonPromise(err);
+            }
+        };
+        if (args.options.force) {
+            await removeCalendar();
+        }
+        else {
+            const calendarIdentifier = args.options.id ?? args.options.name;
+            const result = await cli.promptForConfirmation({ message: `Are you sure you want to remove calendar '${calendarIdentifier}'?` });
+            if (result) {
+                await removeCalendar();
+            }
+        }
+    }
+}
+export default new OutlookCalendarRemoveCommand();
+//# sourceMappingURL=calendar-remove.js.map

package/dist/m365/outlook/commands/calendargroup/calendargroup-set.js

@@ -0,0 +1,115 @@
+import { z } from 'zod';
+import { globalOptionsZod } from '../../../../Command.js';
+import GraphCommand from '../../../base/GraphCommand.js';
+import commands from '../../commands.js';
+import { validation } from '../../../../utils/validation.js';
+import request from '../../../../request.js';
+import { accessToken } from '../../../../utils/accessToken.js';
+import auth from '../../../../Auth.js';
+import { formatting } from '../../../../utils/formatting.js';
+import { calendarGroup } from '../../../../utils/calendarGroup.js';
+export const options = z.strictObject({
+    ...globalOptionsZod.shape,
+    id: z.string().optional(),
+    name: z.string().optional(),
+    userId: z.string().refine(id => validation.isValidGuid(id), {
+        error: e => `'${e.input}' is not a valid GUID.`
+    }).optional(),
+    userName: z.string().refine(name => validation.isValidUserPrincipalName(name), {
+        error: e => `'${e.input}' is not a valid UPN.`
+    }).optional(),
+    newName: z.string()
+});
+class OutlookCalendarGroupSetCommand extends GraphCommand {
+    get name() {
+        return commands.CALENDARGROUP_SET;
+    }
+    get description() {
+        return 'Updates a calendar group for a user';
+    }
+    get schema() {
+        return options;
+    }
+    getRefinedSchema(schema) {
+        return schema
+            .refine(options => !(options.userId && options.userName), {
+            error: 'Specify either userId or userName, but not both.'
+        })
+            .refine(options => !(!options.id && !options.name), {
+            error: 'Specify either id or name.'
+        })
+            .refine(options => !(options.id && options.name), {
+            error: 'Specify either id or name, but not both.'
+        });
+    }
+    async commandAction(logger, args) {
+        try {
+            const token = auth.connection.accessTokens[auth.defaultResource].accessToken;
+            const isAppOnlyAccessToken = accessToken.isAppOnlyAccessToken(token);
+            let userUrl;
+            let graphUserId;
+            if (isAppOnlyAccessToken) {
+                if (!args.options.userId && !args.options.userName) {
+                    throw 'When running with application permissions either userId or userName is required.';
+                }
+                graphUserId = (args.options.userId ?? args.options.userName);
+                userUrl = `${this.resource}/v1.0/users('${formatting.encodeQueryParameter(graphUserId)}')`;
+                if (this.verbose) {
+                    await logger.logToStderr(`Updating calendar group using application permissions for user '${graphUserId}'...`);
+                }
+            }
+            else if (args.options.userId || args.options.userName) {
+                const currentUserId = accessToken.getUserIdFromAccessToken(token);
+                const currentUserName = accessToken.getUserNameFromAccessToken(token);
+                const isOtherUser = (args.options.userId && args.options.userId !== currentUserId) ||
+                    (args.options.userName && args.options.userName.toLowerCase() !== currentUserName?.toLowerCase());
+                if (isOtherUser) {
+                    const scopes = accessToken.getScopesFromAccessToken(token);
+                    const hasSharedScope = scopes.some(s => s === 'Calendars.ReadWrite.Shared');
+                    if (!hasSharedScope) {
+                        throw `To update calendar groups of other users, the Entra ID application used for authentication must have the Calendars.ReadWrite.Shared delegated permission assigned.`;
+                    }
+                }
+                graphUserId = (args.options.userId ?? args.options.userName);
+                userUrl = `${this.resource}/v1.0/users('${formatting.encodeQueryParameter(graphUserId)}')`;
+                if (this.verbose) {
+                    await logger.logToStderr(`Updating calendar group using delegated permissions for user '${graphUserId}'...`);
+                }
+            }
+            else {
+                graphUserId = accessToken.getUserIdFromAccessToken(token);
+                userUrl = `${this.resource}/v1.0/me`;
+                if (this.verbose) {
+                    await logger.logToStderr('Updating calendar group for the signed-in user...');
+                }
+            }
+            let calendarGroupId;
+            if (args.options.id) {
+                calendarGroupId = args.options.id;
+            }
+            else {
+                const calendarGroupResult = await calendarGroup.getUserCalendarGroupByName(graphUserId, args.options.name);
+                calendarGroupId = calendarGroupResult.id;
+            }
+            if (this.verbose) {
+                await logger.logToStderr(`Updating calendar group '${calendarGroupId}'...`);
+            }
+            const requestOptions = {
+                url: `${userUrl}/calendarGroups/${calendarGroupId}`,
+                headers: {
+                    accept: 'application/json;odata.metadata=none'
+                },
+                responseType: 'json',
+                data: {
+                    name: args.options.newName
+                }
+            };
+            await request.patch(requestOptions);
+        }
+        catch (err) {
+            this.handleRejectedODataJsonPromise(err);
+        }
+    }
+}
+export default new OutlookCalendarGroupSetCommand();
+//# sourceMappingURL=calendargroup-set.js.map

package/dist/m365/outlook/commands/event/event-cancel.js

@@ -0,0 +1,103 @@
+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 { cli } from '../../../../cli/cli.js';
+import { globalOptionsZod } from '../../../../Command.js';
+import { z } from 'zod';
+export const options = z.strictObject({
+    ...globalOptionsZod.shape,
+    id: z.string().alias('i'),
+    userId: z.string().refine(id => validation.isValidGuid(id), {
+        error: e => `'${e.input}' is not a valid GUID.`
+    }).optional(),
+    userName: z.string()
+        .refine(upn => validation.isValidUserPrincipalName(upn) === true, {
+        error: e => `'${e.input}' is not a valid user principal name for option 'userName'.`
+    })
+        .optional(),
+    comment: z.string().optional(),
+    force: z.boolean().optional().alias('f')
+});
+class OutlookEventCancelCommand extends GraphCommand {
+    get name() {
+        return commands.EVENT_CANCEL;
+    }
+    get description() {
+        return 'Cancels a calendar event';
+    }
+    get schema() {
+        return options;
+    }
+    getRefinedSchema(schema) {
+        return schema
+            .refine(options => !(options.userId && options.userName), {
+            error: `Specify either 'userId' or 'userName', but not both.`
+        });
+    }
+    async commandAction(logger, args) {
+        const isAppOnlyAccessToken = accessToken.isAppOnlyAccessToken(auth.connection.accessTokens[auth.defaultResource].accessToken);
+        let principalUrl = '';
+        const token = auth.connection.accessTokens[auth.defaultResource].accessToken;
+        if (isAppOnlyAccessToken) {
+            if (!args.options.userId && !args.options.userName) {
+                throw `The option 'userId' or 'userName' is required when cancelling an event using application permissions.`;
+            }
+        }
+        else {
+            if (args.options.userId) {
+                const currentUserId = accessToken.getUserIdFromAccessToken(token);
+                if (args.options.userId !== currentUserId) {
+                    throw `You can only cancel your own events when using delegated permissions. The specified userId '${args.options.userId}' does not match the current user '${currentUserId}'.`;
+                }
+            }
+            if (args.options.userName) {
+                const currentUserName = accessToken.getUserNameFromAccessToken(token);
+                if (args.options.userName.toLowerCase() !== currentUserName.toLowerCase()) {
+                    throw `You can only cancel your own events when using delegated permissions. The specified userName '${args.options.userName}' does not match the current user '${currentUserName}'.`;
+                }
+            }
+        }
+        if (args.options.userId || args.options.userName) {
+            const userIdentifier = args.options.userId ?? args.options.userName;
+            principalUrl += `users('${userIdentifier}')`;
+        }
+        else {
+            principalUrl += 'me';
+        }
+        const cancelEvent = async () => {
+            try {
+                if (this.verbose) {
+                    await logger.logToStderr(`Cancelling event with id '${args.options.id}'...`);
+                }
+                const requestOptions = {
+                    url: `${this.resource}/v1.0/${principalUrl}/events/${args.options.id}/cancel`,
+                    headers: {
+                        accept: 'application/json;odata.metadata=none',
+                        'content-type': 'application/json'
+                    },
+                    data: {
+                        comment: args.options.comment
+                    }
+                };
+                await request.post(requestOptions);
+            }
+            catch (err) {
+                this.handleRejectedODataJsonPromise(err);
+            }
+        };
+        if (args.options.force) {
+            await cancelEvent();
+        }
+        else {
+            const result = await cli.promptForConfirmation({ message: `Are you sure you want to cancel event with id '${args.options.id}'?` });
+            if (result) {
+                await cancelEvent();
+            }
+        }
+    }
+}
+export default new OutlookEventCancelCommand();
+//# sourceMappingURL=event-cancel.js.map