@pnp/cli-microsoft365 10.0.0-beta.48e9f7d → 10.0.0-beta.787c5f1

package/dist/m365/spo/commands/folder/folder-sharinglink-clear.js

@@ -0,0 +1,111 @@
+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 _SpoFolderSharingLinkClearCommand_instances, _SpoFolderSharingLinkClearCommand_initTelemetry, _SpoFolderSharingLinkClearCommand_initOptions, _SpoFolderSharingLinkClearCommand_initOptionSets, _SpoFolderSharingLinkClearCommand_initValidators, _SpoFolderSharingLinkClearCommand_initTypes;
+import { cli } from '../../../../cli/cli.js';
+import { spo } from '../../../../utils/spo.js';
+import { odata } from '../../../../utils/odata.js';
+import { urlUtil } from '../../../../utils/urlUtil.js';
+import { drive } from '../../../../utils/drive.js';
+import { validation } from '../../../../utils/validation.js';
+import SpoCommand from '../../../base/SpoCommand.js';
+import request from '../../../../request.js';
+import commands from '../../commands.js';
+class SpoFolderSharingLinkClearCommand extends SpoCommand {
+    get name() {
+        return commands.FOLDER_SHARINGLINK_CLEAR;
+    }
+    get description() {
+        return 'Removes all sharing links of a folder';
+    }
+    constructor() {
+        super();
+        _SpoFolderSharingLinkClearCommand_instances.add(this);
+        this.allowedScopes = ['anonymous', 'users', 'organization'];
+        __classPrivateFieldGet(this, _SpoFolderSharingLinkClearCommand_instances, "m", _SpoFolderSharingLinkClearCommand_initTelemetry).call(this);
+        __classPrivateFieldGet(this, _SpoFolderSharingLinkClearCommand_instances, "m", _SpoFolderSharingLinkClearCommand_initOptions).call(this);
+        __classPrivateFieldGet(this, _SpoFolderSharingLinkClearCommand_instances, "m", _SpoFolderSharingLinkClearCommand_initOptionSets).call(this);
+        __classPrivateFieldGet(this, _SpoFolderSharingLinkClearCommand_instances, "m", _SpoFolderSharingLinkClearCommand_initValidators).call(this);
+        __classPrivateFieldGet(this, _SpoFolderSharingLinkClearCommand_instances, "m", _SpoFolderSharingLinkClearCommand_initTypes).call(this);
+    }
+    async commandAction(logger, args) {
+        const clearSharingLinks = async () => {
+            if (this.verbose) {
+                await logger.logToStderr(`Clearing sharing links from folder ${args.options.folderId || args.options.folderUrl} for ${args.options.scope ? `${args.options.scope} scope` : 'all scopes'}`);
+            }
+            try {
+                const relFolderUrl = await spo.getFolderServerRelativeUrl(args.options.webUrl, args.options.folderUrl, args.options.folderId, logger, args.options.verbose);
+                const absoluteFolderUrl = urlUtil.getAbsoluteUrl(args.options.webUrl, relFolderUrl);
+                const folderUrl = new URL(absoluteFolderUrl);
+                const siteId = await spo.getSiteId(args.options.webUrl);
+                const driveDetails = await drive.getDriveByUrl(siteId, folderUrl, logger, args.options.verbose);
+                const itemId = await drive.getDriveItemId(driveDetails, folderUrl, logger, args.options.verbose);
+                let requestUrl = `https://graph.microsoft.com/v1.0/drives/${driveDetails.id}/items/${itemId}/permissions?$filter=Link ne null`;
+                if (args.options.scope) {
+                    requestUrl += ` and Link/Scope eq '${args.options.scope}'`;
+                }
+                const sharingLinks = await odata.getAllItems(requestUrl);
+                for (const sharingLink of sharingLinks) {
+                    const requestOptions = {
+                        url: `https://graph.microsoft.com/v1.0/drives/${driveDetails.id}/items/${itemId}/permissions/${sharingLink.id}`,
+                        headers: {
+                            accept: 'application/json;odata.metadata=none'
+                        }
+                    };
+                    await request.delete(requestOptions);
+                }
+            }
+            catch (err) {
+                this.handleRejectedODataJsonPromise(err);
+            }
+        };
+        if (args.options.force) {
+            await clearSharingLinks();
+        }
+        else {
+            const result = await cli.promptForConfirmation({ message: `Are you sure you want to clear sharing links from folder ${args.options.folderUrl || args.options.folderId}? for ${args.options.scope ? `${args.options.scope} scope` : 'all scopes'}` });
+            if (result) {
+                await clearSharingLinks();
+            }
+        }
+    }
+}
+_SpoFolderSharingLinkClearCommand_instances = new WeakSet(), _SpoFolderSharingLinkClearCommand_initTelemetry = function _SpoFolderSharingLinkClearCommand_initTelemetry() {
+    this.telemetry.push((args) => {
+        Object.assign(this.telemetryProperties, {
+            webUrl: typeof args.options.webUrl !== 'undefined',
+            folderUrl: typeof args.options.folderUrl !== 'undefined',
+            folderId: typeof args.options.folderId !== 'undefined',
+            scope: typeof args.options.scope !== 'undefined',
+            force: !!args.options.force
+        });
+    });
+}, _SpoFolderSharingLinkClearCommand_initOptions = function _SpoFolderSharingLinkClearCommand_initOptions() {
+    this.options.unshift({ option: '-u, --webUrl <webUrl>' }, { option: '--folderUrl [folderUrl]' }, { option: '--folderId [folderId]' }, {
+        option: '--scope [scope]',
+        autocomplete: this.allowedScopes
+    }, { option: '-f, --force' });
+}, _SpoFolderSharingLinkClearCommand_initOptionSets = function _SpoFolderSharingLinkClearCommand_initOptionSets() {
+    this.optionSets.push({ options: ['folderUrl', 'folderId'] });
+}, _SpoFolderSharingLinkClearCommand_initValidators = function _SpoFolderSharingLinkClearCommand_initValidators() {
+    this.validators.push(async (args) => {
+        const isValidSharePointUrl = validation.isValidSharePointUrl(args.options.webUrl);
+        if (isValidSharePointUrl !== true) {
+            return isValidSharePointUrl;
+        }
+        if (args.options.folderId && !validation.isValidGuid(args.options.folderId)) {
+            return `${args.options.folderId} is not a valid GUID`;
+        }
+        if (args.options.scope && !this.allowedScopes.some(scope => scope === args.options.scope)) {
+            return `'${args.options.scope}' is not a valid scope. Allowed values are: ${this.allowedScopes.join(',')}`;
+        }
+        return true;
+    });
+}, _SpoFolderSharingLinkClearCommand_initTypes = function _SpoFolderSharingLinkClearCommand_initTypes() {
+    this.types.string.push('webUrl', 'folderUrl', 'folderId', 'scope');
+    this.types.boolean.push('force');
+};
+export default new SpoFolderSharingLinkClearCommand();
+//# sourceMappingURL=folder-sharinglink-clear.js.map

package/dist/m365/spo/commands/folder/folder-sharinglink-remove.js

@@ -0,0 +1,95 @@
+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 _SpoFolderSharingLinkRemoveCommand_instances, _SpoFolderSharingLinkRemoveCommand_initTelemetry, _SpoFolderSharingLinkRemoveCommand_initOptions, _SpoFolderSharingLinkRemoveCommand_initOptionSets, _SpoFolderSharingLinkRemoveCommand_initValidators, _SpoFolderSharingLinkRemoveCommand_initTypes;
+import { cli } from '../../../../cli/cli.js';
+import { spo } from '../../../../utils/spo.js';
+import { urlUtil } from '../../../../utils/urlUtil.js';
+import { drive } from '../../../../utils/drive.js';
+import { validation } from '../../../../utils/validation.js';
+import SpoCommand from '../../../base/SpoCommand.js';
+import request from '../../../../request.js';
+import commands from '../../commands.js';
+class SpoFolderSharingLinkRemoveCommand extends SpoCommand {
+    get name() {
+        return commands.FOLDER_SHARINGLINK_REMOVE;
+    }
+    get description() {
+        return 'Removes a sharing link from a folder';
+    }
+    constructor() {
+        super();
+        _SpoFolderSharingLinkRemoveCommand_instances.add(this);
+        __classPrivateFieldGet(this, _SpoFolderSharingLinkRemoveCommand_instances, "m", _SpoFolderSharingLinkRemoveCommand_initTelemetry).call(this);
+        __classPrivateFieldGet(this, _SpoFolderSharingLinkRemoveCommand_instances, "m", _SpoFolderSharingLinkRemoveCommand_initOptions).call(this);
+        __classPrivateFieldGet(this, _SpoFolderSharingLinkRemoveCommand_instances, "m", _SpoFolderSharingLinkRemoveCommand_initOptionSets).call(this);
+        __classPrivateFieldGet(this, _SpoFolderSharingLinkRemoveCommand_instances, "m", _SpoFolderSharingLinkRemoveCommand_initValidators).call(this);
+        __classPrivateFieldGet(this, _SpoFolderSharingLinkRemoveCommand_instances, "m", _SpoFolderSharingLinkRemoveCommand_initTypes).call(this);
+    }
+    async commandAction(logger, args) {
+        const removeSharingLink = async () => {
+            if (this.verbose) {
+                await logger.logToStderr(`Removing sharing link of folder ${args.options.folderId || args.options.folderUrl} with id ${args.options.id}...`);
+            }
+            try {
+                const relFolderUrl = await spo.getFolderServerRelativeUrl(args.options.webUrl, args.options.folderUrl, args.options.folderId, logger, args.options.verbose);
+                const absoluteFolderUrl = urlUtil.getAbsoluteUrl(args.options.webUrl, relFolderUrl);
+                const folderUrl = new URL(absoluteFolderUrl);
+                const siteId = await spo.getSiteId(args.options.webUrl);
+                const driveDetails = await drive.getDriveByUrl(siteId, folderUrl, logger, args.options.verbose);
+                const itemId = await drive.getDriveItemId(driveDetails, folderUrl, logger, args.options.verbose);
+                const requestOptions = {
+                    url: `https://graph.microsoft.com/v1.0/drives/${driveDetails.id}/items/${itemId}/permissions/${args.options.id}`,
+                    headers: {
+                        accept: 'application/json;odata.metadata=none'
+                    },
+                    responseType: 'json'
+                };
+                return request.delete(requestOptions);
+            }
+            catch (err) {
+                this.handleRejectedODataJsonPromise(err);
+            }
+        };
+        if (args.options.force) {
+            await removeSharingLink();
+        }
+        else {
+            const result = await cli.promptForConfirmation({ message: `Are you sure you want to remove sharing link ${args.options.id} of folder ${args.options.folderUrl || args.options.folderId}?` });
+            if (result) {
+                await removeSharingLink();
+            }
+        }
+    }
+}
+_SpoFolderSharingLinkRemoveCommand_instances = new WeakSet(), _SpoFolderSharingLinkRemoveCommand_initTelemetry = function _SpoFolderSharingLinkRemoveCommand_initTelemetry() {
+    this.telemetry.push((args) => {
+        Object.assign(this.telemetryProperties, {
+            folderUrl: typeof args.options.folderUrl !== 'undefined',
+            folderId: typeof args.options.folderId !== 'undefined',
+            force: !!args.options.force
+        });
+    });
+}, _SpoFolderSharingLinkRemoveCommand_initOptions = function _SpoFolderSharingLinkRemoveCommand_initOptions() {
+    this.options.unshift({ option: '-u, --webUrl <webUrl>' }, { option: '--folderUrl [folderUrl]' }, { option: '--folderId [folderId]' }, { option: '-i, --id <id>' }, { option: '-f, --force' });
+}, _SpoFolderSharingLinkRemoveCommand_initOptionSets = function _SpoFolderSharingLinkRemoveCommand_initOptionSets() {
+    this.optionSets.push({ options: ['folderUrl', 'folderId'] });
+}, _SpoFolderSharingLinkRemoveCommand_initValidators = function _SpoFolderSharingLinkRemoveCommand_initValidators() {
+    this.validators.push(async (args) => {
+        const isValidSharePointUrl = validation.isValidSharePointUrl(args.options.webUrl);
+        if (isValidSharePointUrl !== true) {
+            return isValidSharePointUrl;
+        }
+        if (args.options.folderId && !validation.isValidGuid(args.options.folderId)) {
+            return `${args.options.folderId} is not a valid GUID`;
+        }
+        return true;
+    });
+}, _SpoFolderSharingLinkRemoveCommand_initTypes = function _SpoFolderSharingLinkRemoveCommand_initTypes() {
+    this.types.string.push('webUrl', 'folderUrl', 'folderId', 'id');
+    this.types.boolean.push('force');
+};
+export default new SpoFolderSharingLinkRemoveCommand();
+//# sourceMappingURL=folder-sharinglink-remove.js.map

package/dist/m365/spo/commands/list/list-get.js

@@ -22,6 +22,7 @@ class SpoListGetCommand extends SpoCommand {
     constructor() {
         super();
         _SpoListGetCommand_instances.add(this);
+        this.supportedBaseTemplates = [101, 109, 110, 111, 113, 114, 115, 116, 117, 119, 121, 122, 123, 126, 130, 175];
         __classPrivateFieldGet(this, _SpoListGetCommand_instances, "m", _SpoListGetCommand_initTelemetry).call(this);
         __classPrivateFieldGet(this, _SpoListGetCommand_instances, "m", _SpoListGetCommand_initOptions).call(this);
         __classPrivateFieldGet(this, _SpoListGetCommand_instances, "m", _SpoListGetCommand_initValidators).call(this);
@@ -50,11 +51,8 @@ class SpoListGetCommand extends SpoCommand {
         if (fieldsProperties.expandProperties.length > 0) {
             queryParams.push(`$expand=${fieldsProperties.expandProperties.join(',')}`);
         }
-        if (queryParams.length === 0) {
-            queryParams.push(`$expand=VersionPolicies`);
-        }
         const requestOptions = {
-            url: `${requestUrl}?${queryParams.join('&')}`,
+            url: `${requestUrl}${queryParams.length > 0 ? `?${queryParams.join('&')}` : ''}`,
             headers: {
                 'accept': 'application/json;odata=nometadata'
             },
@@ -67,6 +65,9 @@ class SpoListGetCommand extends SpoCommand {
                     r.Member.PrincipalTypeString = ListPrincipalType[r.Member.PrincipalType];
                 });
             }
+            if (this.supportedBaseTemplates.some(template => template === listInstance.BaseTemplate)) {
+                await this.retrieveVersionPolicies(requestUrl, listInstance);
+            }
             if (listInstance.VersionPolicies) {
                 listInstance.VersionPolicies.DefaultTrimModeValue = DefaultTrimModeType[listInstance.VersionPolicies.DefaultTrimMode];
             }
@@ -96,6 +97,18 @@ class SpoListGetCommand extends SpoCommand {
             expandProperties: [...new Set(expandProperties)]
         };
     }
+    async retrieveVersionPolicies(requestUrl, listInstance) {
+        const requestOptions = {
+            url: `${requestUrl}?$select=VersionPolicies&$expand=VersionPolicies`,
+            headers: {
+                'accept': 'application/json;odata=nometadata'
+            },
+            responseType: 'json'
+        };
+        const { VersionPolicies } = await request.get(requestOptions);
+        listInstance.VersionPolicies = VersionPolicies;
+        listInstance.VersionPolicies.DefaultTrimModeValue = DefaultTrimModeType[listInstance.VersionPolicies.DefaultTrimMode];
+    }
 }
 _SpoListGetCommand_instances = new WeakSet(), _SpoListGetCommand_initTelemetry = function _SpoListGetCommand_initTelemetry() {
     this.telemetry.push((args) => {

package/dist/m365/spo/commands/page/page-section-add.js

@@ -3,13 +3,14 @@ var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (
     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 _SpoPageSectionAddCommand_instances, _a, _SpoPageSectionAddCommand_initTelemetry, _SpoPageSectionAddCommand_initOptions, _SpoPageSectionAddCommand_initValidators;
+var _SpoPageSectionAddCommand_instances, _SpoPageSectionAddCommand_initTelemetry, _SpoPageSectionAddCommand_initOptions, _SpoPageSectionAddCommand_initValidators, _SpoPageSectionAddCommand_initTypes;
+import { v4 } from 'uuid';
 import request from '../../../../request.js';
 import { formatting } from '../../../../utils/formatting.js';
 import { validation } from '../../../../utils/validation.js';
 import SpoCommand from '../../../base/SpoCommand.js';
 import commands from '../../commands.js';
-import { CanvasSectionTemplate, ZoneEmphasis } from './clientsidepages.js';
+import { CanvasSectionTemplate } from './clientsidepages.js';
 class SpoPageSectionAddCommand extends SpoCommand {
     get name() {
         return commands.PAGE_SECTION_ADD;
@@ -20,13 +21,18 @@ class SpoPageSectionAddCommand extends SpoCommand {
     constructor() {
         super();
         _SpoPageSectionAddCommand_instances.add(this);
+        this.sectionTemplate = ['OneColumn', 'OneColumnFullWidth', 'TwoColumn', 'ThreeColumn', 'TwoColumnLeft', 'TwoColumnRight', 'Vertical'];
+        this.zoneEmphasis = ['None', 'Neutral', 'Soft', 'Strong', 'Image', 'Gradient'];
+        this.iconAlignment = ['Left', 'Right'];
+        this.fillMode = ['ScaleToFill', 'ScaleToFit', 'Tile', 'OriginalSize'];
         __classPrivateFieldGet(this, _SpoPageSectionAddCommand_instances, "m", _SpoPageSectionAddCommand_initTelemetry).call(this);
         __classPrivateFieldGet(this, _SpoPageSectionAddCommand_instances, "m", _SpoPageSectionAddCommand_initOptions).call(this);
         __classPrivateFieldGet(this, _SpoPageSectionAddCommand_instances, "m", _SpoPageSectionAddCommand_initValidators).call(this);
+        __classPrivateFieldGet(this, _SpoPageSectionAddCommand_instances, "m", _SpoPageSectionAddCommand_initTypes).call(this);
     }
     async commandAction(logger, args) {
         let pageFullName = args.options.pageName.toLowerCase();
-        if (pageFullName.indexOf('.aspx') < 0) {
+        if (!pageFullName.endsWith('.aspx')) {
             pageFullName += '.aspx';
         }
         let canvasContent;
@@ -66,11 +72,22 @@ class SpoPageSectionAddCommand extends SpoCommand {
                 .sort();
             // zoneIndex for the new section to add
             const zoneIndex = this.getSectionIndex(zoneIndices, args.options.order);
+            let zoneId;
+            let backgroundControlToAdd = undefined;
+            if (args.options.zoneEmphasis && ['image', 'gradient'].includes(args.options.zoneEmphasis.toLowerCase())) {
+                zoneId = v4();
+                // get background control based on control type 14
+                const backgroundControl = canvasContent.find(c => c.controlType === 14);
+                backgroundControlToAdd = this.setBackgroundControl(zoneId, backgroundControl, args);
+                if (!backgroundControl) {
+                    canvasContent.push(backgroundControlToAdd);
+                }
+            }
             // get the list of columns to insert based on the selected template
-            const columnsToAdd = this.getColumns(zoneIndex, args.options.sectionTemplate, args.options.zoneEmphasis, args.options.isLayoutReflowOnTop);
+            const columnsToAdd = this.getColumns(zoneIndex, args, zoneId);
             // insert the column in the right place in the array so that
             // it stays sorted ascending by zoneIndex
-            let pos = canvasContent.findIndex(c => typeof c.controlType === 'undefined' && c.position.zoneIndex > zoneIndex);
+            let pos = canvasContent.findIndex(c => typeof c.controlType === 'undefined' && c.position && c.position.zoneIndex > zoneIndex);
             if (pos === -1) {
                 pos = canvasContent.length - 1;
             }
@@ -107,71 +124,146 @@ class SpoPageSectionAddCommand extends SpoCommand {
         }
         return zoneIndices[order - 2] + ((zoneIndices[order - 1] - zoneIndices[order - 2]) / 2);
     }
-    getColumns(zoneIndex, sectionTemplate, zoneEmphasis, isLayoutReflowOnTop) {
+    getColumns(zoneIndex, args, zoneId) {
         const columns = [];
         let sectionIndex = 1;
-        switch (sectionTemplate) {
+        switch (args.options.sectionTemplate) {
             case 'OneColumnFullWidth':
-                columns.push(this.getColumn(zoneIndex, sectionIndex++, 0, zoneEmphasis));
+                columns.push(this.getColumn(zoneIndex, sectionIndex++, 0, args, zoneId));
                 break;
             case 'TwoColumn':
-                columns.push(this.getColumn(zoneIndex, sectionIndex++, 6, zoneEmphasis));
-                columns.push(this.getColumn(zoneIndex, sectionIndex++, 6, zoneEmphasis));
+                columns.push(this.getColumn(zoneIndex, sectionIndex++, 6, args, zoneId));
+                columns.push(this.getColumn(zoneIndex, sectionIndex++, 6, args, zoneId));
                 break;
             case 'ThreeColumn':
-                columns.push(this.getColumn(zoneIndex, sectionIndex++, 4, zoneEmphasis));
-                columns.push(this.getColumn(zoneIndex, sectionIndex++, 4, zoneEmphasis));
-                columns.push(this.getColumn(zoneIndex, sectionIndex++, 4, zoneEmphasis));
+                columns.push(this.getColumn(zoneIndex, sectionIndex++, 4, args, zoneId));
+                columns.push(this.getColumn(zoneIndex, sectionIndex++, 4, args, zoneId));
+                columns.push(this.getColumn(zoneIndex, sectionIndex++, 4, args, zoneId));
                 break;
             case 'TwoColumnLeft':
-                columns.push(this.getColumn(zoneIndex, sectionIndex++, 8, zoneEmphasis));
-                columns.push(this.getColumn(zoneIndex, sectionIndex++, 4, zoneEmphasis));
+                columns.push(this.getColumn(zoneIndex, sectionIndex++, 8, args, zoneId));
+                columns.push(this.getColumn(zoneIndex, sectionIndex++, 4, args, zoneId));
                 break;
             case 'TwoColumnRight':
-                columns.push(this.getColumn(zoneIndex, sectionIndex++, 4, zoneEmphasis));
-                columns.push(this.getColumn(zoneIndex, sectionIndex++, 8, zoneEmphasis));
+                columns.push(this.getColumn(zoneIndex, sectionIndex++, 4, args, zoneId));
+                columns.push(this.getColumn(zoneIndex, sectionIndex++, 8, args, zoneId));
                 break;
             case 'Vertical':
-                columns.push(this.getVerticalColumn(zoneEmphasis, isLayoutReflowOnTop));
+                columns.push(this.getVerticalColumn(args, zoneId));
                 break;
             case 'OneColumn':
             default:
-                columns.push(this.getColumn(zoneIndex, sectionIndex++, 12, zoneEmphasis));
+                columns.push(this.getColumn(zoneIndex, sectionIndex++, 12, args, zoneId));
                 break;
         }
         return columns;
     }
-    getColumn(zoneIndex, sectionIndex, sectionFactor, zoneEmphasis) {
+    getColumn(zoneIndex, sectionIndex, sectionFactor, args, zoneId) {
+        const { zoneEmphasis, isCollapsibleSection, isExpanded, showDivider, iconAlignment } = args.options;
         const columnValue = {
             displayMode: 2,
             position: {
                 zoneIndex: zoneIndex,
                 sectionIndex: sectionIndex,
                 sectionFactor: sectionFactor,
-                layoutIndex: 1
+                layoutIndex: 1,
+                zoneId: zoneId
             },
             emphasis: {}
         };
-        if (zoneEmphasis) {
-            const zoneEmphasisValue = ZoneEmphasis[zoneEmphasis];
+        if (zoneEmphasis && ['none', 'neutral', 'soft', 'strong'].includes(zoneEmphasis?.toLocaleLowerCase())) {
+            // Just these zoneEmphasis values should be added to column emphasis
+            const zoneEmphasisValue = ['none', 'neutral', 'soft', 'strong'].indexOf(zoneEmphasis.toLocaleLowerCase());
             columnValue.emphasis = { zoneEmphasis: zoneEmphasisValue };
         }
+        if (isCollapsibleSection) {
+            columnValue.zoneGroupMetadata = {
+                type: 1,
+                isExpanded: !!isExpanded,
+                showDividerLine: !!showDivider,
+                iconAlignment: iconAlignment && iconAlignment.toLocaleLowerCase() === "right" ? "right" : "left"
+            };
+        }
         return columnValue;
     }
-    getVerticalColumn(zoneEmphasis, isLayoutReflowOnTop) {
-        const columnValue = this.getColumn(1, 1, 12, zoneEmphasis);
-        columnValue.position.isLayoutReflowOnTop = isLayoutReflowOnTop !== undefined ? true : false;
+    getVerticalColumn(args, zoneId) {
+        const columnValue = this.getColumn(1, 1, 12, args, zoneId);
+        columnValue.position.isLayoutReflowOnTop = args.options.isLayoutReflowOnTop !== undefined;
         columnValue.position.layoutIndex = 2;
         columnValue.position.controlIndex = 1;
         return columnValue;
     }
+    setBackgroundControl(zoneId, backgroundControl, args) {
+        const { overlayColor, overlayOpacity, useLightText, imageUrl } = args.options;
+        const backgroundDetails = this.getBackgroundDetails(args);
+        if (!backgroundControl) {
+            backgroundControl = {
+                controlType: 14,
+                webPartData: {
+                    properties: {
+                        zoneBackground: {}
+                    },
+                    serverProcessedContent: {
+                        htmlStrings: {},
+                        searchablePlainTexts: {},
+                        imageSources: {},
+                        links: {}
+                    },
+                    dataVersion: "1.0"
+                }
+            };
+        }
+        backgroundControl.webPartData.properties.zoneBackground[zoneId] = {
+            ...backgroundDetails,
+            useLightText: !!useLightText,
+            overlay: {
+                color: overlayColor ? overlayColor : "#FFFFFF",
+                opacity: overlayOpacity ? overlayOpacity : 60
+            }
+        };
+        if (imageUrl && backgroundControl.webPartData.serverProcessedContent.imageSources) {
+            backgroundControl.webPartData.serverProcessedContent.imageSources[`zoneBackground.${zoneId}.imageData.url`] = imageUrl;
+        }
+        return backgroundControl;
+    }
+    getBackgroundDetails(args) {
+        const { gradientText, imageUrl, imageHeight, imageWidth, fillMode } = args.options;
+        const backgroundDetails = {};
+        if (gradientText) {
+            backgroundDetails.type = "gradient";
+            backgroundDetails.gradient = gradientText;
+        }
+        if (imageUrl) {
+            backgroundDetails.type = "image";
+            backgroundDetails.imageData = {
+                source: 2,
+                fileName: "sectionbackground.jpg",
+                height: imageHeight ? imageHeight : 955,
+                width: imageWidth ? imageWidth : 555
+            };
+            backgroundDetails.fillMode = fillMode ? this.fillMode.indexOf(fillMode) : 0;
+        }
+        return backgroundDetails;
+    }
 }
-_a = SpoPageSectionAddCommand, _SpoPageSectionAddCommand_instances = new WeakSet(), _SpoPageSectionAddCommand_initTelemetry = function _SpoPageSectionAddCommand_initTelemetry() {
+_SpoPageSectionAddCommand_instances = new WeakSet(), _SpoPageSectionAddCommand_initTelemetry = function _SpoPageSectionAddCommand_initTelemetry() {
     this.telemetry.push((args) => {
         Object.assign(this.telemetryProperties, {
             order: typeof args.options.order !== 'undefined',
             zoneEmphasis: typeof args.options.zoneEmphasis !== 'undefined',
-            isLayoutReflowOnTop: !!args.options.isLayoutReflowOnTop
+            isLayoutReflowOnTop: !!args.options.isLayoutReflowOnTop,
+            isCollapsibleSection: !!args.options.isCollapsibleSection,
+            showDivider: !!typeof args.options.showDivider,
+            iconAlignment: typeof args.options.iconAlignment !== 'undefined',
+            isExpanded: !!args.options.isExpanded,
+            gradientText: typeof args.options.gradientText !== 'undefined',
+            imageUrl: typeof args.options.imageUrl !== 'undefined',
+            imageHeight: typeof args.options.imageHeight !== 'undefined',
+            imageWidth: typeof args.options.imageWidth !== 'undefined',
+            fillMode: typeof args.options.fillMode !== 'undefined',
+            useLightText: !!args.options.useLightText,
+            overlayColor: typeof args.options.overlayColor !== 'undefined',
+            overlayOpacity: typeof args.options.overlayOpacity !== 'undefined'
         });
     });
 }, _SpoPageSectionAddCommand_initOptions = function _SpoPageSectionAddCommand_initOptions() {
@@ -181,14 +273,40 @@ _a = SpoPageSectionAddCommand, _SpoPageSectionAddCommand_instances = new WeakSet
         option: '-u, --webUrl <webUrl>'
     }, {
         option: '-t, --sectionTemplate <sectionTemplate>',
-        autocomplete: _a.SectionTemplate
+        autocomplete: this.sectionTemplate
     }, {
         option: '--order [order]'
     }, {
         option: '--zoneEmphasis [zoneEmphasis]',
-        autocomplete: _a.ZoneEmphasis
+        autocomplete: this.zoneEmphasis
     }, {
         option: '--isLayoutReflowOnTop'
+    }, {
+        option: '--isCollapsibleSection'
+    }, {
+        option: '--showDivider'
+    }, {
+        option: '--iconAlignment [iconAlignment]',
+        autocomplete: this.iconAlignment
+    }, {
+        option: '--isExpanded'
+    }, {
+        option: '--gradientText [gradientText]'
+    }, {
+        option: '--imageUrl [imageUrl]'
+    }, {
+        option: '--imageHeight [imageHeight]'
+    }, {
+        option: '--imageWidth [imageWidth]'
+    }, {
+        option: '--fillMode [fillMode]',
+        autocomplete: this.fillMode
+    }, {
+        option: '--useLightText'
+    }, {
+        option: '--overlayColor [overlayColor]'
+    }, {
+        option: '--overlayOpacity [overlayOpacity]'
     });
 }, _SpoPageSectionAddCommand_initValidators = function _SpoPageSectionAddCommand_initValidators() {
     this.validators.push(async (args) => {
@@ -201,8 +319,8 @@ _a = SpoPageSectionAddCommand, _SpoPageSectionAddCommand_instances = new WeakSet
             }
         }
         if (typeof args.options.zoneEmphasis !== 'undefined') {
-            if (!(args.options.zoneEmphasis in ZoneEmphasis)) {
-                return 'The value of parameter zoneEmphasis must be None|Neutral|Soft|Strong';
+            if (!this.zoneEmphasis.some(zoneEmphasisValue => zoneEmphasisValue.toLocaleLowerCase() === args.options.zoneEmphasis?.toLowerCase())) {
+                return `The value of parameter zoneEmphasis must be ${this.zoneEmphasis.join(', ')}`;
             }
         }
         if (typeof args.options.isLayoutReflowOnTop !== 'undefined') {
@@ -210,10 +328,43 @@ _a = SpoPageSectionAddCommand, _SpoPageSectionAddCommand_instances = new WeakSet
                 return 'Specify isLayoutReflowOnTop when the sectionTemplate is set to Vertical.';
             }
         }
+        if (typeof args.options.iconAlignment !== 'undefined') {
+            if (!this.iconAlignment.some(iconAlignmentValue => iconAlignmentValue.toLocaleLowerCase() === args.options.iconAlignment?.toLowerCase())) {
+                return `The value of parameter iconAlignment must be ${this.iconAlignment.join(', ')}`;
+            }
+        }
+        if (typeof args.options.fillMode !== 'undefined') {
+            if (!this.fillMode.some(fillModeValue => fillModeValue.toLocaleLowerCase() === args.options.fillMode?.toLowerCase())) {
+                return `The value of parameter fillMode must be ${this.fillMode.join(', ')}`;
+            }
+        }
+        if (args.options.zoneEmphasis?.toLocaleLowerCase() !== 'image' && (args.options.imageUrl || args.options.imageWidth ||
+            args.options.imageHeight || args.options.fillMode)) {
+            return 'Specify imageUrl, imageWidth, imageHeight or fillMode only when zoneEmphasis is set to Image';
+        }
+        if (args.options.zoneEmphasis?.toLocaleLowerCase() === 'image' && !args.options.imageUrl) {
+            return 'Specify imageUrl when zoneEmphasis is set to Image';
+        }
+        if (args.options.zoneEmphasis?.toLowerCase() !== 'gradient' && args.options.gradientText) {
+            return 'Specify gradientText only when zoneEmphasis is set to Gradient';
+        }
+        if (args.options.zoneEmphasis?.toLowerCase() === 'gradient' && !args.options.gradientText) {
+            return 'Specify gradientText when zoneEmphasis is set to Gradient';
+        }
+        if (args.options.overlayOpacity && (args.options.overlayOpacity < 0 || args.options.overlayOpacity > 100)) {
+            return 'The value of parameter overlayOpacity must be between 0 and 100';
+        }
+        if (args.options.overlayColor && !/^#[0-9a-f]{6}$/i.test(args.options.overlayColor)) {
+            return 'The value of parameter overlayColor must be a valid hex color';
+        }
+        if (!(args.options.zoneEmphasis && ['image', 'gradient'].includes(args.options.zoneEmphasis.toLowerCase())) && (args.options.overlayColor || args.options.overlayOpacity || args.options.useLightText)) {
+            return 'Specify overlayColor or overlayOpacity only when zoneEmphasis is set to Image or Gradient';
+        }
         return validation.isValidSharePointUrl(args.options.webUrl);
     });
+}, _SpoPageSectionAddCommand_initTypes = function _SpoPageSectionAddCommand_initTypes() {
+    this.types.string = ['pageName', 'webUrl', 'sectionTemplate', 'zoneEmphasis', 'iconAlignment', 'gradientText', 'imageUrl', 'fillMode', 'overlayColor'];
+    this.types.boolean = ['isLayoutReflowOnTop', 'isCollapsibleSection', 'showDivider', 'isExpanded', 'useLightText'];
 };
-SpoPageSectionAddCommand.SectionTemplate = ['OneColumn', 'OneColumnFullWidth', 'TwoColumn', 'ThreeColumn', 'TwoColumnLeft', 'TwoColumnRight', 'Vertical'];
-SpoPageSectionAddCommand.ZoneEmphasis = ['None', 'Neutral', 'Soft', 'Strong'];
 export default new SpoPageSectionAddCommand();
 //# sourceMappingURL=page-section-add.js.map

package/dist/m365/spo/commands/site/SiteAdmin.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=SiteAdmin.js.map