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

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

package/dist/m365/outlook/commands/event/event-list.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 { odata } from '../../../../utils/odata.js';
+import { calendar } from '../../../../utils/calendar.js';
+export const options = z.strictObject({
+    ...globalOptionsZod.shape,
+    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(),
+    calendarId: z.string().optional(),
+    calendarName: z.string().optional(),
+    startDateTime: z.string().refine(date => validation.isValidISODateTime(date), {
+        error: e => `'${e.input}' is not a valid ISO date-time.`
+    }).optional(),
+    endDateTime: z.string().refine(date => validation.isValidISODateTime(date), {
+        error: e => `'${e.input}' is not a valid ISO date-time.`
+    }).optional(),
+    timeZone: z.string().optional(),
+    properties: z.string().optional(),
+    filter: z.string().optional()
+});
+class OutlookEventListCommand extends GraphCommand {
+    get name() {
+        return commands.EVENT_LIST;
+    }
+    get description() {
+        return 'Retrieves a list of events from a specific calendar of a user.';
+    }
+    get schema() {
+        return options;
+    }
+    getRefinedSchema(schema) {
+        return schema
+            .refine(options => [options.userId, options.userName].filter(x => x !== undefined).length === 1, {
+            error: 'Specify either userId or userName, but not both'
+        })
+            .refine(options => !(options.calendarId && options.calendarName), {
+            error: 'Specify either calendarId or calendarName, but not both.'
+        });
+    }
+    defaultProperties() {
+        return ['id', 'subject'];
+    }
+    async commandAction(logger, args) {
+        try {
+            if (this.verbose) {
+                await logger.logToStderr('Getting a list of the events...');
+            }
+            let events;
+            const endpoint = await this.getRequestUrl(args.options);
+            if (args.options.timeZone) {
+                const requestOptions = {
+                    url: endpoint,
+                    headers: {
+                        accept: 'application/json;odata.metadata=none',
+                        Prefer: `outlook.timezone="${args.options.timeZone}"`
+                    },
+                    responseType: 'json'
+                };
+                events = await odata.getAllItems(requestOptions);
+            }
+            else {
+                events = await odata.getAllItems(endpoint);
+            }
+            await logger.log(events);
+        }
+        catch (err) {
+            this.handleRejectedODataJsonPromise(err);
+        }
+    }
+    async getRequestUrl(options) {
+        const queryParameters = [];
+        if (options.properties) {
+            const allProperties = options.properties.split(',');
+            const selectProperties = allProperties.filter(prop => !prop.includes('/'));
+            const expandProperties = allProperties.filter(prop => prop.includes('/'));
+            if (selectProperties.length > 0) {
+                queryParameters.push(`$select=${selectProperties}`);
+            }
+            if (expandProperties.length > 0) {
+                const fieldExpands = expandProperties.map(p => `${p.split('/')[0]}($select=${p.split('/')[1]})`);
+                queryParameters.push(`$expand=${fieldExpands.join(',')}`);
+            }
+        }
+        if (options.filter || options.startDateTime || options.endDateTime) {
+            let filter = options.filter || '';
+            if (options.startDateTime) {
+                filter += `${filter ? ' and ' : ''}start/dateTime ge '${options.startDateTime}'`;
+            }
+            if (options.endDateTime) {
+                filter += `${filter ? ' and ' : ''}start/dateTime lt '${options.endDateTime}'`;
+            }
+            queryParameters.push(`$filter=${filter}`);
+        }
+        const queryString = queryParameters.length > 0
+            ? `?${queryParameters.join('&')}`
+            : '';
+        const userIdentifier = options.userId ?? options.userName;
+        let calendarId = options.calendarId;
+        if (options.calendarName) {
+            calendarId = (await calendar.getUserCalendarByName(userIdentifier, options.calendarName)).id;
+        }
+        return calendarId
+            ? `${this.resource}/v1.0/users('${userIdentifier}')/calendars/${calendarId}/events${queryString}`
+            : `${this.resource}/v1.0/users('${userIdentifier}')/events${queryString}`;
+    }
+}
+export default new OutlookEventListCommand();
+//# sourceMappingURL=event-list.js.map

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

@@ -0,0 +1,104 @@
+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(),
+    permanent: z.boolean().optional(),
+    force: z.boolean().optional().alias('f')
+});
+class OutlookEventRemoveCommand extends GraphCommand {
+    get name() {
+        return commands.EVENT_REMOVE;
+    }
+    get description() {
+        return 'Removes an event from a calendar';
+    }
+    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);
+        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 removing an event using application permissions.`;
+            }
+        }
+        else {
+            if (args.options.userId) {
+                const currentUserId = accessToken.getUserIdFromAccessToken(token);
+                if (args.options.userId !== currentUserId) {
+                    throw `You can only remove 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 remove your own events when using delegated permissions. The specified userName '${args.options.userName}' does not match the current user '${currentUserName}'.`;
+                }
+            }
+        }
+        let principalUrl = '';
+        const userIdentifier = args.options.userId ?? args.options.userName;
+        if (userIdentifier) {
+            principalUrl += `users('${userIdentifier}')`;
+        }
+        else {
+            principalUrl += 'me';
+        }
+        const removeEvent = async () => {
+            try {
+                if (this.verbose) {
+                    await logger.logToStderr(`Removing event with id '${args.options.id}'...`);
+                }
+                const requestOptions = {
+                    url: `${this.resource}/v1.0/${principalUrl}/events/${args.options.id}`,
+                    headers: {
+                        accept: 'application/json;odata.metadata=none'
+                    }
+                };
+                if (args.options.permanent) {
+                    requestOptions.url += '/permanentDelete';
+                    await request.post(requestOptions);
+                }
+                else {
+                    await request.delete(requestOptions);
+                }
+            }
+            catch (err) {
+                this.handleRejectedODataJsonPromise(err);
+            }
+        };
+        if (args.options.force) {
+            await removeEvent();
+        }
+        else {
+            const result = await cli.promptForConfirmation({ message: `Are you sure you want to remove event with id '${args.options.id}'?` });
+            if (result) {
+                await removeEvent();
+            }
+        }
+    }
+}
+export default new OutlookEventRemoveCommand();
+//# sourceMappingURL=event-remove.js.map

package/dist/m365/outlook/commands.js

@@ -1,6 +1,15 @@
 const prefix = 'outlook';
 export default {
+    CALENDAR_ADD: `${prefix} calendar add`,
+    CALENDAR_GET: `${prefix} calendar get`,
+    CALENDAR_REMOVE: `${prefix} calendar remove`,
+    CALENDAR_SET: `${prefix} calendar set`,
+    CALENDARGROUP_GET: `${prefix} calendargroup get`,
     CALENDARGROUP_LIST: `${prefix} calendargroup list`,
+    CALENDARGROUP_SET: `${prefix} calendargroup set`,
+    EVENT_CANCEL: `${prefix} event cancel`,
+    EVENT_LIST: `${prefix} event list`,
+    EVENT_REMOVE: `${prefix} event remove`,
     MAIL_SEARCHFOLDER_ADD: `${prefix} mail searchfolder add`,
     MAIL_SEND: `${prefix} mail send`,
     MAILBOX_SETTINGS_GET: `${prefix} mailbox settings get`,