@onmax/nuxt-better-auth 0.0.1

package/README.md

@@ -0,0 +1,180 @@
+# @onmax/nuxt-better-auth
+
+[![npm version][npm-version-src]][npm-version-href]
+[![npm downloads][npm-downloads-src]][npm-downloads-href]
+[![License][license-src]][license-href]
+[![Nuxt][nuxt-src]][nuxt-href]
+
+Nuxt module for [Better Auth](https://better-auth.com) with auto schema generation, route protection, and session management. Works with [NuxtHub](https://hub.nuxt.com) and future `@nuxt/db`.
+
+## Features
+
+- **Auto Schema Generation** - Generates Drizzle schema from your better-auth plugins
+- **Route Protection** - Declarative access rules via `routeRules`
+- **Session Management** - SSR-safe session handling with client hydration
+- **Role-Based Access** - Support for `admin`, `user`, and custom roles
+- **Auto-Imports** - `useUserSession`, `requireUserSession`, `getUserSession`
+- **BetterAuthState Component** - Ready-to-use Vue component with slots
+
+## Requirements
+
+- NuxtHub with database enabled (`hub: { database: true }`) or future `@nuxt/db`
+
+## Quick Start
+
+### 1. Install
+
+```bash
+pnpm add @onmax/nuxt-better-auth better-auth drizzle-orm @nuxthub/core
+```
+
+### 2. Configure Nuxt
+
+```ts
+export default defineNuxtConfig({
+  modules: ['@nuxthub/core', '@onmax/nuxt-better-auth'],
+
+  hub: { database: true },
+
+  runtimeConfig: {
+    betterAuthSecret: '', // BETTER_AUTH_SECRET env var
+    public: { siteUrl: 'http://localhost:3000' },
+  },
+
+  routeRules: {
+    '/app/**': { auth: 'user' },
+    '/admin/**': { auth: { role: 'admin' } },
+    '/login': { auth: 'guest' },
+  },
+})
+```
+
+### 3. Create Server Config
+
+Create `server/auth.config.ts`:
+
+```ts
+import { admin } from 'better-auth/plugins'
+import { defineServerAuth } from '@onmax/nuxt-better-auth'
+
+export default defineServerAuth(({ db }) => ({
+  appName: 'My App',
+  plugins: [admin()],
+  emailAndPassword: { enabled: true },
+}))
+```
+
+> Schema is auto-generated from your plugins! No manual Drizzle schema needed.
+
+### 4. Create Client Config
+
+Create `app/auth.client.ts`:
+
+```ts
+import { adminClient } from 'better-auth/client/plugins'
+import { createAuthClient } from 'better-auth/vue'
+
+export function createAppAuthClient(baseURL: string) {
+  return createAuthClient({
+    baseURL,
+    plugins: [adminClient()],
+  })
+}
+
+export type AppAuthClient = ReturnType<typeof createAppAuthClient>
+```
+
+### 5. Add Type Extensions
+
+Create `shared/types/auth.d.ts`:
+
+```ts
+import '#nuxt-better-auth'
+
+declare module '#nuxt-better-auth' {
+  interface AuthUser {
+    role?: string | null
+    banned?: boolean | null
+  }
+}
+```
+
+## Route Rules
+
+| Option | Type | Description |
+|--------|------|-------------|
+| `auth` | `false \| 'guest' \| 'user' \| { role: string }` | Auth requirement |
+
+Examples:
+- `auth: false` - Public (default)
+- `auth: 'guest'` - Only unauthenticated users
+- `auth: 'user'` - Any authenticated user
+- `auth: { role: 'admin' }` - Requires specific role
+
+## Composables
+
+### `useUserSession()`
+
+```ts
+const { user, session, loggedIn, ready, client } = useUserSession()
+```
+
+### `<BetterAuthState>`
+
+```vue
+<BetterAuthState>
+  <template #default="{ loggedIn, user, signOut }">
+    <p v-if="loggedIn">Welcome, {{ user?.name }}</p>
+    <p v-else>Not logged in</p>
+  </template>
+  <template #placeholder>
+    <p>Loading...</p>
+  </template>
+</BetterAuthState>
+```
+
+## Server Utils
+
+```ts
+// Require auth
+const { user, session } = await requireUserSession(event)
+
+// Require admin
+const { user } = await requireUserSession(event, { role: 'admin' })
+
+// Optional session
+const session = await getUserSession(event)
+```
+
+## Module Aliases
+
+| Alias | Points To |
+|-------|-----------|
+| `#auth/server` | `server/auth.config.ts` |
+| `#auth/client` | `app/auth.client.ts` |
+| `#nuxt-better-auth` | Module type augmentation |
+
+## Development
+
+```bash
+pnpm install
+pnpm dev:prepare
+pnpm dev
+```
+
+## License
+
+MIT
+
+<!-- Badges -->
+[npm-version-src]: https://img.shields.io/npm/v/@onmax/nuxt-better-auth/latest.svg?style=flat&colorA=020420&colorB=00DC82
+[npm-version-href]: https://npmjs.com/package/@onmax/nuxt-better-auth
+
+[npm-downloads-src]: https://img.shields.io/npm/dm/@onmax/nuxt-better-auth.svg?style=flat&colorA=020420&colorB=00DC82
+[npm-downloads-href]: https://npm.chart.dev/@onmax/nuxt-better-auth
+
+[license-src]: https://img.shields.io/npm/l/@onmax/nuxt-better-auth.svg?style=flat&colorA=020420&colorB=00DC82
+[license-href]: https://npmjs.com/package/@onmax/nuxt-better-auth
+
+[nuxt-src]: https://img.shields.io/badge/Nuxt-020420?logo=nuxt.js
+[nuxt-href]: https://nuxt.com

package/dist/module.d.cts

@@ -0,0 +1,2 @@
+export * from "/home/maxi/nuxt/better-auth/src/module.js";
+export { default } from "/home/maxi/nuxt/better-auth/src/module.js";

package/dist/module.d.mts

@@ -0,0 +1,2 @@
+export * from "/home/maxi/nuxt/better-auth/src/module.js";
+export { default } from "/home/maxi/nuxt/better-auth/src/module.js";

package/dist/module.json

@@ -0,0 +1,12 @@
+{
+  "name": "@onmax/nuxt-better-auth",
+  "configKey": "auth",
+  "compatibility": {
+    "nuxt": ">=3.0.0"
+  },
+  "version": "0.0.1",
+  "builder": {
+    "@nuxt/module-builder": "1.0.2",
+    "unbuild": "3.6.1"
+  }
+}

package/dist/module.mjs

@@ -0,0 +1,20 @@
+import { createJiti } from "file:///home/maxi/nuxt/better-auth/node_modules/.pnpm/jiti@2.6.1/node_modules/jiti/lib/jiti.mjs";
+
+const jiti = createJiti(import.meta.url, {
+  "interopDefault": true,
+  "alias": {
+    "@onmax/nuxt-better-auth": "/home/maxi/nuxt/better-auth"
+  },
+  "transformOptions": {
+    "babel": {
+      "plugins": []
+    }
+  }
+})
+
+/** @type {import("/home/maxi/nuxt/better-auth/src/module.js")} */
+const _module = await jiti.import("/home/maxi/nuxt/better-auth/src/module.ts");
+
+export default _module?.default ?? _module;
+export const defineClientAuth = _module.defineClientAuth;
+export const defineServerAuth = _module.defineServerAuth;

package/dist/types.d.mts

@@ -0,0 +1,13 @@
+import type { ModuleHooks, ModuleRuntimeHooks, ModuleRuntimeConfig, ModulePublicRuntimeConfig } from './module.mjs'
+
+declare module '#app' {
+  interface RuntimeNuxtHooks extends ModuleRuntimeHooks {}
+}
+
+declare module '@nuxt/schema' {
+  interface NuxtHooks extends ModuleHooks {}
+  interface RuntimeConfig extends ModuleRuntimeConfig {}
+  interface PublicRuntimeConfig extends ModulePublicRuntimeConfig {}
+}
+
+export * from "./module.mjs"

package/package.json

@@ -0,0 +1,85 @@
+{
+  "name": "@onmax/nuxt-better-auth",
+  "type": "module",
+  "version": "0.0.1",
+  "description": "Nuxt module for Better Auth integration with NuxtHub, route protection, session management, and role-based access",
+  "license": "MIT",
+  "author": "onmax",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/onmax/nuxt-better-auth"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/types.d.mts",
+      "import": "./dist/module.mjs"
+    }
+  },
+  "main": "./dist/module.mjs",
+  "typesVersions": {
+    "*": {
+      ".": [
+        "./dist/types.d.mts"
+      ]
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "prepack": "nuxt-module-build build",
+    "dev": "pnpm dev:prepare && nuxi dev playground",
+    "dev:build": "nuxi build playground",
+    "dev:prepare": "nuxt-module-build build --stub && nuxi prepare playground",
+    "prepare": "nuxt-module-build build --stub && nuxi prepare playground",
+    "release": "pnpm lint && pnpm test && pnpm prepack && changelogen --release && npm publish && git push --follow-tags",
+    "lint": "eslint .",
+    "lint:fix": "eslint . --fix",
+    "typecheck": "vue-tsc --noEmit",
+    "typecheck:playground": "cd playground && vue-tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest watch"
+  },
+  "peerDependencies": {
+    "@nuxthub/core": ">=0.10.0",
+    "better-auth": ">=1.0.0",
+    "drizzle-orm": ">=0.30.0"
+  },
+  "dependencies": {
+    "@nuxt/kit": "^4.2.2",
+    "defu": "^6.1.4",
+    "jiti": "^2.4.2",
+    "pathe": "^2.0.3",
+    "radix3": "^1.1.2"
+  },
+  "devDependencies": {
+    "@antfu/eslint-config": "^4.12.0",
+    "@better-auth/cli": "^1.4.6",
+    "@libsql/client": "^0.15.15",
+    "@nuxt/devtools": "^3.1.1",
+    "@nuxt/module-builder": "^1.0.2",
+    "@nuxt/schema": "^4.2.2",
+    "@nuxt/test-utils": "^3.21.0",
+    "@nuxthub/core": "^0.10.0",
+    "@types/better-sqlite3": "^7.6.13",
+    "@types/node": "latest",
+    "better-auth": "^1.2.8",
+    "better-sqlite3": "^11.9.1",
+    "changelogen": "^0.6.2",
+    "consola": "^3.4.2",
+    "drizzle-kit": "^0.31.8",
+    "drizzle-orm": "^0.38.4",
+    "eslint": "^9.39.1",
+    "nuxt": "^4.2.2",
+    "typescript": "~5.9.3",
+    "vitest": "^4.0.15",
+    "vue-tsc": "^3.1.7"
+  },
+  "pnpm": {
+    "onlyBuiltDependencies": [
+      "better-sqlite3",
+      "esbuild",
+      "@parcel/watcher"
+    ]
+  }
+}