fork-version 1.4.13 → 1.4.48

package/dist/index.d.ts

@@ -3,26 +3,18 @@ import { ReleaseType } from 'semver';
 
 declare const ForkConfigSchema: z.ZodObject<{
     /**
-     * The path where the changes should be calculated from.
+     * The path fork-version will run from.
      * @default
      * ```js
      * process.cwd()
      * ```
      */
-    changePath: z.ZodString;
+    path: z.ZodString;
     /**
-     * The name of the changelog file.
+     * Name of the changelog file.
      * @default "CHANGELOG.md"
      */
     changelog: z.ZodString;
-    /**
-     * Files to be updated.
-     * @default
-     * ```js
-     * ["bower.json", "manifest.json", "npm-shrinkwrap.json", "package-lock.json", "package.json"]
-     * ```
-     */
-    outFiles: z.ZodArray<z.ZodString, "many">;
     /**
      * The header to be used in the changelog.
      * @default
@@ -34,16 +26,44 @@ declare const ForkConfigSchema: z.ZodObject<{
      */
     header: z.ZodString;
     /**
-     * Specify a prefix for the git tag that will be taken into account during the comparison.
+     * Files to be updated.
+     * @default
+     * ```js
+     * ["bower.json", "manifest.json", "npm-shrinkwrap.json", "package-lock.json", "package.json"]
+     * ```
+     */
+    files: z.ZodArray<z.ZodString, "many">;
+    /**
+     * Specify a prefix for the git tag fork-version will create.
+     *
+     * For instance if your version tag is prefixed by "version/" instead of "v" you have to specify
+     * `tagPrefix: "version/"`.
      *
-     * For instance if your version tag is prefixed by `version/` instead of `v` you would
-     * have to specify `tagPrefix: "version/"`.
-     * @default `v`
+     * `tagPrefix` can also be used for a monorepo environment where you might want to deploy
+     * multiple package from the same repository. In this case you can specify a prefix for
+     * each package:
+     *
+     * | Value                    | Tag Created                   |
+     * |:-------------------------|:------------------------------|
+     * | ""                       | `1.2.3`                       |
+     * | "version/"               | `version/1.2.3`               |
+     * | "@eglavin/fork-version-" | `@eglavin/fork-version-1.2.3` |
+     *
+     * @example "", "version/", "@eglavin/fork-version-"
+     * @default "v"
      */
     tagPrefix: z.ZodString;
     /**
-     * Make a pre-release with optional label to specify a tag id.
-     * @example true, "alpha", "beta", "rc", etc.
+     * Make a pre-release with optional label, if value is a string it will be used as the
+     * pre-release tag.
+     *
+     * | Value     | Version         |
+     * |:----------|:----------------|
+     * | true      | "1.2.3-0"       |
+     * | "alpha"   | "1.2.3-alpha-0" |
+     * | "beta"    | "1.2.3-beta-0"  |
+     *
+     * @example true, "alpha", "beta", "rc"
      * @default undefined
      */
     preReleaseTag: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodBoolean]>>;
@@ -52,17 +72,27 @@ declare const ForkConfigSchema: z.ZodObject<{
      * @default false
      */
     commitAll: z.ZodBoolean;
+    /**
+     * If set we'll log debug information.
+     * @default false
+     */
+    debug: z.ZodBoolean;
     /**
      * If true, no output will be written to disk or committed.
      * @default false
      */
     dryRun: z.ZodBoolean;
     /**
-     * If true and we cant find a version in an `outFiles`, we'll fallback and attempt
-     * to use the latest git tag for the current version.
+     * If true and we cant find a version in the list of `files`, we'll fallback
+     * and attempt to use the latest git tag to get the current version.
      * @default true
      */
     gitTagFallback: z.ZodBoolean;
+    /**
+     * If set, we'll gather information about the current version and exit.
+     * @default false
+     */
+    inspectVersion: z.ZodBoolean;
     /**
      * Should we sign the git commit using GPG?
      * @see {@link https://git-scm.com/docs/git-commit#Documentation/git-commit.txt--Sltkeyidgt GPG Sign Commits}
@@ -80,13 +110,14 @@ declare const ForkConfigSchema: z.ZodObject<{
      */
     verify: z.ZodBoolean;
     /**
-     * If set, we'll use this version number instead of trying to find it in an `outFiles`.
+     * If set, we'll use this version number instead of trying to find a version from the list of `files`.
      * @example "1.0.0"
      * @default undefined
      */
     currentVersion: z.ZodOptional<z.ZodString>;
     /**
-     * If set, we'll attempt to update the version number to this version.
+     * If set, we'll attempt to update the version number to this version, instead of incrementing
+     * using "conventional-commit".
      * @example "2.0.0"
      * @default undefined
      */
@@ -95,9 +126,6 @@ declare const ForkConfigSchema: z.ZodObject<{
      * Override the default conventional-changelog preset configuration.
      */
     changelogPresetConfig: z.ZodObject<{
-        /**
-         * An array of `type` objects representing the explicitly supported commit message types, and whether they should show up in generated `CHANGELOG`s.
-         */
         types: z.ZodOptional<z.ZodArray<z.ZodObject<{
             type: z.ZodString;
             section: z.ZodOptional<z.ZodString>;
@@ -111,29 +139,11 @@ declare const ForkConfigSchema: z.ZodObject<{
             section?: string | undefined;
             hidden?: boolean | undefined;
         }>, "many">>;
-        /**
-         * A URL representing a specific commit at a hash.
-         */
         commitUrlFormat: z.ZodOptional<z.ZodString>;
-        /**
-         * A URL representing the comparison between two git SHAs.
-         */
         compareUrlFormat: z.ZodOptional<z.ZodString>;
-        /**
-         * A URL representing the issue format (allowing a different URL format to be swapped in for Gitlab, Bitbucket, etc).
-         */
         issueUrlFormat: z.ZodOptional<z.ZodString>;
-        /**
-         * A URL representing the a user's profile URL on GitHub, Gitlab, etc. This URL is used for substituting @bcoe with https://github.com/bcoe in commit messages.
-         */
         userUrlFormat: z.ZodOptional<z.ZodString>;
-        /**
-         * A string to be used to format the auto-generated release commit message.
-         */
         releaseCommitMessageFormat: z.ZodOptional<z.ZodString>;
-        /**
-         * An array of prefixes used to detect references to issues
-         */
         issuePrefixes: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
     }, "strip", z.ZodTypeAny, {
         types?: {
@@ -161,14 +171,16 @@ declare const ForkConfigSchema: z.ZodObject<{
         issuePrefixes?: string[] | undefined;
     }>;
 }, "strip", z.ZodTypeAny, {
-    changePath: string;
+    path: string;
     changelog: string;
-    outFiles: string[];
     header: string;
+    files: string[];
     tagPrefix: string;
     commitAll: boolean;
+    debug: boolean;
     dryRun: boolean;
     gitTagFallback: boolean;
+    inspectVersion: boolean;
     sign: boolean;
     silent: boolean;
     verify: boolean;
@@ -189,14 +201,16 @@ declare const ForkConfigSchema: z.ZodObject<{
     currentVersion?: string | undefined;
     nextVersion?: string | undefined;
 }, {
-    changePath: string;
+    path: string;
     changelog: string;
-    outFiles: string[];
     header: string;
+    files: string[];
     tagPrefix: string;
     commitAll: boolean;
+    debug: boolean;
     dryRun: boolean;
     gitTagFallback: boolean;
+    inspectVersion: boolean;
     sign: boolean;
     silent: boolean;
     verify: boolean;
@@ -217,74 +231,93 @@ declare const ForkConfigSchema: z.ZodObject<{
     currentVersion?: string | undefined;
     nextVersion?: string | undefined;
 }>;
-type ForkConfig = z.infer<typeof ForkConfigSchema> & {
-    /**
-     * Log function, can be used to override the default `console.log` function
-     * to log to a file or another service.
-     * @default console.log
-     */
-    log: (...args: unknown[]) => void;
+type ForkConfig = z.infer<typeof ForkConfigSchema>;
+declare function defineConfig(config: Partial<ForkConfig>): Partial<ForkConfig>;
+
+declare function getUserConfig(): Promise<ForkConfig>;
+
+declare class Logger {
+    private config;
+    disableLogs: boolean;
+    constructor(config: Pick<ForkConfig, "silent" | "debug" | "inspectVersion">);
+    log(...messages: any[]): void;
+    warn(...messages: any[]): void;
+    error(...messages: any[]): void;
+    debug(...messages: any[]): void;
+}
+
+interface FileState {
+    name: string;
+    path: string;
+    version: string;
+    [other: string]: unknown;
+}
+interface IFileManager {
+    read(fileName: string): FileState | undefined;
+    write(filePath: string, newVersion: string): void;
+}
+declare class FileManager implements IFileManager {
+    private config;
+    private logger;
+    private JSONPackage;
+    private PlainText;
+    constructor(config: ForkConfig, logger: Logger);
     /**
-     * Error logger function, can be used to override the default `console.error`
-     * function to log to a file or another service.
-     * @default console.error
+     * Get the state from the given file name.
+     *
+     * @example
+     * ```ts
+     * fileManager.read("package.json");
+     * ```
+     *
+     * @returns
+     * ```json
+     * { "name": "package.json", "path": "/path/to/package.json", "version": "1.2.3", "isPrivate": true }
+     * ```
      */
-    error: (...args: unknown[]) => void;
+    read(fileName: string): FileState | undefined;
     /**
-     * Debug logger function, by default this is a noop function, but can be replaced
-     * with a custom logger function or `console.info` to print output.
-     * @default  () => {}
+     * Write the new version to the given file path.
+     *
+     * @example
+     * ```ts
+     * fileManager.write("/path/to/package.json", "1.2.3");
+     * ```
      */
-    debug: (...args: unknown[]) => void;
-};
-declare function defineConfig(config: Partial<ForkConfig>): Partial<ForkConfig>;
+    write(filePath: string, newVersion: string): void;
+}
 
-type FileState = {
-    name: string;
-    path: string;
-    type: "package-file" | ({} & string);
+interface CurrentVersion {
     version: string;
-    isPrivate: boolean;
-};
-type CurrentVersion = {
-    currentVersion: string;
     files: FileState[];
-};
-type NextVersion = {
-    nextVersion: string;
+}
+declare function getCurrentVersion(config: ForkConfig, logger: Logger, fileManager: IFileManager): Promise<CurrentVersion>;
+interface NextVersion {
+    version: string;
     level?: number;
     preMajor?: boolean;
     reason?: string;
     releaseType?: ReleaseType;
-};
-type BumpVersion = CurrentVersion & NextVersion;
-declare function bumpVersion(options: ForkConfig): Promise<BumpVersion>;
+}
+declare function getNextVersion(config: ForkConfig, logger: Logger, currentVersion: string): Promise<NextVersion>;
 
-type CreateChangelog = {
-    path: string;
-    exists: boolean;
-};
-type UpdateChangelog = {
-    changelog: CreateChangelog;
+interface UpdateChangelog {
+    changelogPath: string;
     oldContent: string;
     newContent: string;
-};
-declare function updateChangelog(options: ForkConfig, bumpResult: BumpVersion): Promise<UpdateChangelog>;
+}
+declare function updateChangelog(config: ForkConfig, logger: Logger, nextVersion: string): Promise<UpdateChangelog>;
 
-type CommitChanges = {
+interface CommitChanges {
     filesToCommit: string[];
     gitAddOutput?: string;
     gitCommitOutput?: string;
-};
-declare function commitChanges(options: ForkConfig, bumpResult: BumpVersion): Promise<CommitChanges>;
+}
+declare function commitChanges(config: ForkConfig, logger: Logger, files: FileState[], nextVersion: string): Promise<CommitChanges>;
 
-type TagChanges = {
+interface TagChanges {
     gitTagOutput: string;
-    currentBranchName: string;
-    hasPublicPackageFile: boolean;
-    pushMessage: string;
-    publishMessage: string;
-};
-declare function tagChanges(options: ForkConfig, bumpResult: BumpVersion): Promise<TagChanges>;
+}
+declare function tagChanges(config: ForkConfig, logger: Logger, nextVersion: string): Promise<TagChanges>;
 
-export { BumpVersion, ForkConfig, bumpVersion, commitChanges, defineConfig, tagChanges, updateChangelog };
+export { type CurrentVersion, FileManager, type FileState, type ForkConfig, ForkConfigSchema, type IFileManager, type NextVersion, commitChanges, defineConfig, getCurrentVersion, getNextVersion, getUserConfig, tagChanges, updateChangelog };

package/dist/index.js

@@ -1,3 +1,3 @@
-export { bumpVersion, commitChanges, defineConfig, tagChanges, updateChangelog } from './chunk-Z5YLEJGR.js';
+export { FileManager, ForkConfigSchema, commitChanges, defineConfig, getCurrentVersion, getNextVersion, getUserConfig, tagChanges, updateChangelog } from './chunk-S2VPLFG2.js';
 //# sourceMappingURL=out.js.map
 //# sourceMappingURL=index.js.map

package/package.json

@@ -1,79 +1,92 @@
 {
-	"name": "fork-version",
-	"version": "1.4.13",
-	"license": "ISC",
-	"description": "Replacement for standard version written with modern syntax",
-	"homepage": "https://github.com/eglavin/fork-version",
-	"bugs": {
-		"url": "https://github.com/eglavin/fork-version/issues"
-	},
-	"repository": {
-		"type": "git",
-		"url": "https://github.com/eglavin/fork-version.git"
-	},
-	"author": {
-		"name": "Eanna Glavin",
-		"url": "https://eglavin.com"
-	},
-	"type": "module",
-	"main": "dist/index.cjs",
-	"module": "dist/index.js",
-	"types": "dist/index.d.ts",
-	"exports": {
-		".": {
-			"import": "./dist/index.js",
-			"require": "./dist/index.cjs",
-			"types": "./dist/index.d.ts"
-		},
-		"./cli": {
-			"import": "./dist/cli.js",
-			"require": "./dist/cli.cjs",
-			"types": "./dist/cli.d.ts"
-		},
-		"./package.json": "./package.json"
-	},
-	"bin": {
-		"fork-version": "./dist/cli.js"
-	},
-	"files": [
-		"dist"
-	],
-	"scripts": {
-		"fork-version": "node dist/cli.js",
-		"dev": "tsup --watch",
-		"build": "tsup",
-		"lint:style": "prettier --write \"src/**/*.ts\"",
-		"lint:code": "eslint --fix \"src/**/*.ts\""
-	},
-	"dependencies": {
-		"bundle-require": "4.0.1",
-		"conventional-changelog": "5.1.0",
-		"conventional-changelog-config-spec": "2.1.0",
-		"conventional-changelog-conventionalcommits": "7.0.2",
-		"conventional-recommended-bump": "9.0.0",
-		"detect-indent": "6.1.0",
-		"detect-newline": "3.1.0",
-		"esbuild": "0.19.3",
-		"git-semver-tags": "7.0.1",
-		"joycon": "3.1.1",
-		"meow": "12.1.1",
-		"semver": "7.5.4",
-		"zod": "3.22.2"
-	},
-	"devDependencies": {
-		"@types/conventional-changelog-config-spec": "2.1.3",
-		"@types/git-raw-commits": "2.0.2",
-		"@types/json-schema": "7.0.13",
-		"@types/node": "20.6.2",
-		"@types/semver": "7.5.2",
-		"@typescript-eslint/eslint-plugin": "6.7.2",
-		"@typescript-eslint/parser": "6.7.2",
-		"eslint": "8.49.0",
-		"eslint-config-prettier": "9.0.0",
-		"eslint-plugin-prettier": "5.0.0",
-		"globals": "13.21.0",
-		"prettier": "3.0.3",
-		"tsup": "7.2.0",
-		"typescript": "5.2.2"
-	}
+  "name": "fork-version",
+  "version": "1.4.48",
+  "license": "ISC",
+  "description": "Replacement for standard version written with modern syntax",
+  "homepage": "https://github.com/eglavin/fork-version",
+  "bugs": {
+    "url": "https://github.com/eglavin/fork-version/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/eglavin/fork-version.git"
+  },
+  "author": {
+    "name": "Eanna Glavin",
+    "url": "https://eglavin.com"
+  },
+  "packageManager": "pnpm@8.15.6",
+  "private": false,
+  "type": "module",
+  "main": "dist/index.cjs",
+  "module": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs",
+      "types": "./dist/index.d.ts"
+    },
+    "./cli": {
+      "import": "./dist/cli.js",
+      "require": "./dist/cli.cjs",
+      "types": "./dist/cli.d.ts"
+    },
+    "./package.json": "./package.json"
+  },
+  "bin": {
+    "fork-version": "./dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "CHANGELOG.md",
+    "README.md"
+  ],
+  "scripts": {
+    "fork-version": "node dist/cli.js",
+    "dev": "tsup --watch",
+    "build": "tsup",
+    "lint": "eslint --fix \"src/**/*.ts\"",
+    "lint:check": "eslint \"src/**/*.ts\"",
+    "lint:format": "prettier --write \"src/**/*.ts\"",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest",
+    "test:cover": "vitest --coverage",
+    "test:ci": "vitest run --coverage --no-file-parallelism",
+    "test:ui": "vitest --ui",
+    "test:cleanup": "rimraf -g ../fork-version.tests/*"
+  },
+  "dependencies": {
+    "bundle-require": "4.0.2",
+    "conventional-changelog": "5.1.0",
+    "conventional-changelog-config-spec": "2.1.0",
+    "conventional-changelog-conventionalcommits": "7.0.2",
+    "conventional-recommended-bump": "9.0.0",
+    "detect-indent": "7.0.1",
+    "detect-newline": "4.0.1",
+    "esbuild": "0.20.2",
+    "git-semver-tags": "7.0.1",
+    "joycon": "3.1.1",
+    "meow": "13.2.0",
+    "semver": "7.6.0",
+    "zod": "3.22.4"
+  },
+  "devDependencies": {
+    "@types/git-raw-commits": "2.0.4",
+    "@types/json-schema": "7.0.15",
+    "@types/node": "20.11.30",
+    "@types/semver": "7.5.8",
+    "@vitest/coverage-v8": "1.4.0",
+    "@vitest/ui": "1.4.0",
+    "eslint": "8.57.0",
+    "eslint-config-prettier": "9.1.0",
+    "eslint-plugin-prettier": "5.1.3",
+    "globals": "15.0.0",
+    "prettier": "3.2.5",
+    "rimraf": "5.0.5",
+    "tsup": "8.0.2",
+    "typescript": "5.4.3",
+    "typescript-eslint": "7.4.0",
+    "vitest": "1.4.0"
+  }
 }