chore(release): 🚀 add custom workspace publish and version sync scripts

* Introduce `publish-workspace.js` to handle npm publishing for workspaces, including dry-run support and version syncing.
* Add `sync-workspace-versions.js` to synchronize root version to workspace packages post-bump.
* Update `.release-it.json` to integrate new scripts into release workflow and improve workspace publishing reliability.

Signed-off-by: Justin Wiegmann <wiegmann@e-spirit.com>

Author: spirit-wiegmann

.release-it.json

@@ -22,6 +22,7 @@
       "npm run test"
     ],
     "after:bump": [
+      "node scripts/sync-workspace-versions.js",
       "npm run build"
     ],
     "after:release": "echo Successfully released ${name} v${version} to ${repo.repository}."
@@ -38,11 +39,8 @@
         "proxy"
       ],
       "publish": true,
-      "additionalManifests": {
-        "versionUpdates": [
-          "proxy/package.json"
-        ]
-      }
+      "skipChecks": true,
+      "publishCommand": "node scripts/publish-workspace.js"
     }
   }
 }

scripts/publish-workspace.js

@@ -0,0 +1,68 @@
+#!/usr/bin/env node
+
+/**
+ * Custom publish script for workspace packages.
+ * This script handles the actual npm publish for workspaces,
+ * and correctly handles dry-run mode by syncing versions first.
+ * 
+ * Environment variables provided by @release-it-plugins/workspaces:
+ * - RELEASE_IT_WORKSPACES_PATH_TO_WORKSPACE: relative path to workspace
+ * - RELEASE_IT_WORKSPACES_TAG: npm dist-tag (e.g., 'latest')
+ * - RELEASE_IT_WORKSPACES_ACCESS: access level ('public' or 'restricted')
+ * - RELEASE_IT_WORKSPACES_OTP: one-time password for 2FA (optional)
+ * - RELEASE_IT_WORKSPACES_DRY_RUN: 'true' if this is a dry run
+ */
+
+const { execSync } = require('child_process');
+const fs = require('fs');
+const path = require('path');
+
+const workspacePath = process.env.RELEASE_IT_WORKSPACES_PATH_TO_WORKSPACE;
+const tag = process.env.RELEASE_IT_WORKSPACES_TAG || 'latest';
+const access = process.env.RELEASE_IT_WORKSPACES_ACCESS || 'public';
+const otp = process.env.RELEASE_IT_WORKSPACES_OTP;
+const isDryRun = process.env.RELEASE_IT_WORKSPACES_DRY_RUN === 'true';
+
+if (!workspacePath) {
+  console.error('Error: RELEASE_IT_WORKSPACES_PATH_TO_WORKSPACE not set');
+  process.exit(1);
+}
+
+// Sync version from root package.json to workspace package.json
+// This is needed because in dry-run mode, the after:bump hook doesn't execute
+const rootPackagePath = path.join(__dirname, '..', 'package.json');
+const workspacePackagePath = path.join(__dirname, '..', workspacePath, 'package.json');
+
+try {
+  const rootPackage = JSON.parse(fs.readFileSync(rootPackagePath, 'utf8'));
+  const workspacePackage = JSON.parse(fs.readFileSync(workspacePackagePath, 'utf8'));
+  
+  if (rootPackage.version !== workspacePackage.version) {
+    console.log(`Syncing version: ${workspacePackage.version} -> ${rootPackage.version}`);
+    workspacePackage.version = rootPackage.version;
+    fs.writeFileSync(workspacePackagePath, JSON.stringify(workspacePackage, null, 2) + '\n');
+  }
+} catch (error) {
+  console.error('Error syncing version:', error.message);
+  process.exit(1);
+}
+
+// Build the npm publish command
+let command = `npm publish ./${workspacePath} --tag ${tag} --access ${access}`;
+if (otp) {
+  command += ` --otp ${otp}`;
+}
+if (isDryRun) {
+  command += ' --dry-run';
+}
+
+console.log(`Publishing ${workspacePath}...`);
+console.log(`Command: ${command}`);
+
+try {
+  execSync(command, { stdio: 'inherit' });
+  console.log(`Successfully published ${workspacePath}`);
+} catch (error) {
+  console.error(`Failed to publish ${workspacePath}:`, error.message);
+  process.exit(1);
+}

scripts/sync-workspace-versions.js

@@ -0,0 +1,40 @@
+#!/usr/bin/env node
+
+/**
+ * Synchronizes the version from root package.json to all workspace package.json files.
+ * Used as a release-it hook after version bump.
+ */
+
+const fs = require('fs');
+const path = require('path');
+
+const rootPackagePath = path.join(__dirname, '..', 'package.json');
+const workspaces = ['proxy'];
+
+try {
+  const rootPackage = JSON.parse(fs.readFileSync(rootPackagePath, 'utf8'));
+  const newVersion = rootPackage.version;
+
+  console.log(`Syncing version ${newVersion} to workspaces...`);
+
+  workspaces.forEach((workspace) => {
+    const workspacePackagePath = path.join(__dirname, '..', workspace, 'package.json');
+    
+    if (fs.existsSync(workspacePackagePath)) {
+      const workspacePackage = JSON.parse(fs.readFileSync(workspacePackagePath, 'utf8'));
+      const oldVersion = workspacePackage.version;
+      
+      workspacePackage.version = newVersion;
+      fs.writeFileSync(workspacePackagePath, JSON.stringify(workspacePackage, null, 2) + '\n');
+      
+      console.log(`  ${workspace}/package.json: ${oldVersion} -> ${newVersion}`);
+    } else {
+      console.warn(`  Warning: ${workspacePackagePath} not found`);
+    }
+  });
+
+  console.log('Version sync complete.');
+} catch (error) {
+  console.error('Error syncing versions:', error.message);
+  process.exit(1);
+}