feat: add post-merge releases, pre-release support, fix ESM build

- Add post-merge release: git tags, GitHub Releases, spec attachments
- Add pre-release-tag input for beta/rc versions
- Add new inputs: create-releases, tag-prefix, attach-specs
- Add new outputs: bumped-versions, release-urls, created-tags
- Fix ESM build (format: esm in tsup.config.ts)
- Use shared diffContracts from CLI instead of duplicated logic
- Integrate VersionManager for actual versioning

Author: omermorad

action.yml

@@ -32,6 +32,21 @@ inputs:
     description: 'Branch name for Version Contracts PR'
     required: false
     default: 'contractual/version-contracts'
+  pre-release-tag:
+    description: 'Pre-release tag (e.g., "alpha", "beta", "rc") - creates versions like 2.0.0-beta.0'
+    required: false
+  create-releases:
+    description: 'Create GitHub Releases when Version PR merges'
+    required: false
+    default: 'true'
+  tag-prefix:
+    description: 'Tag format: "contract" for orders-api@1.0.0, "v" for v1.0.0, "none" for 1.0.0'
+    required: false
+    default: 'contract'
+  attach-specs:
+    description: 'Attach spec files to GitHub Releases as assets'
+    required: false
+    default: 'true'
 
 outputs:
   has-breaking:
@@ -42,6 +57,12 @@ outputs:
     description: 'Whether a changeset was auto-created'
   version-pr-url:
     description: 'URL of the Version Contracts PR (release mode)'
+  bumped-versions:
+    description: 'JSON of bumped versions (release mode), e.g. {"orders-api": "2.0.0", "order-schema": "1.1.0"}'
+  release-urls:
+    description: 'JSON array of created GitHub Release URLs (post-merge)'
+  created-tags:
+    description: 'JSON array of created git tags (post-merge)'
 
 runs:
   using: 'node20'

dist/index.js

@@ -21,6 +21,7 @@
   },
   "dependencies": {
     "@actions/core": "^1.10.1",
+    "@actions/exec": "^3.0.0",
     "@actions/github": "^6.0.0",
     "@octokit/rest": "^20.1.1"
   },

dist/index.js.map

@@ -0,0 +1,177 @@
+/**
+ * GitHub Release utilities
+ */
+
+import * as core from '@actions/core';
+import * as github from '@actions/github';
+import * as exec from '@actions/exec';
+import { readFileSync } from 'node:fs';
+import { basename } from 'node:path';
+import type { TagPrefix } from '../types.js';
+
+type Octokit = ReturnType<typeof github.getOctokit>;
+
+export interface ReleaseOptions {
+  /** Git tag name (e.g., "orders-api@2.0.0") */
+  tagName: string;
+  /** Release title (e.g., "orders-api v2.0.0") */
+  releaseName: string;
+  /** Release body (markdown) */
+  body: string;
+  /** Whether this is a pre-release */
+  prerelease: boolean;
+}
+
+export interface ReleaseResult {
+  /** GitHub Release URL */
+  url: string;
+  /** GitHub Release ID (for uploading assets) */
+  id: number;
+}
+
+export interface AssetInfo {
+  /** Display name for the asset */
+  name: string;
+  /** Path to the file to upload */
+  path: string;
+}
+
+/**
+ * Format a git tag based on the tag prefix setting
+ *
+ * @param contractName - Contract name (e.g., "orders-api")
+ * @param version - Version string (e.g., "2.0.0")
+ * @param prefix - Tag prefix format
+ * @returns Formatted tag name
+ *
+ * @example
+ * formatTag("orders-api", "2.0.0", "contract") // "orders-api@2.0.0"
+ * formatTag("orders-api", "2.0.0", "v")        // "v2.0.0"
+ * formatTag("orders-api", "2.0.0", "none")     // "2.0.0"
+ */
+export function formatTag(contractName: string, version: string, prefix: TagPrefix): string {
+  switch (prefix) {
+    case 'contract':
+      return `${contractName}@${version}`;
+    case 'v':
+      return `v${version}`;
+    case 'none':
+      return version;
+  }
+}
+
+/**
+ * Check if a version is a pre-release (contains hyphen)
+ *
+ * @example
+ * isPrerelease("2.0.0")        // false
+ * isPrerelease("2.0.0-beta.0") // true
+ */
+export function isPrerelease(version: string): boolean {
+  return version.includes('-');
+}
+
+/**
+ * Create a git tag using git CLI
+ *
+ * @param tagName - The tag name to create
+ * @param message - Tag message
+ */
+export async function createGitTag(tagName: string, message: string): Promise<void> {
+  core.info(`Creating git tag: ${tagName}`);
+
+  // Create annotated tag
+  await exec.exec('git', ['tag', '-a', tagName, '-m', message]);
+
+  // Push tag to remote
+  await exec.exec('git', ['push', 'origin', tagName]);
+
+  core.info(`Tag ${tagName} created and pushed`);
+}
+
+/**
+ * Create a GitHub Release
+ *
+ * @param octokit - Authenticated Octokit instance
+ * @param context - GitHub context
+ * @param options - Release options
+ * @returns Release URL and ID
+ */
+export async function createRelease(
+  octokit: Octokit,
+  context: typeof github.context,
+  options: ReleaseOptions
+): Promise<ReleaseResult> {
+  core.info(`Creating GitHub Release: ${options.releaseName}`);
+
+  const { data: release } = await octokit.rest.repos.createRelease({
+    owner: context.repo.owner,
+    repo: context.repo.repo,
+    tag_name: options.tagName,
+    name: options.releaseName,
+    body: options.body,
+    prerelease: options.prerelease,
+  });
+
+  core.info(`Release created: ${release.html_url}`);
+
+  return {
+    url: release.html_url,
+    id: release.id,
+  };
+}
+
+/**
+ * Upload an asset to an existing GitHub Release
+ *
+ * @param octokit - Authenticated Octokit instance
+ * @param context - GitHub context
+ * @param releaseId - The release ID to upload to
+ * @param asset - Asset info (name and path)
+ */
+export async function uploadReleaseAsset(
+  octokit: Octokit,
+  context: typeof github.context,
+  releaseId: number,
+  asset: AssetInfo
+): Promise<void> {
+  core.info(`Uploading asset: ${asset.name}`);
+
+  const fileContent = readFileSync(asset.path);
+
+  await octokit.rest.repos.uploadReleaseAsset({
+    owner: context.repo.owner,
+    repo: context.repo.repo,
+    release_id: releaseId,
+    name: asset.name,
+    data: fileContent as unknown as string,
+  });
+
+  core.info(`Asset uploaded: ${asset.name}`);
+}
+
+/**
+ * Check if a tag already exists
+ *
+ * @param octokit - Authenticated Octokit instance
+ * @param context - GitHub context
+ * @param tagName - Tag name to check
+ * @returns True if tag exists
+ */
+export async function tagExists(
+  octokit: Octokit,
+  context: typeof github.context,
+  tagName: string
+): Promise<boolean> {
+  try {
+    await octokit.rest.git.getRef({
+      owner: context.repo.owner,
+      repo: context.repo.repo,
+      ref: `tags/${tagName}`,
+    });
+    return true;
+  } catch (error) {
+    // 404 means tag doesn't exist
+    return false;
+  }
+}

package.json

@@ -1,7 +1,7 @@
 import * as core from '@actions/core';
 import { runPRCheck } from './modes/pr-check.js';
 import { runRelease } from './modes/release.js';
-import type { ActionInputs } from './types.js';
+import type { ActionInputs, TagPrefix } from './types.js';
 
 /**
  * Parse and validate action inputs
@@ -18,6 +18,12 @@ function getInputs(): ActionInputs {
     throw new Error('github-token is required');
   }
 
+  // Parse tag-prefix with validation
+  const tagPrefixInput = core.getInput('tag-prefix') || 'contract';
+  if (!['contract', 'v', 'none'].includes(tagPrefixInput)) {
+    throw new Error(`Invalid tag-prefix: "${tagPrefixInput}". Must be 'contract', 'v', or 'none'.`);
+  }
+
   return {
     mode,
     githubToken,
@@ -26,6 +32,10 @@ function getInputs(): ActionInputs {
     autoChangeset: core.getInput('auto-changeset') === 'true',
     versionPrTitle: core.getInput('version-pr-title') || 'Version Contracts',
     versionPrBranch: core.getInput('version-pr-branch') || 'contractual/version-contracts',
+    preReleaseTag: core.getInput('pre-release-tag') || undefined,
+    createReleases: core.getInput('create-releases') !== 'false',
+    tagPrefix: tagPrefixInput as TagPrefix,
+    attachSpecs: core.getInput('attach-specs') !== 'false',
   };
 }