@pnp/cli-microsoft365 6.9.0-beta.289ab69 → 6.9.0-beta.3158148

package/dist/m365/tenant/commands/security/security-alerts-list.js

@@ -47,36 +47,35 @@ class TenantSecurityAlertsListCommand extends GraphCommand_1.default {
         });
     }
     listAlert(options) {
-        let queryFilter = '';
-        if (options.vendor) {
-            let vendorName = options.vendor;
-            switch (options.vendor.toLowerCase()) {
-                case 'azure security center':
-                    vendorName = 'ASC';
-                    break;
-                case 'microsoft cloud app security':
-                    vendorName = 'MCAS';
-                    break;
-                case 'azure active directory identity protection':
-                    vendorName = 'IPC';
+        return __awaiter(this, void 0, void 0, function* () {
+            let queryFilter = '';
+            if (options.vendor) {
+                let vendorName = options.vendor;
+                switch (options.vendor.toLowerCase()) {
+                    case 'azure security center':
+                        vendorName = 'ASC';
+                        break;
+                    case 'microsoft cloud app security':
+                        vendorName = 'MCAS';
+                        break;
+                    case 'azure active directory identity protection':
+                        vendorName = 'IPC';
+                }
+                queryFilter = `?$filter=vendorInformation/provider eq '${formatting_1.formatting.encodeQueryParameter(vendorName)}'`;
             }
-            queryFilter = `?$filter=vendorInformation/provider eq '${formatting_1.formatting.encodeQueryParameter(vendorName)}'`;
-        }
-        const requestOptions = {
-            url: `${this.resource}/v1.0/security/alerts${queryFilter}`,
-            headers: {
-                accept: 'application/json;odata.metadata=none'
-            },
-            responseType: 'json'
-        };
-        return request_1.default
-            .get(requestOptions)
-            .then(response => {
+            const requestOptions = {
+                url: `${this.resource}/v1.0/security/alerts${queryFilter}`,
+                headers: {
+                    accept: 'application/json;odata.metadata=none'
+                },
+                responseType: 'json'
+            };
+            const response = yield request_1.default.get(requestOptions);
             const alertList = response.value;
             if (!alertList) {
-                return Promise.reject(`Error fetching security alerts`);
+                throw `Error fetching security alerts`;
             }
-            return Promise.resolve(alertList);
+            return alertList;
         });
     }
 }

package/dist/m365/tenant/commands/serviceannouncement/serviceannouncement-health-list.js

@@ -37,8 +37,8 @@ class TenantServiceAnnouncementHealthListCommand extends GraphCommand_1.default
     commandAction(logger, args) {
         return __awaiter(this, void 0, void 0, function* () {
             try {
-                const res = yield this.listServiceHealth(args.options);
-                logger.log(res);
+                const response = yield this.listServiceHealth(args.options);
+                logger.log(response);
             }
             catch (err) {
                 this.handleRejectedODataJsonPromise(err);
@@ -46,21 +46,20 @@ class TenantServiceAnnouncementHealthListCommand extends GraphCommand_1.default
         });
     }
     listServiceHealth(options) {
-        const requestOptions = {
-            url: `${this.resource}/v1.0/admin/serviceAnnouncement/healthOverviews${options.issues && (!options.output || options.output.toLocaleLowerCase() === 'json') ? '?$expand=issues' : ''}`,
-            headers: {
-                accept: 'application/json;odata.metadata=none'
-            },
-            responseType: 'json'
-        };
-        return request_1.default
-            .get(requestOptions)
-            .then(response => {
+        return __awaiter(this, void 0, void 0, function* () {
+            const requestOptions = {
+                url: `${this.resource}/v1.0/admin/serviceAnnouncement/healthOverviews${options.issues && (!options.output || options.output.toLocaleLowerCase() === 'json') ? '?$expand=issues' : ''}`,
+                headers: {
+                    accept: 'application/json;odata.metadata=none'
+                },
+                responseType: 'json'
+            };
+            const response = yield request_1.default.get(requestOptions);
             const serviceHealthList = response.value;
             if (!serviceHealthList) {
-                return Promise.reject(`Error fetching service health`);
+                throw `Error fetching service health`;
             }
-            return Promise.resolve(serviceHealthList);
+            return serviceHealthList;
         });
     }
 }

package/dist/m365/todo/commands/list/list-remove.js

@@ -35,42 +35,8 @@ class TodoListRemoveCommand extends GraphCommand_1.default {
     }
     commandAction(logger, args) {
         return __awaiter(this, void 0, void 0, function* () {
-            const getListId = () => __awaiter(this, void 0, void 0, function* () {
-                if (args.options.name) {
-                    // Search list by its name
-                    const requestOptions = {
-                        url: `${this.resource}/v1.0/me/todo/lists?$filter=displayName eq '${escape(args.options.name)}'`,
-                        headers: {
-                            accept: "application/json;odata.metadata=none"
-                        },
-                        responseType: 'json'
-                    };
-                    const response = yield request_1.default.get(requestOptions);
-                    return response.value && response.value.length === 1 ? response.value[0].id : null;
-                }
-                return args.options.id;
-            });
-            const removeList = () => __awaiter(this, void 0, void 0, function* () {
-                try {
-                    const listId = yield getListId();
-                    if (!listId) {
-                        return Promise.reject(`The list ${args.options.name} cannot be found`);
-                    }
-                    const requestOptions = {
-                        url: `${this.resource}/v1.0/me/todo/lists/${listId}`,
-                        headers: {
-                            accept: "application/json;odata.metadata=none"
-                        },
-                        responseType: 'json'
-                    };
-                    yield request_1.default.delete(requestOptions);
-                }
-                catch (err) {
-                    this.handleRejectedODataJsonPromise(err);
-                }
-            });
             if (args.options.confirm) {
-                yield removeList();
+                yield this.removeList(args);
             }
             else {
                 const result = yield Cli_1.Cli.prompt({
@@ -80,11 +46,48 @@ class TodoListRemoveCommand extends GraphCommand_1.default {
                     message: `Are you sure you want to remove the task list ${args.options.id || args.options.name}?`
                 });
                 if (result.continue) {
-                    yield removeList();
+                    yield this.removeList(args);
                 }
             }
         });
     }
+    getListId(args) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (args.options.id) {
+                return args.options.id;
+            }
+            const requestOptions = {
+                url: `${this.resource}/v1.0/me/todo/lists?$filter=displayName eq '${escape(args.options.name)}'`,
+                headers: {
+                    accept: "application/json;odata.metadata=none"
+                },
+                responseType: 'json'
+            };
+            const response = yield request_1.default.get(requestOptions);
+            return response.value && response.value.length === 1 ? response.value[0].id : null;
+        });
+    }
+    removeList(args) {
+        return __awaiter(this, void 0, void 0, function* () {
+            try {
+                const listId = yield this.getListId(args);
+                if (!listId) {
+                    throw `The list ${args.options.name} cannot be found`;
+                }
+                const requestOptions = {
+                    url: `${this.resource}/v1.0/me/todo/lists/${listId}`,
+                    headers: {
+                        accept: "application/json;odata.metadata=none"
+                    },
+                    responseType: 'json'
+                };
+                yield request_1.default.delete(requestOptions);
+            }
+            catch (err) {
+                this.handleRejectedODataJsonPromise(err);
+            }
+        });
+    }
 }
 _TodoListRemoveCommand_instances = new WeakSet(), _TodoListRemoveCommand_initTelemetry = function _TodoListRemoveCommand_initTelemetry() {
     this.telemetry.push((args) => {

package/dist/m365/todo/commands/list/list-set.js

@@ -60,20 +60,22 @@ class TodoListSetCommand extends GraphCommand_1.default {
         });
     }
     getListId(args) {
-        const endpoint = `${this.resource}/v1.0`;
-        if (args.options.id) {
-            return Promise.resolve(args.options.id);
-        }
-        const requestOptions = {
-            url: `${endpoint}/me/todo/lists?$filter=displayName eq '${escape(args.options.name)}'`,
-            headers: {
-                accept: "application/json;odata.metadata=none"
-            },
-            responseType: 'json'
-        };
-        return request_1.default
-            .get(requestOptions)
-            .then((response) => response.value && response.value.length === 1 ? response.value[0].id : null);
+        return __awaiter(this, void 0, void 0, function* () {
+            const endpoint = `${this.resource}/v1.0`;
+            if (args.options.id) {
+                return args.options.id;
+            }
+            const requestOptions = {
+                url: `${endpoint}/me/todo/lists?$filter=displayName eq '${escape(args.options.name)}'`,
+                headers: {
+                    accept: "application/json;odata.metadata=none"
+                },
+                responseType: 'json'
+            };
+            return request_1.default
+                .get(requestOptions)
+                .then((response) => response.value && response.value.length === 1 ? response.value[0].id : null);
+        });
     }
 }
 _TodoListSetCommand_instances = new WeakSet(), _TodoListSetCommand_initTelemetry = function _TodoListSetCommand_initTelemetry() {

package/dist/m365/todo/commands/task/task-add.js

@@ -81,23 +81,23 @@ class TodoTaskAddCommand extends GraphCommand_1.default {
         };
     }
     getTodoListId(args) {
-        if (args.options.listId) {
-            return Promise.resolve(args.options.listId);
-        }
-        const requestOptions = {
-            url: `${this.resource}/v1.0/me/todo/lists?$filter=displayName eq '${escape(args.options.listName)}'`,
-            headers: {
-                accept: 'application/json;odata.metadata=none'
-            },
-            responseType: 'json'
-        };
-        return request_1.default.get(requestOptions)
-            .then(response => {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (args.options.listId) {
+                return args.options.listId;
+            }
+            const requestOptions = {
+                url: `${this.resource}/v1.0/me/todo/lists?$filter=displayName eq '${escape(args.options.listName)}'`,
+                headers: {
+                    accept: 'application/json;odata.metadata=none'
+                },
+                responseType: 'json'
+            };
+            const response = yield request_1.default.get(requestOptions);
             const taskList = response.value[0];
             if (!taskList) {
-                return Promise.reject(`The specified task list does not exist`);
+                throw `The specified task list does not exist`;
             }
-            return Promise.resolve(taskList.id);
+            return taskList.id;
         });
     }
 }

package/dist/m365/util/commands/accesstoken/accesstoken-get.js

@@ -34,15 +34,18 @@ class UtilAccessTokenGetCommand extends Command_1.default {
     commandAction(logger, args) {
         return __awaiter(this, void 0, void 0, function* () {
             let resource = args.options.resource;
-            if (resource.toLowerCase() === 'sharepoint') {
-                if (Auth_1.default.service.spoUrl) {
-                    resource = Auth_1.default.service.spoUrl;
+            try {
+                if (resource.toLowerCase() === 'sharepoint') {
+                    if (Auth_1.default.service.spoUrl) {
+                        resource = Auth_1.default.service.spoUrl;
+                    }
+                    else {
+                        throw `SharePoint URL undefined. Use the 'm365 spo set --url https://contoso.sharepoint.com' command to set the URL`;
+                    }
                 }
-                else {
-                    throw `SharePoint URL undefined. Use the 'm365 spo set --url https://contoso.sharepoint.com' command to set the URL`;
+                else if (resource.toLowerCase() === 'graph') {
+                    resource = Auth_1.Auth.getEndpointForResource('https://graph.microsoft.com', Auth_1.default.service.cloudType);
                 }
-            }
-            try {
                 const accessToken = yield Auth_1.default.ensureAccessToken(resource, logger, this.debug, args.options.new);
                 logger.log(accessToken);
             }

package/dist/utils/browserUtil.js

@@ -0,0 +1,23 @@
+"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.browserUtil = void 0;
+exports.browserUtil = {
+    /* c8 ignore next 5 */
+    open(url) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const _open = require('open');
+            const runningOnWindows = process.platform === 'win32';
+            yield _open(url, { wait: runningOnWindows });
+        });
+    }
+};
+//# sourceMappingURL=browserUtil.js.map

package/dist/utils/md.js

@@ -16,15 +16,18 @@ function convertHeadings(md) {
     });
 }
 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;
-    });
+    const regex = new RegExp(/^:::(\w+)([\s\S]*?):::$/, 'gm');
+    return md.replace(regex, (_, label, content) => label.toLocaleUpperCase() + os_1.EOL + os_1.EOL + content.trim());
 }
 function includeContent(md, rootFolder) {
-    return md.replace(/^--8<-- "([^"]+)"/gm, (match, filePath) => {
-        return fs.readFileSync(path.join(rootFolder, filePath), 'utf8');
+    const mdxImports = [
+        { tag: "<Global />", location: "docs/cmd/_global.mdx" },
+        { tag: "<CLISettings />", location: "docs/_clisettings.mdx" }
+    ];
+    mdxImports.forEach(mdxImport => {
+        md = md.replace(mdxImport.tag, () => fs.readFileSync(path.join(rootFolder, mdxImport.location), 'utf8')).replace(/(```\r\n)\r\n(```md definition-list\r\n)/g, "$1$2");
     });
+    return md;
 }
 function convertDd(md) {
     return md.replace(/^:\s(.*)/gm, (match, content) => {
@@ -47,16 +50,11 @@ function convertHyperlinks(md) {
     });
 }
 function convertContentTabs(md) {
-    const regex = new RegExp('^=== "(.+?)"(?:\r\n|\n){2}((?:^    (?:.*?(?:\r\n|\n))?)+)', 'gms');
-    return md.replace(regex, (match, title, content) => {
-        return `  ${title}${os_1.EOL}${os_1.EOL}${content.replace(/^    /gms, '')}`;
-    });
-}
-function convertMdOutput(md) {
-    const regex = new RegExp('(?<=^    ```md)(.*)(?=    ```)', 'gms');
-    return md.replace(regex, (match, content) => {
-        return content.replace(/^    /gms, '');
-    });
+    return md
+        .replace(/<TabItem value="([^"]+)">/gm, '$1')
+        .replace(/.*<\/?(Tabs|TabItem)>.*\n?/g, '')
+        .replace(/```(?:\w+)?\s*([\s\S]*?)\s*```/g, '$1')
+        .trim();
 }
 function convertCodeFences(md) {
     const regex = new RegExp('^```.*?(?:\r\n|\n)(.*?)```(?:\r\n|\n)', 'gms');
@@ -72,6 +70,12 @@ function removeTooManyEmptyLines(md) {
     const regex = new RegExp('(' + os_1.EOL + '){4,}', 'g');
     return md.replace(regex, Array(4).join(os_1.EOL));
 }
+function removeFrontmatter(md) {
+    return md.replace(/^---[\s\S]*?---/gm, '').trim();
+}
+function removeImports(md) {
+    return md.replace(/^import .+;$/gms, '').trim();
+}
 function escapeMd(mdString) {
     if (!mdString) {
         return mdString;
@@ -86,11 +90,12 @@ const convertFunctions = [
     convertAdmonitions,
     convertDd,
     convertHyperlinks,
-    convertMdOutput,
-    convertContentTabs,
     convertCodeFences,
+    convertContentTabs,
     removeInlineMarkup,
-    removeTooManyEmptyLines
+    removeTooManyEmptyLines,
+    removeFrontmatter,
+    removeImports
 ];
 exports.md = {
     md2plain(md, rootFolderDocs) {

package/dist/utils/spo.js

@@ -568,6 +568,66 @@ exports.spo = {
             const res = yield request_1.default.get(requestOptions);
             return res.AadObjectId.NameId;
         });
+    },
+    /**
+     * Retrieves the menu state for the quick launch.
+     * @param webUrl Web url
+     */
+    getQuickLaunchMenuState(webUrl) {
+        return __awaiter(this, void 0, void 0, function* () {
+            return this.getMenuState(webUrl);
+        });
+    },
+    /**
+     * Retrieves the menu state for the top navigation.
+     * @param webUrl Web url
+     */
+    getTopNavigationMenuState(webUrl) {
+        return __awaiter(this, void 0, void 0, function* () {
+            return this.getMenuState(webUrl, '1002');
+        });
+    },
+    /**
+     * Retrieves the menu state.
+     * @param webUrl Web url
+     * @param menuNodeKey Menu node key
+     */
+    getMenuState(webUrl, menuNodeKey) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const requestBody = {
+                customProperties: null,
+                depth: 10,
+                mapProviderName: null,
+                menuNodeKey: menuNodeKey || null
+            };
+            const requestOptions = {
+                url: `${webUrl}/_api/navigation/MenuState`,
+                headers: {
+                    accept: 'application/json;odata=nometadata'
+                },
+                data: requestBody,
+                responseType: 'json'
+            };
+            return request_1.default.post(requestOptions);
+        });
+    },
+    /**
+    * Saves the menu state.
+    * @param webUrl Web url
+    * @param menuState Updated menu state
+    */
+    saveMenuState(webUrl, menuState) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const requestOptions = {
+                url: `${webUrl}/_api/navigation/SaveMenuState`,
+                headers: {
+                    accept: 'application/json;odata=nometadata'
+                },
+                data: { menuState: menuState },
+                responseType: 'json'
+            };
+            return request_1.default.post(requestOptions);
+        });
     }
 };
 //# sourceMappingURL=spo.js.map

package/docs/docs/cmd/_global.mdx

@@ -0,0 +1,16 @@
+```md definition-list
+`-h, --help [help]`
+: Output usage information. Optionally, specify which section of command's help you want to see. Allowed values are `options`, `examples`, `remarks`, `response`, `full`. Default is `full`.
+
+`--query [query]`
+: JMESPath query string. See [http://jmespath.org/](http://jmespath.org/) for more information and examples.
+
+`-o, --output [output]`
+: Output type. `json`, `text`, `csv`, `md`. Default `json`.
+
+`--verbose`
+: Runs command with verbose logging.
+
+`--debug`
+: Runs command with debug logging.
+```