setup: lint, ci, tests, nuxthub integration

Author: onmax

.github/workflows/ci.yml

@@ -0,0 +1,21 @@
+name: lint
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: pnpm/action-setup@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 22
+          cache: pnpm
+
+      - run: pnpm install
+      - run: pnpm lint

.github/workflows/lint.yml

@@ -0,0 +1,22 @@
+name: pkg.new
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  pkg:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: pnpm/action-setup@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 22
+          cache: pnpm
+
+      - run: pnpm install
+      - run: pnpm prepack
+      - uses: pkg-pr-new/action@v1

.github/workflows/pkg.yml

@@ -1 +1,2 @@
 enable-pre-post-scripts=true
+shamefully-hoist=true

.npmrc

@@ -5,25 +5,51 @@
 [![License][license-src]][license-href]
 [![Nuxt][nuxt-src]][nuxt-href]
 
-Nuxt module for [Better Auth](https://better-auth.com) integration with route protection, session management, and role-based access.
+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.
 
 ## 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`
 
+## Requirements
+
+- NuxtHub with database enabled (`hub: { database: true }`)
+
 ## Quick Start
 
 ### 1. Install
 
 ```bash
-pnpm add nuxt-better-auth better-auth drizzle-orm
+pnpm add nuxt-better-auth better-auth drizzle-orm @nuxthub/core
+```
+
+### 2. Configure Nuxt
+
+```ts
+export default defineNuxtConfig({
+  modules: ['@nuxthub/core', 'nuxt-better-auth'],
+
+  hub: { database: true },
+
+  runtimeConfig: {
+    betterAuthSecret: '', // BETTER_AUTH_SECRET env var
+    public: { siteUrl: 'http://localhost:3000' },
+  },
+
+  routeRules: {
+    '/app/**': { auth: 'user' },
+    '/admin/**': { auth: 'user', requiresAdmin: true },
+    '/login': { auth: 'guest' },
+  },
+})
 ```
 
-### 2. Create Server Config
+### 3. Create Server Config
 
 Create `server/auth.config.ts`:
 
@@ -38,7 +64,7 @@ export default defineServerAuth(({ runtimeConfig, db }) => ({
 }))
 ```
 
-### 3. Create Client Config
+### 4. Create Client Config
 
 Create `app/auth.client.ts`:
 
@@ -56,7 +82,7 @@ export function createAppAuthClient(baseURL: string) {
 export type AppAuthClient = ReturnType<typeof createAppAuthClient>
 ```
 
-### 4. Add Type Extensions
+### 5. Add Type Extensions
 
 Create `shared/types/auth.d.ts`:
 
@@ -71,36 +97,6 @@ declare module '#nuxt-better-auth' {
 }
 ```
 
-### 5. Configure Nuxt
-
-```ts
-export default defineNuxtConfig({
-  modules: ['nuxt-better-auth'],
-
-  runtimeConfig: {
-    betterAuthSecret: '', // BETTER_AUTH_SECRET env var
-    public: { siteUrl: 'http://localhost:3000' },
-  },
-
-  routeRules: {
-    '/app/**': { auth: 'user' },
-    '/admin/**': { auth: 'user', requiresAdmin: true },
-    '/login': { auth: 'guest' },
-  },
-})
-```
-
-### 6. Setup Database
-
-Set the global database instance in a server plugin:
-
-```ts
-// server/plugins/db.ts
-export default defineNitroPlugin(() => {
-  ;(globalThis as any).__nuxt_better_auth_db = yourDrizzleInstance
-})
-```
-
 ## Route Rules
 
 | Option | Type | Description |

README.md

@@ -1,20 +1,10 @@
 // @ts-check
-import { createConfigForNuxt } from '@nuxt/eslint-config/flat'
+import antfu from '@antfu/eslint-config'
 
-// Run `npx @eslint/config-inspector` to inspect the resolved config interactively
-export default createConfigForNuxt({
-  features: {
-    // Rules for module authors
-    tooling: true,
-    // Rules for formatting
-    stylistic: true,
-  },
-  dirs: {
-    src: [
-      './playground',
-    ],
+export default antfu({
+  ignores: ['**/*.md', 'dist/**', '.nuxt/**'],
+}, {
+  rules: {
+    'node/prefer-global/process': 'off',
   },
 })
-  .append(
-    // your custom flat config here...
-  )

eslint.config.mjs

@@ -1,10 +1,10 @@
 {
   "name": "nuxt-better-auth",
+  "type": "module",
   "version": "0.1.0",
-  "description": "Nuxt module for Better Auth integration with route protection, session management, and role-based access",
-  "repository": "your-org/nuxt-better-auth",
+  "description": "Nuxt module for Better Auth integration with NuxtHub, route protection, session management, and role-based access",
   "license": "MIT",
-  "type": "module",
+  "repository": "your-org/nuxt-better-auth",
   "exports": {
     ".": { "types": "./dist/types.d.mts", "import": "./dist/module.mjs" }
   },
@@ -16,27 +16,35 @@
     "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",
-    "test:types": "vue-tsc --noEmit && cd playground && vue-tsc --noEmit"
+    "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",
     "radix3": "^1.1.2"
   },
-  "peerDependencies": {
-    "better-auth": ">=1.0.0",
-    "drizzle-orm": ">=0.30.0"
+  "pnpm": {
+    "onlyBuiltDependencies": ["better-sqlite3", "esbuild", "@parcel/watcher"]
   },
   "devDependencies": {
+    "@antfu/eslint-config": "^4.12.0",
     "@nuxt/devtools": "^3.1.1",
-    "@nuxt/eslint-config": "^1.11.0",
     "@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",

package.json

@@ -1,5 +1,7 @@
 export default defineNuxtConfig({
-  modules: ['../src/module'],
+  modules: ['@nuxthub/core', '../src/module'],
+
+  hub: { database: true },
 
   devtools: { enabled: true },
 

playground/nuxt.config.ts

@@ -1,7 +1,7 @@
 {
-  "private": true,
   "name": "my-module-playground",
   "type": "module",
+  "private": true,
   "scripts": {
     "dev": "nuxi dev",
     "build": "nuxi build",

playground/package.json

@@ -1,7 +1,7 @@
 import { admin } from 'better-auth/plugins'
 import { defineServerAuth } from '../../src/runtime/config'
 
-export default defineServerAuth(({ runtimeConfig }) => ({
+export default defineServerAuth(({ runtimeConfig: _runtimeConfig }) => ({
   appName: 'Nuxt Better Auth Playground',
   plugins: [admin()],
   emailAndPassword: { enabled: true },