fork-version 4.1.4 → 4.1.7

package/CHANGELOG.md

@@ -1,5 +1,29 @@
 # Fork Version
 
+## [4.1.7](https://github.com/eglavin/fork-version/compare/v4.1.6...v4.1.7) (2026-03-08)
+
+
+### Refactor
+
+* improve inspect command ([0b78aab](https://github.com/eglavin/fork-version/commit/0b78aab5dd9be49ffccba173fdb99e13eac52fbd))
+
+
+## [4.1.6](https://github.com/eglavin/fork-version/compare/v4.1.5...v4.1.6) (2026-03-08)
+
+
+### Refactor
+
+* remove duplicate get tags function ([ec2962a](https://github.com/eglavin/fork-version/commit/ec2962a99f0da0335079ef6fa677f3023325cdcf))
+
+
+## [4.1.5](https://github.com/eglavin/fork-version/compare/v4.1.4...v4.1.5) (2026-03-08)
+
+
+### Refactor
+
+* remove typescript member visibility modifiers in favour of private fields ([c2e0749](https://github.com/eglavin/fork-version/commit/c2e07494bb2af69f04c0ecfc13eb342705c904aa))
+
+
 ## [4.1.4](https://github.com/eglavin/fork-version/compare/v4.1.3...v4.1.4) (2026-03-08)
 
 

package/README.md

@@ -94,8 +94,9 @@ Fork-Version has a number of command modes which will make the program behave di
 | Command             | Description                                                            |
 | ------------------- | ---------------------------------------------------------------------- |
 | `main`              | Bumps the version, update files, generate changelog, commits, and tag. |
-| `inspect-version`   | Prints the current version and exit.                                   |
-| `inspect-tag`       | Prints the current git tag and exit.                                   |
+| `inspect`           | Print the current version and git tag, then exit.                       |
+| `inspect-version`   | Print the current version then exit.                                   |
+| `inspect-tag`       | Print the current git tag then exit.                                   |
 | `validate-config`   | Validates the configuration and exit.                                  |
 
 ### Exit Codes
@@ -121,8 +122,9 @@ Usage:
 
 Commands:
   main                             Bumps the version, update files, generate changelog, commit, and tag. [Default when no command is provided]
-  inspect-version                  Prints the current version and exits.
-  inspect-tag                      Prints the current git tag and exits.
+  inspect                          Print the current version and git tag, then exits.
+  inspect-version                  Print the current version then exits.
+  inspect-tag                      Print the current git tag then exits.
   validate-config                  Validates the configuration and exits.
 
 General Options:
@@ -154,6 +156,7 @@ Flags:
   --git-tag-fallback               If unable to find a version in the given files, fallback and attempt to use the latest git tag. [Default: true]
   --sign                           If true, git will sign the commit with the systems GPG key.
   --verify                         If true, git will run user defined git hooks before committing.
+  --as-json                        Output the result as JSON.
 
   To negate a flag you can prefix it with "no-", for example "--no-git-tag-fallback" will not fallback to the latest git tag.
 

package/dist/{chunk-I76EAKJC.js → chunk-5CZU5EA7.js}

@@ -1,6 +1,6 @@
 import { z } from 'zod';
 import { execFile } from 'child_process';
-import semver from 'semver';
+import semver5 from 'semver';
 import { resolve, join, isAbsolute, parse, basename } from 'path';
 import { glob } from 'fs/promises';
 import conventionalChangelogConfigSpec from 'conventional-changelog-config-spec';
@@ -80,12 +80,13 @@ var ForkConfigSchema = z.object({
    * - `main` - Bumps the version, update files, generate changelog, commit, and tag.
    * - `inspect-version` - Prints the current version and exits.
    * - `inspect-tag` - Prints the current git tag and exits.
+   * - `inspect` - Prints the current version and git tag and exits.
    * - `validate-config` - Validates the configuration and exits.
    *
    * @default "main"
    */
-  command: z.literal(["main", "inspect-version", "inspect-tag", "validate-config"]).describe(
-    "The command to run. Can be one of: main, inspect-version, inspect-tag, validate-config. Defaults to main."
+  command: z.literal(["main", "inspect", "inspect-version", "inspect-tag", "validate-config"]).describe(
+    "The command to run. Can be one of: main, inspect, inspect-version, inspect-tag, validate-config. Defaults to main."
   ),
   /**
    * If set, Fork-Version will print the current version and exit.
@@ -248,6 +249,11 @@ var ForkConfigSchema = z.object({
    * @default false
    */
   verify: z.boolean().describe("If true, git will run user defined git hooks before committing."),
+  /**
+   * Output result as JSON.
+   * @default false
+   */
+  asJson: z.boolean().describe("Output the result as JSON."),
   // Skip Steps
   //
   /**
@@ -290,8 +296,11 @@ function escapeRegex(input) {
 
 // src/services/git.ts
 var Git = class {
+  #path;
+  #dryRun;
   constructor(config) {
-    this.config = config;
+    this.#path = config.path;
+    this.#dryRun = config.dryRun ?? false;
     this.add = this.add.bind(this);
     this.commit = this.commit.bind(this);
     this.tag = this.tag.bind(this);
@@ -301,8 +310,6 @@ var Git = class {
     this.getRemoteUrl = this.getRemoteUrl.bind(this);
     this.getTags = this.getTags.bind(this);
     this.getMostRecentTag = this.getMostRecentTag.bind(this);
-    this.getCleanedTags = this.getCleanedTags.bind(this);
-    this.getHighestSemverVersionFromTags = this.getHighestSemverVersionFromTags.bind(this);
     this.getCommits = this.getCommits.bind(this);
   }
   async #execGit(command, args) {
@@ -311,7 +318,7 @@ var Git = class {
         "git",
         [command, ...args],
         {
-          cwd: this.config.path,
+          cwd: this.#path,
           maxBuffer: Infinity
         },
         (error, stdout, stderr) => {
@@ -335,7 +342,7 @@ var Git = class {
    * ```
    */
   async add(...args) {
-    if (this.config.dryRun) {
+    if (this.#dryRun) {
       return "";
     }
     return this.#execGit("add", args.filter(Boolean));
@@ -351,7 +358,7 @@ var Git = class {
    * ```
    */
   async commit(...args) {
-    if (this.config.dryRun) {
+    if (this.#dryRun) {
       return "";
     }
     return this.#execGit("commit", args.filter(Boolean));
@@ -367,7 +374,7 @@ var Git = class {
    * ```
    */
   async tag(...args) {
-    if (this.config.dryRun) {
+    if (this.#dryRun) {
       return "";
     }
     return this.#execGit("tag", args.filter(Boolean));
@@ -476,18 +483,18 @@ var Git = class {
       if (tagPrefix) {
         if (tag.startsWith(tagPrefix)) {
           const tagWithoutPrefix = tag.replace(new RegExp(`^${escapedTagPrefix}`), "");
-          if (semver.valid(tagWithoutPrefix)) {
+          if (semver5.valid(tagWithoutPrefix)) {
             tags.push(tag);
           }
         }
-      } else if (/^\d/.test(tag) && semver.valid(tag)) {
+      } else if (/^\d/.test(tag) && semver5.valid(tag)) {
         tags.push(tag);
       }
     }
     return tags;
   }
   /**
-   * Returns the latest git tag based on commit date
+   * Returns the most recent tag from the commit history, or `undefined` if no valid semver tags are found
    *
    * @example
    * ```ts
@@ -498,40 +505,6 @@ var Git = class {
     const tags = await this.getTags(tagPrefix);
     return tags[0] || void 0;
   }
-  /**
-   * Get cleaned semver tags, with any tag prefix's removed
-   *
-   * @example
-   * ```ts
-   * await git.getCleanedTags("v"); // ["1.2.3", "1.2.2", "1.2.1"]
-   * ```
-   */
-  async getCleanedTags(tagPrefix) {
-    const tags = await this.getTags(tagPrefix);
-    const escapedTagPrefix = tagPrefix ? escapeRegex(tagPrefix) : void 0;
-    const cleanedTags = [];
-    for (const tag of tags) {
-      const tagWithoutPrefix = tag.replace(new RegExp(`^${escapedTagPrefix}`), "");
-      const cleanedTag = semver.clean(tagWithoutPrefix);
-      if (cleanedTag) {
-        cleanedTags.push(cleanedTag);
-      }
-    }
-    return cleanedTags;
-  }
-  /**
-   * Get the highest semver version from git tags. This will return the highest
-   * semver version found for the given tag prefix, regardless of the commit date.
-   *
-   * @example
-   * ```ts
-   * await git.getHighestSemverVersionFromTags("v"); // "1.2.3"
-   * ```
-   */
-  async getHighestSemverVersionFromTags(tagPrefix) {
-    const cleanedTags = await this.getCleanedTags(tagPrefix);
-    return cleanedTags.sort(semver.rcompare)[0] || void 0;
-  }
   /**
    * Get commit history in a parsable format
    *
@@ -686,6 +659,7 @@ All notable changes to this project will be documented in this file. See [fork-v
   gitTagFallback: true,
   sign: false,
   verify: false,
+  asJson: false,
   // Skip Steps
   skipBump: false,
   skipChangelog: false,
@@ -695,11 +669,8 @@ All notable changes to this project will be documented in this file. See [fork-v
 };
 
 // src/config/detect-git-host.ts
-async function detectGitHost(cwd) {
-  const remoteUrl = await new Git({
-    path: cwd,
-    dryRun: false
-  }).getRemoteUrl();
+async function detectGitHost(path) {
+  const remoteUrl = await new Git({ path }).getRemoteUrl();
   if (remoteUrl.startsWith("https://") && remoteUrl.includes("@dev.azure.com/")) {
     const match = /^https:\/\/(?<atorganisation>.*?)@dev.azure.com\/(?<organisation>.*?)\/(?<project>.*?)\/_git\/(?<repository>.*?)(?:\.git)?$/.exec(
       remoteUrl
@@ -843,33 +814,34 @@ async function getUserConfig(cliArguments) {
   };
 }
 var Logger = class {
+  #silent;
+  #debug;
   constructor(config) {
-    this.config = config;
+    this.#silent = config.silent ?? false;
+    this.#debug = config.debug ?? false;
     this.log = this.log.bind(this);
     this.warn = this.warn.bind(this);
     this.error = this.error.bind(this);
     this.debug = this.debug.bind(this);
     this.skipping = this.skipping.bind(this);
-    this.disableLogs = this.config.silent;
   }
-  disableLogs = false;
   log(message) {
-    if (!this.disableLogs) {
+    if (!this.#silent) {
       console.log(message);
     }
   }
   warn(message) {
-    if (!this.disableLogs) {
+    if (!this.#silent) {
       console.warn(styleText("yellowBright", message));
     }
   }
   error(message) {
-    if (!this.disableLogs) {
+    if (!this.#silent) {
       console.error(styleText("redBright", message));
     }
   }
   debug(message, ...optionalParams) {
-    if (this.config.debug && !this.disableLogs) {
+    if (!this.#silent && this.#debug) {
       console.debug(styleText("cyanBright", message));
       if (optionalParams.length > 0) {
         console.debug(...optionalParams);
@@ -877,7 +849,7 @@ var Logger = class {
     }
   }
   skipping(message) {
-    if (!this.disableLogs) {
+    if (!this.#silent) {
       console.log(styleText("magenta", message));
     }
   }
@@ -1205,66 +1177,6 @@ ${JSON.stringify(config, null, 2)}
 \u2705 Configuration is valid.
 `);
 }
-async function getCurrentVersion(config, logger, git, fileManager, filesToUpdate) {
-  const files = [];
-  const versions = /* @__PURE__ */ new Set();
-  for (const file of filesToUpdate) {
-    if (await git.isIgnored(file)) {
-      logger.debug(`[Git Ignored] ${file}`);
-      continue;
-    }
-    const fileState = fileManager.read(file);
-    if (fileState) {
-      files.push(fileState);
-      if (!config.currentVersion) {
-        versions.add(fileState.version);
-      }
-    }
-  }
-  if (config.currentVersion) {
-    versions.add(config.currentVersion);
-  }
-  if (versions.size === 0 && config.gitTagFallback) {
-    const version = await git.getHighestSemverVersionFromTags(config.tagPrefix);
-    if (version) {
-      logger.warn(`Using latest git tag as fallback`);
-      versions.add(version);
-    }
-  }
-  if (versions.size === 0) {
-    throw new Error("Unable to find current version");
-  } else if (versions.size > 1) {
-    if (!config.allowMultipleVersions) {
-      throw new Error("Found multiple versions");
-    }
-    logger.warn(
-      `Found multiple versions (${Array.from(versions).join(", ")}), using the higher semver version`
-    );
-  }
-  const currentVersion = semver.rsort(Array.from(versions))[0];
-  logger.log(`Current version: ${currentVersion}`);
-  return {
-    files,
-    version: currentVersion
-  };
-}
-
-// src/commands/inspect-version.ts
-async function inspectVersion(config, logger, fileManager, git) {
-  let foundVersion = "";
-  try {
-    const currentVersion = await getCurrentVersion(config, logger, git, fileManager, config.files);
-    if (currentVersion) foundVersion = currentVersion.version;
-  } catch {
-  }
-  console.log(foundVersion);
-}
-
-// src/commands/inspect-tag.ts
-async function inspectTag(config, git) {
-  const tag = await git.getMostRecentTag(config.tagPrefix);
-  console.log(tag ?? "");
-}
 
 // src/utils/trim-string-array.ts
 function trimStringArray(array) {
@@ -1728,6 +1640,12 @@ function filterRevertedCommits(parsedCommits) {
   }
   return commitsWithoutReverts;
 }
+function cleanTag(tag, tagPrefix) {
+  if (!tag) return void 0;
+  const escapedTagPrefix = tagPrefix ? escapeRegex(tagPrefix) : void 0;
+  const tagWithoutPrefix = escapedTagPrefix ? tag.replace(new RegExp(`^${escapedTagPrefix}`), "") : tag;
+  return semver5.clean(tagWithoutPrefix) ?? void 0;
+}
 
 // src/process/get-commits.ts
 async function getCommitsSinceTag(config, logger, git) {
@@ -1751,14 +1669,130 @@ async function getCommitsSinceTag(config, logger, git) {
   );
   return {
     latestTag,
+    latestTagVersion: cleanTag(latestTag, config.tagPrefix),
     commits: filteredCommits
   };
 }
+async function getCurrentVersion(config, logger, git, fileManager, filesToUpdate, latestTagVersion) {
+  const files = [];
+  const versions = /* @__PURE__ */ new Set();
+  for (const file of filesToUpdate) {
+    if (await git.isIgnored(file)) {
+      logger.debug(`[Git Ignored] ${file}`);
+      continue;
+    }
+    const fileState = fileManager.read(file);
+    if (fileState) {
+      files.push(fileState);
+      if (!config.currentVersion) {
+        versions.add(fileState.version);
+      }
+    }
+  }
+  if (config.currentVersion) {
+    versions.add(config.currentVersion);
+  }
+  if (versions.size === 0 && config.gitTagFallback && latestTagVersion) {
+    logger.warn(`Using latest git tag as fallback`);
+    versions.add(latestTagVersion);
+  }
+  if (versions.size === 0) {
+    throw new Error("Unable to find current version");
+  } else if (versions.size > 1) {
+    if (!config.allowMultipleVersions) {
+      throw new Error("Found multiple versions");
+    }
+    logger.warn(
+      `Found multiple versions (${Array.from(versions).join(", ")}), using the higher semver version`
+    );
+  }
+  const currentVersion = semver5.rsort(Array.from(versions))[0];
+  logger.log(`Current version: ${currentVersion}`);
+  return {
+    files,
+    version: currentVersion
+  };
+}
+async function inspect(config, logger, fileManager, git) {
+  let latestTag = "";
+  let latestVersion = "";
+  try {
+    const commits = await getCommitsSinceTag(config, logger, git);
+    if (commits.latestTag) {
+      latestTag = commits.latestTag;
+      latestVersion = commits.latestTagVersion ?? "";
+    }
+    const currentVersion = await getCurrentVersion(
+      config,
+      logger,
+      git,
+      fileManager,
+      config.files,
+      latestVersion
+    );
+    if (currentVersion.version) {
+      latestVersion = currentVersion.version;
+    }
+  } catch {
+  }
+  if (!latestVersion && !latestTag) {
+    console.error(
+      styleText(
+        "yellowBright",
+        "No version found. Make sure you have at least one tag in your repository."
+      )
+    );
+    process.exit(1);
+    return;
+  }
+  switch (config.command) {
+    case "inspect-version": {
+      console.log(
+        config.asJson ? JSON.stringify(
+          {
+            version: latestVersion
+          },
+          null,
+          2
+        ) : latestVersion
+      );
+      return;
+    }
+    case "inspect-tag": {
+      console.log(
+        config.asJson ? JSON.stringify(
+          {
+            tag: latestTag
+          },
+          null,
+          2
+        ) : latestTag
+      );
+      return;
+    }
+    default: {
+      console.log(
+        config.asJson ? JSON.stringify(
+          {
+            version: latestVersion,
+            tag: latestTag
+          },
+          null,
+          2
+        ) : `
+Version: ${latestVersion}
+Tag: ${latestTag}
+`.trim()
+      );
+      return;
+    }
+  }
+}
 function getPriority(type) {
   return ["patch", "minor", "major"].indexOf(type ?? "");
 }
 function getVersionType(version) {
-  const parseVersion = semver.parse(version);
+  const parseVersion = semver5.parse(version);
   if (parseVersion?.major) {
     return "major";
   } else if (parseVersion?.minor) {
@@ -1772,7 +1806,7 @@ function getReleaseType(releaseType, currentVersion, preReleaseTag) {
   if (!preReleaseTag) {
     return releaseType;
   }
-  const currentVersionsIsPreRelease = Array.isArray(semver.prerelease(currentVersion));
+  const currentVersionsIsPreRelease = Array.isArray(semver5.prerelease(currentVersion));
   if (currentVersionsIsPreRelease) {
     const currentReleaseType = getVersionType(currentVersion);
     if (currentReleaseType === releaseType || getPriority(currentReleaseType) > getPriority(releaseType)) {
@@ -1791,7 +1825,7 @@ async function getNextVersion(config, logger, commits, currentVersion) {
     };
   }
   if (config.nextVersion) {
-    if (!semver.valid(config.nextVersion)) {
+    if (!semver5.valid(config.nextVersion)) {
       throw new Error(`Invalid Version: ${config.nextVersion}`);
     }
     logger.log(`Next version: ${config.nextVersion}`);
@@ -1799,7 +1833,7 @@ async function getNextVersion(config, logger, commits, currentVersion) {
       version: config.nextVersion
     };
   }
-  const isPreMajor = semver.lt(currentVersion, "1.0.0");
+  const isPreMajor = semver5.lt(currentVersion, "1.0.0");
   let releaseType = "patch";
   const changes = {
     major: 0,
@@ -1849,7 +1883,7 @@ async function getNextVersion(config, logger, commits, currentVersion) {
     }
   }
   const releaseTypeOrPreRelease = getReleaseType(releaseType, currentVersion, config.preRelease);
-  const nextVersion = semver.inc(
+  const nextVersion = semver5.inc(
     currentVersion,
     releaseTypeOrPreRelease,
     typeof config.preRelease === "string" ? config.preRelease : ""
@@ -2001,7 +2035,14 @@ async function main(config, logger, fileManager, git) {
   logger.log(`Running fork-version - ${(/* @__PURE__ */ new Date()).toUTCString()}`);
   logger.warn(config.dryRun ? "[Dry Run] No changes will be written to disk.\n" : "");
   const commits = await getCommitsSinceTag(config, logger, git);
-  const current = await getCurrentVersion(config, logger, git, fileManager, config.files);
+  const current = await getCurrentVersion(
+    config,
+    logger,
+    git,
+    fileManager,
+    config.files,
+    commits.latestTagVersion
+  );
   const next = await getNextVersion(config, logger, commits.commits, current.version);
   logger.log("Updating files: ");
   for (const outFile of current.files) {
@@ -2019,6 +2060,6 @@ async function main(config, logger, fileManager, git) {
   };
 }
 
-export { CommitParser, FileManager, ForkConfigSchema, Git, Logger, commitChanges, createParserOptions, filterRevertedCommits, getCommitsSinceTag, getCurrentVersion, getNextVersion, getUserConfig, inspectTag, inspectVersion, main, tagChanges, updateChangelog, validateConfig };
-//# sourceMappingURL=chunk-I76EAKJC.js.map
-//# sourceMappingURL=chunk-I76EAKJC.js.map
+export { CommitParser, FileManager, ForkConfigSchema, Git, Logger, commitChanges, createParserOptions, filterRevertedCommits, getCommitsSinceTag, getCurrentVersion, getNextVersion, getUserConfig, inspect, main, tagChanges, updateChangelog, validateConfig };
+//# sourceMappingURL=chunk-5CZU5EA7.js.map
+//# sourceMappingURL=chunk-5CZU5EA7.js.map