@simplysf/simply-cicd-core 0.2.0

package/lib/vcs/github.js

@@ -0,0 +1,267 @@
+/*
+ * Copyright (c) 2026, Clay Chipps.
+ *
+ * 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.
+ */
+function normalizeProject(repo) {
+    return {
+        id: repo.id,
+        key: repo.full_name,
+        name: repo.name,
+        pathWithNamespace: repo.full_name,
+        defaultBranch: repo.default_branch,
+        archived: Boolean(repo.archived),
+        // GitHub has no `empty_repo` flag; a repo with no commits reports a zero size.
+        empty: repo.size === 0,
+        isFork: repo.fork === true,
+        raw: repo,
+    };
+}
+function normalizePullRequest(pullRequest) {
+    return {
+        id: pullRequest.id,
+        // GitHub's per-pull-request endpoints take the repo-scoped `number`.
+        iid: pullRequest.number,
+        title: pullRequest.title,
+        description: pullRequest.body,
+        sourceBranch: pullRequest.head.ref,
+        targetBranch: pullRequest.base.ref,
+        webUrl: pullRequest.html_url,
+        raw: pullRequest,
+    };
+}
+/** GitHub addresses repos as `owner/repo`, so each segment is encoded separately. */
+function splitProject(project) {
+    const key = typeof project === 'object' ? project.key : String(project);
+    const [owner, repo] = key.split('/');
+    if (!owner || !repo) {
+        throw new Error(`Invalid GitHub repository "${key}". Expected "owner/repo".`);
+    }
+    return { owner: encodeURIComponent(owner), repo: encodeURIComponent(repo) };
+}
+function repoPath(project) {
+    const { owner, repo } = splitProject(project);
+    return `/repos/${owner}/${repo}`;
+}
+/** Encodes a file path for the contents API, preserving its directory separators. */
+function encodeFilePath(filePath) {
+    return filePath.split('/').map(encodeURIComponent).join('/');
+}
+/** Extracts the `rel="next"` URL from a Link header, if present. */
+function nextLink(linkHeader) {
+    if (!linkHeader) {
+        return undefined;
+    }
+    for (const part of linkHeader.split(',')) {
+        const match = /<(?<url>[^>]+)>\s*;\s*rel="next"/.exec(part);
+        if (match?.groups?.url) {
+            return match.groups.url;
+        }
+    }
+    return undefined;
+}
+/** A `VcsProvider` implementation for GitHub, backed by the GitHub REST API. */
+export class GitHubProvider {
+    /** Used when no `--vcs-host` is supplied, so selecting a provider is enough to reach its SaaS instance. */
+    static defaultHost = 'github.com';
+    kind = 'github';
+    terminology = {
+        changeRequest: 'pull request',
+        changeRequestShort: 'PR',
+        projectVariable: 'GitHub Actions variable',
+    };
+    host;
+    apiUrl;
+    token;
+    constructor(options) {
+        const { host, token, apiUrl } = options;
+        if (!token) {
+            throw new Error('GitHub access token is required.');
+        }
+        const resolvedHost = host ?? GitHubProvider.defaultHost;
+        // github.com serves its API from a dedicated hostname; GitHub Enterprise Server serves it
+        // from /api/v3 on the instance itself.
+        const derived = resolvedHost === GitHubProvider.defaultHost ? 'https://api.github.com' : `https://${resolvedHost}/api/v3`;
+        this.apiUrl = (apiUrl ?? derived).replace(/\/+$/, '');
+        this.host = resolvedHost;
+        this.token = token;
+    }
+    // eslint-disable-next-line class-methods-use-this -- part of the VcsProvider instance contract; GitHub Actions variables are process-global
+    getCiContext() {
+        return {
+            projectPath: process.env.GITHUB_REPOSITORY,
+            projectId: process.env.GITHUB_REPOSITORY_ID,
+        };
+    }
+    async listProjects(orgId) {
+        const repos = [];
+        // GitHub orgs are flat, so there is no subgroup recursion to do here.
+        let endpoint = `/orgs/${encodeURIComponent(orgId)}/repos?per_page=100`;
+        while (endpoint) {
+            // eslint-disable-next-line no-await-in-loop -- pagination is inherently sequential (the next URL comes from this page's Link header)
+            const response = await this.request(endpoint);
+            // eslint-disable-next-line no-await-in-loop
+            const data = (await response.json());
+            if (!Array.isArray(data) || data.length === 0) {
+                break;
+            }
+            repos.push(...data);
+            endpoint = nextLink(response.headers.get('Link'));
+        }
+        return repos.map(normalizeProject);
+    }
+    async getFileContent(project, filePath, ref) {
+        const endpoint = `${repoPath(project)}/contents/${encodeFilePath(filePath)}?ref=${encodeURIComponent(ref)}`;
+        const response = await this.request(endpoint, { headers: { Accept: 'application/vnd.github.raw' } });
+        return response.text();
+    }
+    async compareRefs(project, from, to) {
+        const endpoint = `${repoPath(project)}/compare/${encodeURIComponent(from)}...${encodeURIComponent(to)}`;
+        const response = (await this.getJson(endpoint));
+        return (response.commits ?? []).map((commit) => ({
+            sha: commit.sha,
+            message: commit.commit.message,
+            raw: commit,
+        }));
+    }
+    async branchExists(project, branchName) {
+        const endpoint = `${repoPath(project)}/branches/${encodeURIComponent(branchName)}`;
+        try {
+            await this.request(endpoint, { method: 'GET' });
+            return true;
+        }
+        catch (error) {
+            const err = error;
+            if (err.message.includes('404')) {
+                return false;
+            }
+            throw err;
+        }
+    }
+    async createBranch(project, branchName, ref) {
+        // GitHub creates refs by SHA, so the source branch has to be resolved first.
+        const sourceRef = (await this.getJson(`${repoPath(project)}/git/ref/heads/${encodeURIComponent(ref)}`));
+        const response = await this.request(`${repoPath(project)}/git/refs`, {
+            method: 'POST',
+            body: { ref: `refs/heads/${branchName}`, sha: sourceRef.object.sha },
+        });
+        const raw = await response.json();
+        return { name: branchName, raw };
+    }
+    async commitFile(project, branchName, commitMessage, filePath, content) {
+        const encodedPath = encodeFilePath(filePath);
+        // Updating an existing file through the contents API requires its current blob SHA.
+        const existing = (await this.getJson(`${repoPath(project)}/contents/${encodedPath}?ref=${encodeURIComponent(branchName)}`));
+        const response = await this.request(`${repoPath(project)}/contents/${encodedPath}`, {
+            method: 'PUT',
+            body: {
+                message: commitMessage,
+                content: Buffer.from(content, 'utf8').toString('base64'),
+                branch: branchName,
+                sha: existing.sha,
+            },
+        });
+        const raw = (await response.json());
+        return { id: raw.commit?.sha, raw };
+    }
+    async findOpenMergeRequest(project, sourceBranch, targetBranch) {
+        const { owner } = splitProject(project);
+        const head = `${owner}:${sourceBranch}`;
+        const endpoint = `${repoPath(project)}/pulls?state=open&head=${encodeURIComponent(head)}&base=${encodeURIComponent(targetBranch)}`;
+        const pullRequests = (await this.getJson(endpoint));
+        return pullRequests.length > 0 ? normalizePullRequest(pullRequests[0]) : undefined;
+    }
+    async createMergeRequest(project, sourceBranch, targetBranch, title, description, labels) {
+        // GitLab's `remove_source_branch` has no per-pull-request equivalent here; branch cleanup is
+        // the repo-level `delete_branch_on_merge` setting.
+        const response = await this.request(`${repoPath(project)}/pulls`, {
+            method: 'POST',
+            body: { title, body: description, head: sourceBranch, base: targetBranch },
+        });
+        const pullRequest = normalizePullRequest((await response.json()));
+        if (labels?.length) {
+            // Labels live on the issue that backs the pull request, not on the pull request itself.
+            await this.request(`${repoPath(project)}/issues/${pullRequest.iid}/labels`, {
+                method: 'POST',
+                body: { labels },
+            });
+        }
+        return pullRequest;
+    }
+    async updateMergeRequest(project, mergeRequest, title, description, labels) {
+        const response = await this.request(`${repoPath(project)}/pulls/${mergeRequest.iid}`, {
+            method: 'PUT',
+            body: { title, body: description },
+        });
+        const updated = normalizePullRequest((await response.json()));
+        if (labels?.length) {
+            // PUT replaces the label set, matching GitLab's update-with-labels semantics.
+            await this.request(`${repoPath(project)}/issues/${updated.iid}/labels`, {
+                method: 'PUT',
+                body: { labels },
+            });
+        }
+        return updated;
+    }
+    async getProjectVariables(project) {
+        try {
+            const result = (await this.getJson(`${repoPath(project)}/actions/variables`));
+            return (result.variables ?? []).map((variable) => ({
+                key: variable.name,
+                value: variable.value,
+                raw: variable,
+            }));
+        }
+        catch {
+            // If we don't have permission to read variables, treat it as "no variables".
+            return [];
+        }
+    }
+    // eslint-disable-next-line class-methods-use-this -- part of the VcsProvider instance contract; the path scheme needs no instance state
+    buildChangeRequestUrl(projectUrl, changeRequestIid) {
+        return `${projectUrl.replace(/\/+$/, '')}/pull/${changeRequestIid}`;
+    }
+    buildAuthenticatedRemoteUrl(token, projectPath) {
+        return `https://x-access-token:${token}@${this.host}/${projectPath}.git`;
+    }
+    buildCiCloneUrl(ciJobToken, projectPath) {
+        // GitHub has no separate job token; Actions hands the workflow a GITHUB_TOKEN that
+        // authenticates the same way.
+        return `https://x-access-token:${ciJobToken}@${this.host}/${projectPath}.git`;
+    }
+    async request(endpoint, options = {}) {
+        const url = endpoint.startsWith('http') ? endpoint : `${this.apiUrl}${endpoint}`;
+        const headers = {
+            Authorization: `Bearer ${this.token}`,
+            Accept: 'application/vnd.github+json',
+            'X-GitHub-Api-Version': '2022-11-28',
+            'Content-Type': 'application/json',
+            ...options.headers,
+        };
+        const response = await fetch(url, {
+            method: options.method,
+            headers,
+            body: options.body !== undefined ? JSON.stringify(options.body) : undefined,
+        });
+        if (!response.ok) {
+            const errorText = await response.text().catch(() => 'Unknown error');
+            throw new Error(`GitHub API error: ${response.status} ${response.statusText} - ${errorText}`);
+        }
+        return response;
+    }
+    async getJson(endpoint) {
+        const response = await this.request(endpoint);
+        return response.json();
+    }
+}
+//# sourceMappingURL=github.js.map

package/lib/vcs/github.js.map

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

package/lib/vcs/gitlab.d.ts

@@ -0,0 +1,30 @@
+import type { VcsBranch, VcsCiContext, VcsCommit, VcsCommitLogEntry, VcsMergeRequest, VcsProject, VcsProjectRef, VcsProjectVariable, VcsProvider, VcsProviderOptions, VcsTerminology } from './types.js';
+/** A `VcsProvider` implementation for GitLab, backed by the GitLab REST API v4. */
+export declare class GitLabProvider implements VcsProvider {
+    /** Used when no `--vcs-host` is supplied, so selecting a provider is enough to reach its SaaS instance. */
+    static readonly defaultHost = "gitlab.com";
+    readonly kind: "gitlab";
+    readonly terminology: VcsTerminology;
+    readonly host: string;
+    readonly apiUrl: string;
+    private readonly token;
+    private readonly tokenKind;
+    constructor(options: VcsProviderOptions);
+    getCiContext(): VcsCiContext;
+    listProjects(groupId: string | number): Promise<VcsProject[]>;
+    getFileContent(project: VcsProjectRef, filePath: string, ref: string): Promise<string>;
+    compareRefs(project: VcsProjectRef, from: string, to: string): Promise<VcsCommitLogEntry[]>;
+    branchExists(project: VcsProjectRef, branchName: string): Promise<boolean>;
+    createBranch(project: VcsProjectRef, branchName: string, ref: string): Promise<VcsBranch>;
+    commitFile(project: VcsProjectRef, branchName: string, commitMessage: string, filePath: string, content: string): Promise<VcsCommit>;
+    findOpenMergeRequest(project: VcsProjectRef, sourceBranch: string, targetBranch: string): Promise<VcsMergeRequest | undefined>;
+    createMergeRequest(project: VcsProjectRef, sourceBranch: string, targetBranch: string, title: string, description: string, labels?: string[]): Promise<VcsMergeRequest>;
+    updateMergeRequest(project: VcsProjectRef, mergeRequest: VcsMergeRequest, title: string, description: string, labels?: string[]): Promise<VcsMergeRequest>;
+    getProjectVariables(project: VcsProjectRef): Promise<VcsProjectVariable[]>;
+    buildChangeRequestUrl(projectUrl: string, changeRequestIid: string | number): string;
+    buildAuthenticatedRemoteUrl(token: string, projectPath: string): string;
+    buildCiCloneUrl(ciJobToken: string, projectPath: string): string;
+    private request;
+    private getJson;
+    private getRawText;
+}

package/lib/vcs/gitlab.js

@@ -0,0 +1,242 @@
+/*
+ * Copyright (c) 2026, Clay Chipps.
+ *
+ * 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.
+ */
+function normalizeProject(project) {
+    return {
+        id: project.id,
+        key: String(project.id),
+        name: project.name,
+        pathWithNamespace: project.path_with_namespace,
+        defaultBranch: project.default_branch,
+        archived: Boolean(project.archived),
+        empty: Boolean(project.empty_repo),
+        isFork: Boolean(project.forked_from_project) || project.fork === true,
+        raw: project,
+    };
+}
+function normalizeMergeRequest(mergeRequest) {
+    return {
+        id: mergeRequest.id,
+        iid: mergeRequest.iid,
+        title: mergeRequest.title,
+        description: mergeRequest.description,
+        sourceBranch: mergeRequest.source_branch,
+        targetBranch: mergeRequest.target_branch,
+        webUrl: mergeRequest.web_url,
+        raw: mergeRequest,
+    };
+}
+/** GitLab addresses projects by numeric ID or URL-encoded path; both arrive here already usable. */
+function projectSegment(project) {
+    const key = typeof project === 'object' ? project.key : String(project);
+    return encodeURIComponent(key);
+}
+/** A `VcsProvider` implementation for GitLab, backed by the GitLab REST API v4. */
+export class GitLabProvider {
+    /** Used when no `--vcs-host` is supplied, so selecting a provider is enough to reach its SaaS instance. */
+    static defaultHost = 'gitlab.com';
+    kind = 'gitlab';
+    terminology = {
+        changeRequest: 'merge request',
+        changeRequestShort: 'MR',
+        projectVariable: 'GitLab CI/CD variable',
+    };
+    host;
+    apiUrl;
+    token;
+    tokenKind;
+    constructor(options) {
+        const { host, token, apiUrl, tokenKind } = options;
+        if (!token) {
+            throw new Error('GitLab access token is required.');
+        }
+        this.apiUrl = (apiUrl ?? `https://${host ?? GitLabProvider.defaultHost}/api/v4`).replace(/\/+$/, '');
+        // When only an API URL is supplied (the dependabot path), recover the host from it so the
+        // remote-URL builders stay usable.
+        this.host = host ?? new URL(this.apiUrl).host;
+        this.token = token;
+        this.tokenKind = tokenKind ?? 'personal';
+    }
+    // eslint-disable-next-line class-methods-use-this -- part of the VcsProvider instance contract; GitLab's CI variables are process-global
+    getCiContext() {
+        return {
+            projectPath: process.env.CI_PROJECT_PATH,
+            projectId: process.env.CI_PROJECT_ID,
+        };
+    }
+    async listProjects(groupId) {
+        let projects = [];
+        let page = 1;
+        let hasMore = true;
+        const encodedGroupId = encodeURIComponent(groupId);
+        while (hasMore) {
+            const endpoint = `/groups/${encodedGroupId}/projects?include_subgroups=true&per_page=100&page=${page}`;
+            // eslint-disable-next-line no-await-in-loop -- pagination is inherently sequential (next page depends on this one's headers)
+            const response = await this.request(endpoint);
+            // eslint-disable-next-line no-await-in-loop
+            const data = (await response.json());
+            if (!Array.isArray(data) || data.length === 0) {
+                break;
+            }
+            projects = projects.concat(data);
+            const nextPageHeader = response.headers.get('X-Next-Page');
+            if (nextPageHeader) {
+                const nextPageNum = Number(nextPageHeader);
+                if (nextPageNum && nextPageNum > page) {
+                    page = nextPageNum;
+                }
+                else {
+                    hasMore = false;
+                }
+            }
+            else if (data.length < 100) {
+                hasMore = false;
+            }
+            else {
+                page++;
+            }
+        }
+        return projects.map(normalizeProject);
+    }
+    async getFileContent(project, filePath, ref) {
+        const encodedFilePath = encodeURIComponent(filePath);
+        const endpoint = `/projects/${projectSegment(project)}/repository/files/${encodedFilePath}/raw?ref=${encodeURIComponent(ref)}`;
+        return this.getRawText(endpoint);
+    }
+    async compareRefs(project, from, to) {
+        const endpoint = `/projects/${projectSegment(project)}/repository/compare?from=${encodeURIComponent(from)}&to=${encodeURIComponent(to)}`;
+        const response = (await this.getJson(endpoint));
+        return (response.commits ?? []).map((commit) => ({ sha: commit.id, message: commit.message, raw: commit }));
+    }
+    async branchExists(project, branchName) {
+        const encodedBranch = encodeURIComponent(branchName);
+        const endpoint = `/projects/${projectSegment(project)}/repository/branches/${encodedBranch}`;
+        try {
+            await this.request(endpoint, { method: 'GET' });
+            return true;
+        }
+        catch (error) {
+            const err = error;
+            if (err.message.includes('404')) {
+                return false;
+            }
+            throw err;
+        }
+    }
+    async createBranch(project, branchName, ref) {
+        const endpoint = `/projects/${projectSegment(project)}/repository/branches`;
+        const response = await this.request(endpoint, {
+            method: 'POST',
+            body: { branch: branchName, ref },
+        });
+        const raw = await response.json();
+        return { name: branchName, raw };
+    }
+    async commitFile(project, branchName, commitMessage, filePath, content) {
+        const endpoint = `/projects/${projectSegment(project)}/repository/commits`;
+        /* eslint-disable camelcase -- GitLab API field names */
+        const response = await this.request(endpoint, {
+            method: 'POST',
+            body: {
+                branch: branchName,
+                commit_message: commitMessage,
+                actions: [{ action: 'update', file_path: filePath, content }],
+            },
+        });
+        /* eslint-enable camelcase */
+        const raw = (await response.json());
+        return { id: raw.id, raw };
+    }
+    async findOpenMergeRequest(project, sourceBranch, targetBranch) {
+        const endpoint = `/projects/${projectSegment(project)}/merge_requests?state=opened&source_branch=${encodeURIComponent(sourceBranch)}&target_branch=${encodeURIComponent(targetBranch)}`;
+        const mergeRequests = (await this.getJson(endpoint));
+        return mergeRequests.length > 0 ? normalizeMergeRequest(mergeRequests[0]) : undefined;
+    }
+    async createMergeRequest(project, sourceBranch, targetBranch, title, description, labels) {
+        const endpoint = `/projects/${projectSegment(project)}/merge_requests`;
+        /* eslint-disable camelcase -- GitLab API field names */
+        const body = {
+            source_branch: sourceBranch,
+            target_branch: targetBranch,
+            title,
+            description,
+            remove_source_branch: true,
+        };
+        /* eslint-enable camelcase */
+        if (labels?.length) {
+            body.labels = labels.join(',');
+        }
+        const response = await this.request(endpoint, { method: 'POST', body });
+        return normalizeMergeRequest((await response.json()));
+    }
+    async updateMergeRequest(project, mergeRequest, title, description, labels) {
+        // GitLab's per-merge-request endpoints take the project-scoped `iid`, not the global `id`.
+        const endpoint = `/projects/${projectSegment(project)}/merge_requests/${mergeRequest.iid}`;
+        const body = { title, description };
+        if (labels?.length) {
+            body.labels = labels.join(',');
+        }
+        const response = await this.request(endpoint, { method: 'PUT', body });
+        return normalizeMergeRequest((await response.json()));
+    }
+    async getProjectVariables(project) {
+        try {
+            const variables = (await this.getJson(`/projects/${projectSegment(project)}/variables`));
+            return variables.map((variable) => ({ key: variable.key, value: variable.value, raw: variable }));
+        }
+        catch {
+            // If we don't have permission to read variables, treat it as "no variables".
+            return [];
+        }
+    }
+    // eslint-disable-next-line class-methods-use-this -- part of the VcsProvider instance contract; the path scheme needs no instance state
+    buildChangeRequestUrl(projectUrl, changeRequestIid) {
+        return `${projectUrl.replace(/\/+$/, '')}/-/merge_requests/${changeRequestIid}`;
+    }
+    buildAuthenticatedRemoteUrl(token, projectPath) {
+        return `https://oauth2:${token}@${this.host}/${projectPath}.git`;
+    }
+    buildCiCloneUrl(ciJobToken, projectPath) {
+        return `https://gitlab-ci-token:${ciJobToken}@${this.host}/${projectPath}.git`;
+    }
+    async request(endpoint, options = {}) {
+        const url = endpoint.startsWith('http') ? endpoint : `${this.apiUrl}${endpoint}`;
+        const tokenHeader = this.tokenKind === 'job' ? 'JOB-TOKEN' : 'PRIVATE-TOKEN';
+        const headers = {
+            [tokenHeader]: this.token,
+            'Content-Type': 'application/json',
+            ...options.headers,
+        };
+        const response = await fetch(url, {
+            method: options.method,
+            headers,
+            body: options.body !== undefined ? JSON.stringify(options.body) : undefined,
+        });
+        if (!response.ok) {
+            const errorText = await response.text().catch(() => 'Unknown error');
+            throw new Error(`GitLab API error: ${response.status} ${response.statusText} - ${errorText}`);
+        }
+        return response;
+    }
+    async getJson(endpoint) {
+        const response = await this.request(endpoint);
+        return response.json();
+    }
+    async getRawText(endpoint) {
+        const response = await this.request(endpoint);
+        return response.text();
+    }
+}
+//# sourceMappingURL=gitlab.js.map

package/lib/vcs/gitlab.js.map

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

package/lib/vcs/index.d.ts

@@ -0,0 +1,4 @@
+export { createVcsProvider, listVcsProviderKinds, registerVcsProvider } from './registry.js';
+export { GitHubProvider } from './github.js';
+export { GitLabProvider } from './gitlab.js';
+export type { VcsBranch, VcsCiContext, VcsCommit, VcsCommitLogEntry, VcsMergeRequest, VcsProject, VcsProjectRef, VcsProjectVariable, VcsProvider, VcsProviderFactory, VcsProviderKind, VcsProviderOptions, VcsTerminology, } from './types.js';

package/lib/vcs/index.js

@@ -0,0 +1,24 @@
+/*
+ * Copyright (c) 2026, Clay Chipps.
+ *
+ * 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 { GitHubProvider } from './github.js';
+import { GitLabProvider } from './gitlab.js';
+import { registerVcsProvider } from './registry.js';
+registerVcsProvider('gitlab', (options) => new GitLabProvider(options));
+registerVcsProvider('github', (options) => new GitHubProvider(options));
+export { createVcsProvider, listVcsProviderKinds, registerVcsProvider } from './registry.js';
+export { GitHubProvider } from './github.js';
+export { GitLabProvider } from './gitlab.js';
+//# sourceMappingURL=index.js.map

package/lib/vcs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/vcs/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAEpD,mBAAmB,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC;AACxE,mBAAmB,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC;AAExE,OAAO,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAE7F,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC"}

package/lib/vcs/registry.d.ts

@@ -0,0 +1,10 @@
+import type { VcsProvider, VcsProviderFactory, VcsProviderKind, VcsProviderOptions } from './types.js';
+/**
+ * Registers a platform implementation. Built-in providers register themselves when `./index.js` is
+ * imported; call this directly to add a platform without modifying this package.
+ */
+export declare function registerVcsProvider(kind: VcsProviderKind, factory: VcsProviderFactory): void;
+/** The platforms currently registered, for flag options and error messages. */
+export declare function listVcsProviderKinds(): VcsProviderKind[];
+/** Builds a provider for the given platform and instance. */
+export declare function createVcsProvider(kind: VcsProviderKind, options: VcsProviderOptions): VcsProvider;

package/lib/vcs/registry.js

@@ -0,0 +1,37 @@
+/*
+ * Copyright (c) 2026, Clay Chipps.
+ *
+ * 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 factories = new Map();
+/**
+ * Registers a platform implementation. Built-in providers register themselves when `./index.js` is
+ * imported; call this directly to add a platform without modifying this package.
+ */
+export function registerVcsProvider(kind, factory) {
+    factories.set(kind, factory);
+}
+/** The platforms currently registered, for flag options and error messages. */
+export function listVcsProviderKinds() {
+    return [...factories.keys()].sort();
+}
+/** Builds a provider for the given platform and instance. */
+export function createVcsProvider(kind, options) {
+    const factory = factories.get(kind);
+    if (!factory) {
+        const known = listVcsProviderKinds().join(', ');
+        throw new Error(`VCS provider "${kind}" is not supported. Registered providers: ${known}.`);
+    }
+    return factory(options);
+}
+//# sourceMappingURL=registry.js.map