@pnp/cli-microsoft365 7.6.0-beta.c74fe4b → 7.6.0-beta.fc0eacc

package/dist/m365/entra/commands/user/user-remove.js

@@ -29,6 +29,7 @@ class EntraUserRemoveCommand extends GraphCommand {
         __classPrivateFieldGet(this, _EntraUserRemoveCommand_instances, "m", _EntraUserRemoveCommand_initOptionSets).call(this);
     }
     async commandAction(logger, args) {
+        await this.showDeprecationWarning(logger, aadCommands.USER_REMOVE, commands.USER_REMOVE);
         if (this.verbose) {
             await logger.logToStderr(`Removing user '${args.options.id || args.options.userName}'...`);
         }

package/dist/m365/entra/commands/user/user-set.js

@@ -35,6 +35,7 @@ class EntraUserSetCommand extends GraphCommand {
         __classPrivateFieldGet(this, _EntraUserSetCommand_instances, "m", _EntraUserSetCommand_initOptionSets).call(this);
     }
     async commandAction(logger, args) {
+        await this.showDeprecationWarning(logger, aadCommands.USER_SET, commands.USER_SET);
         try {
             if (args.options.currentPassword) {
                 if (args.options.id && args.options.id !== accessToken.getUserIdFromAccessToken(auth.connection.accessTokens[auth.defaultResource].accessToken)) {

package/dist/m365/entra/commands/user/user-signin-list.js

@@ -31,6 +31,7 @@ class EntraUserSigninListCommand extends GraphCommand {
         return ['id', 'userPrincipalName', 'appId', 'appDisplayName', 'createdDateTime'];
     }
     async commandAction(logger, args) {
+        await this.showDeprecationWarning(logger, aadCommands.USER_SIGNIN_LIST, commands.USER_SIGNIN_LIST);
         try {
             let endpoint = `${this.resource}/v1.0/auditLogs/signIns`;
             let filter = "";

package/dist/m365/outlook/commands/message/message-remove.js

@@ -0,0 +1,113 @@
+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 _OutlookMessageRemoveCommand_instances, _OutlookMessageRemoveCommand_initTelemetry, _OutlookMessageRemoveCommand_initOptions, _OutlookMessageRemoveCommand_initValidators, _OutlookMessageRemoveCommand_initTypes;
+import auth from '../../../../Auth.js';
+import request from '../../../../request.js';
+import { accessToken } from '../../../../utils/accessToken.js';
+import GraphCommand from '../../../base/GraphCommand.js';
+import commands from '../../commands.js';
+import { cli } from '../../../../cli/cli.js';
+import { validation } from '../../../../utils/validation.js';
+import { formatting } from '../../../../utils/formatting.js';
+class OutlookMessageRemoveCommand extends GraphCommand {
+    get name() {
+        return commands.MESSAGE_REMOVE;
+    }
+    get description() {
+        return 'Permanently removes a specific message from a mailbox';
+    }
+    constructor() {
+        super();
+        _OutlookMessageRemoveCommand_instances.add(this);
+        __classPrivateFieldGet(this, _OutlookMessageRemoveCommand_instances, "m", _OutlookMessageRemoveCommand_initTelemetry).call(this);
+        __classPrivateFieldGet(this, _OutlookMessageRemoveCommand_instances, "m", _OutlookMessageRemoveCommand_initOptions).call(this);
+        __classPrivateFieldGet(this, _OutlookMessageRemoveCommand_instances, "m", _OutlookMessageRemoveCommand_initValidators).call(this);
+        __classPrivateFieldGet(this, _OutlookMessageRemoveCommand_instances, "m", _OutlookMessageRemoveCommand_initTypes).call(this);
+    }
+    async commandAction(logger, args) {
+        const isAppOnlyAccessToken = accessToken.isAppOnlyAccessToken(auth.connection.accessTokens[auth.defaultResource].accessToken);
+        let principalUrl = '';
+        if (isAppOnlyAccessToken) {
+            if (!args.options.userId && !args.options.userName) {
+                throw `The option 'userId' or 'userName' is required when removing a message using application permissions.`;
+            }
+            if (args.options.userId && args.options.userName) {
+                throw `Both options 'userId' and 'userName' cannot be used together when removing a message using application permissions.`;
+            }
+        }
+        else {
+            if (args.options.userId && args.options.userName) {
+                throw `Both options 'userId' and 'userName' cannot be used together when removing a message using delegated permissions.`;
+            }
+        }
+        if (args.options.userId || args.options.userName) {
+            principalUrl += `users/${args.options.userId || formatting.encodeQueryParameter(args.options.userName)}`;
+        }
+        else {
+            principalUrl += 'me';
+        }
+        const removeMessage = async () => {
+            try {
+                if (this.verbose) {
+                    await logger.logToStderr(`Removing message with id '${args.options.id}' using ${isAppOnlyAccessToken ? 'application' : 'delegated'} permissions.`);
+                }
+                const requestOptions = {
+                    url: `${this.resource}/v1.0/${principalUrl}/messages/${args.options.id}`,
+                    headers: {
+                        accept: 'application/json;odata.metadata=none'
+                    }
+                };
+                await request.delete(requestOptions);
+            }
+            catch (err) {
+                this.handleRejectedODataJsonPromise(err);
+            }
+        };
+        if (args.options.force) {
+            await removeMessage();
+        }
+        else {
+            const result = await cli.promptForConfirmation({ message: `Are you sure you want to remove message with id '${args.options.id}'?` });
+            if (result) {
+                await removeMessage();
+            }
+        }
+    }
+}
+_OutlookMessageRemoveCommand_instances = new WeakSet(), _OutlookMessageRemoveCommand_initTelemetry = function _OutlookMessageRemoveCommand_initTelemetry() {
+    this.telemetry.push((args) => {
+        Object.assign(this.telemetryProperties, {
+            userId: typeof args.options.userId !== 'undefined',
+            userName: typeof args.options.userName !== 'undefined',
+            force: !!args.options.force
+        });
+    });
+}, _OutlookMessageRemoveCommand_initOptions = function _OutlookMessageRemoveCommand_initOptions() {
+    this.options.unshift({
+        option: '-i, --id <id>'
+    }, {
+        option: '--userId [userId]'
+    }, {
+        option: '--userName [userName]'
+    }, {
+        option: '-f, --force'
+    });
+}, _OutlookMessageRemoveCommand_initValidators = function _OutlookMessageRemoveCommand_initValidators() {
+    this.validators.push(async (args) => {
+        if (args.options.userId && !validation.isValidGuid(args.options.userId)) {
+            return `Value '${args.options.userId}' is not a valid GUID for option 'userId'.`;
+        }
+        if (args.options.userName && !validation.isValidUserPrincipalName(args.options.userName)) {
+            return `Value '${args.options.userName}' is not a valid user principal name for option 'userName'.`;
+        }
+        return true;
+    });
+}, _OutlookMessageRemoveCommand_initTypes = function _OutlookMessageRemoveCommand_initTypes() {
+    this.types.string.push('id', 'userId', 'userName');
+    this.types.boolean.push('force');
+};
+export default new OutlookMessageRemoveCommand();
+//# sourceMappingURL=message-remove.js.map

package/dist/m365/outlook/commands.js

@@ -4,6 +4,7 @@ export default {
     MESSAGE_GET: `${prefix} message get`,
     MESSAGE_LIST: `${prefix} message list`,
     MESSAGE_MOVE: `${prefix} message move`,
+    MESSAGE_REMOVE: `${prefix} message remove`,
     REPORT_MAILACTIVITYCOUNTS: `${prefix} report mailactivitycounts`,
     REPORT_MAILACTIVITYUSERCOUNTS: `${prefix} report mailactivityusercounts`,
     REPORT_MAILACTIVITYUSERDETAIL: `${prefix} report mailactivityuserdetail`,

package/dist/m365/pp/commands/managementapp/managementapp-add.js

@@ -58,16 +58,16 @@ class PpManagementAppAddCommand extends PowerPlatformCommand {
             },
             responseType: 'json'
         };
-        const aadApps = await request.get((requestOptions));
-        if (aadApps.value.length === 0) {
+        const entraApps = await request.get((requestOptions));
+        if (entraApps.value.length === 0) {
             const applicationIdentifier = objectId ? `ID ${objectId}` : `name ${name}`;
-            throw `No Azure AD application registration with ${applicationIdentifier} found`;
+            throw `No Microsoft Entra application registration with ${applicationIdentifier} found`;
         }
-        if (aadApps.value.length === 1 && aadApps.value[0].appId) {
-            return aadApps.value[0].appId;
+        if (entraApps.value.length === 1 && entraApps.value[0].appId) {
+            return entraApps.value[0].appId;
         }
-        const resultAsKeyValuePair = formatting.convertArrayToHashTable('appId', aadApps.value);
-        const result = await cli.handleMultipleResultsFound(`Multiple Azure AD application registration with name '${name}' found.`, resultAsKeyValuePair);
+        const resultAsKeyValuePair = formatting.convertArrayToHashTable('appId', entraApps.value);
+        const result = await cli.handleMultipleResultsFound(`Multiple Microsoft Entra application registrations with name '${name}' found.`, resultAsKeyValuePair);
         return result.appId;
     }
 }

package/dist/m365/spfx/commands/project/DeployWorkflow.js

@@ -53,4 +53,115 @@ export const workflow = {
         }
     }
 };
+export const pipeline = {
+    name: "Deploy Solution",
+    trigger: {
+        branches: {
+            include: [
+                "main"
+            ]
+        }
+    },
+    pool: {
+        vmImage: "ubuntu-latest"
+    },
+    variables: [
+        {
+            name: "CertificateBase64Encoded",
+            value: ""
+        },
+        {
+            name: "CertificateSecureFileId",
+            value: ""
+        },
+        {
+            name: "CertificatePassword",
+            value: ""
+        },
+        {
+            name: "EntraAppId",
+            value: ""
+        },
+        {
+            name: "UserName",
+            value: ""
+        },
+        {
+            name: "Password",
+            value: ""
+        },
+        {
+            name: "TenantId",
+            value: ""
+        },
+        {
+            name: "SharePointBaseUrl",
+            value: ""
+        },
+        {
+            name: "PackageName",
+            value: ""
+        },
+        {
+            name: "SiteAppCatalogUrl",
+            value: ""
+        }
+    ],
+    stages: [
+        {
+            stage: "Build_and_Deploy",
+            jobs: [
+                {
+                    job: "Build_and_Deploy",
+                    steps: [
+                        {
+                            task: "NodeTool@0",
+                            displayName: "Use Node.js",
+                            inputs: {
+                                versionSpec: "18.x"
+                            }
+                        },
+                        {
+                            task: "Npm@1",
+                            displayName: "Run npm install",
+                            inputs: {
+                                command: "install"
+                            }
+                        },
+                        {
+                            task: "Gulp@0",
+                            displayName: "Gulp bundle",
+                            inputs: {
+                                gulpFile: "./gulpfile.js",
+                                targets: "bundle",
+                                arguments: "--ship"
+                            }
+                        },
+                        {
+                            task: "Gulp@0",
+                            displayName: "Gulp package",
+                            inputs: {
+                                targets: "package-solution",
+                                arguments: "--ship"
+                            }
+                        },
+                        {
+                            task: "Npm@1",
+                            displayName: "Install CLI for Microsoft 365",
+                            inputs: {
+                                command: "custom",
+                                verbose: false,
+                                customCommand: "install -g @pnp/cli-microsoft365"
+                            }
+                        },
+                        {
+                            script: "\n{{login}} \nm365 spo set --url '$(SharePointBaseUrl)' \n{{addApp}} \n{{deploy}}\n",
+                            displayName: "CLI for Microsoft 365 Deploy App"
+                        }
+                    ]
+                }
+            ]
+        }
+    ]
+};
 //# sourceMappingURL=DeployWorkflow.js.map

package/dist/m365/spfx/commands/project/project-azuredevops-pipeline-add.js

@@ -0,0 +1,183 @@
+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 _SpfxProjectAzureDevOpsPipelineAddCommand_instances, _a, _SpfxProjectAzureDevOpsPipelineAddCommand_initTelemetry, _SpfxProjectAzureDevOpsPipelineAddCommand_initOptions, _SpfxProjectAzureDevOpsPipelineAddCommand_initValidators;
+import fs from 'fs';
+import path from 'path';
+import yaml from 'yaml';
+import { CommandError } from '../../../../Command.js';
+import commands from '../../commands.js';
+import { BaseProjectCommand } from './base-project-command.js';
+import { validation } from '../../../../utils/validation.js';
+import { pipeline } from './DeployWorkflow.js';
+import { fsUtil } from '../../../../utils/fsUtil.js';
+import { parse } from 'semver';
+class SpfxProjectAzureDevOpsPipelineAddCommand extends BaseProjectCommand {
+    get name() {
+        return commands.PROJECT_AZUREDEVOPS_PIPELINE_ADD;
+    }
+    get description() {
+        return 'Adds a Azure DevOps Pipeline for a SharePoint Framework project.';
+    }
+    constructor() {
+        super();
+        _SpfxProjectAzureDevOpsPipelineAddCommand_instances.add(this);
+        __classPrivateFieldGet(this, _SpfxProjectAzureDevOpsPipelineAddCommand_instances, "m", _SpfxProjectAzureDevOpsPipelineAddCommand_initTelemetry).call(this);
+        __classPrivateFieldGet(this, _SpfxProjectAzureDevOpsPipelineAddCommand_instances, "m", _SpfxProjectAzureDevOpsPipelineAddCommand_initOptions).call(this);
+        __classPrivateFieldGet(this, _SpfxProjectAzureDevOpsPipelineAddCommand_instances, "m", _SpfxProjectAzureDevOpsPipelineAddCommand_initValidators).call(this);
+    }
+    async commandAction(logger, args) {
+        this.projectRootPath = this.getProjectRoot(process.cwd());
+        if (this.projectRootPath === null) {
+            throw new CommandError(`Couldn't find project root folder`, _a.ERROR_NO_PROJECT_ROOT_FOLDER);
+        }
+        const solutionPackageJsonFile = path.join(this.projectRootPath, 'package.json');
+        const packageJson = fs.readFileSync(solutionPackageJsonFile, 'utf-8');
+        const solutionName = JSON.parse(packageJson).name;
+        if (this.debug) {
+            logger.logToStderr(`Adding Azure DevOps pipeline in the current SPFx project`);
+        }
+        try {
+            this.updatePipeline(solutionName, pipeline, args.options);
+            this.savePipeline(pipeline);
+        }
+        catch (error) {
+            throw new CommandError(error);
+        }
+    }
+    savePipeline(pipeline) {
+        const azureDevOpsPath = path.join(this.projectRootPath, '.azuredevops');
+        fsUtil.ensureDirectory(azureDevOpsPath);
+        const pipelinesPath = path.join(azureDevOpsPath, 'pipelines');
+        fsUtil.ensureDirectory(pipelinesPath);
+        const pipelineFile = path.join(pipelinesPath, 'deploy-spfx-solution.yml');
+        fs.writeFileSync(path.resolve(pipelineFile), yaml.stringify(pipeline), 'utf-8');
+    }
+    updatePipeline(solutionName, pipeline, options) {
+        if (options.name) {
+            pipeline.name = options.name;
+        }
+        else {
+            delete pipeline.name;
+        }
+        if (options.branchName) {
+            pipeline.trigger.branches.include[0] = options.branchName;
+        }
+        const version = this.getProjectVersion();
+        if (!version) {
+            throw `Unable to determine the version of the current SharePoint Framework project`;
+        }
+        const minorVersion = parse(version)?.minor;
+        if (minorVersion === undefined) {
+            throw `Unable to determine the minor version of the current SharePoint Framework project`;
+        }
+        if (minorVersion < 18) {
+            const node = this.getNodeAction(pipeline);
+            if (node.inputs) {
+                node.inputs.versionSpec = '16.x';
+            }
+        }
+        const script = this.getScriptAction(pipeline);
+        if (script.script) {
+            if (options.loginMethod === 'user') {
+                script.script = script.script.replace(`{{login}}`, `m365 login --authType password --userName '$(UserName)' --password '$(Password)'`);
+                pipeline.variables = pipeline.variables.filter(v => v.name !== 'CertificateBase64Encoded' &&
+                    v.name !== 'CertificateSecureFileId' &&
+                    v.name !== 'CertificatePassword' &&
+                    v.name !== 'EntraAppId' &&
+                    v.name !== 'TenantId');
+            }
+            else {
+                script.script = script.script.replace(`{{login}}`, `m365 login --authType certificate --certificateBase64Encoded '$(CertificateBase64Encoded)' --password '$(CertificatePassword)' --appId '$(EntraAppId)' --tenant '$(TenantId)'`);
+                pipeline.variables = pipeline.variables.filter(v => v.name !== 'UserName' &&
+                    v.name !== 'Password');
+            }
+            if (options.scope === 'sitecollection') {
+                script.script = script.script.replace(`{{deploy}}`, `m365 spo app deploy --name '$(PackageName)' --appCatalogScope sitecollection --appCatalogUrl '$(SiteAppCatalogUrl)'`);
+                script.script = script.script.replace(`{{addApp}}`, `m365 spo app add --filePath '$(Build.SourcesDirectory)/sharepoint/solution/$(PackageName)' --appCatalogScope sitecollection --appCatalogUrl '$(SiteAppCatalogUrl)' --overwrite`);
+                this.assignPipelineVariables(pipeline, 'SiteAppCatalogUrl', options.siteUrl);
+            }
+            else {
+                script.script = script.script.replace(`{{deploy}}`, `m365 spo app deploy --name '$(PackageName)' --appCatalogScope 'tenant'`);
+                script.script = script.script.replace(`{{addApp}}`, `m365 spo app add --filePath '$(Build.SourcesDirectory)/sharepoint/solution/$(PackageName)' --overwrite`);
+                pipeline.variables = pipeline.variables.filter(v => v.name !== 'SiteAppCatalogUrl');
+            }
+            if (solutionName) {
+                this.assignPipelineVariables(pipeline, 'PackageName', `${solutionName}.sppkg`);
+            }
+            if (options.skipFeatureDeployment) {
+                script.script = script.script.replace(`m365 spo app deploy `, `m365 spo app deploy --skipFeatureDeployment `);
+            }
+        }
+    }
+    assignPipelineVariables(pipeline, variableName, newVariableValue) {
+        const variable = pipeline.variables.find(v => v.name === variableName);
+        if (variable) {
+            variable.value = newVariableValue;
+        }
+    }
+    getScriptAction(pipeline) {
+        const steps = this.getPipelineSteps(pipeline);
+        return steps.find(step => step.script);
+    }
+    getNodeAction(pipeline) {
+        const steps = this.getPipelineSteps(pipeline);
+        return steps.find(step => step.task && step.task.indexOf('NodeTool') >= 0);
+    }
+    getPipelineSteps(pipeline) {
+        return pipeline.stages[0].jobs[0].steps;
+    }
+}
+_a = SpfxProjectAzureDevOpsPipelineAddCommand, _SpfxProjectAzureDevOpsPipelineAddCommand_instances = new WeakSet(), _SpfxProjectAzureDevOpsPipelineAddCommand_initTelemetry = function _SpfxProjectAzureDevOpsPipelineAddCommand_initTelemetry() {
+    this.telemetry.push((args) => {
+        Object.assign(this.telemetryProperties, {
+            name: typeof args.options.name !== 'undefined',
+            branchName: typeof args.options.branchName !== 'undefined',
+            loginMethod: typeof args.options.loginMethod !== 'undefined',
+            scope: typeof args.options.scope !== 'undefined',
+            skipFeatureDeployment: !!args.options.skipFeatureDeployment
+        });
+    });
+}, _SpfxProjectAzureDevOpsPipelineAddCommand_initOptions = function _SpfxProjectAzureDevOpsPipelineAddCommand_initOptions() {
+    this.options.unshift({
+        option: '-n, --name [name]'
+    }, {
+        option: '-b, --branchName [branchName]'
+    }, {
+        option: '-l, --loginMethod [loginMethod]',
+        autocomplete: _a.loginMethod
+    }, {
+        option: '-s, --scope [scope]',
+        autocomplete: _a.scope
+    }, {
+        option: '-u, --siteUrl [siteUrl]'
+    }, {
+        option: '--skipFeatureDeployment'
+    });
+}, _SpfxProjectAzureDevOpsPipelineAddCommand_initValidators = function _SpfxProjectAzureDevOpsPipelineAddCommand_initValidators() {
+    this.validators.push(async (args) => {
+        if (args.options.scope && args.options.scope === 'sitecollection') {
+            if (!args.options.siteUrl) {
+                return `siteUrl option has to be defined when scope set to ${args.options.scope}`;
+            }
+            const isValidSharePointUrl = validation.isValidSharePointUrl(args.options.siteUrl);
+            if (isValidSharePointUrl !== true) {
+                return isValidSharePointUrl;
+            }
+        }
+        if (args.options.loginMethod && _a.loginMethod.indexOf(args.options.loginMethod) < 0) {
+            return `${args.options.loginMethod} is not a valid login method. Allowed values are ${_a.loginMethod.join(', ')}`;
+        }
+        if (args.options.scope && _a.scope.indexOf(args.options.scope) < 0) {
+            return `${args.options.scope} is not a valid scope. Allowed values are ${_a.scope.join(', ')}`;
+        }
+        return true;
+    });
+};
+SpfxProjectAzureDevOpsPipelineAddCommand.loginMethod = ['application', 'user'];
+SpfxProjectAzureDevOpsPipelineAddCommand.scope = ['tenant', 'sitecollection'];
+SpfxProjectAzureDevOpsPipelineAddCommand.ERROR_NO_PROJECT_ROOT_FOLDER = 1;
+export default new SpfxProjectAzureDevOpsPipelineAddCommand();
+//# sourceMappingURL=project-azuredevops-pipeline-add.js.map

package/dist/m365/spfx/commands/project/project-azuredevops-pipeline-model.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=project-azuredevops-pipeline-model.js.map

package/dist/m365/spfx/commands/project/project-github-workflow-add.js

@@ -13,6 +13,7 @@ import { validation } from '../../../../utils/validation.js';
 import commands from '../../commands.js';
 import { workflow } from './DeployWorkflow.js';
 import { BaseProjectCommand } from './base-project-command.js';
+import { parse } from 'semver';
 class SpfxProjectGithubWorkflowAddCommand extends BaseProjectCommand {
     get name() {
         return commands.PROJECT_GITHUB_WORKFLOW_ADD;
@@ -32,6 +33,9 @@ class SpfxProjectGithubWorkflowAddCommand extends BaseProjectCommand {
         if (this.projectRootPath === null) {
             throw new CommandError(`Couldn't find project root folder`, _a.ERROR_NO_PROJECT_ROOT_FOLDER);
         }
+        if (!args.options.overwrite) {
+            await this.warn(logger, `We recommend always using the --overwrite option and it will become the default behavior in next major release. Overwriting your sppkg file on every deployment is required to make continuous delivery of the latest version of your app which is the aim of the continuous delivery pipeline.`);
+        }
         const solutionPackageJsonFile = path.join(this.projectRootPath, 'package.json');
         const packageJson = fs.readFileSync(solutionPackageJsonFile, 'utf-8');
         const solutionName = JSON.parse(packageJson).name;
@@ -67,10 +71,8 @@ class SpfxProjectGithubWorkflowAddCommand extends BaseProjectCommand {
         if (!version) {
             throw `Unable to determine the version of the current SharePoint Framework project`;
         }
-        const match = version.match(/^(\d+)\.(\d+)\.(\d+)$/);
-        const minorVersionString = match ? match[2] : null;
-        const minorVersion = minorVersionString ? Number(minorVersionString) : null;
-        if (minorVersion === null || isNaN(minorVersion)) {
+        const minorVersion = parse(version)?.minor;
+        if (minorVersion === undefined) {
             throw `Unable to determine the minor version of the current SharePoint Framework project`;
         }
         if (minorVersion < 18) {

package/dist/m365/spfx/commands.js

@@ -2,6 +2,7 @@ const prefix = 'spfx';
 export default {
     DOCTOR: `${prefix} doctor`,
     PACKAGE_GENERATE: `${prefix} package generate`,
+    PROJECT_AZUREDEVOPS_PIPELINE_ADD: `${prefix} project azuredevops pipeline add`,
     PROJECT_DOCTOR: `${prefix} project doctor`,
     PROJECT_EXTERNALIZE: `${prefix} project externalize`,
     PROJECT_GITHUB_WORKFLOW_ADD: `${prefix} project github workflow add`,

package/dist/m365/spo/commands/folder/FolderColor.js

@@ -0,0 +1,19 @@
+export const FolderColorValues = {
+    yellow: '0',
+    darkRed: '1',
+    darkOrange: '2',
+    darkGreen: '3',
+    darkTeal: '4',
+    darkBlue: '5',
+    darkPurple: '6',
+    darkPink: '7',
+    grey: '8',
+    lightRed: '9',
+    lightOrange: '10',
+    lightGreen: '11',
+    lightTeal: '12',
+    lightBlue: '13',
+    lightPurple: '14',
+    lightPink: '15'
+};
+//# sourceMappingURL=FolderColor.js.map

package/dist/m365/spo/commands/folder/folder-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 _SpoFolderAddCommand_instances, _SpoFolderAddCommand_initOptions, _SpoFolderAddCommand_initValidators, _SpoFolderAddCommand_initTypes;
+var _SpoFolderAddCommand_instances, _SpoFolderAddCommand_initTelemetry, _SpoFolderAddCommand_initOptions, _SpoFolderAddCommand_initValidators, _SpoFolderAddCommand_initTypes;
 import request from '../../../../request.js';
 import { formatting } from '../../../../utils/formatting.js';
 import { urlUtil } from '../../../../utils/urlUtil.js';
 import { validation } from '../../../../utils/validation.js';
 import SpoCommand from '../../../base/SpoCommand.js';
 import commands from '../../commands.js';
+import { FolderColorValues } from './FolderColor.js';
 class SpoFolderAddCommand extends SpoCommand {
     get name() {
         return commands.FOLDER_ADD;
@@ -20,25 +21,35 @@ class SpoFolderAddCommand extends SpoCommand {
     constructor() {
         super();
         _SpoFolderAddCommand_instances.add(this);
+        __classPrivateFieldGet(this, _SpoFolderAddCommand_instances, "m", _SpoFolderAddCommand_initTelemetry).call(this);
         __classPrivateFieldGet(this, _SpoFolderAddCommand_instances, "m", _SpoFolderAddCommand_initOptions).call(this);
         __classPrivateFieldGet(this, _SpoFolderAddCommand_instances, "m", _SpoFolderAddCommand_initValidators).call(this);
         __classPrivateFieldGet(this, _SpoFolderAddCommand_instances, "m", _SpoFolderAddCommand_initTypes).call(this);
     }
     async commandAction(logger, args) {
-        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 requestUrl = `${args.options.webUrl}/_api/web/folders/addUsingPath(decodedUrl='${formatting.encodeQueryParameter(serverRelativeUrl)}')`;
-        const requestOptions = {
-            url: requestUrl,
-            headers: {
-                'accept': 'application/json;odata=nometadata'
-            },
-            responseType: 'json'
-        };
         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)}')`;
+            }
+            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);
             await logger.log(folder);
         }
@@ -47,18 +58,36 @@ class SpoFolderAddCommand extends SpoCommand {
         }
     }
 }
-_SpoFolderAddCommand_instances = new WeakSet(), _SpoFolderAddCommand_initOptions = function _SpoFolderAddCommand_initOptions() {
+_SpoFolderAddCommand_instances = new WeakSet(), _SpoFolderAddCommand_initTelemetry = function _SpoFolderAddCommand_initTelemetry() {
+    this.telemetry.push((args) => {
+        Object.assign(this.telemetryProperties, {
+            color: typeof args.options.color !== 'undefined'
+        });
+    });
+}, _SpoFolderAddCommand_initOptions = function _SpoFolderAddCommand_initOptions() {
     this.options.unshift({
         option: '-u, --webUrl <webUrl>'
     }, {
         option: '-p, --parentFolderUrl <parentFolderUrl>'
     }, {
         option: '-n, --name <name>'
+    }, {
+        option: '--color [color]',
+        autocomplete: Object.keys(FolderColorValues)
     });
 }, _SpoFolderAddCommand_initValidators = function _SpoFolderAddCommand_initValidators() {
-    this.validators.push(async (args) => validation.isValidSharePointUrl(args.options.webUrl));
+    this.validators.push(async (args) => {
+        const isValidSharePointUrl = validation.isValidSharePointUrl(args.options.webUrl);
+        if (isValidSharePointUrl !== true) {
+            return isValidSharePointUrl;
+        }
+        if (args.options.color && !Object.entries(FolderColorValues).flat().includes(args.options.color)) {
+            return `'${args.options.color}' is not a valid value for option 'color'. Allowed values are ${Object.keys(FolderColorValues).join(', ')}, ${Object.values(FolderColorValues).join(', ')}.`;
+        }
+        return true;
+    });
 }, _SpoFolderAddCommand_initTypes = function _SpoFolderAddCommand_initTypes() {
-    this.types.string.push('webUrl', 'parentFolderUrl', 'name');
+    this.types.string.push('webUrl', 'parentFolderUrl', 'name', 'color');
 };
 export default new SpoFolderAddCommand();
 //# sourceMappingURL=folder-add.js.map