@pnp/cli-microsoft365 5.1.0-beta.efe1dcb → 5.2.0-beta.0f1c454

package/dist/m365/spo/commands/app/app-teamspackage-download.js

@@ -0,0 +1,180 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const fs = require("fs");
+const path = require("path");
+const request_1 = require("../../../../request");
+const urlUtil_1 = require("../../../../utils/urlUtil");
+const spo_1 = require("../../../../utils/spo");
+const validation_1 = require("../../../../utils/validation");
+const commands_1 = require("../../commands");
+const SpoAppBaseCommand_1 = require("./SpoAppBaseCommand");
+class SpoAppTeamsPackageDownloadCommand extends SpoAppBaseCommand_1.SpoAppBaseCommand {
+    get name() {
+        return commands_1.default.APP_TEAMSPACKAGE_DOWNLOAD;
+    }
+    get description() {
+        return 'Downloads Teams app package for an SPFx solution deployed to tenant app catalog';
+    }
+    getTelemetryProperties(args) {
+        const telemetryProps = super.getTelemetryProperties(args);
+        telemetryProps.appCatalogUrl = typeof args.options.appCatalogUrl !== 'undefined';
+        telemetryProps.appItemUniqueId = typeof args.options.appItemUniqueId !== 'undefined';
+        telemetryProps.appItemId = typeof args.options.appItemId !== 'undefined';
+        telemetryProps.appName = typeof args.options.appName !== 'undefined';
+        telemetryProps.fileName = typeof args.options.fileName !== 'undefined';
+        return telemetryProps;
+    }
+    commandAction(logger, args, cb) {
+        var _a, _b;
+        this.appCatalogUrl = args.options.appCatalogUrl;
+        const appInfo = {
+            id: (_a = args.options.appItemId) !== null && _a !== void 0 ? _a : undefined,
+            packageFileName: (_b = args.options.fileName) !== null && _b !== void 0 ? _b : undefined
+        };
+        if (this.debug) {
+            logger.logToStderr(`appInfo: ${JSON.stringify(appInfo)}`);
+        }
+        this
+            .ensureAppInfo(logger, args, appInfo)
+            .then(_ => {
+            if (this.debug) {
+                logger.logToStderr(`ensureAppInfo: ${JSON.stringify(appInfo)}`);
+            }
+            return this.loadAppCatalogUrl(logger, args);
+        })
+            .then(_ => {
+            const requestOptions = {
+                url: `${this.appCatalogUrl}/_api/web/tenantappcatalog/downloadteamssolution(${appInfo.id})/$value`,
+                headers: {
+                    accept: 'application/json;odata=nometadata'
+                },
+                responseType: 'stream'
+            };
+            return request_1.default.get(requestOptions);
+        })
+            .then((file) => {
+            return new Promise((resolve, reject) => {
+                const writer = fs.createWriteStream(appInfo.packageFileName);
+                file.data.pipe(writer);
+                writer.on('error', err => {
+                    reject(err);
+                });
+                writer.on('close', () => {
+                    resolve(appInfo.packageFileName);
+                });
+            });
+        })
+            .then((file) => {
+            if (this.verbose) {
+                logger.logToStderr(`Package saved to ${file}`);
+            }
+            cb();
+        }, (err) => this.handleRejectedODataJsonPromise(err, logger, cb));
+    }
+    ensureAppInfo(logger, args, appInfo) {
+        if (appInfo.id && appInfo.packageFileName) {
+            return Promise.resolve();
+        }
+        if (args.options.appName && !appInfo.packageFileName) {
+            appInfo.packageFileName = this.getPackageNameFromFileName(args.options.appName);
+        }
+        return this
+            .loadAppCatalogUrl(logger, args)
+            .then(_ => {
+            const appCatalogListName = 'AppCatalog';
+            const serverRelativeAppCatalogListUrl = `${urlUtil_1.urlUtil.getServerRelativeSiteUrl(this.appCatalogUrl)}/${appCatalogListName}`;
+            let url = `${this.appCatalogUrl}/_api/web/`;
+            if (args.options.appItemUniqueId) {
+                url += `GetList('${serverRelativeAppCatalogListUrl}')/GetItemByUniqueId('${args.options.appItemUniqueId}')?$expand=File&$select=Id,File/Name`;
+            }
+            else if (args.options.appItemId) {
+                url += `GetList('${serverRelativeAppCatalogListUrl}')/GetItemById(${args.options.appItemId})?$expand=File&$select=File/Name`;
+            }
+            else if (args.options.appName) {
+                url += `getfolderbyserverrelativeurl('${appCatalogListName}')/files('${encodeURIComponent(args.options.appName)}')/ListItemAllFields?$select=Id`;
+            }
+            const requestOptions = {
+                url,
+                headers: {
+                    accept: 'application/json;odata=nometadata'
+                },
+                responseType: 'json'
+            };
+            return request_1.default.get(requestOptions);
+        })
+            .then(res => {
+            if (args.options.appItemUniqueId) {
+                appInfo.id = parseInt(res.Id);
+                if (!appInfo.packageFileName) {
+                    appInfo.packageFileName = this.getPackageNameFromFileName(res.File.Name);
+                }
+                return Promise.resolve();
+            }
+            if (args.options.appItemId) {
+                if (!appInfo.packageFileName) {
+                    appInfo.packageFileName = this.getPackageNameFromFileName(res.File.Name);
+                }
+                return Promise.resolve();
+            }
+            // if (args.options.appName)
+            // skipped 'if' clause to provide a default code branch
+            appInfo.id = parseInt(res.Id);
+            return Promise.resolve();
+        });
+    }
+    getPackageNameFromFileName(fileName) {
+        return `${path.basename(fileName, path.extname(fileName))}.zip`;
+    }
+    loadAppCatalogUrl(logger, args) {
+        if (this.appCatalogUrl) {
+            return Promise.resolve();
+        }
+        return spo_1.spo
+            .getSpoUrl(logger, this.debug)
+            .then(spoUrl => this.getAppCatalogSiteUrl(logger, spoUrl, args))
+            .then(appCatalogUrl => {
+            this.appCatalogUrl = appCatalogUrl;
+        });
+    }
+    options() {
+        const options = [
+            { option: '--appItemId [appItemId]' },
+            { option: '--appItemUniqueId [appItemUniqueId]' },
+            { option: '--appName [appName]' },
+            { option: '--fileName [fileName]' },
+            { option: '-u, --appCatalogUrl [appCatalogUrl]' }
+        ];
+        const parentOptions = super.options();
+        return options.concat(parentOptions);
+    }
+    validate(args) {
+        if (!args.options.appItemUniqueId &&
+            !args.options.appItemId &&
+            !args.options.appName) {
+            return `Specify appItemUniqueId, appItemId or appName`;
+        }
+        if ((args.options.appItemUniqueId && args.options.appItemId) ||
+            (args.options.appItemUniqueId && args.options.appName) ||
+            (args.options.appItemId && args.options.appName)) {
+            return `Specify appItemUniqueId, appItemId or appName but not multiple`;
+        }
+        if (args.options.appItemUniqueId &&
+            !validation_1.validation.isValidGuid(args.options.appItemUniqueId)) {
+            return `${args.options.appItemUniqueId} is not a valid GUID`;
+        }
+        if (args.options.appItemId &&
+            isNaN(args.options.appItemId)) {
+            return `${args.options.appItemId} is not a number`;
+        }
+        if (args.options.fileName &&
+            fs.existsSync(args.options.fileName)) {
+            return `File ${args.options.fileName} already exists`;
+        }
+        if (args.options.appCatalogUrl) {
+            return validation_1.validation.isValidSharePointUrl(args.options.appCatalogUrl);
+        }
+        return true;
+    }
+}
+module.exports = new SpoAppTeamsPackageDownloadCommand();
+//# sourceMappingURL=app-teamspackage-download.js.map

package/dist/m365/spo/commands/site/site-recyclebinitem-restore.js

@@ -0,0 +1,66 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const request_1 = require("../../../../request");
+const utils_1 = require("../../../../utils");
+const SpoCommand_1 = require("../../../base/SpoCommand");
+const commands_1 = require("../../commands");
+class SpoSiteRecycleBinItemRestoreCommand extends SpoCommand_1.default {
+    get name() {
+        return commands_1.default.SITE_RECYCLEBINITEM_RESTORE;
+    }
+    get description() {
+        return 'Restores given items from the site recycle bin';
+    }
+    commandAction(logger, args, cb) {
+        if (this.verbose) {
+            logger.logToStderr(`Restoring items from recycle bin at ${args.options.siteUrl}...`);
+        }
+        const requestUrl = `${args.options.siteUrl}/_api/site/RecycleBin/RestoreByIds`;
+        const ids = utils_1.formatting.splitAndTrim(args.options.ids);
+        const idsChunks = [];
+        while (ids.length) {
+            idsChunks.push(ids.splice(0, 20));
+        }
+        Promise.all(idsChunks.map((idsChunk) => {
+            const requestOptions = {
+                url: requestUrl,
+                headers: {
+                    'accept': 'application/json;odata=nometadata',
+                    'content-type': 'application/json'
+                },
+                responseType: 'json',
+                data: {
+                    ids: idsChunk
+                }
+            };
+            return request_1.default.post(requestOptions);
+        })).then(_ => cb(), (rawRes) => this.handleRejectedODataJsonPromise(rawRes, logger, cb));
+    }
+    options() {
+        const options = [
+            {
+                option: '-u, --siteUrl <siteUrl>'
+            },
+            {
+                option: '-i, --ids <ids>'
+            }
+        ];
+        const parentOptions = super.options();
+        return options.concat(parentOptions);
+    }
+    validate(args) {
+        const isValidSharePointUrl = utils_1.validation.isValidSharePointUrl(args.options.siteUrl);
+        if (isValidSharePointUrl !== true) {
+            return isValidSharePointUrl;
+        }
+        const invalidIds = utils_1.formatting
+            .splitAndTrim(args.options.ids)
+            .filter(id => !utils_1.validation.isValidGuid(id));
+        if (invalidIds.length > 0) {
+            return `The following IDs are invalid: ${invalidIds.join(', ')}`;
+        }
+        return true;
+    }
+}
+module.exports = new SpoSiteRecycleBinItemRestoreCommand();
+//# sourceMappingURL=site-recyclebinitem-restore.js.map

package/dist/m365/spo/commands.js

@@ -10,6 +10,7 @@ exports.default = {
     APP_LIST: `${prefix} app list`,
     APP_REMOVE: `${prefix} app remove`,
     APP_RETRACT: `${prefix} app retract`,
+    APP_TEAMSPACKAGE_DOWNLOAD: `${prefix} app teamspackage download`,
     APP_UNINSTALL: `${prefix} app uninstall`,
     APP_UPGRADE: `${prefix} app upgrade`,
     APPPAGE_ADD: `${prefix} apppage add`,
@@ -185,6 +186,7 @@ exports.default = {
     SITE_LIST: `${prefix} site list`,
     SITE_INPLACERECORDSMANAGEMENT_SET: `${prefix} site inplacerecordsmanagement set`,
     SITE_RECYCLEBINITEM_LIST: `${prefix} site recyclebinitem list`,
+    SITE_RECYCLEBINITEM_RESTORE: `${prefix} site recyclebinitem restore`,
     SITE_REMOVE: `${prefix} site remove`,
     SITE_RENAME: `${prefix} site rename`,
     SITE_SET: `${prefix} site set`,

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

@@ -20,21 +20,22 @@ class TeamsChatMessageSendCommand extends GraphCommand_1.default {
         return commands_1.default.CHAT_MESSAGE_SEND;
     }
     get description() {
-        return 'Send a message to an existing or new chat conversation.';
+        return 'Sends a chat message to a Microsoft Teams chat conversation.';
+    }
+    getTelemetryProperties(args) {
+        const telemetryProps = super.getTelemetryProperties(args);
+        telemetryProps.chatId = typeof args.options.chatId !== 'undefined';
+        telemetryProps.userEmails = typeof args.options.userEmails !== 'undefined';
+        telemetryProps.chatName = typeof args.options.chatName !== 'undefined';
+        return telemetryProps;
     }
     commandAction(logger, args, cb) {
-        return __awaiter(this, void 0, void 0, function* () {
-            try {
-                const chatId = args.options.chatId
-                    || args.options.userEmails && (yield this.ensureChatIdByUserEmails(args.options.userEmails))
-                    || args.options.chatName && (yield this.getChatIdByName(args.options.chatName));
-                yield this.sendChatMessage(chatId, args.options);
-                cb();
-            }
-            catch (error) {
-                this.handleRejectedODataJsonPromise(error, logger, cb);
-            }
-        });
+        this
+            .getChatId(logger, args)
+            .then(chatId => this.sendChatMessage(chatId, args))
+            .then(_ => {
+            cb();
+        }, (err) => this.handleRejectedODataJsonPromise(err, logger, cb));
     }
     options() {
         const options = [
@@ -78,36 +79,44 @@ class TeamsChatMessageSendCommand extends GraphCommand_1.default {
             return `${args.options.chatId} is not a valid Teams ChatId.`;
         }
         if (args.options.userEmails) {
-            const userEmails = args.options.userEmails.toLowerCase().replace(/\s/g, '').split(',').filter(e => e && e !== '');
+            const userEmails = this.convertCommaSeparatedListToArray(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.`;
             }
         }
         return true;
     }
-    ensureChatIdByUserEmails(userEmailsOption) {
+    getChatId(logger, args) {
         return __awaiter(this, void 0, void 0, function* () {
-            const userEmails = userEmailsOption.toLowerCase().replace(/\s/g, '').split(',').filter(e => e && e !== '');
+            if (args.options.chatId) {
+                return args.options.chatId;
+            }
+            return args.options.userEmails
+                ? this.ensureChatIdByUserEmails(args.options.userEmails, logger)
+                : this.getChatIdByName(args.options.chatName, logger);
+        });
+    }
+    ensureChatIdByUserEmails(userEmailsOption, logger) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const userEmails = this.convertCommaSeparatedListToArray(userEmailsOption);
             const currentUserEmail = utils_1.accessToken.getUserNameFromAccessToken(Auth_1.default.service.accessTokens[this.resource].accessToken).toLowerCase();
-            const existingChats = yield this.findExistingGroupChatsByMembers([currentUserEmail, ...userEmails]);
-            if (existingChats && existingChats.length > 0) {
-                if (existingChats.length > 1) {
-                    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 this topic found. Please disambiguate:${os.EOL}${disambiguationText}`);
-                }
-                else {
-                    return existingChats[0].id;
-                }
+            const existingChats = yield this.findExistingGroupChatsByMembers([currentUserEmail, ...userEmails], logger);
+            if (!existingChats || existingChats.length === 0) {
+                const chat = yield this.createConversation([currentUserEmail, ...userEmails]);
+                return chat.id;
             }
-            const chat = yield this.createConversation([currentUserEmail, ...userEmails]);
-            return chat.id;
+            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 this name found. Please disambiguate:${os.EOL}${disambiguationText}`);
         });
     }
-    getChatIdByName(chatName) {
+    getChatIdByName(chatName, logger) {
         return __awaiter(this, void 0, void 0, function* () {
-            const existingChats = yield this.findExistingGroupChatsByTopic(chatName);
+            const existingChats = yield this.findExistingGroupChatsByName(chatName, logger);
             if (!existingChats || existingChats.length === 0) {
                 throw new Error('No chat conversation was found with this name.');
             }
@@ -118,7 +127,7 @@ class TeamsChatMessageSendCommand extends GraphCommand_1.default {
                 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 topic found. Please disambiguate:${os.EOL}${disambiguationText}`);
+            throw new Error(`Multiple chat conversations with this name found. Please disambiguate:${os.EOL}${disambiguationText}`);
         });
     }
     // This Microsoft Graph API request throws an intermittent 404 exception, saying that it cannot find the principal.
@@ -159,7 +168,7 @@ class TeamsChatMessageSendCommand extends GraphCommand_1.default {
             }
         });
     }
-    sendChatMessage(chatId, options) {
+    sendChatMessage(chatId, args) {
         return __awaiter(this, void 0, void 0, function* () {
             const requestOptions = {
                 url: `${this.resource}/v1.0/chats/${chatId}/messages`,
@@ -170,18 +179,18 @@ class TeamsChatMessageSendCommand extends GraphCommand_1.default {
                 responseType: 'json',
                 data: {
                     body: {
-                        content: options.message
+                        content: args.options.message
                     }
                 }
             };
             yield request_1.default.post(requestOptions);
         });
     }
-    findExistingGroupChatsByMembers(expectedMemberEmails) {
+    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 this.getAllChats(endpoint, []);
+            const chats = yield utils_1.odata.getAllItems(endpoint, logger);
             for (const chat of chats) {
                 const chatMembers = chat.members;
                 if (chatMembers.length === expectedMemberEmails.length) {
@@ -194,31 +203,14 @@ class TeamsChatMessageSendCommand extends GraphCommand_1.default {
             return foundChats;
         });
     }
-    findExistingGroupChatsByTopic(topic) {
+    findExistingGroupChatsByName(name, logger) {
         return __awaiter(this, void 0, void 0, function* () {
-            const endpoint = `${this.resource}/v1.0/chats?$filter=topic eq '${encodeURIComponent(topic)}'&$expand=members&$select=id,topic,createdDateTime,chatType`;
-            const chats = yield this.getAllChats(endpoint, []);
-            return chats;
+            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);
         });
     }
-    getAllChats(url, items) {
-        return __awaiter(this, void 0, void 0, function* () {
-            const requestOptions = {
-                url: url,
-                headers: {
-                    accept: 'application/json;odata.metadata=none'
-                },
-                responseType: 'json'
-            };
-            const res = yield request_1.default.get(requestOptions);
-            items = items.concat(res.value);
-            if (res['@odata.nextLink']) {
-                return yield this.getAllChats(res['@odata.nextLink'], items);
-            }
-            else {
-                return items;
-            }
-        });
+    convertCommaSeparatedListToArray(userEmailsString) {
+        return userEmailsString.toLowerCase().replace(/\s/g, '').split(',').filter(e => e && e !== '');
     }
 }
 module.exports = new TeamsChatMessageSendCommand();

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',
@@ -11,6 +12,7 @@ const settingsNames = {
     errorOutput: 'errorOutput',
     output: 'output',
     printErrorsAsPlainText: 'printErrorsAsPlainText',
+    prompt: 'prompt',
     showHelpOnFailure: 'showHelpOnFailure'
 };
 exports.settingsNames = settingsNames;

package/dist/utils/formatting.js

@@ -61,6 +61,9 @@ exports.formatting = {
     },
     removeSingleLineComments(s) {
         return stripJsonComments(s);
+    },
+    splitAndTrim(s) {
+        return s.split(',').map(c => c.trim());
     }
 };
 //# sourceMappingURL=formatting.js.map

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

@@ -1,7 +1,11 @@
 "use strict";
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
-    Object.defineProperty(o, k2, { enumerable: true, get: function() { return m[k]; } });
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
 }) : (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
     o[k2] = m[k];
@@ -14,9 +18,11 @@ __exportStar(require("./accessToken"), exports);
 __exportStar(require("./formatting"), exports);
 __exportStar(require("./fsUtil"), 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/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