chore(clerk-react,shared): Improve assertion error for requiring active organization

Author: panteliselef

.changeset/plain-bottles-press.md

@@ -0,0 +1,6 @@
+---
+'@clerk/shared': patch
+'@clerk/clerk-react': patch
+---
+
+Improve assertion error for requiring active organization.

packages/react/src/components/CheckoutButton.tsx

@@ -63,7 +63,9 @@ export const CheckoutButton = withClerk(
     }
 
     if (orgId === null && _for === 'organization') {
-      throw new Error('Wrap `<CheckoutButton for="organization" />` with a check for an active organization.');
+      throw new Error(
+        'Wrap `<CheckoutButton for="organization" />` with a check for an active organization. Retrieve `orgId` from `useAuth()` and confirm it is defined. For SSR, see: https://clerk.com/docs/references/backend/types/auth-object#how-to-access-the-auth-object',
+      );
     }
 
     children = normalizeWithDefaultValue(children, 'Checkout');

packages/react/src/components/SubscriptionDetailsButton.tsx

@@ -58,7 +58,7 @@ export const SubscriptionDetailsButton = withClerk(
 
     if (orgId === null && _for === 'organization') {
       throw new Error(
-        'Wrap `<SubscriptionDetailsButton for="organization" />` with a check for an active organization.',
+        'Wrap `<SubscriptionDetailsButton for="organization" />` with a check for an active organization. Retrieve `orgId` from `useAuth()` and confirm it is defined. For SSR, see: https://clerk.com/docs/references/backend/types/auth-object#how-to-access-the-auth-object',
       );
     }
 

packages/shared/src/react/hooks/useCheckout.ts

@@ -84,7 +84,9 @@ export const useCheckout = (options?: Params): __experimental_UseCheckoutReturn
   }
 
   if (forOrganization === 'organization' && !organization) {
-    throw new Error('Clerk: Wrap your flow with a check for an active organization');
+    throw new Error(
+      'Clerk: Ensure your flow checks for an active organization. Retrieve `orgId` from `useAuth()` and confirm it is defined. For SSR, see: https://clerk.com/docs/references/backend/types/auth-object#how-to-access-the-auth-object',
+    );
   }
 
   const manager = useMemo(