@mridang/semantic-release-gomod 1.0.0

package/README.md

@@ -0,0 +1,134 @@
+# Semantic Release - Gomod
+
+A [semantic-release](https://github.com/semantic-release/semantic-release)
+plugin to automatically tag and release multi-module Go repositories.
+
+This plugin automates the release workflow for Go monorepos that use the
+multi-module pattern. During `prepare`, it pins every submodule `go.mod`
+require line that references the root module to the new release version and
+optionally runs `go mod tidy`. During `publish`, it creates and pushes a
+per-module git tag for every `go.mod` in the repository, following the
+standard `<subpath>/vX.Y.Z` naming that the Go module proxy requires. This
+eliminates the need for manual tagging scripts, ensuring every module in
+your monorepo is consistently released together.
+
+## Why?
+
+Releasing a multi-module Go repository involves more than just creating a
+single Git tag. For each submodule to be resolvable by the Go module proxy
+and `go get`, it must have its own version tag in the form
+`<path>/vX.Y.Z` (e.g., `assert/cert/manager/v1.2.3`). Keeping require
+lines pinned to the new version across all submodules adds further
+complexity. This multi-step process is a common point of friction in an
+otherwise automated pipeline.
+
+Without this plugin, developers typically face one of two issues:
+
+- **Manual Tagging:** The most common method is a shell script that walks
+  the repository, updates require lines, and pushes tags for each `go.mod`.
+  This adds toil, is error-prone, and is not reusable across projects.
+- **Incomplete Automation:** Other tooling may create the root tag but
+  skip submodule tags, leaving submodules unreachable via `go get` until
+  someone manually creates the missing tags.
+
+This plugin provides a lightweight and direct solution. It auto-discovers
+every `go.mod` in the repository, pins inter-module dependencies to the
+new version, and creates the correct per-module tag for each one — all
+within a standard `semantic-release` pipeline with zero required
+configuration.
+
+## Installation
+
+Install using NPM with the following command:
+
+```sh
+npm install --save-dev @mridang/semantic-release-gomod
+```
+
+## Usage
+
+To use this plugin, add it to your semantic-release configuration file
+(e.g., `.releaserc.js`, `release.config.js`, or in your `package.json`).
+
+The plugin's `prepare` step pins require lines in submodule `go.mod` files.
+For these changes to be included in the release commit, the plugin should be
+placed **before** `@semantic-release/git` in the `plugins` array.
+
+> [!IMPORTANT]
+> This plugin updates `go.mod` files during the `prepare` step. For these
+> changes to be included in your release commit, you **must** configure
+> the `@semantic-release/git` plugin to include your `go.mod` and `go.sum`
+> files in its `assets` array.
+
+### Example Configuration (`.releaserc.js`)
+
+```javascript
+module.exports = {
+  branches: ['main', 'next'],
+  plugins: [
+    '@semantic-release/commit-analyzer',
+    '@mridang/semantic-release-gomod',
+    '@semantic-release/release-notes-generator',
+    '@semantic-release/github',
+    [
+      '@semantic-release/git',
+      {
+        assets: ['go.mod', 'go.sum', '**/go.mod', '**/go.sum'],
+        message:
+          'chore(release): ${nextRelease.version} [skip ci]\n\n${nextRelease.notes}',
+      },
+    ],
+  ],
+};
+```
+
+### Configuration Options
+
+All options are case-sensitive and lowercased in the JSON configuration.
+
+- **`modules` (string | string[], optional):**
+  Glob patterns (relative to the repository root) matching submodule
+  `go.mod` files. When omitted, the plugin auto-discovers every `go.mod`
+  in the repository except the root-level one.
+  Example: `["assert/**/go.mod", "env/**/go.mod"]`.
+
+- **`skipGoModTidy` (boolean, optional):**
+  Skip running `go mod tidy` in each submodule directory after pinning the
+  require version. Useful when Go is not available in the CI environment or
+  for debugging. Default: `false`.
+
+- **`pushTags` (boolean, optional):**
+  Push the created submodule tags to the remote origin after creating them
+  locally. Set to `false` to create tags locally only. Default: `true`.
+
+## Tag Naming
+
+The git tag created for each module is derived from the relative path of
+its `go.mod` directory to the repository root:
+
+| `go.mod` location              | Git tag                      |
+| ------------------------------ | ---------------------------- |
+| `./go.mod`                     | `v1.2.3`                     |
+| `./assert/cert/manager/go.mod` | `assert/cert/manager/v1.2.3` |
+| `./env/flux/helm/go.mod`       | `env/flux/helm/v1.2.3`       |
+
+## Known Issues
+
+- None.
+
+## Useful links
+
+- **[Go Modules Reference](https://go.dev/ref/mod):** Official Go modules
+  documentation.
+- **[Module version numbering](https://go.dev/doc/modules/version-numbers):**
+  How Go module version numbers work.
+
+## Contributing
+
+If you have suggestions for how this plugin could be improved, or
+want to report a bug, open an issue — we'd love all and any
+contributions.
+
+## License
+
+Apache License 2.0 © 2024 Mridang Agarwalla

package/dist/exec.d.ts

@@ -0,0 +1,15 @@
+import { type ExecSyncOptions } from 'child_process';
+/**
+ * A function that executes a shell command synchronously.
+ * Accepting this as a parameter makes the callers unit-testable
+ * without needing to mock Node.js built-in modules.
+ *
+ * Implementations must throw when the command exits with a non-zero
+ * status (matching the default behaviour of Node's `execSync`).
+ * Callers are responsible for catching and handling failures.
+ */
+export type ExecFn = (cmd: string, opts?: ExecSyncOptions) => void;
+/**
+ * Default executor that delegates to Node's built-in `execSync`.
+ */
+export declare const defaultExec: ExecFn;

package/dist/exec.js

@@ -0,0 +1,8 @@
+import { execSync as nodeExecSync } from 'child_process';
+/**
+ * Default executor that delegates to Node's built-in `execSync`.
+ */
+export const defaultExec = (cmd, opts) => {
+    nodeExecSync(cmd, opts);
+};
+//# sourceMappingURL=exec.js.map

package/dist/exec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exec.js","sourceRoot":"","sources":["../src/exec.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,IAAI,YAAY,EAAwB,MAAM,eAAe,CAAC;AAa/E;;GAEG;AACH,MAAM,CAAC,MAAM,WAAW,GAAW,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE;IAC/C,YAAY,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;AAC1B,CAAC,CAAC"}

package/dist/gomod.d.ts

@@ -0,0 +1,65 @@
+import { type ExecFn } from './exec.js';
+/**
+ * Minimal logger interface compatible with the semantic-release context logger.
+ */
+interface Logger {
+    log(message: string, ...args: unknown[]): void;
+    warn(message: string, ...args: unknown[]): void;
+}
+/**
+ * Walk `root` recursively and return the absolute paths of every
+ * go.mod file found, excluding the root-level go.mod itself.
+ *
+ * When `globPatterns` are provided the walk is skipped and the
+ * patterns are expanded against `root` instead.
+ *
+ * @param root        Absolute path to the repository root.
+ * @param globPatterns Optional array of glob patterns relative to root.
+ * @returns Sorted array of absolute go.mod paths (submodules only).
+ */
+export declare function discoverSubmoduleGoMods(root: string, globPatterns?: readonly string[]): readonly string[];
+/**
+ * Read a go.mod file and extract the module declaration.
+ *
+ * @param goModPath Absolute path to the go.mod file.
+ * @returns The module import path, e.g. `"github.com/mridang/wilhelm"`.
+ * @throws Error if no `module` line is found.
+ */
+export declare function readModulePath(goModPath: string): string;
+/**
+ * Update every `require` line in a go.mod file whose import path
+ * starts with `rootModule`, replacing the version with `newVersion`.
+ * Lines with `// indirect` comments are preserved as-is.
+ *
+ * Handles both single-line requires and require blocks.
+ *
+ * @param filePath   Absolute path to the go.mod file to rewrite.
+ * @param rootModule Root module import path (e.g. `"github.com/mridang/wilhelm"`).
+ * @param newVersion New semver string without leading `v` (e.g. `"1.2.3"`).
+ */
+export declare function updateGoModRequires(filePath: string, rootModule: string, newVersion: string): void;
+/**
+ * Derive the git tag prefix for a submodule given its go.mod path
+ * and the repository root.
+ *
+ * - Root module (`./go.mod`)                → `""` (tag = `"v1.2.3"`)
+ * - Submodule (`./assert/cert/manager/go.mod`) → `"assert/cert/manager"`
+ *
+ * @param goModPath Absolute path to the go.mod file.
+ * @param repoRoot  Absolute path to the repository root.
+ * @returns Tag prefix string (empty string for the root module).
+ */
+export declare function deriveTagPrefix(goModPath: string, repoRoot: string): string;
+/**
+ * Create a git tag locally and optionally push it to origin.
+ * Silently ignores the case where the tag already exists so the
+ * plugin can be called idempotently.
+ *
+ * @param repoRoot Absolute path to the repository root.
+ * @param tag      Full tag string, e.g. `"assert/cert/manager/v1.2.3"`.
+ * @param push     When true, push the tag to `origin`.
+ * @param logger   semantic-release logger.
+ * @param exec     Command executor (injectable for testing).
+ */
+export declare function createAndPushTag(repoRoot: string, tag: string, push: boolean, logger: Logger, exec?: ExecFn): void;
+export {};

package/dist/gomod.js

@@ -0,0 +1,177 @@
+import * as fs from 'fs';
+import * as path from 'path';
+import { defaultExec } from './exec.js';
+/**
+ * Read a directory, returning an empty array on any I/O error.
+ */
+function safeReadDir(dir) {
+    try {
+        return fs.readdirSync(dir, { withFileTypes: true });
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Walk `root` recursively and return the absolute paths of every
+ * go.mod file found, excluding the root-level go.mod itself.
+ *
+ * When `globPatterns` are provided the walk is skipped and the
+ * patterns are expanded against `root` instead.
+ *
+ * @param root        Absolute path to the repository root.
+ * @param globPatterns Optional array of glob patterns relative to root.
+ * @returns Sorted array of absolute go.mod paths (submodules only).
+ */
+export function discoverSubmoduleGoMods(root, globPatterns) {
+    if (globPatterns && globPatterns.length > 0) {
+        const results = globPatterns.flatMap((pattern) => expandGlob(root, pattern));
+        return [...new Set(results)].sort();
+    }
+    // Auto-discover: walk the tree
+    return walkForGoMods(root)
+        .filter((f) => f !== path.join(root, 'go.mod'))
+        .sort();
+}
+/**
+ * Recursively walk `dir` and return absolute paths of all go.mod files.
+ */
+function walkForGoMods(dir) {
+    return safeReadDir(dir).flatMap((entry) => {
+        if (entry.name === 'vendor' || entry.name === 'node_modules')
+            return [];
+        const full = path.join(dir, entry.name);
+        if (entry.isDirectory())
+            return [...walkForGoMods(full)];
+        if (entry.isFile() && entry.name === 'go.mod')
+            return [full];
+        return [];
+    });
+}
+/**
+ * Minimal glob expander supporting `**` as a recursive wildcard.
+ * Only handles the patterns this plugin actually uses, e.g.
+ * `"assert/**\/go.mod"` or `"env/*\/go.mod"`.
+ */
+function expandGlob(root, pattern) {
+    return matchParts(root, pattern.split('/'));
+}
+function matchParts(dir, parts) {
+    if (parts.length === 0)
+        return [];
+    const [head, ...tail] = parts;
+    if (head === '**') {
+        // Zero levels: continue with tail from current dir.
+        // One or more levels: descend into each subdirectory.
+        return [
+            ...matchParts(dir, tail),
+            ...safeReadDir(dir)
+                .filter((e) => e.isDirectory())
+                .flatMap((e) => matchParts(path.join(dir, e.name), parts)),
+        ];
+    }
+    if (tail.length === 0) {
+        // Last segment — must be a file (single statSync avoids TOCTOU)
+        const candidate = path.join(dir, head);
+        try {
+            return fs.statSync(candidate).isFile() ? [candidate] : [];
+        }
+        catch {
+            return [];
+        }
+    }
+    if (head === '*') {
+        // Single-level wildcard
+        return safeReadDir(dir)
+            .filter((e) => e.isDirectory())
+            .flatMap((e) => matchParts(path.join(dir, e.name), tail));
+    }
+    // Literal segment — safeReadDir handles missing/unreadable paths gracefully
+    return matchParts(path.join(dir, head), tail);
+}
+/**
+ * Read a go.mod file and extract the module declaration.
+ *
+ * @param goModPath Absolute path to the go.mod file.
+ * @returns The module import path, e.g. `"github.com/mridang/wilhelm"`.
+ * @throws Error if no `module` line is found.
+ */
+export function readModulePath(goModPath) {
+    const content = fs.readFileSync(goModPath, 'utf8');
+    for (const line of content.split('\n')) {
+        const m = line.match(/^module\s+(\S+)/);
+        if (m)
+            return m[1];
+    }
+    throw new Error(`No module declaration found in ${goModPath}`);
+}
+/**
+ * Update every `require` line in a go.mod file whose import path
+ * starts with `rootModule`, replacing the version with `newVersion`.
+ * Lines with `// indirect` comments are preserved as-is.
+ *
+ * Handles both single-line requires and require blocks.
+ *
+ * @param filePath   Absolute path to the go.mod file to rewrite.
+ * @param rootModule Root module import path (e.g. `"github.com/mridang/wilhelm"`).
+ * @param newVersion New semver string without leading `v` (e.g. `"1.2.3"`).
+ */
+export function updateGoModRequires(filePath, rootModule, newVersion) {
+    const content = fs.readFileSync(filePath, 'utf8');
+    // Escape slashes and dots in the module path for use in regex
+    const escaped = rootModule.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+    // Match: <module_path_starting_with_root> <v-prefixed-version> [optional comment]
+    const pattern = new RegExp(`(${escaped}[^\\s]*)\\s+v[0-9]\\S*`, 'g');
+    const updated = content.replace(pattern, `$1 v${newVersion}`);
+    if (updated !== content) {
+        fs.writeFileSync(filePath, updated, 'utf8');
+    }
+}
+/**
+ * Derive the git tag prefix for a submodule given its go.mod path
+ * and the repository root.
+ *
+ * - Root module (`./go.mod`)                → `""` (tag = `"v1.2.3"`)
+ * - Submodule (`./assert/cert/manager/go.mod`) → `"assert/cert/manager"`
+ *
+ * @param goModPath Absolute path to the go.mod file.
+ * @param repoRoot  Absolute path to the repository root.
+ * @returns Tag prefix string (empty string for the root module).
+ */
+export function deriveTagPrefix(goModPath, repoRoot) {
+    return path.relative(repoRoot, path.dirname(goModPath));
+}
+/**
+ * Create a git tag locally and optionally push it to origin.
+ * Silently ignores the case where the tag already exists so the
+ * plugin can be called idempotently.
+ *
+ * @param repoRoot Absolute path to the repository root.
+ * @param tag      Full tag string, e.g. `"assert/cert/manager/v1.2.3"`.
+ * @param push     When true, push the tag to `origin`.
+ * @param logger   semantic-release logger.
+ * @param exec     Command executor (injectable for testing).
+ */
+export function createAndPushTag(repoRoot, tag, push, logger, exec = defaultExec) {
+    try {
+        exec(`git tag "${tag}"`, { cwd: repoRoot, stdio: 'pipe' });
+        logger.log('Created tag %s', tag);
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        if (msg.includes('already exists')) {
+            logger.log('Tag %s already exists, skipping', tag);
+        }
+        else {
+            throw err;
+        }
+    }
+    if (push) {
+        exec(`git push origin "refs/tags/${tag}"`, {
+            cwd: repoRoot,
+            stdio: 'pipe',
+        });
+        logger.log('Pushed tag %s', tag);
+    }
+}
+//# sourceMappingURL=gomod.js.map

package/dist/gomod.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gomod.js","sourceRoot":"","sources":["../src/gomod.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,49 @@
+import type { PrepareContext, PublishContext, VerifyConditionsContext } from 'semantic-release';
+import { type ExecFn } from './exec.js';
+import { GomodPluginConfig } from './plugin-config.js';
+/**
+ * Verify that all preconditions for the plugin are met:
+ *  - A root `go.mod` exists in the working directory.
+ *  - `git` is available on PATH.
+ *
+ * A warning (not an error) is emitted when no submodule go.mod files
+ * are found, since the plugin is still useful for single-module repos
+ * (it will create the root tag in the publish step).
+ *
+ * @param pluginConfig The plugin configuration.
+ * @param context      The semantic-release context.
+ * @param exec         Command executor (injectable for testing).
+ */
+export declare function verifyConditions(pluginConfig: GomodPluginConfig, context: VerifyConditionsContext, exec?: ExecFn): Promise<void>;
+/**
+ * Pin every submodule `go.mod` require line that references the root
+ * module (or any of its sub-paths) to the new release version.
+ *
+ * Optionally runs `go mod tidy` in each submodule directory afterward.
+ * The actual commit is handled by `@semantic-release/git`.
+ *
+ * @param pluginConfig The plugin configuration.
+ * @param context      The semantic-release context.
+ * @param exec         Command executor (injectable for testing).
+ */
+export declare function prepare(pluginConfig: GomodPluginConfig, context: PrepareContext, exec?: ExecFn): Promise<void>;
+/**
+ * Create and push a git tag for every module in the repository,
+ * including the root module.
+ *
+ * semantic-release creates the root tag (`vX.Y.Z`) before calling
+ * publish; this step creates it silently when it already exists and
+ * then creates all submodule tags
+ * (e.g. `assert/cert/manager/vX.Y.Z`).
+ *
+ * @param pluginConfig The plugin configuration.
+ * @param context      The semantic-release context.
+ * @param exec         Command executor (injectable for testing).
+ */
+export declare function publish(pluginConfig: GomodPluginConfig, context: PublishContext, exec?: ExecFn): Promise<void>;
+declare const _default: {
+    readonly verifyConditions: typeof verifyConditions;
+    readonly prepare: typeof prepare;
+    readonly publish: typeof publish;
+};
+export default _default;

package/dist/index.js

@@ -0,0 +1,113 @@
+import * as fs from 'fs';
+import * as path from 'path';
+import SemanticReleaseError from '@semantic-release/error';
+import { defaultExec } from './exec.js';
+import { GomodConfig } from './plugin-config.js';
+import { createAndPushTag, deriveTagPrefix, discoverSubmoduleGoMods, readModulePath, updateGoModRequires, } from './gomod.js';
+/**
+ * Verify that all preconditions for the plugin are met:
+ *  - A root `go.mod` exists in the working directory.
+ *  - `git` is available on PATH.
+ *
+ * A warning (not an error) is emitted when no submodule go.mod files
+ * are found, since the plugin is still useful for single-module repos
+ * (it will create the root tag in the publish step).
+ *
+ * @param pluginConfig The plugin configuration.
+ * @param context      The semantic-release context.
+ * @param exec         Command executor (injectable for testing).
+ */
+export async function verifyConditions(pluginConfig, context, exec = defaultExec) {
+    const { logger } = context;
+    const cwd = context.cwd ?? process.cwd();
+    const config = new GomodConfig(pluginConfig);
+    const rootGoMod = path.join(cwd, 'go.mod');
+    if (!fs.existsSync(rootGoMod)) {
+        throw new SemanticReleaseError('go.mod not found.', 'EMISSINGGOMOD', `A \`go.mod\` file is required at the repository root but was not found in ${cwd}. Ensure the plugin is configured for a Go module repository.`);
+    }
+    try {
+        exec('git --version', { stdio: 'pipe' });
+    }
+    catch {
+        throw new SemanticReleaseError('git is not available.', 'ENOGIT', 'The `git` executable could not be found. Ensure git is installed and available on PATH.');
+    }
+    const submodules = discoverSubmoduleGoMods(cwd, config.getModules());
+    if (submodules.length === 0) {
+        logger.log('No submodule go.mod files found — operating in single-module mode.');
+    }
+    else {
+        logger.log('Found %d submodule(s).', submodules.length);
+    }
+}
+/**
+ * Pin every submodule `go.mod` require line that references the root
+ * module (or any of its sub-paths) to the new release version.
+ *
+ * Optionally runs `go mod tidy` in each submodule directory afterward.
+ * The actual commit is handled by `@semantic-release/git`.
+ *
+ * @param pluginConfig The plugin configuration.
+ * @param context      The semantic-release context.
+ * @param exec         Command executor (injectable for testing).
+ */
+export async function prepare(pluginConfig, context, exec = defaultExec) {
+    const { logger, nextRelease: { version }, } = context;
+    const cwd = context.cwd ?? process.cwd();
+    const config = new GomodConfig(pluginConfig);
+    const rootGoMod = path.join(cwd, 'go.mod');
+    const rootModule = readModulePath(rootGoMod);
+    logger.log('Root module: %s', rootModule);
+    const submodules = discoverSubmoduleGoMods(cwd, config.getModules());
+    if (submodules.length === 0) {
+        logger.log('No submodules to update.');
+        return;
+    }
+    for (const goModPath of submodules) {
+        logger.log('Pinning requires in %s', path.relative(cwd, goModPath));
+        updateGoModRequires(goModPath, rootModule, version);
+        if (!config.isSkipGoModTidy()) {
+            const modDir = path.dirname(goModPath);
+            try {
+                exec('go mod tidy', { cwd: modDir, stdio: 'pipe' });
+                logger.log('go mod tidy OK in %s', path.relative(cwd, modDir));
+            }
+            catch (err) {
+                const msg = err instanceof Error ? err.message : String(err);
+                logger.warn('go mod tidy failed in %s: %s', path.relative(cwd, modDir), msg);
+            }
+        }
+    }
+    logger.log('Prepared %d submodule(s) for v%s.', submodules.length, version);
+}
+/**
+ * Create and push a git tag for every module in the repository,
+ * including the root module.
+ *
+ * semantic-release creates the root tag (`vX.Y.Z`) before calling
+ * publish; this step creates it silently when it already exists and
+ * then creates all submodule tags
+ * (e.g. `assert/cert/manager/vX.Y.Z`).
+ *
+ * @param pluginConfig The plugin configuration.
+ * @param context      The semantic-release context.
+ * @param exec         Command executor (injectable for testing).
+ */
+export async function publish(pluginConfig, context, exec = defaultExec) {
+    const { logger, nextRelease: { version }, } = context;
+    const cwd = context.cwd ?? process.cwd();
+    const config = new GomodConfig(pluginConfig);
+    // All go.mod files: submodules + root
+    const submodules = discoverSubmoduleGoMods(cwd, config.getModules());
+    const allGoMods = [
+        path.join(cwd, 'go.mod'),
+        ...submodules,
+    ];
+    for (const goModPath of allGoMods) {
+        const prefix = deriveTagPrefix(goModPath, cwd);
+        const tag = prefix ? `${prefix}/v${version}` : `v${version}`;
+        createAndPushTag(cwd, tag, config.isPushTagsEnabled(), logger, exec);
+    }
+    logger.log('Tagged %d module(s) at v%s.', allGoMods.length, version);
+}
+export default { verifyConditions, prepare, publish };
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/plugin-config.d.ts

@@ -0,0 +1,58 @@
+import type { Config } from 'semantic-release';
+/**
+ * Raw plugin configuration as provided by the user in their
+ * semantic-release config file. All fields are optional — the
+ * plugin works with zero configuration by auto-detecting all
+ * submodule go.mod files in the repository.
+ */
+export interface GomodPluginConfig extends Config {
+    /**
+     * Glob patterns (relative to cwd) that match submodule go.mod files.
+     * When omitted, the plugin walks the repository and treats every
+     * go.mod file except the root-level one as a submodule.
+     *
+     * @example ["assert/**\/go.mod", "env/**\/go.mod"]
+     */
+    readonly modules?: string | readonly string[];
+    /**
+     * Skip running `go mod tidy` in each submodule directory after
+     * pinning the require version. Useful when Go is not available in
+     * the CI environment or for debugging. Defaults to false.
+     */
+    readonly skipGoModTidy?: boolean;
+    /**
+     * Push the created submodule tags to the remote origin after
+     * creating them locally. Set to false to create tags locally only.
+     * Defaults to true.
+     */
+    readonly pushTags?: boolean;
+}
+/**
+ * GomodConfig wraps the raw plugin config and exposes derived values
+ * with sensible defaults. It centralises option reading so the plugin
+ * lifecycle hooks stay small and consistent.
+ */
+export declare class GomodConfig {
+    private readonly config;
+    constructor(config: GomodPluginConfig);
+    /**
+     * Returns the user-supplied glob patterns for submodule go.mod files,
+     * normalised to an array. Returns undefined when not configured,
+     * which signals the plugin to auto-discover.
+     *
+     * @returns Readonly array of glob strings, or undefined for auto-detection.
+     */
+    getModules(): readonly string[] | undefined;
+    /**
+     * Whether to skip `go mod tidy` after pinning submodule versions.
+     *
+     * @returns true only when explicitly set to true.
+     */
+    isSkipGoModTidy(): boolean;
+    /**
+     * Whether to push submodule tags to origin after creating them.
+     *
+     * @returns true unless explicitly disabled.
+     */
+    isPushTagsEnabled(): boolean;
+}

package/dist/plugin-config.js

@@ -0,0 +1,43 @@
+/**
+ * GomodConfig wraps the raw plugin config and exposes derived values
+ * with sensible defaults. It centralises option reading so the plugin
+ * lifecycle hooks stay small and consistent.
+ */
+export class GomodConfig {
+    config;
+    constructor(config) {
+        this.config = config;
+    }
+    /**
+     * Returns the user-supplied glob patterns for submodule go.mod files,
+     * normalised to an array. Returns undefined when not configured,
+     * which signals the plugin to auto-discover.
+     *
+     * @returns Readonly array of glob strings, or undefined for auto-detection.
+     */
+    getModules() {
+        const { modules } = this.config;
+        if (!modules)
+            return undefined;
+        if (typeof modules === 'string')
+            return [modules];
+        return modules;
+    }
+    /**
+     * Whether to skip `go mod tidy` after pinning submodule versions.
+     *
+     * @returns true only when explicitly set to true.
+     */
+    isSkipGoModTidy() {
+        return this.config.skipGoModTidy === true;
+    }
+    /**
+     * Whether to push submodule tags to origin after creating them.
+     *
+     * @returns true unless explicitly disabled.
+     */
+    isPushTagsEnabled() {
+        return this.config.pushTags !== false;
+    }
+}
+//# sourceMappingURL=plugin-config.js.map

package/dist/plugin-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-config.js","sourceRoot":"","sources":["../src/plugin-config.ts"],"names":[],"mappings":"AAiCA;;;;GAIG;AACH,MAAM,OAAO,WAAW;IACO;IAA7B,YAA6B,MAAyB;QAAzB,WAAM,GAAN,MAAM,CAAmB;IAAG,CAAC;IAE1D;;;;;;OAMG;IACH,UAAU;QACR,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC;QAChC,IAAI,CAAC,OAAO;YAAE,OAAO,SAAS,CAAC;QAC/B,IAAI,OAAO,OAAO,KAAK,QAAQ;YAAE,OAAO,CAAC,OAAO,CAAC,CAAC;QAClD,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;;;OAIG;IACH,eAAe;QACb,OAAO,IAAI,CAAC,MAAM,CAAC,aAAa,KAAK,IAAI,CAAC;IAC5C,CAAC;IAED;;;;OAIG;IACH,iBAAiB;QACf,OAAO,IAAI,CAAC,MAAM,CAAC,QAAQ,KAAK,KAAK,CAAC;IACxC,CAAC;CACF"}

package/package.json

@@ -0,0 +1,73 @@
+{
+  "name": "@mridang/semantic-release-gomod",
+  "version": "1.0.0",
+  "type": "module",
+  "scripts": {
+    "prepack": "tsc",
+    "build": "tsc",
+    "test": "jest --verbose --config=jest.config.mjs --runInBand",
+    "test:watch": "npm run test -- --watch",
+    "test:debug": "jest --verbose --config=jest.config.mjs --runInBand --detectOpenHandles",
+    "format": "prettier --write .",
+    "format:check": "prettier --check .",
+    "lint": "npx eslint .",
+    "lint:fix": "npx eslint . --fix"
+  },
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "keywords": [
+    "semver",
+    "nodejs",
+    "semantic-release",
+    "go",
+    "golang",
+    "gomod"
+  ],
+  "author": {
+    "name": "Mridang Agarwalla",
+    "email": "mridang.agarwalla@gmail.com",
+    "url": "https://github.com/mridang"
+  },
+  "files": [
+    "dist"
+  ],
+  "license": "Apache-2.0",
+  "description": "Semantic Release plugin for multi-module Go repositories: pins submodule require lines and creates per-module git tags",
+  "private": false,
+  "engines": {
+    "node": ">=22.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/mridang/semantic-release-gomod.git"
+  },
+  "homepage": "https://github.com/mridang/semantic-release-gomod",
+  "bugs": "https://github.com/mridang/semantic-release-gomod/issues",
+  "dependencies": {
+    "@semantic-release/error": "^4.0.0"
+  },
+  "devDependencies": {
+    "@jest/globals": "^30.0.3",
+    "@mridang/eslint-defaults": "^1.4.0",
+    "@semantic-release/commit-analyzer": "^13.0.1",
+    "@semantic-release/git": "^10.0.1",
+    "@semantic-release/github": "^12.0.0",
+    "@semantic-release/npm": "^13.1.1",
+    "@semantic-release/release-notes-generator": "^14.1.0",
+    "@tsconfig/node22": "^22.0.2",
+    "@types/jest": "^30.0.0",
+    "@types/node": "^22.18.12",
+    "@types/semantic-release__error": "^3.0.3",
+    "eslint": "^9.27.0",
+    "jest": "^30.0.3",
+    "jest-junit": "^17.0.0",
+    "knip": "^5.43.6",
+    "prettier": "^3.1.1",
+    "semantic-release": "^25.0.1",
+    "ts-jest": "^29.4.0",
+    "typescript": "^5.9.3"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}