@pnp/cli-microsoft365 11.6.0-beta.358a4f1 → 11.6.0-beta.bc374af

package/dist/m365/spo/commands/navigation/navigation-node-get.js

@@ -1,13 +1,18 @@
-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 _SpoNavigationNodeGetCommand_instances, _SpoNavigationNodeGetCommand_initOptions, _SpoNavigationNodeGetCommand_initValidators;
+import { globalOptionsZod } from '../../../../Command.js';
+import { z } from 'zod';
 import request from '../../../../request.js';
 import { validation } from '../../../../utils/validation.js';
 import SpoCommand from '../../../base/SpoCommand.js';
 import commands from '../../commands.js';
+export const options = z.strictObject({
+    ...globalOptionsZod.shape,
+    webUrl: z.string()
+        .refine(url => validation.isValidSharePointUrl(url) === true, {
+        error: e => `'${e.input}' is not a valid SharePoint Online site URL.`
+    })
+        .alias('u'),
+    id: z.int().positive()
+});
 class SpoNavigationNodeGetCommand extends SpoCommand {
     get name() {
         return commands.NAVIGATION_NODE_GET;
@@ -15,25 +20,25 @@ class SpoNavigationNodeGetCommand extends SpoCommand {
     get description() {
         return 'Retrieve information about a specific navigation node';
     }
-    constructor() {
-        super();
-        _SpoNavigationNodeGetCommand_instances.add(this);
-        __classPrivateFieldGet(this, _SpoNavigationNodeGetCommand_instances, "m", _SpoNavigationNodeGetCommand_initOptions).call(this);
-        __classPrivateFieldGet(this, _SpoNavigationNodeGetCommand_instances, "m", _SpoNavigationNodeGetCommand_initValidators).call(this);
+    get schema() {
+        return options;
     }
     async commandAction(logger, args) {
         if (this.verbose) {
             await logger.logToStderr(`Retrieving information about navigation node with id ${args.options.id}`);
         }
         const requestOptions = {
-            url: `${args.options.webUrl}/_api/web/navigation/GetNodeById(${args.options.id})`,
+            url: `${args.options.webUrl}/_api/web/navigation/GetNodeById(${args.options.id})?$expand=Children,Children/Children,Children/Children/Children`,
             headers: {
-                'accept': 'application/json;odata=nometadata'
+                accept: 'application/json;odata=nometadata'
             },
             responseType: 'json'
         };
         try {
             const listInstance = await request.get(requestOptions);
+            if (listInstance['odata.null']) {
+                throw `No navigation node found with id ${args.options.id}.`;
+            }
             await logger.log(listInstance);
         }
         catch (err) {
@@ -41,20 +46,5 @@ class SpoNavigationNodeGetCommand extends SpoCommand {
         }
     }
 }
-_SpoNavigationNodeGetCommand_instances = new WeakSet(), _SpoNavigationNodeGetCommand_initOptions = function _SpoNavigationNodeGetCommand_initOptions() {
-    this.options.unshift({
-        option: '-u, --webUrl <webUrl>'
-    }, {
-        option: '--id <id>'
-    });
-}, _SpoNavigationNodeGetCommand_initValidators = function _SpoNavigationNodeGetCommand_initValidators() {
-    this.validators.push(async (args) => {
-        const id = parseInt(args.options.id);
-        if (isNaN(id)) {
-            return `${args.options.id} is not a valid number`;
-        }
-        return validation.isValidSharePointUrl(args.options.webUrl);
-    });
-};
 export default new SpoNavigationNodeGetCommand();
 //# sourceMappingURL=navigation-node-get.js.map

package/dist/m365/spo/commands/navigation/navigation-node-list.js

@@ -1,13 +1,18 @@
-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 _SpoNavigationNodeListCommand_instances, _SpoNavigationNodeListCommand_initTelemetry, _SpoNavigationNodeListCommand_initOptions, _SpoNavigationNodeListCommand_initValidators;
+import { globalOptionsZod } from '../../../../Command.js';
+import { z } from 'zod';
 import { odata } from '../../../../utils/odata.js';
 import { validation } from '../../../../utils/validation.js';
 import SpoCommand from '../../../base/SpoCommand.js';
 import commands from '../../commands.js';
+export const options = z.strictObject({
+    ...globalOptionsZod.shape,
+    webUrl: z.string()
+        .refine(url => validation.isValidSharePointUrl(url) === true, {
+        error: e => `'${e.input}' is not a valid SharePoint Online site URL.`
+    })
+        .alias('u'),
+    location: z.enum(['QuickLaunch', 'TopNavigationBar']).alias('l')
+});
 class SpoNavigationNodeListCommand extends SpoCommand {
     get name() {
         return commands.NAVIGATION_NODE_LIST;
@@ -18,19 +23,15 @@ class SpoNavigationNodeListCommand extends SpoCommand {
     defaultProperties() {
         return ['Id', 'Title', 'Url'];
     }
-    constructor() {
-        super();
-        _SpoNavigationNodeListCommand_instances.add(this);
-        __classPrivateFieldGet(this, _SpoNavigationNodeListCommand_instances, "m", _SpoNavigationNodeListCommand_initTelemetry).call(this);
-        __classPrivateFieldGet(this, _SpoNavigationNodeListCommand_instances, "m", _SpoNavigationNodeListCommand_initOptions).call(this);
-        __classPrivateFieldGet(this, _SpoNavigationNodeListCommand_instances, "m", _SpoNavigationNodeListCommand_initValidators).call(this);
+    get schema() {
+        return options;
     }
     async commandAction(logger, args) {
         if (this.verbose) {
             await logger.logToStderr(`Retrieving navigation nodes...`);
         }
         try {
-            const res = await odata.getAllItems(`${args.options.webUrl}/_api/web/navigation/${args.options.location.toLowerCase()}`);
+            const res = await odata.getAllItems(`${args.options.webUrl}/_api/web/navigation/${args.options.location.toLowerCase()}?$expand=Children,Children/Children,Children/Children/Children`);
             await logger.log(res);
         }
         catch (err) {
@@ -38,31 +39,5 @@ class SpoNavigationNodeListCommand extends SpoCommand {
         }
     }
 }
-_SpoNavigationNodeListCommand_instances = new WeakSet(), _SpoNavigationNodeListCommand_initTelemetry = function _SpoNavigationNodeListCommand_initTelemetry() {
-    this.telemetry.push((args) => {
-        Object.assign(this.telemetryProperties, {
-            location: args.options.location
-        });
-    });
-}, _SpoNavigationNodeListCommand_initOptions = function _SpoNavigationNodeListCommand_initOptions() {
-    this.options.unshift({
-        option: '-u, --webUrl <webUrl>'
-    }, {
-        option: '-l, --location <location>',
-        autocomplete: ['QuickLaunch', 'TopNavigationBar']
-    });
-}, _SpoNavigationNodeListCommand_initValidators = function _SpoNavigationNodeListCommand_initValidators() {
-    this.validators.push(async (args) => {
-        const isValidSharePointUrl = validation.isValidSharePointUrl(args.options.webUrl);
-        if (isValidSharePointUrl !== true) {
-            return isValidSharePointUrl;
-        }
-        if (args.options.location !== 'QuickLaunch' &&
-            args.options.location !== 'TopNavigationBar') {
-            return `${args.options.location} is not a valid value for the location option. Allowed values are QuickLaunch|TopNavigationBar`;
-        }
-        return true;
-    });
-};
 export default new SpoNavigationNodeListCommand();
 //# sourceMappingURL=navigation-node-list.js.map

package/dist/m365/spo/commands/site/site-accessrequest-setting-set.js

@@ -0,0 +1,102 @@
+import { z } from 'zod';
+import { globalOptionsZod } from '../../../../Command.js';
+import request from '../../../../request.js';
+import { validation } from '../../../../utils/validation.js';
+import SpoCommand from '../../../base/SpoCommand.js';
+import commands from '../../commands.js';
+export const options = z.strictObject({
+    ...globalOptionsZod.shape,
+    siteUrl: z.string()
+        .refine(url => validation.isValidSharePointUrl(url) === true, {
+        error: e => `'${e.input}' is not a valid SharePoint Online site URL.`
+    })
+        .alias('u'),
+    disabled: z.boolean().optional(),
+    ownerGroup: z.boolean().optional(),
+    email: z.string()
+        .refine(email => validation.isValidUserPrincipalName(email), {
+        error: e => `'${e.input}' is not a valid email address.`
+    }).optional(),
+    message: z.string().optional()
+});
+class SpoSiteAccessRequestSettingSetCommand extends SpoCommand {
+    get name() {
+        return commands.SITE_ACCESSREQUEST_SETTING_SET;
+    }
+    get description() {
+        return 'Update access requests for a specific site';
+    }
+    get schema() {
+        return options;
+    }
+    getRefinedSchema(schema) {
+        return schema
+            .refine(o => [o.disabled, o.ownerGroup, o.email].filter(v => v !== undefined).length === 1, {
+            error: 'Specify exactly one of disabled, ownerGroup, or email'
+        })
+            .refine(o => !(o.disabled && typeof o.message !== 'undefined'), {
+            error: 'The message option cannot be used when disabled is specified'
+        });
+    }
+    async commandAction(logger, args) {
+        if (this.verbose) {
+            await logger.logToStderr(`Updating access requests for site '${args.options.siteUrl}'...`);
+        }
+        try {
+            const { siteUrl, ownerGroup, email, message } = args.options;
+            const requestAccessEmail = email || '';
+            if (this.verbose) {
+                await logger.logToStderr(`Updating RequestAccessEmail to '${requestAccessEmail}'...`);
+            }
+            const requestPatchWeb = {
+                url: `${siteUrl}/_api/Web`,
+                headers: {
+                    accept: 'application/json;odata=nometadata'
+                },
+                responseType: 'json',
+                data: {
+                    RequestAccessEmail: requestAccessEmail
+                }
+            };
+            await request.patch(requestPatchWeb);
+            const useAccessRequestDefault = !!ownerGroup;
+            if (this.verbose) {
+                await logger.logToStderr(`Updating UseAccessRequestDefault to '${useAccessRequestDefault}'...`);
+            }
+            const requestUseDefault = {
+                url: `${siteUrl}/_api/Web/SetUseAccessRequestDefaultAndUpdate`,
+                headers: {
+                    accept: 'application/json;odata=nometadata',
+                    'content-type': 'application/json;odata=nometadata'
+                },
+                responseType: 'json',
+                data: {
+                    useAccessRequestDefault: useAccessRequestDefault
+                }
+            };
+            await request.post(requestUseDefault);
+            if (message !== undefined) {
+                if (this.verbose) {
+                    await logger.logToStderr(`Updating access request message to '${message}'...`);
+                }
+                const requestSetMessage = {
+                    url: `${siteUrl}/_api/Web/SetAccessRequestSiteDescriptionAndUpdate`,
+                    headers: {
+                        accept: 'application/json;odata=nometadata',
+                        'content-type': 'application/json;odata=nometadata'
+                    },
+                    responseType: 'json',
+                    data: {
+                        description: message
+                    }
+                };
+                await request.post(requestSetMessage);
+            }
+        }
+        catch (err) {
+            this.handleRejectedODataJsonPromise(err);
+        }
+    }
+}
+export default new SpoSiteAccessRequestSettingSetCommand();
+//# sourceMappingURL=site-accessrequest-setting-set.js.map

package/dist/m365/spo/commands/site/site-add.js

@@ -5,6 +5,7 @@ var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (
 };
 var _SpoSiteAddCommand_instances, _SpoSiteAddCommand_initTelemetry, _SpoSiteAddCommand_initOptions, _SpoSiteAddCommand_initValidators;
 import { setTimeout } from 'timers/promises';
+import { cli } from '../../../../cli/cli.js';
 import config from '../../../../config.js';
 import request from '../../../../request.js';
 import { formatting } from '../../../../utils/formatting.js';
@@ -12,6 +13,7 @@ import { spo } from '../../../../utils/spo.js';
 import { validation } from '../../../../utils/validation.js';
 import SpoCommand from '../../../base/SpoCommand.js';
 import commands from '../../commands.js';
+import { brandCenter } from '../../../../utils/brandCenter.js';
 class SpoSiteAddCommand extends SpoCommand {
     get supportedLcids() {
         // Languages supported by SharePoint
@@ -43,7 +45,7 @@ class SpoSiteAddCommand extends SpoCommand {
         await logger.log(siteUrl);
     }
     async createModernSite(logger, args) {
-        const isTeamSite = args.options.type !== 'CommunicationSite';
+        const isTeamSite = args.options.type !== 'CommunicationSite' && args.options.type !== 'BrandCenter';
         try {
             const spoUrl = await spo.getSpoUrl(logger, this.debug);
             if (this.verbose) {
@@ -128,6 +130,9 @@ class SpoSiteAddCommand extends SpoCommand {
                 if (args.options.owners) {
                     requestOptions.data.request.Owner = args.options.owners;
                 }
+                if (args.options.type === 'BrandCenter') {
+                    await this.addBrandCenter(requestOptions.data.request, logger, args.options.force || false);
+                }
             }
             const response = await request.post(requestOptions);
             if (isTeamSite) {
@@ -325,6 +330,27 @@ class SpoSiteAddCommand extends SpoCommand {
             this.handleRejectedPromise(err);
         }
     }
+    async addBrandCenter(requestData, logger, force) {
+        const brandingCenterConfiguration = await brandCenter.getBrandCenterConfiguration(logger, this.debug);
+        if (brandingCenterConfiguration.IsBrandCenterSiteFeatureEnabled) {
+            throw Error('Brand center site is already created in the tenant.');
+        }
+        const warningMessage = `You agree to activate this site as your official brand center site and turn on the brand center app for use in your organization. Storage locations will be created for uploading files to brand center and managing them. Any uploaded files will be stored in the cloud and managed in a public content delivery network (CDN). The files will be accessible to anyone who is able to extract the URLs that point to them.
+Don't use this feature if your files contain proprietary information, or if you don't have the necessary cloud hosting rights to use them. After creation, that site cannot be deleted.`;
+        if (force) {
+            await logger.logToStderr(warningMessage);
+        }
+        else {
+            const result = await cli.promptForConfirmation({
+                message: `${warningMessage}\n\nDo you want to proceed?`
+            });
+            if (!result) {
+                throw Error('Operation cancelled by the user.');
+            }
+        }
+        const brandCenterFeatureId = '99cd6e8b-189b-4611-ae89-f89105876e43';
+        requestData.AdditionalSiteFeatureIds = [brandCenterFeatureId];
+    }
 }
 _SpoSiteAddCommand_instances = new WeakSet(), _SpoSiteAddCommand_initTelemetry = function _SpoSiteAddCommand_initTelemetry() {
     this.telemetry.push((args) => {
@@ -338,6 +364,7 @@ _SpoSiteAddCommand_instances = new WeakSet(), _SpoSiteAddCommand_initTelemetry =
         telemetryProps.lcid = args.options.lcid;
         telemetryProps.owners = typeof args.options.owners !== 'undefined';
         telemetryProps.withAppCatalog = args.options.withAppCatalog || false;
+        telemetryProps.force = args.options.force || false;
         if (isCommunicationSite) {
             telemetryProps.shareByEmailEnabled = args.options.shareByEmailEnabled || false;
             telemetryProps.siteDesign = args.options.siteDesign;
@@ -357,7 +384,7 @@ _SpoSiteAddCommand_instances = new WeakSet(), _SpoSiteAddCommand_initTelemetry =
 }, _SpoSiteAddCommand_initOptions = function _SpoSiteAddCommand_initOptions() {
     this.options.unshift({
         option: '--type [type]',
-        autocomplete: ['TeamSite', 'CommunicationSite', 'ClassicSite']
+        autocomplete: ['TeamSite', 'CommunicationSite', 'ClassicSite', 'BrandCenter']
     }, {
         option: '-t, --title <title>'
     }, {
@@ -399,24 +426,27 @@ _SpoSiteAddCommand_instances = new WeakSet(), _SpoSiteAddCommand_initTelemetry =
         option: '--withAppCatalog'
     }, {
         option: '--wait'
+    }, {
+        option: '--force'
     });
 }, _SpoSiteAddCommand_initValidators = function _SpoSiteAddCommand_initValidators() {
     this.validators.push(async (args) => {
         const isClassicSite = args.options.type === 'ClassicSite';
-        const isCommunicationSite = args.options.type === 'CommunicationSite';
+        const isCommunicationSite = args.options.type === 'CommunicationSite' || args.options.type === 'BrandCenter';
         const isTeamSite = isCommunicationSite === false && isClassicSite === false;
         if (args.options.type) {
             if (args.options.type !== 'TeamSite' &&
                 args.options.type !== 'CommunicationSite' &&
-                args.options.type !== 'ClassicSite') {
-                return `${args.options.type} is not a valid site type. Allowed types are TeamSite, CommunicationSite, and ClassicSite`;
+                args.options.type !== 'ClassicSite' &&
+                args.options.type !== 'BrandCenter') {
+                return `${args.options.type} is not a valid site type. Allowed types are TeamSite, CommunicationSite, ClassicSite, and BrandCenter`;
             }
         }
         if (isTeamSite) {
             if (!args.options.alias) {
                 return 'Required option alias missing';
             }
-            if (args.options.url || args.options.siteDesign || args.options.removeDeletedSite || args.options.wait || args.options.shareByEmailEnabled || args.options.siteDesignId || args.options.timeZone || args.options.resourceQuota || args.options.resourceQuotaWarningLevel || args.options.storageQuota || args.options.storageQuotaWarningLevel || args.options.webTemplate) {
+            if (args.options.url || args.options.siteDesign || args.options.removeDeletedSite || args.options.wait || args.options.shareByEmailEnabled || args.options.siteDesignId || args.options.timeZone || args.options.resourceQuota || args.options.resourceQuotaWarningLevel || args.options.storageQuota || args.options.storageQuotaWarningLevel || args.options.webTemplate || args.options.force) {
                 return "Type TeamSite supports only the parameters title, lcid, alias, owners, classification, isPublic, and description";
             }
         }
@@ -447,7 +477,7 @@ _SpoSiteAddCommand_instances = new WeakSet(), _SpoSiteAddCommand_initTelemetry =
                 return 'Specify siteDesign or siteDesignId but not both';
             }
             if (args.options.timeZone || args.options.isPublic || args.options.removeDeletedSite || args.options.wait || args.options.alias || args.options.resourceQuota || args.options.resourceQuotaWarningLevel || args.options.storageQuota || args.options.storageQuotaWarningLevel || args.options.webTemplate) {
-                return "Type CommunicationSite supports only the parameters url, title, lcid, classification, siteDesign, shareByEmailEnabled, siteDesignId, owners, and description";
+                return "Type CommunicationSite supports only the parameters url, title, lcid, classification, siteDesign, shareByEmailEnabled, siteDesignId, owners, description, and force";
             }
         }
         else {
@@ -500,7 +530,7 @@ _SpoSiteAddCommand_instances = new WeakSet(), _SpoSiteAddCommand_initTelemetry =
             if (args.options.storageQuotaWarningLevel > args.options.storageQuota) {
                 return `storageQuotaWarningLevel cannot exceed storageQuota`;
             }
-            if (args.options.classification || args.options.shareByEmailEnabled || args.options.siteDesignId || args.options.siteDesignId || args.options.alias || args.options.isPublic) {
+            if (args.options.classification || args.options.shareByEmailEnabled || args.options.siteDesignId || args.options.siteDesignId || args.options.alias || args.options.isPublic || args.options.force) {
                 return "Type ClassicSite supports only the parameters url, title, lcid, storageQuota, storageQuotaWarningLevel, resourceQuota, resourceQuotaWarningLevel, webTemplate, owners, and description";
             }
         }

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

@@ -0,0 +1,112 @@
+import { z } from 'zod';
+import { globalOptionsZod } from '../../../../Command.js';
+import request from '../../../../request.js';
+import { formatting } from '../../../../utils/formatting.js';
+import { spo } from '../../../../utils/spo.js';
+import { validation } from '../../../../utils/validation.js';
+import SpoCommand from '../../../base/SpoCommand.js';
+import commands from '../../commands.js';
+import { cli } from '../../../../cli/cli.js';
+export const options = z.strictObject({
+    ...globalOptionsZod.shape,
+    id: z.uuid().optional().alias('i'),
+    title: z.string().optional().alias('t'),
+    url: z.string().refine(url => validation.isValidSharePointUrl(url) === true, {
+        message: 'Specify a valid SharePoint site URL'
+    }).optional().alias('u')
+});
+class SpoTenantSiteGetCommand extends SpoCommand {
+    get name() {
+        return commands.TENANT_SITE_GET;
+    }
+    get description() {
+        return 'Retrieves the tenant site information';
+    }
+    get schema() {
+        return options;
+    }
+    getRefinedSchema(schema) {
+        return schema.refine(o => [o.id, o.title, o.url].filter(v => v !== undefined).length === 1, {
+            error: `Specify exactly one of the following options: 'id', 'title', or 'url'.`
+        });
+    }
+    async commandAction(logger, args) {
+        if (this.verbose) {
+            await logger.logToStderr(`Retrieving tenant site information for site '${args.options.url || args.options.id || args.options.title}'...`);
+        }
+        try {
+            let siteUrl;
+            if (args.options.url) {
+                siteUrl = args.options.url;
+            }
+            else if (args.options.id) {
+                siteUrl = await this.getSiteUrlById(args.options.id, logger);
+                if (this.verbose) {
+                    await logger.logToStderr(`Retrieved tenant site URL for site '${args.options.id}'...`);
+                }
+            }
+            else {
+                siteUrl = await this.getSiteUrlByTitle(args.options.title, logger);
+                if (this.verbose) {
+                    await logger.logToStderr(`Retrieved tenant site URL for site '${args.options.title}'...`);
+                }
+            }
+            const site = await spo.getSiteAdminPropertiesByUrl(siteUrl, false, logger, this.verbose);
+            await logger.log(site);
+        }
+        catch (err) {
+            this.handleRejectedODataJsonPromise(err);
+        }
+    }
+    async getSiteUrlById(id, logger) {
+        if (this.verbose) {
+            await logger.logToStderr(`Retrieving tenant site URL for site '${id}'...`);
+        }
+        const adminUrl = await spo.getSpoAdminUrl(logger, this.debug);
+        const requestOptions = {
+            url: `${adminUrl}/_api/SPO.Tenant/sites('${id}')?$select=Url`,
+            headers: {
+                accept: 'application/json;odata=nometadata'
+            },
+            responseType: 'json'
+        };
+        const res = await request.get(requestOptions);
+        return res.Url;
+    }
+    async getSiteUrlByTitle(title, logger) {
+        if (this.verbose) {
+            await logger.logToStderr(`Retrieving tenant site URL for site '${title}'...`);
+        }
+        const adminUrl = await spo.getSpoAdminUrl(logger, this.debug);
+        const viewXml = `<View><Query><Where><And><IsNull><FieldRef Name="TimeDeleted"/></IsNull><Eq><FieldRef Name="Title"/><Value Type='Text'>${formatting.escapeXml(title)}</Value></Eq></And></Where></Query><ViewFields><FieldRef Name="Title"/><FieldRef Name="SiteUrl"/><FieldRef Name="SiteId"/></ViewFields></View>`;
+        const requestOptions = {
+            url: `${adminUrl}/_api/web/lists/GetByTitle('DO_NOT_DELETE_SPLIST_TENANTADMIN_AGGREGATED_SITECOLLECTIONS')/RenderListDataAsStream`,
+            headers: {
+                accept: 'application/json;odata=nometadata'
+            },
+            responseType: 'json',
+            data: {
+                parameters: {
+                    ViewXml: viewXml,
+                    DatesInUtc: true
+                }
+            }
+        };
+        const res = await request.post(requestOptions);
+        const rows = res.Row;
+        if (rows.length === 0) {
+            throw `The specified site '${title}' does not exist.`;
+        }
+        if (rows.length > 1) {
+            const resultAsKeyValuePair = rows.reduce((acc, cur) => {
+                acc[cur.SiteUrl] = { url: cur.SiteUrl };
+                return acc;
+            }, {});
+            const selection = await cli.handleMultipleResultsFound(`Multiple sites with title '${title}' found.`, resultAsKeyValuePair);
+            return selection.url;
+        }
+        return rows[0].SiteUrl;
+    }
+}
+export default new SpoTenantSiteGetCommand();
+//# sourceMappingURL=tenant-site-get.js.map

package/dist/m365/spo/commands.js

@@ -1,5 +1,6 @@
 const prefix = 'spo';
 export default {
+    AGENT_ADD: `${prefix} agent add`,
     APP_ADD: `${prefix} app add`,
     APP_DEPLOY: `${prefix} app deploy`,
     APP_GET: `${prefix} app get`,
@@ -255,6 +256,7 @@ export default {
     SERVICEPRINCIPAL_PERMISSIONREQUEST_LIST: `${prefix} serviceprincipal permissionrequest list`,
     SERVICEPRINCIPAL_SET: `${prefix} serviceprincipal set`,
     SET: `${prefix} set`,
+    SITE_ACCESSREQUEST_SETTING_SET: `${prefix} site accessrequest setting set`,
     SITE_ADD: `${prefix} site add`,
     SITE_ADMIN_ADD: `${prefix} site admin add`,
     SITE_ADMIN_LIST: `${prefix} site admin list`,
@@ -337,6 +339,7 @@ export default {
     TENANT_RECYCLEBINITEM_RESTORE: `${prefix} tenant recyclebinitem restore`,
     TENANT_SETTINGS_LIST: `${prefix} tenant settings list`,
     TENANT_SETTINGS_SET: `${prefix} tenant settings set`,
+    TENANT_SITE_GET: `${prefix} tenant site get`,
     TERM_ADD: `${prefix} term add`,
     TERM_GET: `${prefix} term get`,
     TERM_LIST: `${prefix} term list`,

package/dist/utils/accessToken.js

@@ -87,6 +87,27 @@ export const accessToken = {
         const payload = JSON.parse(payloadString);
         return { header, payload };
     },
+    getScopesFromAccessToken(accessToken) {
+        let scopes = [];
+        if (!accessToken || accessToken.length === 0) {
+            return scopes;
+        }
+        const chunks = accessToken.split('.');
+        if (chunks.length !== 3) {
+            return scopes;
+        }
+        const tokenString = Buffer.from(chunks[1], 'base64').toString();
+        try {
+            const token = JSON.parse(tokenString);
+            if (token.scp?.length > 0) {
+                scopes = token.scp.split(' ');
+            }
+        }
+        catch {
+            // Do nothing
+        }
+        return scopes;
+    },
     /**
      * Asserts the presence of a delegated or application-only access token.
      * @throws {CommandError} Will throw an error if the access token is not available.

package/dist/utils/brandCenter.js

@@ -0,0 +1,29 @@
+import request from '../request.js';
+import { spo } from './spo.js';
+export const brandCenter = {
+    /**
+     * Gets the brand center configuration for the specified site
+     * @param logger Logger instance for verbose output
+     * @param debug Debug flag for detailed logging
+     * @returns Promise<BrandCenterConfiguration> Brand center configuration object
+     */
+    async getBrandCenterConfiguration(logger, debug = false) {
+        if (debug) {
+            await logger.logToStderr(`Retrieving brand center configuration...`);
+        }
+        const spoAdminUrl = await spo.getSpoAdminUrl(logger, debug);
+        const brandConfigRequestOptions = {
+            url: `${spoAdminUrl}/_api/SPO.Tenant/GetBrandCenterConfiguration`,
+            headers: {
+                'accept': 'application/json;odata=nometadata'
+            },
+            responseType: 'json'
+        };
+        const brandConfig = await request.get(brandConfigRequestOptions);
+        if (debug) {
+            await logger.logToStderr(`Successfully retrieved brand center configuration`);
+        }
+        return brandConfig;
+    }
+};
+//# sourceMappingURL=brandCenter.js.map

package/docs/docs/cmd/entra/app/app-role-add.mdx

@@ -1,4 +1,6 @@
 import Global from '../../_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
 
 # entra app role add
 
@@ -49,6 +51,25 @@ For best performance use the `appObjectId` option to reference the Entra applica
 
 If the command finds multiple Entra application registrations with the specified app name, it will prompt you to disambiguate which app it should use, listing the discovered object IDs.
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions               |
+  | --------------- | ------------------------- |
+  | Microsoft Graph | Application.ReadWrite.All |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions               |
+  | --------------- | ------------------------- |
+  | Microsoft Graph | Application.ReadWrite.All |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Add role to the Entra application registration specified by its object ID

package/docs/docs/cmd/entra/app/app-role-list.mdx

@@ -39,6 +39,25 @@ For best performance use the `appObjectId` option to reference the Entra applica
 
 If the command finds multiple Entra application registrations with the specified app name, it will prompt you to disambiguate which app it should use, listing the discovered object IDs.
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions          |
+  | --------------- | -------------------- |
+  | Microsoft Graph | Application.Read.All |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions          |
+  | --------------- | -------------------- |
+  | Microsoft Graph | Application.Read.All |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Get roles for the Entra application registration specified by its object ID
@@ -118,4 +137,4 @@ m365 entra app role list --appName "My app"
   ```
 
   </TabItem>
-</Tabs>
+</Tabs>