@nuxtjs/better-auth 0.1.3 → 0.2.0

package/README.md

@@ -4,7 +4,7 @@ Nuxt module for [Better Auth](https://better-auth.com) with Nuxt-native route pr
 
 ## Who this is for
 
-Use this module if you want Better Auth in a Nuxt 4 app and you want the Nuxt-specific pieces handled for you:
+Use this module if you want Better Auth in a Nuxt app and you want the Nuxt-specific pieces handled for you:
 
 - `useUserSession()` for reactive auth state
 - `requireUserSession(event)` and related server helpers
@@ -14,7 +14,7 @@ Use this module if you want Better Auth in a Nuxt 4 app and you want the Nuxt-sp
 
 ## Install the module
 
-For the fastest path in a Nuxt 4 app:
+For the fastest path in a Nuxt app:
 
 ```bash
 npx nuxi module add @nuxtjs/better-auth

package/dist/module.json

@@ -1,12 +1,12 @@
 {
   "name": "@nuxtjs/better-auth",
-  "version": "0.1.3",
+  "version": "0.2.0",
   "configKey": "auth",
   "compatibility": {
     "nuxt": ">=4.0.0"
   },
   "builder": {
-    "@nuxt/module-builder": "1.0.2",
+    "@nuxt/module-builder": "1.0.3",
     "unbuild": "unknown"
   }
 }

package/dist/module.mjs

@@ -10,7 +10,7 @@ import { randomBytes } from 'node:crypto';
 import { isCI, isTest } from 'std-env';
 export { defineClientAuth, defineServerAuth } from '../dist/runtime/config.js';
 
-const version = "0.1.3";
+const version = "0.2.0";
 
 const CONFIG_EXTENSIONS = [".ts", ".js"];
 const CONFIG_EXTENSION_RE = /\.(?:ts|js)$/;
@@ -592,10 +592,7 @@ function setupRuntimeConfig(input) {
     redirectQueryKey: options.redirectQueryKey ?? "redirect",
     useDatabase: databaseProvider !== "none",
     databaseProvider,
-    clientOnly,
-    session: {
-      skipHydratedSsrGetSession: options.session?.skipHydratedSsrGetSession ?? false
-    }
+    clientOnly
   });
   if (clientOnly) {
     const siteUrl = nuxt.options.runtimeConfig.public.siteUrl;

package/dist/runtime/app/composables/useUserSession.js

@@ -6,7 +6,6 @@ import { isRecord } from "../internal/utils.js";
 import { createVueSafeAuthFacade, isAuthProxyProbeKey } from "../internal/vue-safe-auth-proxy.js";
 import { wrapAuthMethod } from "../internal/wrap-auth-method.js";
 import { getAuthRuntimeFlags, useRawAuthClient } from "./useAuthClient.js";
-let _sessionSignalListenerBound = false;
 let _signOutPromise = null;
 function createServerOnlyActionNamespace(path) {
   return new Proxy({}, {
@@ -22,24 +21,6 @@ function createServerOnlyActionNamespace(path) {
 }
 const _signInServerOnly = createServerOnlyActionNamespace("signIn");
 const _signUpServerOnly = createServerOnlyActionNamespace("signUp");
-function ensureSessionSignalListener(client, onSignal) {
-  if (_sessionSignalListenerBound)
-    return;
-  const store = client.$store;
-  if (!isRecord(store))
-    return;
-  const listen = store.listen;
-  if (typeof listen !== "function")
-    return;
-  _sessionSignalListenerBound = true;
-  const listenFn = listen;
-  listenFn("$sessionSignal", async () => {
-    try {
-      await onSignal();
-    } catch {
-    }
-  });
-}
 export function useUserSession() {
   const runtimeFlags = getAuthRuntimeFlags();
   const runtimeConfig = useRuntimeConfig();
@@ -60,21 +41,6 @@ export function useUserSession() {
       return false;
     return !session.value && !user.value;
   });
-  const skipHydratedSsrGetSession = computed(() => {
-    const authConfig = runtimeConfig.public.auth;
-    return Boolean(authConfig?.session?.skipHydratedSsrGetSession);
-  });
-  const shouldSkipInitialClientSessionFetch = computed(() => {
-    if (!skipHydratedSsrGetSession.value)
-      return false;
-    if (!runtimeFlags.client)
-      return false;
-    if (!nuxtApp.payload.serverRendered)
-      return false;
-    if (isPrerenderedPayload.value)
-      return false;
-    return Boolean(session.value && user.value);
-  });
   if (isPrerenderHydrationEmptySnapshot.value && authReady.value && !prerenderReadyResetQueued.value) {
     prerenderReadyResetQueued.value = true;
     nuxtApp.hook("app:suspense:resolve", () => {
@@ -86,8 +52,6 @@ export function useUserSession() {
       }
     });
   }
-  if (shouldSkipInitialClientSessionFetch.value && !authReady.value)
-    authReady.value = true;
   function clearSession() {
     session.value = null;
     user.value = null;
@@ -123,7 +87,7 @@ export function useUserSession() {
       throw error;
     }
   }
-  if (runtimeFlags.client && rawClient && !shouldSkipInitialClientSessionFetch.value) {
+  if (runtimeFlags.client && rawClient) {
     const clientSession = rawClient.useSession();
     watch(
       () => clientSession.value,
@@ -172,9 +136,6 @@ export function useUserSession() {
       }, 5e3);
     });
   }
-  if (runtimeFlags.client && rawClient && shouldSkipInitialClientSessionFetch.value) {
-    ensureSessionSignalListener(rawClient, () => fetchSession({ force: true }));
-  }
   async function signOut(options) {
     if (!rawClient)
       throw new Error("signOut can only be called on client-side");

package/dist/runtime/config.d.ts

@@ -1,11 +1,11 @@
 import type { BetterAuthOptions, BetterAuthPlugin } from 'better-auth';
 import type { BetterAuthClientOptions } from 'better-auth/client';
-import type { Casing } from 'drizzle-orm/utils';
 import type { ServerAuthContext as BaseServerAuthContext } from './types/augment.js';
 import { createAuthClient } from 'better-auth/vue';
 export interface ServerAuthContextExtension {
 }
 export type ServerAuthContext = BaseServerAuthContext & ServerAuthContextExtension;
+export type SchemaCasing = 'snake_case' | 'camelCase';
 export interface ClientAuthContext {
     siteUrl: string;
 }
@@ -49,16 +49,6 @@ export interface BetterAuthModuleOptions {
      * Default: 'redirect'
      */
     redirectQueryKey?: string;
-    session?: {
-        /**
-         * When enabled, and session/user are already hydrated from SSR, skip the initial
-         * client `/api/auth/get-session` bootstrap request. This also skips Better Auth's
-         * session refresh manager on those pages.
-         *
-         * Default: false
-         */
-        skipHydratedSsrGetSession?: boolean;
-    };
     /**
      * Enable secondary storage for sessions.
      * - `true`: Use NuxtHub KV (requires hub.kv: true)
@@ -71,7 +61,7 @@ export interface BetterAuthModuleOptions {
         /** Plural table names: user → users. Default: false */
         usePlural?: boolean;
         /** Column/table name casing. Explicit value takes precedence over hub.db.casing. */
-        casing?: Casing;
+        casing?: SchemaCasing;
         /** PostgreSQL schema namespace. */
         schemaName?: string;
     };
@@ -88,9 +78,6 @@ export interface AuthRuntimeConfig {
     useDatabase: boolean;
     databaseProvider: EffectiveDatabaseProviderId;
     clientOnly: boolean;
-    session: {
-        skipHydratedSsrGetSession: boolean;
-    };
 }
 export interface AuthPrivateRuntimeConfig {
     hubSecondaryStorage: boolean | 'custom';

package/dist/runtime/server/api/_better-auth/_schema.d.ts

@@ -1,4 +1,8 @@
 import { z } from 'zod';
-export declare const paginationQuerySchema: any;
+export declare const paginationQuerySchema: z.ZodObject<{
+    page: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+    limit: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+    search: z.ZodDefault<z.ZodString>;
+}, z.core.$strip>;
 export type PaginationQuery = z.infer<typeof paginationQuerySchema>;
 export declare function sanitizeSearchPattern(search: string): string;

package/dist/runtime/server/api/_better-auth/sessions.delete.js

@@ -15,7 +15,7 @@ export default defineEventHandler(async (event) => {
     return { success: true };
   } catch (error) {
     if (error instanceof z.ZodError) {
-      throw createAuthError(400, error.errors[0]?.message || "Invalid request");
+      throw createAuthError(400, error.issues[0]?.message || "Invalid request");
     }
     console.error("[DevTools] Delete session failed:", error);
     throw createAuthError(500, "Failed to delete session");

package/dist/runtime/server/utils/auth.d.ts

@@ -8,7 +8,7 @@ type UserAuthConfig = AuthOptions & {
     trustedOrigins?: BetterAuthOptions['trustedOrigins'];
     secondaryStorage?: BetterAuthOptions['secondaryStorage'];
 };
-type ResolvedAuthOptions = UserAuthConfig & {
+type ResolvedAuthOptions = Omit<UserAuthConfig, 'secret' | 'baseURL' | 'trustedOrigins' | 'database'> & {
     secret: string;
     baseURL: string;
     trustedOrigins?: BetterAuthOptions['trustedOrigins'];

package/dist/runtime/server/utils/session.d.ts

@@ -2,6 +2,7 @@ import type { AppSession, AuthSession, RequireSessionOptions } from '#nuxt-bette
 import type { ServerEvent } from '../internal/nitro-compat.js';
 export declare function getRequestSession(event: ServerEvent): Promise<AppSession | null>;
 export declare function getUserSession(event: ServerEvent): Promise<AppSession | null>;
+export declare function setRequestSession(event: ServerEvent, session: AppSession | null): void;
 export declare function refreshSessionCookieCache(event: ServerEvent): Promise<AppSession | null>;
 export declare function setSessionCookie(event: ServerEvent, token: string): Promise<void>;
 export declare function createSession(event: ServerEvent, userId: string): Promise<AuthSession>;

package/dist/runtime/server/utils/session.js

@@ -194,37 +194,47 @@ function updateRequestHeaders(event, sessionCookie, clearedCookieNames) {
 }
 export async function getRequestSession(event) {
   const context = getRequestSessionContext(event);
-  if (context.requestSession !== void 0)
-    return context.requestSession;
   const inFlight = context[requestSessionLoadKey];
   if (inFlight)
     return inFlight;
+  if (context.requestSession !== void 0)
+    return context.requestSession;
   const load = loadSession(event);
   context[requestSessionLoadKey] = load;
   try {
     const session = await load;
-    context.requestSession = session;
+    if (context[requestSessionLoadKey] === load)
+      context.requestSession = session;
     return session;
   } finally {
-    delete context[requestSessionLoadKey];
+    if (context[requestSessionLoadKey] === load)
+      delete context[requestSessionLoadKey];
   }
 }
 export async function getUserSession(event) {
   const context = getRequestSessionContext(event);
-  if (context.requestSession !== void 0)
-    return context.requestSession;
   const inFlight = context[requestSessionLoadKey];
   if (inFlight)
     return inFlight;
+  if (context.requestSession !== void 0)
+    return context.requestSession;
   return loadSession(event);
 }
+export function setRequestSession(event, session) {
+  const context = getRequestSessionContext(event);
+  context.requestSession = session;
+  delete context[requestSessionLoadKey];
+}
 export async function refreshSessionCookieCache(event) {
   const context = getRequestSessionContext(event);
   const inFlight = context[requestSessionLoadKey];
-  if (inFlight)
-    await inFlight.catch(() => void 0);
-  delete context.requestSession;
-  const load = loadFreshSession(event).then(({ headers, response }) => {
+  const load = (inFlight ?? Promise.resolve(null)).catch(() => void 0).then(async () => {
+    if (context[requestSessionLoadKey] !== load)
+      return context.requestSession ?? null;
+    delete context.requestSession;
+    const { headers, response } = await loadFreshSession(event);
+    if (context[requestSessionLoadKey] !== load)
+      return context.requestSession ?? null;
     appendSetCookieHeaders(event, headers);
     context.requestSession = response;
     return response;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@nuxtjs/better-auth",
   "type": "module",
-  "version": "0.1.3",
+  "version": "0.2.0",
   "description": "Nuxt module for Better Auth integration with NuxtHub, route protection, session management, and role-based access",
   "author": "onmax",
   "license": "MIT",
@@ -41,9 +41,12 @@
   "files": [
     "dist"
   ],
+  "engines": {
+    "node": "^22.19.0 || ^24.11.0 || >=26.0.0"
+  },
   "peerDependencies": {
     "@nuxthub/core": ">=0.10.5",
-    "better-auth": ">=1.7.0-rc.5 <2"
+    "better-auth": ">=1.7.1 <2"
   },
   "peerDependenciesMeta": {
     "@nuxthub/core": {
@@ -51,50 +54,49 @@
     }
   },
   "dependencies": {
-    "@nuxt/kit": "^4.3.1",
-    "auth": "1.7.0-rc.5",
-    "defu": "^6.1.4",
+    "@nuxt/devtools-kit": "^3.4.1",
+    "@nuxt/kit": "^4.5.2",
+    "auth": "1.7.1",
+    "consola": "^3.4.2",
+    "defu": "^6.1.7",
     "h3": "^1.15.11",
-    "jiti": "^2.6.1",
+    "jiti": "^2.7.0",
     "pathe": "^2.0.3",
     "radix3": "^1.1.2",
-    "std-env": "^4.0.0",
-    "ufo": "^1.6.4"
+    "std-env": "^4.2.0",
+    "ufo": "^1.6.4",
+    "zod": "^4.4.3"
   },
   "devDependencies": {
-    "@antfu/eslint-config": "^9.0.0",
-    "@libsql/client": "^0.17.3",
+    "@antfu/eslint-config": "^9.3.0",
+    "@libsql/client": "^0.17.4",
     "@libsql/linux-x64-gnu": "0.5.29",
-    "@nuxt/devtools": "^3.2.3",
-    "@nuxt/devtools-kit": "^3.2.4",
-    "@nuxt/module-builder": "^1.0.2",
-    "@nuxt/schema": "^4.3.1",
-    "@nuxt/test-utils": "^4.0.0",
-    "@nuxthub/core": "^0.10.6",
-    "@pinia/nuxt": "^0.11.3",
-    "@types/better-sqlite3": "^7.6.13",
-    "@types/node": "latest",
-    "better-auth": "1.7.0-rc.5",
+    "@nuxt/devtools": "^3.4.1",
+    "@nuxt/module-builder": "^1.0.3",
+    "@nuxt/schema": "^4.5.2",
+    "@nuxt/test-utils": "^4.1.0",
+    "@nuxthub/core": "^0.10.8",
+    "@pinia/nuxt": "^1.0.2",
+    "@types/better-sqlite3": "^9.6.0",
+    "@types/node": "^24.13.3",
+    "better-auth": "1.7.1",
     "better-call": "1.4.0",
     "better-sqlite3": "^12.6.2",
-    "consola": "^3.4.2",
     "drizzle-kit": "^0.31.10",
-    "drizzle-orm": "^0.45.1",
-    "eslint": "^10.0.3",
-    "nitropack": "2.13.1",
-    "nuxt": "^4.3.1",
-    "pinia": "^3.0.4",
-    "pkg-pr-new": "0.0.87",
+    "drizzle-orm": "^0.45.2",
+    "eslint": "^10.8.1",
+    "nitropack": "2.13.4",
+    "nuxt": "^4.5.2",
+    "pinia": "^4.0.3",
+    "pkg-pr-new": "0.0.88",
     "postgres": "^3.4.9",
-    "tinyexec": "^1.1.1",
     "typescript": "~5.9.3",
     "unstorage": "^1.17.5",
-    "vitest": "^4.0.18",
-    "vitest-package-exports": "^1.2.0",
-    "vue": "3.5.29",
-    "vue-tsc": "^3.2.7",
-    "wrangler": "4.72.0",
-    "yaml": "^2.8.3"
+    "vitest": "^4.1.11",
+    "vue": "3.5.41",
+    "vue-tsc": "^3.3.10",
+    "wrangler": "4.124.0",
+    "yaml": "^2.9.0"
   },
   "scripts": {
     "build": "pnpm build:docs",