improve documentation

Author: HugoRCD

.changeset/better-auth-integration.md

@@ -5,9 +5,17 @@
 Add `evlog/better-auth` integration for automatic user identification from [Better Auth](https://better-auth.com/) sessions.
 
 **New exports** (`evlog/better-auth`):
-- `identifyUser(log, session, options?)` — sets `userId`, `user`, and `session` fields on a wide event from a Better Auth session
-- `createAuthIdentifier(auth, options?)` — Nitro `request` hook factory that auto-identifies users on every request (skips `/api/auth/**` by default)
-- `createAuthMiddleware(auth, options?)` — framework-agnostic function `(log, headers) => Promise<void>` for Express, Hono, Fastify, etc.
+- `identifyUser(log, session, options?)` — sets `userId`, `user`, and `session` fields on a wide event. Returns `true` if identified
+- `createAuthMiddleware(auth, options?)` — framework-agnostic `(log, headers, path?) => Promise<boolean>` with route filtering, timing capture, and lifecycle hooks
+- `createAuthIdentifier(auth, options?)` — Nitro `request` hook factory for standalone Nitro apps
 - `maskEmail(email)` — utility to mask emails for safe logging (`h***@example.com`)
+- `BetterAuthInstance` — reusable type for the auth parameter
 
-Options: `maskEmail`, `session` (include session metadata), `fields` (user field whitelist), `exclude`/`include` (route patterns for `createAuthIdentifier`).
+**Features:**
+- `include`/`exclude` route pattern filtering on `createAuthMiddleware`
+- `extend` callback for Better Auth plugin fields (organizations, roles, etc.)
+- `auth.resolvedIn` timing in every wide event
+- `auth.identified` boolean in every wide event
+- `session.userAgent` captured by default
+- `onIdentify`/`onAnonymous` lifecycle hooks
+- `console.warn` in development when session resolution fails

apps/docs/app/app.config.ts

@@ -46,6 +46,20 @@ export default defineAppConfig({
       primary: 'blue',
       neutral: 'zinc',
     },
+    prose: {
+      codeIcon: {
+        'nuxt': 'i-vscode-icons-file-type-nuxt',
+        'nuxt / nitro': 'i-vscode-icons-file-type-nuxt',
+        'next.js': 'i-simple-icons-nextdotjs',
+        'express': 'i-simple-icons-express',
+        'hono': 'i-simple-icons-hono',
+        'fastify': 'i-simple-icons-fastify',
+        'elysia': 'i-custom:elysia',
+        'nestjs': 'i-simple-icons-nestjs',
+        'standalone': 'i-lucide-box',
+        'nitro': 'i-custom:nitro',
+      },
+    },
     button: {
       slots: {
         base: 'active:translate-y-px transition-transform duration-300',