@clerk/upgrade 2.0.0-snapshot.v20251203203405 → 2.0.0-snapshot.v20251204175016

package/dist/codemods/index.js

@@ -3,7 +3,7 @@ import { fileURLToPath } from 'node:url';
 import { globby } from 'globby';
 import { run } from 'jscodeshift/src/Runner.js';
 const __dirname = dirname(fileURLToPath(import.meta.url));
-export async function runCodemod(transform = 'transform-async-request', glob, options) {
+export async function runCodemod(transform = 'transform-async-request', glob, options = {}) {
   if (!transform) {
     throw new Error('No transform provided');
   }
@@ -16,10 +16,17 @@ export async function runCodemod(transform = 'transform-async-request', glob, op
     '**/*.(css|scss|sass|less|styl)+' // common style files
     ]
   });
-  return await run(resolvedPath, paths ?? [], {
+  const clerkUpgradeStats = options.clerkUpgradeStats ?? {};
+  const result = await run(resolvedPath, paths ?? [], {
     dry: false,
     ...options,
+    // expose a mutable stats bag so individual transforms can record structured information
+    clerkUpgradeStats,
     // we must silence stdout to prevent output from interfering with ink CLI
     silent: true
   });
+  return {
+    ...result,
+    clerkUpgradeStats
+  };
 }

package/dist/codemods/transform-remove-deprecated-props.cjs

@@ -20,12 +20,14 @@ const COMPONENT_REDIRECT_ATTR = new Map([['ClerkProvider', {
 const COMPONENTS_WITH_USER_BUTTON_REMOVALS = new Map([['UserButton', ['afterSignOutUrl', 'afterMultiSessionSingleSignOutUrl']]]);
 const ORGANIZATION_SWITCHER_RENAMES = new Map([['afterSwitchOrganizationUrl', 'afterSelectOrganizationUrl']]);
 module.exports = function transformDeprecatedProps({
-  source
+  source,
+  path: filePath
 }, {
   jscodeshift: j
-}) {
+}, options = {}) {
   const root = j(source);
   let dirty = false;
+  const stats = options.clerkUpgradeStats;
   const {
     namedImports,
     namespaceImports
@@ -39,12 +41,29 @@ module.exports = function transformDeprecatedProps({
     if (COMPONENTS_WITH_HIDE_SLUG.has(canonicalName)) {
       if (removeJsxAttribute(j, jsxNode, 'hideSlug')) {
         dirty = true;
+        if (stats) {
+          stats.hideSlugRemoved = (stats.hideSlugRemoved || 0) + 1;
+          stats.hideSlugFiles = stats.hideSlugFiles || [];
+          if (!stats.hideSlugFiles.includes(filePath)) {
+            stats.hideSlugFiles.push(filePath);
+          }
+        }
       }
     }
     if (COMPONENTS_WITH_USER_BUTTON_REMOVALS.has(canonicalName)) {
-      for (const attrName of COMPONENTS_WITH_USER_BUTTON_REMOVALS.get(canonicalName)) {
+      const propsToRemove = COMPONENTS_WITH_USER_BUTTON_REMOVALS.get(canonicalName);
+      let removedCount = 0;
+      for (const attrName of propsToRemove) {
         if (removeJsxAttribute(j, jsxNode, attrName)) {
           dirty = true;
+          removedCount += 1;
+        }
+      }
+      if (removedCount > 0 && stats) {
+        stats.userbuttonAfterSignOutPropsRemoved = (stats.userbuttonAfterSignOutPropsRemoved || 0) + removedCount;
+        stats.userbuttonFilesAffected = stats.userbuttonFilesAffected || [];
+        if (!stats.userbuttonFilesAffected.includes(filePath)) {
+          stats.userbuttonFilesAffected.push(filePath);
         }
       }
     }
@@ -96,7 +115,7 @@ module.exports = function transformDeprecatedProps({
   if (renameObjectProperties(root, j, 'activeSessions', 'signedInSessions')) {
     dirty = true;
   }
-  if (transformSetActiveBeforeEmit(root, j)) {
+  if (transformSetActiveBeforeEmit(root, j, stats, filePath)) {
     dirty = true;
   }
   if (renameTypeReferences(root, j, 'ClerkMiddlewareAuthObject', 'ClerkMiddlewareSessionAuthObject')) {
@@ -319,7 +338,7 @@ function renameTSPropertySignatures(root, j, oldName, newName) {
   });
   return changed;
 }
-function transformSetActiveBeforeEmit(root, j) {
+function transformSetActiveBeforeEmit(root, j, stats, filePath) {
   let changed = false;
   root.find(j.CallExpression).filter(path => isSetActiveCall(path.node.callee)).forEach(path => {
     const [args0] = path.node.arguments;
@@ -343,6 +362,13 @@ function transformSetActiveBeforeEmit(root, j) {
     const navigateProp = j.objectProperty(j.identifier('navigate'), buildNavigateArrowFunction(j, originalValue));
     args0.properties.splice(beforeEmitIndex, 1, navigateProp);
     changed = true;
+    if (stats) {
+      stats.beforeEmitTransformed = (stats.beforeEmitTransformed || 0) + 1;
+      stats.beforeEmitFiles = stats.beforeEmitFiles || [];
+      if (!stats.beforeEmitFiles.includes(filePath)) {
+        stats.beforeEmitFiles.push(filePath);
+      }
+    }
   });
   return changed;
 }

package/dist/components/Codemod.js

@@ -77,7 +77,73 @@ export function Codemod(props) {
     color: "yellow"
   }, result.skip ?? 0, " skipped"), /*#__PURE__*/React.createElement(Text, {
     color: "gray"
-  }, result.nochange ?? 0, " unmodified"), result.timeElapsed && /*#__PURE__*/React.createElement(Text, null, "Time elapsed: ", result.timeElapsed), /*#__PURE__*/React.createElement(Newline, null)), error && /*#__PURE__*/React.createElement(Text, {
+  }, result.nochange ?? 0, " unmodified"), result.timeElapsed && /*#__PURE__*/React.createElement(Text, null, "Time elapsed: ", result.timeElapsed), transform === 'transform-remove-deprecated-props' && /*#__PURE__*/React.createElement(ManualInterventionSummary, {
+    stats: result.clerkUpgradeStats
+  }), /*#__PURE__*/React.createElement(Newline, null)), error && /*#__PURE__*/React.createElement(Text, {
     color: "red"
   }, error.message));
+}
+function ManualInterventionSummary({
+  stats
+}) {
+  if (!stats) {
+    return null;
+  }
+  const hasUserButtonChanges = stats.userbuttonAfterSignOutPropsRemoved > 0;
+  const hasHideSlugChanges = stats.hideSlugRemoved > 0;
+  const hasBeforeEmitChanges = stats.beforeEmitTransformed > 0;
+  if (!hasUserButtonChanges && !hasHideSlugChanges && !hasBeforeEmitChanges) {
+    return null;
+  }
+  return /*#__PURE__*/React.createElement(React.Fragment, null, /*#__PURE__*/React.createElement(Newline, null), /*#__PURE__*/React.createElement(Text, {
+    bold: true,
+    color: "yellow"
+  }, "\u26A0\uFE0F Manual intervention may be required:"), hasUserButtonChanges && /*#__PURE__*/React.createElement(React.Fragment, null, /*#__PURE__*/React.createElement(Newline, null), /*#__PURE__*/React.createElement(Text, {
+    color: "yellow"
+  }, "\u2022 Removed ", stats.userbuttonAfterSignOutPropsRemoved, " ", /*#__PURE__*/React.createElement(Text, {
+    bold: true
+  }, "UserButton"), " sign-out redirect prop(s)"), /*#__PURE__*/React.createElement(Text, {
+    color: "gray"
+  }, '  ', "Configure redirects via ", /*#__PURE__*/React.createElement(Text, {
+    italic: true
+  }, "ClerkProvider afterSignOutUrl"), " or", ' ', /*#__PURE__*/React.createElement(Text, {
+    italic: true
+  }, "SignOutButton redirectUrl")), /*#__PURE__*/React.createElement(FileList, {
+    files: stats.userbuttonFilesAffected
+  })), hasHideSlugChanges && /*#__PURE__*/React.createElement(React.Fragment, null, /*#__PURE__*/React.createElement(Newline, null), /*#__PURE__*/React.createElement(Text, {
+    color: "yellow"
+  }, "\u2022 Removed ", stats.hideSlugRemoved, " ", /*#__PURE__*/React.createElement(Text, {
+    bold: true
+  }, "hideSlug"), " prop(s)"), /*#__PURE__*/React.createElement(Text, {
+    color: "gray"
+  }, '  ', "This prop has been removed. Slug visibility is now controlled differently."), /*#__PURE__*/React.createElement(FileList, {
+    files: stats.hideSlugFiles
+  })), hasBeforeEmitChanges && /*#__PURE__*/React.createElement(React.Fragment, null, /*#__PURE__*/React.createElement(Newline, null), /*#__PURE__*/React.createElement(Text, {
+    color: "yellow"
+  }, "\u2022 Transformed ", stats.beforeEmitTransformed, " ", /*#__PURE__*/React.createElement(Text, {
+    bold: true
+  }, "setActive beforeEmit"), " to", ' ', /*#__PURE__*/React.createElement(Text, {
+    bold: true
+  }, "navigate")), /*#__PURE__*/React.createElement(Text, {
+    color: "gray"
+  }, '  ', "Callback signature changed: now receives ", /*#__PURE__*/React.createElement(Text, {
+    italic: true
+  }, "params"), " object instead of", ' ', /*#__PURE__*/React.createElement(Text, {
+    italic: true
+  }, "session"), " directly. Review the transformed code."), /*#__PURE__*/React.createElement(FileList, {
+    files: stats.beforeEmitFiles
+  })));
+}
+function FileList({
+  files
+}) {
+  if (!files?.length) {
+    return null;
+  }
+  return /*#__PURE__*/React.createElement(React.Fragment, null, /*#__PURE__*/React.createElement(Text, {
+    color: "gray"
+  }, '  ', "Files:"), files.map((file, index) => /*#__PURE__*/React.createElement(Text, {
+    key: index,
+    color: "gray"
+  }, '    ', "- ", file)));
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clerk/upgrade",
-  "version": "2.0.0-snapshot.v20251203203405",
+  "version": "2.0.0-snapshot.v20251204175016",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/clerk/javascript.git",