Validate task options on Clerk init

Author: LauraBeatris

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

@@ -119,7 +119,7 @@ import {
   stripOrigin,
   windowNavigate,
 } from '../utils';
-import { assertNoLegacyProp } from '../utils/assertNoLegacyProp';
+import { assertNoLegacyProp, warnNoTaskOptions } from '../utils/assertNoLegacyProp';
 import { CLERK_ENVIRONMENT_STORAGE_ENTRY, SafeLocalStorage } from '../utils/localStorage';
 import { memoizeListenerCallback } from '../utils/memoizeStateListenerCallback';
 import { RedirectUrls } from '../utils/redirectUrls';
@@ -429,6 +429,10 @@ export class Clerk implements ClerkInterface {
 
     assertNoLegacyProp(this.#options);
 
+    if (this.__internal_hasAfterAuthFlows) {
+      warnNoTaskOptions(this.#options);
+    }
+
     if (this.#options.sdkMetadata) {
       Clerk.sdkMetadata = this.#options.sdkMetadata;
     }

packages/clerk-js/src/utils/assertNoLegacyProp.ts

@@ -1,4 +1,5 @@
 import { logger } from '@clerk/shared/logger';
+import type { ClerkOptions } from '@clerk/types';
 
 export function assertNoLegacyProp(props: Record<string, any>) {
   const legacyProps = ['redirectUrl', 'afterSignInUrl', 'afterSignUpUrl', 'after_sign_in_url', 'after_sign_up_url'];
@@ -23,3 +24,17 @@ export function warnForNewPropShadowingLegacyProp(
     );
   }
 }
+
+export function warnNoTaskOptions(options: ClerkOptions) {
+  const taskOptions = ['taskUrls', 'onPendingSession'];
+
+  const hasAtLeastOneTaskOption = Object.keys(options).some(option => taskOptions.includes(option));
+  if (hasAtLeastOneTaskOption) {
+    return;
+  }
+
+  logger.warnOnce(
+    // TODO - Link to after-auth docs once it gets released
+    `Clerk: After-auth is enabled and no task options configured. Consider providing "taskUrls" or "onPendingSession" to handle pending session tasks.`,
+  );
+}