feat(clerk-js,clerk-react,types): Expose fapi version

.changeset/hip-ideas-cheat.md

@@ -0,0 +1,7 @@
+---
+'@clerk/clerk-js': minor
+'@clerk/clerk-react': minor
+'@clerk/types': minor
+---
+
+Expose the frontend api version the clerk instance is using via `Clerk.apiVersion`.

packages/clerk-js/src/core/clerk.ts

@@ -126,7 +126,13 @@ import { memoizeListenerCallback } from '../utils/memoizeStateListenerCallback';
 import { RedirectUrls } from '../utils/redirectUrls';
 import { AuthCookieService } from './auth/AuthCookieService';
 import { CaptchaHeartbeat } from './auth/CaptchaHeartbeat';
-import { CLERK_SATELLITE_URL, CLERK_SUFFIXED_COOKIES, CLERK_SYNCED, ERROR_CODES } from './constants';
+import {
+  CLERK_SATELLITE_URL,
+  CLERK_SUFFIXED_COOKIES,
+  CLERK_SYNCED,
+  ERROR_CODES,
+  SUPPORTED_FAPI_VERSION,
+} from './constants';
 import {
   clerkErrorInitFailed,
   clerkInvalidSignInUrlFormat,
@@ -275,6 +281,10 @@ export class Clerk implements ClerkInterface {
     return Clerk.sdkMetadata;
   }
 
+  get apiVersion(): string {
+    return SUPPORTED_FAPI_VERSION;
+  }
+
   get loaded(): boolean {
     return this.status === 'degraded' || this.status === 'ready';
   }

packages/react/src/isomorphicClerk.ts

@@ -652,6 +652,10 @@ export class IsomorphicClerk implements IsomorphicLoadedClerk {
     return this.clerkjs?.version;
   }
 
+  get apiVersion() {
+    return this.clerkjs?.apiVersion;
+  }
+
   get client(): ClientResource | undefined {
     if (this.clerkjs) {
       return this.clerkjs.client;

packages/types/src/clerk.ts

@@ -165,6 +165,11 @@
    */
   version: string | undefined;
 
+  /**
+   * The version of the Clerk Frontend API that the SDK is using.
+   */
+  apiVersion: string | undefined;
+
   /**
    * If present, contains information about the SDK that the host application is using.
    * For example, if Clerk is loaded through `@clerk/nextjs`, this would be `{ name: '@clerk/nextjs', version: '1.0.0' }`
@@ -1138,7 +1143,7 @@
      */
     windowNavigate: (to: URL | string) => void;
   },
 ) => Promise<unknown> | unknown;
 
 export type WithoutRouting<T> = Omit<T, 'path' | 'routing'>;