@salesforce/plugin-devops-center 1.2.26 → 1.2.28

package/lib/utils/createProject.d.ts

@@ -0,0 +1,17 @@
+import { Connection } from '@salesforce/core';
+export type CreateProjectParams = {
+    connection: Connection;
+    name: string;
+    description: string;
+};
+export type CreateProjectResult = {
+    success: boolean;
+    projectId?: string;
+    name?: string;
+    description?: string;
+    error?: string;
+};
+/**
+ * Creates a new DevOps Center project via sObject create on DevopsProject.
+ */
+export declare function createProject(params: CreateProjectParams): Promise<CreateProjectResult>;

package/lib/utils/createProject.js

@@ -0,0 +1,39 @@
+/*
+ * 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.
+ */
+/**
+ * Creates a new DevOps Center project via sObject create on DevopsProject.
+ */
+export async function createProject(params) {
+    const { connection, name, description } = params;
+    const result = await connection.sobject('DevopsProject').create({
+        Name: name,
+        Description: description || null,
+    });
+    if (result.success) {
+        return {
+            success: true,
+            projectId: result.id,
+            name,
+            description: description || undefined,
+        };
+    }
+    const errorMessages = result.errors?.map((e) => (typeof e === 'string' ? e : JSON.stringify(e))).join('; ');
+    return {
+        success: false,
+        error: errorMessages ?? 'Unknown error',
+    };
+}
+//# sourceMappingURL=createProject.js.map

package/lib/utils/createProject.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createProject.js","sourceRoot":"","sources":["../../src/utils/createProject.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAkBH;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,MAA2B;IAC7D,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,WAAW,EAAE,GAAG,MAAM,CAAC;IAEjD,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC,MAAM,CAAC;QAC9D,IAAI,EAAE,IAAI;QACV,WAAW,EAAE,WAAW,IAAI,IAAI;KACjC,CAAC,CAAC;IAEH,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACnB,OAAO;YACL,OAAO,EAAE,IAAI;YACb,SAAS,EAAE,MAAM,CAAC,EAAE;YACpB,IAAI;YACJ,WAAW,EAAE,WAAW,IAAI,SAAS;SACtC,CAAC;IACJ,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,KAAK,EAAE,aAAa,IAAI,eAAe;KACxC,CAAC;AACJ,CAAC"}

package/lib/utils/createPullRequest.d.ts

@@ -0,0 +1,49 @@
+import { Connection } from '@salesforce/core';
+export type WorkItemDetail = {
+    workItemId: string;
+    workItemName: string;
+    subject: string;
+    branchName?: string;
+    targetBranch?: string;
+    projectId: string;
+    repoOwner?: string;
+    repoName?: string;
+    provider?: string;
+};
+export type CreatePullRequestParams = {
+    owner: string;
+    repo: string;
+    head: string;
+    base: string;
+    title: string;
+    body?: string;
+    provider: string;
+    token: string;
+};
+export type CreatePullRequestResult = {
+    success: boolean;
+    workItemName?: string;
+    title?: string;
+    url?: string;
+    sourceBranch?: string;
+    targetBranch?: string;
+    error?: string;
+};
+/**
+ * Queries a work item (by Name or Id) and resolves all info needed
+ * to create a pull request: branch, repo, owner, provider, and target branch.
+ */
+export declare function fetchWorkItemDetail(connection: Connection, filter: {
+    name: string;
+} | {
+    id: string;
+}): Promise<WorkItemDetail>;
+/**
+ * Creates a pull request on GitHub or Bitbucket using their REST APIs.
+ */
+export declare function createPullRequest(params: CreatePullRequestParams): Promise<CreatePullRequestResult>;
+/**
+ * Attempts to resolve a VCS authentication token from the environment
+ * or the `gh` CLI (for GitHub).
+ */
+export declare function resolveGitHubToken(): Promise<string | undefined>;

package/lib/utils/createPullRequest.js

@@ -0,0 +1,204 @@
+/*
+ * 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 { getPipelineIdForProject, fetchPipelineStages, computeFirstStageId, findStageById, getBranchNameFromStage, resolveTargetStageId, } from './pipelineUtils.js';
+function normalizeProvider(provider) {
+    if (!provider)
+        return undefined;
+    const normalized = String(provider).toLowerCase();
+    if (normalized === 'bitbucketcloud')
+        return 'bitbucket';
+    return normalized;
+}
+function providerToVcsType(provider) {
+    const normalized = normalizeProvider(provider);
+    if (normalized === 'github')
+        return 'GITHUB';
+    if (normalized === 'bitbucket')
+        return 'BITBUCKET';
+    return undefined;
+}
+function extractOwnerFromVcsPayload(payload) {
+    if (!payload)
+        return undefined;
+    if (typeof payload === 'string')
+        return payload.trim() || undefined;
+    const obj = payload;
+    if (typeof obj.owner === 'string' && obj.owner.trim())
+        return obj.owner.trim();
+    const list = (obj.owners ?? obj.items ?? obj.records);
+    if (Array.isArray(list)) {
+        for (const candidate of list) {
+            if (typeof candidate === 'string' && candidate.trim())
+                return candidate.trim();
+            if (candidate && typeof candidate === 'object') {
+                const ownerVal = candidate.owner;
+                if (typeof ownerVal === 'string' && ownerVal.trim())
+                    return ownerVal.trim();
+            }
+        }
+    }
+    return undefined;
+}
+async function fetchOwnerByVcsType(connection, vcsType) {
+    const path = `/services/data/v${connection.getApiVersion()}/connect/devops/vcs/${vcsType}`;
+    const response = await connection.request({ method: 'GET', url: path });
+    return extractOwnerFromVcsPayload(response);
+}
+/**
+ * Queries a work item (by Name or Id) and resolves all info needed
+ * to create a pull request: branch, repo, owner, provider, and target branch.
+ */
+export async function fetchWorkItemDetail(connection, filter) {
+    const whereClause = 'name' in filter ? `Name = '${filter.name}'` : `Id = '${filter.id}'`;
+    const identifier = 'name' in filter ? filter.name : filter.id;
+    const result = await connection.query(`SELECT Id, Name, Subject, DevopsProjectId, DevopsPipelineStageId,
+            SourceCodeRepositoryBranch.Name,
+            SourceCodeRepositoryBranch.SourceCodeRepository.Name,
+            SourceCodeRepositoryBranch.SourceCodeRepository.RepositoryOwner,
+            SourceCodeRepositoryBranch.SourceCodeRepository.Provider
+     FROM WorkItem
+     WHERE ${whereClause}
+     LIMIT 1`);
+    const record = (result.records ?? [])[0];
+    if (!record) {
+        throw new Error(`Work item '${identifier}' not found.`);
+    }
+    const provider = normalizeProvider(record.SourceCodeRepositoryBranch?.SourceCodeRepository?.Provider);
+    let repoOwner = record.SourceCodeRepositoryBranch?.SourceCodeRepository?.RepositoryOwner ?? undefined;
+    const vcsType = providerToVcsType(provider);
+    if (vcsType && !repoOwner) {
+        try {
+            repoOwner = (await fetchOwnerByVcsType(connection, vcsType)) ?? undefined;
+        }
+        catch {
+            // owner lookup is best-effort
+        }
+    }
+    const detail = {
+        workItemId: record.Id,
+        workItemName: record.Name,
+        subject: record.Subject ?? '',
+        branchName: record.SourceCodeRepositoryBranch?.Name ?? undefined,
+        projectId: record.DevopsProjectId,
+        repoOwner,
+        repoName: record.SourceCodeRepositoryBranch?.SourceCodeRepository?.Name ?? undefined,
+        provider,
+    };
+    const pipelineId = await getPipelineIdForProject(connection, record.DevopsProjectId);
+    if (pipelineId) {
+        const stages = await fetchPipelineStages(connection, pipelineId);
+        if (stages.length) {
+            let targetStageId = resolveTargetStageId(record.DevopsPipelineStageId ?? undefined, stages);
+            if (!targetStageId) {
+                targetStageId = computeFirstStageId(stages);
+            }
+            detail.targetBranch = getBranchNameFromStage(findStageById(stages, targetStageId));
+        }
+    }
+    return detail;
+}
+/**
+ * Creates a pull request on GitHub or Bitbucket using their REST APIs.
+ */
+export async function createPullRequest(params) {
+    const { owner, repo, head, base, title, body, provider, token } = params;
+    if (provider === 'github') {
+        return createGitHubPullRequest({ owner, repo, head, base, title, body, token });
+    }
+    else if (provider === 'bitbucket') {
+        return createBitbucketPullRequest({ owner, repo, head, base, title, body, token });
+    }
+    throw new Error(`Unsupported VCS provider: ${provider ?? 'unknown'}. Supported providers are GitHub and Bitbucket.`);
+}
+async function createGitHubPullRequest(params) {
+    const { owner, repo, head, base, title, body, token } = params;
+    const url = `https://api.github.com/repos/${owner}/${repo}/pulls`;
+    const response = await fetch(url, {
+        method: 'POST',
+        headers: {
+            Authorization: `Bearer ${token}`,
+            Accept: 'application/vnd.github+json',
+            'Content-Type': 'application/json',
+            'X-GitHub-Api-Version': '2022-11-28',
+        },
+        body: JSON.stringify({ title, body: body ?? '', head, base }),
+    });
+    const data = (await response.json());
+    if (!response.ok) {
+        const errors = Array.isArray(data.errors)
+            ? data.errors.map((e) => e.message ?? JSON.stringify(e)).join('; ')
+            : undefined;
+        const msg = data.message ?? `HTTP ${response.status}`;
+        throw new Error(errors ? `${msg}: ${errors}` : msg);
+    }
+    return {
+        success: true,
+        title: data.title,
+        url: data.html_url,
+        sourceBranch: head,
+        targetBranch: base,
+    };
+}
+async function createBitbucketPullRequest(params) {
+    const { owner, repo, head, base, title, body, token } = params;
+    const url = `https://api.bitbucket.org/2.0/repositories/${owner}/${repo}/pullrequests`;
+    const response = await fetch(url, {
+        method: 'POST',
+        headers: {
+            Authorization: `Bearer ${token}`,
+            'Content-Type': 'application/json',
+        },
+        body: JSON.stringify({
+            title,
+            description: body ?? '',
+            source: { branch: { name: head } },
+            destination: { branch: { name: base } },
+        }),
+    });
+    const data = (await response.json());
+    if (!response.ok) {
+        const errorMsg = data.error?.message ?? data.message ?? `HTTP ${response.status}`;
+        throw new Error(String(errorMsg));
+    }
+    const links = data.links;
+    return {
+        success: true,
+        title: data.title,
+        url: links?.html?.href ?? data.url ?? '',
+        sourceBranch: head,
+        targetBranch: base,
+    };
+}
+/**
+ * Attempts to resolve a VCS authentication token from the environment
+ * or the `gh` CLI (for GitHub).
+ */
+export async function resolveGitHubToken() {
+    const envToken = process.env.GITHUB_TOKEN ?? process.env.GH_TOKEN;
+    if (envToken)
+        return envToken;
+    try {
+        const { execSync } = await import('node:child_process');
+        const token = execSync('gh auth token', { encoding: 'utf-8', stdio: ['pipe', 'pipe', 'pipe'] }).trim();
+        if (token)
+            return token;
+    }
+    catch {
+        // gh CLI not installed or not authenticated
+    }
+    return undefined;
+}
+//# sourceMappingURL=createPullRequest.js.map

package/lib/utils/createPullRequest.js.map

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

package/lib/utils/createWorkItem.d.ts

@@ -0,0 +1,19 @@
+import { Connection } from '@salesforce/core';
+export type CreateWorkItemParams = {
+    connection: Connection;
+    projectId: string;
+    subject: string;
+    description: string;
+};
+export type CreateWorkItemResult = {
+    success: boolean;
+    workItemId?: string;
+    workItemName?: string;
+    subject?: string;
+    error?: string;
+};
+/**
+ * Creates a new DevOps Center Work Item in the specified project.
+ * API: POST /services/data/v65.0/connect/devops/projects/<ProjectID>/workitem
+ */
+export declare function createWorkItem(params: CreateWorkItemParams): Promise<CreateWorkItemResult>;

package/lib/utils/createWorkItem.js

@@ -0,0 +1,58 @@
+/*
+ * 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.
+ */
+/**
+ * Creates a new DevOps Center Work Item in the specified project.
+ * API: POST /services/data/v65.0/connect/devops/projects/<ProjectID>/workitem
+ */
+export async function createWorkItem(params) {
+    const { connection, projectId, subject, description } = params;
+    const path = `/services/data/v${connection.getApiVersion()}/connect/devops/projects/${projectId}/workitem`;
+    const body = JSON.stringify({ subject, description: description ?? '' });
+    try {
+        const response = await connection.request({
+            method: 'POST',
+            url: path,
+            body,
+            headers: { 'Content-Type': 'application/json' },
+        });
+        const data = response ?? {};
+        return {
+            success: true,
+            workItemId: (data.id ?? data.Id),
+            workItemName: (data.name ?? data.Name),
+            subject: (data.subject ?? data.Subject ?? subject),
+        };
+    }
+    catch (error) {
+        const err = error;
+        const data = (err.response?.data ?? err.body ?? err);
+        const message = (typeof data === 'object' &&
+            data !== null &&
+            (data.message ??
+                data.error ??
+                data.errorDescription)) ||
+            err.message ||
+            'Unknown error';
+        const details = typeof data === 'object' && data !== null && Array.isArray(data.body)
+            ? data.body.join('; ')
+            : undefined;
+        return {
+            success: false,
+            error: details ? `${String(message)}: ${details}` : String(message),
+        };
+    }
+}
+//# sourceMappingURL=createWorkItem.js.map

package/lib/utils/createWorkItem.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createWorkItem.js","sourceRoot":"","sources":["../../src/utils/createWorkItem.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAmBH;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,MAA4B;IAC/D,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,OAAO,EAAE,WAAW,EAAE,GAAG,MAAM,CAAC;IAE/D,MAAM,IAAI,GAAG,mBAAmB,UAAU,CAAC,aAAa,EAAE,4BAA4B,SAAS,WAAW,CAAC;IAC3G,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,WAAW,EAAE,WAAW,IAAI,EAAE,EAAE,CAAC,CAAC;IAEzE,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,UAAU,CAAC,OAAO,CAAC;YACxC,MAAM,EAAE,MAAM;YACd,GAAG,EAAE,IAAI;YACT,IAAI;YACJ,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;SAChD,CAAC,CAAC;QACH,MAAM,IAAI,GAAI,QAAoC,IAAI,EAAE,CAAC;QACzD,OAAO;YACL,OAAO,EAAE,IAAI;YACb,UAAU,EAAE,CAAC,IAAI,CAAC,EAAE,IAAI,IAAI,CAAC,EAAE,CAAuB;YACtD,YAAY,EAAE,CAAC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,CAAuB;YAC5D,OAAO,EAAE,CAAC,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,OAAO,IAAI,OAAO,CAAW;SAC7D,CAAC;IACJ,CAAC;IAAC,OAAO,KAAc,EAAE,CAAC;QACxB,MAAM,GAAG,GAAG,KAAuG,CAAC;QACpH,MAAM,IAAI,GAAY,CAAC,GAAG,CAAC,QAAQ,EAAE,IAAI,IAAI,GAAG,CAAC,IAAI,IAAI,GAAG,CAAY,CAAC;QACzE,MAAM,OAAO,GACX,CAAC,OAAO,IAAI,KAAK,QAAQ;YACvB,IAAI,KAAK,IAAI;YACb,CAAE,IAAgC,CAAC,OAAO;gBACvC,IAAgC,CAAC,KAAK;gBACtC,IAAgC,CAAC,gBAAgB,CAAC,CAAC;YACxD,GAAG,CAAC,OAAO;YACX,eAAe,CAAC;QAClB,MAAM,OAAO,GACX,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAE,IAAgC,CAAC,IAAI,CAAC;YAChG,CAAC,CAAG,IAAkC,CAAC,IAAiB,CAAC,IAAI,CAAC,IAAI,CAAC;YACnE,CAAC,CAAC,SAAS,CAAC;QAChB,OAAO;YACL,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,OAAO,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC;SACpE,CAAC;IACJ,CAAC;AACH,CAAC"}

package/lib/utils/pipelineUtils.d.ts

@@ -0,0 +1,8 @@
+import { Connection } from '@salesforce/core';
+import { PipelineStageRecord } from './types.js';
+export declare function getPipelineIdForProject(connection: Connection, projectId: string): Promise<string | undefined>;
+export declare function fetchPipelineStages(connection: Connection, pipelineId: string): Promise<PipelineStageRecord[]>;
+export declare function computeFirstStageId(stages: PipelineStageRecord[]): string | undefined;
+export declare function resolveTargetStageId(currentStageId: string | undefined, stages: PipelineStageRecord[]): string | undefined;
+export declare function findStageById(stages: PipelineStageRecord[], stageId: string | undefined): PipelineStageRecord | undefined;
+export declare function getBranchNameFromStage(stage: PipelineStageRecord | undefined): string | undefined;

package/lib/utils/pipelineUtils.js

@@ -0,0 +1,51 @@
+/*
+ * 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 getPipelineIdForProject(connection, projectId) {
+    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) {
+    const stageQuery = `SELECT Id, Name, NextStageId, SourceCodeRepositoryBranch.Name FROM DevopsPipelineStage WHERE DevopsPipelineId = '${pipelineId}'`;
+    const stageResult = await connection.query(stageQuery);
+    return stageResult.records ?? [];
+}
+export function computeFirstStageId(stages) {
+    const allStageIds = new Set(stages.map((s) => s.Id));
+    const nextStageIds = new Set(stages.map((s) => s.NextStageId).filter(Boolean));
+    const firstStageIds = Array.from(allStageIds).filter((id) => !nextStageIds.has(id));
+    if (firstStageIds.length !== 1)
+        return undefined;
+    return firstStageIds[0];
+}
+export function resolveTargetStageId(currentStageId, stages) {
+    if (!stages.length)
+        return undefined;
+    if (currentStageId) {
+        const current = stages.find((s) => s.Id === currentStageId);
+        return current?.NextStageId ?? undefined;
+    }
+    return undefined;
+}
+export function findStageById(stages, stageId) {
+    if (!stageId)
+        return undefined;
+    return stages.find((s) => s.Id === stageId);
+}
+export function getBranchNameFromStage(stage) {
+    return stage?.SourceCodeRepositoryBranch?.Name ?? undefined;
+}
+//# sourceMappingURL=pipelineUtils.js.map

package/lib/utils/pipelineUtils.js.map

@@ -0,0 +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"}

package/lib/utils/types.d.ts

@@ -0,0 +1,57 @@
+export type WorkItem = {
+    id: string;
+    name: string;
+    subject?: string;
+    description?: string;
+    status: string;
+    owner: string;
+    DevopsProjectId: string;
+    PipelineId?: string;
+    PipelineStageId?: string;
+    SourceCodeRepository?: {
+        repoUrl: string;
+        repoType: string;
+    };
+    WorkItemBranch?: string;
+    TargetStageId?: string;
+    TargetBranch?: string;
+};
+export type PipelineStageRecord = {
+    Id: string;
+    Name?: string;
+    NextStageId?: string | null;
+    SourceCodeRepositoryBranch?: {
+        Name?: string;
+    } | null;
+};
+export type ProjectStagesContext = {
+    pipelineId: string;
+    stages: PipelineStageRecord[];
+    firstStageId: string | undefined;
+};
+export type VcsType = 'GITHUB' | 'BITBUCKET';
+export type SourceCodeRepositoryQueryRecord = {
+    Name: string | null;
+    RepositoryOwner: string | null;
+    Provider: string | null;
+};
+export type SourceCodeRepositoryBranchQueryRecord = {
+    Name: string | null;
+    SourceCodeRepositoryId: string | null;
+    SourceCodeRepository: SourceCodeRepositoryQueryRecord | null;
+};
+export type WorkItemQueryRecord = {
+    Id: string;
+    Name: string;
+    Subject: string | null;
+    Description: string | null;
+    Status: string;
+    AssignedToId: string | null;
+    SourceCodeRepositoryBranchId: string | null;
+    SourceCodeRepositoryBranch: SourceCodeRepositoryBranchQueryRecord | null;
+    DevopsPipelineStageId: string | null;
+    DevopsProjectId: string;
+};
+export type DevopsProjectPipelineQueryRecord = {
+    DevopsPipelineId: string;
+};

package/lib/utils/types.js

@@ -0,0 +1,17 @@
+/*
+ * 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 {};
+//# sourceMappingURL=types.js.map

package/lib/utils/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/utils/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG"}

package/lib/utils/updateWorkItemStatus.d.ts

@@ -0,0 +1,34 @@
+import { Connection } from '@salesforce/core';
+export type WorkItemContext = {
+    workItemId: string;
+    projectId: string;
+};
+export type UpdateWorkItemStatusParams = {
+    connection: Connection;
+    workItemId: string;
+    projectId: string;
+    status: string;
+};
+export type UpdateWorkItemStatusResult = {
+    success: boolean;
+    workItemId: string;
+    workItemName?: string;
+    status?: string;
+    error?: string;
+};
+/**
+ * Resolves a work item's Salesforce ID and project ID from its Name (e.g. WI-000001) via SOQL.
+ */
+export declare function resolveWorkItemByName(connection: Connection, workItemName: string): Promise<WorkItemContext>;
+/**
+ * Fetches the project ID for a given work item ID via SOQL.
+ */
+export declare function resolveProjectIdForWorkItem(connection: Connection, workItemId: string): Promise<string>;
+export declare const ALLOWED_STATUSES: readonly ["In Progress", "Ready to Promote"];
+export type AllowedStatus = (typeof ALLOWED_STATUSES)[number];
+export declare function toApiStatus(status: string): string;
+/**
+ * Updates the status of a DevOps Center work item via the Connect API.
+ * API: PATCH /services/data/v{version}/connect/devops/projects/{projectId}/workitem/{workItemId}
+ */
+export declare function updateWorkItemStatus(params: UpdateWorkItemStatusParams): Promise<UpdateWorkItemStatusResult>;

package/lib/utils/updateWorkItemStatus.js

@@ -0,0 +1,71 @@
+/*
+ * 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.
+ */
+/**
+ * Resolves a work item's Salesforce ID and project ID from its Name (e.g. WI-000001) via SOQL.
+ */
+export async function resolveWorkItemByName(connection, workItemName) {
+    const result = await connection.query(`SELECT Id, DevopsProjectId FROM WorkItem WHERE Name = '${workItemName}' LIMIT 1`);
+    const record = (result.records ?? [])[0];
+    if (!record) {
+        throw new Error(`Work item with name '${workItemName}' not found.`);
+    }
+    return { workItemId: record.Id, projectId: record.DevopsProjectId };
+}
+/**
+ * Fetches the project ID for a given work item ID via SOQL.
+ */
+export async function resolveProjectIdForWorkItem(connection, workItemId) {
+    const result = await connection.query(`SELECT DevopsProjectId FROM WorkItem WHERE Id = '${workItemId}' LIMIT 1`);
+    const record = (result.records ?? [])[0];
+    if (!record) {
+        throw new Error(`Work item with ID '${workItemId}' not found.`);
+    }
+    return record.DevopsProjectId;
+}
+export const ALLOWED_STATUSES = ['In Progress', 'Ready to Promote'];
+const STATUS_LABEL_TO_API = {
+    'in progress': 'IN_PROGRESS',
+    'ready to promote': 'READY_TO_PROMOTE',
+};
+export function toApiStatus(status) {
+    const apiStatus = STATUS_LABEL_TO_API[status.toLowerCase()];
+    if (!apiStatus) {
+        throw new Error(`Invalid status "${status}". Allowed values: ${ALLOWED_STATUSES.join(', ')}`);
+    }
+    return apiStatus;
+}
+/**
+ * Updates the status of a DevOps Center work item via the Connect API.
+ * API: PATCH /services/data/v{version}/connect/devops/projects/{projectId}/workitem/{workItemId}
+ */
+export async function updateWorkItemStatus(params) {
+    const { connection, workItemId, projectId, status } = params;
+    const path = `/services/data/v${connection.getApiVersion()}/connect/devops/projects/${projectId}/workitem/${workItemId}`;
+    const body = JSON.stringify({ status: toApiStatus(status) });
+    const response = await connection.request({
+        method: 'PATCH',
+        url: path,
+        body,
+        headers: { 'Content-Type': 'application/json' },
+    });
+    const data = response ?? {};
+    return {
+        success: true,
+        workItemId,
+        status: (data.status ?? data.Status ?? status),
+    };
+}
+//# sourceMappingURL=updateWorkItemStatus.js.map