#137 Add tooling for automated releases

package.json

@@ -18,7 +18,9 @@
     "test:coverage": "vitest run --coverage --coverage.reporter=text",
     "test:debug": "vitest --inspect-brk --no-file-parallelism",
     "test": "vitest run --reporter verbose",
-    "gen:component": "node generateComponent.js"
+    "gen:component": "node scripts/generateComponent.js",
+    "release:prepare": "node scripts/prepareRelease.js",
+    "release:finish": "node scripts/finishRelease.js"
   },
   "dependencies": {
     "@convex-dev/auth": "^0.0.80",
@@ -120,6 +122,7 @@
     "eslint-plugin-simple-import-sort": "^12.1.1",
     "husky": "^9.1.7",
     "sass": "^1.77.8",
+    "semver": "^7.7.2",
     "stylelint": "^16.9.0",
     "stylelint-config-clean-order": "^6.1.0",
     "stylelint-config-standard": "^36.0.1",

scripts/.eslintrc.cjs

@@ -0,0 +1,8 @@
+module.exports = {
+  env: {
+    node: true,
+  },
+  rules: {
+    'no-console': 'off'
+  }
+};

scripts/finishRelease.js

@@ -0,0 +1,36 @@
+import { execSync } from 'child_process';
+import semver from 'semver';
+
+const version = process.argv[2];
+if (!version || !semver.valid(version)) {
+  console.error('Please provide a valid semver version (e.g., 1.0.0)!');
+  process.exit(1);
+}
+
+const releaseBranch = `release-v${version}`;
+const tagName = `v${version}`;
+
+try {
+  console.log(`\nPublishing release ${version}...\n`);
+
+  execSync('git checkout main', { stdio: 'inherit' });
+  execSync('git pull origin main', { stdio: 'inherit' });
+  execSync(`git merge --no-ff ${releaseBranch} -m "Merge release ${version} into main"`, { stdio: 'inherit' });
+
+  execSync(`git tag -a ${tagName} -m "Release ${tagName}"`, { stdio: 'inherit' });
+  execSync('git push origin main');
+  execSync(`git push origin ${tagName}`);
+
+  execSync('git checkout develop', { stdio: 'inherit' });
+  execSync('git pull origin develop', { stdio: 'inherit' });
+  execSync(`git merge --no-ff ${releaseBranch} -m "Merge release ${version} into develop"`, { stdio: 'inherit' });
+  execSync('git push origin develop');
+
+  execSync(`git branch -d ${releaseBranch}`, { stdio: 'inherit' });
+  execSync(`git push origin --delete ${releaseBranch}`, { stdio: 'inherit' });
+
+  console.log(`\n✅ Release ${version} completed and cleaned up.\n`);
+} catch (err) {
+  console.error('❌ Failed to finish release:', err.message);
+  process.exit(1);
+}

scripts/prepareRelease.js

@@ -0,0 +1,33 @@
+import { execSync } from 'child_process';
+import semver from 'semver';
+
+const version = process.argv[2];
+if (!version || !semver.valid(version)) {
+  console.error('Please provide a valid semver version (e.g., 1.0.0)!');
+  process.exit(1);
+}
+
+const releaseBranch = `release-v${version}`;
+
+try {
+  console.log(`\n🚀 Preparing release ${version}...\n`);
+
+  execSync('git checkout develop', { stdio: 'inherit' });
+  execSync('git pull origin develop', { stdio: 'inherit' });
+
+  execSync(`git checkout -b ${releaseBranch}`, { stdio: 'inherit' });
+
+  execSync(`npm version ${version} --no-git-tag-version`, { stdio: 'inherit' });
+  execSync(`git commit -am "Prepare release v${version}"`, { stdio: 'inherit' });
+
+  execSync(`git push --set-upstream origin ${releaseBranch}`, { stdio: 'inherit' });
+
+  console.log(`\n📦 Creating pull request from '${releaseBranch}' to 'main'...\n`);
+
+  execSync(`gh pr create --base main --head ${releaseBranch} --title "Release v${version}" --body "This PR prepares release v${version}."`, { stdio: 'inherit' });
+
+  console.log(`\n✅ Release branch '${releaseBranch}' created and PR opened.\n`);
+} catch (err) {
+  console.error('❌ Failed to prepare release:', err.message);
+  process.exit(1);
+}