@pnp/cli-microsoft365 7.10.0-beta.0d80e6e → 7.10.0-beta.4ffb095

package/dist/m365/entra/commands/pim/pim-role-request-list.js

@@ -0,0 +1,149 @@
+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 _EntraPimRoleRequestListCommand_instances, _EntraPimRoleRequestListCommand_initTelemetry, _EntraPimRoleRequestListCommand_initOptions, _EntraPimRoleRequestListCommand_initValidators, _EntraPimRoleRequestListCommand_initOptionSets;
+import GraphCommand from '../../../base/GraphCommand.js';
+import commands from '../../commands.js';
+import { validation } from '../../../../utils/validation.js';
+import { entraUser } from '../../../../utils/entraUser.js';
+import { entraGroup } from '../../../../utils/entraGroup.js';
+import { odata } from '../../../../utils/odata.js';
+class EntraPimRoleRequestListCommand extends GraphCommand {
+    get name() {
+        return commands.PIM_ROLE_REQUEST_LIST;
+    }
+    get description() {
+        return 'Retrieves a list of PIM requests for roles';
+    }
+    defaultProperties() {
+        return ['id', 'roleDefinitionName', 'principalId'];
+    }
+    constructor() {
+        super();
+        _EntraPimRoleRequestListCommand_instances.add(this);
+        this.allowedStatuses = ['Canceled', 'Denied', 'Failed', 'Granted', 'PendingAdminDecision', 'PendingApproval', 'PendingProvisioning', 'PendingScheduleCreation', 'Provisioned', 'Revoked', 'ScheduleCreated'];
+        __classPrivateFieldGet(this, _EntraPimRoleRequestListCommand_instances, "m", _EntraPimRoleRequestListCommand_initTelemetry).call(this);
+        __classPrivateFieldGet(this, _EntraPimRoleRequestListCommand_instances, "m", _EntraPimRoleRequestListCommand_initOptions).call(this);
+        __classPrivateFieldGet(this, _EntraPimRoleRequestListCommand_instances, "m", _EntraPimRoleRequestListCommand_initValidators).call(this);
+        __classPrivateFieldGet(this, _EntraPimRoleRequestListCommand_instances, "m", _EntraPimRoleRequestListCommand_initOptionSets).call(this);
+    }
+    async commandAction(logger, args) {
+        if (this.verbose) {
+            await logger.logToStderr(`Retrieving list of PIM roles requests for ${args.options.userId || args.options.userName || args.options.groupId || args.options.groupName || 'all users'}...`);
+        }
+        const queryParameters = [];
+        const filters = [];
+        const expands = [];
+        try {
+            const principalId = await this.getPrincipalId(logger, args.options);
+            if (principalId) {
+                filters.push(`principalId eq '${principalId}'`);
+            }
+            if (args.options.createdDateTime) {
+                filters.push(`createdDateTime ge ${args.options.createdDateTime}`);
+            }
+            if (args.options.status) {
+                filters.push(`status eq '${args.options.status}'`);
+            }
+            if (filters.length > 0) {
+                queryParameters.push(`$filter=${filters.join(' and ')}`);
+            }
+            expands.push('roleDefinition($select=displayName)');
+            if (args.options.includePrincipalDetails) {
+                expands.push('principal');
+            }
+            queryParameters.push(`$expand=${expands.join(',')}`);
+            const queryString = `?${queryParameters.join('&')}`;
+            const url = `${this.resource}/v1.0/roleManagement/directory/roleAssignmentScheduleRequests${queryString}`;
+            const results = await odata.getAllItems(url);
+            results.forEach(c => {
+                const roleDefinition = c['roleDefinition'];
+                if (roleDefinition) {
+                    c.roleDefinitionName = roleDefinition.displayName;
+                }
+                delete c['roleDefinition'];
+            });
+            await logger.log(results);
+        }
+        catch (err) {
+            this.handleRejectedODataJsonPromise(err);
+        }
+    }
+    async getPrincipalId(logger, options) {
+        let principalId = options.userId;
+        if (options.userName) {
+            if (this.verbose) {
+                await logger.logToStderr(`Retrieving user by its name '${options.userName}'`);
+            }
+            principalId = await entraUser.getUserIdByUpn(options.userName);
+        }
+        else if (options.groupId) {
+            principalId = options.groupId;
+        }
+        else if (options.groupName) {
+            if (this.verbose) {
+                await logger.logToStderr(`Retrieving group by its name '${options.groupName}'`);
+            }
+            principalId = await entraGroup.getGroupIdByDisplayName(options.groupName);
+        }
+        return principalId;
+    }
+}
+_EntraPimRoleRequestListCommand_instances = new WeakSet(), _EntraPimRoleRequestListCommand_initTelemetry = function _EntraPimRoleRequestListCommand_initTelemetry() {
+    this.telemetry.push((args) => {
+        Object.assign(this.telemetryProperties, {
+            userId: typeof args.options.userId !== 'undefined',
+            userName: typeof args.options.userName !== 'undefined',
+            groupId: typeof args.options.groupId !== 'undefined',
+            groupName: typeof args.options.groupName !== 'undefined',
+            createdDateTime: typeof args.options.createdDateTime !== 'undefined',
+            status: typeof args.options.status !== 'undefined',
+            includePrincipalDetails: !!args.options.includePrincipalDetails
+        });
+    });
+}, _EntraPimRoleRequestListCommand_initOptions = function _EntraPimRoleRequestListCommand_initOptions() {
+    this.options.unshift({
+        option: '--userId [userId]'
+    }, {
+        option: '--userName [userName]'
+    }, {
+        option: '--groupId [groupId]'
+    }, {
+        option: '--groupName [groupName]'
+    }, {
+        option: '-c, --createdDateTime [createdDateTime]'
+    }, {
+        option: '-s, --status [status]',
+        autocomplete: this.allowedStatuses
+    }, {
+        option: '--includePrincipalDetails [includePrincipalDetails]'
+    });
+}, _EntraPimRoleRequestListCommand_initValidators = function _EntraPimRoleRequestListCommand_initValidators() {
+    this.validators.push(async (args) => {
+        if (args.options.userId && !validation.isValidGuid(args.options.userId)) {
+            return `'${args.options.userId}' is not a valid GUID for option 'userId'`;
+        }
+        if (args.options.userName && !validation.isValidUserPrincipalName(args.options.userName)) {
+            return `'${args.options.userName}' is not a valid user principal name for option 'userName'.`;
+        }
+        if (args.options.groupId && !validation.isValidGuid(args.options.groupId)) {
+            return `'${args.options.groupId}' is not a valid GUID for option 'groupId'`;
+        }
+        if (args.options.createdDateTime && !validation.isValidISODateTime(args.options.createdDateTime)) {
+            return `'${args.options.createdDateTime}' is not a valid ISO 8601 date time string for option 'createdDateTime'`;
+        }
+        if (args.options.status && !this.allowedStatuses.some(status => status.toLowerCase() === args.options.status.toLowerCase())) {
+            return `'${args.options.status}' for option 'status' must be one of the following values: ${this.allowedStatuses.join(', ')}.`;
+        }
+        return true;
+    });
+}, _EntraPimRoleRequestListCommand_initOptionSets = function _EntraPimRoleRequestListCommand_initOptionSets() {
+    this.optionSets.push({
+        options: ['userId', 'userName', 'groupId', 'groupName'],
+        runsWhen: (args) => args.options.userId || args.options.userName || args.options.groupId || args.options.groupName
+    });
+};
+export default new EntraPimRoleRequestListCommand();
+//# sourceMappingURL=pim-role-request-list.js.map

package/dist/m365/entra/commands.js

@@ -16,6 +16,7 @@ export default {
     APP_SET: `${prefix} app set`,
     APP_PERMISSION_ADD: `${prefix} app permission add`,
     APP_PERMISSION_LIST: `${prefix} app permission list`,
+    APP_PERMISSION_REMOVE: `${prefix} app permission remove`,
     APP_ROLE_ADD: `${prefix} app role add`,
     APP_ROLE_LIST: `${prefix} app role list`,
     APP_ROLE_REMOVE: `${prefix} app role remove`,
@@ -77,6 +78,8 @@ export default {
     OAUTH2GRANT_SET: `${prefix} oauth2grant set`,
     PIM_ROLE_ASSIGNMENT_ADD: `${prefix} pim role assignment add`,
     PIM_ROLE_ASSIGNMENT_LIST: `${prefix} pim role assignment list`,
+    PIM_ROLE_ASSIGNMENT_ELIGIBILITY_LIST: `${prefix} pim role assignment eligibility list`,
+    PIM_ROLE_REQUEST_LIST: `${prefix} pim role request list`,
     POLICY_LIST: `${prefix} policy list`,
     SITECLASSIFICATION_DISABLE: `${prefix} siteclassification disable`,
     SITECLASSIFICATION_ENABLE: `${prefix} siteclassification enable`,

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

@@ -42,29 +42,27 @@ class SpoFileAddCommand extends SpoCommand {
         const fileName = fsUtil.getSafeFileName(path.basename(fullPath));
         let isCheckedOut = false;
         let listSettings;
-        if (this.debug) {
-            await logger.logToStderr(`folder path: ${folderPath}...`);
-        }
-        if (this.debug) {
-            await logger.logToStderr('Check if the specified folder exists.');
-            await logger.logToStderr('');
-        }
-        if (this.debug) {
+        if (this.verbose) {
             await logger.logToStderr(`file name: ${fileName}...`);
+            await logger.logToStderr(`folder path: ${folderPath}...`);
         }
         try {
             try {
+                if (this.verbose) {
+                    await logger.logToStderr('Check if the specified folder exists.');
+                }
                 const requestOptions = {
                     url: `${args.options.webUrl}/_api/web/GetFolderByServerRelativePath(DecodedUrl='${formatting.encodeQueryParameter(folderPath)}')`,
                     headers: {
-                        'accept': 'application/json;odata=nometadata'
-                    }
+                        accept: 'application/json;odata=nometadata'
+                    },
+                    responseType: 'json'
                 };
                 await request.get(requestOptions);
             }
             catch (err) {
                 // folder does not exist so will attempt to create the folder tree
-                await spo.ensureFolder(args.options.webUrl, folderPath, logger, this.debug);
+                await spo.ensureFolder(args.options.webUrl, folderPath, logger, this.verbose);
             }
             if (args.options.checkOut) {
                 await this.fileCheckOut(fileName, args.options.webUrl, folderPath);
@@ -77,7 +75,7 @@ class SpoFileAddCommand extends SpoCommand {
             }
             const fileStats = fs.statSync(fullPath);
             const fileSize = fileStats.size;
-            if (this.debug) {
+            if (this.verbose) {
                 await logger.logToStderr(`File size is ${fileSize} bytes`);
             }
             // only up to 250 MB are allowed in a single request
@@ -91,8 +89,9 @@ class SpoFileAddCommand extends SpoCommand {
                 const requestOptions = {
                     url: `${args.options.webUrl}/_api/web/GetFolderByServerRelativePath(DecodedUrl='${formatting.encodeQueryParameter(folderPath)}')/Files/GetByPathOrAddStub(DecodedUrl='${formatting.encodeQueryParameter(fileName)}')/StartUpload(uploadId=guid'${uploadId}')`,
                     headers: {
-                        'accept': 'application/json;odata=nometadata'
-                    }
+                        accept: 'application/json;odata=nometadata'
+                    },
+                    responseType: 'json'
                 };
                 await request.post(requestOptions);
                 // session started successfully, now upload our file chunks
@@ -119,8 +118,9 @@ class SpoFileAddCommand extends SpoCommand {
                     const requestOptions = {
                         url: `${args.options.webUrl}/_api/web/GetFolderByServerRelativePath(DecodedUrl='${formatting.encodeQueryParameter(folderPath)}')/Files('${formatting.encodeQueryParameter(fileName)}')/cancelupload(uploadId=guid'${uploadId}')`,
                         headers: {
-                            'accept': 'application/json;odata=nometadata'
-                        }
+                            accept: 'application/json;odata=nometadata'
+                        },
+                        responseType: 'json'
                     };
                     try {
                         await request.post(requestOptions);
@@ -142,7 +142,7 @@ class SpoFileAddCommand extends SpoCommand {
                     url: `${args.options.webUrl}/_api/web/GetFolderByServerRelativePath(DecodedUrl='${formatting.encodeQueryParameter(folderPath)}')/Files/Add(url='${formatting.encodeQueryParameter(fileName)}', overwrite=true)`,
                     data: fileBody,
                     headers: {
-                        'accept': 'application/json;odata=nometadata',
+                        accept: 'application/json;odata=nometadata',
                         'content-length': bodyLength
                     },
                     maxBodyLength: this.fileChunkingThreshold
@@ -165,12 +165,12 @@ class SpoFileAddCommand extends SpoCommand {
                 });
             }
             if (fieldsToUpdate.length > 0) {
-                // perform list item update and checkin
+                // perform list item update and check-in
                 await this.validateUpdateListItem(args.options.webUrl, folderPath, fileName, fieldsToUpdate, logger, args.options.checkInComment);
             }
             else if (isCheckedOut) {
-                // perform checkin
-                await this.fileCheckIn(args, fileName);
+                // perform check-in
+                await this.fileCheckIn(args.options.webUrl, folderPath, fileName, args.options.checkInComment);
             }
             // approve and publish cannot be used together
             // when approve is used it will automatically publish the file
@@ -183,7 +183,7 @@ class SpoFileAddCommand extends SpoCommand {
                 const requestOptions = {
                     url: `${args.options.webUrl}/_api/web/GetFolderByServerRelativePath(DecodedUrl='${formatting.encodeQueryParameter(folderPath)}')/Files('${formatting.encodeQueryParameter(fileName)}')/approve(comment='${formatting.encodeQueryParameter(args.options.approveComment || '')}')`,
                     headers: {
-                        'accept': 'application/json;odata=nometadata'
+                        accept: 'application/json;odata=nometadata'
                     },
                     responseType: 'json'
                 };
@@ -200,7 +200,7 @@ class SpoFileAddCommand extends SpoCommand {
                 const requestOptions = {
                     url: `${args.options.webUrl}/_api/web/GetFolderByServerRelativePath(DecodedUrl='${formatting.encodeQueryParameter(folderPath)}')/Files('${formatting.encodeQueryParameter(fileName)}')/publish(comment='${formatting.encodeQueryParameter(args.options.publishComment || '')}')`,
                     headers: {
-                        'accept': 'application/json;odata=nometadata'
+                        accept: 'application/json;odata=nometadata'
                     },
                     responseType: 'json'
                 };
@@ -212,7 +212,11 @@ class SpoFileAddCommand extends SpoCommand {
                 // in a case the command has done checkout
                 // then have to rollback the checkout
                 const requestOptions = {
-                    url: `${args.options.webUrl}/_api/web/GetFolderByServerRelativePath(DecodedUrl='${formatting.encodeQueryParameter(folderPath)}')/Files('${formatting.encodeQueryParameter(fileName)}')/UndoCheckOut()`
+                    url: `${args.options.webUrl}/_api/web/GetFolderByServerRelativePath(DecodedUrl='${formatting.encodeQueryParameter(folderPath)}')/Files('${formatting.encodeQueryParameter(fileName)}')/UndoCheckOut()`,
+                    headers: {
+                        accept: 'application/json;odata=nometadata'
+                    },
+                    responseType: 'json'
                 };
                 try {
                     await request.post(requestOptions);
@@ -221,7 +225,6 @@ class SpoFileAddCommand extends SpoCommand {
                     if (this.verbose) {
                         await logger.logToStderr('Could not rollback file checkout');
                         await logger.logToStderr(err);
-                        await logger.logToStderr('');
                     }
                 }
             }
@@ -235,7 +238,7 @@ class SpoFileAddCommand extends SpoCommand {
         const requestOptions = {
             url: `${webUrl}/_api/web/lists('${listSettings.Id}')/contenttypes?$select=Name,Id`,
             headers: {
-                'accept': 'application/json;odata=nometadata'
+                accept: 'application/json;odata=nometadata'
             },
             responseType: 'json'
         };
@@ -253,14 +256,15 @@ class SpoFileAddCommand extends SpoCommand {
         const requestOptionsGetFile = {
             url: `${webUrl}/_api/web/GetFolderByServerRelativePath(DecodedUrl='${formatting.encodeQueryParameter(folder)}')/Files('${formatting.encodeQueryParameter(fileName)}')`,
             headers: {
-                'accept': 'application/json;odata=nometadata'
-            }
+                accept: 'application/json;odata=nometadata'
+            },
+            responseType: 'json'
         };
         await request.get(requestOptionsGetFile);
         const requestOptionsCheckOut = {
             url: `${webUrl}/_api/web/GetFolderByServerRelativePath(DecodedUrl='${formatting.encodeQueryParameter(folder)}')/Files('${formatting.encodeQueryParameter(fileName)}')/CheckOut()`,
             headers: {
-                'accept': 'application/json;odata=nometadata'
+                accept: 'application/json;odata=nometadata'
             },
             responseType: 'json'
         };
@@ -285,7 +289,7 @@ class SpoFileAddCommand extends SpoCommand {
                 url: `${info.WebUrl}/_api/web/GetFolderByServerRelativePath(DecodedUrl='${formatting.encodeQueryParameter(info.FolderPath)}')/Files('${formatting.encodeQueryParameter(info.Name)}')/${isLastChunk ? 'Finish' : 'Continue'}Upload(uploadId=guid'${info.Id}',fileOffset=${offset})`,
                 data: fileBuffer,
                 headers: {
-                    'accept': 'application/json;odata=nometadata',
+                    accept: 'application/json;odata=nometadata',
                     'content-length': readCount
                 },
                 maxBodyLength: this.fileChunkingThreshold
@@ -341,7 +345,7 @@ class SpoFileAddCommand extends SpoCommand {
         const requestOptions = {
             url: `${webUrl}/_api/web/GetFolderByServerRelativePath(DecodedUrl='${formatting.encodeQueryParameter(folder)}')/Files('${formatting.encodeQueryParameter(fileName)}')/ListItemAllFields/ParentList?$Select=Id,EnableModeration,EnableVersioning,EnableMinorVersions`,
             headers: {
-                'accept': 'application/json;odata=nometadata'
+                accept: 'application/json;odata=nometadata'
             },
             responseType: 'json'
         };
@@ -353,18 +357,17 @@ class SpoFileAddCommand extends SpoCommand {
         }
         const requestBody = {
             formValues: fieldsToUpdate,
-            bNewDocumentUpdate: true, // true = will automatically checkin the item, but we will use it to perform system update and also do a checkin
+            bNewDocumentUpdate: true, // true = will automatically check-in the item, but we will use it to perform system update and also do a check-in
             checkInComment: checkInComment || ''
         };
-        if (this.debug) {
-            await logger.logToStderr('ValidateUpdateListItem will perform the checkin ...');
-            await logger.logToStderr('');
+        if (this.verbose) {
+            await logger.logToStderr('ValidateUpdateListItem will perform the check-in ...');
         }
         // update the existing file list item fields
         const requestOptions = {
             url: `${webUrl}/_api/web/GetFolderByServerRelativePath(DecodedUrl='${formatting.encodeQueryParameter(folderPath)}')/Files('${formatting.encodeQueryParameter(fileName)}')/ListItemAllFields/ValidateUpdateListItem()`,
             headers: {
-                'accept': 'application/json;odata=nometadata'
+                accept: 'application/json;odata=nometadata'
             },
             data: requestBody,
             responseType: 'json'
@@ -379,11 +382,11 @@ class SpoFileAddCommand extends SpoCommand {
         }
         return;
     }
-    async fileCheckIn(args, fileName) {
+    async fileCheckIn(webUrl, folderUrl, fileName, checkInComment) {
         const requestOptions = {
-            url: `${args.options.webUrl}/_api/web/GetFolderByServerRelativePath(DecodedUrl='${formatting.encodeQueryParameter(args.options.folder)}')/Files('${formatting.encodeQueryParameter(fileName)}')/CheckIn(comment='${formatting.encodeQueryParameter(args.options.checkInComment || '')}',checkintype=0)`,
+            url: `${webUrl}/_api/web/GetFolderByServerRelativePath(DecodedUrl='${formatting.encodeQueryParameter(folderUrl)}')/Files('${formatting.encodeQueryParameter(fileName)}')/CheckIn(comment='${formatting.encodeQueryParameter(checkInComment || '')}',checkintype=0)`,
             headers: {
-                'accept': 'application/json;odata=nometadata'
+                accept: 'application/json;odata=nometadata'
             },
             responseType: 'json'
         };

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

@@ -28,40 +28,81 @@ class SpoFolderAddCommand extends SpoCommand {
     }
     async commandAction(logger, args) {
         try {
-            if (this.verbose) {
-                await logger.logToStderr(`Adding folder to site ${args.options.webUrl}...`);
-            }
             const parentFolderServerRelativeUrl = urlUtil.getServerRelativePath(args.options.webUrl, args.options.parentFolderUrl);
             const serverRelativeUrl = `${parentFolderServerRelativeUrl}/${args.options.name}`;
-            const requestOptions = {
-                headers: {
-                    'accept': 'application/json;odata=nometadata'
-                },
-                responseType: 'json'
-            };
-            if (args.options.color === undefined) {
-                requestOptions.url = `${args.options.webUrl}/_api/web/folders/addUsingPath(decodedUrl='${formatting.encodeQueryParameter(serverRelativeUrl)}')`;
+            if (args.options.ensureParentFolders) {
+                await this.ensureParentFolderPath(args.options, parentFolderServerRelativeUrl, logger);
             }
-            else {
-                requestOptions.url = `${args.options.webUrl}/_api/foldercoloring/createfolder(DecodedUrl='${formatting.encodeQueryParameter(serverRelativeUrl)}', overwrite=false)`;
-                requestOptions.data = {
-                    coloringInformation: {
-                        ColorHex: FolderColorValues[args.options.color] || args.options.color
-                    }
-                };
-            }
-            const folder = await request.post(requestOptions);
+            const folder = await this.addFolder(serverRelativeUrl, args.options, logger);
             await logger.log(folder);
         }
         catch (err) {
             this.handleRejectedODataJsonPromise(err);
         }
     }
+    async ensureParentFolderPath(options, parentFolderPath, logger) {
+        if (this.verbose) {
+            await logger.logToStderr(`Ensuring parent folders exist...`);
+        }
+        const parsedUrl = new URL(options.webUrl);
+        const absoluteFolderUrl = `${parsedUrl.origin}${parentFolderPath}`;
+        const relativeFolderPath = absoluteFolderUrl.replace(options.webUrl, '');
+        const parentFolders = relativeFolderPath.split('/').filter(folder => folder !== '');
+        for (let i = 1; i < parentFolders.length; i++) {
+            const currentFolderPath = parentFolders.slice(0, i + 1).join('/');
+            if (this.verbose) {
+                await logger.logToStderr(`Checking if folder '${currentFolderPath}' exists...`);
+            }
+            const folderExists = await this.getFolderExists(options.webUrl, currentFolderPath);
+            if (!folderExists) {
+                await this.addFolder(currentFolderPath, options, logger);
+            }
+        }
+    }
+    async getFolderExists(webUrl, folderServerRelativeUrl) {
+        const requestUrl = `${webUrl}/_api/web/GetFolderByServerRelativePath(DecodedUrl='${formatting.encodeQueryParameter(folderServerRelativeUrl)}')?$select=Exists`;
+        const requestOptions = {
+            url: requestUrl,
+            headers: {
+                'accept': 'application/json;odata=nometadata'
+            },
+            responseType: 'json'
+        };
+        const response = await request.get(requestOptions);
+        return response.Exists;
+    }
+    async addFolder(serverRelativeUrl, options, logger) {
+        if (this.verbose) {
+            const folderName = serverRelativeUrl.split('/').pop();
+            const folderLocation = serverRelativeUrl.split('/').slice(0, -1).join('/');
+            await logger.logToStderr(`Adding folder with name '${folderName}' at location '${folderLocation}'...`);
+        }
+        const requestOptions = {
+            headers: {
+                'accept': 'application/json;odata=nometadata'
+            },
+            responseType: 'json'
+        };
+        if (options.color === undefined) {
+            requestOptions.url = `${options.webUrl}/_api/web/folders/addUsingPath(decodedUrl='${formatting.encodeQueryParameter(serverRelativeUrl)}')`;
+        }
+        else {
+            requestOptions.url = `${options.webUrl}/_api/foldercoloring/createfolder(DecodedUrl='${formatting.encodeQueryParameter(serverRelativeUrl)}', overwrite=false)`;
+            requestOptions.data = {
+                coloringInformation: {
+                    ColorHex: FolderColorValues[options.color] || options.color
+                }
+            };
+        }
+        const response = await request.post(requestOptions);
+        return response;
+    }
 }
 _SpoFolderAddCommand_instances = new WeakSet(), _SpoFolderAddCommand_initTelemetry = function _SpoFolderAddCommand_initTelemetry() {
     this.telemetry.push((args) => {
         Object.assign(this.telemetryProperties, {
-            color: typeof args.options.color !== 'undefined'
+            color: typeof args.options.color !== 'undefined',
+            ensureParentFolders: !!args.options.ensureParentFolders
         });
     });
 }, _SpoFolderAddCommand_initOptions = function _SpoFolderAddCommand_initOptions() {
@@ -74,6 +115,8 @@ _SpoFolderAddCommand_instances = new WeakSet(), _SpoFolderAddCommand_initTelemet
     }, {
         option: '--color [color]',
         autocomplete: Object.keys(FolderColorValues)
+    }, {
+        option: '--ensureParentFolders [ensureParentFolders]'
     });
 }, _SpoFolderAddCommand_initValidators = function _SpoFolderAddCommand_initValidators() {
     this.validators.push(async (args) => {
@@ -88,6 +131,7 @@ _SpoFolderAddCommand_instances = new WeakSet(), _SpoFolderAddCommand_initTelemet
     });
 }, _SpoFolderAddCommand_initTypes = function _SpoFolderAddCommand_initTypes() {
     this.types.string.push('webUrl', 'parentFolderUrl', 'name', 'color');
+    this.types.boolean.push('ensureParentFolders');
 };
 export default new SpoFolderAddCommand();
 //# sourceMappingURL=folder-add.js.map

package/dist/m365/spo/commands/site/site-admin-list.js

@@ -0,0 +1,144 @@
+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 _SpoSiteAdminListCommand_instances, _SpoSiteAdminListCommand_initTelemetry, _SpoSiteAdminListCommand_initOptions, _SpoSiteAdminListCommand_initValidators, _SpoSiteAdminListCommand_initTypes;
+import request from '../../../../request.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 { ListPrincipalType } from '../list/ListPrincipalType.js';
+class SpoSiteAdminListCommand extends SpoCommand {
+    get name() {
+        return commands.SITE_ADMIN_LIST;
+    }
+    get description() {
+        return 'Lists all administrators of a specific SharePoint site';
+    }
+    constructor() {
+        super();
+        _SpoSiteAdminListCommand_instances.add(this);
+        __classPrivateFieldGet(this, _SpoSiteAdminListCommand_instances, "m", _SpoSiteAdminListCommand_initTelemetry).call(this);
+        __classPrivateFieldGet(this, _SpoSiteAdminListCommand_instances, "m", _SpoSiteAdminListCommand_initOptions).call(this);
+        __classPrivateFieldGet(this, _SpoSiteAdminListCommand_instances, "m", _SpoSiteAdminListCommand_initValidators).call(this);
+        __classPrivateFieldGet(this, _SpoSiteAdminListCommand_instances, "m", _SpoSiteAdminListCommand_initTypes).call(this);
+    }
+    async commandAction(logger, args) {
+        try {
+            if (args.options.asAdmin) {
+                await this.callActionAsAdmin(logger, args);
+                return;
+            }
+            await this.callAction(logger, args);
+        }
+        catch (err) {
+            this.handleRejectedODataJsonPromise(err);
+        }
+    }
+    async callActionAsAdmin(logger, args) {
+        if (this.verbose) {
+            await logger.logToStderr('Retrieving site administrators as an administrator...');
+        }
+        const adminUrl = await spo.getSpoAdminUrl(logger, this.debug);
+        const siteId = await this.getSiteId(args.options.siteUrl, logger);
+        const requestOptions = {
+            url: `${adminUrl}/_api/SPO.Tenant/GetSiteAdministrators?siteId='${siteId}'`,
+            headers: {
+                accept: 'application/json;odata=nometadata',
+                'content-type': 'application/json;charset=utf-8'
+            }
+        };
+        const response = await request.post(requestOptions);
+        const responseContent = JSON.parse(response);
+        const primaryAdminLoginName = await this.getPrimaryAdminLoginNameFromAdmin(adminUrl, siteId);
+        const mappedResult = responseContent.value.map((u) => ({
+            Id: null,
+            Email: u.email,
+            LoginName: u.loginName,
+            Title: u.name,
+            PrincipalType: null,
+            PrincipalTypeString: null,
+            IsPrimaryAdmin: u.loginName === primaryAdminLoginName
+        }));
+        await logger.log(mappedResult);
+    }
+    async getSiteId(siteUrl, logger) {
+        const siteGraphId = await spo.getSiteId(siteUrl, logger, this.verbose);
+        const match = siteGraphId.match(/,([a-f0-9\-]{36}),/i);
+        if (!match) {
+            throw `Site with URL ${siteUrl} not found`;
+        }
+        return match[1];
+    }
+    async getPrimaryAdminLoginNameFromAdmin(adminUrl, siteId) {
+        const requestOptions = {
+            url: `${adminUrl}/_api/SPO.Tenant/sites('${siteId}')?$select=OwnerLoginName`,
+            headers: {
+                accept: 'application/json;odata=nometadata',
+                'content-type': 'application/json;charset=utf-8'
+            }
+        };
+        const response = await request.get(requestOptions);
+        const responseContent = JSON.parse(response);
+        return responseContent.OwnerLoginName;
+    }
+    async callAction(logger, args) {
+        if (this.verbose) {
+            await logger.logToStderr('Retrieving site administrators...');
+        }
+        const requestOptions = {
+            url: `${args.options.siteUrl}/_api/web/siteusers?$filter=IsSiteAdmin eq true`,
+            method: 'GET',
+            headers: {
+                'accept': 'application/json;odata=nometadata'
+            },
+            responseType: 'json'
+        };
+        const responseContent = await request.get(requestOptions);
+        const primaryOwnerLogin = await this.getPrimaryOwnerLoginFromSite(args.options.siteUrl);
+        const mappedResult = responseContent.value.map((u) => ({
+            Id: u.Id,
+            LoginName: u.LoginName,
+            Title: u.Title,
+            PrincipalType: u.PrincipalType,
+            PrincipalTypeString: ListPrincipalType[u.PrincipalType],
+            Email: u.Email,
+            IsPrimaryAdmin: u.LoginName === primaryOwnerLogin
+        }));
+        await logger.log(mappedResult);
+    }
+    async getPrimaryOwnerLoginFromSite(siteUrl) {
+        const requestOptions = {
+            url: `${siteUrl}/_api/site/owner`,
+            method: 'GET',
+            headers: {
+                'accept': 'application/json;odata=nometadata'
+            },
+            responseType: 'json'
+        };
+        const responseContent = await request.get(requestOptions);
+        return responseContent?.LoginName ?? null;
+    }
+}
+_SpoSiteAdminListCommand_instances = new WeakSet(), _SpoSiteAdminListCommand_initTelemetry = function _SpoSiteAdminListCommand_initTelemetry() {
+    this.telemetry.push((args) => {
+        Object.assign(this.telemetryProperties, {
+            siteUrl: typeof args.options.siteUrl !== 'undefined',
+            asAdmin: !!args.options.asAdmin
+        });
+    });
+}, _SpoSiteAdminListCommand_initOptions = function _SpoSiteAdminListCommand_initOptions() {
+    this.options.unshift({
+        option: '-u, --siteUrl <siteUrl>'
+    }, {
+        option: '--asAdmin'
+    });
+}, _SpoSiteAdminListCommand_initValidators = function _SpoSiteAdminListCommand_initValidators() {
+    this.validators.push(async (args) => validation.isValidSharePointUrl(args.options.siteUrl));
+}, _SpoSiteAdminListCommand_initTypes = function _SpoSiteAdminListCommand_initTypes() {
+    this.types.string.push('siteUrl');
+};
+export default new SpoSiteAdminListCommand();
+//# sourceMappingURL=site-admin-list.js.map