diff --git a/.changeset/auth-import-error.md b/.changeset/auth-import-error.md new file mode 100644 index 00000000000..6ac19aef736 --- /dev/null +++ b/.changeset/auth-import-error.md @@ -0,0 +1,5 @@ +--- +"@clerk/nextjs": patch +--- + +Add helpful TypeScript error for incorrect `auth` import path \ No newline at end of file diff --git a/packages/nextjs/src/index.ts b/packages/nextjs/src/index.ts index 65e061353bf..25cea1d9d19 100644 --- a/packages/nextjs/src/index.ts +++ b/packages/nextjs/src/index.ts @@ -81,3 +81,17 @@ import type { ServerComponentsServerModuleTypes } from './components.server'; export const ClerkProvider = ComponentsModule.ClerkProvider as ServerComponentsServerModuleTypes['ClerkProvider']; export const Show = ComponentsModule.Show as ServerComponentsServerModuleTypes['Show']; + +/** + * `auth` is not available from this import path. + * + * **To fix this error:** + * ```diff + * - import { auth } from '@clerk/nextjs' + * + import { auth } from '@clerk/nextjs/server' + * ``` + * + * The `auth` function is only available in server-side contexts: + * API Routes, Server Components, Server Actions, and Middleware. + */ +export declare const auth: never;