fix(nuxt): Add TypeScript support for auth object in event handlers

.changeset/soft-walls-speak.md

@@ -0,0 +1,15 @@
+---
+"@clerk/nuxt": minor
+---
+
+Bump `@nuxt/*` dependencies to 3.16.0 and add proper typing for `event.context.auth` object in event handlers
+
+```ts
+export default eventHandler((event) => {
+  const { userId } = event.context.auth // auth is now typed
+
+  // ...
+
+  return { userId }
+})
+```

packages/nuxt/package.json

@@ -67,12 +67,12 @@
     "@clerk/shared": "workspace:^",
     "@clerk/types": "workspace:^",
     "@clerk/vue": "workspace:^",
-    "@nuxt/kit": "^3.14.159",
-    "@nuxt/schema": "^3.14.159",
+    "@nuxt/kit": "^3.16.0",
+    "@nuxt/schema": "^3.16.0",
     "h3": "^1.13.0"
   },
   "devDependencies": {
-    "nuxt": "^3.14.159",
+    "nuxt": "^3.16.0",
     "typescript": "catalog:repo"
   },
   "engines": {

packages/nuxt/src/module.ts

@@ -5,6 +5,7 @@ import {
   addImportsDir,
   addPlugin,
   addServerHandler,
+  addTypeTemplate,
   createResolver,
   defineNuxtModule,
   updateRuntimeConfig,
@@ -97,6 +98,21 @@ export default defineNuxtModule<ModuleOptions>({
       });
     }
 
+    // Adds TS support for `event.context.auth` in event handlers
+    addTypeTemplate(
+      {
+        filename: 'types/clerk.d.ts',
+        getContents: () => `import type { AuthObject } from '@clerk/backend';
+          declare module 'h3' {
+            interface H3EventContext {
+              auth: AuthObject;
+            }
+          }
+        `,
+      },
+      { nitro: true },
+    );
+
     // Add auto-imports for Clerk components, composables and client utils
     addImportsDir(resolver.resolve('./runtime/composables'));
     addImports([

packages/nuxt/src/runtime/server/clerkMiddleware.ts

@@ -1,4 +1,3 @@
-import type { AuthObject } from '@clerk/backend';
 import type { AuthenticateRequestOptions } from '@clerk/backend/internal';
 import { AuthStatus, constants } from '@clerk/backend/internal';
 import { eventMethodCalled } from '@clerk/shared/telemetry';
@@ -115,9 +114,3 @@ export const clerkMiddleware: ClerkMiddleware = (...args: unknown[]) => {
     await handler?.(event);
   });
 };
-
-declare module 'h3' {
-  interface H3EventContext {
-    auth: AuthObject;
-  }
-}