@pnp/cli-microsoft365 6.9.0-beta.6a23aba → 6.9.0-beta.8393174

package/dist/m365/spo/commands/tenant/tenant-commandset-get.js

@@ -0,0 +1,114 @@
+"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());
+    });
+};
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+};
+var _SpoTenantCommandSetGetCommand_instances, _SpoTenantCommandSetGetCommand_initTelemetry, _SpoTenantCommandSetGetCommand_initOptions, _SpoTenantCommandSetGetCommand_initValidators, _SpoTenantCommandSetGetCommand_initOptionSets;
+Object.defineProperty(exports, "__esModule", { value: true });
+const Command_1 = require("../../../../Command");
+const request_1 = require("../../../../request");
+const formatting_1 = require("../../../../utils/formatting");
+const spo_1 = require("../../../../utils/spo");
+const urlUtil_1 = require("../../../../utils/urlUtil");
+const validation_1 = require("../../../../utils/validation");
+const SpoCommand_1 = require("../../../base/SpoCommand");
+const commands_1 = require("../../commands");
+class SpoTenantCommandSetGetCommand extends SpoCommand_1.default {
+    get name() {
+        return commands_1.default.TENANT_COMMANDSET_GET;
+    }
+    get description() {
+        return 'Get a ListView Command Set that is installed tenant wide';
+    }
+    constructor() {
+        super();
+        _SpoTenantCommandSetGetCommand_instances.add(this);
+        __classPrivateFieldGet(this, _SpoTenantCommandSetGetCommand_instances, "m", _SpoTenantCommandSetGetCommand_initTelemetry).call(this);
+        __classPrivateFieldGet(this, _SpoTenantCommandSetGetCommand_instances, "m", _SpoTenantCommandSetGetCommand_initOptions).call(this);
+        __classPrivateFieldGet(this, _SpoTenantCommandSetGetCommand_instances, "m", _SpoTenantCommandSetGetCommand_initValidators).call(this);
+        __classPrivateFieldGet(this, _SpoTenantCommandSetGetCommand_instances, "m", _SpoTenantCommandSetGetCommand_initOptionSets).call(this);
+    }
+    commandAction(logger, args) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const appCatalogUrl = yield spo_1.spo.getTenantAppCatalogUrl(logger, this.debug);
+            if (!appCatalogUrl) {
+                throw new Command_1.CommandError('No app catalog URL found');
+            }
+            let filter = `startswith(TenantWideExtensionLocation,'ClientSideExtension.ListViewCommandSet')`;
+            if (args.options.title) {
+                filter += ` and Title eq '${args.options.title}'`;
+            }
+            else if (args.options.id) {
+                filter += ` and Id eq ${args.options.id}`;
+            }
+            else if (args.options.clientSideComponentId) {
+                filter += ` and TenantWideExtensionComponentId eq '${args.options.clientSideComponentId}'`;
+            }
+            const listServerRelativeUrl = urlUtil_1.urlUtil.getServerRelativePath(appCatalogUrl, '/lists/TenantWideExtensions');
+            const reqOptions = {
+                url: `${appCatalogUrl}/_api/web/GetList('${formatting_1.formatting.encodeQueryParameter(listServerRelativeUrl)}')/items?$filter=${filter}`,
+                headers: {
+                    'accept': 'application/json;odata=nometadata'
+                },
+                responseType: 'json'
+            };
+            try {
+                const listItemInstances = yield request_1.default.get(reqOptions);
+                if ((listItemInstances === null || listItemInstances === void 0 ? void 0 : listItemInstances.value.length) > 0) {
+                    if (listItemInstances.value.length > 1) {
+                        throw `Multiple ListView Command Sets with ${args.options.title || args.options.clientSideComponentId} were found. Please disambiguate (IDs): ${listItemInstances.value.map(item => item.Id).join(', ')}`;
+                    }
+                    listItemInstances.value.forEach(v => delete v['ID']);
+                    logger.log(listItemInstances.value[0]);
+                }
+                else {
+                    throw 'The specified ListView Command Set was not found';
+                }
+            }
+            catch (err) {
+                return this.handleRejectedODataJsonPromise(err);
+            }
+        });
+    }
+}
+_SpoTenantCommandSetGetCommand_instances = new WeakSet(), _SpoTenantCommandSetGetCommand_initTelemetry = function _SpoTenantCommandSetGetCommand_initTelemetry() {
+    this.telemetry.push((args) => {
+        Object.assign(this.telemetryProperties, {
+            title: typeof args.options.title !== 'undefined',
+            id: typeof args.options.id !== 'undefined',
+            clientSideComponentId: typeof args.options.clientSideComponentId !== 'undefined'
+        });
+    });
+}, _SpoTenantCommandSetGetCommand_initOptions = function _SpoTenantCommandSetGetCommand_initOptions() {
+    this.options.unshift({
+        option: '-t, --title [title]'
+    }, {
+        option: '-i, --id [id]'
+    }, {
+        option: '-c, --clientSideComponentId  [clientSideComponentId]'
+    });
+}, _SpoTenantCommandSetGetCommand_initValidators = function _SpoTenantCommandSetGetCommand_initValidators() {
+    this.validators.push((args) => __awaiter(this, void 0, void 0, function* () {
+        if (args.options.id && isNaN(parseInt(args.options.id))) {
+            return `${args.options.id} is not a number`;
+        }
+        if (args.options.clientSideComponentId && !validation_1.validation.isValidGuid(args.options.clientSideComponentId)) {
+            return `${args.options.clientSideComponentId} is not a valid GUID`;
+        }
+        return true;
+    }));
+}, _SpoTenantCommandSetGetCommand_initOptionSets = function _SpoTenantCommandSetGetCommand_initOptionSets() {
+    this.optionSets.push({ options: ['title', 'id', 'clientSideComponentId'] });
+};
+module.exports = new SpoTenantCommandSetGetCommand();
+//# sourceMappingURL=tenant-commandset-get.js.map

package/dist/m365/spo/commands/tenant/tenant-commandset-list.js

@@ -0,0 +1,50 @@
+"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 Command_1 = require("../../../../Command");
+const formatting_1 = require("../../../../utils/formatting");
+const odata_1 = require("../../../../utils/odata");
+const spo_1 = require("../../../../utils/spo");
+const urlUtil_1 = require("../../../../utils/urlUtil");
+const SpoCommand_1 = require("../../../base/SpoCommand");
+const commands_1 = require("../../commands");
+class SpoTenantCommandSetListCommand extends SpoCommand_1.default {
+    get name() {
+        return commands_1.default.TENANT_COMMANDSET_LIST;
+    }
+    get description() {
+        return 'Retrieves a list of ListView Command Sets that are installed tenant-wide';
+    }
+    defaultProperties() {
+        return ['Title', 'TenantWideExtensionComponentId', 'TenantWideExtensionListTemplate'];
+    }
+    commandAction(logger) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const appCatalogUrl = yield spo_1.spo.getTenantAppCatalogUrl(logger, this.debug);
+            if (!appCatalogUrl) {
+                throw new Command_1.CommandError('No app catalog URL found');
+            }
+            if (this.verbose) {
+                logger.logToStderr('Retrieving a list of ListView Command Sets that are installed tenant-wide');
+            }
+            const listServerRelativeUrl = urlUtil_1.urlUtil.getServerRelativePath(appCatalogUrl, '/lists/TenantWideExtensions');
+            try {
+                const response = yield odata_1.odata.getAllItems(`${appCatalogUrl}/_api/web/GetList('${formatting_1.formatting.encodeQueryParameter(listServerRelativeUrl)}')/items?$filter=startswith(TenantWideExtensionLocation, 'ClientSideExtension.ListViewCommandSet')`);
+                logger.log(response);
+            }
+            catch (err) {
+                this.handleRejectedODataJsonPromise(err);
+            }
+        });
+    }
+}
+module.exports = new SpoTenantCommandSetListCommand();
+//# sourceMappingURL=tenant-commandset-list.js.map

package/dist/m365/spo/commands/tenant/tenant-commandset-set.js

@@ -166,7 +166,7 @@ _SpoTenantCommandSetSetCommand_instances = new WeakSet(), _SpoTenantCommandSetSe
         option: '-l, --listType [listType]',
         autocomplete: SpoTenantCommandSetSetCommand.listTypes
     }, {
-        option: '-i, --clientSideComponentId [clientSideComponentId]'
+        option: '-c, --clientSideComponentId [clientSideComponentId]'
     }, {
         option: '-p, --clientSideComponentProperties [clientSideComponentProperties]'
     }, {

package/dist/m365/spo/commands.js

@@ -17,6 +17,7 @@ exports.default = {
     APPLICATIONCUSTOMIZER_GET: `${prefix} applicationcustomizer get`,
     APPLICATIONCUSTOMIZER_LIST: `${prefix} applicationcustomizer list`,
     APPLICATIONCUSTOMIZER_REMOVE: `${prefix} applicationcustomizer remove`,
+    APPLICATIONCUSTOMIZER_SET: `${prefix} applicationcustomizer set`,
     APPPAGE_ADD: `${prefix} apppage add`,
     APPPAGE_SET: `${prefix} apppage set`,
     CDN_GET: `${prefix} cdn get`,
@@ -60,6 +61,7 @@ exports.default = {
     FILE_ADD: `${prefix} file add`,
     FILE_CHECKIN: `${prefix} file checkin`,
     FILE_CHECKOUT: `${prefix} file checkout`,
+    FILE_CHECKOUT_UNDO: `${prefix} file checkout undo`,
     FILE_COPY: `${prefix} file copy`,
     FILE_GET: `${prefix} file get`,
     FILE_LIST: `${prefix} file list`,
@@ -141,6 +143,7 @@ exports.default = {
     LIST_ROLEASSIGNMENT_ADD: `${prefix} list roleassignment add`,
     LIST_ROLEINHERITANCE_BREAK: `${prefix} list roleinheritance break`,
     LIST_ROLEINHERITANCE_RESET: `${prefix} list roleinheritance reset`,
+    LIST_SENSITIVITYLABEL_ENSURE: `${prefix} list sensitivitylabel ensure`,
     LIST_SET: `${prefix} list set`,
     LIST_SITESCRIPT_GET: `${prefix} list sitescript get`,
     LIST_VIEW_ADD: `${prefix} list view add`,
@@ -295,6 +298,10 @@ exports.default = {
     TENANT_APPLICATIONCUSTOMIZER_GET: `${prefix} tenant applicationcustomizer get`,
     TENANT_APPLICATIONCUSTOMIZER_LIST: `${prefix} tenant applicationcustomizer list`,
     TENANT_APPLICATIONCUSTOMIZER_REMOVE: `${prefix} tenant applicationcustomizer remove`,
+    TENANT_APPLICATIONCUSTOMIZER_SET: `${prefix} tenant applicationcustomizer set`,
+    TENANT_COMMANDSET_ADD: `${prefix} tenant commandset add`,
+    TENANT_COMMANDSET_GET: `${prefix} tenant commandset get`,
+    TENANT_COMMANDSET_LIST: `${prefix} tenant commandset list`,
     TENANT_COMMANDSET_REMOVE: `${prefix} tenant commandset remove`,
     TENANT_COMMANDSET_SET: `${prefix} tenant commandset set`,
     TENANT_RECYCLEBINITEM_LIST: `${prefix} tenant recyclebinitem list`,

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/settingsNames.js

@@ -12,6 +12,7 @@ const settingsNames = {
     disableTelemetry: 'disableTelemetry',
     errorOutput: 'errorOutput',
     helpMode: 'helpMode',
+    interactive: 'interactive',
     output: 'output',
     printErrorsAsPlainText: 'printErrorsAsPlainText',
     prompt: 'prompt',

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

@@ -25,9 +25,7 @@ function includeContent(md, rootFolder) {
         { tag: "<CLISettings />", location: "docs/_clisettings.mdx" }
     ];
     mdxImports.forEach(mdxImport => {
-        md = md.replace(mdxImport.tag, () => {
-            return fs.readFileSync(path.join(rootFolder, mdxImport.location), 'utf8');
-        }).replace(/(```\r\n)\r\n(```md defintion-list\r\n)/g, "$1$2");
+        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;
 }

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/aad/app/app-add.mdx

@@ -1,4 +1,6 @@
 import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
 
 # aad app add
 
@@ -182,3 +184,114 @@ Create new Azure AD app registration with a certificate
 ```sh
 m365 aad app add --name 'My AAD app' --certificateDisplayName "Some certificate name" --certificateFile "c:\temp\some-certificate.cer"
 ```
+
+## Response
+
+### Standard response
+
+<Tabs>
+  <TabItem value="JSON">
+
+  ```json
+  {
+    "appId": "68e9f0dd-c743-4693-9ba4-d78e91bd13cc",
+    "objectId": "d4d7d33a-d40e-4606-b67d-de6cdbfaa01f",
+    "tenantId": "1e852b49-bf4b-4ba5-bcd4-a8c4706c8ed4"
+  }
+  ```
+
+  </TabItem>
+  <TabItem value="Text">
+
+  ```text
+  appId   : 908db832-dac2-4622-98b3-b492fdc74f80
+  objectId: 089066cc-2c81-4188-9b6b-7b86e861a169
+  tenantId: 1e852b49-bf4b-4ba5-bcd4-a8c4706c8ed4
+  ```
+
+  </TabItem>
+  <TabItem value="CSV">
+
+  ```csv
+  appId,objectId,tenantId
+  9db26abb-dd17-48f1-b790-765d14d834b6,5c803709-e0b8-4a4f-a43f-f4ad39fdee45,1e852b49-bf4b-4ba5-bcd4-a8c4706c8ed4
+  ```
+
+  </TabItem>
+  <TabItem value="Markdown">
+
+  ```md
+  # aad app add --name "My AAD app"
+
+  Date: 2023-06-01
+
+  ## 8e60ecac-34b4-404c-832d-f1c77bc27b78
+
+  Property | Value
+  ---------|-------
+  appId | f86600df-9842-4f25-b7cf-242f3736b137
+  objectId | 8e60ecac-34b4-404c-832d-f1c77bc27b78
+  tenantId | 1e852b49-bf4b-4ba5-bcd4-a8c4706c8ed4
+  ```
+
+  </TabItem>
+</Tabs>
+
+### `withSecret` response
+
+When we make use of the option `withSecret` the response will differ. 
+
+<Tabs>
+  <TabItem value="JSON">
+
+  ```json
+  {
+    "appId": "efb2ec4c-d247-446b-9efd-0f8141652711",
+    "objectId": "c8bdc471-ba5a-45c9-b725-5fc83bfc9c59",
+    "tenantId": "1e852b49-bf4b-4ba5-bcd4-a8c4706c8ed4",
+    "secrets": [
+      {
+        "displayName": "Default",
+        "value": "Bhc8Q~EhE26SCWAxSlKpfwTkbfdHtsXxVJNTtagT"
+      }
+    ]
+  }
+  ```
+
+  </TabItem>
+  <TabItem value="Text">
+
+  ```text
+  appId   : 748e1b24-8fa6-4f54-a3f2-5f84ffcffdbe
+  objectId: 6aa9fde7-d58a-4211-a84a-b7252ac6087b
+  secrets : [{"displayName":"Default","value":"6JA8Q~_4SzAbj3bQgzap~vNscazQzXBBEcxDHdd5"}]
+  tenantId: 1e852b49-bf4b-4ba5-bcd4-a8c4706c8ed4
+  ```
+
+  </TabItem>
+  <TabItem value="CSV">
+
+  ```csv
+  appId,objectId,tenantId
+  06700d67-0c97-402a-8c09-802049ffd70f,1eb0491f-1c88-490f-b2b3-18dc501938a1,1e852b49-bf4b-4ba5-bcd4-a8c4706c8ed4
+  ```
+
+  </TabItem>
+  <TabItem value="Markdown">
+
+  ```md
+  # aad app add --name "My AAD app" --withSecret "true"
+
+  Date: 2023-06-01
+
+  ## a5cb917a-ebf3-4c3c-82db-90aa122495b4
+
+  Property | Value
+  ---------|-------
+  appId | 3d1a4664-2634-4b35-9e42-1fa24abfda89
+  objectId | a5cb917a-ebf3-4c3c-82db-90aa122495b4
+  tenantId | 1e852b49-bf4b-4ba5-bcd4-a8c4706c8ed4
+  ```
+
+  </TabItem>
+</Tabs>