@salesforce/plugin-devops-center 1.2.28 → 1.3.0

package/oclif.manifest.json

@@ -487,6 +487,199 @@
         "create.js"
       ]
     },
+    "devops:stage:add-branch": {
+      "aliases": [],
+      "args": {},
+      "description": "By default, the branch must exist in the repository. Use --create-vcs-branch to create a branch if it doesn't exist.\nEach pipeline stage supports only one branch. Adding a branch replaces any existing branch linked to the pipeline stage.",
+      "examples": [
+        "Add an existing branch to a stage:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --pipeline-id 0Xo000000000001 --stage-id 0Xp000000000001 --branch-name main",
+        "Create and add a branch to a pipeline stage:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --pipeline-id 0Xo000000000001 --stage-id 0Xp000000000002 --branch-name integration --create-vcs-branch"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "flags-dir": {
+          "helpGroup": "GLOBAL",
+          "name": "flags-dir",
+          "summary": "Import flag values from a directory.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "target-org": {
+          "char": "o",
+          "name": "target-org",
+          "noCacheDefault": true,
+          "required": true,
+          "summary": "Username or alias of the target org. Not required if the `target-org` configuration variable is already set.",
+          "hasDynamicHelp": true,
+          "multiple": false,
+          "type": "option"
+        },
+        "api-version": {
+          "description": "Override the api version used for api requests made by this command",
+          "name": "api-version",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "pipeline-id": {
+          "name": "pipeline-id",
+          "required": true,
+          "summary": "ID of the pipeline that contains the stage.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "stage-id": {
+          "name": "stage-id",
+          "required": true,
+          "summary": "ID of the pipeline stage to associate the branch with.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "branch-name": {
+          "char": "b",
+          "name": "branch-name",
+          "required": true,
+          "summary": "Name of the repository branch to assign to the stage.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "create-vcs-branch": {
+          "name": "create-vcs-branch",
+          "summary": "Create the branch in the remote repository if it doesn't already exist.",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": true,
+      "hiddenAliases": [],
+      "id": "devops:stage:add-branch",
+      "pluginAlias": "@salesforce/plugin-devops-center",
+      "pluginName": "@salesforce/plugin-devops-center",
+      "pluginType": "core",
+      "strict": true,
+      "summary": "Add a source code repository branch to a pipeline stage.",
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "lib",
+        "commands",
+        "devops",
+        "stage",
+        "add-branch.js"
+      ]
+    },
+    "devops:stage:add-environment": {
+      "aliases": [],
+      "args": {},
+      "description": "This command triggers an OAuth flow to authenticate the environment. A browser window opens automatically for you to log in.",
+      "examples": [
+        "Add a production environment to a stage using its ID:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --stage-id 0Xp000000000001 --environment-name Production_Org --org-type Production"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "flags-dir": {
+          "helpGroup": "GLOBAL",
+          "name": "flags-dir",
+          "summary": "Import flag values from a directory.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "target-org": {
+          "char": "o",
+          "name": "target-org",
+          "noCacheDefault": true,
+          "required": true,
+          "summary": "Username or alias of the target org. Not required if the `target-org` configuration variable is already set.",
+          "hasDynamicHelp": true,
+          "multiple": false,
+          "type": "option"
+        },
+        "api-version": {
+          "description": "Override the api version used for api requests made by this command",
+          "name": "api-version",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "pipeline-id": {
+          "name": "pipeline-id",
+          "required": true,
+          "summary": "ID of the pipeline that contains the stage.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "stage-id": {
+          "name": "stage-id",
+          "required": true,
+          "summary": "ID of the pipeline stage.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "environment-name": {
+          "char": "e",
+          "name": "environment-name",
+          "required": true,
+          "summary": "Name of the environment.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "org-type": {
+          "name": "org-type",
+          "required": true,
+          "summary": "Type of the Salesforce org. Valid values: Production, Sandbox.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "Production",
+            "Sandbox"
+          ],
+          "type": "option"
+        },
+        "no-browser": {
+          "name": "no-browser",
+          "summary": "Don't auto-open the browser for OAuth authentication. The redirect URL is printed for manual use.",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": true,
+      "hiddenAliases": [],
+      "id": "devops:stage:add-environment",
+      "pluginAlias": "@salesforce/plugin-devops-center",
+      "pluginName": "@salesforce/plugin-devops-center",
+      "pluginType": "core",
+      "strict": true,
+      "summary": "Add a Salesforce environment to a pipeline stage.",
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "lib",
+        "commands",
+        "devops",
+        "stage",
+        "add-environment.js"
+      ]
+    },
     "devops:work-item:create": {
       "aliases": [],
       "args": {},
@@ -642,6 +835,181 @@
         "list.js"
       ]
     },
+    "devops:pipeline:stage:add": {
+      "aliases": [],
+      "args": {},
+      "description": "Inserts an empty stage before the stage specified by `--next-stage-id`. The new stage doesn't include a branch or environment. Configure them separately after you create the stage.",
+      "examples": [
+        "Add a Development stage before Integration in a specific pipeline.\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --pipeline-id 0XB000000000001 --name \"Development\" --next-stage-id 0Xc000000000002",
+        "Add a QA stage before UAT in a specific pipeline.\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --pipeline-id 0XB000000000001 --name \"QA\" --next-stage-id 0Xc000000000003"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "flags-dir": {
+          "helpGroup": "GLOBAL",
+          "name": "flags-dir",
+          "summary": "Import flag values from a directory.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "target-org": {
+          "char": "o",
+          "name": "target-org",
+          "noCacheDefault": true,
+          "required": true,
+          "summary": "Username or alias of the target org. Not required if the `target-org` configuration variable is already set.",
+          "hasDynamicHelp": true,
+          "multiple": false,
+          "type": "option"
+        },
+        "api-version": {
+          "description": "Override the api version used for api requests made by this command",
+          "name": "api-version",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "pipeline-id": {
+          "name": "pipeline-id",
+          "required": true,
+          "summary": "ID of the pipeline where the stage is added.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "name": {
+          "char": "n",
+          "name": "name",
+          "required": true,
+          "summary": "Name of the pipeline stage, such as Integration, UAT, or Staging.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "next-stage-id": {
+          "name": "next-stage-id",
+          "required": true,
+          "summary": "ID of the stage that follows the new stage in the pipeline.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": true,
+      "hiddenAliases": [],
+      "id": "devops:pipeline:stage:add",
+      "pluginAlias": "@salesforce/plugin-devops-center",
+      "pluginName": "@salesforce/plugin-devops-center",
+      "pluginType": "core",
+      "strict": true,
+      "summary": "Add a stage to a DevOps Center pipeline.",
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "lib",
+        "commands",
+        "devops",
+        "pipeline",
+        "stage",
+        "add.js"
+      ]
+    },
+    "devops:work-item:status:update": {
+      "aliases": [],
+      "args": {},
+      "description": "Allowed statuses are \"In Progress\" and \"Ready to Promote\".",
+      "examples": [
+        "Update a work item status by its name to indicate the work is underway:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --work-item-name WI-000001 --status \"In Progress\"",
+        "Update a work item status by its ID to indicate the changes are ready for promotion:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --work-item-id 0Wx000000000001 --status \"Ready to Promote\""
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "flags-dir": {
+          "helpGroup": "GLOBAL",
+          "name": "flags-dir",
+          "summary": "Import flag values from a directory.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "target-org": {
+          "char": "o",
+          "name": "target-org",
+          "noCacheDefault": true,
+          "required": true,
+          "summary": "Username or alias of the target org. Not required if the `target-org` configuration variable is already set.",
+          "hasDynamicHelp": true,
+          "multiple": false,
+          "type": "option"
+        },
+        "api-version": {
+          "description": "Override the api version used for api requests made by this command",
+          "name": "api-version",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "work-item-name": {
+          "char": "n",
+          "name": "work-item-name",
+          "summary": "Name of the work item, such as WI-000001.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "work-item-id": {
+          "char": "w",
+          "name": "work-item-id",
+          "summary": "ID of the work item.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "status": {
+          "name": "status",
+          "required": true,
+          "summary": "Status to set for the work item. Allowed values: \"In Progress\", \"Ready to Promote\".",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "In Progress",
+            "Ready to Promote"
+          ],
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": true,
+      "hiddenAliases": [],
+      "id": "devops:work-item:status:update",
+      "pluginAlias": "@salesforce/plugin-devops-center",
+      "pluginName": "@salesforce/plugin-devops-center",
+      "pluginType": "core",
+      "strict": true,
+      "summary": "Update the status of a work item in DevOps Center.",
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "lib",
+        "commands",
+        "devops",
+        "work-item",
+        "status",
+        "update.js"
+      ]
+    },
     "project:deploy:pipeline:quick": {
       "aliases": [],
       "args": {},
@@ -1217,182 +1585,7 @@
         "pipeline",
         "validate.js"
       ]
-    },
-    "devops:pipeline:stage:add": {
-      "aliases": [],
-      "args": {},
-      "description": "Inserts an empty stage before the stage specified by `--next-stage-id`. The new stage doesn't include a branch or environment. Configure them separately after you create the stage.",
-      "examples": [
-        "Add a Development stage before Integration in a specific pipeline.\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --pipeline-id 0XB000000000001 --name \"Development\" --next-stage-id 0Xc000000000002",
-        "Add a QA stage before UAT in a specific pipeline.\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --pipeline-id 0XB000000000001 --name \"QA\" --next-stage-id 0Xc000000000003"
-      ],
-      "flags": {
-        "json": {
-          "description": "Format output as json.",
-          "helpGroup": "GLOBAL",
-          "name": "json",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "flags-dir": {
-          "helpGroup": "GLOBAL",
-          "name": "flags-dir",
-          "summary": "Import flag values from a directory.",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "target-org": {
-          "char": "o",
-          "name": "target-org",
-          "noCacheDefault": true,
-          "required": true,
-          "summary": "Username or alias of the target org. Not required if the `target-org` configuration variable is already set.",
-          "hasDynamicHelp": true,
-          "multiple": false,
-          "type": "option"
-        },
-        "api-version": {
-          "description": "Override the api version used for api requests made by this command",
-          "name": "api-version",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "pipeline-id": {
-          "name": "pipeline-id",
-          "required": true,
-          "summary": "ID of the pipeline where the stage is added.",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "name": {
-          "char": "n",
-          "name": "name",
-          "required": true,
-          "summary": "Name of the pipeline stage, such as Integration, UAT, or Staging.",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "next-stage-id": {
-          "name": "next-stage-id",
-          "required": true,
-          "summary": "ID of the stage that follows the new stage in the pipeline.",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        }
-      },
-      "hasDynamicHelp": true,
-      "hiddenAliases": [],
-      "id": "devops:pipeline:stage:add",
-      "pluginAlias": "@salesforce/plugin-devops-center",
-      "pluginName": "@salesforce/plugin-devops-center",
-      "pluginType": "core",
-      "strict": true,
-      "summary": "Add a stage to a DevOps Center pipeline.",
-      "enableJsonFlag": true,
-      "isESM": true,
-      "relativePath": [
-        "lib",
-        "commands",
-        "devops",
-        "pipeline",
-        "stage",
-        "add.js"
-      ]
-    },
-    "devops:work-item:status:update": {
-      "aliases": [],
-      "args": {},
-      "description": "Allowed statuses are \"In Progress\" and \"Ready to Promote\".",
-      "examples": [
-        "Update a work item status by its name to indicate the work is underway:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --work-item-name WI-000001 --status \"In Progress\"",
-        "Update a work item status by its ID to indicate the changes are ready for promotion:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --work-item-id 0Wx000000000001 --status \"Ready to Promote\""
-      ],
-      "flags": {
-        "json": {
-          "description": "Format output as json.",
-          "helpGroup": "GLOBAL",
-          "name": "json",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "flags-dir": {
-          "helpGroup": "GLOBAL",
-          "name": "flags-dir",
-          "summary": "Import flag values from a directory.",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "target-org": {
-          "char": "o",
-          "name": "target-org",
-          "noCacheDefault": true,
-          "required": true,
-          "summary": "Username or alias of the target org. Not required if the `target-org` configuration variable is already set.",
-          "hasDynamicHelp": true,
-          "multiple": false,
-          "type": "option"
-        },
-        "api-version": {
-          "description": "Override the api version used for api requests made by this command",
-          "name": "api-version",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "work-item-name": {
-          "char": "n",
-          "name": "work-item-name",
-          "summary": "Name of the work item, such as WI-000001.",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "work-item-id": {
-          "char": "w",
-          "name": "work-item-id",
-          "summary": "ID of the work item.",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "status": {
-          "name": "status",
-          "required": true,
-          "summary": "Status to set for the work item. Allowed values: \"In Progress\", \"Ready to Promote\".",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "In Progress",
-            "Ready to Promote"
-          ],
-          "type": "option"
-        }
-      },
-      "hasDynamicHelp": true,
-      "hiddenAliases": [],
-      "id": "devops:work-item:status:update",
-      "pluginAlias": "@salesforce/plugin-devops-center",
-      "pluginName": "@salesforce/plugin-devops-center",
-      "pluginType": "core",
-      "strict": true,
-      "summary": "Update the status of a work item in DevOps Center.",
-      "enableJsonFlag": true,
-      "isESM": true,
-      "relativePath": [
-        "lib",
-        "commands",
-        "devops",
-        "work-item",
-        "status",
-        "update.js"
-      ]
     }
   },
-  "version": "1.2.28"
+  "version": "1.3.0"
 }

package/package.json

@@ -1,7 +1,7 @@
 {
     "name": "@salesforce/plugin-devops-center",
     "description": "The DevOps Center CLI plugin provides a command-line alternative to performing equivalent actions in the DevOps Center graphical UI",
-    "version": "1.2.28",
+    "version": "1.3.0",
     "type": "module",
     "author": "Salesforce",
     "bugs": "https://github.com/forcedotcom/cli/issues",
@@ -244,7 +244,7 @@
         }
     },
     "sfdx": {
-        "publicKeyUrl": "https://developer.salesforce.com/media/salesforce-cli/security/@salesforce/plugin-devops-center/1.2.28.crt",
-        "signatureUrl": "https://developer.salesforce.com/media/salesforce-cli/security/@salesforce/plugin-devops-center/1.2.28.sig"
+        "publicKeyUrl": "https://developer.salesforce.com/media/salesforce-cli/security/@salesforce/plugin-devops-center/1.3.0.crt",
+        "signatureUrl": "https://developer.salesforce.com/media/salesforce-cli/security/@salesforce/plugin-devops-center/1.3.0.sig"
     }
 }

package/schemas/devops-stage-add__branch.json

@@ -0,0 +1,34 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$ref": "#/definitions/AddStageBranchResult",
+  "definitions": {
+    "AddStageBranchResult": {
+      "type": "object",
+      "properties": {
+        "success": {
+          "type": "boolean"
+        },
+        "stageId": {
+          "type": "string"
+        },
+        "branchName": {
+          "type": "string"
+        },
+        "branchCreated": {
+          "type": "boolean"
+        },
+        "repoBranchId": {
+          "type": "string"
+        },
+        "pipelineId": {
+          "type": "string"
+        },
+        "error": {
+          "type": "string"
+        }
+      },
+      "required": ["success", "stageId"],
+      "additionalProperties": false
+    }
+  }
+}

package/schemas/devops-stage-add__environment.json

@@ -0,0 +1,47 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$ref": "#/definitions/AddStageEnvironmentResult",
+  "definitions": {
+    "AddStageEnvironmentResult": {
+      "type": "object",
+      "properties": {
+        "success": {
+          "type": "boolean"
+        },
+        "stageId": {
+          "type": "string"
+        },
+        "environmentId": {
+          "type": "string"
+        },
+        "environmentName": {
+          "type": "string"
+        },
+        "orgType": {
+          "$ref": "#/definitions/OrgType"
+        },
+        "pipelineId": {
+          "type": "string"
+        },
+        "redirectUrl": {
+          "type": "string"
+        },
+        "namedCredential": {
+          "type": "string"
+        },
+        "organizationId": {
+          "type": "string"
+        },
+        "error": {
+          "type": "string"
+        }
+      },
+      "required": ["success", "stageId"],
+      "additionalProperties": false
+    },
+    "OrgType": {
+      "type": "string",
+      "enum": ["Production", "Sandbox"]
+    }
+  }
+}