@pnp/cli-microsoft365 5.1.0-beta.ffd9bc8 → 5.2.0-beta.90d2227

package/dist/m365/teams/commands/chat/chat-get.js

@@ -0,0 +1,143 @@
+"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());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const Auth_1 = require("../../../../Auth");
+const os = require("os");
+const request_1 = require("../../../../request");
+const GraphCommand_1 = require("../../../base/GraphCommand");
+const commands_1 = require("../../commands");
+const validation_1 = require("../../../../utils/validation");
+const accessToken_1 = require("../../../../utils/accessToken");
+const chatUtil_1 = require("./chatUtil");
+class TeamsChatGetCommand extends GraphCommand_1.default {
+    get name() {
+        return commands_1.default.CHAT_GET;
+    }
+    get description() {
+        return 'Get a Microsoft Teams chat conversation by id, participants or chat name.';
+    }
+    getTelemetryProperties(args) {
+        const telemetryProps = super.getTelemetryProperties(args);
+        telemetryProps.id = typeof args.options.id !== 'undefined';
+        telemetryProps.participants = typeof args.options.participants !== 'undefined';
+        telemetryProps.name = typeof args.options.name !== 'undefined';
+        return telemetryProps;
+    }
+    commandAction(logger, args, cb) {
+        this
+            .getChatId(logger, args)
+            .then(chatId => this.getChatDetailsById(chatId))
+            .then((chat) => {
+            logger.log(chat);
+            cb();
+        }, (err) => this.handleRejectedODataJsonPromise(err, logger, cb));
+    }
+    options() {
+        const options = [
+            {
+                option: '-i, --id [id]'
+            },
+            {
+                option: '-p, --participants [participants]'
+            },
+            {
+                option: '-n, --name [name]'
+            }
+        ];
+        const parentOptions = super.options();
+        return options.concat(parentOptions);
+    }
+    validate(args) {
+        if (!args.options.id && !args.options.participants && !args.options.name) {
+            return 'Specify id or participants or name, one is required.';
+        }
+        let nrOfMutuallyExclusiveOptionsInUse = 0;
+        if (args.options.id) {
+            nrOfMutuallyExclusiveOptionsInUse++;
+        }
+        if (args.options.participants) {
+            nrOfMutuallyExclusiveOptionsInUse++;
+        }
+        if (args.options.name) {
+            nrOfMutuallyExclusiveOptionsInUse++;
+        }
+        if (nrOfMutuallyExclusiveOptionsInUse > 1) {
+            return 'Specify either id or participants or name, but not multiple.';
+        }
+        if (args.options.id && !validation_1.validation.isValidTeamsChatId(args.options.id)) {
+            return `${args.options.id} is not a valid Teams ChatId.`;
+        }
+        if (args.options.participants) {
+            const participants = chatUtil_1.chatUtil.convertParticipantStringToArray(args.options.participants);
+            if (!participants || participants.length === 0 || participants.some(e => !validation_1.validation.isValidUserPrincipalName(e))) {
+                return `${args.options.participants} contains one or more invalid email addresses.`;
+            }
+        }
+        return true;
+    }
+    getChatId(logger, args) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (args.options.id) {
+                return args.options.id;
+            }
+            return args.options.participants
+                ? this.getChatIdByParticipants(args.options.participants, logger)
+                : this.getChatIdByName(args.options.name, logger);
+        });
+    }
+    getChatDetailsById(id) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const requestOptions = {
+                url: `${this.resource}/v1.0/chats/${encodeURIComponent(id)}`,
+                headers: {
+                    accept: 'application/json;odata.metadata=none'
+                },
+                responseType: 'json'
+            };
+            return request_1.default.get(requestOptions);
+        });
+    }
+    getChatIdByParticipants(participantsString, logger) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const participants = chatUtil_1.chatUtil.convertParticipantStringToArray(participantsString);
+            const currentUserEmail = accessToken_1.accessToken.getUserNameFromAccessToken(Auth_1.default.service.accessTokens[this.resource].accessToken).toLowerCase();
+            const existingChats = yield chatUtil_1.chatUtil.findExistingChatsByParticipants([currentUserEmail, ...participants], logger);
+            if (!existingChats || existingChats.length === 0) {
+                throw new Error('No chat conversation was found with these participants.');
+            }
+            if (existingChats.length === 1) {
+                return existingChats[0].id;
+            }
+            const disambiguationText = existingChats.map(c => {
+                return `- ${c.id}${c.topic && ' - '}${c.topic} - ${c.createdDateTime && new Date(c.createdDateTime).toLocaleString()}`;
+            }).join(os.EOL);
+            throw new Error(`Multiple chat conversations with these participants found. Please disambiguate:${os.EOL}${disambiguationText}`);
+        });
+    }
+    getChatIdByName(name, logger) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const existingChats = yield chatUtil_1.chatUtil.findExistingGroupChatsByName(name, logger);
+            if (!existingChats || existingChats.length === 0) {
+                throw new Error('No chat conversation was found with this name.');
+            }
+            if (existingChats.length === 1) {
+                return existingChats[0].id;
+            }
+            const disambiguationText = existingChats.map(c => {
+                const memberstring = c.members.map(m => m.email).join(', ');
+                return `- ${c.id} - ${c.createdDateTime && new Date(c.createdDateTime).toLocaleString()} - ${memberstring}`;
+            }).join(os.EOL);
+            throw new Error(`Multiple chat conversations with this name found. Please disambiguate:${os.EOL}${disambiguationText}`);
+        });
+    }
+}
+module.exports = new TeamsChatGetCommand();
+//# sourceMappingURL=chat-get.js.map

package/dist/m365/teams/commands/chat/chat-message-send.js

@@ -15,6 +15,7 @@ const request_1 = require("../../../../request");
 const utils_1 = require("../../../../utils");
 const GraphCommand_1 = require("../../../base/GraphCommand");
 const commands_1 = require("../../commands");
+const chatUtil_1 = require("./chatUtil");
 class TeamsChatMessageSendCommand extends GraphCommand_1.default {
     get name() {
         return commands_1.default.CHAT_MESSAGE_SEND;
@@ -79,7 +80,7 @@ class TeamsChatMessageSendCommand extends GraphCommand_1.default {
             return `${args.options.chatId} is not a valid Teams ChatId.`;
         }
         if (args.options.userEmails) {
-            const userEmails = this.convertCommaSeparatedListToArray(args.options.userEmails);
+            const userEmails = chatUtil_1.chatUtil.convertParticipantStringToArray(args.options.userEmails);
             if (!userEmails || userEmails.length === 0 || userEmails.some(e => !utils_1.validation.isValidUserPrincipalName(e))) {
                 return `${args.options.userEmails} contains one or more invalid email addresses.`;
             }
@@ -98,9 +99,9 @@ class TeamsChatMessageSendCommand extends GraphCommand_1.default {
     }
     ensureChatIdByUserEmails(userEmailsOption, logger) {
         return __awaiter(this, void 0, void 0, function* () {
-            const userEmails = this.convertCommaSeparatedListToArray(userEmailsOption);
+            const userEmails = chatUtil_1.chatUtil.convertParticipantStringToArray(userEmailsOption);
             const currentUserEmail = utils_1.accessToken.getUserNameFromAccessToken(Auth_1.default.service.accessTokens[this.resource].accessToken).toLowerCase();
-            const existingChats = yield this.findExistingGroupChatsByMembers([currentUserEmail, ...userEmails], logger);
+            const existingChats = yield chatUtil_1.chatUtil.findExistingChatsByParticipants([currentUserEmail, ...userEmails], logger);
             if (!existingChats || existingChats.length === 0) {
                 const chat = yield this.createConversation([currentUserEmail, ...userEmails]);
                 return chat.id;
@@ -116,7 +117,7 @@ class TeamsChatMessageSendCommand extends GraphCommand_1.default {
     }
     getChatIdByName(chatName, logger) {
         return __awaiter(this, void 0, void 0, function* () {
-            const existingChats = yield this.findExistingGroupChatsByName(chatName, logger);
+            const existingChats = yield chatUtil_1.chatUtil.findExistingGroupChatsByName(chatName, logger);
             if (!existingChats || existingChats.length === 0) {
                 throw new Error('No chat conversation was found with this name.');
             }
@@ -186,32 +187,6 @@ class TeamsChatMessageSendCommand extends GraphCommand_1.default {
             yield request_1.default.post(requestOptions);
         });
     }
-    findExistingGroupChatsByMembers(expectedMemberEmails, logger) {
-        return __awaiter(this, void 0, void 0, function* () {
-            const endpoint = `${this.resource}/v1.0/chats?$filter=chatType eq 'group'&$expand=members&$select=id,topic,createdDateTime,members`;
-            const foundChats = [];
-            const chats = yield utils_1.odata.getAllItems(endpoint, logger);
-            for (const chat of chats) {
-                const chatMembers = chat.members;
-                if (chatMembers.length === expectedMemberEmails.length) {
-                    const chatMemberEmails = chatMembers.map(member => { var _a; return (_a = member.email) === null || _a === void 0 ? void 0 : _a.toLowerCase(); });
-                    if (expectedMemberEmails.every(email => chatMemberEmails.some(memberEmail => memberEmail === email))) {
-                        foundChats.push(chat);
-                    }
-                }
-            }
-            return foundChats;
-        });
-    }
-    findExistingGroupChatsByName(name, logger) {
-        return __awaiter(this, void 0, void 0, function* () {
-            const endpoint = `${this.resource}/v1.0/chats?$filter=topic eq '${encodeURIComponent(name)}'&$expand=members&$select=id,topic,createdDateTime,chatType`;
-            return utils_1.odata.getAllItems(endpoint, logger);
-        });
-    }
-    convertCommaSeparatedListToArray(userEmailsString) {
-        return userEmailsString.toLowerCase().replace(/\s/g, '').split(',').filter(e => e && e !== '');
-    }
 }
 module.exports = new TeamsChatMessageSendCommand();
 //# sourceMappingURL=chat-message-send.js.map

package/dist/m365/teams/commands/chat/chatUtil.js

@@ -0,0 +1,62 @@
+"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());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.chatUtil = void 0;
+const odata_1 = require("../../../../utils/odata");
+exports.chatUtil = {
+    /**
+     * Finds existing Microsoft Teams chats by participants, using the Microsoft Graph
+     * @param expectedMemberEmails a string array of participant emailaddresses
+     * @param logger a logger to pipe into the graph request odata helper.
+     */
+    findExistingChatsByParticipants(expectedMemberEmails, logger) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const chatType = expectedMemberEmails.length === 2 ? 'oneOnOne' : 'group';
+            const endpoint = `https://graph.microsoft.com/v1.0/chats?$filter=chatType eq '${chatType}'&$expand=members&$select=id,topic,createdDateTime,members`;
+            const foundChats = [];
+            const chats = yield odata_1.odata.getAllItems(endpoint, logger);
+            for (const chat of chats) {
+                const chatMembers = chat.members;
+                if (chatMembers.length === expectedMemberEmails.length) {
+                    const chatMemberEmails = chatMembers.map(member => { var _a; return (_a = member.email) === null || _a === void 0 ? void 0 : _a.toLowerCase(); });
+                    if (expectedMemberEmails.every(email => chatMemberEmails.some(memberEmail => memberEmail === email))) {
+                        foundChats.push(chat);
+                    }
+                }
+            }
+            return foundChats;
+        });
+    },
+    /**
+     * Finds existing Microsoft Teams chats by name, using the Microsoft Graph
+     * @param name the name of the chat conversation to find
+     * @param logger a logger to pipe into the graph request odata helper.
+     */
+    findExistingGroupChatsByName(name, logger) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const endpoint = `https://graph.microsoft.com/v1.0/chats?$filter=topic eq '${encodeURIComponent(name).replace("'", "''")}'&$expand=members&$select=id,topic,createdDateTime,chatType`;
+            return odata_1.odata.getAllItems(endpoint, logger);
+        });
+    },
+    /**
+     * Converts a comma or space separated string into an array.
+     * @param value the string to convert
+     */
+    convertParticipantStringToArray(value) {
+        if (value.indexOf(',') === -1) {
+            return value.trim().toLowerCase().split(' ').filter(e => e && e !== '');
+        }
+        else {
+            return value.trim().toLowerCase().split(',').filter(e => e && e !== '');
+        }
+    }
+};
+//# sourceMappingURL=chatUtil.js.map

package/dist/m365/teams/commands.js

@@ -13,6 +13,7 @@ exports.default = {
     CHANNEL_LIST: `${prefix} channel list`,
     CHANNEL_REMOVE: `${prefix} channel remove`,
     CHANNEL_SET: `${prefix} channel set`,
+    CHAT_GET: `${prefix} chat get`,
     CHAT_LIST: `${prefix} chat list`,
     CHAT_MEMBER_LIST: `${prefix} chat member list`,
     CHAT_MESSAGE_LIST: `${prefix} chat message list`,

package/dist/m365/tenant/commands.js

@@ -2,7 +2,6 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 const prefix = 'tenant';
 exports.default = {
-    AUDITLOG_REPORT: `${prefix} auditlog report`,
     ID_GET: `${prefix} id get`,
     REPORT_ACTIVEUSERCOUNTS: `${prefix} report activeusercounts`,
     REPORT_ACTIVEUSERDETAIL: `${prefix} report activeuserdetail`,
@@ -11,14 +10,10 @@ exports.default = {
     REPORT_OFFICE365ACTIVATIONSUSERCOUNTS: `${prefix} report office365activationsusercounts`,
     REPORT_SERVICESUSERCOUNTS: `${prefix} report servicesusercounts`,
     SERVICEANNOUNCEMENT_HEALTHISSUE_GET: `${prefix} serviceannouncement healthissue get`,
-    SERVICE_LIST: `${prefix} service list`,
-    SERVICE_MESSAGE_LIST: `${prefix} service message list`,
-    SERVICE_REPORT_HISTORICALSERVICESTATUS: `${prefix} service report historicalservicestatus`,
     SERVICEANNOUNCEMENT_HEALTH_GET: `${prefix} serviceannouncement health get`,
     SERVICEANNOUNCEMENT_HEALTH_LIST: `${prefix} serviceannouncement health list`,
     SERVICEANNOUNCEMENT_HEALTHISSUE_LIST: `${prefix} serviceannouncement healthissue list`,
     SERVICEANNOUNCEMENT_MESSAGE_GET: `${prefix} serviceannouncement message get`,
-    SERVICEANNOUNCEMENT_MESSAGE_LIST: `${prefix} serviceannouncement message list`,
-    STATUS_LIST: `${prefix} status list`
+    SERVICEANNOUNCEMENT_MESSAGE_LIST: `${prefix} serviceannouncement message list`
 };
 //# sourceMappingURL=commands.js.map

package/dist/settingsNames.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.settingsNames = void 0;
 const settingsNames = {
     autoOpenBrowserOnLogin: 'autoOpenBrowserOnLogin',
+    copyDeviceCodeToClipboard: 'copyDeviceCodeToClipboard',
     csvEscape: 'csvEscape',
     csvHeader: 'csvHeader',
     csvQuote: 'csvQuote',

package/dist/utils/fsUtil.js

@@ -3,6 +3,64 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.fsUtil = void 0;
 const fs = require("fs");
 const path = require("path");
+const copyCommands = {
+    bash: {
+        copyCommand: 'cp',
+        copyDestinationParam: ' '
+    },
+    powershell: {
+        copyCommand: 'Copy-Item',
+        copyDestinationParam: ' -Destination '
+    },
+    cmd: {
+        copyCommand: 'copy',
+        copyDestinationParam: ' '
+    }
+};
+const createDirectoryCommands = {
+    bash: {
+        createDirectoryCommand: 'mkdir',
+        createDirectoryPathParam: ' "',
+        createDirectoryNameParam: '/',
+        createDirectoryItemTypeParam: '"'
+    },
+    powershell: {
+        createDirectoryCommand: 'New-Item',
+        createDirectoryPathParam: ' -Path "',
+        createDirectoryNameParam: '" -Name "',
+        createDirectoryItemTypeParam: '" -ItemType "directory"'
+    },
+    cmd: {
+        createDirectoryCommand: 'mkdir',
+        createDirectoryPathParam: ' "',
+        createDirectoryNameParam: '\\',
+        createDirectoryItemTypeParam: '"'
+    }
+};
+const addFileCommands = {
+    bash: {
+        addFileCommand: 'cat > [FILEPATH] << EOF [FILECONTENT]EOF'
+    },
+    powershell: {
+        addFileCommand: `@"[FILECONTENT]"@ | Out-File -FilePath "[FILEPATH]"
+    `
+    },
+    cmd: {
+        addFileCommand: `echo [FILECONTENT] > "[FILEPATH]"
+    `
+    }
+};
+const removeFileCommands = {
+    bash: {
+        removeFileCommand: 'rm'
+    },
+    powershell: {
+        removeFileCommand: 'Remove-Item'
+    },
+    cmd: {
+        removeFileCommand: 'del'
+    }
+};
 exports.fsUtil = {
     readdirR(dir) {
         return fs.statSync(dir).isDirectory()
@@ -31,6 +89,18 @@ exports.fsUtil = {
     },
     getSafeFileName(input) {
         return input.replace(/'/g, "''");
+    },
+    getCopyCommand(command, shell) {
+        return copyCommands[shell][command];
+    },
+    getDirectoryCommand(command, shell) {
+        return createDirectoryCommands[shell][command];
+    },
+    getAddCommand(command, shell) {
+        return addFileCommands[shell][command];
+    },
+    getRemoveCommand(command, shell) {
+        return removeFileCommands[shell][command];
     }
 };
 //# sourceMappingURL=fsUtil.js.map

package/dist/utils/index.js

@@ -17,10 +17,13 @@ Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./accessToken"), exports);
 __exportStar(require("./formatting"), exports);
 __exportStar(require("./fsUtil"), exports);
+__exportStar(require("./md"), exports);
 __exportStar(require("./odata"), exports);
+__exportStar(require("./packageManager"), exports);
 __exportStar(require("./sinonUtil"), exports);
 __exportStar(require("./spfx"), exports);
 __exportStar(require("./spo"), exports);
+__exportStar(require("./types"), exports);
 __exportStar(require("./urlUtil"), exports);
 __exportStar(require("./validation"), exports);
 //# sourceMappingURL=index.js.map

package/dist/utils/md.js

@@ -0,0 +1,81 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.md = void 0;
+const fs = require("fs");
+const os_1 = require("os");
+const path = require("path");
+function convertTitle(md) {
+    return md.replace(/^#\s+(.*)/gm, (match, title) => {
+        return title.toLocaleUpperCase() + os_1.EOL + Array(title.length + 1).join('=');
+    });
+}
+function convertHeadings(md) {
+    return md.replace(/^(#+)\s+(.*)/gm, (match, level, content) => {
+        return `${os_1.EOL}${content.toLocaleUpperCase()}`;
+    });
+}
+function convertAdmonitions(md) {
+    const regex = new RegExp('^!!!\\s(.*)' + os_1.EOL + '\\s+', 'gm');
+    return md.replace(regex, (match, content) => {
+        return content.toLocaleUpperCase() + os_1.EOL + os_1.EOL;
+    });
+}
+function includeContent(md, rootFolder) {
+    return md.replace(/^--8<-- "([^"]+)"/gm, (match, filePath) => {
+        return fs.readFileSync(path.join(rootFolder, filePath), 'utf8');
+    });
+}
+function convertDd(md) {
+    return md.replace(/^:\s(.*)/gm, (match, content) => {
+        return `  ${content}`;
+    });
+}
+function convertHyperlinks(md) {
+    return md.replace(/\[([^\]]+)\]\(([^\)]+)\)/gm, (match, label, url) => {
+        // if the link is the same as the content, return just the link
+        if (label === url) {
+            return url;
+        }
+        // if the link is relative, remove it because there's no way to open it
+        // from the terminal anyway. In the future, we could convert it to the
+        // actual link of the docs.
+        if (!url.startsWith('http:') && !url.startsWith('https:')) {
+            return label;
+        }
+        return `${label} (${url})`;
+    });
+}
+function convertCodeFences(md) {
+    const regex = new RegExp('^```.*?' + os_1.EOL + '(.*?)```' + os_1.EOL, 'gms');
+    return md.replace(regex, (match, code) => {
+        return `  ${code}${os_1.EOL}`;
+    });
+}
+function removeInlineMarkup(md) {
+    // from https://stackoverflow.com/a/70064453
+    return md.replace(/(?<marks>[`]|\*{1,3}|_{1,3}|~{2})(?<inmarks>.*?)\1/g, '$<inmarks>$<link_text>');
+}
+function removeTooManyEmptyLines(md) {
+    const regex = new RegExp('(' + os_1.EOL + '){4,}', 'g');
+    return md.replace(regex, Array(4).join(os_1.EOL));
+}
+const convertFunctions = [
+    convertTitle,
+    convertHeadings,
+    convertAdmonitions,
+    convertDd,
+    convertHyperlinks,
+    convertCodeFences,
+    removeInlineMarkup,
+    removeTooManyEmptyLines
+];
+exports.md = {
+    md2plain(md, rootFolderDocs) {
+        md = includeContent(md, rootFolderDocs);
+        convertFunctions.forEach(convert => {
+            md = convert(md);
+        });
+        return md;
+    }
+};
+//# sourceMappingURL=md.js.map

package/dist/utils/packageManager.js

@@ -0,0 +1,66 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.packageManager = void 0;
+const packageCommands = {
+    npm: {
+        install: 'npm i -SE',
+        installDev: 'npm i -DE',
+        uninstall: 'npm un -S',
+        uninstallDev: 'npm un -D'
+    },
+    pnpm: {
+        install: 'pnpm i -E',
+        installDev: 'pnpm i -DE',
+        uninstall: 'pnpm un',
+        uninstallDev: 'pnpm un'
+    },
+    yarn: {
+        install: 'yarn add -E',
+        installDev: 'yarn add -DE',
+        uninstall: 'yarn remove',
+        uninstallDev: 'yarn remove'
+    }
+};
+exports.packageManager = {
+    getPackageManagerCommand(command, packageManager) {
+        return packageCommands[packageManager][command];
+    },
+    mapPackageManagerCommand({ command, packagesDepExact, packagesDevExact, packagesDepUn, packagesDevUn, packageMgr }) {
+        // matches must be in this particular order to avoid false matches, eg.
+        // uninstallDev contains install
+        if (command.startsWith(`${exports.packageManager.getPackageManagerCommand('uninstallDev', packageMgr)} `)) {
+            packagesDevUn.push(command.replace(exports.packageManager.getPackageManagerCommand('uninstallDev', packageMgr), '').trim());
+            return;
+        }
+        if (command.startsWith(`${exports.packageManager.getPackageManagerCommand('installDev', packageMgr)} `)) {
+            packagesDevExact.push(command.replace(exports.packageManager.getPackageManagerCommand('installDev', packageMgr), '').trim());
+            return;
+        }
+        if (command.startsWith(`${exports.packageManager.getPackageManagerCommand('uninstall', packageMgr)} `)) {
+            packagesDepUn.push(command.replace(exports.packageManager.getPackageManagerCommand('uninstall', packageMgr), '').trim());
+            return;
+        }
+        if (command.startsWith(`${exports.packageManager.getPackageManagerCommand('install', packageMgr)} `)) {
+            packagesDepExact.push(command.replace(exports.packageManager.getPackageManagerCommand('install', packageMgr), '').trim());
+        }
+    },
+    reducePackageManagerCommand({ packagesDepExact, packagesDevExact, packagesDepUn, packagesDevUn, packageMgr }) {
+        const commandsToExecute = [];
+        // uninstall commands must come first otherwise there is a chance that
+        // whatever we recommended to install, will be immediately uninstalled
+        if (packagesDepUn.length > 0) {
+            commandsToExecute.push(`${exports.packageManager.getPackageManagerCommand('uninstall', packageMgr)} ${packagesDepUn.join(' ')}`);
+        }
+        if (packagesDevUn.length > 0) {
+            commandsToExecute.push(`${exports.packageManager.getPackageManagerCommand('uninstallDev', packageMgr)} ${packagesDevUn.join(' ')}`);
+        }
+        if (packagesDepExact.length > 0) {
+            commandsToExecute.push(`${exports.packageManager.getPackageManagerCommand('install', packageMgr)} ${packagesDepExact.join(' ')}`);
+        }
+        if (packagesDevExact.length > 0) {
+            commandsToExecute.push(`${exports.packageManager.getPackageManagerCommand('installDev', packageMgr)} ${packagesDevExact.join(' ')}`);
+        }
+        return commandsToExecute;
+    }
+};
+//# sourceMappingURL=packageManager.js.map

package/dist/utils/spfx.js

@@ -3,18 +3,19 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.spfx = void 0;
 exports.spfx = {
     isReactProject(project) {
+        var _a, _b;
         return (typeof project.yoRcJson !== 'undefined' &&
             typeof project.yoRcJson['@microsoft/generator-sharepoint'] !== 'undefined' &&
-            project.yoRcJson["@microsoft/generator-sharepoint"].framework === 'react') ||
-            (typeof project.packageJson !== 'undefined' &&
-                typeof project.packageJson.dependencies['react'] !== 'undefined');
+            (project.yoRcJson["@microsoft/generator-sharepoint"].framework === 'react' ||
+                project.yoRcJson["@microsoft/generator-sharepoint"].template === 'react')) ||
+            typeof ((_b = (_a = project.packageJson) === null || _a === void 0 ? void 0 : _a.dependencies) === null || _b === void 0 ? void 0 : _b['react']) !== 'undefined';
     },
     isKnockoutProject(project) {
+        var _a, _b;
         return (typeof project.yoRcJson !== 'undefined' &&
             typeof project.yoRcJson['@microsoft/generator-sharepoint'] !== 'undefined' &&
             project.yoRcJson["@microsoft/generator-sharepoint"].framework === 'knockout') ||
-            (typeof project.packageJson !== 'undefined' &&
-                typeof project.packageJson.dependencies['knockout'] !== 'undefined');
+            typeof ((_b = (_a = project.packageJson) === null || _a === void 0 ? void 0 : _a.dependencies) === null || _b === void 0 ? void 0 : _b['knockout']) !== 'undefined';
     }
 };
 //# sourceMappingURL=spfx.js.map

package/dist/{m365/spfx/commands/project/project-upgrade/Hash.js → utils/types.js}

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

package/docs/docs/cmd/app/app-get.md

@@ -0,0 +1,36 @@
+# app get
+
+Retrieves information about the current Azure AD app
+
+## Usage
+
+```sh
+m365 app get [options]
+```
+
+## Options
+
+`--appId [appId]`
+: Client ID of the Azure AD app registered in the .m365rc.json file to retrieve information for
+
+--8<-- "docs/cmd/_global.md"
+
+## Remarks
+
+Use this command to quickly look up information for the Azure AD application registration registered in the .m365rc.json file in your current project (folder).
+
+If you have multiple apps registered in your .m365rc.json file, you can specify the app for which you'd like to retrieve permissions using the `--appId` option. If you don't specify the app using the `--appId` option, you'll be prompted to select one of the applications from your .m365rc.json file.
+
+## Examples
+
+Retrieve information about your current Azure AD app
+
+```sh
+m365 app get
+```
+
+Retrieve information about the Azure AD app with client ID _e23d235c-fcdf-45d1-ac5f-24ab2ee0695d_ specified in the _.m365rc.json_ file
+
+```sh
+m365 app get --appId e23d235c-fcdf-45d1-ac5f-24ab2ee0695d
+```