fix(clerk-react): Add versionSelector helper

.changeset/neat-needles-poke.md

@@ -0,0 +1,5 @@
+---
+"@clerk/clerk-react": patch
+---
+
+Refactor our script loading logic to use a `versionSelector` helper function. No change in behavior should occur. This internal change allows versions tagged with `snapshot` and `staging` to use the exact corresponding NPM version of `@clerk/clerk-js`.

packages/react/src/globals.d.ts

@@ -3,5 +3,6 @@ export {};
 declare global {
   const PACKAGE_NAME: string;
   const PACKAGE_VERSION: string;
+  const JS_PACKAGE_VERSION: string;
   const __DEV__: boolean;
 }

packages/react/src/utils/__tests__/versionSelector.test.ts

@@ -0,0 +1,32 @@
+/* eslint-disable @typescript-eslint/ban-ts-comment */
+import { versionSelector } from '../versionSelector';
+
+describe('versionSelector', () => {
+  it('should return the clerkJSVersion if it is provided', () => {
+    expect(versionSelector('1.0.0')).toEqual('1.0.0');
+  });
+  it('should use the major version if there is no prerelease tag', () => {
+    // @ts-ignore
+    global.PACKAGE_VERSION = '1.0.0';
+    // @ts-ignore
+    global.JS_PACKAGE_VERSION = '2.0.0';
+
+    expect(versionSelector(undefined)).toEqual('1');
+  });
+  it('should use the prerelease tag when it is not snapshot', () => {
+    // @ts-ignore
+    global.PACKAGE_VERSION = '1.0.0-next.0';
+    // @ts-ignore
+    global.JS_PACKAGE_VERSION = '2.0.0-next.0';
+
+    expect(versionSelector(undefined)).toEqual('next');
+  });
+  it('should use the exact JS version if tag is snapshot', () => {
+    // @ts-ignore
+    global.PACKAGE_VERSION = '1.0.0-snapshot.0';
+    // @ts-ignore
+    global.JS_PACKAGE_VERSION = '2.0.0-snapshot.0';
+
+    expect(versionSelector(undefined)).toEqual('2.0.0-snapshot.0');
+  });
+});

packages/react/src/utils/loadClerkJsScript.ts

@@ -3,6 +3,7 @@ import { addClerkPrefix, isValidProxyUrl, loadScript, parsePublishableKey, proxy
 import type { IsomorphicClerkOptions } from '../types';
 import { errorThrower } from './errorThrower';
 import { isDevOrStagingUrl } from './isDevOrStageUrl';
+import { versionSelector } from './versionSelector';
 
 const FAILED_TO_LOAD_ERROR = 'Clerk: Failed to load Clerk';
 
@@ -44,7 +45,7 @@ const clerkJsScriptUrl = (opts: LoadClerkJsScriptOptions) => {
   }
 
   const variant = clerkJSVariant ? `${clerkJSVariant.replace(/\.+$/, '')}.` : '';
-  const version = clerkJSVersion || getPrereleaseTag(PACKAGE_VERSION) || getMajorVersion(PACKAGE_VERSION);
+  const version = versionSelector(clerkJSVersion);
   return `https://${scriptHost}/npm/@clerk/clerk-js@${version}/dist/clerk.${variant}browser.js`;
 };
 
@@ -64,7 +65,3 @@ const applyClerkJsScriptAttributes = (options: LoadClerkJsScriptOptions) => (scr
     script.setAttribute('data-clerk-domain', domain);
   }
 };
-
-const getPrereleaseTag = (packageVersion: string) => packageVersion.match(/-(.*)\./)?.[1];
-
-const getMajorVersion = (packageVersion: string) => packageVersion.split('.')[0];

packages/react/src/utils/versionSelector.ts

@@ -0,0 +1,29 @@
+/**
+ * This version selector is a bit complicated, so here is the flow:
+ * 1. Use the clerkJSVersion prop on the provider
+ * 2. Use the exact `@clerk/clerk-js` version if it is a `@snapshot` prerelease for `@clerk/clerk-react`
+ * 3. Use the prerelease tag of `@clerk/clerk-react`
+ * 4. Fallback to the major version of `@clerk/clerk-react`
+ * @param clerkJSVersion - The optional clerkJSVersion prop on the provider
+ * @returns The npm tag, version or major version to use
+ */
+export const versionSelector = (clerkJSVersion: string | undefined) => {
+  if (clerkJSVersion) {
+    return clerkJSVersion;
+  }
+
+  const prereleaseTag = getPrereleaseTag(PACKAGE_VERSION);
+  if (prereleaseTag) {
+    if (prereleaseTag === 'snapshot') {
+      return JS_PACKAGE_VERSION;
+    }
+
+    return prereleaseTag;
+  }
+
+  return getMajorVersion(PACKAGE_VERSION);
+};
+
+// TODO: Replace these with "semver" package
+const getPrereleaseTag = (packageVersion: string) => packageVersion.match(/-(.*)\./)?.[1];
+const getMajorVersion = (packageVersion: string) => packageVersion.split('.')[0];

packages/react/tsup.config.ts

@@ -2,6 +2,7 @@ import type { Options } from 'tsup';
 import { defineConfig } from 'tsup';
 
 import { runAfterLast } from '../../scripts/utils';
+import { version as clerkJsVersion } from '../clerk-js/package.json';
 import { name, version } from './package.json';
 
 export default defineConfig(overrideOptions => {
@@ -18,6 +19,7 @@ export default defineConfig(overrideOptions => {
     define: {
       PACKAGE_NAME: `"${name}"`,
       PACKAGE_VERSION: `"${version}"`,
+      JS_PACKAGE_VERSION: `"${clerkJsVersion}"`,
       __DEV__: `${isWatch}`,
     },
   };