eslint: ensure we don’t publish an alpha version with the latest tag (#41790)

GitOrigin-RevId: 8977d1e17e50b11916d1e86be5356b43e192de11

Author: Nicolapps

npm-packages/@convex-dev/eslint-plugin/package.json

@@ -10,7 +10,8 @@
     "test:watch": "vitest",
     "prepare": "tshy",
     "lint": "eslint .",
-    "prepublishOnly": "node src/scripts/checkVersion.mjs"
+    "prepublishOnly": "node src/scripts/check-version.mjs",
+    "prepack": "node src/scripts/dont-publish-alpha-as-latest.mjs"
   },
   "dependencies": {
     "@typescript-eslint/utils": "~8.38.0"

npm-packages/@convex-dev/eslint-plugin/src/scripts/checkVersion.mjs renamed to npm-packages/@convex-dev/eslint-plugin/src/scripts/check-version.mjs

@@ -0,0 +1,49 @@
+#!/usr/bin/env node
+
+import { fileURLToPath } from "node:url";
+import { dirname, join } from "node:path";
+import { readFileSync } from "node:fs";
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+
+const packageJsonPath = join(__dirname, "../../package.json");
+const packageJson = JSON.parse(readFileSync(packageJsonPath, "utf-8"));
+const version = packageJson.version;
+
+// Check if this is an alpha version
+const isAlpha = version.includes("alpha") || version.includes("-alpha.");
+
+if (isAlpha) {
+  // For alpha versions, require --tag=alpha
+  const npmTag = process.env.npm_config_tag;
+
+  if (!npmTag || npmTag === "latest") {
+    console.error(
+      `❌ Alpha version ${version} cannot be published to "latest" tag`,
+    );
+    console.error("Use: npm publish --tag=alpha");
+    process.exit(1);
+  }
+
+  if (npmTag !== "alpha") {
+    console.error(
+      `❌ Alpha version ${version} should use --tag=alpha, not --tag=${npmTag}`,
+    );
+    console.error("Use: npm publish --tag=alpha");
+    process.exit(1);
+  }
+
+  console.log(`✅ Publishing alpha version ${version} with --tag=alpha`);
+} else {
+  // For stable versions, warn if not using latest
+  const npmTag = process.env.npm_config_tag;
+  if (npmTag && npmTag !== "latest") {
+    console.warn(
+      `⚠️  Publishing stable version ${version} with --tag=${npmTag}`,
+    );
+    console.warn("Did you mean to use --tag=latest or no tag?");
+  } else {
+    console.log(`✅ Publishing stable version ${version}`);
+  }
+}