@clerk/upgrade 2.0.0-canary-core3.v20251203181537 → 2.0.0-snapshot.v20251203203405

package/dist/codemods/__tests__/__fixtures__/transform-remove-deprecated-props.fixtures.js

@@ -0,0 +1,199 @@
+export const fixtures = [{
+  name: 'ClerkProvider legacy redirect props',
+  source: `
+import { ClerkProvider } from '@clerk/nextjs';
+
+export function App({ children }) {
+  return (
+    <ClerkProvider
+      afterSignInUrl='/dashboard'
+      afterSignUpUrl='/welcome'
+    >
+      {children}
+    </ClerkProvider>
+  );
+}
+    `,
+  output: `
+import { ClerkProvider } from '@clerk/nextjs';
+
+export function App({ children }) {
+  return (
+    <ClerkProvider
+      signInFallbackRedirectUrl='/dashboard'
+      signUpFallbackRedirectUrl='/welcome'
+    >
+      {children}
+    </ClerkProvider>
+  );
+}
+    `
+}, {
+  name: 'SignIn legacy props',
+  source: `
+import { SignIn as MySignIn } from '@clerk/nextjs';
+
+export const Page = () => (
+  <MySignIn
+    afterSignInUrl='/home'
+    afterSignUpUrl='/after-sign-up'
+    fallbackRedirectUrl='/existing'
+  />
+);
+    `,
+  output: `
+import { SignIn as MySignIn } from '@clerk/nextjs';
+
+export const Page = () => (
+  <MySignIn
+    signUpFallbackRedirectUrl='/after-sign-up'
+    fallbackRedirectUrl='/existing' />
+);
+    `
+}, {
+  name: 'SignUp legacy props',
+  source: `
+import { SignUp } from '@clerk/react';
+
+export function Example() {
+  return (
+    <SignUp afterSignUpUrl='/done' afterSignInUrl='/in' />
+  );
+}
+    `,
+  output: `
+import { SignUp } from '@clerk/react';
+
+export function Example() {
+  return (<SignUp fallbackRedirectUrl='/done' signInFallbackRedirectUrl='/in' />);
+}
+    `
+}, {
+  name: 'ClerkProvider redirectUrl only',
+  source: `
+import { ClerkProvider } from '@clerk/react';
+
+export const Provider = ({ children }) => (
+  <ClerkProvider redirectUrl='/legacy'>{children}</ClerkProvider>
+);
+    `,
+  output: `
+import { ClerkProvider } from '@clerk/react';
+
+export const Provider = ({ children }) => (
+  <ClerkProvider signInFallbackRedirectUrl="/legacy" signUpFallbackRedirectUrl="/legacy">{children}</ClerkProvider>
+);
+    `
+}, {
+  name: 'SignIn redirectUrl only',
+  source: `
+import { SignIn } from '@clerk/nextjs';
+
+export const Page = () => <SignIn redirectUrl='/legacy' />;
+    `,
+  output: `
+import { SignIn } from '@clerk/nextjs';
+
+export const Page = () => <SignIn fallbackRedirectUrl="/legacy" />;
+    `
+}, {
+  name: 'UserButton and organization props',
+  source: `
+import { UserButton, OrganizationSwitcher, CreateOrganization } from '@clerk/react';
+
+export const Actions = () => (
+  <>
+    <UserButton afterSignOutUrl='/bye' afterMultiSessionSingleSignOutUrl='/multi' />
+    <OrganizationSwitcher hideSlug afterSwitchOrganizationUrl='/org' />
+    <CreateOrganization hideSlug />
+  </>
+);
+    `,
+  output: `
+import { UserButton, OrganizationSwitcher, CreateOrganization } from '@clerk/react';
+
+export const Actions = () => (
+  <>
+    <UserButton />
+    <OrganizationSwitcher afterSelectOrganizationUrl='/org' />
+    <CreateOrganization />
+  </>
+);
+    `
+}, {
+  name: 'Object literals and destructuring',
+  source: `
+const config = {
+  afterSignInUrl: '/one',
+  afterSignUpUrl: '/two',
+  activeSessions,
+};
+
+const { afterSignInUrl, afterSignUpUrl: custom, activeSessions: current } = config;
+    `,
+  output: `
+const config = {
+  signInFallbackRedirectUrl: '/one',
+  signUpFallbackRedirectUrl: '/two',
+  signedInSessions: activeSessions,
+};
+
+const { signInFallbackRedirectUrl: afterSignInUrl, signUpFallbackRedirectUrl: custom, signedInSessions: current } = config;
+    `
+}, {
+  name: 'Member expressions and optional chaining',
+  source: `
+const signInTarget = options.afterSignInUrl;
+const signUpTarget = options?.afterSignUpUrl;
+const fallback = options['afterSignInUrl'];
+const hasSessions = client?.activeSessions?.length > 0 && client['activeSessions'];
+    `,
+  output: `
+const signInTarget = options.signInFallbackRedirectUrl;
+const signUpTarget = options?.signUpFallbackRedirectUrl;
+const fallback = options["signInFallbackRedirectUrl"];
+const hasSessions = client?.signedInSessions?.length > 0 && client["signedInSessions"];
+    `
+}, {
+  name: 'setActive beforeEmit callback',
+  source: `
+await setActive({
+  session: '123',
+  beforeEmit: handleBeforeEmit,
+});
+    `,
+  output: `
+await setActive({
+  session: '123',
+  navigate: params => handleBeforeEmit(params.session),
+});
+    `
+}, {
+  name: 'ClerkMiddlewareAuthObject type rename',
+  source: `
+import type { ClerkMiddlewareAuthObject } from '@clerk/nextjs/server';
+
+type Handler = (auth: ClerkMiddlewareAuthObject) => void;
+    `,
+  output: `
+import type { ClerkMiddlewareSessionAuthObject } from '@clerk/nextjs/server';
+
+type Handler = (auth: ClerkMiddlewareSessionAuthObject) => void;
+    `
+}, {
+  name: 'Namespace import support',
+  source: `
+import * as Clerk from '@clerk/nextjs';
+
+export const Provider = ({ children }) => (
+  <Clerk.ClerkProvider redirectUrl='/deep' />
+);
+    `,
+  output: `
+import * as Clerk from '@clerk/nextjs';
+
+export const Provider = ({ children }) => (
+  <Clerk.ClerkProvider signInFallbackRedirectUrl="/deep" signUpFallbackRedirectUrl="/deep" />
+);
+    `
+}];

package/dist/codemods/__tests__/transform-remove-deprecated-props.test.js

@@ -0,0 +1,15 @@
+import { applyTransform } from 'jscodeshift/dist/testUtils';
+import { describe, expect, it } from 'vitest';
+import transformer from '../transform-remove-deprecated-props.cjs';
+import { fixtures } from './__fixtures__/transform-remove-deprecated-props.fixtures';
+describe('transform-remove-deprecated-props', () => {
+  it.each(fixtures)('$name', ({
+    source,
+    output
+  }) => {
+    const result = applyTransform(transformer, {}, {
+      source
+    });
+    expect(result).toEqual(output.trim());
+  });
+});

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

@@ -0,0 +1,426 @@
+const CLERK_PACKAGE_PREFIX = '@clerk/';
+const COMPONENTS_WITH_HIDE_SLUG = new Set(['CreateOrganization', 'OrganizationSwitcher', 'OrganizationList']);
+const COMPONENT_RENAMES = new Map([['ClerkProvider', {
+  afterSignInUrl: 'signInFallbackRedirectUrl',
+  afterSignUpUrl: 'signUpFallbackRedirectUrl'
+}], ['SignIn', {
+  afterSignInUrl: 'fallbackRedirectUrl',
+  afterSignUpUrl: 'signUpFallbackRedirectUrl'
+}], ['SignUp', {
+  afterSignInUrl: 'signInFallbackRedirectUrl',
+  afterSignUpUrl: 'fallbackRedirectUrl'
+}]]);
+const COMPONENT_REDIRECT_ATTR = new Map([['ClerkProvider', {
+  targetAttrs: ['signInFallbackRedirectUrl', 'signUpFallbackRedirectUrl']
+}], ['SignIn', {
+  targetAttrs: ['fallbackRedirectUrl']
+}], ['SignUp', {
+  targetAttrs: ['fallbackRedirectUrl']
+}]]);
+const COMPONENTS_WITH_USER_BUTTON_REMOVALS = new Map([['UserButton', ['afterSignOutUrl', 'afterMultiSessionSingleSignOutUrl']]]);
+const ORGANIZATION_SWITCHER_RENAMES = new Map([['afterSwitchOrganizationUrl', 'afterSelectOrganizationUrl']]);
+module.exports = function transformDeprecatedProps({
+  source
+}, {
+  jscodeshift: j
+}) {
+  const root = j(source);
+  let dirty = false;
+  const {
+    namedImports,
+    namespaceImports
+  } = collectClerkImports(root, j);
+  root.find(j.JSXOpeningElement).forEach(path => {
+    const canonicalName = getCanonicalComponentName(path.node.name, namedImports, namespaceImports);
+    if (!canonicalName) {
+      return;
+    }
+    const jsxNode = path.node;
+    if (COMPONENTS_WITH_HIDE_SLUG.has(canonicalName)) {
+      if (removeJsxAttribute(j, jsxNode, 'hideSlug')) {
+        dirty = true;
+      }
+    }
+    if (COMPONENTS_WITH_USER_BUTTON_REMOVALS.has(canonicalName)) {
+      for (const attrName of COMPONENTS_WITH_USER_BUTTON_REMOVALS.get(canonicalName)) {
+        if (removeJsxAttribute(j, jsxNode, attrName)) {
+          dirty = true;
+        }
+      }
+    }
+    if (COMPONENT_RENAMES.has(canonicalName)) {
+      const renameMap = COMPONENT_RENAMES.get(canonicalName);
+      for (const [oldName, newName] of Object.entries(renameMap)) {
+        if (renameJsxAttribute(j, jsxNode, oldName, newName)) {
+          dirty = true;
+        }
+      }
+    }
+    if (COMPONENT_REDIRECT_ATTR.has(canonicalName)) {
+      if (handleRedirectAttribute(j, jsxNode, canonicalName)) {
+        dirty = true;
+      }
+    }
+    if (canonicalName === 'OrganizationSwitcher') {
+      for (const [oldName, newName] of ORGANIZATION_SWITCHER_RENAMES) {
+        if (renameJsxAttribute(j, jsxNode, oldName, newName)) {
+          dirty = true;
+        }
+      }
+    }
+  });
+  if (renameObjectProperties(root, j, 'afterSignInUrl', 'signInFallbackRedirectUrl')) {
+    dirty = true;
+  }
+  if (renameObjectProperties(root, j, 'afterSignUpUrl', 'signUpFallbackRedirectUrl')) {
+    dirty = true;
+  }
+  if (renameMemberExpressions(root, j, 'afterSignInUrl', 'signInFallbackRedirectUrl')) {
+    dirty = true;
+  }
+  if (renameMemberExpressions(root, j, 'afterSignUpUrl', 'signUpFallbackRedirectUrl')) {
+    dirty = true;
+  }
+  if (renameTSPropertySignatures(root, j, 'afterSignInUrl', 'signInFallbackRedirectUrl')) {
+    dirty = true;
+  }
+  if (renameTSPropertySignatures(root, j, 'afterSignUpUrl', 'signUpFallbackRedirectUrl')) {
+    dirty = true;
+  }
+  if (renameTSPropertySignatures(root, j, 'activeSessions', 'signedInSessions')) {
+    dirty = true;
+  }
+  if (renameMemberExpressions(root, j, 'activeSessions', 'signedInSessions')) {
+    dirty = true;
+  }
+  if (renameObjectProperties(root, j, 'activeSessions', 'signedInSessions')) {
+    dirty = true;
+  }
+  if (transformSetActiveBeforeEmit(root, j)) {
+    dirty = true;
+  }
+  if (renameTypeReferences(root, j, 'ClerkMiddlewareAuthObject', 'ClerkMiddlewareSessionAuthObject')) {
+    dirty = true;
+  }
+  return dirty ? root.toSource() : undefined;
+};
+module.exports.parser = 'tsx';
+function collectClerkImports(root, j) {
+  const namedImports = new Map();
+  const namespaceImports = new Set();
+  root.find(j.ImportDeclaration).forEach(path => {
+    const sourceVal = path.node.source.value;
+    if (typeof sourceVal !== 'string' || !sourceVal.startsWith(CLERK_PACKAGE_PREFIX)) {
+      return;
+    }
+    for (const specifier of path.node.specifiers || []) {
+      if (j.ImportSpecifier.check(specifier)) {
+        const localName = specifier.local ? specifier.local.name : specifier.imported.name;
+        namedImports.set(localName, specifier.imported.name);
+      } else if (j.ImportNamespaceSpecifier.check(specifier) || j.ImportDefaultSpecifier.check(specifier)) {
+        namespaceImports.add(specifier.local.name);
+      }
+    }
+  });
+  return {
+    namedImports,
+    namespaceImports
+  };
+}
+function getCanonicalComponentName(nameNode, namedImports, namespaceImports) {
+  if (!nameNode) {
+    return null;
+  }
+  if (nameNode.type === 'JSXIdentifier') {
+    return namedImports.get(nameNode.name) || nameNode.name;
+  }
+  if (nameNode.type === 'JSXMemberExpression') {
+    const identifierName = getNamespaceMemberName(nameNode, namespaceImports);
+    if (identifierName) {
+      return identifierName;
+    }
+  }
+  return null;
+}
+function getNamespaceMemberName(memberNode, namespaceImports) {
+  if (memberNode.object.type === 'JSXIdentifier') {
+    return namespaceImports.has(memberNode.object.name) ? memberNode.property.name : null;
+  }
+  if (memberNode.object.type === 'JSXMemberExpression') {
+    const resolved = getNamespaceMemberName(memberNode.object, namespaceImports);
+    return resolved ? memberNode.property.name : null;
+  }
+  return null;
+}
+function renameJsxAttribute(j, jsxNode, oldName, newName) {
+  if (!jsxNode.attributes) {
+    return false;
+  }
+  const attrIndex = jsxNode.attributes.findIndex(attr => isJsxAttrNamed(attr, oldName));
+  if (attrIndex === -1) {
+    return false;
+  }
+  const targetExists = jsxNode.attributes.some(attr => isJsxAttrNamed(attr, newName));
+  if (targetExists) {
+    jsxNode.attributes.splice(attrIndex, 1);
+    return true;
+  }
+  const attribute = jsxNode.attributes[attrIndex];
+  attribute.name.name = newName;
+  return true;
+}
+function removeJsxAttribute(j, jsxNode, name) {
+  if (!jsxNode.attributes) {
+    return false;
+  }
+  const initialLength = jsxNode.attributes.length;
+  jsxNode.attributes = jsxNode.attributes.filter(attr => !isJsxAttrNamed(attr, name));
+  return jsxNode.attributes.length !== initialLength;
+}
+function isJsxAttrNamed(attribute, name) {
+  return attribute && attribute.type === 'JSXAttribute' && attribute.name && attribute.name.name === name;
+}
+function handleRedirectAttribute(j, jsxNode, canonicalName) {
+  if (!jsxNode.attributes) {
+    return false;
+  }
+  const data = COMPONENT_REDIRECT_ATTR.get(canonicalName);
+  const attrIndex = jsxNode.attributes.findIndex(attr => isJsxAttrNamed(attr, 'redirectUrl'));
+  if (attrIndex === -1) {
+    return false;
+  }
+  const redirectAttr = jsxNode.attributes[attrIndex];
+  const insertions = [];
+  for (const targetName of data.targetAttrs) {
+    if (!jsxNode.attributes.some(attr => isJsxAttrNamed(attr, targetName))) {
+      insertions.push(createJsxAttributeWithClonedValue(j, targetName, redirectAttr.value));
+    }
+  }
+  jsxNode.attributes.splice(attrIndex, 1, ...insertions);
+  return true;
+}
+function createJsxAttributeWithClonedValue(j, name, value) {
+  let clonedValue = null;
+  if (value) {
+    clonedValue = clone(value);
+  }
+  return j.jsxAttribute(j.jsxIdentifier(name), clonedValue);
+}
+function clone(node) {
+  return node ? JSON.parse(JSON.stringify(node)) : node;
+}
+function renameObjectProperties(root, j, oldName, newName) {
+  let changed = false;
+  root.find(j.ObjectProperty).forEach(path => {
+    if (!isPropertyKeyNamed(path.node.key, oldName)) {
+      return;
+    }
+    const originalLocalName = getLocalIdentifierName(path.node);
+    if (path.node.shorthand) {
+      path.node.shorthand = false;
+      const identifierName = originalLocalName || oldName;
+      path.node.value = j.identifier(identifierName);
+    }
+    if (path.node.key.type === 'Identifier') {
+      path.node.key.name = newName;
+    } else if (path.node.key.type === 'StringLiteral') {
+      path.node.key.value = newName;
+    } else if (path.node.key.type === 'Literal') {
+      path.node.key.value = newName;
+    }
+    changed = true;
+  });
+  return changed;
+}
+function getLocalIdentifierName(propertyNode) {
+  if (!propertyNode) {
+    return null;
+  }
+  if (propertyNode.value && propertyNode.value.type === 'Identifier') {
+    return propertyNode.value.name;
+  }
+  if (propertyNode.shorthand && propertyNode.key && propertyNode.key.type === 'Identifier') {
+    return propertyNode.key.name;
+  }
+  return null;
+}
+function isPropertyKeyNamed(keyNode, name) {
+  if (!keyNode) {
+    return false;
+  }
+  if (keyNode.type === 'Identifier') {
+    return keyNode.name === name;
+  }
+  if (keyNode.type === 'StringLiteral' || keyNode.type === 'Literal') {
+    return keyNode.value === name;
+  }
+  return false;
+}
+function renameMemberExpressions(root, j, oldName, newName) {
+  let changed = false;
+  root.find(j.MemberExpression, {
+    property: {
+      type: 'Identifier',
+      name: oldName
+    },
+    computed: false
+  }).forEach(path => {
+    path.node.property.name = newName;
+    changed = true;
+  });
+  root.find(j.MemberExpression, {
+    computed: true
+  }).forEach(path => {
+    if (path.node.property.type === 'Literal' && path.node.property.value === oldName) {
+      path.node.property.value = newName;
+      changed = true;
+    }
+    if (path.node.property.type === 'StringLiteral' && path.node.property.value === oldName) {
+      path.node.property.value = newName;
+      changed = true;
+    }
+  });
+  root.find(j.OptionalMemberExpression, {
+    property: {
+      type: 'Identifier',
+      name: oldName
+    },
+    computed: false
+  }).forEach(path => {
+    path.node.property.name = newName;
+    changed = true;
+  });
+  root.find(j.OptionalMemberExpression, {
+    computed: true
+  }).forEach(path => {
+    if (path.node.property.type === 'Literal' && path.node.property.value === oldName) {
+      path.node.property.value = newName;
+      changed = true;
+    }
+    if (path.node.property.type === 'StringLiteral' && path.node.property.value === oldName) {
+      path.node.property.value = newName;
+      changed = true;
+    }
+  });
+  return changed;
+}
+function renameTSPropertySignatures(root, j, oldName, newName) {
+  let changed = false;
+  root.find(j.TSPropertySignature).forEach(path => {
+    if (!isPropertyKeyNamed(path.node.key, oldName)) {
+      return;
+    }
+    if (path.node.key.type === 'Identifier') {
+      path.node.key.name = newName;
+    } else if (path.node.key.type === 'StringLiteral') {
+      path.node.key.value = newName;
+    }
+    changed = true;
+  });
+  return changed;
+}
+function transformSetActiveBeforeEmit(root, j) {
+  let changed = false;
+  root.find(j.CallExpression).filter(path => isSetActiveCall(path.node.callee)).forEach(path => {
+    const [args0] = path.node.arguments;
+    if (!args0 || args0.type !== 'ObjectExpression') {
+      return;
+    }
+    const beforeEmitIndex = args0.properties.findIndex(prop => isPropertyNamed(prop, 'beforeEmit'));
+    if (beforeEmitIndex === -1) {
+      return;
+    }
+    const beforeEmitProp = args0.properties[beforeEmitIndex];
+    if (!beforeEmitProp || beforeEmitProp.type !== 'ObjectProperty') {
+      return;
+    }
+    const originalValue = getPropertyValueExpression(beforeEmitProp.value);
+    if (!originalValue) {
+      args0.properties.splice(beforeEmitIndex, 1);
+      changed = true;
+      return;
+    }
+    const navigateProp = j.objectProperty(j.identifier('navigate'), buildNavigateArrowFunction(j, originalValue));
+    args0.properties.splice(beforeEmitIndex, 1, navigateProp);
+    changed = true;
+  });
+  return changed;
+}
+function isSetActiveCall(callee) {
+  if (!callee) {
+    return false;
+  }
+  if (callee.type === 'Identifier') {
+    return callee.name === 'setActive';
+  }
+  if (callee.type === 'MemberExpression' || callee.type === 'OptionalMemberExpression') {
+    const property = callee.property;
+    return property && property.type === 'Identifier' && property.name === 'setActive';
+  }
+  return false;
+}
+function isPropertyNamed(prop, name) {
+  return prop && prop.type === 'ObjectProperty' && isPropertyKeyNamed(prop.key, name);
+}
+function getPropertyValueExpression(valueNode) {
+  if (!valueNode) {
+    return null;
+  }
+  if (valueNode.type === 'JSXExpressionContainer') {
+    return valueNode.expression;
+  }
+  return valueNode;
+}
+function buildNavigateArrowFunction(j, originalExpression) {
+  const paramIdentifier = j.identifier('params');
+  const calleeExpression = clone(originalExpression);
+  const callExpression = j.callExpression(calleeExpression, [j.memberExpression(paramIdentifier, j.identifier('session'))]);
+  return j.arrowFunctionExpression([paramIdentifier], callExpression);
+}
+function renameTypeReferences(root, j, oldName, newName) {
+  let changed = false;
+  root.find(j.ImportSpecifier).forEach(path => {
+    const imported = path.node.imported;
+    if (imported && imported.type === 'Identifier' && imported.name === oldName) {
+      imported.name = newName;
+      if (path.node.local && path.node.local.name === oldName) {
+        path.node.local.name = newName;
+      }
+      changed = true;
+    }
+  });
+  root.find(j.TSTypeReference).forEach(path => {
+    if (renameEntityName(path.node.typeName, oldName, newName)) {
+      changed = true;
+    }
+  });
+  root.find(j.TSExpressionWithTypeArguments).forEach(path => {
+    if (renameEntityName(path.node.expression, oldName, newName)) {
+      changed = true;
+    }
+  });
+  root.find(j.TSQualifiedName).forEach(path => {
+    if (path.node.right.type === 'Identifier' && path.node.right.name === oldName) {
+      path.node.right.name = newName;
+      changed = true;
+    }
+  });
+  return changed;
+}
+function renameEntityName(entity, oldName, newName) {
+  if (!entity) {
+    return false;
+  }
+  if (entity.type === 'Identifier' && entity.name === oldName) {
+    entity.name = newName;
+    return true;
+  }
+  if (entity.type === 'TSQualifiedName') {
+    if (entity.right.type === 'Identifier' && entity.right.name === oldName) {
+      entity.right.name = newName;
+      return true;
+    }
+    return renameEntityName(entity.left, oldName, newName);
+  }
+  return false;
+}

package/dist/components/Codemod.js

@@ -8,7 +8,10 @@ import { runCodemod } from '../codemods/index.js';
  *
  * @param {Object} props
  * @param {Function} props.callback - The callback function to be called after the codemod is run.
- * @param {string} props.glob - The directory to scan for files in the project.
+ * @param {string|string[]} [props.glob] - Optional glob(s) to scan for files. When provided, the
+ *   codemod will use this glob directly instead of prompting.
+ * @param {Function} [props.onGlobResolved] - Optional callback invoked with the resolved glob array
+ *   when the user provides it via the prompt.
  * @param {string} props.sdk - The SDK name to be used in the codemod.
  * @param {string} props.transform - The transformation to be applied by the codemod.
  *
@@ -18,11 +21,21 @@ export function Codemod(props) {
   const {
     callback,
     sdk,
-    transform
+    transform,
+    glob: initialGlob,
+    onGlobResolved
   } = props;
   const [error, setError] = useState();
-  const [glob, setGlob] = useState(props.glob);
+  const [glob, setGlob] = useState(initialGlob);
   const [result, setResult] = useState();
+
+  // If a glob is later provided via props (e.g. from a previous codemod run),
+  // adopt it so we can run without re-prompting.
+  useEffect(() => {
+    if (initialGlob && !glob) {
+      setGlob(initialGlob);
+    }
+  }, [initialGlob, glob]);
   useEffect(() => {
     if (!glob) {
       return;
@@ -42,7 +55,11 @@ export function Codemod(props) {
   }, "(globstar syntax supported)"), glob ? /*#__PURE__*/React.createElement(Text, null, glob.toString()) : /*#__PURE__*/React.createElement(TextInput, {
     defaultValue: "**/*.(js|jsx|ts|tsx|mjs|cjs)",
     onSubmit: val => {
-      setGlob(val.split(/[ ,]/));
+      const parsed = val.split(/[ ,]/).filter(Boolean);
+      setGlob(parsed);
+      if (onGlobResolved) {
+        onGlobResolved(parsed);
+      }
     }
   })), !result && !error && glob && /*#__PURE__*/React.createElement(Spinner, {
     label: `Running @clerk/${sdk} codemod... ${transform}`

package/dist/components/Command.js

@@ -32,7 +32,7 @@ export function Command({
     }).catch(err => {
       setError(err);
     });
-  }, []);
+  }, [cmd]);
   return /*#__PURE__*/React.createElement(React.Fragment, null, !result && !error && /*#__PURE__*/React.createElement(Loading, {
     cmd: cmd,
     message: message

package/dist/components/SDKWorkflow.js

@@ -7,6 +7,11 @@ import { Codemod } from './Codemod.js';
 import { Command } from './Command.js';
 import { Header } from './Header.js';
 import { UpgradeSDK } from './UpgradeSDK.js';
+const CODEMODS = {
+  ASYNC_REQUEST: 'transform-async-request',
+  CLERK_REACT_V6: 'transform-clerk-react-v6',
+  REMOVE_DEPRECATED_PROPS: 'transform-remove-deprecated-props'
+};
 function versionNeedsUpgrade(sdk, version) {
   if (sdk === 'clerk-react' && version === 5) {
     return true;
@@ -38,10 +43,12 @@ export function SDKWorkflow(props) {
   const {
     sdk
   } = props;
+  const detectedVersion = getClerkSdkVersion(sdk);
   const [done, setDone] = useState(false);
   const [runCodemod, setRunCodemod] = useState(false);
   const [upgradeComplete, setUpgradeComplete] = useState(false);
-  const [version] = useState(getClerkSdkVersion(sdk));
+  const [version, setVersion] = useState(detectedVersion);
+  const [versionConfirmed, setVersionConfirmed] = useState(Boolean(detectedVersion));
   if (!['nextjs', 'clerk-react', 'clerk-expo', 'react-router', 'tanstack-react-start'].includes(sdk)) {
     return /*#__PURE__*/React.createElement(StatusMessage, {
       variant: "error"
@@ -49,96 +56,223 @@ export function SDKWorkflow(props) {
       bold: true
     }, "@clerk/", sdk), " at the moment.");
   }
-  if (sdk === 'nextjs') {
-    // Right now, we only have one codemod for the `@clerk/nextjs` async request transformation
-    return /*#__PURE__*/React.createElement(React.Fragment, null, /*#__PURE__*/React.createElement(Header, null), /*#__PURE__*/React.createElement(Text, null, "Clerk SDK used: ", /*#__PURE__*/React.createElement(Text, {
-      color: "green"
-    }, "@clerk/", sdk)), /*#__PURE__*/React.createElement(Text, null, "Migrating from version: ", /*#__PURE__*/React.createElement(Text, {
-      color: "green"
-    }, version)), runCodemod ? /*#__PURE__*/React.createElement(Text, null, "Executing codemod: ", /*#__PURE__*/React.createElement(Text, {
-      color: "green"
-    }, "yes")) : null, /*#__PURE__*/React.createElement(Newline, null), version === 5 && /*#__PURE__*/React.createElement(React.Fragment, null, /*#__PURE__*/React.createElement(UpgradeSDK, {
-      callback: setUpgradeComplete,
-      sdk: sdk
-    }), upgradeComplete ? /*#__PURE__*/React.createElement(Codemod, {
-      callback: setDone,
-      sdk: sdk,
-      transform: "transform-async-request"
-    }) : null), version === 6 && /*#__PURE__*/React.createElement(React.Fragment, null, /*#__PURE__*/React.createElement(UpgradeSDK, {
-      callback: setUpgradeComplete,
-      sdk: sdk
-    }), upgradeComplete ? /*#__PURE__*/React.createElement(Codemod, {
-      callback: setDone,
-      sdk: sdk,
-      transform: "transform-clerk-react-v6"
-    }) : null), version === 7 && /*#__PURE__*/React.createElement(React.Fragment, null, runCodemod ? /*#__PURE__*/React.createElement(Codemod, {
-      sdk: sdk,
-      callback: setDone,
-      transform: "transform-clerk-react-v6"
-    }) : /*#__PURE__*/React.createElement(React.Fragment, null, /*#__PURE__*/React.createElement(Text, null, "Looks like you are already on the latest version of ", /*#__PURE__*/React.createElement(Text, {
+
+  // If we cannot automatically determine the installed version, let the user
+  // pick the major version they are on so we can still run the appropriate
+  // upgrade / codemods instead of silently doing nothing.
+  if (!versionConfirmed) {
+    return /*#__PURE__*/React.createElement(React.Fragment, null, /*#__PURE__*/React.createElement(Header, null), /*#__PURE__*/React.createElement(Text, null, "We couldn't automatically detect which major version of ", /*#__PURE__*/React.createElement(Text, {
       bold: true
-    }, "@clerk/", sdk), ". Would you like to run the associated codemod?"), /*#__PURE__*/React.createElement(Select, {
+    }, "@clerk/", sdk), " you're using."), /*#__PURE__*/React.createElement(Newline, null), /*#__PURE__*/React.createElement(StatusMessage, {
+      variant: "warning"
+    }, "Please select the major version below. If you're not sure, picking v7 (Core 3) will run the latest codemods and is generally safe to re-run."), /*#__PURE__*/React.createElement(Newline, null), /*#__PURE__*/React.createElement(Text, null, "Please select your current @clerk/", sdk, " major version:"), /*#__PURE__*/React.createElement(Select, {
       options: [{
-        label: 'yes',
-        value: 'yes'
+        label: 'v5 (upgrade to v6)',
+        value: 5
       }, {
-        label: 'no',
-        value: 'no'
+        label: 'v6 (upgrade to v7 / Core 3)',
+        value: 6
+      }, {
+        label: 'v7 (already on Core 3, just run codemods)',
+        value: 7
       }],
       onChange: value => {
-        if (value === 'yes') {
-          setRunCodemod(true);
-        } else {
-          setDone(true);
-        }
+        const numeric = typeof value === 'number' ? value : Number(value);
+        setVersion(Number.isNaN(numeric) ? 7 : numeric);
+        setVersionConfirmed(true);
       }
-    }))), done && /*#__PURE__*/React.createElement(React.Fragment, null, /*#__PURE__*/React.createElement(StatusMessage, {
-      variant: "success"
-    }, "Done upgrading ", /*#__PURE__*/React.createElement(Text, {
-      bold: true
-    }, "@clerk/nextjs")), /*#__PURE__*/React.createElement(Command, {
-      cmd: 'grep -rE "import.*\\\\{.*useAuth.*\\\\}.*from.*[\'\\\\\\"]@clerk/nextjs[\'\\\\\\"]" . --exclude-dir={node_modules,dist}',
-      message: /*#__PURE__*/React.createElement(Spinner, {
-        label: 'Checking for `useAuth` usage in your project...'
-      }),
-      onError: () => null,
-      onSuccess: () => /*#__PURE__*/React.createElement(StatusMessage, {
-        variant: "warning"
-      }, /*#__PURE__*/React.createElement(Text, null, "We have detected that your application might be using the ", /*#__PURE__*/React.createElement(Text, {
-        bold: true
-      }, "useAuth"), " hook from", ' ', /*#__PURE__*/React.createElement(Text, {
-        bold: true
-      }, "@clerk/nextjs"), "."), /*#__PURE__*/React.createElement(Newline, null), /*#__PURE__*/React.createElement(Text, null, "If usages of this hook are server-side rendered, you might need to add the ", /*#__PURE__*/React.createElement(Text, {
-        bold: true
-      }, "dynamic"), ' ', "prop to your application's root ", /*#__PURE__*/React.createElement(Text, {
-        bold: true
-      }, "ClerkProvider"), "."), /*#__PURE__*/React.createElement(Newline, null), /*#__PURE__*/React.createElement(Text, null, "You can find more information about this change in the Clerk documentation at", ' ', /*#__PURE__*/React.createElement(Link, {
-        url: "https://clerk.com/docs/references/nextjs/rendering-modes"
-      }, "https://clerk.com/docs/references/nextjs/rendering-modes"), "."))
-    })));
+    }));
   }
-  if (['clerk-react', 'clerk-expo', 'react-router', 'tanstack-react-start'].includes(sdk)) {
-    const replacePackage = sdk === 'clerk-react' || sdk === 'clerk-expo';
-    return /*#__PURE__*/React.createElement(React.Fragment, null, /*#__PURE__*/React.createElement(Header, null), /*#__PURE__*/React.createElement(Text, null, "Clerk SDK used: ", /*#__PURE__*/React.createElement(Text, {
-      color: "green"
-    }, "@clerk/", sdk)), /*#__PURE__*/React.createElement(Text, null, "Migrating from version: ", /*#__PURE__*/React.createElement(Text, {
-      color: "green"
-    }, version)), runCodemod ? /*#__PURE__*/React.createElement(Text, null, "Executing codemod: ", /*#__PURE__*/React.createElement(Text, {
-      color: "green"
-    }, "yes")) : null, /*#__PURE__*/React.createElement(Newline, null), versionNeedsUpgrade(sdk, version) && /*#__PURE__*/React.createElement(React.Fragment, null, /*#__PURE__*/React.createElement(UpgradeSDK, {
-      callback: setUpgradeComplete,
+  if (sdk === 'nextjs') {
+    return /*#__PURE__*/React.createElement(NextjsWorkflow, {
+      done: done,
+      runCodemod: runCodemod,
       sdk: sdk,
-      replacePackage: replacePackage
-    }), upgradeComplete ? /*#__PURE__*/React.createElement(Codemod, {
-      callback: setDone,
+      setDone: setDone,
+      setRunCodemod: setRunCodemod,
+      setUpgradeComplete: setUpgradeComplete,
+      upgradeComplete: upgradeComplete,
+      version: version
+    });
+  }
+  if (['clerk-react', 'clerk-expo', 'react-router', 'tanstack-react-start'].includes(sdk)) {
+    return /*#__PURE__*/React.createElement(ReactSdkWorkflow, {
+      done: done,
+      runCodemod: runCodemod,
       sdk: sdk,
-      transform: "transform-clerk-react-v6"
-    }) : null), done && /*#__PURE__*/React.createElement(React.Fragment, null, /*#__PURE__*/React.createElement(StatusMessage, {
-      variant: "success"
-    }, replacePackage ? /*#__PURE__*/React.createElement(React.Fragment, null, "Done upgrading to ", /*#__PURE__*/React.createElement(Text, {
-      bold: true
-    }, "@clerk/", sdk.replace('clerk-', ''))) : /*#__PURE__*/React.createElement(React.Fragment, null, "Done upgrading ", /*#__PURE__*/React.createElement(Text, {
-      bold: true
-    }, "@clerk/", sdk)))));
+      setDone: setDone,
+      setRunCodemod: setRunCodemod,
+      setUpgradeComplete: setUpgradeComplete,
+      upgradeComplete: upgradeComplete,
+      version: version
+    });
   }
+}
+function NextjsWorkflow({
+  done,
+  runCodemod,
+  sdk,
+  setDone,
+  setRunCodemod,
+  setUpgradeComplete,
+  upgradeComplete,
+  version
+}) {
+  const [v6CodemodComplete, setV6CodemodComplete] = useState(false);
+  const [glob, setGlob] = useState();
+  return /*#__PURE__*/React.createElement(React.Fragment, null, /*#__PURE__*/React.createElement(Header, null), /*#__PURE__*/React.createElement(Text, null, "Clerk SDK used: ", /*#__PURE__*/React.createElement(Text, {
+    color: "green"
+  }, "@clerk/", sdk)), /*#__PURE__*/React.createElement(Text, null, "Migrating from version: ", /*#__PURE__*/React.createElement(Text, {
+    color: "green"
+  }, version)), runCodemod ? /*#__PURE__*/React.createElement(Text, null, "Executing codemod: ", /*#__PURE__*/React.createElement(Text, {
+    color: "green"
+  }, "yes")) : null, /*#__PURE__*/React.createElement(Newline, null), version === 5 && /*#__PURE__*/React.createElement(React.Fragment, null, /*#__PURE__*/React.createElement(UpgradeSDK, {
+    callback: setUpgradeComplete,
+    sdk: sdk
+  }), upgradeComplete ? /*#__PURE__*/React.createElement(Codemod, {
+    callback: setV6CodemodComplete,
+    sdk: sdk,
+    transform: CODEMODS.ASYNC_REQUEST,
+    onGlobResolved: setGlob
+  }) : null, v6CodemodComplete ? /*#__PURE__*/React.createElement(Codemod, {
+    callback: setDone,
+    sdk: sdk,
+    transform: CODEMODS.REMOVE_DEPRECATED_PROPS,
+    glob: glob
+  }) : null), version === 6 && /*#__PURE__*/React.createElement(React.Fragment, null, /*#__PURE__*/React.createElement(UpgradeSDK, {
+    callback: setUpgradeComplete,
+    sdk: sdk
+  }), upgradeComplete ? /*#__PURE__*/React.createElement(Codemod, {
+    callback: setV6CodemodComplete,
+    sdk: sdk,
+    transform: CODEMODS.CLERK_REACT_V6,
+    onGlobResolved: setGlob
+  }) : null, v6CodemodComplete ? /*#__PURE__*/React.createElement(Codemod, {
+    callback: setDone,
+    sdk: sdk,
+    transform: CODEMODS.REMOVE_DEPRECATED_PROPS,
+    glob: glob
+  }) : null), version === 7 && /*#__PURE__*/React.createElement(React.Fragment, null, runCodemod ? /*#__PURE__*/React.createElement(React.Fragment, null, /*#__PURE__*/React.createElement(Codemod, {
+    callback: setV6CodemodComplete,
+    sdk: sdk,
+    transform: CODEMODS.CLERK_REACT_V6,
+    onGlobResolved: setGlob
+  }), v6CodemodComplete ? /*#__PURE__*/React.createElement(Codemod, {
+    callback: setDone,
+    sdk: sdk,
+    transform: CODEMODS.REMOVE_DEPRECATED_PROPS,
+    glob: glob
+  }) : null) : /*#__PURE__*/React.createElement(React.Fragment, null, /*#__PURE__*/React.createElement(Text, null, "Looks like you are already on the latest version of ", /*#__PURE__*/React.createElement(Text, {
+    bold: true
+  }, "@clerk/", sdk), ". Would you like to run the associated codemods?"), /*#__PURE__*/React.createElement(Select, {
+    onChange: value => {
+      if (value === 'yes') {
+        setRunCodemod(true);
+      } else {
+        setDone(true);
+      }
+    },
+    options: [{
+      label: 'yes',
+      value: 'yes'
+    }, {
+      label: 'no',
+      value: 'no'
+    }]
+  }))), done && /*#__PURE__*/React.createElement(React.Fragment, null, /*#__PURE__*/React.createElement(StatusMessage, {
+    variant: "success"
+  }, "Done upgrading ", /*#__PURE__*/React.createElement(Text, {
+    bold: true
+  }, "@clerk/nextjs")), /*#__PURE__*/React.createElement(Command, {
+    cmd: 'grep -rE "import.*\\\\{.*useAuth.*\\\\}.*from.*[\'\\\\\\"]@clerk/nextjs[\'\\\\\\"]" . --exclude-dir={node_modules,dist}',
+    message: /*#__PURE__*/React.createElement(Spinner, {
+      label: 'Checking for `useAuth` usage in your project...'
+    }),
+    onError: () => null,
+    onSuccess: NextjsUseAuthWarning
+  })));
+}
+function NextjsUseAuthWarning() {
+  return /*#__PURE__*/React.createElement(StatusMessage, {
+    variant: "warning"
+  }, /*#__PURE__*/React.createElement(Text, null, "We have detected that your application might be using the ", /*#__PURE__*/React.createElement(Text, {
+    bold: true
+  }, "useAuth"), " hook from", ' ', /*#__PURE__*/React.createElement(Text, {
+    bold: true
+  }, "@clerk/nextjs"), "."), /*#__PURE__*/React.createElement(Newline, null), /*#__PURE__*/React.createElement(Text, null, "If usages of this hook are server-side rendered, you might need to add the ", /*#__PURE__*/React.createElement(Text, {
+    bold: true
+  }, "dynamic"), " prop to your application's root ", /*#__PURE__*/React.createElement(Text, {
+    bold: true
+  }, "ClerkProvider"), "."), /*#__PURE__*/React.createElement(Newline, null), /*#__PURE__*/React.createElement(Text, null, "You can find more information about this change in the Clerk documentation at", ' ', /*#__PURE__*/React.createElement(Link, {
+    url: "https://clerk.com/docs/references/nextjs/rendering-modes"
+  }, "https://clerk.com/docs/references/nextjs/rendering-modes"), "."));
+}
+function ReactSdkWorkflow({
+  done,
+  runCodemod,
+  sdk,
+  setDone,
+  setRunCodemod,
+  setUpgradeComplete,
+  upgradeComplete,
+  version
+}) {
+  const [v6CodemodComplete, setV6CodemodComplete] = useState(false);
+  const [glob, setGlob] = useState();
+  const replacePackage = sdk === 'clerk-react' || sdk === 'clerk-expo';
+  const needsUpgrade = versionNeedsUpgrade(sdk, version);
+  return /*#__PURE__*/React.createElement(React.Fragment, null, /*#__PURE__*/React.createElement(Header, null), /*#__PURE__*/React.createElement(Text, null, "Clerk SDK used: ", /*#__PURE__*/React.createElement(Text, {
+    color: "green"
+  }, "@clerk/", sdk)), /*#__PURE__*/React.createElement(Text, null, "Migrating from version: ", /*#__PURE__*/React.createElement(Text, {
+    color: "green"
+  }, version)), runCodemod ? /*#__PURE__*/React.createElement(Text, null, "Executing codemod: ", /*#__PURE__*/React.createElement(Text, {
+    color: "green"
+  }, "yes")) : null, /*#__PURE__*/React.createElement(Newline, null), needsUpgrade && /*#__PURE__*/React.createElement(React.Fragment, null, /*#__PURE__*/React.createElement(UpgradeSDK, {
+    callback: setUpgradeComplete,
+    replacePackage: replacePackage,
+    sdk: sdk
+  }), upgradeComplete ? /*#__PURE__*/React.createElement(Codemod, {
+    callback: setV6CodemodComplete,
+    sdk: sdk,
+    transform: CODEMODS.CLERK_REACT_V6,
+    onGlobResolved: setGlob
+  }) : null, v6CodemodComplete ? /*#__PURE__*/React.createElement(Codemod, {
+    callback: setDone,
+    sdk: sdk,
+    transform: CODEMODS.REMOVE_DEPRECATED_PROPS,
+    glob: glob
+  }) : null), !needsUpgrade && /*#__PURE__*/React.createElement(React.Fragment, null, runCodemod ? /*#__PURE__*/React.createElement(React.Fragment, null, /*#__PURE__*/React.createElement(Codemod, {
+    callback: setV6CodemodComplete,
+    sdk: sdk,
+    transform: CODEMODS.CLERK_REACT_V6,
+    onGlobResolved: setGlob
+  }), v6CodemodComplete ? /*#__PURE__*/React.createElement(Codemod, {
+    callback: setDone,
+    sdk: sdk,
+    transform: CODEMODS.REMOVE_DEPRECATED_PROPS,
+    glob: glob
+  }) : null) : /*#__PURE__*/React.createElement(React.Fragment, null, /*#__PURE__*/React.createElement(Text, null, "Looks like you are already on the latest version of ", /*#__PURE__*/React.createElement(Text, {
+    bold: true
+  }, "@clerk/", sdk), ". Would you like to run the associated codemods?"), /*#__PURE__*/React.createElement(Select, {
+    onChange: value => {
+      if (value === 'yes') {
+        setRunCodemod(true);
+      } else {
+        setDone(true);
+      }
+    },
+    options: [{
+      label: 'yes',
+      value: 'yes'
+    }, {
+      label: 'no',
+      value: 'no'
+    }]
+  }))), done && /*#__PURE__*/React.createElement(StatusMessage, {
+    variant: "success"
+  }, replacePackage ? /*#__PURE__*/React.createElement(React.Fragment, null, "Done upgrading to ", /*#__PURE__*/React.createElement(Text, {
+    bold: true
+  }, "@clerk/", sdk.replace('clerk-', ''))) : /*#__PURE__*/React.createElement(React.Fragment, null, "Done upgrading ", /*#__PURE__*/React.createElement(Text, {
+    bold: true
+  }, "@clerk/", sdk))));
 }

package/dist/components/Scan.js

@@ -37,7 +37,7 @@ export function Scan(props) {
   // { sdkName: [{ title: 'x', matcher: /x/, slug: 'x', ... }] }
   useEffect(() => {
     setStatus(`Loading data for ${toVersion} migration`);
-    import(`../versions/${toVersion}/index.js`).then(version => {
+    void import(`../versions/${toVersion}/index.js`).then(version => {
       setMatchers(sdks.reduce((m, sdk) => {
         m[sdk] = version.default[sdk];
         return m;
@@ -51,7 +51,7 @@ export function Scan(props) {
   useEffect(() => {
     setStatus('Collecting files to scan');
     const pattern = convertPathToPattern(path.resolve(dir));
-    globby(pattern, {
+    void globby(pattern, {
       ignore: ['node_modules/**', '**/node_modules/**', '.git/**', 'package.json', '**/package.json', 'package-lock.json', '**/package-lock.json', 'yarn.lock', '**/yarn.lock', 'pnpm-lock.yaml', '**/pnpm-lock.yaml', '**/*.(png|webp|svg|gif|jpg|jpeg)+', '**/*.(mp4|mkv|wmv|m4v|mov|avi|flv|webm|flac|mka|m4a|aac|ogg)+', ...ignore].filter(Boolean)
     }).then(files => {
       setFiles(files);
@@ -66,7 +66,7 @@ export function Scan(props) {
       return;
     }
     const allResults = {};
-    Promise.all(
+    void Promise.all(
     // first we read all the files
     files.map(async (file, idx) => {
       const content = await fs.readFile(file, 'utf8');
@@ -124,8 +124,8 @@ export function Scan(props) {
       setStatus(`Scanning ${file}`);
       setProgress(Math.ceil(idx / files.length * 100));
     })).then(() => {
-      const newResults = [...results, ...Object.keys(allResults).map(k => allResults[k])];
-      setResults(newResults);
+      const aggregatedResults = Object.keys(allResults).map(k => allResults[k]);
+      setResults(prevResults => [...prevResults, ...aggregatedResults]);
 
       // Anonymously track how many instances of each breaking change item were encountered.
       // This only tracks the name of the breaking change found, and how many instances of it
@@ -133,14 +133,14 @@ export function Scan(props) {
       // It is used internally to help us understand what the most common sticking points are
       // for our users so we can appropriate prioritize support/guidance/docs around them.
       if (!disableTelemetry) {
-        fetch('https://api.segment.io/v1/batch', {
+        void fetch('https://api.segment.io/v1/batch', {
           method: 'POST',
           headers: {
             Authorization: `Basic ${Buffer.from('5TkC1SM87VX2JRJcIGBBmL7sHLRWaIvc:').toString('base64')}`,
             'Content-Type': 'application/json'
           },
           body: JSON.stringify({
-            batch: newResults.map(item => {
+            batch: aggregatedResults.map(item => {
               return {
                 type: 'track',
                 userId: 'clerk-upgrade-tool',
@@ -169,7 +169,7 @@ export function Scan(props) {
     }).catch(err => {
       console.error(err);
     });
-  }, [matchers, files, noWarnings, disableTelemetry]);
+  }, [matchers, files, noWarnings, disableTelemetry, fromVersion, toVersion, uuid]);
   return complete ? /*#__PURE__*/React.createElement(React.Fragment, null, /*#__PURE__*/React.createElement(Text, {
     color: "green"
   }, "\u2713 ", status), /*#__PURE__*/React.createElement(Newline, null), !!results.length && /*#__PURE__*/React.createElement(ExpandableList, {

package/dist/components/UpgradeSDK.js

@@ -80,7 +80,7 @@ export function UpgradeSDK({
     }).finally(() => {
       callback(true);
     });
-  }, [command, packageManager, sdk]);
+  }, [callback, command, packageManager, replacePackage, sdk]);
   return /*#__PURE__*/React.createElement(React.Fragment, null, packageManager ? null : /*#__PURE__*/React.createElement(React.Fragment, null, /*#__PURE__*/React.createElement(Text, null, "We could not detect the package manager used in your project. Please select the package manager you are using"), /*#__PURE__*/React.createElement(Select, {
     options: [{
       label: 'npm',

package/dist/guide-generators/core-2/backend/index.js

@@ -19,4 +19,4 @@ async function generate() {
     packageName
   }), markdown('cli'), '## Breaking Changes', singleItem('authenticaterequest-params-change'), singleItem('clockskewinseconds'), markdown('import-paths'), accordionForCategory('import-paths'), singleItem('httpoptions-removed'), markdown('orgs-claim'), markdown('pagination-args'), accordionForCategory('pagination-args'), markdown('pagination-return'), accordionForCategory('pagination-return'), markdown('image-url'), accordionForCategory(['image-url', 'image-url-backend']), deprecationRemovalsAndHousekeeping()]);
 }
-generate().then(writeToFile(cwd));
+void generate().then(writeToFile(cwd));

package/dist/guide-generators/core-2/chrome-extension/index.js

@@ -21,4 +21,4 @@ async function generate() {
     packageName
   }), markdown('image-url'), accordionForCategory('image-url'), deprecationRemovalsAndHousekeeping(['hof-removal', 'pagination-return', 'pagination-args', 'error-imports'])]);
 }
-generate().then(writeToFile(cwd));
+void generate().then(writeToFile(cwd));

package/dist/guide-generators/core-2/expo/index.js

@@ -22,4 +22,4 @@ async function generate() {
     packageName
   }), markdown('image-url'), accordionForCategory('image-url'), deprecationRemovalsAndHousekeeping(['hof-removal', 'pagination-return', 'pagination-args', 'error-imports'])]);
 }
-generate().then(writeToFile(cwd));
+void generate().then(writeToFile(cwd));

package/dist/guide-generators/core-2/fastify/index.js

@@ -20,4 +20,4 @@ async function generate() {
     packageName
   }), markdown('cli'), '## Breaking Changes', markdown('orgs-claim'), markdown('image-url'), accordionForCategory('image-url'), deprecationRemovalsAndHousekeeping(['hof-removal', 'pagination-return', 'pagination-args', 'error-imports'])]);
 }
-generate().then(writeToFile(cwd));
+void generate().then(writeToFile(cwd));

package/dist/guide-generators/core-2/js/index.js

@@ -25,4 +25,4 @@ async function generate() {
   // attemptweb3wallet?
   deprecationRemovalsAndHousekeeping(['error-imports'])]);
 }
-generate().then(writeToFile(cwd));
+void generate().then(writeToFile(cwd));

package/dist/guide-generators/core-2/nextjs/index.js

@@ -22,4 +22,4 @@ async function generate() {
     packageName
   }), markdown('image-url'), accordionForCategory('image-url'), deprecationRemovalsAndHousekeeping(['hof-removal', 'pagination-return', 'pagination-args', 'error-imports'])]);
 }
-generate().then(writeToFile(cwd));
+void generate().then(writeToFile(cwd));

package/dist/guide-generators/core-2/node/index.js

@@ -20,4 +20,4 @@ async function generate() {
     packageName
   }), markdown('cli'), '## Breaking Changes', singleItem('cjs-esm-instance'), markdown('node-setters-removals'), markdown('orgs-claim'), markdown('image-url'), accordionForCategory('image-url'), deprecationRemovalsAndHousekeeping(['pagination-return', 'pagination-args', 'error-imports'])]);
 }
-generate().then(writeToFile(cwd));
+void generate().then(writeToFile(cwd));

package/dist/guide-generators/core-2/overview/index.js

@@ -1,7 +1,7 @@
 import { assembleContent, frontmatter, markdown, writeToFile } from '../../text-generation.js';
 const cwd = 'core-2/overview';
 async function generate() {
-  return assembleContent({
+  return await assembleContent({
     data: {},
     cwd
   }, [frontmatter({
@@ -9,4 +9,4 @@ async function generate() {
     description: `Learn how to upgrade to the latest version of Clerk's SDKs`
   }), markdown('intro')]);
 }
-generate().then(writeToFile(cwd));
+void generate().then(writeToFile(cwd));

package/dist/guide-generators/core-2/react/index.js

@@ -22,4 +22,4 @@ async function generate() {
     packageName
   }), markdown('image-url'), accordionForCategory('image-url'), deprecationRemovalsAndHousekeeping(['hof-removal', 'pagination-return', 'pagination-args', 'error-imports'])]);
 }
-generate().then(writeToFile(cwd));
+void generate().then(writeToFile(cwd));

package/dist/guide-generators/core-2/remix/index.js

@@ -22,4 +22,4 @@ async function generate() {
     packageName
   }), markdown('image-url'), accordionForCategory('image-url'), deprecationRemovalsAndHousekeeping()]);
 }
-generate().then(writeToFile(cwd));
+void generate().then(writeToFile(cwd));

package/dist/guide-generators/core-2/retheme/index.js

@@ -20,4 +20,4 @@ async function generate() {
     additionalItems: [defaultsChangeItem]
   }), '## Localization Changes', accordionForCategory('localization')]);
 }
-generate().then(writeToFile(cwd));
+void generate().then(writeToFile(cwd));

package/dist/util/generate-changelog.js

@@ -24,7 +24,7 @@ ${entry.content}
   }
   return output;
 }
-generate().then(console.log);
+void generate().then(console.log);
 function getSdkName(val) {
   return SDKS.find(sdk => val === sdk.value).label;
 }

package/package.json

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