chore(vue,nuxt): Make initialState prop public and bump dependencies

.changeset/tame-poems-impress.md

@@ -0,0 +1,6 @@
+---
+"@clerk/nuxt": patch
+"@clerk/vue": patch
+---
+
+Make `initialState` prop public and bump `@nuxt/kit` to 3.17.5

packages/nextjs/src/__tests__/webhooks.test.ts

@@ -10,16 +10,22 @@ const mockSuccessResponse = {
   object: 'event',
 } as any;
 
-const mockError = new Error('Missing required Svix headers: svix-id, svix-timestamp, svix-signature');
-
 vi.mock('@clerk/backend/webhooks', () => ({
-  verifyWebhook: vi.fn().mockImplementation((request: Request) => {
-    const svixId = request.headers.get('svix-id');
-    const svixTimestamp = request.headers.get('svix-timestamp');
-    const svixSignature = request.headers.get('svix-signature');
+  verifyWebhook: vi.fn().mockImplementation(async (request: any) => {
+    // Support both Fetch API Request and plain object
+    const getHeader = (key: string) => {
+      if (request instanceof Request) {
+        return request.headers.get(key);
+      }
+      return request.headers?.[key];
+    };
+
+    const svixId = getHeader('svix-id');
+    const svixTimestamp = getHeader('svix-timestamp');
+    const svixSignature = getHeader('svix-signature');
 
     if (!svixId || !svixTimestamp || !svixSignature) {
-      throw mockError;
+      throw new Error('Missing required Svix headers: svix-id, svix-timestamp, svix-signature');
     }
 
     return mockSuccessResponse;
@@ -88,7 +94,9 @@ describe('verifyWebhook', () => {
         aborted: false,
       } as unknown as NextApiRequest;
 
-      await expect(verifyWebhook(mockNextApiRequest)).rejects.toThrow(mockError);
+      await expect(verifyWebhook(mockNextApiRequest)).rejects.toThrow(
+        'Missing required Svix headers: svix-id, svix-timestamp, svix-signature',
+      );
     });
   });
 });

packages/nuxt/package.json

@@ -71,12 +71,12 @@
     "@clerk/shared": "workspace:^",
     "@clerk/types": "workspace:^",
     "@clerk/vue": "workspace:^",
-    "@nuxt/kit": "^3.16.2",
-    "@nuxt/schema": "^3.16.2",
-    "h3": "^1.15.1"
+    "@nuxt/kit": "^3.17.5",
+    "@nuxt/schema": "^3.17.5",
+    "h3": "^1.15.3"
   },
   "devDependencies": {
-    "nuxt": "^3.16.2",
+    "nuxt": "^3.17.5",
     "typescript": "catalog:repo"
   },
   "engines": {

packages/nuxt/src/global.d.ts

@@ -11,6 +11,7 @@ declare module 'nuxt/schema' {
     clerk: {
       secretKey?: string;
       jwtKey?: string;
+      webhookSigningSecret?: string;
     };
   }
   interface PublicRuntimeConfig {

packages/nuxt/src/module.ts

@@ -12,7 +12,10 @@ import {
   updateRuntimeConfig,
 } from '@nuxt/kit';
 
-export type ModuleOptions = Without<PluginOptions, 'routerPush' | 'routerReplace' | 'publishableKey'> & {
+export type ModuleOptions = Without<
+  PluginOptions,
+  'routerPush' | 'routerReplace' | 'publishableKey' | 'initialState'
+> & {
   publishableKey?: string;
   /**
    * Skip the automatic server middleware registration. When enabled, you'll need to
@@ -106,10 +109,10 @@ export default defineNuxtModule<ModuleOptions>({
     addTypeTemplate(
       {
         filename: 'types/clerk.d.ts',
-        getContents: () => `import type { SignedInAuthObject, SignedOutAuthObject } from '@clerk/backend/internal';
+        getContents: () => `import type { SessionAuthObject } from '@clerk/backend';
           declare module 'h3' {
-            type AuthObjectHandler = (SignedInAuthObject | SignedOutAuthObject) & {
-              (): SignedInAuthObject | SignedOutAuthObject;
+            type AuthObjectHandler = SessionAuthObject & {
+              (): SessionAuthObject;
             }
 
             interface H3EventContext {

packages/nuxt/src/runtime/plugin.ts

@@ -1,4 +1,5 @@
 import { setClerkJsLoadingErrorPackageName } from '@clerk/shared/loadClerkJsScript';
+import type { InitialState } from '@clerk/types';
 import { clerkPlugin } from '@clerk/vue';
 import { setErrorThrowerOptions } from '@clerk/vue/internal';
 import { defineNuxtPlugin, navigateTo, useRuntimeConfig, useState } from 'nuxt/app';
@@ -8,14 +9,15 @@ setClerkJsLoadingErrorPackageName(PACKAGE_NAME);
 
 export default defineNuxtPlugin(nuxtApp => {
   // SSR-friendly shared state
-  const initialState = useState('clerk-initial-state', () => undefined);
+  const initialState = useState<InitialState | undefined>('clerk-initial-state', () => undefined);
 
   if (import.meta.server) {
     // Save the initial state from server and pass it to the plugin
     initialState.value = nuxtApp.ssrContext?.event.context.__clerk_initial_state;
   }
 
   const runtimeConfig = useRuntimeConfig();
+
   nuxtApp.vueApp.use(clerkPlugin, {
     ...(runtimeConfig.public.clerk ?? {}),
     sdkMetadata: {

packages/vue/package.json

@@ -62,10 +62,10 @@
   },
   "devDependencies": {
     "@testing-library/vue": "^8.1.0",
-    "@vitejs/plugin-vue": "^5.2.3",
+    "@vitejs/plugin-vue": "^5.2.4",
     "@vue.ts/tsx-auto-props": "^0.6.0",
-    "unplugin-vue": "^5.2.1",
-    "vue": "3.5.13",
+    "unplugin-vue": "^6.2.0",
+    "vue": "3.5.16",
     "vue-tsc": "^2.2.10"
   },
   "peerDependencies": {

packages/vue/src/plugin.ts

@@ -1,13 +1,16 @@
 import { inBrowser } from '@clerk/shared/browser';
 import { deriveState } from '@clerk/shared/deriveState';
 import { loadClerkJsScript, type LoadClerkJsScriptOptions } from '@clerk/shared/loadClerkJsScript';
-import type { Clerk, ClientResource, MultiDomainAndOrProxy, Resources, Without } from '@clerk/types';
+import type { Clerk, ClientResource, InitialState, MultiDomainAndOrProxy, Resources, Without } from '@clerk/types';
 import type { Plugin } from 'vue';
 import { computed, ref, shallowRef, triggerRef } from 'vue';
 
 import { ClerkInjectionKey } from './keys';
 
-export type PluginOptions = Without<LoadClerkJsScriptOptions, 'domain' | 'proxyUrl'> & MultiDomainAndOrProxy;
+export type PluginOptions = Without<LoadClerkJsScriptOptions, 'domain' | 'proxyUrl'> &
+  MultiDomainAndOrProxy & {
+    initialState?: InitialState;
+  };
 
 const SDK_METADATA = {
   name: PACKAGE_NAME,
@@ -35,7 +38,6 @@ const SDK_METADATA = {
  */
 export const clerkPlugin: Plugin<[PluginOptions]> = {
   install(app, pluginOptions) {
-    // @ts-expect-error: Internal property for SSR frameworks like Nuxt
     const { initialState } = pluginOptions;
 
     const loaded = shallowRef(false);