@pnp/cli-microsoft365 6.3.0-beta.64eb7da → 6.3.0-beta.80fcd21

package/dist/m365/spo/commands/tenant/tenant-applicationcustomizer-add.js

@@ -0,0 +1,179 @@
+"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 _SpoTenantApplicationCustomizerAddCommand_instances, _SpoTenantApplicationCustomizerAddCommand_initTelemetry, _SpoTenantApplicationCustomizerAddCommand_initOptions, _SpoTenantApplicationCustomizerAddCommand_initValidators;
+Object.defineProperty(exports, "__esModule", { value: true });
+const validation_1 = require("../../../../utils/validation");
+const SpoCommand_1 = require("../../../base/SpoCommand");
+const commands_1 = require("../../commands");
+const Cli_1 = require("../../../../cli/Cli");
+const spoTenantAppCatalogUrlGetCommand = require("../tenant/tenant-appcatalogurl-get");
+const spoListItemAddCommand = require("../listitem/listitem-add");
+const spoListItemListCommand = require("../listitem/listitem-list");
+const urlUtil_1 = require("../../../../utils/urlUtil");
+class SpoTenantApplicationCustomizerAddCommand extends SpoCommand_1.default {
+    get name() {
+        return commands_1.default.TENANT_APPLICATIONCUSTOMIZER_ADD;
+    }
+    get description() {
+        return 'Add an application customizer as a tenant wide extension.';
+    }
+    constructor() {
+        super();
+        _SpoTenantApplicationCustomizerAddCommand_instances.add(this);
+        __classPrivateFieldGet(this, _SpoTenantApplicationCustomizerAddCommand_instances, "m", _SpoTenantApplicationCustomizerAddCommand_initTelemetry).call(this);
+        __classPrivateFieldGet(this, _SpoTenantApplicationCustomizerAddCommand_instances, "m", _SpoTenantApplicationCustomizerAddCommand_initOptions).call(this);
+        __classPrivateFieldGet(this, _SpoTenantApplicationCustomizerAddCommand_instances, "m", _SpoTenantApplicationCustomizerAddCommand_initValidators).call(this);
+    }
+    commandAction(logger, args) {
+        return __awaiter(this, void 0, void 0, function* () {
+            try {
+                const appCatalogUrl = yield this.getAppCatalogUrl(logger);
+                const componentManifest = yield this.getComponentManifest(appCatalogUrl, args.options.clientSideComponentId, logger);
+                const clientComponentManifest = JSON.parse(componentManifest.ClientComponentManifest);
+                if (clientComponentManifest.extensionType !== "ApplicationCustomizer") {
+                    throw `The extension type of this component is not of type 'ApplicationCustomizer' but of type '${clientComponentManifest.extensionType}'`;
+                }
+                const solution = yield this.getSolutionFromAppCatalog(appCatalogUrl, componentManifest.SolutionId, logger);
+                if (!solution.ContainsTenantWideExtension) {
+                    throw `The solution does not contain an extension that can be deployed to all sites. Make sure that you've entered the correct component Id.`;
+                }
+                else if (!solution.SkipFeatureDeployment) {
+                    throw 'The solution has not been deployed to all sites. Make sure to deploy this solution to all sites.';
+                }
+                yield this.addTenantWideExtension(appCatalogUrl, args.options, logger);
+            }
+            catch (err) {
+                this.handleRejectedODataJsonPromise(err);
+            }
+        });
+    }
+    getAppCatalogUrl(logger) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const spoTenantAppCatalogUrlGetCommandOutput = yield Cli_1.Cli.executeCommandWithOutput(spoTenantAppCatalogUrlGetCommand, { options: { output: 'text', _: [] } });
+            if (this.verbose) {
+                logger.logToStderr(spoTenantAppCatalogUrlGetCommandOutput.stderr);
+            }
+            const appCatalogUrl = spoTenantAppCatalogUrlGetCommandOutput.stdout;
+            if (!appCatalogUrl) {
+                throw 'Cannot add tenant-wide application customizer as app catalog cannot be found';
+            }
+            if (this.verbose) {
+                logger.logToStderr(`Got tenant app catalog url: ${appCatalogUrl}`);
+            }
+            return appCatalogUrl;
+        });
+    }
+    getComponentManifest(appCatalogUrl, clientSideComponentId, logger) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (this.verbose) {
+                logger.logToStderr('Retrieving component manifest item from the ComponentManifests list on the app catalog site so that we get the solution id');
+            }
+            const camlQuery = `<View><ViewFields><FieldRef Name='ClientComponentId'></FieldRef><FieldRef Name='SolutionId'></FieldRef><FieldRef Name='ClientComponentManifest'></FieldRef></ViewFields><Query><Where><Eq><FieldRef Name='ClientComponentId' /><Value Type='Guid'>${clientSideComponentId}</Value></Eq></Where></Query></View>`;
+            const commandOptions = {
+                webUrl: appCatalogUrl,
+                listUrl: `${urlUtil_1.urlUtil.getServerRelativeSiteUrl(appCatalogUrl)}/Lists/ComponentManifests`,
+                camlQuery: camlQuery,
+                verbose: this.verbose,
+                debug: this.debug,
+                output: 'json'
+            };
+            const output = yield Cli_1.Cli.executeCommandWithOutput(spoListItemListCommand, { options: Object.assign(Object.assign({}, commandOptions), { _: [] }) });
+            if (this.verbose) {
+                logger.logToStderr(output.stderr);
+            }
+            const outputParsed = JSON.parse(output.stdout);
+            if (outputParsed.length === 0) {
+                throw 'No component found with the specified clientSideComponentId found in the component manifest list. Make sure that the application is added to the application catalog';
+            }
+            return outputParsed[0];
+        });
+    }
+    getSolutionFromAppCatalog(appCatalogUrl, solutionId, logger) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (this.verbose) {
+                logger.logToStderr(`Retrieving solution with id ${solutionId} from the application catalog`);
+            }
+            const camlQuery = `<View><ViewFields><FieldRef Name='SkipFeatureDeployment'></FieldRef><FieldRef Name='ContainsTenantWideExtension'></FieldRef></ViewFields><Query><Where><Eq><FieldRef Name='AppProductID' /><Value Type='Guid'>${solutionId}</Value></Eq></Where></Query></View>`;
+            const commandOptions = {
+                webUrl: appCatalogUrl,
+                listUrl: `${urlUtil_1.urlUtil.getServerRelativeSiteUrl(appCatalogUrl)}/AppCatalog`,
+                camlQuery: camlQuery,
+                verbose: this.verbose,
+                debug: this.debug,
+                output: 'json'
+            };
+            const output = yield Cli_1.Cli.executeCommandWithOutput(spoListItemListCommand, { options: Object.assign(Object.assign({}, commandOptions), { _: [] }) });
+            if (this.verbose) {
+                logger.logToStderr(output.stderr);
+            }
+            const outputParsed = JSON.parse(output.stdout);
+            if (outputParsed.length === 0) {
+                throw `No component found with the solution id ${solutionId}. Make sure that the solution is available in the app catalog`;
+            }
+            return outputParsed[0];
+        });
+    }
+    addTenantWideExtension(appCatalogUrl, options, logger) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (this.verbose) {
+                logger.logToStderr('Pre-checks finished. Adding tenant wide extension to the TenantWideExtensions list');
+            }
+            const commandOptions = {
+                webUrl: appCatalogUrl,
+                listUrl: `${urlUtil_1.urlUtil.getServerRelativeSiteUrl(appCatalogUrl)}/Lists/TenantWideExtensions`,
+                Title: options.title,
+                TenantWideExtensionComponentId: options.clientSideComponentId,
+                TenantWideExtensionLocation: 'ClientSideExtension.ApplicationCustomizer',
+                TenantWideExtensionSequence: 0,
+                TenantWideExtensionListTemplate: 0,
+                TenantWideExtensionComponentProperties: options.clientSideComponentProperties || '',
+                TenantWideExtensionWebTemplate: options.webTemplate || '',
+                TenantWideExtensionDisabled: false,
+                verbose: this.verbose,
+                debug: this.debug,
+                output: options.output
+            };
+            yield Cli_1.Cli.executeCommand(spoListItemAddCommand, { options: Object.assign(Object.assign({}, commandOptions), { _: [] }) });
+        });
+    }
+}
+_SpoTenantApplicationCustomizerAddCommand_instances = new WeakSet(), _SpoTenantApplicationCustomizerAddCommand_initTelemetry = function _SpoTenantApplicationCustomizerAddCommand_initTelemetry() {
+    this.telemetry.push((args) => {
+        Object.assign(this.telemetryProperties, {
+            clientSideComponentProperties: typeof args.options.clientSideComponentProperties !== 'undefined',
+            webTemplate: typeof args.options.webTemplate !== 'undefined'
+        });
+    });
+}, _SpoTenantApplicationCustomizerAddCommand_initOptions = function _SpoTenantApplicationCustomizerAddCommand_initOptions() {
+    this.options.unshift({
+        option: '-t, --title <title>'
+    }, {
+        option: '-i, --clientSideComponentId <clientSideComponentId>'
+    }, {
+        option: '-p, --clientSideComponentProperties [clientSideComponentProperties]'
+    }, {
+        option: '-w, --webTemplate [webTemplate]'
+    });
+}, _SpoTenantApplicationCustomizerAddCommand_initValidators = function _SpoTenantApplicationCustomizerAddCommand_initValidators() {
+    this.validators.push((args) => __awaiter(this, void 0, void 0, function* () {
+        if (!validation_1.validation.isValidGuid(args.options.clientSideComponentId)) {
+            return `${args.options.clientSideComponentId} is not a valid GUID`;
+        }
+        return true;
+    }));
+};
+module.exports = new SpoTenantApplicationCustomizerAddCommand();
+//# sourceMappingURL=tenant-applicationcustomizer-add.js.map

package/dist/m365/spo/commands/tenant/tenant-recyclebinitem-remove.js

@@ -74,7 +74,6 @@ class SpoTenantRecycleBinItemRemoveCommand extends SpoCommand_1.default {
                                     reject,
                                     logger,
                                     currentContext: this.context,
-                                    dots: this.dots,
                                     debug: this.debug,
                                     verbose: this.verbose
                                 });

package/dist/m365/spo/commands.js

@@ -13,6 +13,7 @@ exports.default = {
     APP_TEAMSPACKAGE_DOWNLOAD: `${prefix} app teamspackage download`,
     APP_UNINSTALL: `${prefix} app uninstall`,
     APP_UPGRADE: `${prefix} app upgrade`,
+    APPLICATIONCUSTOMIZER_ADD: `${prefix} applicationcustomizer add`,
     APPPAGE_ADD: `${prefix} apppage add`,
     APPPAGE_SET: `${prefix} apppage set`,
     CDN_GET: `${prefix} cdn get`,
@@ -65,9 +66,11 @@ exports.default = {
     FILE_ROLEINHERITANCE_RESET: `${prefix} file roleinheritance reset`,
     FILE_SHARINGINFO_GET: `${prefix} file sharinginfo get`,
     FILE_SHARINGLINK_ADD: `${prefix} file sharinglink add`,
+    FILE_SHARINGLINK_CLEAR: `${prefix} file sharinglink clear`,
     FILE_SHARINGLINK_GET: `${prefix} file sharinglink get`,
     FILE_SHARINGLINK_LIST: `${prefix} file sharinglink list`,
     FILE_SHARINGLINK_REMOVE: `${prefix} file sharinglink remove`,
+    FILE_SHARINGLINK_SET: `${prefix} file sharinglink set`,
     FILE_VERSION_CLEAR: `${prefix} file version clear`,
     FILE_VERSION_GET: `${prefix} file version get`,
     FILE_VERSION_LIST: `${prefix} file version list`,
@@ -165,6 +168,7 @@ exports.default = {
     LISTITEM_SET: `${prefix} listitem set`,
     MAIL_SEND: `${prefix} mail send`,
     NAVIGATION_NODE_ADD: `${prefix} navigation node add`,
+    NAVIGATION_NODE_GET: `${prefix} navigation node get`,
     NAVIGATION_NODE_LIST: `${prefix} navigation node list`,
     NAVIGATION_NODE_REMOVE: `${prefix} navigation node remove`,
     NAVIGATION_NODE_SET: `${prefix} navigation node set`,
@@ -274,6 +278,7 @@ exports.default = {
     STORAGEENTITY_REMOVE: `${prefix} storageentity remove`,
     TENANT_APPCATALOG_ADD: `${prefix} tenant appcatalog add`,
     TENANT_APPCATALOGURL_GET: `${prefix} tenant appcatalogurl get`,
+    TENANT_APPLICATIONCUSTOMIZER_ADD: `${prefix} tenant applicationcustomizer add`,
     TENANT_RECYCLEBINITEM_LIST: `${prefix} tenant recyclebinitem list`,
     TENANT_RECYCLEBINITEM_REMOVE: `${prefix} tenant recyclebinitem remove`,
     TENANT_RECYCLEBINITEM_RESTORE: `${prefix} tenant recyclebinitem restore`,

package/dist/m365/teams/commands/team/team-add.js

@@ -44,7 +44,6 @@ class TeamsTeamAddCommand extends GraphCommand_1.default {
     }
     commandAction(logger, args) {
         return __awaiter(this, void 0, void 0, function* () {
-            this.dots = '';
             let requestBody;
             if (args.options.template) {
                 if (this.verbose) {
@@ -95,7 +94,7 @@ class TeamsTeamAddCommand extends GraphCommand_1.default {
                     }
                     else {
                         setTimeout(() => {
-                            this.waitUntilFinished(requestOptions, resolve, reject, logger, this.dots);
+                            this.waitUntilFinished(requestOptions, resolve, reject, logger);
                         }, this.pollingInterval);
                     }
                 }));
@@ -113,11 +112,7 @@ class TeamsTeamAddCommand extends GraphCommand_1.default {
             }
         });
     }
-    waitUntilFinished(requestOptions, resolve, reject, logger, dots) {
-        if (!this.debug && this.verbose) {
-            dots += '.';
-            process.stdout.write(`\r${dots}`);
-        }
+    waitUntilFinished(requestOptions, resolve, reject, logger) {
         request_1.default
             .get(requestOptions)
             .then((teamsAsyncOperation) => {
@@ -133,7 +128,7 @@ class TeamsTeamAddCommand extends GraphCommand_1.default {
                 return;
             }
             setTimeout(() => {
-                this.waitUntilFinished(requestOptions, resolve, reject, logger, dots);
+                this.waitUntilFinished(requestOptions, resolve, reject, logger);
             }, this.pollingInterval);
         }).catch(err => reject(err));
     }

package/dist/utils/aadUser.js

@@ -0,0 +1,38 @@
+"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.aadUser = void 0;
+const request_1 = require("../request");
+const formatting_1 = require("./formatting");
+const graphResource = 'https://graph.microsoft.com';
+exports.aadUser = {
+    /**
+     * Retrieve the id of a user by its UPN.
+     * @param upn User UPN.
+     */
+    getUserIdByUpn(upn) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const requestOptions = {
+                url: `${graphResource}/v1.0/users?$filter=userPrincipalName eq '${formatting_1.formatting.encodeQueryParameter(upn)}'&$select=Id`,
+                headers: {
+                    accept: 'application/json;odata.metadata=none'
+                },
+                responseType: 'json'
+            };
+            const res = yield request_1.default.get(requestOptions);
+            if (res.value.length === 0) {
+                throw Error(`The specified user with user name ${upn} does not exist.`);
+            }
+            return res.value[0].id;
+        });
+    }
+};
+//# sourceMappingURL=aadUser.js.map

package/dist/utils/planner.js

@@ -57,15 +57,12 @@ exports.planner = {
      * @param groupId Owner group ID.
      * @param rosterId Roster ID.
      */
-    getPlanByTitle(title, groupId, rosterId, metadata = 'none') {
+    getPlanByTitle(title, groupId, metadata = 'none') {
         return __awaiter(this, void 0, void 0, function* () {
             let plans = [];
             if (groupId) {
                 plans = yield this.getPlansByGroupId(groupId, metadata);
             }
-            else if (rosterId) {
-                plans = yield this.getPlansByRosterId(rosterId, metadata);
-            }
             const filteredPlans = plans.filter(p => p.title && p.title.toLowerCase() === title.toLowerCase());
             if (!filteredPlans.length) {
                 throw Error(`The specified plan '${title}' does not exist.`);

package/dist/utils/session.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.session = void 0;
+const crypto = require("crypto");
+const cache_1 = require("./cache");
+exports.session = {
+    getId(pid) {
+        const key = `${pid.toString()}_session`;
+        let sessionId = cache_1.cache.getValue(key);
+        if (sessionId) {
+            return sessionId;
+        }
+        sessionId = crypto.randomBytes(24).toString('base64');
+        cache_1.cache.setValue(key, sessionId);
+        return sessionId;
+    }
+};
+//# sourceMappingURL=session.js.map

package/dist/utils/spo.js

@@ -18,6 +18,7 @@ const config_1 = require("../config");
 const base_permissions_1 = require("../m365/spo/base-permissions");
 const request_1 = require("../request");
 const formatting_1 = require("./formatting");
+const odata_1 = require("./odata");
 exports.spo = {
     getRequestDigest(siteUrl) {
         const requestOptions = {
@@ -55,7 +56,7 @@ exports.spo = {
             });
         });
     },
-    waitUntilFinished({ operationId, siteUrl, resolve, reject, logger, currentContext, dots, debug, verbose }) {
+    waitUntilFinished({ operationId, siteUrl, resolve, reject, logger, currentContext, debug, verbose }) {
         exports.spo
             .ensureFormDigest(siteUrl, logger, currentContext, debug)
             .then((res) => {
@@ -63,10 +64,6 @@ exports.spo = {
             if (debug) {
                 logger.logToStderr(`Checking if operation ${operationId} completed...`);
             }
-            if (!debug && verbose) {
-                dots += '.';
-                process.stdout.write(`\r${dots}`);
-            }
             const requestOptions = {
                 url: `${siteUrl}/_vti_bin/client.svc/ProcessQuery`,
                 headers: {
@@ -100,7 +97,6 @@ exports.spo = {
                         reject,
                         logger,
                         currentContext,
-                        dots,
                         debug,
                         verbose
                     });
@@ -108,7 +104,7 @@ exports.spo = {
             }
         });
     },
-    waitUntilCopyJobFinished({ copyJobInfo, siteUrl, pollingInterval, resolve, reject, logger, dots, debug, verbose }) {
+    waitUntilCopyJobFinished({ copyJobInfo, siteUrl, pollingInterval, resolve, reject, logger, debug, verbose }) {
         const requestUrl = `${siteUrl}/_api/site/GetCopyJobProgress`;
         const requestOptions = {
             url: requestUrl,
@@ -118,10 +114,6 @@ exports.spo = {
             data: { "copyJobInfo": copyJobInfo },
             responseType: 'json'
         };
-        if (!debug && verbose) {
-            dots += '.';
-            process.stdout.write(`\r${dots}`);
-        }
         request_1.default
             .post(requestOptions)
             .then((resp) => {
@@ -148,7 +140,7 @@ exports.spo = {
             }
             else {
                 setTimeout(() => {
-                    exports.spo.waitUntilCopyJobFinished({ copyJobInfo, siteUrl, pollingInterval, resolve, reject, logger, dots, debug, verbose });
+                    exports.spo.waitUntilCopyJobFinished({ copyJobInfo, siteUrl, pollingInterval, resolve, reject, logger, debug, verbose });
                 }, pollingInterval);
             }
         });
@@ -456,6 +448,94 @@ exports.spo = {
                 reject('Cannot proceed. Folder _ObjectIdentity_ not found'); // this is not suppose to happen
             }, (err) => { reject(err); });
         });
+    },
+    /**
+     * Retrieves the SiteId, VroomItemId and VroomDriveId from a specific file.
+     * @param webUrl Web url
+     * @param fileId GUID ID of the file
+     * @param fileUrl Decoded URL of the file
+     */
+    getVroomFileDetails(webUrl, fileId, fileUrl) {
+        return __awaiter(this, void 0, void 0, function* () {
+            let requestUrl = `${webUrl}/_api/web/`;
+            if (fileUrl) {
+                const fileServerRelativeUrl = urlUtil_1.urlUtil.getServerRelativePath(webUrl, fileUrl);
+                requestUrl += `GetFileByServerRelativePath(decodedUrl='${formatting_1.formatting.encodeQueryParameter(fileServerRelativeUrl)}')`;
+            }
+            else {
+                requestUrl += `GetFileById('${fileId}')`;
+            }
+            requestUrl += '?$select=SiteId,VroomItemId,VroomDriveId';
+            const requestOptions = {
+                url: requestUrl,
+                headers: {
+                    accept: 'application/json;odata=nometadata'
+                },
+                responseType: 'json'
+            };
+            const res = yield request_1.default.get(requestOptions);
+            return res;
+        });
+    },
+    /**
+     * Retrieves a list of Custom Actions from a SharePoint site.
+     * @param webUrl Web url
+     * @param scope The scope of custom actions to retrieve, allowed values "Site", "Web" or "All".
+     * @param filter An OData filter query to limit the results.
+     */
+    getCustomActions(webUrl, scope, filter) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (scope && scope !== "All" && scope !== "Site" && scope !== "Web") {
+                throw `Invalid scope '${scope}'. Allowed values are 'Site', 'Web' or 'All'.`;
+            }
+            const queryString = filter ? `?$filter=${filter}` : "";
+            if (scope && scope !== "All") {
+                return yield odata_1.odata.getAllItems(`${webUrl}/_api/${scope}/UserCustomActions${queryString}`);
+            }
+            const customActions = [
+                ...yield odata_1.odata.getAllItems(`${webUrl}/_api/Site/UserCustomActions${queryString}`),
+                ...yield odata_1.odata.getAllItems(`${webUrl}/_api/Web/UserCustomActions${queryString}`)
+            ];
+            return customActions;
+        });
+    },
+    /**
+     * Retrieves a Custom Actions from a SharePoint site by Id.
+     * @param webUrl Web url
+     * @param id The Id of the Custom Action
+     * @param scope The scope of custom actions to retrieve, allowed values "Site", "Web" or "All".
+     */
+    getCustomActionById(webUrl, id, scope) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (scope && scope !== "All" && scope !== "Site" && scope !== "Web") {
+                throw `Invalid scope '${scope}'. Allowed values are 'Site', 'Web' or 'All'.`;
+            }
+            function getById(webUrl, id, scope) {
+                return __awaiter(this, void 0, void 0, function* () {
+                    const requestOptions = {
+                        url: `${webUrl}/_api/${scope}/UserCustomActions(guid'${id}')`,
+                        headers: {
+                            accept: 'application/json;odata=nometadata'
+                        },
+                        responseType: 'json'
+                    };
+                    const result = yield request_1.default.get(requestOptions);
+                    if (result["odata.null"] === true) {
+                        return undefined;
+                    }
+                    return result;
+                });
+            }
+            if (scope && scope !== "All") {
+                return yield getById(webUrl, id, scope);
+            }
+            const customActionOnWeb = yield getById(webUrl, id, "Web");
+            if (customActionOnWeb) {
+                return customActionOnWeb;
+            }
+            const customActionOnSite = yield getById(webUrl, id, "Site");
+            return customActionOnSite;
+        });
     }
 };
 //# sourceMappingURL=spo.js.map

package/docs/docs/cmd/aad/license/license-list.md

@@ -0,0 +1,87 @@
+# aad license list
+
+Lists commercial subscriptions that an organization has acquired
+
+## Usage
+
+```sh
+m365 aad license list [options]
+```
+
+## Options
+
+--8<-- "docs/cmd/_global.md"
+
+## Examples
+
+List all licenses within the tenant
+
+```sh
+m365 aad license list
+```
+
+## Response
+
+=== "JSON"
+
+    ```json
+    [
+      {
+        "capabilityStatus": "Enabled",
+        "consumedUnits": 1,
+        "id": "48a80680-7326-48cd-9935-b556b81d3a4e_c7df2760-2c81-4ef7-b578-5b5392b571df",
+        "skuId": "c7df2760-2c81-4ef7-b578-5b5392b571df",
+        "skuPartNumber": "ENTERPRISEPREMIUM",
+        "appliesTo": "User",
+        "prepaidUnits": {
+          "enabled": 10000,
+          "suspended": 0,
+          "warning": 0
+        },
+        "servicePlans": [
+            {
+                "servicePlanId": "8c098270-9dd4-4350-9b30-ba4703f3b36b",
+                "servicePlanName": "ADALLOM_S_O365",
+                "provisioningStatus": "Success",
+                "appliesTo": "User"
+            }
+        ]
+      }
+    ]
+    ```
+
+=== "Text"
+
+    ```text
+    id                                                                         skuId                                 skuPartNumber
+    -------------------------------------------------------------------------  ------------------------------------  ----------------------
+    48a80680-7326-48cd-9935-b556b81d3a4e_c7df2760-2c81-4ef7-b578-5b5392b571df  c7df2760-2c81-4ef7-b578-5b5392b571df  ENTERPRISEPREMIUM
+    ```
+
+=== "CSV"
+
+    ```csv
+    id,skuId,skuPartNumber
+    48a80680-7326-48cd-9935-b556b81d3a4e_c7df2760-2c81-4ef7-b578-5b5392b571df,c7df2760-2c81-4ef7-b578-5b5392b571df,ENTERPRISEPREMIUM
+    ```
+    
+=== "Markdown"
+
+    ```md
+    # aad license list
+
+    Date: 14/2/2023
+
+    ## 48a80680-7326-48cd-9935-b556b81d3a4e_c7df2760-2c81-4ef7-b578-5b5392b571df
+
+    Property | Value
+    ---------|-------
+    capabilityStatus | Enabled
+    consumedUnits | 1
+    id | 48a80680-7326-48cd-9935-b556b81d3a4e_c7df2760-2c81-4ef7-b578-5b5392b571df
+    skuId | c7df2760-2c81-4ef7-b578-5b5392b571df
+    skuPartNumber | ENTERPRISEPREMIUM
+    appliesTo | User
+    prepaidUnits | {"enabled":10000,"suspended":0,"warning":0}
+    servicePlans | [{"servicePlanId":"8c098270-9dd4-4350-9b30-ba4703f3b36b","servicePlanName": "ADALLOM_S_O365","provisioningStatus": "Success","appliesTo": "User"}]
+    ```