rename to @onmax/nuxt-better-auth

Author: onmax

README.md

@@ -1,38 +1,38 @@
-# Nuxt Better Auth
+# @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) integration with [NuxtHub](https://hub.nuxt.com). Provides route protection, session management, and role-based access.
+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
 
-- NuxtHub Integration - Uses `hub:db` for database access
-- Route Protection - Declarative access rules via `routeRules`
-- Session Management - Server and client plugins that sync auth state
-- Role-Based Access - Support for `admin`, `user`, and custom roles
-- Tier Gating - Generic tier system for subscription/premium features
-- Auto-Imports - `useUserSession`, `usePageAccess`, `requireUserSession`, `getUserSession`
+- **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 }`)
+- NuxtHub with database enabled (`hub: { database: true }`) or future `@nuxt/db`
 
 ## Quick Start
 
 ### 1. Install
 
 ```bash
-pnpm add nuxt-better-auth better-auth drizzle-orm @nuxthub/core
+pnpm add @onmax/nuxt-better-auth better-auth drizzle-orm @nuxthub/core
 ```
 
 ### 2. Configure Nuxt
 
 ```ts
 export default defineNuxtConfig({
-  modules: ['@nuxthub/core', 'nuxt-better-auth'],
+  modules: ['@nuxthub/core', '@onmax/nuxt-better-auth'],
 
   hub: { database: true },
 
@@ -43,7 +43,7 @@ export default defineNuxtConfig({
 
   routeRules: {
     '/app/**': { auth: 'user' },
-    '/admin/**': { auth: 'user', requiresAdmin: true },
+    '/admin/**': { auth: { role: 'admin' } },
     '/login': { auth: 'guest' },
   },
 })
@@ -55,15 +55,17 @@ Create `server/auth.config.ts`:
 
 ```ts
 import { admin } from 'better-auth/plugins'
-import { defineServerAuth } from 'nuxt-better-auth'
+import { defineServerAuth } from '@onmax/nuxt-better-auth'
 
-export default defineServerAuth(({ runtimeConfig, db }) => ({
+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`:
@@ -101,23 +103,34 @@ declare module '#nuxt-better-auth' {
 
 | Option | Type | Description |
 |--------|------|-------------|
-| `auth` | `boolean \| 'guest' \| 'user'` | Auth requirement |
-| `role` | `string \| string[]` | Required role(s) |
-| `requiresAdmin` | `boolean` | Shorthand for `role: 'admin'` |
-| `tier` | `string \| string[]` | Required tier |
+| `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, signIn, signUp, signOut, fetchSession, updateUser } = useUserSession()
+const { user, session, loggedIn, ready, client } = useUserSession()
 ```
 
-### `usePageAccess()`
-
-```ts
-const { hasAccess, showPaywall, paywallConfig } = usePageAccess()
+### `<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
@@ -154,14 +167,14 @@ pnpm dev
 MIT
 
 <!-- Badges -->
-[npm-version-src]: https://img.shields.io/npm/v/nuxt-better-auth/latest.svg?style=flat&colorA=020420&colorB=00DC82
-[npm-version-href]: https://npmjs.com/package/nuxt-better-auth
+[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/nuxt-better-auth.svg?style=flat&colorA=020420&colorB=00DC82
-[npm-downloads-href]: https://npm.chart.dev/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/nuxt-better-auth.svg?style=flat&colorA=020420&colorB=00DC82
-[license-href]: https://npmjs.com/package/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.json

@@ -1,10 +1,14 @@
 {
-  "name": "nuxt-better-auth",
+  "name": "@onmax/nuxt-better-auth",
   "type": "module",
   "version": "0.1.0",
   "description": "Nuxt module for Better Auth integration with NuxtHub, route protection, session management, and role-based access",
   "license": "MIT",
-  "repository": "your-org/nuxt-better-auth",
+  "author": "onmax",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/onmax/nuxt-better-auth"
+  },
   "exports": {
     ".": {
       "types": "./dist/types.d.mts",

src/module.ts

@@ -11,7 +11,7 @@ import { generateDrizzleSchema, loadUserAuthConfig } from './schema-generator'
 export interface BetterAuthModuleOptions {}
 
 export default defineNuxtModule<BetterAuthModuleOptions>({
-  meta: { name: 'nuxt-better-auth', configKey: 'auth', compatibility: { nuxt: '>=3.0.0' } },
+  meta: { name: '@onmax/nuxt-better-auth', configKey: 'auth', compatibility: { nuxt: '>=3.0.0' } },
   defaults: {},
   async setup(_options, nuxt) {
     const resolver = createResolver(import.meta.url)
@@ -24,9 +24,9 @@ export default defineNuxtModule<BetterAuthModuleOptions>({
     const clientConfigExists = existsSync(`${clientConfigPath}.ts`) || existsSync(`${clientConfigPath}.js`)
 
     if (!serverConfigExists)
-      throw new Error('[nuxt-better-auth] Missing server/auth.config.ts - create with defineServerAuth()')
+      throw new Error('[@onmax/nuxt-better-auth] Missing server/auth.config.ts - create with defineServerAuth()')
     if (!clientConfigExists)
-      throw new Error('[nuxt-better-auth] Missing app/auth.client.ts - export createAppAuthClient()')
+      throw new Error('[@onmax/nuxt-better-auth] Missing app/auth.client.ts - export createAppAuthClient()')
 
     // Register #nuxt-better-auth alias for type augmentation
     nuxt.options.alias['#nuxt-better-auth'] = resolver.resolve('./runtime/types/augment')

src/schema-generator.ts

@@ -146,7 +146,7 @@ export async function loadUserAuthConfig(configPath: string): Promise<Partial<Be
     return {}
   }
   catch (error) {
-    console.warn('[nuxt-better-auth] Failed to load auth config for schema generation:', error)
+    console.warn('[@onmax/nuxt-better-auth] Failed to load auth config for schema generation:', error)
     return {}
   }
 }