evlog 1.8.0 → 1.9.0

package/README.md

@@ -4,13 +4,12 @@
 [![npm downloads](https://img.shields.io/npm/dm/evlog?color=black)](https://npm.chart.dev/evlog)
 [![CI](https://img.shields.io/github/actions/workflow/status/HugoRCD/evlog/ci.yml?branch=main&color=black)](https://github.com/HugoRCD/evlog/actions/workflows/ci.yml)
 [![TypeScript](https://img.shields.io/badge/TypeScript-black?logo=typescript&logoColor=white)](https://www.typescriptlang.org/)
-[![Nuxt](https://img.shields.io/badge/Nuxt-black?logo=nuxt&logoColor=white)](https://nuxt.com/)
 [![Documentation](https://img.shields.io/badge/Documentation-black?logo=readme&logoColor=white)](https://evlog.dev)
 [![license](https://img.shields.io/github/license/HugoRCD/evlog?color=black)](https://github.com/HugoRCD/evlog/blob/main/LICENSE)
 
 **Your logs are lying to you.**
 
-A single request generates 10+ log lines. When production breaks at 3am, you're grep-ing through noise, praying you'll find signal. Your errors say "Something went wrong" – thanks, very helpful.
+A single request generates 10+ log lines. When production breaks at 3am, you're grep-ing through noise, praying you'll find signal. Your errors say "Something went wrong" -- thanks, very helpful.
 
 **evlog fixes this.** One log per request. All context included. Errors that explain themselves.
 
@@ -21,13 +20,13 @@ A single request generates 10+ log lines. When production breaks at 3am, you're
 ```typescript
 // server/api/checkout.post.ts
 
-// ❌ Scattered logs - impossible to debug
+// Scattered logs - impossible to debug
 console.log('Request received')
 console.log('User:', user.id)
 console.log('Cart loaded')
 console.log('Payment failed')  // Good luck finding this at 3am
 
-throw new Error('Something went wrong')  // 🤷‍♂️
+throw new Error('Something went wrong')
 ```
 
 ### The Solution
@@ -36,7 +35,7 @@ throw new Error('Something went wrong')  // 🤷‍♂️
 // server/api/checkout.post.ts
 import { useLogger } from 'evlog'
 
-// ✅ One comprehensive event per request
+// One comprehensive event per request
 export default defineEventHandler(async (event) => {
   const log = useLogger(event)  // Auto-injected by evlog
 
@@ -176,18 +175,43 @@ The wide event emitted at the end contains **everything**:
 
 Works with **any framework powered by Nitro**: Nuxt, Analog, Vinxi, SolidStart, TanStack Start, and more.
 
+### Nitro v3
+
+```typescript
+// nitro.config.ts
+import { defineConfig } from 'nitro'
+import evlog from 'evlog/nitro/v3'
+
+export default defineConfig({
+  modules: [
+    evlog({ env: { service: 'my-api' } })
+  ],
+})
+```
+
+### Nitro v2
+
 ```typescript
 // nitro.config.ts
+import { defineNitroConfig } from 'nitropack/config'
+import evlog from 'evlog/nitro'
+
 export default defineNitroConfig({
-  plugins: ['evlog/nitro'],
+  modules: [
+    evlog({ env: { service: 'my-api' } })
+  ],
 })
 ```
 
-Same API, same wide events:
+Then use `useLogger` in any route. Import from `evlog/nitro/v3` (v3) or `evlog/nitro` (v2):
 
 ```typescript
 // routes/api/documents/[id]/export.post.ts
-import { useLogger, createError } from 'evlog'
+// Nitro v3: import { defineHandler } from 'nitro/h3' + import { useLogger } from 'evlog/nitro/v3'
+// Nitro v2: import { defineEventHandler } from 'h3' + import { useLogger } from 'evlog/nitro'
+import { defineEventHandler } from 'h3'
+import { useLogger } from 'evlog/nitro'
+import { createError } from 'evlog'
 
 export default defineEventHandler(async (event) => {
   const log = useLogger(event)
@@ -248,47 +272,6 @@ Output when the export completes:
 }
 ```
 
-## Structured Errors
-
-Errors should tell you **what** happened, **why**, and **how to fix it**.
-
-```typescript
-// server/api/repos/sync.post.ts
-import { useLogger, createError } from 'evlog'
-
-export default defineEventHandler(async (event) => {
-  const log = useLogger(event)
-
-  log.set({ repo: { owner: 'acme', name: 'my-project' } })
-
-  try {
-    const result = await syncWithGitHub()
-    log.set({ sync: { commits: result.commits, files: result.files } })
-    return result
-  } catch (error) {
-    log.error(error, { step: 'github-sync' })
-
-    throw createError({
-      message: 'Failed to sync repository',
-      status: 503,
-      why: 'GitHub API rate limit exceeded',
-      fix: 'Wait 1 hour or use a different token',
-      link: 'https://docs.github.com/en/rest/rate-limit',
-      cause: error,
-    })
-  }
-})
-```
-
-Console output (development):
-
-```
-Error: Failed to sync repository
-Why: GitHub API rate limit exceeded
-Fix: Wait 1 hour or use a different token
-More info: https://docs.github.com/en/rest/rate-limit
-```
-
 ## Standalone TypeScript
 
 For scripts, workers, or any TypeScript project:
@@ -390,6 +373,130 @@ Notes:
 - `request.cf` is included (colo, country, asn) unless disabled
 - Use `headerAllowlist` to avoid logging sensitive headers
 
+## Hono
+
+Use the standalone API to create one wide event per request from a Hono middleware.
+
+```typescript
+// src/index.ts
+import { serve } from '@hono/node-server'
+import { Hono } from 'hono'
+import { createRequestLogger, initLogger } from 'evlog'
+
+initLogger({
+  env: { service: 'hono-api' },
+})
+
+const app = new Hono()
+
+app.use('*', async (c, next) => {
+  const startedAt = Date.now()
+  const log = createRequestLogger({ method: c.req.method, path: c.req.path })
+
+  try {
+    await next()
+  } catch (error) {
+    log.error(error as Error)
+    throw error
+  } finally {
+    log.emit({
+      status: c.res.status,
+      duration: Date.now() - startedAt,
+    })
+  }
+})
+
+app.get('/health', (c) => c.json({ ok: true }))
+
+serve({ fetch: app.fetch, port: 3000 })
+```
+
+See the full [hono example](https://github.com/HugoRCD/evlog/tree/main/examples/hono) for a complete working project.
+
+## Browser
+
+Use the `log` API on the client side for structured browser logging:
+
+```typescript
+import { log } from 'evlog/browser'
+
+log.info('checkout', 'User initiated checkout')
+log.error({ action: 'payment', error: 'validation_failed' })
+```
+
+In Nuxt, `log` is auto-imported -- no import needed in Vue components:
+
+```vue
+<script setup>
+log.info('checkout', 'User initiated checkout')
+</script>
+```
+
+Client logs output to the browser console with colored tags in development.
+
+### Client Transport
+
+To send client logs to the server for centralized logging, enable the transport:
+
+```typescript
+// nuxt.config.ts
+export default defineNuxtConfig({
+  modules: ['evlog/nuxt'],
+  evlog: {
+    transport: {
+      enabled: true,  // Send client logs to server
+    },
+  },
+})
+```
+
+When enabled:
+1. Client logs are sent to `/api/_evlog/ingest` via POST
+2. Server enriches with environment context (service, version, etc.)
+3. `evlog:drain` hook is called with `source: 'client'`
+4. External services receive the log
+
+## Structured Errors
+
+Errors should tell you **what** happened, **why**, and **how to fix it**.
+
+```typescript
+// server/api/repos/sync.post.ts
+import { useLogger, createError } from 'evlog'
+
+export default defineEventHandler(async (event) => {
+  const log = useLogger(event)
+
+  log.set({ repo: { owner: 'acme', name: 'my-project' } })
+
+  try {
+    const result = await syncWithGitHub()
+    log.set({ sync: { commits: result.commits, files: result.files } })
+    return result
+  } catch (error) {
+    log.error(error, { step: 'github-sync' })
+
+    throw createError({
+      message: 'Failed to sync repository',
+      status: 503,
+      why: 'GitHub API rate limit exceeded',
+      fix: 'Wait 1 hour or use a different token',
+      link: 'https://docs.github.com/en/rest/rate-limit',
+      cause: error,
+    })
+  }
+})
+```
+
+Console output (development):
+
+```
+Error: Failed to sync repository
+Why: GitHub API rate limit exceeded
+Fix: Wait 1 hour or use a different token
+More info: https://docs.github.com/en/rest/rate-limit
+```
+
 ## Enrichment Hook
 
 Use the `evlog:enrich` hook to add derived context after emit, before drain.
@@ -428,6 +535,58 @@ export default defineNitroPlugin((nitroApp) => {
 })
 ```
 
+Each enricher adds a specific field to the event:
+
+| Enricher | Event Field | Shape |
+|----------|-------------|-------|
+| `createUserAgentEnricher()` | `event.userAgent` | `{ raw, browser?: { name, version? }, os?: { name, version? }, device?: { type } }` |
+| `createGeoEnricher()` | `event.geo` | `{ country?, region?, regionCode?, city?, latitude?, longitude? }` |
+| `createRequestSizeEnricher()` | `event.requestSize` | `{ requestBytes?, responseBytes? }` |
+| `createTraceContextEnricher()` | `event.traceContext` + `event.traceId` + `event.spanId` | `{ traceparent?, tracestate?, traceId?, spanId? }` |
+
+All enrichers accept an optional `{ overwrite?: boolean }` option. By default (`overwrite: false`), user-provided data on the event takes precedence over enricher-computed values. Set `overwrite: true` to always replace existing fields.
+
+> **Cloudflare geo note:** Only `cf-ipcountry` is a real Cloudflare HTTP header. The `cf-region`, `cf-city`, `cf-latitude`, `cf-longitude` headers are NOT standard -- they are properties of `request.cf`. For full geo data on Cloudflare, write a custom enricher that reads `request.cf`, or use a Workers middleware to forward `cf` properties as custom headers.
+
+### Custom Enrichers
+
+The `evlog:enrich` hook receives an `EnrichContext` with these fields:
+
+```typescript
+interface EnrichContext {
+  event: WideEvent        // The emitted wide event (mutable -- modify it directly)
+  request?: {             // Request metadata
+    method?: string
+    path?: string
+    requestId?: string
+  }
+  headers?: Record<string, string>  // Safe HTTP headers (sensitive headers filtered)
+  response?: {            // Response metadata
+    status?: number
+    headers?: Record<string, string>
+  }
+}
+```
+
+Example custom enricher:
+
+```typescript
+// server/plugins/evlog-enrich.ts
+export default defineNitroPlugin((nitroApp) => {
+  nitroApp.hooks.hook('evlog:enrich', (ctx) => {
+    // Add deployment metadata
+    ctx.event.deploymentId = process.env.DEPLOYMENT_ID
+    ctx.event.region = process.env.FLY_REGION
+
+    // Extract data from headers
+    const tenantId = ctx.headers?.['x-tenant-id']
+    if (tenantId) {
+      ctx.event.tenantId = tenantId
+    }
+  })
+})
+```
+
 ## Adapters
 
 Send your logs to external observability platforms with built-in adapters.
@@ -469,6 +628,24 @@ Set environment variables:
 NUXT_OTLP_ENDPOINT=http://localhost:4318
 ```
 
+### PostHog
+
+```typescript
+// server/plugins/evlog-drain.ts
+import { createPostHogDrain } from 'evlog/posthog'
+
+export default defineNitroPlugin((nitroApp) => {
+  nitroApp.hooks.hook('evlog:drain', createPostHogDrain())
+})
+```
+
+Set environment variables:
+
+```bash
+NUXT_POSTHOG_API_KEY=phc_your-key
+NUXT_POSTHOG_HOST=https://us.i.posthog.com  # Optional: for EU or self-hosted
+```
+
 ### Sentry
 
 ```typescript
@@ -486,6 +663,23 @@ Set environment variables:
 NUXT_SENTRY_DSN=https://public@o0.ingest.sentry.io/123
 ```
 
+### Better Stack
+
+```typescript
+// server/plugins/evlog-drain.ts
+import { createBetterStackDrain } from 'evlog/better-stack'
+
+export default defineNitroPlugin((nitroApp) => {
+  nitroApp.hooks.hook('evlog:drain', createBetterStackDrain())
+})
+```
+
+Set environment variables:
+
+```bash
+NUXT_BETTER_STACK_SOURCE_TOKEN=your-source-token
+```
+
 ### Multiple Destinations
 
 Send logs to multiple services:
@@ -571,15 +765,15 @@ export default defineNitroPlugin((nitroApp) => {
 | `retry.initialDelayMs` | `1000` | Base delay for first retry |
 | `retry.maxDelayMs` | `30000` | Upper bound for any retry delay |
 | `maxBufferSize` | `1000` | Max buffered events before dropping oldest |
-| `onDropped` | — | Callback when events are dropped |
+| `onDropped` | -- | Callback when events are dropped |
 
 ### Returned drain function
 
 The function returned by `pipeline(drain)` is hook-compatible and exposes:
 
-- **`drain(ctx)`** — Push a single event into the buffer
-- **`drain.flush()`** — Force-flush all buffered events (call on server shutdown)
-- **`drain.pending`** — Number of events currently buffered
+- **`drain(ctx)`** -- Push a single event into the buffer
+- **`drain.flush()`** -- Force-flush all buffered events (call on server shutdown)
+- **`drain.pending`** -- Number of events currently buffered
 
 ## API Reference
 
@@ -589,7 +783,7 @@ Initialize the logger. Required for standalone usage, automatic with Nuxt/Nitro
 
 ```typescript
 initLogger({
-  enabled: boolean       // (optional) Enable/disable all logging (default: true)
+  enabled: boolean       // Optional. Enable/disable all logging (default: true)
   env: {
     service: string      // Service name
     environment: string  // 'production' | 'development' | 'test'
@@ -680,9 +874,9 @@ In development, evlog uses a compact tree format:
 
 ```
 16:45:31.060 INFO [my-app] GET /api/checkout 200 in 234ms
-  ├─ user: id=123 plan=premium
-  ├─ cart: items=3 total=9999
-  └─ payment: id=pay_xyz method=card
+  |- user: id=123 plan=premium
+  |- cart: items=3 total=9999
+  +- payment: id=pay_xyz method=card
 ```
 
 In production (`pretty: false`), logs are emitted as JSON for machine parsing.
@@ -798,11 +992,12 @@ evlog works with any framework powered by [Nitro](https://nitro.unjs.io/):
 | Framework | Integration |
 |-----------|-------------|
 | **Nuxt** | `modules: ['evlog/nuxt']` |
-| **Analog** | `plugins: ['evlog/nitro']` |
-| **Vinxi** | `plugins: ['evlog/nitro']` |
-| **SolidStart** | `plugins: ['evlog/nitro']` |
-| **TanStack Start** | `plugins: ['evlog/nitro']` |
-| **Standalone Nitro** | `plugins: ['evlog/nitro']` |
+| **Nitro v3** | `modules: [evlog()]` with `import evlog from 'evlog/nitro/v3'` |
+| **Nitro v2** | `modules: [evlog()]` with `import evlog from 'evlog/nitro'` |
+| **Analog** | Nitro v2 module setup |
+| **Vinxi** | Nitro v2 module setup |
+| **SolidStart** | Nitro v2 module setup ([example](./examples/solidstart)) |
+| **TanStack Start** | Nitro v2 module setup |
 
 ## Agent Skills
 

package/dist/nuxt/module.d.mts

@@ -151,6 +151,12 @@ interface ModuleOptions {
     tags?: Record<string, string>; /** Request timeout in milliseconds. Default: 5000 */
     timeout?: number;
   };
+  /**
+   * How long to retain events before cleanup (used by @evlog/nuxthub).
+   * Supports "30d" (days), "24h" (hours), "60m" (minutes).
+   * @default '30d'
+   */
+  retention?: string;
 }
 declare const _default: _nuxt_schema0.NuxtModule<ModuleOptions, ModuleOptions, false>;
 //#endregion

package/dist/nuxt/module.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"module.d.mts","names":[],"sources":["../../src/nuxt/module.ts"],"mappings":";;;;UAYiB,aAAA;;;AAAjB;;;EAME,OAAA;EAKM;;;EAAN,GAAA,GAAM,OAAA,CAAQ,kBAAA;EAoEF;;;;EA9DZ,MAAA;EA+Je;;;;;;EAvJf,OAAA;EAQA;;;;;;EAAA,OAAA;EA8CY;;;;;;;;;;;;;EA/BZ,MAAA,GAAS,MAAA,SAAe,WAAA;EAkFtB;;;;;;;;;;;;;;;;EAhEF,QAAA,GAAW,cAAA;;;;;;;;;;;;EAaX,SAAA,GAAY,eAAA;;;;;;;;;;;;;EAcZ,KAAA;6BAEE,OAAA;IAEA,KAAA;IAEA,KAAA;IAEA,OAAA;IAEA,OAAA;EAAA;;;;;;;;;;;;;;;EAiBF,IAAA;2DAEE,QAAA;IAEA,WAAA;IAEA,kBAAA,GAAqB,MAAA;IAErB,OAAA,GAAU,MAAA;IAEV,OAAA;EAAA;;;;;;;;;;;;EAcF,OAAA;kCAEE,MAAA;IAEA,IAAA;IAEA,SAAA;IAEA,UAAA;IAEA,OAAA;EAAA;;;;;;;;;;;;EAcF,MAAA;qBAEE,GAAA;IAEA,WAAA;IAEA,OAAA;IAEA,IAAA,GAAO,MAAA;IAEP,OAAA;EAAA;AAAA;AAAA,cAEH,QAAA"}
+{"version":3,"file":"module.d.mts","names":[],"sources":["../../src/nuxt/module.ts"],"mappings":";;;;UAaiB,aAAA;;;AAAjB;;;EAME,OAAA;EAKM;;;EAAN,GAAA,GAAM,OAAA,CAAQ,kBAAA;EAoEF;;;;EA9DZ,MAAA;EA+Je;;;;;;EAvJf,OAAA;EAQA;;;;;;EAAA,OAAA;EA8CY;;;;;;;;;;;;;EA/BZ,MAAA,GAAS,MAAA,SAAe,WAAA;EAkFtB;;;;;;;;;;;;;;;;EAhEF,QAAA,GAAW,cAAA;EAyHZ;;;;;;;;;;;EA5GC,SAAA,GAAY,eAAA;;;;;;;;;;;;;EAcZ,KAAA;6BAEE,OAAA;IAEA,KAAA;IAEA,KAAA;IAEA,OAAA;IAEA,OAAA;EAAA;;;;;;;;;;;;;;;EAiBF,IAAA;2DAEE,QAAA;IAEA,WAAA;IAEA,kBAAA,GAAqB,MAAA;IAErB,OAAA,GAAU,MAAA;IAEV,OAAA;EAAA;;;;;;;;;;;;EAcF,OAAA;kCAEE,MAAA;IAEA,IAAA;IAEA,SAAA;IAEA,UAAA;IAEA,OAAA;EAAA;;;;;;;;;;;;EAcF,MAAA;qBAEE,GAAA;IAEA,WAAA;IAEA,OAAA;IAEA,IAAA,GAAO,MAAA;IAEP,OAAA;EAAA;;;;;;EAQF,SAAA;AAAA;AAAA,cACD,QAAA"}

package/dist/nuxt/module.mjs

@@ -1,10 +1,16 @@
 import { addImports, addPlugin, addServerHandler, addServerImports, addServerPlugin, createResolver, defineNuxtModule } from "@nuxt/kit";
 
+//#region package.json
+var name = "evlog";
+var version = "1.9.0";
+
+//#endregion
 //#region src/nuxt/module.ts
 var module_default = defineNuxtModule({
 	meta: {
-		name: "evlog",
-		configKey: "evlog",
+		name,
+		version,
+		configKey: name,
 		docs: "https://evlog.dev"
 	},
 	defaults: {},

package/dist/nuxt/module.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"module.mjs","names":[],"sources":["../../src/nuxt/module.ts"],"sourcesContent":["import {\n  addImports,\n  addPlugin,\n  addServerHandler,\n  addServerImports,\n  addServerPlugin,\n  createResolver,\n  defineNuxtModule,\n} from '@nuxt/kit'\nimport type { NitroConfig } from 'nitropack'\nimport type { EnvironmentContext, RouteConfig, SamplingConfig, TransportConfig } from '../types'\n\nexport interface ModuleOptions {\n  /**\n   * Enable or disable all logging globally.\n   * When false, all emits, tagged logs, and request logger operations become no-ops.\n   * @default true\n   */\n  enabled?: boolean\n\n  /**\n   * Environment context overrides.\n   */\n  env?: Partial<EnvironmentContext>\n\n  /**\n   * Enable pretty printing.\n   * @default true in development, false in production\n   */\n  pretty?: boolean\n\n  /**\n   * Route patterns to include in logging.\n   * Supports glob patterns like '/api/**'.\n   * If not set, all routes are logged.\n   * @example ['/api/**', '/auth/**']\n   */\n  include?: string[]\n\n  /**\n   * Route patterns to exclude from logging.\n   * Supports glob patterns like '/api/_nuxt_icon/**'.\n   * Exclusions take precedence over inclusions.\n   * @example ['/api/_nuxt_icon/**', '/health']\n   */\n  exclude?: string[]\n\n  /**\n   * Route-specific service configuration.\n   * Allows setting different service names for different routes.\n   * Patterns are matched using glob syntax.\n   *\n   * @example\n   * ```ts\n   * routes: {\n   *   '/api/foo/**': { service: 'service1' },\n   *   '/api/bar/**': { service: 'service2' }\n   * }\n   * ```\n   */\n  routes?: Record<string, RouteConfig>\n\n  /**\n   * Sampling configuration for filtering logs.\n   * Allows configuring what percentage of logs to keep per level.\n   *\n   * @example\n   * ```ts\n   * sampling: {\n   *   rates: {\n   *     info: 10,    // Keep 10% of info logs\n   *     warn: 50,    // Keep 50% of warning logs\n   *     debug: 5,    // Keep 5% of debug logs\n   *     error: 100,  // Always keep errors (default)\n   *   }\n   * }\n   * ```\n   */\n  sampling?: SamplingConfig\n\n  /**\n   * Transport configuration for sending client logs to the server.\n   *\n   * @example\n   * ```ts\n   * transport: {\n   *   enabled: true,  // Send logs to server API\n   *   endpoint: '/api/_evlog/ingest'  // Custom endpoint\n   * }\n   * ```\n   */\n  transport?: TransportConfig\n\n  /**\n   * Axiom adapter configuration.\n   * When configured, use `createAxiomDrain()` from `evlog/axiom` to send logs.\n   *\n   * @example\n   * ```ts\n   * axiom: {\n   *   dataset: 'my-app-logs',\n   *   token: process.env.AXIOM_TOKEN,\n   * }\n   * ```\n   */\n  axiom?: {\n    /** Axiom dataset name */\n    dataset: string\n    /** Axiom API token */\n    token: string\n    /** Organization ID (required for Personal Access Tokens) */\n    orgId?: string\n    /** Base URL for Axiom API. Default: https://api.axiom.co */\n    baseUrl?: string\n    /** Request timeout in milliseconds. Default: 5000 */\n    timeout?: number\n  }\n\n  /**\n   * OTLP adapter configuration.\n   * When configured, use `createOTLPDrain()` from `evlog/otlp` to send logs.\n   *\n   * @example\n   * ```ts\n   * otlp: {\n   *   endpoint: 'http://localhost:4318',\n   *   headers: {\n   *     'Authorization': `Basic ${process.env.GRAFANA_TOKEN}`,\n   *   },\n   * }\n   * ```\n   */\n  otlp?: {\n    /** OTLP HTTP endpoint (e.g., http://localhost:4318) */\n    endpoint: string\n    /** Override service name (defaults to event.service) */\n    serviceName?: string\n    /** Additional resource attributes */\n    resourceAttributes?: Record<string, string | number | boolean>\n    /** Custom headers (e.g., for authentication) */\n    headers?: Record<string, string>\n    /** Request timeout in milliseconds. Default: 5000 */\n    timeout?: number\n  }\n\n  /**\n   * PostHog adapter configuration.\n   * When configured, use `createPostHogDrain()` from `evlog/posthog` to send logs.\n   *\n   * @example\n   * ```ts\n   * posthog: {\n   *   apiKey: process.env.POSTHOG_API_KEY,\n   * }\n   * ```\n   */\n  posthog?: {\n    /** PostHog project API key */\n    apiKey: string\n    /** PostHog host URL. Default: https://us.i.posthog.com */\n    host?: string\n    /** PostHog event name. Default: evlog_wide_event */\n    eventName?: string\n    /** Override distinct_id (defaults to event.service) */\n    distinctId?: string\n    /** Request timeout in milliseconds. Default: 5000 */\n    timeout?: number\n  }\n\n  /**\n   * Sentry adapter configuration.\n   * When configured, use `createSentryDrain()` from `evlog/sentry` to send logs.\n   *\n   * @example\n   * ```ts\n   * sentry: {\n   *   dsn: process.env.SENTRY_DSN,\n   * }\n   * ```\n   */\n  sentry?: {\n    /** Sentry DSN */\n    dsn: string\n    /** Environment override (defaults to event.environment) */\n    environment?: string\n    /** Release version override (defaults to event.version) */\n    release?: string\n    /** Additional tags to attach as attributes */\n    tags?: Record<string, string>\n    /** Request timeout in milliseconds. Default: 5000 */\n    timeout?: number\n  }\n}\n\nexport default defineNuxtModule<ModuleOptions>({\n  meta: {\n    name: 'evlog',\n    configKey: 'evlog',\n    docs: 'https://evlog.dev',\n  },\n  defaults: {},\n  setup(options, nuxt) {\n    const resolver = createResolver(import.meta.url)\n\n    const transportEnabled = options.transport?.enabled ?? false\n    const transportEndpoint = options.transport?.endpoint ?? '/api/_evlog/ingest'\n\n    // Register custom error handler for proper EvlogError serialization\n    // Only set if not already configured to avoid overwriting user's custom handler\n    // @ts-expect-error nitro:config hook exists but is not in NuxtHooks type\n    nuxt.hook('nitro:config', (nitroConfig: NitroConfig) => {\n      nitroConfig.errorHandler = nitroConfig.errorHandler || resolver.resolve('../nitro/errorHandler')\n    })\n\n    nuxt.options.runtimeConfig.evlog = options\n    nuxt.options.runtimeConfig.public.evlog = {\n      enabled: options.enabled ?? true,\n      pretty: options.pretty,\n      transport: {\n        enabled: transportEnabled,\n        endpoint: transportEndpoint,\n      },\n    }\n\n    if (transportEnabled) {\n      addServerHandler({\n        route: transportEndpoint,\n        method: 'post',\n        handler: resolver.resolve('../runtime/server/routes/_evlog/ingest.post'),\n      })\n    }\n\n    addServerPlugin(resolver.resolve('../nitro/plugin'))\n\n    addPlugin({\n      src: resolver.resolve('../runtime/client/plugin'),\n      mode: 'client',\n    })\n\n    addImports([\n      {\n        name: 'log',\n        from: resolver.resolve('../runtime/client/log'),\n      },\n      {\n        name: 'setIdentity',\n        from: resolver.resolve('../runtime/client/log'),\n      },\n      {\n        name: 'clearIdentity',\n        from: resolver.resolve('../runtime/client/log'),\n      },\n      {\n        name: 'createEvlogError',\n        from: resolver.resolve('../error'),\n      },\n      {\n        name: 'parseError',\n        from: resolver.resolve('../runtime/utils/parseError'),\n      },\n    ])\n\n    addServerImports([\n      {\n        name: 'useLogger',\n        from: resolver.resolve('../runtime/server/useLogger'),\n      },\n      {\n        name: 'log',\n        from: resolver.resolve('../logger'),\n      },\n      {\n        name: 'createEvlogError',\n        from: resolver.resolve('../error'),\n      },\n    ])\n  },\n})\n"],"mappings":";;;AAkMA,qBAAe,iBAAgC;CAC7C,MAAM;EACJ,MAAM;EACN,WAAW;EACX,MAAM;EACP;CACD,UAAU,EAAE;CACZ,MAAM,SAAS,MAAM;EACnB,MAAM,WAAW,eAAe,OAAO,KAAK,IAAI;EAEhD,MAAM,mBAAmB,QAAQ,WAAW,WAAW;EACvD,MAAM,oBAAoB,QAAQ,WAAW,YAAY;AAKzD,OAAK,KAAK,iBAAiB,gBAA6B;AACtD,eAAY,eAAe,YAAY,gBAAgB,SAAS,QAAQ,wBAAwB;IAChG;AAEF,OAAK,QAAQ,cAAc,QAAQ;AACnC,OAAK,QAAQ,cAAc,OAAO,QAAQ;GACxC,SAAS,QAAQ,WAAW;GAC5B,QAAQ,QAAQ;GAChB,WAAW;IACT,SAAS;IACT,UAAU;IACX;GACF;AAED,MAAI,iBACF,kBAAiB;GACf,OAAO;GACP,QAAQ;GACR,SAAS,SAAS,QAAQ,8CAA8C;GACzE,CAAC;AAGJ,kBAAgB,SAAS,QAAQ,kBAAkB,CAAC;AAEpD,YAAU;GACR,KAAK,SAAS,QAAQ,2BAA2B;GACjD,MAAM;GACP,CAAC;AAEF,aAAW;GACT;IACE,MAAM;IACN,MAAM,SAAS,QAAQ,wBAAwB;IAChD;GACD;IACE,MAAM;IACN,MAAM,SAAS,QAAQ,wBAAwB;IAChD;GACD;IACE,MAAM;IACN,MAAM,SAAS,QAAQ,wBAAwB;IAChD;GACD;IACE,MAAM;IACN,MAAM,SAAS,QAAQ,WAAW;IACnC;GACD;IACE,MAAM;IACN,MAAM,SAAS,QAAQ,8BAA8B;IACtD;GACF,CAAC;AAEF,mBAAiB;GACf;IACE,MAAM;IACN,MAAM,SAAS,QAAQ,8BAA8B;IACtD;GACD;IACE,MAAM;IACN,MAAM,SAAS,QAAQ,YAAY;IACpC;GACD;IACE,MAAM;IACN,MAAM,SAAS,QAAQ,WAAW;IACnC;GACF,CAAC;;CAEL,CAAC"}
+{"version":3,"file":"module.mjs","names":[],"sources":["../../package.json","../../src/nuxt/module.ts"],"sourcesContent":["","import {\n  addImports,\n  addPlugin,\n  addServerHandler,\n  addServerImports,\n  addServerPlugin,\n  createResolver,\n  defineNuxtModule,\n} from '@nuxt/kit'\nimport type { NitroConfig } from 'nitropack'\nimport type { EnvironmentContext, RouteConfig, SamplingConfig, TransportConfig } from '../types'\nimport { name, version } from '../../package.json'\n\nexport interface ModuleOptions {\n  /**\n   * Enable or disable all logging globally.\n   * When false, all emits, tagged logs, and request logger operations become no-ops.\n   * @default true\n   */\n  enabled?: boolean\n\n  /**\n   * Environment context overrides.\n   */\n  env?: Partial<EnvironmentContext>\n\n  /**\n   * Enable pretty printing.\n   * @default true in development, false in production\n   */\n  pretty?: boolean\n\n  /**\n   * Route patterns to include in logging.\n   * Supports glob patterns like '/api/**'.\n   * If not set, all routes are logged.\n   * @example ['/api/**', '/auth/**']\n   */\n  include?: string[]\n\n  /**\n   * Route patterns to exclude from logging.\n   * Supports glob patterns like '/api/_nuxt_icon/**'.\n   * Exclusions take precedence over inclusions.\n   * @example ['/api/_nuxt_icon/**', '/health']\n   */\n  exclude?: string[]\n\n  /**\n   * Route-specific service configuration.\n   * Allows setting different service names for different routes.\n   * Patterns are matched using glob syntax.\n   *\n   * @example\n   * ```ts\n   * routes: {\n   *   '/api/foo/**': { service: 'service1' },\n   *   '/api/bar/**': { service: 'service2' }\n   * }\n   * ```\n   */\n  routes?: Record<string, RouteConfig>\n\n  /**\n   * Sampling configuration for filtering logs.\n   * Allows configuring what percentage of logs to keep per level.\n   *\n   * @example\n   * ```ts\n   * sampling: {\n   *   rates: {\n   *     info: 10,    // Keep 10% of info logs\n   *     warn: 50,    // Keep 50% of warning logs\n   *     debug: 5,    // Keep 5% of debug logs\n   *     error: 100,  // Always keep errors (default)\n   *   }\n   * }\n   * ```\n   */\n  sampling?: SamplingConfig\n\n  /**\n   * Transport configuration for sending client logs to the server.\n   *\n   * @example\n   * ```ts\n   * transport: {\n   *   enabled: true,  // Send logs to server API\n   *   endpoint: '/api/_evlog/ingest'  // Custom endpoint\n   * }\n   * ```\n   */\n  transport?: TransportConfig\n\n  /**\n   * Axiom adapter configuration.\n   * When configured, use `createAxiomDrain()` from `evlog/axiom` to send logs.\n   *\n   * @example\n   * ```ts\n   * axiom: {\n   *   dataset: 'my-app-logs',\n   *   token: process.env.AXIOM_TOKEN,\n   * }\n   * ```\n   */\n  axiom?: {\n    /** Axiom dataset name */\n    dataset: string\n    /** Axiom API token */\n    token: string\n    /** Organization ID (required for Personal Access Tokens) */\n    orgId?: string\n    /** Base URL for Axiom API. Default: https://api.axiom.co */\n    baseUrl?: string\n    /** Request timeout in milliseconds. Default: 5000 */\n    timeout?: number\n  }\n\n  /**\n   * OTLP adapter configuration.\n   * When configured, use `createOTLPDrain()` from `evlog/otlp` to send logs.\n   *\n   * @example\n   * ```ts\n   * otlp: {\n   *   endpoint: 'http://localhost:4318',\n   *   headers: {\n   *     'Authorization': `Basic ${process.env.GRAFANA_TOKEN}`,\n   *   },\n   * }\n   * ```\n   */\n  otlp?: {\n    /** OTLP HTTP endpoint (e.g., http://localhost:4318) */\n    endpoint: string\n    /** Override service name (defaults to event.service) */\n    serviceName?: string\n    /** Additional resource attributes */\n    resourceAttributes?: Record<string, string | number | boolean>\n    /** Custom headers (e.g., for authentication) */\n    headers?: Record<string, string>\n    /** Request timeout in milliseconds. Default: 5000 */\n    timeout?: number\n  }\n\n  /**\n   * PostHog adapter configuration.\n   * When configured, use `createPostHogDrain()` from `evlog/posthog` to send logs.\n   *\n   * @example\n   * ```ts\n   * posthog: {\n   *   apiKey: process.env.POSTHOG_API_KEY,\n   * }\n   * ```\n   */\n  posthog?: {\n    /** PostHog project API key */\n    apiKey: string\n    /** PostHog host URL. Default: https://us.i.posthog.com */\n    host?: string\n    /** PostHog event name. Default: evlog_wide_event */\n    eventName?: string\n    /** Override distinct_id (defaults to event.service) */\n    distinctId?: string\n    /** Request timeout in milliseconds. Default: 5000 */\n    timeout?: number\n  }\n\n  /**\n   * Sentry adapter configuration.\n   * When configured, use `createSentryDrain()` from `evlog/sentry` to send logs.\n   *\n   * @example\n   * ```ts\n   * sentry: {\n   *   dsn: process.env.SENTRY_DSN,\n   * }\n   * ```\n   */\n  sentry?: {\n    /** Sentry DSN */\n    dsn: string\n    /** Environment override (defaults to event.environment) */\n    environment?: string\n    /** Release version override (defaults to event.version) */\n    release?: string\n    /** Additional tags to attach as attributes */\n    tags?: Record<string, string>\n    /** Request timeout in milliseconds. Default: 5000 */\n    timeout?: number\n  }\n\n  /**\n   * How long to retain events before cleanup (used by @evlog/nuxthub).\n   * Supports \"30d\" (days), \"24h\" (hours), \"60m\" (minutes).\n   * @default '30d'\n   */\n  retention?: string\n}\n\nexport default defineNuxtModule<ModuleOptions>({\n  meta: {\n    name,\n    version,\n    configKey: name,\n    docs: 'https://evlog.dev',\n  },\n  defaults: {},\n  setup(options, nuxt) {\n    const resolver = createResolver(import.meta.url)\n\n    const transportEnabled = options.transport?.enabled ?? false\n    const transportEndpoint = options.transport?.endpoint ?? '/api/_evlog/ingest'\n\n    // Register custom error handler for proper EvlogError serialization\n    // Only set if not already configured to avoid overwriting user's custom handler\n    // @ts-expect-error nitro:config hook exists but is not in NuxtHooks type\n    nuxt.hook('nitro:config', (nitroConfig: NitroConfig) => {\n      nitroConfig.errorHandler = nitroConfig.errorHandler || resolver.resolve('../nitro/errorHandler')\n    })\n\n    nuxt.options.runtimeConfig.evlog = options\n    nuxt.options.runtimeConfig.public.evlog = {\n      enabled: options.enabled ?? true,\n      pretty: options.pretty,\n      transport: {\n        enabled: transportEnabled,\n        endpoint: transportEndpoint,\n      },\n    }\n\n    if (transportEnabled) {\n      addServerHandler({\n        route: transportEndpoint,\n        method: 'post',\n        handler: resolver.resolve('../runtime/server/routes/_evlog/ingest.post'),\n      })\n    }\n\n    addServerPlugin(resolver.resolve('../nitro/plugin'))\n\n    addPlugin({\n      src: resolver.resolve('../runtime/client/plugin'),\n      mode: 'client',\n    })\n\n    addImports([\n      {\n        name: 'log',\n        from: resolver.resolve('../runtime/client/log'),\n      },\n      {\n        name: 'setIdentity',\n        from: resolver.resolve('../runtime/client/log'),\n      },\n      {\n        name: 'clearIdentity',\n        from: resolver.resolve('../runtime/client/log'),\n      },\n      {\n        name: 'createEvlogError',\n        from: resolver.resolve('../error'),\n      },\n      {\n        name: 'parseError',\n        from: resolver.resolve('../runtime/utils/parseError'),\n      },\n    ])\n\n    addServerImports([\n      {\n        name: 'useLogger',\n        from: resolver.resolve('../runtime/server/useLogger'),\n      },\n      {\n        name: 'log',\n        from: resolver.resolve('../logger'),\n      },\n      {\n        name: 'createEvlogError',\n        from: resolver.resolve('../error'),\n      },\n    ])\n  },\n})\n"],"mappings":";;;;;;;;AC0MA,qBAAe,iBAAgC;CAC7C,MAAM;EACJ;EACA;EACA,WAAW;EACX,MAAM;EACP;CACD,UAAU,EAAE;CACZ,MAAM,SAAS,MAAM;EACnB,MAAM,WAAW,eAAe,OAAO,KAAK,IAAI;EAEhD,MAAM,mBAAmB,QAAQ,WAAW,WAAW;EACvD,MAAM,oBAAoB,QAAQ,WAAW,YAAY;AAKzD,OAAK,KAAK,iBAAiB,gBAA6B;AACtD,eAAY,eAAe,YAAY,gBAAgB,SAAS,QAAQ,wBAAwB;IAChG;AAEF,OAAK,QAAQ,cAAc,QAAQ;AACnC,OAAK,QAAQ,cAAc,OAAO,QAAQ;GACxC,SAAS,QAAQ,WAAW;GAC5B,QAAQ,QAAQ;GAChB,WAAW;IACT,SAAS;IACT,UAAU;IACX;GACF;AAED,MAAI,iBACF,kBAAiB;GACf,OAAO;GACP,QAAQ;GACR,SAAS,SAAS,QAAQ,8CAA8C;GACzE,CAAC;AAGJ,kBAAgB,SAAS,QAAQ,kBAAkB,CAAC;AAEpD,YAAU;GACR,KAAK,SAAS,QAAQ,2BAA2B;GACjD,MAAM;GACP,CAAC;AAEF,aAAW;GACT;IACE,MAAM;IACN,MAAM,SAAS,QAAQ,wBAAwB;IAChD;GACD;IACE,MAAM;IACN,MAAM,SAAS,QAAQ,wBAAwB;IAChD;GACD;IACE,MAAM;IACN,MAAM,SAAS,QAAQ,wBAAwB;IAChD;GACD;IACE,MAAM;IACN,MAAM,SAAS,QAAQ,WAAW;IACnC;GACD;IACE,MAAM;IACN,MAAM,SAAS,QAAQ,8BAA8B;IACtD;GACF,CAAC;AAEF,mBAAiB;GACf;IACE,MAAM;IACN,MAAM,SAAS,QAAQ,8BAA8B;IACtD;GACD;IACE,MAAM;IACN,MAAM,SAAS,QAAQ,YAAY;IACpC;GACD;IACE,MAAM;IACN,MAAM,SAAS,QAAQ,WAAW;IACnC;GACF,CAAC;;CAEL,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "evlog",
-  "version": "1.8.0",
+  "version": "1.9.0",
   "description": "Wide event logging library with structured error handling. Inspired by LoggingSucks.",
   "author": "HugoRCD <contact@hrcd.fr>",
   "homepage": "https://evlog.dev",
@@ -130,7 +130,6 @@
     "build": "tsdown",
     "dev": "tsdown --watch",
     "dev:prepare": "tsdown",
-    "release": "bun run lint && bun run test && bun run build && changelogen --release && npm publish && git push --follow-tags",
     "lint": "eslint .",
     "lint:fix": "eslint . --fix",
     "test": "vitest run",