release-please 17.4.0 → 17.5.0

package/build/src/local-github.js

@@ -0,0 +1,776 @@
+"use strict";
+// Copyright 2026 Google LLC
+//
+// 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.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LocalGitHub = void 0;
+const fs = require("fs");
+const path = require("path");
+const os = require("os");
+const child_process = require("child_process");
+const util = require("util");
+const readline = require("readline");
+const execFile = util.promisify(child_process.execFile);
+const mkdtemp = fs.promises.mkdtemp;
+const errors_1 = require("./errors");
+const manifest_1 = require("./manifest");
+const git_file_utils_1 = require("@google-automations/git-file-utils");
+const composite_1 = require("./updaters/composite");
+const github_api_1 = require("./github-api");
+const logger_1 = require("./util/logger");
+/**
+ * LocalGitHub implements the Scm interface using a local git clone
+ * where possible, and falling back to the GitHub API for other operations.
+ */
+class LocalGitHub {
+    constructor(repository, gitHubApi, cloneDir, options) {
+        var _a;
+        this.repository = repository;
+        this.gitHubApi = gitHubApi;
+        this.cloneDir = cloneDir;
+        this.logger = (_a = options === null || options === void 0 ? void 0 : options.logger) !== null && _a !== void 0 ? _a : logger_1.logger;
+    }
+    static async create(options) {
+        var _a;
+        const gitHubApi = await github_api_1.GitHubApi.create(options);
+        const logger = (_a = options.logger) !== null && _a !== void 0 ? _a : logger_1.logger;
+        let repoDir;
+        if (options.localRepoPath) {
+            repoDir = options.localRepoPath;
+            let isGitRepo = false;
+            try {
+                await execFile('git', ['rev-parse', '--is-inside-work-tree'], {
+                    cwd: repoDir,
+                });
+                isGitRepo = true;
+            }
+            catch (err) {
+                isGitRepo = false;
+            }
+            if (!isGitRepo) {
+                logger.info(`Path ${repoDir} is not a git clone. Cloning repository...`);
+                const url = `https://github.com/${gitHubApi.repository.owner}/${gitHubApi.repository.repo}.git`;
+                const args = ['clone', '--', url, repoDir];
+                if (options.cloneDepth) {
+                    args.splice(1, 0, '--depth', options.cloneDepth.toString());
+                }
+                logger.debug(`Executing: git ${args.join(' ')}`);
+                await execFile('git', args);
+            }
+            else {
+                logger.info(`Using existing local repository at ${repoDir}...`);
+            }
+            const branch = gitHubApi.repository.defaultBranch;
+            logger.debug('Executing: git fetch origin');
+            await execFile('git', ['fetch', 'origin'], { cwd: repoDir });
+            logger.debug(`Executing: git checkout ${branch}`);
+            await execFile('git', ['checkout', branch], { cwd: repoDir });
+            logger.debug(`Executing: git reset --hard origin/${branch}`);
+            await execFile('git', ['reset', '--hard', `origin/${branch}`], {
+                cwd: repoDir,
+            });
+        }
+        else {
+            const tempDir = await mkdtemp(path.join(os.tmpdir(), 'release-please-'));
+            logger.info(`Cloning repository to ${tempDir}...`);
+            const url = `https://github.com/${gitHubApi.repository.owner}/${gitHubApi.repository.repo}.git`;
+            const args = ['clone', '--', url, tempDir];
+            if (options.cloneDepth) {
+                args.splice(1, 0, '--depth', options.cloneDepth.toString());
+            }
+            logger.debug(`Executing: git ${args.join(' ')}`);
+            await execFile('git', args);
+            repoDir = tempDir;
+        }
+        return new LocalGitHub(gitHubApi.repository, gitHubApi, repoDir, {
+            logger: options.logger,
+        });
+    }
+    /**
+     * Fetch the contents of a file from the configured branch
+     *
+     * @param {string} path The path to the file in the repository
+     * @returns {GitHubFileContents}
+     * @throws {GitHubAPIError} on other API errors
+     */
+    async getFileContents(path) {
+        return await this.getFileContentsOnBranch(path, this.repository.defaultBranch);
+    }
+    async execGitStream(args, callback) {
+        return new Promise((resolve, reject) => {
+            const child = child_process.spawn('git', args, { cwd: this.cloneDir });
+            let stderr = '';
+            child.stderr.on('data', data => {
+                stderr += data;
+            });
+            const rl = readline.createInterface({
+                input: child.stdout,
+                crlfDelay: Infinity,
+            });
+            rl.on('line', callback);
+            child.on('close', code => {
+                if (code !== 0) {
+                    reject(new Error(`Command failed ${code}: ${stderr}`));
+                }
+                else {
+                    resolve();
+                }
+            });
+        });
+    }
+    async ensureRef(ref) {
+        try {
+            await execFile('git', ['rev-parse', '--verify', ref], {
+                cwd: this.cloneDir,
+            });
+            return ref;
+        }
+        catch (err) {
+            this.logger.debug(`Ref ${ref} not found locally, trying to fetch from origin...`);
+            try {
+                await execFile('git', ['fetch', 'origin', '--', ref], {
+                    cwd: this.cloneDir,
+                });
+                return 'FETCH_HEAD';
+            }
+            catch (fetchErr) {
+                throw err; // Throw original error if fetch fails
+            }
+        }
+    }
+    /**
+     * Fetch the contents of a file
+     *
+     * @param {string} path The path to the file in the repository
+     * @param {string} branch The branch to fetch from
+     * @returns {GitHubFileContents}
+     * @throws {FileNotFoundError} if the file cannot be found
+     * @throws {GitHubAPIError} on other API errors
+     */
+    async getFileContentsOnBranch(path, branch) {
+        this.logger.debug(`Fetching file contents for file ${path} on branch ${branch}`);
+        const ref = await this.ensureRef(branch);
+        const lsTreeResult = await execFile('git', ['ls-tree', ref, path], {
+            cwd: this.cloneDir,
+        });
+        if (!lsTreeResult.stdout.trim()) {
+            throw new errors_1.FileNotFoundError(path);
+        }
+        const [info] = lsTreeResult.stdout.split('\t');
+        const [mode, , sha] = info.split(' ');
+        const { stdout } = await execFile('git', ['show', `${ref}:${path}`], {
+            cwd: this.cloneDir,
+            maxBuffer: 100 * 1024 * 1024,
+        });
+        return {
+            content: Buffer.from(stdout).toString('base64'),
+            parsedContent: stdout,
+            sha,
+            mode,
+        };
+    }
+    async getFileJson(path, branch) {
+        const content = await this.getFileContentsOnBranch(path, branch);
+        return JSON.parse(content.parsedContent);
+    }
+    /**
+     * Returns a list of paths to all files with a given name.
+     *
+     * If a prefix is specified, only return paths that match
+     * the provided prefix.
+     *
+     * @param filename The name of the file to find
+     * @param prefix Optional path prefix used to filter results
+     * @returns {string[]} List of file paths
+     * @throws {GitHubAPIError} on an API error
+     */
+    async findFilesByFilename(filename, prefix) {
+        return this.findFilesByFilenameAndRef(filename, this.repository.defaultBranch, prefix);
+    }
+    /**
+     * Returns a list of paths to all files with a given name.
+     *
+     * If a prefix is specified, only return paths that match
+     * the provided prefix.
+     *
+     * @param filename The name of the file to find
+     * @param ref Git reference to search files in
+     * @param prefix Optional path prefix used to filter results
+     * @throws {GitHubAPIError} on an API error
+     */
+    async findFilesByFilenameAndRef(filename, ref, prefix) {
+        this.logger.debug(`Looking in local clone for file ${filename} with ref ${ref} and prefix '${prefix}'`);
+        let normalizedPrefix = prefix
+            ? prefix.replace(/^[/\\]/, '').replace(/[/\\]$/, '')
+            : '';
+        if (normalizedPrefix === manifest_1.ROOT_PROJECT_PATH) {
+            normalizedPrefix = '';
+        }
+        const treePath = normalizedPrefix ? `${normalizedPrefix}/` : '.';
+        const resolvedRef = await this.ensureRef(ref);
+        this.logger.trace(`Executing stream: git ls-tree -r --name-only ${resolvedRef} ${treePath}`);
+        const matchedPaths = [];
+        await this.execGitStream(['ls-tree', '-r', '--name-only', resolvedRef, treePath], line => {
+            const trimmed = line.trim();
+            if (trimmed && path.posix.basename(trimmed) === filename) {
+                matchedPaths.push(trimmed);
+            }
+        });
+        if (normalizedPrefix) {
+            return matchedPaths
+                .map(p => {
+                if (p === normalizedPrefix)
+                    return '';
+                if (p.startsWith(`${normalizedPrefix}/`)) {
+                    return p.slice(normalizedPrefix.length + 1);
+                }
+                return p;
+            })
+                .filter(p => p !== '');
+        }
+        return matchedPaths;
+    }
+    /**
+     * Returns a list of paths to all files matching a glob pattern.
+     *
+     * If a prefix is specified, only return paths that match
+     * the provided prefix.
+     *
+     * @param glob The glob to match
+     * @param prefix Optional path prefix used to filter results
+     * @returns {string[]} List of file paths
+     * @throws {GitHubAPIError} on an API error
+     */
+    async findFilesByGlob(glob, prefix) {
+        return this.findFilesByGlobAndRef(glob, this.repository.defaultBranch, prefix);
+    }
+    /**
+     * Returns a list of paths to all files matching a glob pattern.
+     *
+     * If a prefix is specified, only return paths that match
+     * the provided prefix.
+     *
+     * @param glob The glob to match
+     * @param ref Git reference to search files in
+     * @param prefix Optional path prefix used to filter results
+     * @throws {GitHubAPIError} on an API error
+     */
+    async findFilesByGlobAndRef(glob, ref, prefix) {
+        this.logger.debug(`Looking in local clone for file matching glob ${glob} with ref ${ref} and prefix '${prefix}'`);
+        let normalizedPrefix = prefix
+            ? prefix.replace(/^[/\\]/, '').replace(/[/\\]$/, '')
+            : '';
+        if (normalizedPrefix === manifest_1.ROOT_PROJECT_PATH) {
+            normalizedPrefix = '';
+        }
+        const treePath = normalizedPrefix ? `${normalizedPrefix}/` : '.';
+        const resolvedRef = await this.ensureRef(ref);
+        const files = [];
+        const dirs = new Set();
+        await this.execGitStream(['ls-tree', '-r', '--name-only', resolvedRef, treePath], line => {
+            const trimmed = line.trim();
+            if (trimmed) {
+                files.push(trimmed);
+                let dir = path.posix.dirname(trimmed);
+                while (dir !== '.' && dir !== '/') {
+                    dirs.add(dir);
+                    dir = path.posix.dirname(dir);
+                }
+            }
+        });
+        const allPaths = [...files, ...dirs];
+        // Make paths relative to prefix if provided
+        let relativePaths = allPaths;
+        if (normalizedPrefix) {
+            relativePaths = allPaths
+                .map(p => {
+                if (p === normalizedPrefix)
+                    return '';
+                if (p.startsWith(`${normalizedPrefix}/`)) {
+                    return p.slice(normalizedPrefix.length + 1);
+                }
+                return p;
+            })
+                .filter(p => p !== '');
+        }
+        const regex = globToRegex(glob);
+        return relativePaths.filter(p => regex.test(p));
+    }
+    /**
+     * Returns a list of paths to all files with a given file
+     * extension.
+     *
+     * If a prefix is specified, only return paths that match
+     * the provided prefix.
+     *
+     * @param extension The file extension used to filter results.
+     *   Example: `js`, `java`
+     * @param prefix Optional path prefix used to filter results
+     * @returns {string[]} List of file paths
+     * @throws {GitHubAPIError} on an API error
+     */
+    async findFilesByExtension(extension, prefix) {
+        return this.findFilesByExtensionAndRef(extension, this.repository.defaultBranch, prefix);
+    }
+    /**
+     * Returns a list of paths to all files with a given file
+     * extension.
+     *
+     * If a prefix is specified, only return paths that match
+     * the provided prefix.
+     *
+     * @param extension The file extension used to filter results.
+     *   Example: `js`, `java`
+     * @param ref Git reference to search files in
+     * @param prefix Optional path prefix used to filter results
+     * @returns {string[]} List of file paths
+     * @throws {GitHubAPIError} on an API error
+     */
+    async findFilesByExtensionAndRef(extension, ref, prefix) {
+        this.logger.debug(`Looking in local clone for file matching extension ${extension} with ref ${ref} and prefix '${prefix}'`);
+        let normalizedPrefix = prefix
+            ? prefix.replace(/^[/\\]/, '').replace(/[/\\]$/, '')
+            : '';
+        if (normalizedPrefix === manifest_1.ROOT_PROJECT_PATH) {
+            normalizedPrefix = '';
+        }
+        const treePath = normalizedPrefix ? `${normalizedPrefix}/` : '.';
+        const resolvedRef = await this.ensureRef(ref);
+        const matchedPaths = [];
+        await this.execGitStream(['ls-tree', '-r', '--name-only', resolvedRef, treePath], line => {
+            const trimmed = line.trim();
+            if (trimmed && trimmed.endsWith(`.${extension}`)) {
+                matchedPaths.push(trimmed);
+            }
+        });
+        if (normalizedPrefix) {
+            return matchedPaths
+                .map(p => {
+                if (p === normalizedPrefix)
+                    return '';
+                if (p.startsWith(`${normalizedPrefix}/`)) {
+                    return p.slice(normalizedPrefix.length + 1);
+                }
+                return p;
+            })
+                .filter(p => p !== '');
+        }
+        return matchedPaths;
+    }
+    /**
+     * Returns the list of commits to the default branch after the provided filter
+     * query has been satified.
+     *
+     * @param {string} targetBranch Target branch of commit
+     * @param {CommitFilter} filter Callback function that returns whether a
+     *   commit/pull request matches certain criteria
+     * @param {CommitIteratorOptions} options Query options
+     * @param {number} options.maxResults Limit the number of results searched.
+     *   Defaults to unlimited.
+     * @param {boolean} options.backfillFiles If set, use the REST API for
+     *   fetching the list of touched files in this commit. Defaults to `false`.
+     * @returns {Commit[]} List of commits to current branch
+     * @throws {GitHubAPIError} on an API error
+     */
+    async commitsSince(targetBranch, filter, options) {
+        const commits = [];
+        const generator = this.mergeCommitIterator(targetBranch, options);
+        for await (const commit of generator) {
+            if (filter(commit)) {
+                break;
+            }
+            commits.push(commit);
+        }
+        return commits;
+    }
+    /**
+     * Iterate through commit history with a max number of results scanned.
+     *
+     * @param {string} targetBranch target branch of commit
+     * @param {CommitIteratorOptions} options Query options
+     * @param {number} options.maxResults Limit the number of results searched.
+     *   Defaults to unlimited.
+     * @param {boolean} options.backfillFiles If set, use the REST API for
+     *   fetching the list of touched files in this commit. Defaults to `false`.
+     * @yields {Commit}
+     * @throws {GitHubAPIError} on an API error
+     */
+    async *mergeCommitIterator(targetBranch, options) {
+        var _a;
+        this.logger.debug(`Looking in local clone for commits on branch ${targetBranch}`);
+        const backfillFiles = (_a = options === null || options === void 0 ? void 0 : options.backfillFiles) !== null && _a !== void 0 ? _a : true;
+        let format = '---COMMIT_START---%n%H%n%B';
+        if (backfillFiles) {
+            format += '%n---FILES_START---';
+        }
+        const ref = await this.ensureRef(targetBranch);
+        const args = ['log', ref, `--pretty=format:${format}`];
+        if (backfillFiles) {
+            args.push('--name-only');
+        }
+        if (options === null || options === void 0 ? void 0 : options.maxResults) {
+            args.push('-n', options.maxResults.toString());
+        }
+        const { stdout } = await execFile('git', args, {
+            cwd: this.cloneDir,
+            maxBuffer: 100 * 1024 * 1024,
+        });
+        const blocks = stdout.split('---COMMIT_START---\n');
+        for (const block of blocks) {
+            if (!block.trim())
+                continue;
+            let commitInfo = block;
+            let files = [];
+            if (backfillFiles) {
+                const parts = block.split('\n---FILES_START---\n');
+                commitInfo = parts[0];
+                if (parts[1]) {
+                    files = parts[1]
+                        .split('\n')
+                        .map((f) => f.trim())
+                        .filter((f) => f);
+                }
+            }
+            const lines = commitInfo.split('\n');
+            const sha = lines[0].trim();
+            const message = lines.slice(1).join('\n').trim();
+            if (!sha)
+                continue;
+            const commit = {
+                sha,
+                message,
+                files: backfillFiles ? files : undefined,
+            };
+            const subject = lines[1] ? lines[1].trim() : '';
+            let prNumber;
+            let headBranchName = '';
+            const squashMatch = subject.match(/\s\(#(\d+)\)$/);
+            const mergeMatch = subject.match(/^Merge pull request #(\d+) from (.*)$/);
+            if (squashMatch) {
+                prNumber = parseInt(squashMatch[1], 10);
+            }
+            else if (mergeMatch) {
+                prNumber = parseInt(mergeMatch[1], 10);
+                headBranchName = mergeMatch[2].trim();
+            }
+            if (prNumber) {
+                commit.pullRequest = {
+                    sha,
+                    number: prNumber,
+                    title: subject.replace(/\s\(#(\d+)\)$/, ''),
+                    body: message,
+                    labels: [],
+                    files: backfillFiles ? files : [],
+                    baseBranchName: targetBranch,
+                    headBranchName,
+                };
+            }
+            yield commit;
+        }
+    }
+    /**
+     * Iterate through merged pull requests with a max number of results scanned.
+     *
+     * @param {string} targetBranch The base branch of the pull request
+     * @param {string} status The status of the pull request
+     * @param {number} maxResults Limit the number of results searched. Defaults to
+     *   unlimited.
+     * @param {boolean} includeFiles Whether to fetch the list of files included in
+     *   the pull request. Defaults to `true`.
+     * @yields {PullRequest}
+     * @throws {GitHubAPIError} on an API error
+     */
+    async *pullRequestIterator(targetBranch, status, maxResults, includeFiles) {
+        yield* this.gitHubApi.pullRequestIterator(targetBranch, status, maxResults, includeFiles);
+    }
+    /**
+     * Iterate through releases with a max number of results scanned.
+     *
+     * @param {ReleaseIteratorOptions} options Query options
+     * @param {number} options.maxResults Limit the number of results searched.
+     *   Defaults to unlimited.
+     * @yields {GitHubRelease}
+     * @throws {GitHubAPIError} on an API error
+     */
+    async *releaseIterator(options) {
+        yield* this.gitHubApi.releaseIterator(options);
+    }
+    /**
+     * Iterate through tags with a max number of results scanned.
+     *
+     * @param {TagIteratorOptions} options Query options
+     * @param {number} options.maxResults Limit the number of results searched.
+     *   Defaults to unlimited.
+     * @yields {GitHubTag}
+     * @throws {GitHubAPIError} on an API error
+     */
+    async *tagIterator(options) {
+        const { stdout } = await execFile('git', [
+            'for-each-ref',
+            '--sort=-version:refname',
+            'refs/tags',
+            '--format=%(refname:short)|%(objectname)|%(*objectname)',
+        ], { cwd: this.cloneDir });
+        const maxResults = (options === null || options === void 0 ? void 0 : options.maxResults) || Number.MAX_SAFE_INTEGER;
+        let results = 0;
+        for (const line of stdout.split('\n')) {
+            if (!line)
+                continue;
+            const [name, objectSha, commitSha] = line.split('|');
+            const sha = commitSha || objectSha;
+            if (sha) {
+                yield { name, sha };
+                results++;
+                if (results >= maxResults)
+                    break;
+            }
+        }
+    }
+    async applyEditsAndPush(branch, targetBranch, message, changes) {
+        this.logger.debug(`Applying edits and pushing to ${branch}`);
+        // Checkout/Reset PR branch
+        await execFile('git', ['fetch', 'origin', '--', targetBranch], {
+            cwd: this.cloneDir,
+        });
+        await execFile('git', ['checkout', '-B', branch, `origin/${targetBranch}`], {
+            cwd: this.cloneDir,
+        });
+        // Write file edits
+        for (const [filePath, fileUpdate] of changes.entries()) {
+            const fullPath = path.join(this.cloneDir, filePath);
+            await fs.promises.mkdir(path.dirname(fullPath), { recursive: true });
+            if (fileUpdate.content !== null) {
+                await fs.promises.writeFile(fullPath, fileUpdate.content);
+            }
+            else {
+                await fs.promises.unlink(fullPath).catch(() => { });
+            }
+            if (fileUpdate.mode) {
+                await fs.promises.chmod(fullPath, parseInt(fileUpdate.mode, 8));
+            }
+        }
+        // Commit changes
+        const msgFile = path.join(os.tmpdir(), `release-please-commit-msg-${process.pid}-${Date.now()}`);
+        await fs.promises.writeFile(msgFile, message);
+        await execFile('git', ['add', '.'], { cwd: this.cloneDir });
+        try {
+            await execFile('git', ['commit', '-F', msgFile], { cwd: this.cloneDir });
+        }
+        catch (err) {
+            const error = err;
+            if (error.stdout && error.stdout.includes('nothing to commit')) {
+                this.logger.debug('Nothing to commit');
+            }
+            else {
+                throw err;
+            }
+        }
+        finally {
+            await fs.promises.unlink(msgFile).catch(() => { });
+        }
+        // Push transit
+        await execFile('git', ['push', '-f', 'origin', branch], {
+            cwd: this.cloneDir,
+        });
+    }
+    /**
+     * Open a pull request
+     *
+     * @param {PullRequest} pullRequest Pull request data to update
+     * @param {string} targetBranch The base branch of the pull request
+     * @param {string} message The commit message for the commit
+     * @param {Update[]} updates The files to update
+     * @param {CreatePullRequestOptions} options The pull request options
+     * @throws {GitHubAPIError} on an API error
+     */
+    async createPullRequest(pullRequest, targetBranch, message, updates, options) {
+        const changes = await this.buildChangeSet(updates, targetBranch);
+        await this.applyEditsAndPush(pullRequest.headBranchName, targetBranch, message, changes);
+        this.logger.info('Creating pull request via GitHub API...');
+        return await this.gitHubApi.createPullRequest(pullRequest, targetBranch, options);
+    }
+    /**
+     * Update a pull request's title and body.
+     * @param {number} number The pull request number
+     * @param {ReleasePullRequest} releasePullRequest Pull request data to update
+     * @param {string} targetBranch The target branch of the pull request
+     * @param {string} options.signoffUser Optional. Commit signoff message
+     * @param {boolean} options.fork Optional. Whether to open the pull request from
+     *   a fork or not. Defaults to `false`
+     * @param {PullRequestOverflowHandler} options.pullRequestOverflowHandler Optional.
+     *   Handles extra large pull request body messages.
+     */
+    async updatePullRequest(number, pullRequest, targetBranch, options) {
+        const changes = await this.buildChangeSet(pullRequest.updates, targetBranch);
+        const message = pullRequest.title.toString();
+        await this.applyEditsAndPush(pullRequest.headRefName, targetBranch, message, changes);
+        const body = ((options === null || options === void 0 ? void 0 : options.pullRequestOverflowHandler)
+            ? await options.pullRequestOverflowHandler.handleOverflow(pullRequest)
+            : pullRequest.body)
+            .toString()
+            .slice(0, github_api_1.MAX_ISSUE_BODY_SIZE);
+        const pullResponseData = (await this.gitHubApi.octokit.pulls.update({
+            owner: this.repository.owner,
+            repo: this.repository.repo,
+            pull_number: number,
+            title: pullRequest.title.toString(),
+            body,
+            state: 'open',
+        })).data;
+        return {
+            headBranchName: pullResponseData.head.ref,
+            baseBranchName: pullResponseData.base.ref,
+            number: pullResponseData.number,
+            title: pullResponseData.title,
+            body: pullResponseData.body || '',
+            files: [],
+            labels: pullResponseData.labels
+                .map((label) => label.name)
+                .filter((name) => !!name),
+        };
+    }
+    async getPullRequest(number) {
+        return await this.gitHubApi.getPullRequest(number);
+    }
+    /**
+     * Create a GitHub release
+     *
+     * @param {Release} release Release parameters
+     * @param {ReleaseOptions} options Release option parameters
+     * @throws {DuplicateReleaseError} if the release tag already exists
+     * @throws {GitHubAPIError} on other API errors
+     */
+    async createRelease(release, options) {
+        return await this.gitHubApi.createRelease(release, options);
+    }
+    /**
+     * Makes a comment on a issue/pull request.
+     *
+     * @param {string} comment - The body of the comment to post.
+     * @param {number} number - The issue or pull request number.
+     * @throws {GitHubAPIError} on an API error
+     */
+    async commentOnIssue(comment, number) {
+        return await this.gitHubApi.commentOnIssue(comment, number);
+    }
+    /**
+     * Removes labels from an issue/pull request.
+     *
+     * @param {string[]} labels The labels to remove.
+     * @param {number} number The issue/pull request number.
+     */
+    async removeIssueLabels(labels, number) {
+        return await this.gitHubApi.removeIssueLabels(labels, number);
+    }
+    /**
+     * Adds label to an issue/pull request.
+     *
+     * @param {string[]} labels The labels to add.
+     * @param {number} number The issue/pull request number.
+     */
+    async addIssueLabels(labels, number) {
+        return await this.gitHubApi.addIssueLabels(labels, number);
+    }
+    /**
+     * Generate release notes from GitHub at tag
+     * @param {string} tagName Name of new release tag
+     * @param {string} targetCommitish Target commitish for new tag
+     * @param {string} previousTag Optional. Name of previous tag to analyze commits since
+     */
+    async generateReleaseNotes(tagName, targetCommitish, previousTag) {
+        return await this.gitHubApi.generateReleaseNotes(tagName, targetCommitish, previousTag);
+    }
+    /**
+     * Create a single file on a new branch based on an existing
+     * branch. This will force-push to that branch.
+     * @param {string} filename Filename with path in the repository
+     * @param {string} contents Contents of the file
+     * @param {string} newBranchName Name of the new branch
+     * @param {string} baseBranchName Name of the base branch (where
+     *   new branch is forked from)
+     * @returns {string} HTML URL of the new file
+     */
+    async createFileOnNewBranch(filename, contents, newBranchName, baseBranchName) {
+        return await this.gitHubApi.createFileOnNewBranch(filename, contents, newBranchName, baseBranchName);
+    }
+    /**
+     * Given a set of proposed updates, build a changeset to suggest.
+     *
+     * @param {Update[]} updates The proposed updates
+     * @param {string} defaultBranch The target branch
+     * @return {Changes} The changeset to suggest.
+     * @throws {GitHubAPIError} on an API error
+     */
+    async buildChangeSet(updates, defaultBranch) {
+        const mergedUpdates = (0, composite_1.mergeUpdates)(updates);
+        const changes = new Map();
+        for (const update of mergedUpdates) {
+            let content;
+            try {
+                content = await this.getFileContentsOnBranch(update.path, defaultBranch);
+            }
+            catch (err) {
+                if (!(err instanceof errors_1.FileNotFoundError))
+                    throw err;
+                if (!update.createIfMissing) {
+                    console.warn(`file ${update.path} did not exist`);
+                    continue;
+                }
+            }
+            const newContents = update.updater.updateContent(content ? content.parsedContent : undefined);
+            if (newContents) {
+                changes.set(update.path, {
+                    content: newContents,
+                    originalContent: content ? content.parsedContent : null,
+                    mode: content ? content.mode : git_file_utils_1.DEFAULT_FILE_MODE,
+                });
+            }
+        }
+        return changes;
+    }
+}
+exports.LocalGitHub = LocalGitHub;
+function globToRegex(glob) {
+    let reg = '';
+    let i = 0;
+    while (i < glob.length) {
+        const c = glob[i];
+        if (c === '*') {
+            if (i + 1 < glob.length && glob[i + 1] === '*') {
+                if (i + 2 < glob.length && glob[i + 2] === '/') {
+                    reg += '(?:.*\\/)?';
+                    i += 2;
+                }
+                else {
+                    reg += '.*';
+                    i++;
+                }
+            }
+            else {
+                reg += '[^/]*';
+            }
+        }
+        else if (c === '?') {
+            reg += '[^/]';
+        }
+        else if (['.', '+', '^', '$', '{', '}', '(', ')', '|', '[', ']', '\\'].includes(c)) {
+            reg += '\\' + c;
+        }
+        else {
+            reg += c;
+        }
+        i++;
+    }
+    return new RegExp(`^${reg}$`);
+}
+//# sourceMappingURL=local-github.js.map