feat: add support for nitro v3

README.md

@@ -183,6 +183,8 @@ export default defineNitroConfig({
 })
 ```
 
+> **Note**: For early Nitro v3 support, use `evlog/nitro/v3` instead of `evlog/nitro`.
+
 Same API, same wide events:
 
 ```typescript

apps/docs/content/1.getting-started/1.introduction.md

@@ -111,6 +111,8 @@ Structured errors provide actionable context:
 ::code-group
 ```typescript [Code]
 // server/api/checkout.post.ts
+import { createError } from 'evlog'
+
 throw createError({
   message: 'Payment failed',
   status: 402,

apps/docs/content/1.getting-started/2.installation.md

@@ -373,13 +373,42 @@ bun add evlog
 ```
 ::
 
-Then, add evlog as a Nitro plugin (without Nuxt) using the `evlog/nitro` plugin:
+### Nitro v2
 
+Use the Nitro v2 plugin and error handler directly in your config:
+
+::code-group
 ```typescript [nitro.config.ts]
 export default defineNitroConfig({
   plugins: ['evlog/nitro'],
+  errorHandler: ['evlog/nitro'],
 })
 ```
+::
+
+### Nitro v3
+
+Nitro v3 auto-loads plugins from `./plugins`. Create a plugin file and an error handler file next to `nitro.config.ts`:
+
+::code-group
+```typescript [nitro.config.ts]
+import { defineConfig } from 'nitro'
+
+export default defineConfig({
+  errorHandler: './errorHandler',
+})
+```
+```typescript [errorHandler.ts]
+export { default } from 'evlog/nitro/v3/errorHandler'
+```
+```typescript [plugins/evlog.ts]
+export { default } from 'evlog/nitro/v3'
+```
+::
+
+::callout{icon="i-lucide-info" color="info"}
+**Note:** The `createError` function is available from `evlog` for all Nitro versions. Only the plugin and error handler paths differ between v2 and v3.
+::
 
 ## Cloudflare Workers
 

apps/nitro-v3-playground/.gitignore

@@ -0,0 +1,8 @@
+node_modules
+dist
+.data
+.nitro
+.cache
+.output
+.env
+.env.local

apps/nitro-v3-playground/README.md

@@ -0,0 +1,14 @@
+# Nitro v3 evlog playground
+
+## Getting started
+
+```bash
+bun install
+bun run dev
+```
+
+## Deploying
+
+```bash
+bun run build
+```

apps/nitro-v3-playground/errorHandler.ts

@@ -0,0 +1 @@
+export { default } from 'evlog/nitro/v3/errorHandler'

apps/nitro-v3-playground/nitro.config.ts

@@ -0,0 +1,6 @@
+import { defineConfig } from 'nitro'
+
+export default defineConfig({
+  serverDir: './',
+  errorHandler: './errorHandler',
+})

apps/nitro-v3-playground/package.json

@@ -0,0 +1,16 @@
+{
+  "name": "evlog-nitro-v3-playground",
+  "type": "module",
+  "scripts": {
+    "build": "nitro build",
+    "dev": "nitro dev",
+    "preview": "npx srvx --prod .output/"
+  },
+  "dependencies": {
+    "evlog": "workspace:*"
+  },
+  "devDependencies": {
+    "nitro": "latest",
+    "rolldown": "latest"
+  }
+}

apps/nitro-v3-playground/plugins/evlog.ts

@@ -0,0 +1 @@
+export { default } from 'evlog/nitro/v3'

apps/nitro-v3-playground/routes/api/test/create.post.ts

@@ -0,0 +1,29 @@
+import { defineHandler, readBody } from 'nitro/h3'
+import { useLogger } from 'evlog'
+
+export default defineHandler(async (event) => {
+  const log = useLogger(event)
+  const body = await readBody(event) as { name: string; type: string }
+
+  log.set({ user: { id: 456 } })
+  log.set({ item: { name: body.name, type: body.type } })
+
+  // Simulate validation
+  await new Promise(resolve => setTimeout(resolve, 100))
+  log.set({ validation: { passed: true, checks: ['name_length', 'type_valid'] } })
+
+  // Simulate database insert
+  await new Promise(resolve => setTimeout(resolve, 200))
+  const itemId = `item_${Math.random().toString(36).substring(2, 8)}`
+  log.set({ database: { operation: 'insert', duration: '200ms' } })
+
+  // Simulate search indexing
+  await new Promise(resolve => setTimeout(resolve, 80))
+  log.set({ search: { indexed: true, engine: 'elasticsearch' } })
+
+  return {
+    success: true,
+    message: 'Item created',
+    id: itemId,
+  }
+})

apps/nitro-v3-playground/routes/api/test/delete.delete.ts

@@ -0,0 +1,28 @@
+import { defineHandler } from 'nitro/h3'
+import { useLogger } from 'evlog'
+
+export default defineHandler(async (event) => {
+  const log = useLogger(event)
+  const itemId = 'item_123'
+
+  log.set({ user: { id: 789 } })
+  log.set({ action: 'delete_item', itemId })
+
+  // Simulate permission check
+  await new Promise(resolve => setTimeout(resolve, 100))
+  log.set({ permissions: { checked: true, hasDelete: true } })
+
+  // Simulate database delete
+  await new Promise(resolve => setTimeout(resolve, 150))
+  log.set({ database: { operation: 'delete', affected: 1 } })
+
+  // Simulate cache invalidation
+  await new Promise(resolve => setTimeout(resolve, 50))
+  log.set({ cache: { invalidated: true, keys: [`item:${itemId}`] } })
+
+  return {
+    success: true,
+    message: 'Item deleted',
+    deletedId: itemId,
+  }
+})

apps/nitro-v3-playground/routes/api/test/success.get.ts

@@ -0,0 +1,24 @@
+import { defineHandler } from 'nitro/h3'
+import { useLogger } from 'evlog'
+
+export default defineHandler(async (event) => {
+  const log = useLogger(event)
+
+  log.set({ user: { id: 123, plan: 'pro' } })
+  log.set({ action: 'fetch_profile' })
+
+  // Simulate database query
+  await new Promise(resolve => setTimeout(resolve, 150))
+  const profile = { name: 'John Doe', email: 'john@example.com', lastLogin: new Date().toISOString() }
+  log.set({ profile })
+
+  // Simulate cache check
+  await new Promise(resolve => setTimeout(resolve, 50))
+  log.set({ cache: { hit: true, ttl: 3600 } })
+
+  return {
+    success: true,
+    message: 'Profile fetched successfully',
+    data: profile,
+  }
+})

apps/nitro-v3-playground/routes/api/test/update.put.ts

@@ -0,0 +1,26 @@
+import { defineHandler, readBody } from 'nitro/h3'
+import { useLogger, createError } from 'evlog'
+
+export default defineHandler(async (event) => {
+  const log = useLogger(event)
+  const body = await readBody(event) as { name: string; version: string }
+
+  log.set({ user: { id: 999 } })
+  log.set({ action: 'update_item', item: { name: body.name, version: body.version } })
+
+  // Simulate validation check
+  await new Promise(resolve => setTimeout(resolve, 100))
+  log.set({ validation: { checked: true } })
+
+  // Simulate permission check that always fails
+  await new Promise(resolve => setTimeout(resolve, 150))
+  log.set({ permissions: { checked: true, hasUpdate: false, requiredRole: 'admin' } })
+
+  throw createError({
+    message: 'Update failed',
+    status: 403,
+    why: 'Insufficient permissions to update this resource',
+    fix: 'Request admin privileges or contact your team lead',
+    link: 'https://docs.example.com/permissions',
+  })
+})

apps/nitro-v3-playground/routes/api/test/wide-event.get.ts

@@ -0,0 +1,72 @@
+import { defineHandler } from 'nitro/h3'
+import { useLogger } from 'evlog'
+
+export default defineHandler(async (event) => {
+  const log = useLogger(event)
+
+  // User context
+  await new Promise(resolve => setTimeout(resolve, 80))
+  log.set({
+    user: {
+      id: 'user_789',
+      email: 'demo@example.com',
+      plan: 'enterprise',
+      accountAge: '2 years',
+      role: 'admin',
+    },
+    session: {
+      device: 'desktop',
+      browser: 'Chrome 120',
+      country: 'US',
+    },
+  })
+
+  // Cart information
+  await new Promise(resolve => setTimeout(resolve, 80))
+  log.set({
+    cart: {
+      items: 5,
+      total: 24999,
+      currency: 'USD',
+      discount: {
+        code: 'WINTER25',
+        savings: 8333,
+      },
+    },
+  })
+
+  // Payment processing
+  await new Promise(resolve => setTimeout(resolve, 80))
+  log.set({
+    payment: {
+      method: 'card',
+      cardBrand: 'visa',
+      cardLast4: '4242',
+    },
+    fraud: {
+      score: 12,
+      riskLevel: 'low',
+      passed: true,
+    },
+  })
+
+  // Performance metrics
+  await new Promise(resolve => setTimeout(resolve, 80))
+  log.set({
+    performance: {
+      dbQueries: 8,
+      cacheHits: 12,
+      cacheMisses: 2,
+    },
+    flags: {
+      newCheckoutFlow: true,
+      experimentId: 'exp_checkout_v2',
+    },
+  })
+
+  return {
+    success: true,
+    message: 'Wide event demo - check your terminal!',
+    orderId: 'ord_abc123xyz',
+  }
+})

apps/nitro-v3-playground/routes/index.ts

@@ -0,0 +1,19 @@
+import { useLogger } from 'evlog'
+import { defineHandler } from 'nitro/h3'
+
+export default defineHandler((event) => {
+  const log = useLogger(event)
+  log.set({
+    playground: 'nitro/v3',
+  })
+  return {
+    message: 'evlog Nitro v3 Playground',
+    endpoints: [
+      'GET /api/test/success',
+      'POST /api/test/create',
+      'PUT /api/test/update (always fails)',
+      'DELETE /api/test/delete',
+      'GET /api/test/wide-event',
+    ],
+  }
+})

apps/nitro-v3-playground/tsconfig.json

@@ -0,0 +1,9 @@
+{
+  "extends": ["nitro/tsconfig"],
+  "compilerOptions": {
+    "moduleResolution": "bundler",
+    "paths": {
+      "~/*": ["./*"],
+    }
+  }
+}