@salesforce/plugin-devops-center 1.2.27 → 1.3.0

package/lib/utils/addPipelineStage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"addPipelineStage.js","sourceRoot":"","sources":["../../src/utils/addPipelineStage.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AA0BH;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,MAA8B;IACnE,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,IAAI,EAAE,WAAW,EAAE,GAAG,MAAM,CAAC;IAE7D,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,OAAO,CAAC,qBAAqB,CAAC,CAAC,MAAM,CAAC;QACpE,IAAI,EAAE,IAAI;QACV,gBAAgB,EAAE,UAAU;QAC5B,WAAW,EAAE,WAAW;KACzB,CAAC,CAAC;IAEH,MAAM,YAAY,GAAG,MAAwC,CAAC;IAE9D,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;YACL,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,QAAQ;SAChB,CAAC;IACJ,CAAC;IAED,OAAO;QACL,OAAO,EAAE,IAAI;QACb,OAAO,EAAE,YAAY,CAAC,EAAE;QACxB,IAAI;QACJ,WAAW;QACX,UAAU;KACX,CAAC;AACJ,CAAC"}

package/lib/utils/addStageBranch.d.ts

@@ -0,0 +1,22 @@
+import { Connection } from '@salesforce/core';
+export type AddStageBranchParams = {
+    connection: Connection;
+    pipelineId: string;
+    stageId: string;
+    branchName: string;
+    createVcsBranch: boolean;
+};
+export type AddStageBranchResult = {
+    success: boolean;
+    stageId: string;
+    branchName?: string;
+    branchCreated?: boolean;
+    repoBranchId?: string;
+    pipelineId?: string;
+    error?: string;
+};
+/**
+ * Associates a branch with a pipeline stage via the Connect API.
+ * PATCH /services/data/v{version}/connect/devops/pipelines/{pipelineId}/stages/{stageId}
+ */
+export declare function addStageBranch(params: AddStageBranchParams): Promise<AddStageBranchResult>;

package/lib/utils/addStageBranch.js

@@ -0,0 +1,48 @@
+/*
+ * 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.
+ */
+/**
+ * Associates a branch with a pipeline stage via the Connect API.
+ * PATCH /services/data/v{version}/connect/devops/pipelines/{pipelineId}/stages/{stageId}
+ */
+export async function addStageBranch(params) {
+    const { connection, pipelineId, stageId, branchName, createVcsBranch } = params;
+    const path = `/services/data/v${connection.getApiVersion()}/connect/devops/pipelines/${pipelineId}/stages/${stageId}`;
+    const data = await connection.request({
+        method: 'PATCH',
+        url: path,
+        body: JSON.stringify({
+            vcsBranch: branchName,
+            createVcsBranch: String(createVcsBranch),
+        }),
+        headers: { 'Content-Type': 'application/json' },
+    });
+    if (data.status === 'FAILED') {
+        return {
+            success: false,
+            stageId,
+            error: data.message ?? 'Failed to associate branch with stage',
+        };
+    }
+    return {
+        success: true,
+        stageId,
+        branchName,
+        branchCreated: createVcsBranch,
+        repoBranchId: data.repoBranchId,
+        pipelineId,
+    };
+}
+//# sourceMappingURL=addStageBranch.js.map

package/lib/utils/addStageBranch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"addStageBranch.js","sourceRoot":"","sources":["../../src/utils/addStageBranch.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AA6BH;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,MAA4B;IAC/D,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,GAAG,MAAM,CAAC;IAEhF,MAAM,IAAI,GAAG,mBAAmB,UAAU,CAAC,aAAa,EAAE,6BAA6B,UAAU,WAAW,OAAO,EAAE,CAAC;IAEtH,MAAM,IAAI,GAAG,MAAM,UAAU,CAAC,OAAO,CAA6B;QAChE,MAAM,EAAE,OAAO;QACf,GAAG,EAAE,IAAI;QACT,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;YACnB,SAAS,EAAE,UAAU;YACrB,eAAe,EAAE,MAAM,CAAC,eAAe,CAAC;SACzC,CAAC;QACF,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;KAChD,CAAC,CAAC;IAEH,IAAI,IAAI,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC7B,OAAO;YACL,OAAO,EAAE,KAAK;YACd,OAAO;YACP,KAAK,EAAE,IAAI,CAAC,OAAO,IAAI,uCAAuC;SAC/D,CAAC;IACJ,CAAC;IAED,OAAO;QACL,OAAO,EAAE,IAAI;QACb,OAAO;QACP,UAAU;QACV,aAAa,EAAE,eAAe;QAC9B,YAAY,EAAE,IAAI,CAAC,YAAY;QAC/B,UAAU;KACX,CAAC;AACJ,CAAC"}

package/lib/utils/addStageEnvironment.d.ts

@@ -0,0 +1,92 @@
+import { Connection } from '@salesforce/core';
+export type OrgType = 'Production' | 'Sandbox';
+export declare const POLL_INTERVAL_MS = 3000;
+export declare const POLL_TIMEOUT_MS: number;
+export type AddStageEnvironmentParams = {
+    connection: Connection;
+    pipelineId: string;
+    stageId: string;
+    environmentName: string;
+    orgType: OrgType;
+};
+export type AddStageEnvironmentResult = {
+    success: boolean;
+    stageId: string;
+    environmentId?: string;
+    environmentName?: string;
+    orgType?: OrgType;
+    pipelineId?: string;
+    redirectUrl?: string;
+    namedCredential?: string;
+    organizationId?: string;
+    error?: string;
+};
+type EnvironmentCreateResponse = {
+    id: string;
+    name: string;
+    redirectUrl: string;
+    namedCredential: string;
+    externalCredential: string;
+    pipelineId?: string;
+};
+export type EnvironmentGetResponse = {
+    id: string;
+    name: string;
+    organizationId?: string;
+    orgType?: string;
+    namedCredential?: string;
+    redirectUrl?: string;
+};
+type EnvironmentValidateResponse = {
+    id: string;
+    name: string;
+    organizationId?: string;
+    orgType?: string;
+    namedCredential?: string;
+};
+/**
+ * Creates an environment and associates it with a pipeline stage via the Connect API.
+ * POST /services/data/v{version}/connect/devops/environment
+ */
+export declare function createEnvironment(connection: Connection, params: {
+    pipelineId: string;
+    stageId: string;
+    environmentName: string;
+    orgType: OrgType;
+}): Promise<EnvironmentCreateResponse>;
+/**
+ * Fetches the current state of an environment.
+ * GET /services/data/v{version}/connect/devops/environment/{environmentId}
+ */
+export declare function getEnvironment(connection: Connection, environmentId: string): Promise<EnvironmentGetResponse>;
+/**
+ * Validates an authenticated environment by triggering server-side org extraction.
+ * PATCH /services/data/v{version}/connect/devops/environment/{environmentId}
+ */
+export declare function validateEnvironment(connection: Connection, environmentId: string): Promise<EnvironmentValidateResponse>;
+/**
+ * Polls until authentication is complete by attempting PATCH validation.
+ * The PATCH call triggers server-side org extraction; if the user has
+ * completed OAuth, it returns a response with organizationId populated.
+ * If auth isn't done yet, the PATCH throws — we catch and retry.
+ * Falls back to GET polling as a secondary check.
+ * Throws on timeout.
+ */
+export declare function pollForAuthentication(connection: Connection, environmentId: string, timeoutMs?: number, intervalMs?: number): Promise<EnvironmentValidateResponse>;
+/**
+ * Full orchestration: create environment -> poll for auth -> validate.
+ * Returns the final result including organizationId.
+ *
+ * The caller is responsible for opening the browser at the returned redirectUrl
+ * and displaying progress to the user. Use `onCreated` to receive the redirect URL
+ * before polling begins.
+ */
+export declare function addStageEnvironment(params: AddStageEnvironmentParams & {
+    onCreated?: (data: {
+        environmentId: string;
+        redirectUrl: string;
+    }) => void;
+    pollTimeoutMs?: number;
+    pollIntervalMs?: number;
+}): Promise<AddStageEnvironmentResult>;
+export {};

package/lib/utils/addStageEnvironment.js

@@ -0,0 +1,120 @@
+/*
+ * 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.
+ */
+const ORG_TYPE_API_MAP = {
+    Production: 'PRODUCTION',
+    Sandbox: 'SANDBOX',
+};
+export const POLL_INTERVAL_MS = 3000;
+export const POLL_TIMEOUT_MS = 5 * 60 * 1000;
+/**
+ * Creates an environment and associates it with a pipeline stage via the Connect API.
+ * POST /services/data/v{version}/connect/devops/environment
+ */
+export async function createEnvironment(connection, params) {
+    const path = `/services/data/v${connection.getApiVersion()}/connect/devops/environment`;
+    return connection.request({
+        method: 'POST',
+        url: path,
+        body: JSON.stringify({
+            envName: params.environmentName,
+            orgType: ORG_TYPE_API_MAP[params.orgType],
+            pipelineStageId: params.stageId,
+            pipelineId: params.pipelineId,
+        }),
+        headers: { 'Content-Type': 'application/json' },
+    });
+}
+/**
+ * Fetches the current state of an environment.
+ * GET /services/data/v{version}/connect/devops/environment/{environmentId}
+ */
+export async function getEnvironment(connection, environmentId) {
+    const path = `/services/data/v${connection.getApiVersion()}/connect/devops/environment/${environmentId}`;
+    return connection.request({ method: 'GET', url: path });
+}
+/**
+ * Validates an authenticated environment by triggering server-side org extraction.
+ * PATCH /services/data/v{version}/connect/devops/environment/{environmentId}
+ */
+export async function validateEnvironment(connection, environmentId) {
+    const path = `/services/data/v${connection.getApiVersion()}/connect/devops/environment/${environmentId}`;
+    return connection.request({
+        method: 'PATCH',
+        url: path,
+        body: JSON.stringify({}),
+        headers: { 'Content-Type': 'application/json' },
+    });
+}
+function sleep(ms) {
+    return new Promise((resolve) => {
+        setTimeout(resolve, ms);
+    });
+}
+/**
+ * Polls until authentication is complete by attempting PATCH validation.
+ * The PATCH call triggers server-side org extraction; if the user has
+ * completed OAuth, it returns a response with organizationId populated.
+ * If auth isn't done yet, the PATCH throws — we catch and retry.
+ * Falls back to GET polling as a secondary check.
+ * Throws on timeout.
+ */
+// eslint-disable-next-line no-await-in-loop -- polling requires sequential awaits by design
+export async function pollForAuthentication(connection, environmentId, timeoutMs = POLL_TIMEOUT_MS, intervalMs = POLL_INTERVAL_MS) {
+    const deadline = Date.now() + timeoutMs;
+    while (Date.now() < deadline) {
+        try {
+            // eslint-disable-next-line no-await-in-loop
+            const validated = await validateEnvironment(connection, environmentId);
+            if (validated.organizationId) {
+                return validated;
+            }
+        }
+        catch {
+            // PATCH failed — auth likely not yet complete, continue polling
+        }
+        // eslint-disable-next-line no-await-in-loop
+        await sleep(intervalMs);
+    }
+    throw new Error(`Authentication timed out after ${timeoutMs / 1000} seconds. Re-run the command or authenticate manually.`);
+}
+/**
+ * Full orchestration: create environment -> poll for auth -> validate.
+ * Returns the final result including organizationId.
+ *
+ * The caller is responsible for opening the browser at the returned redirectUrl
+ * and displaying progress to the user. Use `onCreated` to receive the redirect URL
+ * before polling begins.
+ */
+export async function addStageEnvironment(params) {
+    const { connection, pipelineId, stageId, environmentName, orgType, onCreated, pollTimeoutMs, pollIntervalMs } = params;
+    const createData = await createEnvironment(connection, { pipelineId, stageId, environmentName, orgType });
+    if (onCreated) {
+        onCreated({ environmentId: createData.id, redirectUrl: createData.redirectUrl });
+    }
+    const validated = await pollForAuthentication(connection, createData.id, pollTimeoutMs, pollIntervalMs);
+    return {
+        success: true,
+        stageId,
+        environmentId: createData.id,
+        environmentName: createData.name,
+        orgType,
+        pipelineId,
+        redirectUrl: createData.redirectUrl,
+        namedCredential: createData.namedCredential ?? validated.namedCredential,
+        organizationId: validated.organizationId,
+    };
+}
+//# sourceMappingURL=addStageEnvironment.js.map

package/lib/utils/addStageEnvironment.js.map

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

package/lib/utils/attachProject.d.ts

@@ -0,0 +1,21 @@
+import { Connection } from '@salesforce/core';
+export type AttachProjectParams = {
+    connection: Connection;
+    projectId: string;
+    pipelineId: string;
+};
+export type AttachProjectResult = {
+    success: boolean;
+    projectId: string;
+    pipelineId: string;
+    error?: string;
+};
+/**
+ * Checks if a project is already attached to a pipeline.
+ * Returns the existing pipeline ID if found, undefined otherwise.
+ */
+export declare function findExistingAttachment(connection: Connection, projectId: string): Promise<string | undefined>;
+/**
+ * Attaches a DevOps Center project to a pipeline by creating a DevopsProjectPipeline junction record.
+ */
+export declare function attachProject(params: AttachProjectParams): Promise<AttachProjectResult>;

package/lib/utils/attachProject.js

@@ -0,0 +1,44 @@
+/*
+ * 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.
+ */
+/**
+ * Checks if a project is already attached to a pipeline.
+ * Returns the existing pipeline ID if found, undefined otherwise.
+ */
+export async function findExistingAttachment(connection, projectId) {
+    const result = await connection.query(`SELECT DevopsPipelineId FROM DevopsProjectPipeline WHERE DevopsProjectId = '${projectId}' LIMIT 1`);
+    return (result.records ?? [])[0]?.DevopsPipelineId;
+}
+/**
+ * Attaches a DevOps Center project to a pipeline by creating a DevopsProjectPipeline junction record.
+ */
+export async function attachProject(params) {
+    const { connection, projectId, pipelineId } = params;
+    const result = await connection.sobject('DevopsProjectPipeline').create({
+        DevopsProjectId: projectId,
+        DevopsPipelineId: pipelineId,
+    });
+    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=attachProject.js.map

package/lib/utils/attachProject.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"attachProject.js","sourceRoot":"","sources":["../../src/utils/attachProject.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAiBH;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,UAAsB,EAAE,SAAiB;IACpF,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,KAAK,CACnC,+EAA+E,SAAS,WAAW,CACpG,CAAC;IACF,OAAO,CAAC,MAAM,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,gBAAgB,CAAC;AACrD,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,MAA2B;IAC7D,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,UAAU,EAAE,GAAG,MAAM,CAAC;IAErD,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,OAAO,CAAC,uBAAuB,CAAC,CAAC,MAAM,CAAC;QACtE,eAAe,EAAE,SAAS;QAC1B,gBAAgB,EAAE,UAAU;KAC7B,CAAC,CAAC;IAEH,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/createPipeline.d.ts

@@ -0,0 +1,34 @@
+import { Connection } from '@salesforce/core';
+export type RepoInfo = {
+    repoUrl: string;
+    repoType: string;
+    created: boolean;
+};
+export type CreatePipelineParams = {
+    connection: Connection;
+    name: string;
+    description?: string;
+    repo: string;
+    repoType: string;
+    createRepo?: boolean;
+    repoOwner?: string;
+    bitbucketProject?: string;
+};
+export type CreatePipelineResult = {
+    success: boolean;
+    pipelineId?: string;
+    name?: string;
+    description?: string;
+    status?: string;
+    repository?: RepoInfo;
+    error?: string;
+};
+/**
+ * Detects repo type from a URL. Returns 'github' or 'bitbucket', or undefined.
+ */
+export declare function detectRepoType(repoUrl: string): string | undefined;
+/**
+ * Creates a new DevOps Center pipeline via the Connect API.
+ * POST /services/data/v{version}/connect/devops/pipelines
+ */
+export declare function createPipeline(params: CreatePipelineParams): Promise<CreatePipelineResult>;

package/lib/utils/createPipeline.js

@@ -0,0 +1,77 @@
+/*
+ * 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.
+ */
+const DEFAULT_STAGES = [{ name: 'Integration' }, { name: 'UAT' }, { name: 'Staging' }, { name: 'Production' }];
+/**
+ * Detects repo type from a URL. Returns 'github' or 'bitbucket', or undefined.
+ */
+export function detectRepoType(repoUrl) {
+    const lower = repoUrl.toLowerCase();
+    if (lower.includes('github.com'))
+        return 'github';
+    if (lower.includes('bitbucket.org'))
+        return 'bitbucket';
+    return undefined;
+}
+/**
+ * Creates a new DevOps Center pipeline via the Connect API.
+ * POST /services/data/v{version}/connect/devops/pipelines
+ */
+export async function createPipeline(params) {
+    const { connection, name, description, repo, repoType, createRepo, repoOwner, bitbucketProject } = params;
+    const path = `/services/data/v${connection.getApiVersion()}/connect/devops/pipelines`;
+    const payload = {
+        name,
+        vcsType: repoType,
+        stages: DEFAULT_STAGES,
+    };
+    if (createRepo) {
+        payload.createVcsRepo = true;
+        payload.vcsRepoName = repo;
+        payload.vcsRepoOwner = repoOwner;
+        if (repoType === 'bitbucket' && repoOwner) {
+            const providerInfo = { bitbucketWorkspace: repoOwner };
+            if (bitbucketProject) {
+                providerInfo.bitbucketProject = bitbucketProject;
+            }
+            payload.repoProviderInfo = JSON.stringify(providerInfo);
+        }
+    }
+    else {
+        payload.vcsRepoUrl = repo;
+    }
+    if (description) {
+        payload.description = description;
+    }
+    const data = await connection.request({
+        method: 'POST',
+        url: path,
+        body: JSON.stringify(payload),
+        headers: { 'Content-Type': 'application/json' },
+    });
+    return {
+        success: true,
+        pipelineId: data.id,
+        name,
+        description,
+        status: data.status ?? 'Inactive',
+        repository: {
+            repoUrl: repo,
+            repoType,
+            created: createRepo ?? false,
+        },
+    };
+}
+//# sourceMappingURL=createPipeline.js.map

package/lib/utils/createPipeline.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createPipeline.js","sourceRoot":"","sources":["../../src/utils/createPipeline.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAqCH,MAAM,cAAc,GAAG,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC,CAAC;AAE/G;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,OAAe;IAC5C,MAAM,KAAK,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IACpC,IAAI,KAAK,CAAC,QAAQ,CAAC,YAAY,CAAC;QAAE,OAAO,QAAQ,CAAC;IAClD,IAAI,KAAK,CAAC,QAAQ,CAAC,eAAe,CAAC;QAAE,OAAO,WAAW,CAAC;IACxD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,MAA4B;IAC/D,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,SAAS,EAAE,gBAAgB,EAAE,GAAG,MAAM,CAAC;IAE1G,MAAM,IAAI,GAAG,mBAAmB,UAAU,CAAC,aAAa,EAAE,2BAA2B,CAAC;IAEtF,MAAM,OAAO,GAA4B;QACvC,IAAI;QACJ,OAAO,EAAE,QAAQ;QACjB,MAAM,EAAE,cAAc;KACvB,CAAC;IAEF,IAAI,UAAU,EAAE,CAAC;QACf,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;QAC7B,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;QAC3B,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC;QAEjC,IAAI,QAAQ,KAAK,WAAW,IAAI,SAAS,EAAE,CAAC;YAC1C,MAAM,YAAY,GAA2B,EAAE,kBAAkB,EAAE,SAAS,EAAE,CAAC;YAC/E,IAAI,gBAAgB,EAAE,CAAC;gBACrB,YAAY,CAAC,gBAAgB,GAAG,gBAAgB,CAAC;YACnD,CAAC;YACD,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC;QAC1D,CAAC;IACH,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IAC5B,CAAC;IAED,IAAI,WAAW,EAAE,CAAC;QAChB,OAAO,CAAC,WAAW,GAAG,WAAW,CAAC;IACpC,CAAC;IAED,MAAM,IAAI,GAAG,MAAM,UAAU,CAAC,OAAO,CAA0B;QAC7D,MAAM,EAAE,MAAM;QACd,GAAG,EAAE,IAAI;QACT,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC;QAC7B,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;KAChD,CAAC,CAAC;IAEH,OAAO;QACL,OAAO,EAAE,IAAI;QACb,UAAU,EAAE,IAAI,CAAC,EAAE;QACnB,IAAI;QACJ,WAAW;QACX,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,UAAU;QACjC,UAAU,EAAE;YACV,OAAO,EAAE,IAAI;YACb,QAAQ;YACR,OAAO,EAAE,UAAU,IAAI,KAAK;SAC7B;KACF,CAAC;AACJ,CAAC"}

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>;