release-please 17.8.0 → 17.10.0

package/README.md

@@ -3,7 +3,7 @@
 # [Release Please](https://github.com/googleapis/release-please)
 
 [![npm version](https://img.shields.io/npm/v/release-please.svg)](https://www.npmjs.org/package/release-please)
-[![codecov](https://img.shields.io/codecov/c/github/googleapis/release-please/main.svg?style=flat)](https://codecov.io/gh/googleapis/release-please)
+[![codecov](https://codecov.io/gh/googleapis/release-please/graph/badge.svg)](https://codecov.io/gh/googleapis/release-please)
 
 Release Please automates CHANGELOG generation, the creation of GitHub releases,
 and version bumps for your projects.

package/build/src/github-api.d.ts

@@ -1,6 +1,6 @@
 import { Octokit } from '@octokit/rest';
 import { request } from '@octokit/request';
-import { Logger } from 'code-suggester/build/src/types';
+import { Logger } from './util/code-suggester/types';
 import { PullRequest } from './pull-request';
 import { Repository } from './repository';
 import { Release } from './release';

package/build/src/github.d.ts

@@ -9,7 +9,7 @@ import { Update } from './update';
 import { Release } from './release';
 import { GitHubApi, GitHubCreateOptions } from './github-api';
 import { GitHubFileContents } from '@google-automations/git-file-utils';
-import { Logger } from 'code-suggester/build/src/types';
+import { Logger } from './util/code-suggester/types';
 import { Scm, ScmChangeSet, ScmCommitIteratorOptions, ScmReleaseIteratorOptions, ScmTagIteratorOptions, ScmCreatePullRequestOptions, ScmReleaseOptions, ScmRelease, ScmTag, ScmUpdatePullRequestOptions } from './scm';
 type RequestBuilderType = typeof request;
 type DefaultFunctionType = RequestBuilderType['defaults'];

package/build/src/github.js

@@ -15,7 +15,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.sleepInMs = exports.GitHub = void 0;
 const request_error_1 = require("@octokit/request-error");
-const code_suggester_1 = require("code-suggester");
+const code_suggester_1 = require("./util/code-suggester");
 const errors_1 = require("./errors");
 const MAX_ISSUE_BODY_SIZE = 65536;
 const MAX_SLEEP_SECONDS = 20;

package/build/src/index.d.ts

@@ -14,4 +14,4 @@ export { Logger, setLogger } from './util/logger';
 export { GitHub } from './github';
 export declare const configSchema: any;
 export declare const manifestSchema: any;
-export declare const VERSION = "17.8.0";
+export declare const VERSION = "17.10.0";

package/build/src/index.js

@@ -36,6 +36,6 @@ Object.defineProperty(exports, "GitHub", { enumerable: true, get: function () {
 exports.configSchema = require('../../schemas/config.json');
 exports.manifestSchema = require('../../schemas/manifest.json');
 // x-release-please-start-version
-exports.VERSION = '17.8.0';
+exports.VERSION = '17.10.0';
 // x-release-please-end
 //# sourceMappingURL=index.js.map

package/build/src/local-github.d.ts

@@ -7,7 +7,7 @@ import { Update } from './update';
 import { Release } from './release';
 import { GitHubFileContents } from '@google-automations/git-file-utils';
 import { GitHubApi, GitHubCreateOptions } from './github-api';
-import { Logger } from 'code-suggester/build/src/types';
+import { Logger } from './util/code-suggester/types';
 export interface LocalGitHubCreateOptions extends GitHubCreateOptions {
     cloneDepth?: number;
     localRepoPath?: string;

package/build/src/local-github.js

@@ -20,7 +20,7 @@ const os = require("os");
 const child_process = require("child_process");
 const util = require("util");
 const readline = require("readline");
-const code_suggester_1 = require("code-suggester");
+const code_suggester_1 = require("./util/code-suggester");
 const execFile = util.promisify(child_process.execFile);
 const mkdtemp = fs.promises.mkdtemp;
 const errors_1 = require("./errors");

package/build/src/manifest.js

@@ -211,26 +211,28 @@ class Manifest {
                 continue;
             }
             const component = tagName.component || exports.DEFAULT_COMPONENT_NAME;
-            const path = pathsByComponent[component];
-            if (!path) {
+            const paths = pathsByComponent[component] || [];
+            if (paths.length === 0) {
                 this.logger.warn(`Found release tag with component '${component}', but not configured in manifest`);
                 continue;
             }
-            const expectedVersion = this.releasedVersions[path];
-            if (!expectedVersion) {
-                this.logger.warn(`Unable to find expected version for path '${path}' in manifest`);
-                continue;
-            }
-            if (expectedVersion.toString() === tagName.version.toString()) {
-                this.logger.debug(`Found release for path ${path}, ${release.tagName}`);
-                releaseShasByPath[path] = release.sha;
-                releasesByPath[path] = {
-                    name: release.name,
-                    tag: tagName,
-                    sha: release.sha,
-                    notes: release.notes || '',
-                };
-                releasesFound += 1;
+            for (const path of paths) {
+                const expectedVersion = this.releasedVersions[path];
+                if (!expectedVersion) {
+                    this.logger.warn(`Unable to find expected version for path '${path}' in manifest`);
+                    continue;
+                }
+                if (expectedVersion.toString() === tagName.version.toString()) {
+                    this.logger.debug(`Found release for path ${path}, ${release.tagName}`);
+                    releaseShasByPath[path] = release.sha;
+                    releasesByPath[path] = {
+                        name: release.name,
+                        tag: tagName,
+                        sha: release.sha,
+                        notes: release.notes || '',
+                    };
+                    releasesFound += 1;
+                }
             }
             if (releasesFound >= expectedReleases) {
                 break;
@@ -793,10 +795,10 @@ class Manifest {
             for (const path in this.repositoryConfig) {
                 const strategy = strategiesByPath[path];
                 const component = (await strategy.getComponent()) || '';
-                if (this._pathsByComponent[component]) {
-                    this.logger.warn(`Multiple paths for ${component}: ${this._pathsByComponent[component]}, ${path}`);
+                if (!this._pathsByComponent[component]) {
+                    this._pathsByComponent[component] = [];
                 }
-                this._pathsByComponent[component] = path;
+                this._pathsByComponent[component].push(path);
             }
         }
         return this._pathsByComponent;

package/build/src/plugins/linked-versions.js

@@ -123,7 +123,7 @@ class LinkedVersions extends plugin_1.ManifestPlugin {
         // delegate to the merge plugin and add merged pull request
         if (inScopeCandidates.length > 0) {
             const merge = new merge_1.Merge(this.github, this.targetBranch, this.repositoryConfig, {
-                pullRequestTitlePattern: `chore\${scope}: release ${this.groupName} libraries`,
+                pullRequestTitlePattern: 'chore${scope}: release ' + this.groupName + ' libraries',
                 forceMerge: true,
                 headBranchName: branch_name_1.BranchName.ofGroupTargetBranch(this.groupName, this.targetBranch).toString(),
             });

package/build/src/strategies/base.js

@@ -373,6 +373,14 @@ class BaseStrategy {
             this.logger.error(`Bad branch name: ${mergedPullRequest.headBranchName}`);
             return;
         }
+        const branchComponent = await this.getBranchComponent();
+        if (branchName.isComponent()) {
+            if (this.normalizeComponent(branchName.component) !==
+                this.normalizeComponent(branchComponent)) {
+                this.logger.info(`PR branch component: ${branchName.component} does not match configured branch component: ${branchComponent}`);
+                return;
+            }
+        }
         const pullRequestBody = await this.parsePullRequestBody(mergedPullRequest.body);
         if (!pullRequestBody) {
             this.logger.error('Could not parse pull request body as a release PR');

package/build/src/strategies/go-librarian.d.ts

@@ -4,6 +4,8 @@ import { Version } from '../version';
 export declare class GoLibrarian extends BaseStrategy {
     readonly versionFile: string;
     constructor(options: BaseStrategyOptions);
+    getComponent(): Promise<string | undefined>;
+    getBranchComponent(): Promise<string | undefined>;
     protected buildUpdates(options: BuildUpdatesOptions): Promise<Update[]>;
     protected initialReleaseVersion(): Version;
 }

package/build/src/strategies/go-librarian.js

@@ -26,6 +26,20 @@ class GoLibrarian extends base_1.BaseStrategy {
         super(options);
         this.versionFile = (_b = options.versionFile) !== null && _b !== void 0 ? _b : 'internal/version.go';
     }
+    async getComponent() {
+        const component = await super.getComponent();
+        if (component) {
+            const match = component.match(/^(.*)\/v[2-9]\d*$/);
+            if (match) {
+                return match[1];
+            }
+        }
+        return component;
+    }
+    async getBranchComponent() {
+        const component = await super.getBranchComponent();
+        return component ? component.replace(/\//g, '-') : undefined;
+    }
     async buildUpdates(options) {
         const updates = [];
         const version = options.newVersion;
@@ -63,7 +77,7 @@ class GoLibrarian extends base_1.BaseStrategy {
         if (this.initialVersion) {
             return version_1.Version.parse(this.initialVersion);
         }
-        return version_1.Version.parse('1.0.0');
+        return version_1.Version.parse('0.1.0');
     }
 }
 exports.GoLibrarian = GoLibrarian;

package/build/src/updaters/librarian-yaml.d.ts

@@ -4,11 +4,16 @@ export interface JavaModule {
     artifact_id: string;
     [key: string]: any;
 }
+export interface PreviewModule {
+    version: string;
+    [key: string]: any;
+}
 export interface LibrarianLibrary {
     name: string;
     version: string;
     output?: string;
     java?: JavaModule;
+    preview?: PreviewModule;
     [key: string]: any;
 }
 export interface LibrarianYamlSchema {
@@ -35,4 +40,6 @@ export declare class LibrarianYamlUpdater extends DefaultUpdater {
     updateContent(content: string, _logger?: Logger): string;
     private deriveOutputDirectory;
     private findArtifactID;
+    private getOrCreateSubsection;
+    private updateValue;
 }

package/build/src/updaters/librarian-yaml.js

@@ -35,6 +35,7 @@ class LibrarianYamlUpdater extends default_1.DefaultUpdater {
      * @returns {string} The updated content
      */
     updateContent(content, _logger = logger_1.logger) {
+        var _a;
         const doc = yaml.parseDocument(content);
         if (!doc || doc.errors.length > 0) {
             throw new Error(`Invalid yaml, cannot be parsed: ${doc.errors
@@ -51,6 +52,7 @@ class LibrarianYamlUpdater extends default_1.DefaultUpdater {
                 continue;
             const libraryJSON = library.toJSON();
             let newVersion = undefined;
+            let isPreview = false;
             if (this.versionsMap) {
                 // Multi-version (Java style)
                 const artifactID = this.findArtifactID(libraryJSON);
@@ -60,33 +62,42 @@ class LibrarianYamlUpdater extends default_1.DefaultUpdater {
             }
             else {
                 // Single version (Go, Python, Node style)
-                const isGoMatch = (this.packagePath && libraryJSON.name === this.packagePath) ||
-                    (this.component && libraryJSON.name === this.component);
-                const isPythonNodeMatch = this.packagePath &&
-                    this.deriveOutputDirectory(libraryJSON) === this.packagePath;
-                if (isGoMatch || isPythonNodeMatch) {
+                const isGoPreviewMatch = this.packagePath &&
+                    this.packagePath === `preview/internal/${libraryJSON.name}`;
+                const isPythonPreviewMatch = this.packagePath &&
+                    this.packagePath === `preview-packages/${libraryJSON.name}`;
+                if (isGoPreviewMatch || isPythonPreviewMatch) {
+                    isPreview = true;
                     newVersion = this.version;
                 }
+                else {
+                    const isGoMatch = (this.packagePath && libraryJSON.name === this.packagePath) ||
+                        (this.component && libraryJSON.name === this.component);
+                    const isPythonNodeMatch = this.packagePath &&
+                        this.deriveOutputDirectory(libraryJSON) === this.packagePath;
+                    if (isGoMatch || isPythonNodeMatch) {
+                        newVersion = this.version;
+                    }
+                }
             }
             if (newVersion) {
                 const newVersionStr = newVersion.toString();
-                if (library.get('version') !== newVersionStr) {
-                    library.set('version', newVersionStr);
-                    modified = true;
+                if (isPreview) {
+                    const previewNode = this.getOrCreateSubsection(library, 'preview', doc);
+                    if (this.updateValue(previewNode, 'version', newVersionStr)) {
+                        modified = true;
+                    }
                 }
-                if (this.versionsMap) {
-                    const isSnapshot = newVersion.preRelease === 'SNAPSHOT';
-                    if (!isSnapshot) {
-                        let java = library.get('java');
-                        if (!yaml.isMap(java)) {
-                            const javaNode = doc.createNode({});
-                            library.set('java', javaNode);
-                            java = javaNode;
-                            modified = true;
-                        }
-                        if (yaml.isMap(java)) {
-                            if (java.get('released_version') !== newVersionStr) {
-                                java.set('released_version', newVersionStr);
+                else {
+                    if (this.updateValue(library, 'version', newVersionStr)) {
+                        modified = true;
+                    }
+                    if (this.versionsMap) {
+                        // Multi-version (Java style): updates released_version for non-SNAPSHOTs
+                        const isSnapshot = !!((_a = newVersion.preRelease) === null || _a === void 0 ? void 0 : _a.includes('SNAPSHOT'));
+                        if (!isSnapshot) {
+                            const javaNode = this.getOrCreateSubsection(library, 'java', doc);
+                            if (this.updateValue(javaNode, 'released_version', newVersionStr)) {
                                 modified = true;
                             }
                         }
@@ -115,6 +126,21 @@ class LibrarianYamlUpdater extends default_1.DefaultUpdater {
         }
         return `google-cloud-${library.name}`;
     }
+    getOrCreateSubsection(parent, key, doc) {
+        let section = parent.get(key);
+        if (!yaml.isMap(section)) {
+            section = doc.createNode({});
+            parent.set(key, section);
+        }
+        return section;
+    }
+    updateValue(node, key, value) {
+        if (node.get(key) !== value) {
+            node.set(key, value);
+            return true;
+        }
+        return false;
+    }
 }
 exports.LibrarianYamlUpdater = LibrarianYamlUpdater;
 //# sourceMappingURL=librarian-yaml.js.map

package/build/src/util/branch-name.d.ts

@@ -16,4 +16,5 @@ export declare class BranchName {
     getComponent(): string | undefined;
     getVersion(): Version | undefined;
     toString(): string;
+    isComponent(): boolean;
 }

package/build/src/util/branch-name.js

@@ -78,6 +78,9 @@ class BranchName {
     toString() {
         return '';
     }
+    isComponent() {
+        return false;
+    }
 }
 exports.BranchName = BranchName;
 /**
@@ -156,6 +159,9 @@ class V12ComponentBranchName extends BranchName {
     toString() {
         return `${RELEASE_PLEASE}/branches/${this.targetBranch}/components/${this.component}`;
     }
+    isComponent() {
+        return true;
+    }
 }
 const DEFAULT_PATTERN = `^${RELEASE_PLEASE}--branches--(?<branch>.+)$`;
 class DefaultBranchName extends BranchName {
@@ -189,6 +195,9 @@ class ComponentBranchName extends BranchName {
     toString() {
         return `${RELEASE_PLEASE}--branches--${this.targetBranch}--components--${this.component}`;
     }
+    isComponent() {
+        return true;
+    }
 }
 const GROUP_PATTERN = `^${RELEASE_PLEASE}--branches--(?<branch>.+)--groups--(?<group>.+)$`;
 class GroupBranchName extends BranchName {

package/build/src/util/code-suggester/default-options-handler.d.ts

@@ -0,0 +1,10 @@
+import { CreatePullRequest, CreatePullRequestUserOptions } from './types';
+/**
+ * Add defaults to GitHub Pull Request options.
+ * Preserves the empty string.
+ * For ESCMAScript, null/undefined values are preserved for required fields.
+ * Recommended with an object validation function to check empty strings and incorrect types.
+ * @param {PullRequestUserOptions} options the user-provided github pull request options
+ * @returns {CreatePullRequest} git hub context with defaults applied
+ */
+export declare function addPullRequestDefaults(options: CreatePullRequestUserOptions): CreatePullRequest;

package/build/src/util/code-suggester/default-options-handler.js

@@ -0,0 +1,45 @@
+"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
+//
+//     https://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.addPullRequestDefaults = void 0;
+const DEFAULT_BRANCH_NAME = 'code-suggestions';
+const DEFAULT_PRIMARY_BRANCH = 'main';
+/**
+ * Add defaults to GitHub Pull Request options.
+ * Preserves the empty string.
+ * For ESCMAScript, null/undefined values are preserved for required fields.
+ * Recommended with an object validation function to check empty strings and incorrect types.
+ * @param {PullRequestUserOptions} options the user-provided github pull request options
+ * @returns {CreatePullRequest} git hub context with defaults applied
+ */
+function addPullRequestDefaults(options) {
+    const pullRequestSettings = {
+        upstreamOwner: options.upstreamOwner,
+        upstreamRepo: options.upstreamRepo,
+        description: options.description,
+        title: options.title,
+        message: options.message,
+        force: options.force || false,
+        branch: typeof options.branch === 'string' ? options.branch : DEFAULT_BRANCH_NAME,
+        primary: typeof options.primary === 'string'
+            ? options.primary
+            : DEFAULT_PRIMARY_BRANCH,
+        maintainersCanModify: options.maintainersCanModify === false ? false : true,
+        filesPerCommit: options.filesPerCommit,
+    };
+    return pullRequestSettings;
+}
+exports.addPullRequestDefaults = addPullRequestDefaults;
+//# sourceMappingURL=default-options-handler.js.map

package/build/src/util/code-suggester/errors.d.ts

@@ -0,0 +1,4 @@
+export declare class CommitError extends Error {
+    cause: Error;
+    constructor(message: string, cause: Error);
+}

package/build/src/util/code-suggester/errors.js

@@ -0,0 +1,24 @@
+"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
+//
+//     https://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.CommitError = void 0;
+class CommitError extends Error {
+    constructor(message, cause) {
+        super(message);
+        this.cause = cause;
+    }
+}
+exports.CommitError = CommitError;
+//# sourceMappingURL=errors.js.map

package/build/src/util/code-suggester/github/branch.d.ts

@@ -0,0 +1,45 @@
+import { RepoDomain } from '../types';
+import { Octokit } from '@octokit/rest';
+/**
+ * Create a new branch reference with the ref prefix
+ * @param {string} branchName name of the branch
+ */
+export declare function createRef(branchName: string): string;
+/**
+ * get branch commit HEAD SHA of a repository
+ * Throws an error if the branch cannot be found
+ * @param {Octokit} octokit The authenticated octokit instance
+ * @param {RepoDomain} origin The domain information of the remote origin repository
+ * @param {string} branch the name of the branch
+ * @returns {Promise<string>} branch commit HEAD SHA
+ */
+export declare function getBranchHead(octokit: Octokit, origin: RepoDomain, branch: string): Promise<string>;
+/**
+ * Determine if there is a branch with the provided name in the remote GitHub repository
+ * @param {Octokit} octokit The authenticated octokit instance
+ * @param {RepoDomain} remote The domain information of the remote repository
+ * @param {string} name The branch name to create on the repository
+ * @returns {Promise<boolean>} if there is a branch already existing in the remote GitHub repository
+ */
+export declare function existsBranchWithName(octokit: Octokit, remote: RepoDomain, name: string): Promise<boolean>;
+/**
+ * Create a branch on the remote repository if there is not an existing branch
+ * @param {Octokit} octokit The authenticated octokit instance
+ * @param {RepoDomain} remote The domain information of the remote origin repository
+ * @param {string} name The branch name to create on the origin repository
+ * @param {string} baseSha the sha that the base of the reference points to
+ * @param {boolean} duplicate whether there is an existing branch or not
+ * @returns {Promise<void>}
+ */
+export declare function createBranch(octokit: Octokit, remote: RepoDomain, name: string, baseSha: string, duplicate: boolean): Promise<void>;
+/**
+ * Create a GitHub branch given a remote origin.
+ * Throws an exception if octokit fails, or if the base branch is invalid
+ * @param {Octokit} octokit The authenticated octokit instance
+ * @param {RepoDomain} origin The domain information of the remote origin repository
+ * @param {RepoDomain} upstream The domain information of the remote upstream repository
+ * @param {string} name The branch name to create on the origin repository
+ * @param {string} baseBranch the name of the branch to base the new branch off of. Default is main
+ * @returns {Promise<string>} the base SHA for subsequent commits to be based off for the origin branch
+ */
+export declare function branch(octokit: Octokit, origin: RepoDomain, upstream: RepoDomain, name: string, baseBranch?: string): Promise<string>;

package/build/src/util/code-suggester/github/branch.js

@@ -0,0 +1,118 @@
+"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
+//
+//     https://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.branch = exports.createBranch = exports.existsBranchWithName = exports.getBranchHead = exports.createRef = void 0;
+const logger_1 = require("../logger");
+const REF_PREFIX = 'refs/heads/';
+const DEFAULT_PRIMARY_BRANCH = 'main';
+/**
+ * Create a new branch reference with the ref prefix
+ * @param {string} branchName name of the branch
+ */
+function createRef(branchName) {
+    return REF_PREFIX + branchName;
+}
+exports.createRef = createRef;
+/**
+ * get branch commit HEAD SHA of a repository
+ * Throws an error if the branch cannot be found
+ * @param {Octokit} octokit The authenticated octokit instance
+ * @param {RepoDomain} origin The domain information of the remote origin repository
+ * @param {string} branch the name of the branch
+ * @returns {Promise<string>} branch commit HEAD SHA
+ */
+async function getBranchHead(octokit, origin, branch) {
+    const branchData = (await octokit.repos.getBranch({
+        owner: origin.owner,
+        repo: origin.repo,
+        branch,
+    })).data;
+    logger_1.logger.info(`Successfully found branch HEAD sha "${branchData.commit.sha}".`);
+    return branchData.commit.sha;
+}
+exports.getBranchHead = getBranchHead;
+/**
+ * Determine if there is a branch with the provided name in the remote GitHub repository
+ * @param {Octokit} octokit The authenticated octokit instance
+ * @param {RepoDomain} remote The domain information of the remote repository
+ * @param {string} name The branch name to create on the repository
+ * @returns {Promise<boolean>} if there is a branch already existing in the remote GitHub repository
+ */
+async function existsBranchWithName(octokit, remote, name) {
+    try {
+        const data = (await octokit.git.getRef({
+            owner: remote.owner,
+            repo: remote.repo,
+            ref: `heads/${name}`,
+        })).data;
+        return data.ref ? true : false;
+    }
+    catch (err) {
+        if (err.status === 404)
+            return false;
+        else
+            throw err;
+    }
+}
+exports.existsBranchWithName = existsBranchWithName;
+/**
+ * Create a branch on the remote repository if there is not an existing branch
+ * @param {Octokit} octokit The authenticated octokit instance
+ * @param {RepoDomain} remote The domain information of the remote origin repository
+ * @param {string} name The branch name to create on the origin repository
+ * @param {string} baseSha the sha that the base of the reference points to
+ * @param {boolean} duplicate whether there is an existing branch or not
+ * @returns {Promise<void>}
+ */
+async function createBranch(octokit, remote, name, baseSha, duplicate) {
+    if (!duplicate) {
+        const refData = (await octokit.git.createRef({
+            owner: remote.owner,
+            repo: remote.repo,
+            ref: createRef(name),
+            sha: baseSha,
+        })).data;
+        logger_1.logger.info(`Successfully created branch at ${refData.url}`);
+    }
+    else {
+        logger_1.logger.info('Skipping branch creation step...');
+    }
+}
+exports.createBranch = createBranch;
+/**
+ * Create a GitHub branch given a remote origin.
+ * Throws an exception if octokit fails, or if the base branch is invalid
+ * @param {Octokit} octokit The authenticated octokit instance
+ * @param {RepoDomain} origin The domain information of the remote origin repository
+ * @param {RepoDomain} upstream The domain information of the remote upstream repository
+ * @param {string} name The branch name to create on the origin repository
+ * @param {string} baseBranch the name of the branch to base the new branch off of. Default is main
+ * @returns {Promise<string>} the base SHA for subsequent commits to be based off for the origin branch
+ */
+async function branch(octokit, origin, upstream, name, baseBranch = DEFAULT_PRIMARY_BRANCH) {
+    // create branch from primary branch HEAD SHA
+    try {
+        const baseSha = await getBranchHead(octokit, upstream, baseBranch);
+        const duplicate = await existsBranchWithName(octokit, origin, name);
+        await createBranch(octokit, origin, name, baseSha, duplicate);
+        return baseSha;
+    }
+    catch (err) {
+        logger_1.logger.error('Error when creating branch');
+        throw err;
+    }
+}
+exports.branch = branch;
+//# sourceMappingURL=branch.js.map