@pnp/cli-microsoft365 6.0.0-beta.ff232be → 6.1.0-beta.11542c0

package/dist/request.js

@@ -3,47 +3,9 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const axios_1 = require("axios");
 const stream_1 = require("stream");
 const Auth_1 = require("./Auth");
-const utils_1 = require("./utils");
+const formatting_1 = require("./utils/formatting");
 const packageJSON = require('../package.json');
 class Request {
-    constructor() {
-        this._debug = false;
-        this.req = axios_1.default.create({
-            headers: {
-                'user-agent': `NONISV|SharePointPnP|CLIMicrosoft365/${packageJSON.version}`,
-                'accept-encoding': 'gzip, deflate'
-            },
-            decompress: true,
-            responseType: 'text',
-            /* c8 ignore next */
-            transformResponse: [data => data],
-            maxBodyLength: Infinity,
-            maxContentLength: Infinity
-        });
-        // since we're stubbing requests, request interceptor is never called in
-        // tests, so let's exclude it from coverage
-        /* c8 ignore next 7 */
-        this.req.interceptors.request.use((config) => {
-            if (config.responseType === 'json') {
-                config.transformResponse = axios_1.default.defaults.transformResponse;
-            }
-            return config;
-        });
-        // since we're stubbing requests, response interceptor is never called in
-        // tests, so let's exclude it from coverage
-        /* c8 ignore next 15 */
-        this.req.interceptors.response.use((response) => response, (error) => {
-            if (error &&
-                error.response &&
-                error.response.data &&
-                !(error.response.data instanceof stream_1.Stream)) {
-                // move error details from response.data to error property to make
-                // it compatible with our code
-                error.error = JSON.parse(JSON.stringify(error.response.data));
-            }
-            throw error;
-        });
-    }
     set debug(debug) {
         // if the value to set is the same as current value return early to avoid
         // instantiating interceptors multiple times. This can happen when calling
@@ -60,7 +22,7 @@ class Request {
                     if (config.responseType !== 'stream') {
                         properties.push('data');
                     }
-                    this._logger.logToStderr(JSON.stringify(utils_1.formatting.filterObject(config, properties), null, 2));
+                    this._logger.logToStderr(JSON.stringify(formatting_1.formatting.filterObject(config, properties), null, 2));
                 }
                 return config;
             });
@@ -75,14 +37,14 @@ class Request {
                         response.headers['content-type'].indexOf('json') > -1) {
                         properties.push('data');
                     }
-                    this._logger.logToStderr(JSON.stringify(Object.assign({ url: response.config.url }, utils_1.formatting.filterObject(response, properties)), null, 2));
+                    this._logger.logToStderr(JSON.stringify(Object.assign({ url: response.config.url }, formatting_1.formatting.filterObject(response, properties)), null, 2));
                 }
                 return response;
             }, (error) => {
                 if (this._logger) {
                     const properties = ['status', 'statusText', 'headers'];
                     this._logger.logToStderr('Request error:');
-                    this._logger.logToStderr(JSON.stringify(Object.assign(Object.assign({ url: error.config.url }, utils_1.formatting.filterObject(error.response, properties)), { error: error.error }), null, 2));
+                    this._logger.logToStderr(JSON.stringify(Object.assign(Object.assign({ url: error.config.url }, formatting_1.formatting.filterObject(error.response, properties)), { error: error.error }), null, 2));
                 }
                 throw error;
             });
@@ -94,6 +56,45 @@ class Request {
     set logger(logger) {
         this._logger = logger;
     }
+    constructor() {
+        this._debug = false;
+        this.req = axios_1.default.create({
+            headers: {
+                'user-agent': `NONISV|SharePointPnP|CLIMicrosoft365/${packageJSON.version}`,
+                'accept-encoding': 'gzip, deflate',
+                'X-ClientService-ClientTag': `M365CLI:${packageJSON.version}`
+            },
+            decompress: true,
+            responseType: 'text',
+            /* c8 ignore next */
+            transformResponse: [data => data],
+            maxBodyLength: Infinity,
+            maxContentLength: Infinity
+        });
+        // since we're stubbing requests, request interceptor is never called in
+        // tests, so let's exclude it from coverage
+        /* c8 ignore next 7 */
+        this.req.interceptors.request.use((config) => {
+            if (config.responseType === 'json') {
+                config.transformResponse = axios_1.default.defaults.transformResponse;
+            }
+            return config;
+        });
+        // since we're stubbing requests, response interceptor is never called in
+        // tests, so let's exclude it from coverage
+        /* c8 ignore next 15 */
+        this.req.interceptors.response.use((response) => response, (error) => {
+            if (error &&
+                error.response &&
+                error.response.data &&
+                !(error.response.data instanceof stream_1.Stream)) {
+                // move error details from response.data to error property to make
+                // it compatible with our code
+                error.error = JSON.parse(JSON.stringify(error.response.data));
+            }
+            throw error;
+        });
+    }
     post(options) {
         options.method = 'POST';
         return this.execute(options);
@@ -128,7 +129,8 @@ class Request {
                     return Promise.resolve('');
                 }
                 else {
-                    const resource = Auth_1.Auth.getResourceFromUrl(options.url);
+                    const url = options.headers && options.headers['x-resource'] ? options.headers['x-resource'] : options.url;
+                    const resource = Auth_1.Auth.getResourceFromUrl(url);
                     return Auth_1.default.ensureAccessToken(resource, this._logger, this._debug);
                 }
             })()
@@ -137,7 +139,10 @@ class Request {
                     if (options.headers['x-anonymous']) {
                         delete options.headers['x-anonymous'];
                     }
-                    else {
+                    if (options.headers['x-resource']) {
+                        delete options.headers['x-resource'];
+                    }
+                    if (accessToken !== '') {
                         options.headers.authorization = `Bearer ${accessToken}`;
                     }
                 }

package/dist/settingsNames.js

@@ -2,7 +2,6 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.settingsNames = void 0;
 const settingsNames = {
-    autoOpenBrowserOnLogin: 'autoOpenBrowserOnLogin',
     autoOpenLinksInBrowser: 'autoOpenLinksInBrowser',
     copyDeviceCodeToClipboard: 'copyDeviceCodeToClipboard',
     csvEscape: 'csvEscape',
@@ -10,7 +9,9 @@ const settingsNames = {
     csvQuote: 'csvQuote',
     csvQuoted: 'csvQuoted',
     csvQuotedEmpty: 'csvQuotedEmpty',
+    disableTelemetry: 'disableTelemetry',
     errorOutput: 'errorOutput',
+    helpMode: 'helpMode',
     output: 'output',
     printErrorsAsPlainText: 'printErrorsAsPlainText',
     prompt: 'prompt',

package/dist/telemetry.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.telemetry = void 0;
+const appInsights_1 = require("./appInsights");
+const Cli_1 = require("./cli/Cli");
+const settingsNames_1 = require("./settingsNames");
+class Telemetry {
+    trackEvent(commandName, properties) {
+        if (Cli_1.Cli.getInstance().getSettingWithDefaultValue(settingsNames_1.settingsNames.disableTelemetry, false)) {
+            return;
+        }
+        appInsights_1.default.trackEvent({
+            name: commandName,
+            properties
+        });
+        appInsights_1.default.flush();
+    }
+    trackException(exception) {
+        if (Cli_1.Cli.getInstance().getSettingWithDefaultValue(settingsNames_1.settingsNames.disableTelemetry, false)) {
+            return;
+        }
+        appInsights_1.default.trackException({
+            exception
+        });
+        appInsights_1.default.flush();
+    }
+}
+exports.telemetry = new Telemetry();
+//# sourceMappingURL=telemetry.js.map

package/dist/utils/aadGroup.js

@@ -11,6 +11,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.aadGroup = void 0;
 const request_1 = require("../request");
+const formatting_1 = require("./formatting");
 const odata_1 = require("./odata");
 const graphResource = 'https://graph.microsoft.com';
 exports.aadGroup = {
@@ -33,7 +34,7 @@ exports.aadGroup = {
      * @param displayName Group display name.
      */
     getGroupsByDisplayName(displayName) {
-        return odata_1.odata.getAllItems(`${graphResource}/v1.0/groups?$filter=displayName eq '${encodeURIComponent(displayName)}'`);
+        return odata_1.odata.getAllItems(`${graphResource}/v1.0/groups?$filter=displayName eq '${formatting_1.formatting.encodeQueryParameter(displayName)}'`);
     },
     /**
      * Get a single group by its display name.

package/dist/utils/cache.js

@@ -0,0 +1,81 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.cache = void 0;
+const fs = require("fs");
+const os = require("os");
+const path = require("path");
+const config_1 = require("../config");
+const cacheFolderPath = path.join(os.tmpdir(), config_1.default.configstoreName.replace('config', 'cache'));
+const mkdirOptions = { mode: 0o0700, recursive: true };
+exports.cache = {
+    cacheFolderPath: cacheFolderPath,
+    getValue(key) {
+        this.clearExpired();
+        try {
+            const cacheFilePath = path.join(cacheFolderPath, key);
+            if (!fs.existsSync(cacheFilePath)) {
+                return undefined;
+            }
+            return fs.readFileSync(cacheFilePath, 'utf8');
+        }
+        catch (_a) {
+            return undefined;
+        }
+    },
+    setValue(key, value) {
+        this.clearExpired();
+        try {
+            fs.mkdirSync(cacheFolderPath, mkdirOptions);
+            const cacheFilePath = path.join(cacheFolderPath, key);
+            // we don't need to wait for the file to be written
+            // eslint-disable-next-line @typescript-eslint/no-empty-function
+            fs.writeFile(cacheFilePath, value, () => { });
+        }
+        catch (_a) { }
+    },
+    clearExpired(cb) {
+        // we don't need to wait for this to complete
+        // even if it stops meanwhile, it will be picked up next time
+        fs.readdir(cacheFolderPath, (err, files) => {
+            if (err) {
+                if (cb) {
+                    cb();
+                }
+                return;
+            }
+            const numFiles = files.length;
+            if (numFiles === 0) {
+                if (cb) {
+                    cb();
+                }
+                return;
+            }
+            files.forEach((file, index) => {
+                fs.stat(path.join(cacheFolderPath, file), (err, stats) => {
+                    if (err || stats.isDirectory()) {
+                        if (cb && index === numFiles - 1) {
+                            cb();
+                        }
+                        return;
+                    }
+                    // remove files that haven't been accessed in the last 24 hours
+                    if (stats.atime.getTime() < Date.now() - 24 * 60 * 60 * 1000) {
+                        // we don't need to wait for the file to be deleted
+                        // eslint-disable-next-line @typescript-eslint/no-empty-function
+                        fs.unlink(path.join(cacheFolderPath, file), () => {
+                            if (cb && index === numFiles - 1) {
+                                cb();
+                            }
+                        });
+                    }
+                    else {
+                        if (cb && index === numFiles - 1) {
+                            cb();
+                        }
+                    }
+                });
+            });
+        });
+    }
+};
+//# sourceMappingURL=cache.js.map

package/dist/utils/formatting.js

@@ -2,6 +2,8 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.formatting = void 0;
 const stripJsonComments = require("strip-json-comments");
+const base_permissions_1 = require("../m365/spo/base-permissions");
+const RoleType_1 = require("../m365/spo/commands/roledefinition/RoleType");
 exports.formatting = {
     escapeXml(s) {
         if (!s) {
@@ -38,21 +40,31 @@ exports.formatting = {
             return filtered;
         }, {});
     },
-    parseCsvToJson(s) {
-        const rows = s.split('\n');
-        const jsonObj = [];
-        const headers = rows[0].split(',');
-        for (let i = 1; i < rows.length; i++) {
-            const data = rows[i].split(',');
-            const obj = {};
-            for (let j = 0; j < data.length; j++) {
-                const value = data[j].trim();
-                const numValue = parseInt(value);
-                obj[headers[j].trim()] = isNaN(numValue) || numValue.toString() !== value ? value : numValue;
-            }
-            jsonObj.push(obj);
-        }
-        return jsonObj;
+    setFriendlyPermissions(response) {
+        response.forEach((r) => {
+            const permissions = new base_permissions_1.BasePermissions();
+            permissions.high = r.BasePermissions.High;
+            permissions.low = r.BasePermissions.Low;
+            r.BasePermissionsValue = permissions.parse();
+            r.RoleTypeKindValue = RoleType_1.RoleType[r.RoleTypeKind];
+        });
+        return response;
+    },
+    parseCsvToJson(s, quoteChar = '"', delimiter = ',') {
+        const regex = new RegExp(`\\s*(${quoteChar})?(.*?)\\1\\s*(?:${delimiter}|$)`, 'gs');
+        const lines = s.split('\n');
+        const match = (line) => [...line.matchAll(regex)]
+            .map(m => m[2]) // we only want the second capture group
+            .slice(0, -1); // cut off blank match at the end
+        const heads = match(lines[0]);
+        return lines.slice(1).map(line => {
+            return match(line).reduce((acc, cur, i) => {
+                const val = cur;
+                const numValue = parseInt(val);
+                const key = heads[i];
+                return Object.assign(Object.assign({}, acc), { [key]: isNaN(numValue) || numValue.toString() !== val ? val : numValue });
+            }, {});
+        });
     },
     encodeQueryParameter(value) {
         if (!value) {
@@ -73,6 +85,31 @@ exports.formatting = {
             .replace(/:/g, '%3A')
             .replace(/@/g, '%40')
             .replace(/#/g, '%23');
+    },
+    /**
+     * Rewrites boolean values according to the definition:
+     * Booleans are case-insensitive, and are represented by the following values.
+     *   True: 1, yes, true, on
+     *   False: 0, no, false, off
+     * @value Stringified Boolean value to rewrite
+     * @returns A stringified boolean with the value 'true' or 'false'. Returns the original value if it does not comply with the definition.
+     */
+    rewriteBooleanValue(value) {
+        const argValue = value.toLowerCase();
+        switch (argValue) {
+            case '1':
+            case 'true':
+            case 'yes':
+            case 'on':
+                return 'true';
+            case '0':
+            case 'false':
+            case 'no':
+            case 'off':
+                return 'false';
+            default:
+                return value;
+        }
     }
 };
 //# sourceMappingURL=formatting.js.map

package/dist/utils/fsUtil.js

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

package/dist/utils/md.js

@@ -45,10 +45,16 @@ function convertHyperlinks(md) {
         return `${label} (${url})`;
     });
 }
+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 convertCodeFences(md) {
-    const regex = new RegExp('^```.*?' + os_1.EOL + '(.*?)```' + os_1.EOL, 'gms');
+    const regex = new RegExp('^```.*?(?:\r\n|\n)(.*?)```(?:\r\n|\n)', 'gms');
     return md.replace(regex, (match, code) => {
-        return `  ${code}${os_1.EOL}`;
+        return `${code.replace(/^(.+)$/gm, '  $1')}${os_1.EOL}`;
     });
 }
 function removeInlineMarkup(md) {
@@ -59,12 +65,21 @@ function removeTooManyEmptyLines(md) {
     const regex = new RegExp('(' + os_1.EOL + '){4,}', 'g');
     return md.replace(regex, Array(4).join(os_1.EOL));
 }
+function escapeMd(mdString) {
+    if (!mdString) {
+        return mdString;
+    }
+    return mdString.toString()
+        .replace(/([_*~`|])/g, '\\$1')
+        .replace(/\n/g, '<br>');
+}
 const convertFunctions = [
     convertTitle,
     convertHeadings,
     convertAdmonitions,
     convertDd,
     convertHyperlinks,
+    convertContentTabs,
     convertCodeFences,
     removeInlineMarkup,
     removeTooManyEmptyLines
@@ -76,6 +91,7 @@ exports.md = {
             md = convert(md);
         });
         return md;
-    }
+    },
+    escapeMd
 };
 //# sourceMappingURL=md.js.map

package/dist/utils/odata.js

@@ -19,7 +19,8 @@ exports.odata = {
             const requestOptions = {
                 url: url,
                 headers: {
-                    accept: `application/json;odata.metadata=${metadata !== null && metadata !== void 0 ? metadata : 'none'}`
+                    accept: `application/json;odata.metadata=${metadata !== null && metadata !== void 0 ? metadata : 'none'}`,
+                    'odata-version': '4.0'
                 },
                 responseType: 'json'
             };

package/dist/utils/pid.js

@@ -0,0 +1,57 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.pid = void 0;
+const os = require("os");
+const fs = require("fs");
+const child_process_1 = require("child_process");
+const cache_1 = require("./cache");
+function getProcessNameOnMacOs(pid) {
+    const stdout = (0, child_process_1.execSync)(`ps -o comm= ${pid}`, { encoding: 'utf8' });
+    return stdout.trim();
+}
+function getProcessNameOnLinux(pid) {
+    if (!fs.existsSync(`/proc/${pid}/stat`)) {
+        return undefined;
+    }
+    const stat = fs.readFileSync(`/proc/${pid}/stat`, 'utf8');
+    const start = stat.indexOf('(');
+    const procName = stat.substring(start + 1, stat.indexOf(')') - start);
+    return procName;
+}
+function getProcessNameOnWindows(pid) {
+    const stdout = (0, child_process_1.execSync)(`wmic PROCESS where ProcessId=${pid} get Caption | find /V "Caption"`, { encoding: 'utf8' });
+    return stdout.trim();
+}
+exports.pid = {
+    getProcessName(pid) {
+        let processName = cache_1.cache.getValue(pid.toString());
+        if (processName) {
+            return processName;
+        }
+        let getPidName = undefined;
+        const platform = os.platform();
+        if (platform.indexOf('win') === 0) {
+            getPidName = getProcessNameOnWindows;
+        }
+        if (platform === 'darwin') {
+            getPidName = getProcessNameOnMacOs;
+        }
+        if (platform === 'linux') {
+            getPidName = getProcessNameOnLinux;
+        }
+        if (getPidName) {
+            try {
+                processName = getPidName(pid);
+                if (processName) {
+                    cache_1.cache.setValue(pid.toString(), processName);
+                }
+                return processName;
+            }
+            catch (_a) {
+                return undefined;
+            }
+        }
+        return undefined;
+    }
+};
+//# sourceMappingURL=pid.js.map

package/dist/utils/powerPlatform.js

@@ -0,0 +1,43 @@
+"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.powerPlatform = void 0;
+const request_1 = require("../request");
+const formatting_1 = require("./formatting");
+const powerPlatformResource = 'https://api.bap.microsoft.com';
+exports.powerPlatform = {
+    getDynamicsInstanceApiUrl(environment, asAdmin) {
+        return __awaiter(this, void 0, void 0, function* () {
+            let url = '';
+            if (asAdmin) {
+                url = `${powerPlatformResource}/providers/Microsoft.BusinessAppPlatform/scopes/admin/environments/${formatting_1.formatting.encodeQueryParameter(environment)}`;
+            }
+            else {
+                url = `${powerPlatformResource}/providers/Microsoft.BusinessAppPlatform/environments/${formatting_1.formatting.encodeQueryParameter(environment)}`;
+            }
+            const requestOptions = {
+                url: `${url}?api-version=2020-10-01&$select=properties.linkedEnvironmentMetadata.instanceApiUrl`,
+                headers: {
+                    accept: 'application/json;odata.metadata=none'
+                },
+                responseType: 'json'
+            };
+            try {
+                const response = yield request_1.default.get(requestOptions);
+                return Promise.resolve(response.properties.linkedEnvironmentMetadata.instanceApiUrl);
+            }
+            catch (ex) {
+                throw Error(`The environment '${environment}' could not be retrieved. See the inner exception for more details: ${ex.message}`);
+            }
+        });
+    }
+};
+//# sourceMappingURL=powerPlatform.js.map

package/dist/utils/spo.js

@@ -2,11 +2,13 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.spo = void 0;
 const url = require("url");
-const _1 = require(".");
+const urlUtil_1 = require("./urlUtil");
+const validation_1 = require("./validation");
 const Auth_1 = require("../Auth");
 const config_1 = require("../config");
 const base_permissions_1 = require("../m365/spo/base-permissions");
 const request_1 = require("../request");
+const formatting_1 = require("./formatting");
 exports.spo = {
     getRequestDigest(siteUrl) {
         const requestOptions = {
@@ -20,7 +22,7 @@ exports.spo = {
     },
     ensureFormDigest(siteUrl, logger, context, debug) {
         return new Promise((resolve, reject) => {
-            if (_1.validation.isValidFormDigest(context)) {
+            if (validation_1.validation.isValidFormDigest(context)) {
                 if (debug) {
                     logger.logToStderr('Existing form digest still valid');
                 }
@@ -255,7 +257,7 @@ exports.spo = {
             webFullUrl[webFullUrlLastCharPos] === '/') {
             webFullUrl = webFullUrl.substring(0, webFullUrlLastCharPos);
         }
-        folderToEnsure = _1.urlUtil.getWebRelativePath(webFullUrl, folderToEnsure);
+        folderToEnsure = urlUtil_1.urlUtil.getWebRelativePath(webFullUrl, folderToEnsure);
         if (debug) {
             logger.log(`folderToEnsure`);
             logger.log(folderToEnsure);
@@ -282,9 +284,9 @@ exports.spo = {
             // append the next sub-folder to the folder path and check if it exists
             prevFolder = nextFolder;
             nextFolder += `/${folders[folderIndex]}`;
-            const folderServerRelativeUrl = _1.urlUtil.getServerRelativePath(webFullUrl, nextFolder);
+            const folderServerRelativeUrl = urlUtil_1.urlUtil.getServerRelativePath(webFullUrl, nextFolder);
             const requestOptions = {
-                url: `${webFullUrl}/_api/web/GetFolderByServerRelativeUrl('${encodeURIComponent(folderServerRelativeUrl)}')`,
+                url: `${webFullUrl}/_api/web/GetFolderByServerRelativeUrl('${formatting_1.formatting.encodeQueryParameter(folderServerRelativeUrl)}')`,
                 headers: {
                     'accept': 'application/json;odata=nometadata'
                 }
@@ -296,9 +298,9 @@ exports.spo = {
                 checkOrAddFolder(resolve, reject);
             })
                 .catch(() => {
-                const prevFolderServerRelativeUrl = _1.urlUtil.getServerRelativePath(webFullUrl, prevFolder);
+                const prevFolderServerRelativeUrl = urlUtil_1.urlUtil.getServerRelativePath(webFullUrl, prevFolder);
                 const requestOptions = {
-                    url: `${webFullUrl}/_api/web/GetFolderByServerRelativePath(DecodedUrl=@a1)/AddSubFolderUsingPath(DecodedUrl=@a2)?@a1=%27${encodeURIComponent(prevFolderServerRelativeUrl)}%27&@a2=%27${encodeURIComponent(folders[folderIndex])}%27`,
+                    url: `${webFullUrl}/_api/web/GetFolderByServerRelativePath(DecodedUrl=@a1)/AddSubFolderUsingPath(DecodedUrl=@a2)?@a1=%27${formatting_1.formatting.encodeQueryParameter(prevFolderServerRelativeUrl)}%27&@a2=%27${formatting_1.formatting.encodeQueryParameter(folders[folderIndex])}%27`,
                     headers: {
                         'accept': 'application/json;odata=nometadata'
                     },
@@ -402,7 +404,7 @@ exports.spo = {
       * @param formDigestValue formDigestValue
       */
     getFolderIdentity(webObjectIdentity, webUrl, siteRelativeUrl, formDigestValue) {
-        const serverRelativePath = _1.urlUtil.getServerRelativePath(webUrl, siteRelativeUrl);
+        const serverRelativePath = urlUtil_1.urlUtil.getServerRelativePath(webUrl, siteRelativeUrl);
         const requestOptions = {
             url: `${webUrl}/_vti_bin/client.svc/ProcessQuery`,
             headers: {

package/docs/docs/_clisettings.md

@@ -0,0 +1,20 @@
+## Available settings
+
+Following is the list of configuration settings available in CLI for Microsoft 365.
+
+Setting name|Definition|Default value
+------------|----------|-------------
+`autoOpenLinksInBrowser`|Automatically open the browser for all commands which return a url and expect the user to copy paste this to the browser. For example when logging in, using `m365 login` in device code mode.|`false`
+`copyDeviceCodeToClipboard`|Automatically copy the device code to the clipboard when running `m365 login` command in device code mode|`false`
+`csvEscape`|Single character used for escaping; only apply to characters matching the quote and the escape options|`"`
+`csvHeader`|Display the column names on the first line|`true`
+`csvQuote`|The quote characters surrounding a field. An empty quote value will preserve the original field, whether it contains quotation marks or not.|` `
+`csvQuoted`|Quote all the non-empty fields even if not required|`false`
+`csvQuotedEmpty`|Quote empty strings and overrides quoted_string on empty strings when defined|`false`
+`disableTelemetry`|Disables sending of telemetry data|`false`
+`errorOutput`|Defines if errors should be written to `stdout` or `stderr`|`stderr`
+`helpMode`|Defines what part of command's help to display. Allowed values are `options`, `examples`, `remarks`, `response`, `full`|`full`
+`output`|Defines the default output when issuing a command|`json`
+`printErrorsAsPlainText`|When output mode is set to `json`, print error messages as plain-text rather than JSON|`true`
+`prompt`|Prompts for missing values in required options|`false`
+`showHelpOnFailure`|Automatically display help when executing a command failed|`true`

package/docs/docs/cmd/_global.md

@@ -1,11 +1,11 @@
-`-h, --help`
-: output usage information
+`-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`. Default `json`
+: Output type. `json,text,csv,md`. Default `json`
 
 `--verbose`
 : Runs command with verbose logging