@pnp/cli-microsoft365 5.8.0-beta.c222170 → 5.8.0-beta.f956c5d

package/dist/m365/graph/Changelog.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=Changelog.js.map

package/dist/m365/graph/commands/changelog/changelog-list.js

@@ -0,0 +1,160 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+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 _GraphChangelogListCommand_instances, _GraphChangelogListCommand_initTelemetry, _GraphChangelogListCommand_initOptions, _GraphChangelogListCommand_initValidators;
+Object.defineProperty(exports, "__esModule", { value: true });
+const utils_1 = require("../../../../utils");
+const AnonymousCommand_1 = require("../../../base/AnonymousCommand");
+const commands_1 = require("../../commands");
+const request_1 = require("../../../../request");
+const xmldom_1 = require("@xmldom/xmldom");
+class GraphChangelogListCommand extends AnonymousCommand_1.default {
+    constructor() {
+        super();
+        _GraphChangelogListCommand_instances.add(this);
+        this.allowedVersions = ['beta', 'v1.0'];
+        this.allowedChangeTypes = ['Addition', 'Change', 'Deletion', 'Deprecation'];
+        this.allowedServices = [
+            'Applications', 'Calendar', 'Change notifications', 'Cloud communications',
+            'Compliance', 'Cross-device experiences', 'Customer booking', 'Device and app management',
+            'Education', 'Files', 'Financials', 'Groups',
+            'Identity and access', 'Mail', 'Notes', 'Notifications',
+            'People and workplace intelligence', 'Personal contacts', 'Reports', 'Search',
+            'Security', 'Sites and lists', 'Tasks and plans', 'Teamwork',
+            'To-do tasks', 'Users', 'Workbooks and charts'
+        ];
+        __classPrivateFieldGet(this, _GraphChangelogListCommand_instances, "m", _GraphChangelogListCommand_initTelemetry).call(this);
+        __classPrivateFieldGet(this, _GraphChangelogListCommand_instances, "m", _GraphChangelogListCommand_initOptions).call(this);
+        __classPrivateFieldGet(this, _GraphChangelogListCommand_instances, "m", _GraphChangelogListCommand_initValidators).call(this);
+    }
+    get name() {
+        return commands_1.default.CHANGELOG_LIST;
+    }
+    get description() {
+        return 'Gets an overview of specific API-level changes in Microsoft Graph v1.0 and beta';
+    }
+    defaultProperties() {
+        return ['category', 'title', 'description'];
+    }
+    commandAction(logger, args, cb) {
+        const allowedChangeType = args.options.changeType && this.allowedChangeTypes.find(x => x.toLocaleLowerCase() === args.options.changeType.toLocaleLowerCase());
+        const searchParam = args.options.changeType ? `/?filterBy=${allowedChangeType}` : '';
+        const requestOptions = {
+            url: `https://developer.microsoft.com/en-us/graph/changelog/rss${searchParam}`,
+            headers: {
+                'accept': 'text/xml',
+                'x-anonymous': 'true'
+            }
+        };
+        request_1.default
+            .get(requestOptions)
+            .then((output) => {
+            const parser = new xmldom_1.DOMParser();
+            const xmlDoc = parser.parseFromString(output.toString(), "text/xml");
+            const changelog = this.filterThroughOptions(args.options, this.mapChangelog(xmlDoc, args));
+            logger.log(changelog.items);
+            cb();
+        }, (err) => this.handleRejectedODataJsonPromise(err, logger, cb));
+    }
+    filterThroughOptions(options, changelog) {
+        let items = changelog.items;
+        if (options.services) {
+            const allowedServices = this.allowedServices
+                .filter(allowedService => options.services.toLocaleLowerCase().split(',').includes(allowedService.toLocaleLowerCase()));
+            items = changelog.items.filter(item => allowedServices.includes(item.title));
+        }
+        if (options.versions) {
+            const allowedVersions = this.allowedVersions
+                .filter(allowedVersion => options.versions.toLocaleLowerCase().split(',').includes(allowedVersion.toLocaleLowerCase()));
+            items = items.filter(item => allowedVersions.includes(item.category));
+        }
+        if (options.startDate) {
+            const startDate = new Date(options.startDate);
+            items = items.filter(item => item.pubDate >= startDate);
+        }
+        if (options.endDate) {
+            const endDate = new Date(options.endDate);
+            items = items.filter(item => item.pubDate <= endDate);
+        }
+        // Make sure everything is unique based on the item guid
+        items = [...new Map(items.map((item) => [item.guid, item])).values()];
+        changelog.items = items.sort((itemA, itemB) => Number(itemB.pubDate) - Number(itemA.pubDate));
+        return changelog;
+    }
+    mapChangelog(xmlDoc, args) {
+        const channel = xmlDoc.getElementsByTagName('channel').item(0);
+        const changelog = {
+            title: channel.getElementsByTagName('title').item(0).textContent,
+            description: channel.getElementsByTagName('description').item(0).textContent,
+            url: channel.getElementsByTagName('link').item(0).textContent,
+            items: []
+        };
+        Array.from(xmlDoc.getElementsByTagName('item')).forEach((item) => {
+            const description = args.options.output === 'text' ?
+                utils_1.md.md2plain(item.getElementsByTagName('description').item(0).textContent, '') :
+                item.getElementsByTagName('description').item(0).textContent;
+            changelog.items.push({
+                guid: item.getElementsByTagName('guid').item(0).textContent,
+                category: item.getElementsByTagName('category').item(1).textContent,
+                title: item.getElementsByTagName('title').item(0).textContent,
+                description: args.options.output === 'text' ?
+                    description.length > 50 ? `${description.substring(0, 47)}...` : description :
+                    description,
+                pubDate: new Date(item.getElementsByTagName('pubDate').item(0).textContent)
+            });
+        });
+        return changelog;
+    }
+}
+_GraphChangelogListCommand_instances = new WeakSet(), _GraphChangelogListCommand_initTelemetry = function _GraphChangelogListCommand_initTelemetry() {
+    this.telemetry.push((args) => {
+        Object.assign(this.telemetryProperties, {
+            versions: typeof args.options.versions !== 'undefined',
+            changeType: typeof args.options.changeType !== 'undefined',
+            services: typeof args.options.services !== 'undefined',
+            startDate: typeof args.options.startDate !== 'undefined',
+            endDate: typeof args.options.endDate !== 'undefined'
+        });
+    });
+}, _GraphChangelogListCommand_initOptions = function _GraphChangelogListCommand_initOptions() {
+    this.options.unshift({ option: '-v, --versions [versions]', autocomplete: this.allowedVersions }, { option: "-c, --changeType [changeType]", autocomplete: this.allowedChangeTypes }, { option: "-s, --services [services]", autocomplete: this.allowedServices }, { option: "--startDate [startDate]" }, { option: "--endDate [endDate]" });
+}, _GraphChangelogListCommand_initValidators = function _GraphChangelogListCommand_initValidators() {
+    this.validators.push((args) => __awaiter(this, void 0, void 0, function* () {
+        if (args.options.versions &&
+            args.options.versions.toLocaleLowerCase().split(',').some(x => !this.allowedVersions.map(y => y.toLocaleLowerCase()).includes(x))) {
+            return `The verions contains an invalid value. Specify either ${this.allowedVersions.join(', ')} as properties`;
+        }
+        if (args.options.changeType &&
+            !this.allowedChangeTypes.map(x => x.toLocaleLowerCase()).includes(args.options.changeType.toLocaleLowerCase())) {
+            return `The change type contain an invalid value. Specify either ${this.allowedChangeTypes.join(', ')} as properties`;
+        }
+        if (args.options.services &&
+            args.options.services.toLocaleLowerCase().split(',').some(x => !this.allowedServices.map(y => y.toLocaleLowerCase()).includes(x))) {
+            return `The services contains invalid value. Specify either ${this.allowedServices.join(', ')} as properties`;
+        }
+        if (args.options.startDate && !utils_1.validation.isValidISODate(args.options.startDate)) {
+            return 'The startDate is not a valid ISO date string';
+        }
+        if (args.options.endDate && !utils_1.validation.isValidISODate(args.options.endDate)) {
+            return 'The endDate is not a valid ISO date string';
+        }
+        if (args.options.endDate && args.options.startDate && new Date(args.options.endDate) < new Date(args.options.startDate)) {
+            return 'The endDate should be later than startDate';
+        }
+        return true;
+    }));
+};
+module.exports = new GraphChangelogListCommand();
+//# sourceMappingURL=changelog-list.js.map

package/dist/m365/graph/commands.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 const prefix = 'graph';
 exports.default = {
+    CHANGELOG_LIST: `${prefix} changelog list`,
     SCHEMAEXTENSION_ADD: `${prefix} schemaextension add`,
     SCHEMAEXTENSION_GET: `${prefix} schemaextension get`,
     SCHEMAEXTENSION_LIST: `${prefix} schemaextension list`,

package/dist/m365/outlook/commands/mail/mail-send.js

@@ -15,6 +15,8 @@ var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (
 };
 var _OutlookMailSendCommand_instances, _OutlookMailSendCommand_initTelemetry, _OutlookMailSendCommand_initOptions, _OutlookMailSendCommand_initValidators;
 Object.defineProperty(exports, "__esModule", { value: true });
+const Auth_1 = require("../../../../Auth");
+const Command_1 = require("../../../../Command");
 const request_1 = require("../../../../request");
 const GraphCommand_1 = require("../../../base/GraphCommand");
 const commands_1 = require("../../commands");
@@ -30,15 +32,19 @@ class OutlookMailSendCommand extends GraphCommand_1.default {
         return commands_1.default.MAIL_SEND;
     }
     get description() {
-        return 'Sends e-mail on behalf of the current user';
+        return 'Sends an e-mail';
     }
     alias() {
         return [commands_1.default.SENDMAIL];
     }
     commandAction(logger, args, cb) {
         const bodyContents = args.options.bodyContents;
+        const isAppOnlyAuth = Auth_1.Auth.isAppOnlyAuth(Auth_1.default.service.accessTokens[this.resource].accessToken);
+        if (isAppOnlyAuth === true && !args.options.sender) {
+            return cb(new Command_1.CommandError(`Specify a upn or user id in the 'sender' option when using app only authentication.`));
+        }
         const requestOptions = {
-            url: `${this.resource}/v1.0/me/sendMail`,
+            url: `${this.resource}/v1.0/${args.options.sender ? 'users/' + encodeURIComponent(args.options.sender) : 'me'}/sendMail`,
             headers: {
                 accept: 'application/json;odata.metadata=none',
                 'content-type': 'application/json'
@@ -62,6 +68,13 @@ class OutlookMailSendCommand extends GraphCommand_1.default {
                 saveToSentItems: args.options.saveToSentItems
             }
         };
+        if (args.options.mailbox) {
+            requestOptions.data.message.from = {
+                emailAddress: {
+                    address: args.options.mailbox
+                }
+            };
+        }
         request_1.default
             .post(requestOptions)
             .then(_ => cb(), (err) => this.handleRejectedODataJsonPromise(err, logger, cb));
@@ -72,7 +85,9 @@ _OutlookMailSendCommand_instances = new WeakSet(), _OutlookMailSendCommand_initT
         Object.assign(this.telemetryProperties, {
             bodyContents: typeof args.options.bodyContents !== 'undefined',
             bodyContentType: args.options.bodyContentType,
-            saveToSentItems: args.options.saveToSentItems
+            saveToSentItems: args.options.saveToSentItems,
+            mailbox: typeof args.options.mailbox !== 'undefined',
+            sender: typeof args.options.sender !== 'undefined'
         });
     });
 }, _OutlookMailSendCommand_initOptions = function _OutlookMailSendCommand_initOptions() {
@@ -80,6 +95,10 @@ _OutlookMailSendCommand_instances = new WeakSet(), _OutlookMailSendCommand_initT
         option: '-s, --subject <subject>'
     }, {
         option: '-t, --to <to>'
+    }, {
+        option: '--sender [sender]'
+    }, {
+        option: '-m, --mailbox [mailbox]'
     }, {
         option: '--bodyContents <bodyContents>'
     }, {

package/dist/m365/pp/commands/environment/environment-list.js

@@ -64,7 +64,7 @@ _PpEnvironmentListCommand_instances = new WeakSet(), _PpEnvironmentListCommand_i
     });
 }, _PpEnvironmentListCommand_initOptions = function _PpEnvironmentListCommand_initOptions() {
     this.options.unshift({
-        option: '-a, --asAdmin [teamId]'
+        option: '-a, --asAdmin'
     });
 };
 module.exports = new PpEnvironmentListCommand();

package/dist/utils/fsUtil.js

@@ -42,12 +42,10 @@ const addFileCommands = {
         addFileCommand: 'cat > [FILEPATH] << EOF [FILECONTENT]EOF'
     },
     powershell: {
-        addFileCommand: `@"[FILECONTENT]"@ | Out-File -FilePath "[FILEPATH]"
-    `
+        addFileCommand: `@"[FILECONTENT]"@ | Out-File -FilePath [FILEPATH]`
     },
     cmd: {
-        addFileCommand: `echo [FILECONTENT] > "[FILEPATH]"
-    `
+        addFileCommand: `echo [FILECONTENT] > [FILEPATH]`
     }
 };
 const removeFileCommands = {

package/dist/utils/md.js

@@ -46,7 +46,7 @@ function convertHyperlinks(md) {
     });
 }
 function convertCodeFences(md) {
-    const regex = new RegExp('^```.*?' + os_1.EOL + '(.*?)```' + os_1.EOL, 'gms');
+    const regex = new RegExp('^```.*?(?:\r\n|\n)(.*?)```(?:\r\n|\n)', 'gms');
     return md.replace(regex, (match, code) => {
         return `  ${code}${os_1.EOL}`;
     });

package/docs/docs/cmd/graph/changelog/changelog-list.md

@@ -0,0 +1,53 @@
+# graph changelog list
+
+Gets an overview of specific API-level changes in Microsoft Graph v1.0 and beta
+
+## Usage
+
+```sh
+m365 graph changelog list [options]
+```
+
+## Options
+
+`-v, --versions [versions]`
+: Comma-separated list of versions to show changes for. `Beta, v1.0`. When no version is selected all versions are returned.
+
+`-c, --changeType [changeType]`
+: Change type to show changes for. `Addition, Change, Deletion`. When no changeType is selected all change types are returned.
+
+`-s, --services [services]`
+: Comma-separated list of services to show changes for. `Applications, Calendar, Change notifications, Cloud communications, Compliance, Cross-device experiences, Customer booking, Device and app management, Education, Files, Financials, Groups, Identity and access, Mail, Notes, Notifications, People and workplace intelligence, Personal contacts, Reports, Search, Security, Sites and lists, Tasks and plans, Teamwork, To-do tasks, Users, Workbooks and charts`. When no service is selected all services are returned.
+
+`--startDate [startDate]`
+: The startdate used to query for changes. Supported date format is `YYYY-MM-DD`. When no date is specified all changes are returned.
+
+`--endDate [endDate]`
+: The enddate used to query for changes. Supported date format is `YYYY-MM-DD`. When no date is specified all changes are returned.
+
+--8<-- "docs/cmd/_global.md"
+
+## Remarks
+
+!!! attention
+    This command is based on an API that is currently in preview and is subject to change once the API reached general availability.
+
+## Examples
+
+Get all changes within Microsoft Graph.
+
+```sh
+m365 graph changelog list
+```
+
+Get all changes within Microsoft Graph for the services _Groups_ and _Users_.
+
+```sh
+m365 graph changelog list --services 'Groups,Users'
+```
+
+Get all changes within Microsoft Graph that happend between _2021-01-01_ and _2021-05-01_.
+
+```sh
+m365 graph changelog list --startDate '2021-01-01' --endDate '2021-05-01'
+```

package/docs/docs/cmd/outlook/mail/mail-send.md

@@ -1,6 +1,6 @@
 # outlook sendmail
 
-Sends e-mail on behalf of the current user
+Sends an e-mail
 
 ## Usage
 
@@ -22,6 +22,12 @@ m365 outlook sendmail [options]
 `-t, --to <to>`
 : Comma-separated list of e-mails to send the message to
 
+`--sender [sender]`
+: Optional upn or user id to specify what account to send the message from. Also see the remarks section.
+
+`-m, --mailbox [mailbox]`
+: Specify this option to send the email on behalf of another mailbox, for example a shared mailbox, group or distribution list. The sender needs to be a delegate on the specified mailbox. Also see the remarks section.
+
 `--bodyContents <bodyContents>`
 : String containing the body of the e-mail to send
 
@@ -33,6 +39,25 @@ m365 outlook sendmail [options]
 
 --8<-- "docs/cmd/_global.md"
 
+## Remarks
+
+### If you are connected using app only authentication
+
+- Always specify a user id or upn in the `--sender` option. The email will be sent as if it came from the specified user, and can optionally be saved in the sent folder of that user account.
+- You can optionally also specify the `--mailbox` option to send mail on behalf of a shared mailbox, group or distribution list. The account used in the `--sender` option, needs to have 'Send on behalf of' permissions on the mailbox in question.
+
+!!! important
+    You need `Mail.Send` application permissions on the Microsoft Graph to be able to send mails using an application identity. 
+
+### If you are connected with a regular user account
+
+- Specify the `--mailbox` option if you want to send an email on behalf of another mailbox. This can be a shared mailbox, group or distribution list. It will be visible in the email that the email was sent by you. You need to be assigned `Send on behalf of` permissions on the mailbox in question.  
+- You can specify the `--sender` option if you want to send an email as if you were the other user.
+The sent email can optionally be saved in the sent folder of that user account. You'll need `Read and manage (Full Access)` permissions on the mailbox of the other user. You can combine the `--sender` and `--mailbox` options to let the other user send a mail on behalf of the specified mailbox.
+
+!!! important
+    You need at least `Mail.Send` delegated permissions on the Microsoft Graph to be able to send emails. When specifying another user as sender, you'll need `Mail.Send.Shared` permissions.
+
 ## Examples
 
 Send a text e-mail to the specified e-mail address
@@ -58,3 +83,21 @@ Send a text e-mail to the specified e-mail address. Don't store the e-mail in se
 ```sh
 m365 outlook mail send --to chris@contoso.com --subject "DG2000 Data Sheets" --bodyContents "The latest data sheets are in the team site" --saveToSentItems false
 ```
+
+Send an email on behalf of a shared mailbox using the signed in user
+
+```sh
+m365 outlook mail send --to chris@contoso.com --subject "DG2000 Data Sheets" --bodyContents "The latest data sheets are in the team site" --mailbox sales@contoso.com
+```
+
+Send an email as another user
+
+```sh
+m365 outlook mail send --to chris@contoso.com --subject "DG2000 Data Sheets" --bodyContents "The latest data sheets are in the team site" --sender svc_project@contoso.com
+```
+
+Send an email as another user, on behalf of a shared mailbox
+
+```sh
+m365 outlook mail send --to chris@contoso.com --subject "DG2000 Data Sheets" --bodyContents "The latest data sheets are in the team site" --sender svc_project@contoso.com --mailbox sales@contoso.com
+```

package/docs/docs/cmd/pp/environment/environment-list.md

@@ -10,7 +10,7 @@ m365 pp environment list [options]
 
 ## Options
 
-`-a, --asAdmin [teamId]`
+`-a, --asAdmin`
 Run the command as admin and retrieve all environments. Lists only environments you have explicitly are assigned permissions to by default.
 
 --8<-- "docs/cmd/_global.md"

package/docs/docs/cmd/spo/list/list-roleassignment-add.md

@@ -26,10 +26,10 @@ m365 spo list roleassignment add [options]
 : SharePoint ID of principal it may be either user id or group id we want to add permissions to. Specify principalId only when upn or groupName are not used.
 
 `--upn [upn]`
-: Upn/email of user to assign role to. Specify either upn or princpialId
+: Upn/email of user to assign role to. Specify either upn or principalId
 
 `--groupName [groupName]`
-: Enter group name of Azure AD or SharePoint group.. Specify either groupName or princpialId
+: Enter group name of Azure AD or SharePoint group.. Specify either groupName or principalId
 
 `--roleDefinitionId [roleDefinitionId]`
 : ID of role definition. Specify either roleDefinitionId or roleDefinitionName but not both

package/docs/docs/cmd/spo/list/list-roleassignment-remove.md

@@ -26,10 +26,10 @@ m365 spo list roleassignment remove [options]
 : SharePoint ID of principal it may be either user id or group id we want to remove permissions Specify principalId only when upn or groupName are not used.
 
 `--upn [upn]`
-: upn/email of user. Specify either upn or princpialId.
+: upn/email of user. Specify either upn or principalId.
 
 `--groupName [groupName]`
-: enter group name of Azure AD or SharePoint group. Specify either groupName or princpialId.
+: enter group name of Azure AD or SharePoint group. Specify either groupName or principalId.
 
 `--confirm`
 : Don't prompt for confirming removing the role assignment

package/docs/docs/cmd/spo/listitem/listitem-roleassignment-remove.md

@@ -29,10 +29,10 @@ m365 spo listitem roleassignment remove [options]
 : SharePoint ID of principal it may be either user id or group id we want to remove permissions Specify principalId only when upn or groupName are not used.
 
 `--upn [upn]`
-: upn/email of user. Specify either upn or princpialId.
+: upn/email of user. Specify either upn or principalId.
 
 `--groupName [groupName]`
-: enter group name of Azure AD or SharePoint group. Specify either groupName or princpialId.
+: enter group name of Azure AD or SharePoint group. Specify either groupName or principalId.
 
 `--confirm`
 : Don't prompt for confirming removing the role assignment

package/docs/docs/cmd/spo/web/web-roleassignment-add.md

@@ -17,10 +17,10 @@ m365 spo web roleassignment add [options]
 : SharePoint ID of principal it may be either user id or group id we want to add permissions to. Specify principalId only when upn or groupName are not used.
 
 `--upn [upn]`
-: upn/email of user to assign role to. Specify either upn or princpialId
+: upn/email of user to assign role to. Specify either upn or principalId
 
 `--groupName [groupName]`
-: enter group name of Azure AD or SharePoint group.. Specify either groupName or princpialId
+: enter group name of Azure AD or SharePoint group.. Specify either groupName or principalId
 
 `--roleDefinitionId [roleDefinitionId]`
 : ID of role definition. Specify either roleDefinitionId or roleDefinitionName but not both

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pnp/cli-microsoft365",
-  "version": "5.8.0-beta.c222170",
+  "version": "5.8.0-beta.f956c5d",
   "description": "Manage Microsoft 365 and SharePoint Framework projects on any platform",
   "license": "MIT",
   "main": "./dist/api.js",