feat(repo): Transition Session Reverification to stable

.changeset/afraid-cheetahs-smash.md

@@ -0,0 +1,9 @@
+---
+'@clerk/nextjs': minor
+---
+
+Introduce the `useReverification()` hook that handles the session reverification flow:
+- Replaces `__experimental_useReverification` with `useReverification`
+Also replaces the following APIs:
+- `____experimental_reverificationError` -> `__reverificationError`
+- `__experimental_reverificationErrorResponse` -> `reverificationErrorResponse`

.changeset/curly-terms-confess.md

@@ -0,0 +1,6 @@
+---
+'@clerk/chrome-extension': patch
+---
+
+Introduce the `useReverification()` hook that handles the session reverification flow:
+- Replaces `__experimental_useReverification` with `useReverification`

.changeset/forty-countries-retire.md

@@ -0,0 +1,10 @@
+---
+'@clerk/shared': minor
+---
+
+Introduce the `useReverification()` hook that handles the session reverification flow:
+- `__experimental_useReverification` -> `useReverification`
+Also replaces the following APIs:
+- `__experimental_reverificationError` -> `reverificationError`
+- `__experimental_reverificationErrorResponse` -> `reverificationErrorResponse`
+- `__experimental_isReverificationHint` -> `isReverificationHint`

.changeset/friendly-chairs-tie.md

@@ -0,0 +1,33 @@
+---
+'@clerk/types': minor
+---
+
+Drop experimental tag related to reverification.
+
+Properties of Clerk class:
+- `__experimental_openUserVerification` -> `__internal_openUserVerification`
+- `__experimental_closeUserVerification` -> `__internal_closeUserVerification`
+- `__experimental_UserVerificationProps` -> `__internal_UserVerificationProps`
+- `__experimental_UserVerificationModalProps` -> `__internal_UserVerificationModalProps`
+
+Properties of `Session`:
+- `__experimental_factorVerificationAge` -> `factorVerificationAge`
+- `__experimental_startVerification` -> `startVerification`
+- `__experimental_prepareFirstFactorVerification` -> `prepareFirstFactorVerification`
+- `__experimental_attemptFirstFactorVerification` -> `attemptFirstFactorVerification`
+- `__experimental_prepareSecondFactorVerification` -> `prepareSecondFactorVerification`
+- `__experimental_attemptSecondFactorVerification` -> `attemptSecondFactorVerification`
+
+Renaming 
+- `__experimental_SessionVerificationResource` -> `SessionVerificationResource`
+- `__experimental_SessionVerificationStatus` -> `SessionVerificationStatus`
+- `__experimental_SessionVerificationLevel` -> `SessionVerificationLevel`
+- `__experimental_ReverificationConfig` -> `ReverificationConfig`
+
+`CheckAuthorizationParamsWithCustomPermissions` and `CheckAuthorizationParams` now include `reverification?: ReverificationConfig;`
+
+Properties of  `IntialState`:
+- `__experimental_factorVerificationAge` -> `factorVerificationAge`
+
+Localization types:
+All properties of `__experimental_userVerification` are moved to `userVerification` 

.changeset/happy-balloons-jog.md

@@ -0,0 +1,6 @@
+---
+'@clerk/clerk-react': minor
+---
+
+Introduce the `useReverification()` hook that handles the session reverification flow:
+- Replaces `__experimental_useReverification` with `useReverification`

.changeset/hungry-beds-prove.md

@@ -0,0 +1,19 @@
+---
+'@clerk/clerk-js': minor
+---
+
+Drop experimental tag related to reverification.
+
+Properties of Clerk class:
+- `__experimental_openUserVerification` -> `__internal_openUserVerification`
+- `__experimental_closeUserVerification` -> `__internal_closeUserVerification`
+- `__experimental_UserVerificationProps` -> `__internal_UserVerificationProps`
+- `__experimental_UserVerificationModalProps` -> `__internal_UserVerificationModalProps`
+
+Properties of `Session`:
+- `__experimental_factorVerificationAge` -> `factorVerificationAge`
+- `__experimental_startVerification` -> `startVerification`
+- `__experimental_prepareFirstFactorVerification` -> `prepareFirstFactorVerification`
+- `__experimental_attemptFirstFactorVerification` -> `attemptFirstFactorVerification`
+- `__experimental_prepareSecondFactorVerification` -> `prepareSecondFactorVerification`
+- `__experimental_attemptSecondFactorVerification` -> `attemptSecondFactorVerification`

.changeset/small-suits-knock.md

@@ -0,0 +1,5 @@
+---
+'@clerk/localizations': minor
+---
+
+Moves all properties under `__experimental_userVerification` to `userVerification`. This affects all languages.

.changeset/smart-cooks-drop.md

@@ -0,0 +1,8 @@
+---
+'@clerk/backend': minor
+---
+
+Update AuthObject property from `__experimental_factorVerificationAge` to `factorVerificationAge`. 
+Also replaces the following APIs:
+- `__experimental_reverificationError` -> `__reverificationError`
+- `__experimental_reverificationErrorResponse` -> `reverificationErrorResponse`

integration/templates/next-app-router/src/app/(reverification)/action-with-use-reverification/page.tsx

@@ -1,6 +1,6 @@
 'use client';
 import { useState, useTransition } from 'react';
-import { __experimental_useReverification as useReverification } from '@clerk/nextjs';
+import { useReverification } from '@clerk/nextjs';
 import { logUserIdActionReverification } from '@/app/(reverification)/actions';
 
 function Page() {

integration/templates/next-app-router/src/app/(reverification)/actions.ts

@@ -1,19 +1,17 @@
 'use server';
 
-import { auth } from '@clerk/nextjs/server';
-import { __experimental_reverificationError as reverificationError } from '@clerk/shared/authorization-errors';
-import { __experimental_ReverificationConfig } from '@clerk/types';
-
+import { auth, reverificationError } from '@clerk/nextjs/server';
+import { ReverificationConfig } from '@clerk/types';
 const logUserIdActionReverification = async () => {
   const { userId, has } = await auth.protect();
 
   const config = {
     level: 'second_factor',
     afterMinutes: 1,
-  } satisfies __experimental_ReverificationConfig;
+  } satisfies ReverificationConfig;
 
   const userNeedsReverification = !has({
-    __experimental_reverification: config,
+    reverification: config,
   });
 
   if (userNeedsReverification) {

packages/backend/src/__tests__/exports.test.ts

@@ -37,15 +37,15 @@ describe('subpath /internal exports', () => {
     expect(Object.keys(internalExports).sort()).toMatchInlineSnapshot(`
       [
         "AuthStatus",
-        "__experimental_reverificationError",
-        "__experimental_reverificationErrorResponse",
         "constants",
         "createAuthenticateRequest",
         "createClerkRequest",
         "createRedirect",
         "debugRequestState",
         "decorateObjectWithResources",
         "makeAuthObjectSerializable",
+        "reverificationError",
+        "reverificationErrorResponse",
         "signedInAuthObject",
         "signedOutAuthObject",
         "stripPrivateDataFromObject",

packages/backend/src/internal.ts

@@ -20,7 +20,4 @@ export { decorateObjectWithResources, stripPrivateDataFromObject } from './util/
 export { createClerkRequest } from './tokens/clerkRequest';
 export type { ClerkRequest } from './tokens/clerkRequest';
 
-export {
-  __experimental_reverificationError,
-  __experimental_reverificationErrorResponse,
-} from '@clerk/shared/authorization-errors';
+export { reverificationError, reverificationErrorResponse } from '@clerk/shared/authorization-errors';

packages/backend/src/tokens/authObjects.ts

@@ -39,9 +39,8 @@ export type SignedInAuthObject = {
    * Factor Verification Age
    * Each item represents the minutes that have passed since the last time a first or second factor were verified.
    * [fistFactorAge, secondFactorAge]
-   * @experimental This API is experimental and may change at any moment.
    */
-  __experimental_factorVerificationAge: [number, number] | null;
+  factorVerificationAge: [number, number] | null;
   getToken: ServerGetToken;
   has: CheckAuthorizationWithCustomPermissions;
   debug: AuthObjectDebug;
@@ -63,9 +62,8 @@ export type SignedOutAuthObject = {
    * Factor Verification Age
    * Each item represents the minutes that have passed since the last time a first or second factor were verified.
    * [fistFactorAge, secondFactorAge]
-   * @experimental This API is experimental and may change at any moment.
    */
-  __experimental_factorVerificationAge: null;
+  factorVerificationAge: null;
   getToken: ServerGetToken;
   has: CheckAuthorizationWithCustomPermissions;
   debug: AuthObjectDebug;
@@ -111,7 +109,7 @@ export function signedInAuthObject(
   });
 
   // fva can be undefined for instances that have not opt-in
-  const __experimental_factorVerificationAge = fva ?? null;
+  const factorVerificationAge = fva ?? null;
 
   return {
     actor,
@@ -122,9 +120,9 @@ export function signedInAuthObject(
     orgRole,
     orgSlug,
     orgPermissions,
-    __experimental_factorVerificationAge,
+    factorVerificationAge,
     getToken,
-    has: createCheckAuthorization({ orgId, orgRole, orgPermissions, userId, __experimental_factorVerificationAge }),
+    has: createCheckAuthorization({ orgId, orgRole, orgPermissions, userId, factorVerificationAge }),
     debug: createDebug({ ...authenticateContext, sessionToken }),
   };
 }
@@ -142,7 +140,7 @@ export function signedOutAuthObject(debugData?: AuthObjectDebugData): SignedOutA
     orgRole: null,
     orgSlug: null,
     orgPermissions: null,
-    __experimental_factorVerificationAge: null,
+    factorVerificationAge: null,
     getToken: () => Promise.resolve(null),
     has: () => false,
     debug: createDebug(debugData),

packages/chrome-extension/src/__tests__/__snapshots__/exports.test.ts.snap

@@ -28,12 +28,12 @@ exports[`public exports should not include a breaking change 1`] = `
   "UserButton",
   "UserProfile",
   "Waitlist",
-  "__experimental_useReverification",
   "useAuth",
   "useClerk",
   "useEmailLink",
   "useOrganization",
   "useOrganizationList",
+  "useReverification",
   "useSession",
   "useSessionList",
   "useSignIn",

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

@@ -9,7 +9,7 @@ import { eventPrebuiltComponentMounted, TelemetryCollector } from '@clerk/shared
 import { addClerkPrefix, stripScheme } from '@clerk/shared/url';
 import { handleValueOrFn, noop } from '@clerk/shared/utils';
 import type {
-  __experimental_UserVerificationModalProps,
+  __internal_UserVerificationModalProps,
   ActiveSessionResource,
   AuthenticateWithCoinbaseWalletParams,
   AuthenticateWithGoogleOneTapParams,
@@ -420,7 +420,7 @@ export class Clerk implements ClerkInterface {
     void this.#componentControls.ensureMounted().then(controls => controls.closeModal('signIn'));
   };
 
-  public __experimental_openUserVerification = (props?: __experimental_UserVerificationModalProps): void => {
+  public __internal_openUserVerification = (props?: __internal_UserVerificationModalProps): void => {
     this.assertComponentsReady(this.#componentControls);
     if (noUserExists(this)) {
       if (this.#instanceType === 'development') {
@@ -435,6 +435,11 @@ export class Clerk implements ClerkInterface {
       .then(controls => controls.openModal('userVerification', props || {}));
   };
 
+  public __internal_closeUserVerification = (): void => {
+    this.assertComponentsReady(this.#componentControls);
+    void this.#componentControls.ensureMounted().then(controls => controls.closeModal('userVerification'));
+  };
+
   public __internal_openBlankCaptchaModal = (): Promise<unknown> => {
     this.assertComponentsReady(this.#componentControls);
     return this.#componentControls
@@ -449,11 +454,6 @@ export class Clerk implements ClerkInterface {
       .then(controls => controls.closeModal('blankCaptcha'));
   };
 
-  public __experimental_closeUserVerification = (): void => {
-    this.assertComponentsReady(this.#componentControls);
-    void this.#componentControls.ensureMounted().then(controls => controls.closeModal('userVerification'));
-  };
-
   public openSignUp = (props?: SignUpProps): void => {
     this.assertComponentsReady(this.#componentControls);
     if (sessionExistsAndSingleSessionModeEnabled(this, this.environment)) {