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);

.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);

.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);

.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);

.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);

.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);

.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);

.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);