@wroud/git/src/getGitLastSemverTags.ts

A lightweight toolset for working with local git, including utilities for retrieving git commits and tags, ideal for CI/CD pipelines and automated release workflows.

import { execa } from "execa";
import semverRegex from "semver-regex";
import { validateGitEnvironment } from "./validateGitEnvironment.js";
import { defaultTagPrefix } from "./defaultTagPrefix.js";

interface IGitGetLastTagsOptions {
  to?: string;
  prefix?: string;
}

export async function* getGitLastSemverTags({
  to,
  prefix = defaultTagPrefix,
}: IGitGetLastTagsOptions = {}): AsyncGenerator<string> {
  await validateGitEnvironment();
  try {
    const args = ["tag", "--list", `${prefix}*`];

    if (to) {
      args.push("--merged", to);
    }

    args.push("--sort=-v:refname");
    for await (const tag of execa("git", args)) {
      if (
        tag.startsWith(prefix) &&
        semverRegex().test(tag.slice(prefix.length))
      ) {
        yield tag;
      }
    }
  } catch (e: any) {
    console.error(e);
  }
}