@pnp/cli-microsoft365 5.0.0-beta.d025005 → 5.0.0-beta.ef2dfe7

package/.devcontainer/devcontainer.json

@@ -3,17 +3,20 @@
   "dockerFile": "Dockerfile",
   "settings": {
     "terminal.integrated.profiles.linux": {
-        "zsh": {
-          "path": "/bin/zsh",
-          "args": [
-            "-l"
-          ]
-        }
-      },
-      "terminal.integrated.defaultProfile.linux": "zsh"
+      "zsh": {
+        "path": "/bin/zsh",
+        "args": [
+          "-l"
+        ]
+      }
+    },
+    "terminal.integrated.defaultProfile.linux": "zsh"
   },
   "postCreateCommand": "npm i && npm run clean && npm run build && npm link",
   "extensions": [
-    "dbaeumer.vscode-eslint"
+    "dbaeumer.vscode-eslint",
+    "hbenl.vscode-test-explorer",
+    "hbenl.vscode-mocha-test-adapter",
+    "eamodio.gitlens"
   ]
 }

package/.eslintrc.js

@@ -49,6 +49,7 @@ const dictionary = [
   'records',
   'recycle',
   'role',
+  'room',
   'schema',
   'service',
   'setting',

package/.mocharc.json

@@ -0,0 +1,9 @@
+{
+  "extension": [
+    "ts"
+  ],
+  "spec": "dist/**/*.spec.js",
+  "require": "source-map-support/register",
+  "watch": "dist/**/*.js",
+  "logpanel": true
+}

package/README.md

@@ -208,9 +208,9 @@ If you want to get involved with helping us grow the CLI, whether that is sugges
 
 Checkout our [Wiki](https://github.com/pnp/cli-microsoft365/wiki) for guides on how to contribute to this project.
 
-## Sharing is Caring
+## Microsoft 365 Platform Community
 
-This project is associated with the [Microsoft 365 Patterns and Practices](https://pnp.github.io) (PnP) organisation, which is a virtual team consisting of Microsoft employees and community members focused on helping the community make the best use of Microsoft products.
+CLI for Microsoft 365 is a [Microsoft 365 Platform Community](https://pnp.github.io) (PnP) project. Microsoft 365 Platform Community is a virtual team consisting of Microsoft employees and community members focused on helping the community make the best use of Microsoft products. CLI for Microsoft 365 is an open-source project not affiliated with Microsoft and not covered by Microsoft support. If you experience any issues using the CLI, please submit an issue in the [issues list](https://github.com/pnp/cli-microsoft365/issues).
 
 ## Disclaimer
 

package/dist/Command.js

@@ -113,7 +113,7 @@ class Command {
             },
             {
                 option: '-o, --output [output]',
-                autocomplete: ['json', 'text']
+                autocomplete: ['csv', 'json', 'text']
             },
             {
                 option: '--verbose'

package/dist/m365/aad/commands/app/app-delete.js

@@ -0,0 +1,123 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const cli_1 = require("../../../../cli");
+const request_1 = require("../../../../request");
+const Utils_1 = require("../../../../Utils");
+const GraphCommand_1 = require("../../../base/GraphCommand");
+const commands_1 = require("../../commands");
+class AadAppDeleteCommand extends GraphCommand_1.default {
+    get name() {
+        return commands_1.default.APP_DELETE;
+    }
+    get description() {
+        return 'Removes an Azure AD app registration';
+    }
+    getTelemetryProperties(args) {
+        const telemetryProps = super.getTelemetryProperties(args);
+        telemetryProps.appId = typeof args.options.appId !== 'undefined';
+        telemetryProps.objectId = typeof args.options.objectId !== 'undefined';
+        telemetryProps.name = typeof args.options.name !== 'undefined';
+        telemetryProps.confirm = (!(!args.options.confirm)).toString();
+        return telemetryProps;
+    }
+    commandAction(logger, args, cb) {
+        const deleteApp = () => {
+            this
+                .getObjectId(args, logger)
+                .then((objectId) => {
+                if (this.verbose) {
+                    logger.logToStderr(`Deleting Azure AD app ${objectId}...`);
+                }
+                const requestOptions = {
+                    url: `${this.resource}/v1.0/myorganization/applications/${objectId}`,
+                    headers: {
+                        accept: 'application/json;odata.metadata=none'
+                    },
+                    responseType: 'json'
+                };
+                return request_1.default.delete(requestOptions);
+            })
+                .then(_ => cb(), (rawRes) => this.handleRejectedODataJsonPromise(rawRes, logger, cb));
+        };
+        if (args.options.confirm) {
+            deleteApp();
+        }
+        else {
+            cli_1.Cli.prompt({
+                type: 'confirm',
+                name: 'continue',
+                default: false,
+                message: `Are you sure you want to delete the App?`
+            }, (result) => {
+                if (!result.continue) {
+                    cb();
+                }
+                else {
+                    deleteApp();
+                }
+            });
+        }
+    }
+    getObjectId(args, logger) {
+        if (args.options.objectId) {
+            return Promise.resolve(args.options.objectId);
+        }
+        const { appId, name } = args.options;
+        if (this.verbose) {
+            logger.logToStderr(`Retrieving information about Azure AD app ${appId ? appId : name}...`);
+        }
+        const filter = appId ?
+            `appId eq '${encodeURIComponent(appId)}'` :
+            `displayName eq '${encodeURIComponent(name)}'`;
+        const requestOptions = {
+            url: `${this.resource}/v1.0/myorganization/applications?$filter=${filter}&$select=id`,
+            headers: {
+                accept: 'application/json;odata.metadata=none'
+            },
+            responseType: 'json'
+        };
+        return request_1.default
+            .get(requestOptions)
+            .then((res) => {
+            if (res.value.length === 1) {
+                return Promise.resolve(res.value[0].id);
+            }
+            if (res.value.length === 0) {
+                const applicationIdentifier = appId ? `ID ${appId}` : `name ${name}`;
+                return Promise.reject(`No Azure AD application registration with ${applicationIdentifier} found`);
+            }
+            return Promise.reject(`Multiple Azure AD application registration with name ${name} found. Please choose one of the object IDs: ${res.value.map(a => a.id).join(', ')}`);
+        });
+    }
+    options() {
+        const options = [
+            { option: '--appId [appId]' },
+            { option: '--objectId [objectId]' },
+            { option: '--name [name]' },
+            { option: '--confirm' }
+        ];
+        const parentOptions = super.options();
+        return options.concat(parentOptions);
+    }
+    validate(args) {
+        if (!args.options.appId &&
+            !args.options.objectId &&
+            !args.options.name) {
+            return 'Specify either appId, objectId, or name';
+        }
+        if ((args.options.appId && args.options.objectId) ||
+            (args.options.appId && args.options.name) ||
+            (args.options.objectId && args.options.name)) {
+            return 'Specify either appId, objectId, or name';
+        }
+        if (args.options.appId && !Utils_1.default.isValidGuid(args.options.appId)) {
+            return `${args.options.appId} is not a valid GUID`;
+        }
+        if (args.options.objectId && !Utils_1.default.isValidGuid(args.options.objectId)) {
+            return `${args.options.objectId} is not a valid GUID`;
+        }
+        return true;
+    }
+}
+module.exports = new AadAppDeleteCommand();
+//# sourceMappingURL=app-delete.js.map

package/dist/m365/aad/commands/app/app-get.js

@@ -1,5 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+const fs = require("fs");
 const request_1 = require("../../../../request");
 const Utils_1 = require("../../../../Utils");
 const GraphCommand_1 = require("../../../base/GraphCommand");
@@ -21,16 +22,8 @@ class AadAppGetCommand extends GraphCommand_1.default {
     commandAction(logger, args, cb) {
         this
             .getAppObjectId(args)
-            .then((appObjectId) => {
-            const requestOptions = {
-                url: `${this.resource}/v1.0/myorganization/applications/${appObjectId}`,
-                headers: {
-                    accept: 'application/json;odata.metadata=none'
-                },
-                responseType: 'json'
-            };
-            return request_1.default.get(requestOptions);
-        })
+            .then(appObjectId => this.getAppInfo(appObjectId))
+            .then(appInfo => this.saveAppInfo(args, appInfo, logger))
             .then((res) => {
             logger.log(res);
             cb();
@@ -64,11 +57,63 @@ class AadAppGetCommand extends GraphCommand_1.default {
             return Promise.reject(`Multiple Azure AD application registration with name ${name} found. Please disambiguate (app object IDs): ${res.value.map(a => a.id).join(', ')}`);
         });
     }
+    getAppInfo(appObjectId) {
+        const requestOptions = {
+            url: `${this.resource}/v1.0/myorganization/applications/${appObjectId}`,
+            headers: {
+                accept: 'application/json;odata.metadata=none'
+            },
+            responseType: 'json'
+        };
+        return request_1.default.get(requestOptions);
+    }
+    saveAppInfo(args, appInfo, logger) {
+        if (!args.options.save) {
+            return Promise.resolve(appInfo);
+        }
+        const filePath = '.m365rc.json';
+        if (this.verbose) {
+            logger.logToStderr(`Saving Azure AD app registration information to the ${filePath} file...`);
+        }
+        let m365rc = {};
+        if (fs.existsSync(filePath)) {
+            if (this.debug) {
+                logger.logToStderr(`Reading existing ${filePath}...`);
+            }
+            try {
+                const fileContents = fs.readFileSync(filePath, 'utf8');
+                if (fileContents) {
+                    m365rc = JSON.parse(fileContents);
+                }
+            }
+            catch (e) {
+                logger.logToStderr(`Error reading ${filePath}: ${e}. Please add app info to ${filePath} manually.`);
+                return Promise.resolve(appInfo);
+            }
+        }
+        if (!m365rc.apps) {
+            m365rc.apps = [];
+        }
+        if (!m365rc.apps.some(a => a.appId === appInfo.appId)) {
+            m365rc.apps.push({
+                appId: appInfo.appId,
+                name: appInfo.displayName
+            });
+            try {
+                fs.writeFileSync(filePath, JSON.stringify(m365rc, null, 2));
+            }
+            catch (e) {
+                logger.logToStderr(`Error writing ${filePath}: ${e}. Please add app info to ${filePath} manually.`);
+            }
+        }
+        return Promise.resolve(appInfo);
+    }
     options() {
         const options = [
             { option: '--appId [appId]' },
             { option: '--objectId [objectId]' },
-            { option: '--name [name]' }
+            { option: '--name [name]' },
+            { option: '--save' }
         ];
         const parentOptions = super.options();
         return options.concat(parentOptions);

package/dist/m365/aad/commands/app/app-set.js

@@ -15,6 +15,9 @@ class AadAppSetCommand extends GraphCommand_1.default {
         telemetryProps.appId = typeof args.options.appId !== 'undefined';
         telemetryProps.objectId = typeof args.options.objectId !== 'undefined';
         telemetryProps.name = typeof args.options.name !== 'undefined';
+        telemetryProps.platform = typeof args.options.platform !== 'undefined';
+        telemetryProps.redirectUris = typeof args.options.redirectUris !== 'undefined';
+        telemetryProps.redirectUrisToRemove = typeof args.options.redirectUrisToRemove !== 'undefined';
         telemetryProps.uri = typeof args.options.uri !== 'undefined';
         return telemetryProps;
     }
@@ -22,6 +25,7 @@ class AadAppSetCommand extends GraphCommand_1.default {
         this
             .getAppObjectId(args, logger)
             .then(objectId => this.configureUri(args, objectId, logger))
+            .then(objectId => this.configureRedirectUris(args, objectId, logger))
             .then(_ => cb(), (rawRes) => this.handleRejectedODataJsonPromise(rawRes, logger, cb));
     }
     getAppObjectId(args, logger) {
@@ -57,7 +61,7 @@ class AadAppSetCommand extends GraphCommand_1.default {
     }
     configureUri(args, objectId, logger) {
         if (!args.options.uri) {
-            return Promise.resolve();
+            return Promise.resolve(objectId);
         }
         if (this.verbose) {
             logger.logToStderr(`Configuring Azure AD application ID URI...`);
@@ -73,14 +77,97 @@ class AadAppSetCommand extends GraphCommand_1.default {
             responseType: 'json',
             data: applicationInfo
         };
-        return request_1.default.patch(requestOptions);
+        return request_1.default
+            .patch(requestOptions)
+            .then(_ => Promise.resolve(objectId));
+    }
+    configureRedirectUris(args, objectId, logger) {
+        if (!args.options.redirectUris && !args.options.redirectUrisToRemove) {
+            return Promise.resolve(objectId);
+        }
+        if (this.verbose) {
+            logger.logToStderr(`Configuring Azure AD application redirect URIs...`);
+        }
+        const getAppRequestOptions = {
+            url: `${this.resource}/v1.0/myorganization/applications/${objectId}`,
+            headers: {
+                'content-type': 'application/json;odata.metadata=none'
+            },
+            responseType: 'json'
+        };
+        return request_1.default
+            .get(getAppRequestOptions)
+            .then((application) => {
+            const publicClientRedirectUris = application.publicClient.redirectUris;
+            const spaRedirectUris = application.spa.redirectUris;
+            const webRedirectUris = application.web.redirectUris;
+            // start with existing redirect URIs
+            const applicationPatch = {
+                publicClient: {
+                    redirectUris: publicClientRedirectUris
+                },
+                spa: {
+                    redirectUris: spaRedirectUris
+                },
+                web: {
+                    redirectUris: webRedirectUris
+                }
+            };
+            if (args.options.redirectUrisToRemove) {
+                // remove redirect URIs from all platforms
+                const redirectUrisToRemove = args.options.redirectUrisToRemove
+                    .split(',')
+                    .map(u => u.trim());
+                applicationPatch.publicClient.redirectUris =
+                    publicClientRedirectUris.filter(u => !redirectUrisToRemove.includes(u));
+                applicationPatch.spa.redirectUris =
+                    spaRedirectUris.filter(u => !redirectUrisToRemove.includes(u));
+                applicationPatch.web.redirectUris =
+                    webRedirectUris.filter(u => !redirectUrisToRemove.includes(u));
+            }
+            if (args.options.redirectUris) {
+                const urlsToAdd = args.options.redirectUris
+                    .split(',')
+                    .map(u => u.trim());
+                // add new redirect URIs. If the URI is already present, it will be ignored
+                switch (args.options.platform) {
+                    case 'spa':
+                        applicationPatch.spa.redirectUris
+                            .push(...urlsToAdd.filter(u => !spaRedirectUris.includes(u)));
+                        break;
+                    case 'publicClient':
+                        applicationPatch.publicClient.redirectUris
+                            .push(...urlsToAdd.filter(u => !publicClientRedirectUris.includes(u)));
+                        break;
+                    case 'web':
+                        applicationPatch.web.redirectUris
+                            .push(...urlsToAdd.filter(u => !webRedirectUris.includes(u)));
+                }
+            }
+            const requestOptions = {
+                url: `${this.resource}/v1.0/myorganization/applications/${objectId}`,
+                headers: {
+                    'content-type': 'application/json;odata.metadata=none'
+                },
+                responseType: 'json',
+                data: applicationPatch
+            };
+            return request_1.default.patch(requestOptions);
+        })
+            .then(_ => Promise.resolve(objectId));
     }
     options() {
         const options = [
             { option: '--appId [appId]' },
             { option: '--objectId [objectId]' },
             { option: '-n, --name [name]' },
-            { option: '-u, --uri [uri]' }
+            { option: '-u, --uri [uri]' },
+            { option: '-r, --redirectUris [redirectUris]' },
+            {
+                option: '--platform [platform]',
+                autocomplete: AadAppSetCommand.aadApplicationPlatform
+            },
+            { option: '--redirectUrisToRemove [redirectUrisToRemove]' }
         ];
         const parentOptions = super.options();
         return options.concat(parentOptions);
@@ -96,8 +183,16 @@ class AadAppSetCommand extends GraphCommand_1.default {
             (args.options.objectId && args.options.name)) {
             return 'Specify either appId, objectId or name but not both';
         }
+        if (args.options.redirectUris && !args.options.platform) {
+            return `When you specify redirectUris you also need to specify platform`;
+        }
+        if (args.options.platform &&
+            AadAppSetCommand.aadApplicationPlatform.indexOf(args.options.platform) < 0) {
+            return `${args.options.platform} is not a valid value for platform. Allowed values are ${AadAppSetCommand.aadApplicationPlatform.join(', ')}`;
+        }
         return true;
     }
 }
+AadAppSetCommand.aadApplicationPlatform = ['spa', 'web', 'publicClient'];
 module.exports = new AadAppSetCommand();
 //# sourceMappingURL=app-set.js.map

package/dist/m365/aad/commands/group/group-list.js

@@ -9,12 +9,18 @@ class AadGroupListCommand extends GraphItemsListCommand_1.GraphItemsListCommand
     get description() {
         return 'Lists all groups defined in Azure Active Directory.';
     }
+    getTelemetryProperties(args) {
+        const telemetryProps = super.getTelemetryProperties(args);
+        telemetryProps.deleted = args.options.deleted;
+        return telemetryProps;
+    }
     defaultProperties() {
         return ['id', 'displayName', 'groupType'];
     }
     commandAction(logger, args, cb) {
+        const endpoint = args.options.deleted ? 'directory/deletedItems/microsoft.graph.group' : 'groups';
         this
-            .getAllItems(`${this.resource}/v1.0/groups`, logger, true)
+            .getAllItems(`${this.resource}/v1.0/${endpoint}`, logger, true)
             .then(() => {
             if (args.options.output === 'text') {
                 this.items.forEach((group) => {
@@ -36,6 +42,13 @@ class AadGroupListCommand extends GraphItemsListCommand_1.GraphItemsListCommand
             cb();
         }, (err) => this.handleRejectedODataJsonPromise(err, logger, cb));
     }
+    options() {
+        const options = [
+            { option: '-d, --deleted' }
+        ];
+        const parentOptions = super.options();
+        return options.concat(parentOptions);
+    }
 }
 module.exports = new AadGroupListCommand();
 //# sourceMappingURL=group-list.js.map

package/dist/m365/aad/commands/o365group/o365group-conversation-list.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const Utils_1 = require("../../../../Utils");
+const GraphItemsListCommand_1 = require("../../../base/GraphItemsListCommand");
+const commands_1 = require("../../commands");
+class AadO365GroupConversationListCommand extends GraphItemsListCommand_1.GraphItemsListCommand {
+    get name() {
+        return commands_1.default.O365GROUP_CONVERSATION_LIST;
+    }
+    get description() {
+        return 'Lists conversations for the specified Microsoft 365 group';
+    }
+    defaultProperties() {
+        return ['topic', 'lastDeliveredDateTime', 'id'];
+    }
+    commandAction(logger, args, cb) {
+        this
+            .getAllItems(`${this.resource}/v1.0/groups/${args.options.groupId}/conversations`, logger, true)
+            .then(() => {
+            logger.log(this.items);
+            cb();
+        }, (err) => this.handleRejectedODataJsonPromise(err, logger, cb));
+    }
+    options() {
+        const options = [
+            {
+                option: '-i, --groupId <groupId>'
+            }
+        ];
+        const parentOptions = super.options();
+        return options.concat(parentOptions);
+    }
+    validate(args) {
+        if (!Utils_1.default.isValidGuid(args.options.groupId)) {
+            return `${args.options.groupId} is not a valid GUID`;
+        }
+        return true;
+    }
+}
+module.exports = new AadO365GroupConversationListCommand();
+//# sourceMappingURL=o365group-conversation-list.js.map

package/dist/m365/aad/commands.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const prefix = 'aad';
 exports.default = {
     APP_ADD: `${prefix} app add`,
+    APP_DELETE: `${prefix} app delete`,
     APP_GET: `${prefix} app get`,
     APP_SET: `${prefix} app set`,
     APP_ROLE_ADD: `${prefix} app role add`,
@@ -22,6 +23,7 @@ exports.default = {
     O365GROUP_ADD: `${prefix} o365group add`,
     O365GROUP_GET: `${prefix} o365group get`,
     O365GROUP_LIST: `${prefix} o365group list`,
+    O365GROUP_CONVERSATION_LIST: `${prefix} o365group conversation list`,
     O365GROUP_RECYCLEBINITEM_CLEAR: `${prefix} o365group recyclebinitem clear`,
     O365GROUP_RECYCLEBINITEM_LIST: `${prefix} o365group recyclebinitem list`,
     O365GROUP_RECYCLEBINITEM_RESTORE: `${prefix} o365group recyclebinitem restore`,

package/dist/m365/outlook/commands/room/room-list.js

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const GraphItemsListCommand_1 = require("../../../base/GraphItemsListCommand");
+const commands_1 = require("../../commands");
+class OutlookRoomListCommand extends GraphItemsListCommand_1.GraphItemsListCommand {
+    get name() {
+        return commands_1.default.ROOM_LIST;
+    }
+    get description() {
+        return 'Get a collection of all available rooms';
+    }
+    getTelemetryProperties(args) {
+        const telemetryProps = super.getTelemetryProperties(args);
+        telemetryProps.roomlistEmail = typeof args.options.roomlistEmail !== 'undefined';
+        return telemetryProps;
+    }
+    defaultProperties() {
+        return ['id', 'displayName', 'phone', 'emailAddress'];
+    }
+    commandAction(logger, args, cb) {
+        let endpoint = `${this.resource}/v1.0/places/microsoft.graph.room`;
+        if (args.options.roomlistEmail) {
+            endpoint = `${this.resource}/v1.0/places/${args.options.roomlistEmail}/microsoft.graph.roomlist/rooms`;
+        }
+        this
+            .getAllItems(endpoint, logger, true)
+            .then(() => {
+            logger.log(this.items);
+            cb();
+        }, (err) => this.handleRejectedODataJsonPromise(err, logger, cb));
+    }
+    options() {
+        const options = [
+            {
+                option: '--roomlistEmail [roomlistEmail]'
+            }
+        ];
+        const parentOptions = super.options();
+        return options.concat(parentOptions);
+    }
+}
+module.exports = new OutlookRoomListCommand();
+//# sourceMappingURL=room-list.js.map

package/dist/m365/outlook/commands/roomlist/roomlist-list.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const GraphItemsListCommand_1 = require("../../../base/GraphItemsListCommand");
+const commands_1 = require("../../commands");
+class OutlookRoomListListCommand extends GraphItemsListCommand_1.GraphItemsListCommand {
+    get name() {
+        return commands_1.default.ROOMLIST_LIST;
+    }
+    get description() {
+        return 'Get a collection of available roomlists';
+    }
+    defaultProperties() {
+        return ['id', 'displayName', 'phone', 'emailAddress'];
+    }
+    commandAction(logger, args, cb) {
+        this
+            .getAllItems(`${this.resource}/v1.0/places/microsoft.graph.roomlist`, logger, true)
+            .then(() => {
+            logger.log(this.items);
+            cb();
+        }, (err) => this.handleRejectedODataJsonPromise(err, logger, cb));
+    }
+}
+module.exports = new OutlookRoomListListCommand();
+//# sourceMappingURL=roomlist-list.js.map

package/dist/m365/outlook/commands.js

@@ -16,6 +16,8 @@ exports.default = {
     REPORT_MAILBOXUSAGEMAILBOXCOUNT: `${prefix} report mailboxusagemailboxcount`,
     REPORT_MAILBOXUSAGEQUOTASTATUSMAILBOXCOUNTS: `${prefix} report mailboxusagequotastatusmailboxcounts`,
     REPORT_MAILBOXUSAGESTORAGE: `${prefix} report mailboxusagestorage`,
+    ROOM_LIST: `${prefix} room list`,
+    ROOMLIST_LIST: `${prefix} roomlist list`,
     SENDMAIL: `${prefix} sendmail`
 };
 //# sourceMappingURL=commands.js.map

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

@@ -12,7 +12,7 @@ class PlannerTaskGetCommand extends GraphCommand_1.default {
     }
     commandAction(logger, args, cb) {
         const requestOptions = {
-            url: `${this.resource}/v1.0/planner/tasks/${encodeURIComponent(args.options.id)}`,
+            url: `${this.resource}/beta/planner/tasks/${encodeURIComponent(args.options.id)}`,
             headers: {
                 accept: 'application/json;odata.metadata=none'
             },