@salesforce/plugin-devops-center 1.3.0 → 1.4.1

package/lib/utils/deletePipelineStage.js

@@ -0,0 +1,41 @@
+/*
+ * Copyright 2026, Salesforce, Inc.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { fetchPipelineStages } from './pipelineUtils.js';
+/**
+ * Deletes a pipeline stage and re-links any predecessor stage so the chain stays intact.
+ * If stage B sits between A→B→C, deleting B updates A's NextStageId to C before the delete.
+ */
+export async function deletePipelineStage(connection, pipelineId, stageId) {
+    const stages = await fetchPipelineStages(connection, pipelineId);
+    const target = stages.find((s) => s.Id === stageId);
+    if (!target) {
+        throw new Error(`Stage not found: ${stageId}`);
+    }
+    const predecessor = stages.find((s) => s.NextStageId === stageId);
+    if (predecessor) {
+        await connection
+            .sobject('DevopsPipelineStage')
+            .update({ Id: predecessor.Id, NextStageId: target.NextStageId ?? null });
+    }
+    const result = await connection.sobject('DevopsPipelineStage').delete(stageId);
+    const deleteResult = result;
+    if (!deleteResult.success) {
+        const errorMsg = deleteResult.errors?.map((e) => e.message).join('; ') ?? 'Unknown error';
+        return { success: false, error: errorMsg };
+    }
+    return { success: true, stageId, pipelineId };
+}
+//# sourceMappingURL=deletePipelineStage.js.map

package/lib/utils/deletePipelineStage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deletePipelineStage.js","sourceRoot":"","sources":["../../src/utils/deletePipelineStage.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAGH,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AASzD;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,UAAsB,EACtB,UAAkB,EAClB,OAAe;IAEf,MAAM,MAAM,GAAG,MAAM,mBAAmB,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;IACjE,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,OAAO,CAAC,CAAC;IACpD,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,oBAAoB,OAAO,EAAE,CAAC,CAAC;IACjD,CAAC;IAED,MAAM,WAAW,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,KAAK,OAAO,CAAC,CAAC;IAClE,IAAI,WAAW,EAAE,CAAC;QAChB,MAAM,UAAU;aACb,OAAO,CAAC,qBAAqB,CAAC;aAC9B,MAAM,CAAC,EAAE,EAAE,EAAE,WAAW,CAAC,EAAE,EAAE,WAAW,EAAE,MAAM,CAAC,WAAW,IAAI,IAAI,EAAE,CAAC,CAAC;IAC7E,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,OAAO,CAAC,qBAAqB,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAC/E,MAAM,YAAY,GAAG,MAA8E,CAAC;IAEpG,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,CAAC;QAC1B,MAAM,QAAQ,GAAG,YAAY,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,eAAe,CAAC;QAC1F,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC;IAC7C,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC;AAChD,CAAC"}

package/lib/utils/deleteStageEnvironment.d.ts

@@ -0,0 +1,8 @@
+import { Connection } from '@salesforce/core';
+export type DeleteStageEnvironmentResult = {
+    success: boolean;
+    environmentId?: string;
+    stageId?: string;
+    error?: string;
+};
+export declare function deleteStageEnvironment(connection: Connection, environmentId: string): Promise<DeleteStageEnvironmentResult>;

package/lib/utils/deleteStageEnvironment.js

@@ -0,0 +1,33 @@
+/*
+ * Copyright 2026, Salesforce, Inc.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { validateSalesforceId } from './soqlUtils.js';
+export async function deleteStageEnvironment(connection, environmentId) {
+    validateSalesforceId(environmentId, 'environment');
+    const stageResult = await connection.query(`SELECT Id FROM DevopsPipelineStage WHERE DevOpsEnvironmentId = '${environmentId}'`);
+    const referencingStages = stageResult.records ?? [];
+    if (referencingStages.length > 0) {
+        const updates = referencingStages.map((s) => ({ Id: s.Id, DevOpsEnvironmentId: null }));
+        await connection.sobject('DevopsPipelineStage').update(updates);
+    }
+    const result = await connection.sobject('DevopsEnvironment').delete(environmentId);
+    const deleteResult = result;
+    if (!deleteResult.success) {
+        const errorMsg = deleteResult.errors?.map((e) => e.message).join('; ') ?? 'Unknown error';
+        return { success: false, error: errorMsg };
+    }
+    return { success: true, environmentId };
+}
+//# sourceMappingURL=deleteStageEnvironment.js.map

package/lib/utils/deleteStageEnvironment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deleteStageEnvironment.js","sourceRoot":"","sources":["../../src/utils/deleteStageEnvironment.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAGH,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAStD,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,UAAsB,EACtB,aAAqB;IAErB,oBAAoB,CAAC,aAAa,EAAE,aAAa,CAAC,CAAC;IACnD,MAAM,WAAW,GAAG,MAAM,UAAU,CAAC,KAAK,CACxC,mEAAmE,aAAa,GAAG,CACpF,CAAC;IAEF,MAAM,iBAAiB,GAAG,WAAW,CAAC,OAAO,IAAI,EAAE,CAAC;IACpD,IAAI,iBAAiB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACjC,MAAM,OAAO,GAAG,iBAAiB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,mBAAmB,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QACxF,MAAM,UAAU,CAAC,OAAO,CAAC,qBAAqB,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAClE,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,OAAO,CAAC,mBAAmB,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;IACnF,MAAM,YAAY,GAAG,MAA8E,CAAC;IAEpG,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,CAAC;QAC1B,MAAM,QAAQ,GAAG,YAAY,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,eAAe,CAAC;QAC1F,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC;IAC7C,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,aAAa,EAAE,CAAC;AAC1C,CAAC"}

package/lib/utils/deployStage.d.ts

@@ -0,0 +1,29 @@
+import { Connection } from '@salesforce/core';
+export type UndeployedWorkItemsResult = {
+    undeployedWorkitemIds: string[];
+};
+export type ValidateDeployResult = {
+    success: boolean;
+    errorType: string | null;
+    errorDetails: string | null;
+};
+export type DeployStageResult = {
+    requestId: string;
+    status: string;
+    message: string;
+    promotedWorkitemIds: string[];
+};
+/**
+ * GET /services/data/vXX.X/connect/devops/pipelines/{pipelineId}/stages/{stageId}/undeployedWorkitems
+ */
+export declare function getUndeployedWorkItems(connection: Connection, pipelineId: string, stageId: string): Promise<UndeployedWorkItemsResult>;
+/**
+ * POST /services/data/vXX.X/connect/devops/pipelines/{pipelineId}/validatePromote
+ */
+export declare function validateDeploy(connection: Connection, pipelineId: string, workItemIds: string[], targetStageId: string): Promise<ValidateDeployResult>;
+/**
+ * POST /services/data/vXX.X/connect/devops/pipelines/{pipelineId}/promote
+ * When workItemIds are provided, targets those specific items (allWorkItemsInStage: false).
+ * When omitted, lets Core fill IDs from undeployed/external-merge state (allWorkItemsInStage: true).
+ */
+export declare function executeDeploy(connection: Connection, pipelineId: string, targetStageId: string, fullDeploy?: boolean, testLevel?: string, runTests?: string[], workItemIds?: string[]): Promise<DeployStageResult>;

package/lib/utils/deployStage.js

@@ -0,0 +1,68 @@
+/*
+ * Copyright 2026, Salesforce, Inc.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * GET /services/data/vXX.X/connect/devops/pipelines/{pipelineId}/stages/{stageId}/undeployedWorkitems
+ */
+export async function getUndeployedWorkItems(connection, pipelineId, stageId) {
+    const path = `/services/data/v${connection.getApiVersion()}/connect/devops/pipelines/${pipelineId}/stages/${stageId}/undeployedWorkitems`;
+    const response = await connection.request({ method: 'GET', url: path });
+    return { undeployedWorkitemIds: response.undeployedWorkitemIds ?? [] };
+}
+/**
+ * POST /services/data/vXX.X/connect/devops/pipelines/{pipelineId}/validatePromote
+ */
+export async function validateDeploy(connection, pipelineId, workItemIds, targetStageId) {
+    const path = `/services/data/v${connection.getApiVersion()}/connect/devops/pipelines/${pipelineId}/validatePromote`;
+    const response = await connection.request({
+        method: 'POST',
+        url: path,
+        body: JSON.stringify({ selectedWorkItemIds: workItemIds, targetStageId }),
+        headers: { 'Content-Type': 'application/json' },
+    });
+    return {
+        success: response.success ?? true,
+        errorType: response.errorType ?? null,
+        errorDetails: response.errorDetails ?? null,
+    };
+}
+/**
+ * POST /services/data/vXX.X/connect/devops/pipelines/{pipelineId}/promote
+ * When workItemIds are provided, targets those specific items (allWorkItemsInStage: false).
+ * When omitted, lets Core fill IDs from undeployed/external-merge state (allWorkItemsInStage: true).
+ */
+export async function executeDeploy(connection, pipelineId, targetStageId, fullDeploy = false, testLevel = 'Default', runTests = [], workItemIds) {
+    const path = `/services/data/v${connection.getApiVersion()}/connect/devops/pipelines/${pipelineId}/promote`;
+    const explicitIds = workItemIds && workItemIds.length > 0;
+    const response = await connection.request({
+        method: 'POST',
+        url: path,
+        body: JSON.stringify({
+            workitemIds: explicitIds ? workItemIds : [],
+            targetStageId,
+            allWorkItemsInStage: !explicitIds,
+            isCheckDeploy: false,
+            deployOptions: { testLevel, isFullDeploy: fullDeploy, runTests },
+        }),
+        headers: { 'Content-Type': 'application/json' },
+    });
+    return {
+        requestId: response.requestId ?? '',
+        status: response.status ?? '',
+        message: response.message ?? '',
+        promotedWorkitemIds: response.promotedWorkitemIds ?? [],
+    };
+}
+//# sourceMappingURL=deployStage.js.map

package/lib/utils/deployStage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deployStage.js","sourceRoot":"","sources":["../../src/utils/deployStage.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAsCH;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,UAAsB,EACtB,UAAkB,EAClB,OAAe;IAEf,MAAM,IAAI,GAAG,mBAAmB,UAAU,CAAC,aAAa,EAAE,6BAA6B,UAAU,WAAW,OAAO,sBAAsB,CAAC;IAC1I,MAAM,QAAQ,GAAG,MAAM,UAAU,CAAC,OAAO,CAA8B,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC;IACrG,OAAO,EAAE,qBAAqB,EAAE,QAAQ,CAAC,qBAAqB,IAAI,EAAE,EAAE,CAAC;AACzE,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,UAAsB,EACtB,UAAkB,EAClB,WAAqB,EACrB,aAAqB;IAErB,MAAM,IAAI,GAAG,mBAAmB,UAAU,CAAC,aAAa,EAAE,6BAA6B,UAAU,kBAAkB,CAAC;IACpH,MAAM,QAAQ,GAAG,MAAM,UAAU,CAAC,OAAO,CAAyB;QAChE,MAAM,EAAE,MAAM;QACd,GAAG,EAAE,IAAI;QACT,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,mBAAmB,EAAE,WAAW,EAAE,aAAa,EAAE,CAAC;QACzE,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;KAChD,CAAC,CAAC;IACH,OAAO;QACL,OAAO,EAAE,QAAQ,CAAC,OAAO,IAAI,IAAI;QACjC,SAAS,EAAE,QAAQ,CAAC,SAAS,IAAI,IAAI;QACrC,YAAY,EAAE,QAAQ,CAAC,YAAY,IAAI,IAAI;KAC5C,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,UAAsB,EACtB,UAAkB,EAClB,aAAqB,EACrB,UAAU,GAAG,KAAK,EAClB,SAAS,GAAG,SAAS,EACrB,WAAqB,EAAE,EACvB,WAAsB;IAEtB,MAAM,IAAI,GAAG,mBAAmB,UAAU,CAAC,aAAa,EAAE,6BAA6B,UAAU,UAAU,CAAC;IAC5G,MAAM,WAAW,GAAG,WAAW,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC;IAC1D,MAAM,QAAQ,GAAG,MAAM,UAAU,CAAC,OAAO,CAAsB;QAC7D,MAAM,EAAE,MAAM;QACd,GAAG,EAAE,IAAI;QACT,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;YACnB,WAAW,EAAE,WAAW,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE;YAC3C,aAAa;YACb,mBAAmB,EAAE,CAAC,WAAW;YACjC,aAAa,EAAE,KAAK;YACpB,aAAa,EAAE,EAAE,SAAS,EAAE,YAAY,EAAE,UAAU,EAAE,QAAQ,EAAE;SACjE,CAAC;QACF,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;KAChD,CAAC,CAAC;IACH,OAAO;QACL,SAAS,EAAE,QAAQ,CAAC,SAAS,IAAI,EAAE;QACnC,MAAM,EAAE,QAAQ,CAAC,MAAM,IAAI,EAAE;QAC7B,OAAO,EAAE,QAAQ,CAAC,OAAO,IAAI,EAAE;QAC/B,mBAAmB,EAAE,QAAQ,CAAC,mBAAmB,IAAI,EAAE;KACxD,CAAC;AACJ,CAAC"}

package/lib/utils/detachProject.d.ts

@@ -0,0 +1,8 @@
+import { Connection } from '@salesforce/core';
+export type DetachProjectResult = {
+    success: boolean;
+    projectId: string;
+    pipelineId: string;
+    error?: string;
+};
+export declare function detachProject(connection: Connection, projectId: string, pipelineId: string): Promise<DetachProjectResult>;

package/lib/utils/detachProject.js

@@ -0,0 +1,37 @@
+/*
+ * Copyright 2026, Salesforce, Inc.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { validateSalesforceId } from './soqlUtils.js';
+export async function detachProject(connection, projectId, pipelineId) {
+    validateSalesforceId(projectId, 'project');
+    validateSalesforceId(pipelineId, 'pipeline');
+    const queryResult = await connection.query(`SELECT Id FROM DevopsProjectPipeline WHERE DevopsProjectId = '${projectId}' AND DevopsPipelineId = '${pipelineId}' LIMIT 1`);
+    const junction = (queryResult.records ?? [])[0];
+    if (!junction) {
+        throw new Error(`ProjectNotAttached:${projectId}:${pipelineId}`);
+    }
+    const result = await connection.sobject('DevopsProjectPipeline').delete(junction.Id);
+    if (result.success) {
+        return { success: true, projectId, pipelineId };
+    }
+    const errorMessages = result.errors?.map((e) => (typeof e === 'string' ? e : JSON.stringify(e))).join('; ');
+    return {
+        success: false,
+        projectId,
+        pipelineId,
+        error: errorMessages ?? 'Unknown error',
+    };
+}
+//# sourceMappingURL=detachProject.js.map

package/lib/utils/detachProject.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"detachProject.js","sourceRoot":"","sources":["../../src/utils/detachProject.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAGH,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAStD,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,UAAsB,EACtB,SAAiB,EACjB,UAAkB;IAElB,oBAAoB,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;IAC3C,oBAAoB,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;IAC7C,MAAM,WAAW,GAAG,MAAM,UAAU,CAAC,KAAK,CACxC,iEAAiE,SAAS,6BAA6B,UAAU,WAAW,CAC7H,CAAC;IAEF,MAAM,QAAQ,GAAG,CAAC,WAAW,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IAChD,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,IAAI,KAAK,CAAC,sBAAsB,SAAS,IAAI,UAAU,EAAE,CAAC,CAAC;IACnE,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,OAAO,CAAC,uBAAuB,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IAErF,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACnB,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,UAAU,EAAE,CAAC;IAClD,CAAC;IAED,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC5G,OAAO;QACL,OAAO,EAAE,KAAK;QACd,SAAS;QACT,UAAU;QACV,KAAK,EAAE,aAAa,IAAI,eAAe;KACxC,CAAC;AACJ,CAAC"}

package/lib/utils/getPipeline.d.ts

@@ -0,0 +1,27 @@
+import { Connection } from '@salesforce/core';
+export type StageEnvironment = {
+    id: string;
+    name: string;
+};
+export type PipelineStageDetail = {
+    id: string;
+    name: string | null;
+    nextStageId: string | null;
+    branchName: string | null;
+    repositoryName: string | null;
+    repositoryOwner: string | null;
+    environment: StageEnvironment | null;
+};
+export type ConnectedProject = {
+    id: string;
+    name: string | null;
+};
+export type PipelineGetResult = {
+    id: string;
+    name: string;
+    description: string | null;
+    isActive: boolean;
+    stages: PipelineStageDetail[];
+    connectedProjects: ConnectedProject[];
+};
+export declare function getPipeline(connection: Connection, pipelineId: string): Promise<PipelineGetResult>;

package/lib/utils/getPipeline.js

@@ -0,0 +1,66 @@
+/*
+ * Copyright 2026, Salesforce, Inc.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { validateSalesforceId } from './soqlUtils.js';
+function orderStages(stages) {
+    if (stages.length <= 1)
+        return stages;
+    const nextIds = new Set(stages.map((s) => s.nextStageId).filter(Boolean));
+    const first = stages.find((s) => !nextIds.has(s.id));
+    if (!first)
+        return stages;
+    const byId = new Map(stages.map((s) => [s.id, s]));
+    const ordered = [];
+    let current = first;
+    while (current) {
+        ordered.push(current);
+        current = current.nextStageId ? byId.get(current.nextStageId) : undefined;
+    }
+    return ordered;
+}
+export async function getPipeline(connection, pipelineId) {
+    validateSalesforceId(pipelineId, 'pipeline');
+    const pipelineResult = await connection.query(`SELECT Id, Name, Description, IsActive FROM DevopsPipeline WHERE Id = '${pipelineId}' LIMIT 1`);
+    const pipeline = (pipelineResult.records ?? [])[0];
+    if (!pipeline) {
+        throw new Error(`Pipeline not found: ${pipelineId}`);
+    }
+    const [stageResult, junctionResult] = await Promise.all([
+        connection.query(`SELECT Id, Name, NextStageId, DevopsPipelineId, SourceCodeRepositoryBranch.Name, SourceCodeRepositoryBranch.SourceCodeRepository.Name, SourceCodeRepositoryBranch.SourceCodeRepository.RepositoryOwner, DevOpsEnvironment.Id, DevOpsEnvironment.Name FROM DevopsPipelineStage WHERE DevopsPipelineId = '${pipelineId}'`),
+        connection.query(`SELECT DevopsProjectId, DevopsProject.Name FROM DevopsProjectPipeline WHERE DevopsPipelineId = '${pipelineId}'`),
+    ]);
+    const stages = orderStages((stageResult.records ?? []).map((s) => ({
+        id: s.Id,
+        name: s.Name,
+        nextStageId: s.NextStageId ?? null,
+        branchName: s.SourceCodeRepositoryBranch?.Name ?? null,
+        repositoryName: s.SourceCodeRepositoryBranch?.SourceCodeRepository?.Name ?? null,
+        repositoryOwner: s.SourceCodeRepositoryBranch?.SourceCodeRepository?.RepositoryOwner ?? null,
+        environment: s.DevOpsEnvironment ? { id: s.DevOpsEnvironment.Id, name: s.DevOpsEnvironment.Name } : null,
+    })));
+    const connectedProjects = (junctionResult.records ?? []).map((j) => ({
+        id: j.DevopsProjectId,
+        name: j.DevopsProject?.Name ?? null,
+    }));
+    return {
+        id: pipeline.Id,
+        name: pipeline.Name,
+        description: pipeline.Description,
+        isActive: pipeline.IsActive,
+        stages,
+        connectedProjects,
+    };
+}
+//# sourceMappingURL=getPipeline.js.map

package/lib/utils/getPipeline.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getPipeline.js","sourceRoot":"","sources":["../../src/utils/getPipeline.ts"],"names":[],"mappings":"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"}

package/lib/utils/getRequestStatus.d.ts

@@ -0,0 +1,10 @@
+import { Connection } from '@salesforce/core';
+export type RequestStatusResult = {
+    id: string;
+    status: string;
+    message: string | null;
+    errorDetails: string | null;
+    requestToken: string;
+    requestCompletionDate: string | null;
+};
+export declare function getRequestStatus(connection: Connection, requestToken: string): Promise<RequestStatusResult>;

package/lib/utils/getRequestStatus.js

@@ -0,0 +1,32 @@
+/*
+ * Copyright 2026, Salesforce, Inc.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { escapeSOQL } from './soqlUtils.js';
+export async function getRequestStatus(connection, requestToken) {
+    const result = await connection.query(`SELECT Id, Status, Message, ErrorDetails, RequestToken, RequestCompletionDate FROM DevopsRequestInfo WHERE RequestToken = '${escapeSOQL(requestToken)}' LIMIT 1`);
+    const record = (result.records ?? [])[0];
+    if (!record) {
+        throw new Error(`RequestNotFound:${requestToken}`);
+    }
+    return {
+        id: record.Id,
+        status: record.Status,
+        message: record.Message,
+        errorDetails: record.ErrorDetails,
+        requestToken: record.RequestToken,
+        requestCompletionDate: record.RequestCompletionDate,
+    };
+}
+//# sourceMappingURL=getRequestStatus.js.map

package/lib/utils/getRequestStatus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getRequestStatus.js","sourceRoot":"","sources":["../../src/utils/getRequestStatus.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAGH,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAoB5C,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,UAAsB,EAAE,YAAoB;IACjF,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,KAAK,CACnC,8HAA8H,UAAU,CACtI,YAAY,CACb,WAAW,CACb,CAAC;IAEF,MAAM,MAAM,GAAG,CAAC,MAAM,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IACzC,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,mBAAmB,YAAY,EAAE,CAAC,CAAC;IACrD,CAAC;IAED,OAAO;QACL,EAAE,EAAE,MAAM,CAAC,EAAE;QACb,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,YAAY,EAAE,MAAM,CAAC,YAAY;QACjC,YAAY,EAAE,MAAM,CAAC,YAAY;QACjC,qBAAqB,EAAE,MAAM,CAAC,qBAAqB;KACpD,CAAC;AACJ,CAAC"}

package/lib/utils/listPipelines.d.ts

@@ -0,0 +1,11 @@
+import { Connection } from '@salesforce/core';
+export type DevopsPipeline = {
+    Id: string;
+    Name: string;
+    Description: string | null;
+    IsActive: boolean;
+};
+export type PipelineListResult = {
+    pipelines: DevopsPipeline[];
+};
+export declare function listPipelines(connection: Connection): Promise<PipelineListResult>;

package/lib/utils/listPipelines.js

@@ -0,0 +1,20 @@
+/*
+ * Copyright 2026, Salesforce, Inc.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+export async function listPipelines(connection) {
+    const result = await connection.query('SELECT Id, Name, Description, IsActive FROM DevopsPipeline');
+    return { pipelines: result.records ?? [] };
+}
+//# sourceMappingURL=listPipelines.js.map

package/lib/utils/listPipelines.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"listPipelines.js","sourceRoot":"","sources":["../../src/utils/listPipelines.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAeH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,UAAsB;IACxD,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,KAAK,CAAiB,4DAA4D,CAAC,CAAC;IACpH,OAAO,EAAE,SAAS,EAAE,MAAM,CAAC,OAAO,IAAI,EAAE,EAAE,CAAC;AAC7C,CAAC"}

package/lib/utils/pipelineUtils.js

@@ -13,12 +13,15 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
+import { validateSalesforceId } from './soqlUtils.js';
 export async function getPipelineIdForProject(connection, projectId) {
+    validateSalesforceId(projectId, 'project');
     const query = `SELECT DevopsPipelineId FROM DevopsProjectPipeline WHERE DevopsProjectId = '${projectId}' LIMIT 1`;
     const result = await connection.query(query);
     return (result.records ?? [])[0]?.DevopsPipelineId;
 }
 export async function fetchPipelineStages(connection, pipelineId) {
+    validateSalesforceId(pipelineId, 'pipeline');
     const stageQuery = `SELECT Id, Name, NextStageId, SourceCodeRepositoryBranch.Name FROM DevopsPipelineStage WHERE DevopsPipelineId = '${pipelineId}'`;
     const stageResult = await connection.query(stageQuery);
     return stageResult.records ?? [];

package/lib/utils/pipelineUtils.js.map

@@ -1 +1 @@
-{"version":3,"file":"pipelineUtils.js","sourceRoot":"","sources":["../../src/utils/pipelineUtils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAKH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAAC,UAAsB,EAAE,SAAiB;IACrF,MAAM,KAAK,GAAG,+EAA+E,SAAS,WAAW,CAAC;IAClH,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,KAAK,CAAmC,KAAK,CAAC,CAAC;IAC/E,OAAO,CAAC,MAAM,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,gBAAgB,CAAC;AACrD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,UAAsB,EAAE,UAAkB;IAClF,MAAM,UAAU,GAAG,oHAAoH,UAAU,GAAG,CAAC;IACrJ,MAAM,WAAW,GAAG,MAAM,UAAU,CAAC,KAAK,CAAsB,UAAU,CAAC,CAAC;IAC5E,OAAO,WAAW,CAAC,OAAO,IAAI,EAAE,CAAC;AACnC,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,MAA6B;IAC/D,MAAM,WAAW,GAAG,IAAI,GAAG,CAAS,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAC7D,MAAM,YAAY,GAAG,IAAI,GAAG,CAAS,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,MAAM,CAAC,OAAO,CAAa,CAAC,CAAC;IACnG,MAAM,aAAa,GAAa,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,YAAY,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;IAC9F,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IACjD,OAAO,aAAa,CAAC,CAAC,CAAC,CAAC;AAC1B,CAAC;AAED,MAAM,UAAU,oBAAoB,CAClC,cAAkC,EAClC,MAA6B;IAE7B,IAAI,CAAC,MAAM,CAAC,MAAM;QAAE,OAAO,SAAS,CAAC;IACrC,IAAI,cAAc,EAAE,CAAC;QACnB,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,cAAc,CAAC,CAAC;QAC5D,OAAO,OAAO,EAAE,WAAW,IAAI,SAAS,CAAC;IAC3C,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,aAAa,CAC3B,MAA6B,EAC7B,OAA2B;IAE3B,IAAI,CAAC,OAAO;QAAE,OAAO,SAAS,CAAC;IAC/B,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,OAAO,CAAC,CAAC;AAC9C,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,KAAsC;IAC3E,OAAO,KAAK,EAAE,0BAA0B,EAAE,IAAI,IAAI,SAAS,CAAC;AAC9D,CAAC"}
+{"version":3,"file":"pipelineUtils.js","sourceRoot":"","sources":["../../src/utils/pipelineUtils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAIH,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAEtD,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAAC,UAAsB,EAAE,SAAiB;IACrF,oBAAoB,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;IAC3C,MAAM,KAAK,GAAG,+EAA+E,SAAS,WAAW,CAAC;IAClH,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,KAAK,CAAmC,KAAK,CAAC,CAAC;IAC/E,OAAO,CAAC,MAAM,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,gBAAgB,CAAC;AACrD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,UAAsB,EAAE,UAAkB;IAClF,oBAAoB,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;IAC7C,MAAM,UAAU,GAAG,oHAAoH,UAAU,GAAG,CAAC;IACrJ,MAAM,WAAW,GAAG,MAAM,UAAU,CAAC,KAAK,CAAsB,UAAU,CAAC,CAAC;IAC5E,OAAO,WAAW,CAAC,OAAO,IAAI,EAAE,CAAC;AACnC,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,MAA6B;IAC/D,MAAM,WAAW,GAAG,IAAI,GAAG,CAAS,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAC7D,MAAM,YAAY,GAAG,IAAI,GAAG,CAAS,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,MAAM,CAAC,OAAO,CAAa,CAAC,CAAC;IACnG,MAAM,aAAa,GAAa,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,YAAY,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;IAC9F,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IACjD,OAAO,aAAa,CAAC,CAAC,CAAC,CAAC;AAC1B,CAAC;AAED,MAAM,UAAU,oBAAoB,CAClC,cAAkC,EAClC,MAA6B;IAE7B,IAAI,CAAC,MAAM,CAAC,MAAM;QAAE,OAAO,SAAS,CAAC;IACrC,IAAI,cAAc,EAAE,CAAC;QACnB,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,cAAc,CAAC,CAAC;QAC5D,OAAO,OAAO,EAAE,WAAW,IAAI,SAAS,CAAC;IAC3C,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,aAAa,CAC3B,MAA6B,EAC7B,OAA2B;IAE3B,IAAI,CAAC,OAAO;QAAE,OAAO,SAAS,CAAC;IAC/B,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,OAAO,CAAC,CAAC;AAC9C,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,KAAsC;IAC3E,OAAO,KAAK,EAAE,0BAA0B,EAAE,IAAI,IAAI,SAAS,CAAC;AAC9D,CAAC"}

package/lib/utils/prepareWorkItem.d.ts

@@ -0,0 +1,25 @@
+import { Connection } from '@salesforce/core';
+export type PrepareWorkItemParams = {
+    connection: Connection;
+    pipelineId: string;
+    workItemId: string;
+    sourceStageId: string;
+    targetStageId: string;
+};
+export type PrepareWorkItemResult = {
+    success: boolean;
+    requestToken: string | null;
+    errorCode: string | null;
+    errorMessage: string | null;
+};
+/**
+ * Prepares a work item for one-off promotion by creating the necessary branches
+ * and pull requests in the source control repository.
+ * API: POST /services/data/v{version}/connect/devops/pipelines/{pipelineId}/promote/oneoff/prepare
+ */
+export declare function prepareWorkItem(params: PrepareWorkItemParams): Promise<PrepareWorkItemResult>;
+export type WorkItemContext = {
+    projectId: string;
+    pipelineStageId: string;
+};
+export declare function resolveProjectIdFromWorkItem(connection: Connection, workItemId: string): Promise<WorkItemContext>;

package/lib/utils/prepareWorkItem.js

@@ -0,0 +1,55 @@
+/*
+ * Copyright 2026, Salesforce, Inc.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { validateSalesforceId } from './soqlUtils.js';
+/**
+ * Prepares a work item for one-off promotion by creating the necessary branches
+ * and pull requests in the source control repository.
+ * API: POST /services/data/v{version}/connect/devops/pipelines/{pipelineId}/promote/oneoff/prepare
+ */
+export async function prepareWorkItem(params) {
+    const { connection, pipelineId, workItemId, sourceStageId, targetStageId } = params;
+    const path = `/services/data/v${connection.getApiVersion()}/connect/devops/pipelines/${pipelineId}/promote/oneoff/prepare`;
+    const body = JSON.stringify({
+        selectedWorkItemId: workItemId,
+        sourceStageId,
+        targetStageId,
+    });
+    const data = await connection.request({
+        method: 'POST',
+        url: path,
+        body,
+        headers: { 'Content-Type': 'application/json' },
+    });
+    return {
+        success: data.success ?? true,
+        requestToken: data.requestToken ?? null,
+        errorCode: data.errorCode ?? null,
+        errorMessage: data.errorMessage ?? null,
+    };
+}
+export async function resolveProjectIdFromWorkItem(connection, workItemId) {
+    validateSalesforceId(workItemId, 'work item');
+    const result = await connection.query(`SELECT DevopsProjectId, DevopsPipelineStageId FROM WorkItem WHERE Id = '${workItemId}' LIMIT 1`);
+    const records = result.records ?? [];
+    if (records.length === 0) {
+        throw new Error(`Work item '${workItemId}' not found. Verify the work item ID and try again.`);
+    }
+    return {
+        projectId: records[0].DevopsProjectId,
+        pipelineStageId: records[0].DevopsPipelineStageId ?? '',
+    };
+}
+//# sourceMappingURL=prepareWorkItem.js.map

package/lib/utils/prepareWorkItem.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prepareWorkItem.js","sourceRoot":"","sources":["../../src/utils/prepareWorkItem.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAGH,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAwBtD;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,MAA6B;IACjE,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,aAAa,EAAE,aAAa,EAAE,GAAG,MAAM,CAAC;IAEpF,MAAM,IAAI,GAAG,mBAAmB,UAAU,CAAC,aAAa,EAAE,6BAA6B,UAAU,yBAAyB,CAAC;IAC3H,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC;QAC1B,kBAAkB,EAAE,UAAU;QAC9B,aAAa;QACb,aAAa;KACd,CAAC,CAAC;IAEH,MAAM,IAAI,GAAG,MAAM,UAAU,CAAC,OAAO,CAAiC;QACpE,MAAM,EAAE,MAAM;QACd,GAAG,EAAE,IAAI;QACT,IAAI;QACJ,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;KAChD,CAAC,CAAC;IAEH,OAAO;QACL,OAAO,EAAE,IAAI,CAAC,OAAO,IAAI,IAAI;QAC7B,YAAY,EAAE,IAAI,CAAC,YAAY,IAAI,IAAI;QACvC,SAAS,EAAE,IAAI,CAAC,SAAS,IAAI,IAAI;QACjC,YAAY,EAAE,IAAI,CAAC,YAAY,IAAI,IAAI;KACxC,CAAC;AACJ,CAAC;AAOD,MAAM,CAAC,KAAK,UAAU,4BAA4B,CAChD,UAAsB,EACtB,UAAkB;IAElB,oBAAoB,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC;IAC9C,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,KAAK,CACnC,2EAA2E,UAAU,WAAW,CACjG,CAAC;IACF,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,IAAI,EAAE,CAAC;IACrC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CAAC,cAAc,UAAU,qDAAqD,CAAC,CAAC;IACjG,CAAC;IACD,OAAO;QACL,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,eAAe;QACrC,eAAe,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,qBAAqB,IAAI,EAAE;KACxD,CAAC;AACJ,CAAC"}

package/lib/utils/promoteStage.d.ts

@@ -0,0 +1,21 @@
+import { Connection } from '@salesforce/core';
+export type PromoteStageParams = {
+    connection: Connection;
+    pipelineId: string;
+    workItemIds: string[];
+    targetStageId: string;
+    fullDeploy?: boolean;
+    testLevel?: string;
+    runTests?: string[];
+};
+export type PromoteStageResult = {
+    requestId: string;
+    status: string;
+    message: string;
+    promotedWorkitemIds: string[];
+};
+/**
+ * Promotes work items to a target pipeline stage via the Connect API.
+ * POST /services/data/v{version}/connect/devops/pipelines/{pipelineId}/promote
+ */
+export declare function promoteStage(params: PromoteStageParams): Promise<PromoteStageResult>;

package/lib/utils/promoteStage.js

@@ -0,0 +1,46 @@
+/*
+ * Copyright 2026, Salesforce, Inc.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * Promotes work items to a target pipeline stage via the Connect API.
+ * POST /services/data/v{version}/connect/devops/pipelines/{pipelineId}/promote
+ */
+export async function promoteStage(params) {
+    const { connection, pipelineId, workItemIds, targetStageId, fullDeploy = false, testLevel = 'Default', runTests, } = params;
+    const path = `/services/data/v${connection.getApiVersion()}/connect/devops/pipelines/${pipelineId}/promote`;
+    const response = await connection.request({
+        method: 'POST',
+        url: path,
+        body: JSON.stringify({
+            workitemIds: workItemIds,
+            targetStageId,
+            allWorkItemsInStage: false,
+            isCheckDeploy: false,
+            deployOptions: {
+                testLevel,
+                isFullDeploy: fullDeploy,
+                runTests: runTests ?? [],
+            },
+        }),
+        headers: { 'Content-Type': 'application/json' },
+    });
+    return {
+        requestId: response.requestId ?? '',
+        status: response.status ?? '',
+        message: response.message ?? '',
+        promotedWorkitemIds: response.promotedWorkitemIds ?? [],
+    };
+}
+//# sourceMappingURL=promoteStage.js.map

package/lib/utils/promoteStage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"promoteStage.js","sourceRoot":"","sources":["../../src/utils/promoteStage.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AA4BH;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,MAA0B;IAC3D,MAAM,EACJ,UAAU,EACV,UAAU,EACV,WAAW,EACX,aAAa,EACb,UAAU,GAAG,KAAK,EAClB,SAAS,GAAG,SAAS,EACrB,QAAQ,GACT,GAAG,MAAM,CAAC;IAEX,MAAM,IAAI,GAAG,mBAAmB,UAAU,CAAC,aAAa,EAAE,6BAA6B,UAAU,UAAU,CAAC;IAE5G,MAAM,QAAQ,GAAG,MAAM,UAAU,CAAC,OAAO,CAAuB;QAC9D,MAAM,EAAE,MAAM;QACd,GAAG,EAAE,IAAI;QACT,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;YACnB,WAAW,EAAE,WAAW;YACxB,aAAa;YACb,mBAAmB,EAAE,KAAK;YAC1B,aAAa,EAAE,KAAK;YACpB,aAAa,EAAE;gBACb,SAAS;gBACT,YAAY,EAAE,UAAU;gBACxB,QAAQ,EAAE,QAAQ,IAAI,EAAE;aACzB;SACF,CAAC;QACF,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;KAChD,CAAC,CAAC;IAEH,OAAO;QACL,SAAS,EAAE,QAAQ,CAAC,SAAS,IAAI,EAAE;QACnC,MAAM,EAAE,QAAQ,CAAC,MAAM,IAAI,EAAE;QAC7B,OAAO,EAAE,QAAQ,CAAC,OAAO,IAAI,EAAE;QAC/B,mBAAmB,EAAE,QAAQ,CAAC,mBAAmB,IAAI,EAAE;KACxD,CAAC;AACJ,CAAC"}