release-please 13.0.0-candidate.4 → 13.0.2

package/README.md

@@ -75,6 +75,8 @@ The above commit message will contain:
   that it's a breaking change.
 3. an entry for the feature **"update encode to support unicode"**.
 
+> :warning: **Important:** The additional messages must be added to the bottom of the commit.
+
 ## How do I change the version number?
 
 When a commit to the main branch has `Release-As: x.x.x`(case insensitive) in the **commit body**, Release Please will open a new pull request for the specified version.
@@ -89,31 +91,25 @@ chore: release 2.0.0
 Release-As: 2.0.0
 ```
 
-## Release types supported
+## Strategy (Language) types supported
 
 Release Please automates releases for the following flavors of repositories:
 
 | release type            | description
 |-------------------|---------------------------------------------------------|
-| node              | [A Node.js repository, with a package.json and CHANGELOG.md](https://github.com/yargs/yargs) |
-| python            | [A Python repository, with a setup.py, setup.cfg, CHANGELOG.md](https://github.com/googleapis/python-storage) and optionally a pyproject.toml and a <project>/\_\_init\_\_.py |
-| terraform-module  | [A terraform module, with a version in the README.md, and a CHANGELOG.md](https://github.com/terraform-google-modules/terraform-google-project-factory) |
-| krm-blueprint     | [A kpt package, with 1 or more KRM files and a CHANGELOG.md](https://github.com/GoogleCloudPlatform/blueprints/tree/main/catalog/project) |
-| rust              | A Rust repository, with a Cargo.toml (either as a crate or workspace) and a CHANGELOG.md |
-| ocaml             | [An OCaml repository, containing 1 or more opam or esy files and a CHANGELOG.md](https://github.com/grain-lang/binaryen.ml) |
-| simple            | [A repository with a version.txt and a CHANGELOG.md](https://github.com/googleapis/gapic-generator) |
-| helm              | A repository with a Chart.yaml and a CHANGELOG.md |
-| elixir            | A repository with a mix.exs and a CHANGELOG.md |
-| dart              | A repository with a pubspec.yaml and a CHANGELOG.md |
-
-## Adding additional release types
-
-To add a new release type, simply use the existing [releasers](https://github.com/googleapis/release-please/tree/main/src/releasers) and [updaters](https://github.com/googleapis/release-please/tree/main/src/updaters)
-as a starting point.
-
-**releasers** describe the files that should be updated for a release.
-
-**updaters** describe how to update the version in these files.
+| `dart`              | A repository with a pubspec.yaml and a CHANGELOG.md |
+| `elixir`            | A repository with a mix.exs and a CHANGELOG.md |
+| `go`                | A repository with a CHANGELOG.md |
+| `helm`              | A repository with a Chart.yaml and a CHANGELOG.md |
+| `krm-blueprint`     | [A kpt package, with 1 or more KRM files and a CHANGELOG.md](https://github.com/GoogleCloudPlatform/blueprints/tree/main/catalog/project) |
+| `node`              | [A Node.js repository, with a package.json and CHANGELOG.md](https://github.com/yargs/yargs) |
+| `ocaml`             | [An OCaml repository, containing 1 or more opam or esy files and a CHANGELOG.md](https://github.com/grain-lang/binaryen.ml) |
+| `php`               | A repository with a composer.json and a CHANGELOG.md |
+| `python`            | [A Python repository, with a setup.py, setup.cfg, CHANGELOG.md](https://github.com/googleapis/python-storage) and optionally a pyproject.toml and a <project>/\_\_init\_\_.py |
+| `ruby`              | A repository with a version.rb and a CHANGELOG.md |
+| `rust`              | A Rust repository, with a Cargo.toml (either as a crate or workspace) and a CHANGELOG.md |
+| `simple`            | [A repository with a version.txt and a CHANGELOG.md](https://github.com/googleapis/gapic-generator) |
+| `terraform-module`  | [A terraform module, with a version in the README.md, and a CHANGELOG.md](https://github.com/terraform-google-modules/terraform-google-project-factory) |
 
 ## Setting up Release Please
 
@@ -121,128 +117,34 @@ There are a variety of ways you can deploy release-please:
 
 ### GitHub Action (recommended)
 
-The easiest way to run release please is as a GitHub action:
-
-1. If you haven't already done so, create a `.github/workflows` folder in your
-  repository (_this is where your actions will live_).
-2. Now create a `.github/workflows/release-please.yml` file with these contents:
-
-   ```yaml
-    on:
-      push:
-        branches:
-          - main
-    name: release-please
-    jobs:
-      release-please:
-        runs-on: ubuntu-latest
-        steps:
-          - uses: GoogleCloudPlatform/release-please-action@v2
-            with:
-              token: ${{ secrets.GITHUB_TOKEN }}
-              release-type: node
-              package-name: release-please-action
-    ```
-
-3. Merge the above action into your repository and make sure new commits follow
-  the [Conventional Commits](https://www.conventionalcommits.org/en/v1.0.0/)
-  convention, [release-please](https://github.com/googleapis/release-please)
-  will start creating Release PRs for you.
-
-#### Automating publication to npm
-
-With a few additions, the Release Please action can be made to publish to
-npm when a Release PR is merged:
-
-```yaml
-on:
-  push:
-    branches:
-      - main
-name: release-please
-jobs:
-  release-please:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: GoogleCloudPlatform/release-please-action@v2
-        id: release
-        with:
-          token: ${{ secrets.GITHUB_TOKEN }}
-          release-type: node
-          package-name: test-release-please
-      # The logic below handles the npm publication:
-      - uses: actions/checkout@v2
-        # these if statements ensure that a publication only occurs when
-        # a new release is created:
-        if: ${{ steps.release.outputs.release_created }}
-      - uses: actions/setup-node@v1
-        with:
-          node-version: 12
-          registry-url: 'https://registry.npmjs.org'
-        if: ${{ steps.release.outputs.release_created }}
-      # if you are using Yarn, substitute the command below with `yarn install --frozen-lockfile`
-      - run: npm ci
-        if: ${{ steps.release.outputs.release_created }}
-      - run: npm publish
-        env:
-          NODE_AUTH_TOKEN: ${{secrets.NPM_TOKEN}}
-        if: ${{ steps.release.outputs.release_created }}
-```
-
-> So that you can keep 2FA enabled for npm publications, we recommend setting
-`registry-url` to your own [Wombat Dressing Room](https://github.com/GoogleCloudPlatform/wombat-dressing-room) deployment.
+The easiest way to run release please is as a GitHub action. Please see [google-github-actions/release-please-action](https://github.com/google-github-actions/release-please-action) for installation and configuration instructions.
 
 ### Running as CLI
 
-Install release-please globally:
+Please see [Running release-please CLI](docs/cli.md) for all the configuration options.
 
-```bash
-npm i release-please -g
-```
+### Install the GitHub App
 
-### Creating/updating release PRs
+There is a probot application available, which allows you to deploy Release
+Please as a GitHub App. Please see 
+[github.com/googleapis/repo-automation-bots](https://github.com/googleapis/repo-automation-bots/tree/main/packages/release-please)
+for installation and configuration instructions.
 
-```bash
-release-please release-pr --package-name=@google-cloud/firestore" \
-  --repo-url=googleapis/nodejs-firestore \
-  --token=$GITHUB_TOKEN
-```
+## Bootstrapping your Repository
 
-| option            | description                                             |
-|-------------------|---------------------------------------------------------|
-| `--package-name`  | is the name of the package to publish to publish to an upstream registry such as npm. |
-| `--repo-url`      | is the URL of the repository on GitHub.                 |
-| `--token`         | a token with write access to `--repo-url`.              |
-| `--default-branch`| branch to open pull release PR against (detected by default). |
-| `--path`          | create a release from a path other than the repository's root |
-| `--monorepo-tags` | add prefix to tags and branches, allowing multiple libraries to be released from the same repository. |
-| `--pull-request-title-pattern` | add title pattern to make release PR, defaults to using `chore${scope}: release${component} ${version}`. |
-| `--signoff` | Add [`Signed-off-by`](https://git-scm.com/docs/git-commit#Documentation/git-commit.txt---signoff) line at the end of the commit log message using the user and email provided. (format "Name \<email@example.com\>") |
-| `--api-url` | URL to use when making API requests [default: "https://api.github.com"] |
-| `--graphql-url` | URL to use when making GraphQL requests [default: "https://api.github.com"] |
-
-### Creating a release on GitHub
-
-```bash
-release-please github-release --repo-url=googleapis/nodejs-firestore \
-  --token=$GITHUB_TOKEN
-```
+Release Please looks at commits since your last release tag. It may or may not be able to find
+your previous releases. The easiest way to on-board your repository is to
+[bootstrap a manifest config](/docs/cli.md#bootstrapping).
 
-| option            | description                                             |
-|-------------------|---------------------------------------------------------|
-| `--package-name`  | is the name of the package to publish to publish to  an upstream registry such as npm. |
-| `--repo-url`      | is the URL of the repository on GitHub.                 |
-| `--token`         | a token with write access to `--repo-url`.              |
-| `--path`          | create a release from a path other than the repository's root |
-| `--api-url`       | URL to use when making API requests [default: "https://api.github.com"] |
-| `--graphql-url`   | URL to use when making GraphQL requests [default: "https://api.github.com"] |
+## Customizing Release Please
 
-### Running as a GitHub App
+Release Please provides several configuration options to allow customizing
+your release process. Please see [customizing.md](docs/customizing.md) for more details.
 
-There is a probot application available, which allows you to deploy Release
-Please as a GitHub App:
+## Supporting Monorepos via Manifest Configuration
 
-* [github.com/googleapis/repo-automation-bots](https://github.com/googleapis/repo-automation-bots/tree/main/packages/release-please).
+Release Please also supports releasing multiple artifacts from the same repository.
+See more at [manifest-releaser.md](docs/manifest-releaser.md).
 
 ## Supported Node.js Versions
 

package/build/src/bin/release-please.js

@@ -19,6 +19,7 @@ const coerce_option_1 = require("../util/coerce-option");
 const yargs = require("yargs");
 const github_1 = require("../github");
 const manifest_1 = require("../manifest");
+const changelog_notes_1 = require("../changelog-notes");
 const logger_1 = require("../util/logger");
 const factory_1 = require("../factory");
 const bootstrapper_1 = require("../bootstrapper");
@@ -157,6 +158,16 @@ function pullRequestStrategyOptions(yargs) {
         .option('changelog-type', {
         describe: 'type of changelog to build',
         choices: factory_1.getChangelogTypes(),
+    })
+        .option('changelog-sections', {
+        describe: 'comma-separated list of scopes to include in the changelog',
+        type: 'string',
+        coerce: (arg) => {
+            if (arg) {
+                return changelog_notes_1.buildChangelogSections(arg.split(','));
+            }
+            return arg;
+        },
     })
         .option('last-package-version', {
         describe: 'last version # that package was released as',
@@ -251,6 +262,7 @@ const createReleasePullRequestCommand = {
                 bumpPatchForMinorPreMajor: argv.bumpPatchForMinorPreMajor,
                 changelogPath: argv.changelogPath,
                 changelogType: argv.changelogType,
+                pullRequestTitlePattern: argv.pullRequestTitlePattern,
                 changelogSections: argv.changelogSections,
                 releaseAs: argv.releaseAs,
                 versioning: argv.versioningStrategy,
@@ -388,7 +400,7 @@ const bootstrapCommand = {
     command: 'bootstrap',
     describe: 'configure release manifest',
     builder(yargs) {
-        return manifestOptions(releaseOptions(pullRequestStrategyOptions(gitHubOptions(yargs))))
+        return manifestConfigOptions(manifestOptions(releaseOptions(pullRequestStrategyOptions(gitHubOptions(yargs)))))
             .option('initial-version', {
             description: 'current version',
         })

package/build/src/changelog-notes.d.ts

@@ -17,3 +17,4 @@ export interface ChangelogSection {
     section: string;
     hidden?: boolean;
 }
+export declare function buildChangelogSections(scopes: string[]): ChangelogSection[];

package/build/src/changelog-notes.js

@@ -13,4 +13,28 @@
 // See the License for the specific language governing permissions and
 // limitations under the License.
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildChangelogSections = void 0;
+const DEFAULT_HEADINGS = {
+    feat: 'Features',
+    fix: 'Bug Fixes',
+    perf: 'Performance Improvements',
+    deps: 'Dependencies',
+    revert: 'Reverts',
+    docs: 'Documentation',
+    style: 'Styles',
+    chore: 'Miscellaneous Chores',
+    refactor: 'Code Refactoring',
+    test: 'Tests',
+    build: 'Build System',
+    ci: 'Continuous Integration',
+};
+function buildChangelogSections(scopes) {
+    return scopes.map(scope => {
+        return {
+            type: scope,
+            section: DEFAULT_HEADINGS[scope] || scope,
+        };
+    });
+}
+exports.buildChangelogSections = buildChangelogSections;
 //# sourceMappingURL=changelog-notes.js.map

package/build/src/commit.d.ts

@@ -3,7 +3,7 @@ import * as parser from '@conventional-commits/parser';
 export interface Commit {
     sha: string;
     message: string;
-    files: string[];
+    files?: string[];
     pullRequest?: PullRequest;
 }
 export interface ConventionalCommit extends Commit {

package/build/src/commit.js

@@ -288,8 +288,9 @@ function parseCommits(message) {
 function parseConventionalCommits(commits) {
     const conventionalCommits = [];
     for (const commit of commits) {
+        const commitMessage = preprocessCommitMessage(commit);
         try {
-            for (const parsedCommit of parseCommits(commit.message)) {
+            for (const parsedCommit of parseCommits(commitMessage)) {
                 const breaking = parsedCommit.notes.filter(note => note.title === 'BREAKING CHANGE')
                     .length > 0;
                 conventionalCommits.push({
@@ -313,4 +314,16 @@ function parseConventionalCommits(commits) {
     return conventionalCommits;
 }
 exports.parseConventionalCommits = parseConventionalCommits;
+function preprocessCommitMessage(commit) {
+    // look for 'BEGIN_COMMIT_OVERRIDE' section of pull request body
+    if (commit.pullRequest) {
+        const overrideMessage = (commit.pullRequest.body.split('BEGIN_COMMIT_OVERRIDE')[1] || '')
+            .split('END_COMMIT_OVERRIDE')[0]
+            .trim();
+        if (overrideMessage) {
+            return overrideMessage;
+        }
+    }
+    return commit.message;
+}
 //# sourceMappingURL=commit.js.map

package/build/src/github.d.ts

@@ -36,6 +36,16 @@ export interface GitHubFileContents {
     parsedContent: string;
 }
 declare type CommitFilter = (commit: Commit) => boolean;
+interface CommitIteratorOptions {
+    maxResults?: number;
+    backfillFiles?: boolean;
+}
+interface ReleaseIteratorOptions {
+    maxResults?: number;
+}
+interface TagIteratorOptions {
+    maxResults?: number;
+}
 export interface GitHubRelease {
     name?: string;
     tagName: string;
@@ -44,6 +54,10 @@ export interface GitHubRelease {
     url: string;
     draft?: boolean;
 }
+export interface GitHubTag {
+    name: string;
+    sha: string;
+}
 export declare class GitHub {
     readonly repository: Repository;
     private octokit;
@@ -81,22 +95,28 @@ export declare class GitHub {
      * @param {string} targetBranch Target branch of commit
      * @param {CommitFilter} filter Callback function that returns whether a
      *   commit/pull request matches certain criteria
-     * @param {number} maxResults Limit the number of results searched.
+     * @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
      */
-    commitsSince(targetBranch: string, filter: CommitFilter, maxResults?: number): Promise<Commit[]>;
+    commitsSince(targetBranch: string, filter: CommitFilter, options?: CommitIteratorOptions): Promise<Commit[]>;
     /**
      * Iterate through commit history with a max number of results scanned.
      *
      * @param {string} targetBranch target branch of commit
-     * @param {number} maxResults maxResults - Limit the number of results searched.
+     * @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
      */
-    mergeCommitIterator(targetBranch: string, maxResults?: number): AsyncGenerator<Commit, void, unknown>;
+    mergeCommitIterator(targetBranch: string, options?: CommitIteratorOptions): AsyncGenerator<Commit, void, unknown>;
     private mergeCommitsGraphQL;
     /**
      * Get the list of file paths modified in a given commit.
@@ -129,15 +149,29 @@ export declare class GitHub {
      */
     private pullRequestsGraphQL;
     /**
-     * Iterate through merged pull requests with a max number of results scanned.
+     * Iterate through releases with a max number of results scanned.
      *
-     * @param {number} maxResults maxResults - Limit the number of results searched.
+     * @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
      */
-    releaseIterator(maxResults?: number): AsyncGenerator<GitHubRelease, void, unknown>;
+    releaseIterator(options?: ReleaseIteratorOptions): AsyncGenerator<GitHubRelease, void, unknown>;
     private releaseGraphQL;
+    /**
+     * 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
+     */
+    tagIterator(options?: TagIteratorOptions): AsyncGenerator<{
+        name: string;
+        sha: string;
+    }, void, unknown>;
     /**
      * Fetch the contents of a file from the configured branch
      *

package/build/src/github.js

@@ -139,7 +139,7 @@ class GitHub {
                     // match the filename
                     path.endsWith(filename) &&
                     // match the prefix if provided
-                    (!prefix || path.startsWith(prefix)));
+                    (!prefix || path.startsWith(`${prefix}/`)));
             })
                 .map(file => {
                 let path = file.path;
@@ -277,7 +277,7 @@ class GitHub {
                     // match the file extension
                     path.endsWith(`.${extension}`) &&
                     // match the prefix if provided
-                    (!prefix || path.startsWith(prefix)));
+                    (!prefix || path.startsWith(`${prefix}/`)));
             })
                 .map(file => {
                 let path = file.path;
@@ -299,6 +299,7 @@ class GitHub {
          */
         this.createRelease = wrapAsync(async (release, options = {}) => {
             const resp = await this.octokit.repos.createRelease({
+                name: release.name,
                 owner: this.repository.owner,
                 repo: this.repository.repo,
                 tag_name: release.tag.toString(),
@@ -454,14 +455,17 @@ class GitHub {
      * @param {string} targetBranch Target branch of commit
      * @param {CommitFilter} filter Callback function that returns whether a
      *   commit/pull request matches certain criteria
-     * @param {number} maxResults Limit the number of results searched.
+     * @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, maxResults = Number.MAX_SAFE_INTEGER) {
+    async commitsSince(targetBranch, filter, options = {}) {
         const commits = [];
-        const generator = this.mergeCommitIterator(targetBranch, maxResults);
+        const generator = this.mergeCommitIterator(targetBranch, options);
         for await (const commit of generator) {
             if (filter(commit)) {
                 break;
@@ -474,16 +478,21 @@ class GitHub {
      * Iterate through commit history with a max number of results scanned.
      *
      * @param {string} targetBranch target branch of commit
-     * @param {number} maxResults maxResults - Limit the number of results searched.
+     * @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, maxResults = Number.MAX_SAFE_INTEGER) {
+    async *mergeCommitIterator(targetBranch, options = {}) {
+        var _a;
+        const maxResults = (_a = options.maxResults) !== null && _a !== void 0 ? _a : Number.MAX_SAFE_INTEGER;
         let cursor = undefined;
         let results = 0;
         while (results < maxResults) {
-            const response = await this.mergeCommitsGraphQL(targetBranch, cursor);
+            const response = await this.mergeCommitsGraphQL(targetBranch, cursor, options);
             // no response usually means that the branch can't be found
             if (!response) {
                 break;
@@ -498,7 +507,7 @@ class GitHub {
             cursor = response.pageInfo.endCursor;
         }
     }
-    async mergeCommitsGraphQL(targetBranch, cursor) {
+    async mergeCommitsGraphQL(targetBranch, cursor, options = {}) {
         logger_1.logger.debug(`Fetching merge commits on branch ${targetBranch} with cursor: ${cursor}`);
         const response = await this.graphqlRequest({
             query: `query pullRequestsSince($owner: String!, $repo: String!, $num: Int!, $maxFilesChanged: Int, $targetBranch: String!, $cursor: String) {
@@ -566,7 +575,6 @@ class GitHub {
             const commit = {
                 sha: graphCommit.sha,
                 message: graphCommit.message,
-                files: [],
             };
             const pullRequest = graphCommit.associatedPullRequests.nodes.find(pr => {
                 return pr.mergeCommit && pr.mergeCommit.oid === graphCommit.sha;
@@ -587,7 +595,7 @@ class GitHub {
                 // information for commits with associated pull requests
                 commit.files = files;
             }
-            else {
+            else if (options.backfillFiles) {
                 // In this case, there is no squashed merge commit. This could be a simple
                 // merge commit, a rebase merge commit, or a direct commit to the branch.
                 // Fallback to fetching the list of commits from the REST API. In the future
@@ -708,23 +716,28 @@ class GitHub {
         };
     }
     /**
-     * Iterate through merged pull requests with a max number of results scanned.
+     * Iterate through releases with a max number of results scanned.
      *
-     * @param {number} maxResults maxResults - Limit the number of results searched.
+     * @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(maxResults = Number.MAX_SAFE_INTEGER) {
+    async *releaseIterator(options = {}) {
+        var _a;
+        const maxResults = (_a = options.maxResults) !== null && _a !== void 0 ? _a : Number.MAX_SAFE_INTEGER;
         let results = 0;
         let cursor = undefined;
-        while (results < maxResults) {
+        while (true) {
             const response = await this.releaseGraphQL(cursor);
             if (!response) {
                 break;
             }
             for (let i = 0; i < response.data.length; i++) {
-                results += 1;
+                if ((results += 1) > maxResults) {
+                    break;
+                }
                 yield response.data[i];
             }
             if (!response.pageInfo.hasNextPage) {
@@ -763,12 +776,11 @@ class GitHub {
             repo: this.repository.repo,
             num: 25,
         });
-        if (!response.repository.releases) {
+        if (!response.repository.releases.nodes.length) {
             logger_1.logger.warn('Could not find releases.');
             return null;
         }
-        const releases = (response.repository.releases.nodes ||
-            []);
+        const releases = response.repository.releases.nodes;
         return {
             pageInfo: response.repository.releases.pageInfo,
             data: releases
@@ -788,6 +800,33 @@ class GitHub {
             }),
         };
     }
+    /**
+     * 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 maxResults = options.maxResults || Number.MAX_SAFE_INTEGER;
+        let results = 0;
+        for await (const response of this.octokit.paginate.iterator(this.octokit.rest.repos.listTags, {
+            owner: this.repository.owner,
+            repo: this.repository.repo,
+        })) {
+            for (const tag of response.data) {
+                if ((results += 1) > maxResults) {
+                    break;
+                }
+                yield {
+                    name: tag.name,
+                    sha: tag.commit.sha,
+                };
+            }
+        }
+    }
     /**
      * Fetch the contents of a file from the configured branch
      *

package/build/src/index.d.ts

@@ -0,0 +1,5 @@
+export * as Errors from './errors';
+export { Manifest, ReleaserConfig, ManifestOptions } from './manifest';
+export { ReleaseType, getReleaserTypes, VersioningStrategyType, getVersioningStrategyTypes, ChangelogNotesType, getChangelogTypes, } from './factory';
+export { Logger, setLogger } from './util/logger';
+export { GitHub } from './github';

package/build/src/index.js

@@ -0,0 +1,27 @@
+"use strict";
+// Copyright 2021 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.Errors = require("./errors");
+var manifest_1 = require("./manifest");
+Object.defineProperty(exports, "Manifest", { enumerable: true, get: function () { return manifest_1.Manifest; } });
+var factory_1 = require("./factory");
+Object.defineProperty(exports, "getReleaserTypes", { enumerable: true, get: function () { return factory_1.getReleaserTypes; } });
+Object.defineProperty(exports, "getVersioningStrategyTypes", { enumerable: true, get: function () { return factory_1.getVersioningStrategyTypes; } });
+Object.defineProperty(exports, "getChangelogTypes", { enumerable: true, get: function () { return factory_1.getChangelogTypes; } });
+var logger_1 = require("./util/logger");
+Object.defineProperty(exports, "setLogger", { enumerable: true, get: function () { return logger_1.setLogger; } });
+var github_1 = require("./github");
+Object.defineProperty(exports, "GitHub", { enumerable: true, get: function () { return github_1.GitHub; } });
+//# sourceMappingURL=index.js.map