fix(upgrade): improve CLI usability for monorepos and CI (#7874)

Author: jacekradko

.changeset/fix-upgrade-cli-usability.md

@@ -0,0 +1,5 @@
+---
+'@clerk/upgrade': patch
+---
+
+Improve CLI usability for monorepos: traverse parent directories for pnpm workspace detection and support named catalogs in version resolution

packages/upgrade/src/__tests__/fixtures/monorepo-workspace-catalog/apps/web/package.json

@@ -0,0 +1,9 @@
+{
+  "name": "test-web-app",
+  "version": "1.0.0",
+  "dependencies": {
+    "@clerk/nextjs": "catalog:",
+    "next": "catalog:",
+    "react": "catalog:"
+  }
+}

packages/upgrade/src/__tests__/fixtures/monorepo-workspace-catalog/package.json

@@ -0,0 +1,8 @@
+{
+  "name": "test-monorepo-root",
+  "version": "1.0.0",
+  "private": true,
+  "dependencies": {
+    "@clerk/backend": "^1.0.0"
+  }
+}

packages/upgrade/src/__tests__/fixtures/monorepo-workspace-catalog/pnpm-lock.yaml

@@ -0,0 +1,7 @@
+packages:
+  - 'apps/*'
+
+catalog:
+  '@clerk/nextjs': ^6.0.0
+  next: ^14.0.0
+  react: ^18.0.0

packages/upgrade/src/__tests__/fixtures/monorepo-workspace-catalog/pnpm-workspace.yaml

@@ -0,0 +1,9 @@
+{
+  "name": "test-nextjs-catalog-resolved",
+  "version": "1.0.0",
+  "dependencies": {
+    "@clerk/nextjs": "catalog:",
+    "next": "^14.0.0",
+    "react": "^18.0.0"
+  }
+}

packages/upgrade/src/__tests__/fixtures/nextjs-catalog-resolved/package.json

@@ -0,0 +1,7 @@
+packages:
+  - 'packages/*'
+
+catalog:
+  '@clerk/nextjs': ^6.0.0
+  next: ^14.0.0
+  react: ^18.0.0

packages/upgrade/src/__tests__/fixtures/nextjs-catalog-resolved/pnpm-lock.yaml

@@ -0,0 +1,9 @@
+import { ClerkProvider } from '@clerk/nextjs';
+
+export default function App() {
+  return (
+    <ClerkProvider>
+      <div>Hello</div>
+    </ClerkProvider>
+  );
+}

packages/upgrade/src/__tests__/fixtures/nextjs-catalog-resolved/pnpm-workspace.yaml

@@ -0,0 +1,9 @@
+{
+  "name": "test-nextjs-named-catalog",
+  "version": "1.0.0",
+  "dependencies": {
+    "@clerk/nextjs": "catalog:clerk",
+    "next": "^14.0.0",
+    "react": "catalog:peer-react"
+  }
+}