evlog 2.17.0 → 2.19.0

package/dist/nuxt/module.d.mts

@@ -1,4 +1,4 @@
-import { K as LogLevel, R as EnvironmentContext, Y as RedactConfig, nt as SamplingConfig, st as TransportConfig, tt as RouteConfig } from "../audit-CC8nfazi.mjs";
+import { $ as RedactConfig, H as EnvironmentContext, X as LogLevel, at as RouteConfig, dt as TransportConfig, ot as SamplingConfig, pt as DevTerminalInput } from "../audit-BUAajsPU.mjs";
 import { StreamServerOptions } from "../stream.mjs";
 import * as _$_nuxt_schema0 from "@nuxt/schema";
 
@@ -6,8 +6,12 @@ import * as _$_nuxt_schema0 from "@nuxt/schema";
 interface ModuleAxiomBaseConfig {
   /** Axiom dataset name */
   dataset: string;
-  /** Axiom API token */
-  token: string;
+  /** Axiom API token (evlog field `apiKey`) */
+  apiKey?: string;
+  /**
+   * @deprecated Renamed to `apiKey`. Will be removed in the next major version.
+   */
+  token?: string;
   /** Organization ID (required for Personal Access Tokens) */
   orgId?: string;
   /** Request timeout in milliseconds. Default: 5000 */
@@ -53,6 +57,11 @@ interface ModuleOptions {
    * @default true in development, false in production
    */
   pretty?: boolean;
+  /**
+   * Dev terminal output: preset or explicit overlay + pretty-error settings.
+   * @default 'evlog' when pretty in development
+   */
+  dev?: DevTerminalInput;
   /**
    * Suppress built-in console output.
    * When true, events are still built, sampled, and passed to drains,
@@ -159,7 +168,7 @@ interface ModuleOptions {
    * ```ts
    * axiom: {
    *   dataset: 'my-app-logs',
-   *   token: process.env.AXIOM_TOKEN,
+   *   apiKey: process.env.AXIOM_API_KEY,
    * }
    * ```
    */

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

@@ -1 +1 @@
-{"version":3,"file":"module.d.mts","names":[],"sources":["../../src/nuxt/module.ts"],"mappings":";;;;;UAgBU,qBAAA;;EAER,OAAA;;EAEA,KAAA;EAJ6B;EAM7B,KAAA;EAN6B;EAQ7B,OAAA;AAAA;AAAA,UAGQ,qBAAA;EAHR;;;AAAO;;EASP,OAAA;EAAA;EAEA,OAAA;AAAA;AAAA,UAGQ,yBAAA;;EAER,OAAA;EAEO;EAAP,OAAA;AAAA;AAAA,KAGG,iBAAA,GAAoB,qBAAA,IAAyB,qBAAA,GAAwB,yBAAA;AAAA,UAEzD,aAAA;EAFiC;;;;;EAQhD,OAAA;EARwE;;;EAaxE,GAAA,GAAM,OAAA,CAAQ,kBAAA;EAXc;;;;;;EAmB5B,OAAA;EAuEW;;;;EAjEX,MAAA;EAgJY;;;;;;;EAvIZ,MAAA;EAvBM;;;;;;EA+BN,OAAA;EAuBA;;;;;;EAfA,OAAA;EAsDA;;;;;;;;;;;;;EAvCA,MAAA,GAAS,MAAA,SAAe,WAAA;EAyHxB;;;;;;;;;;;;;;;;EAvGA,QAAA,GAAW,cAAA;EA+KF;;AACV;;;EAzKC,QAAA,GAAW,QAAA;;;;;;;;;;;;;EAcX,SAAA,GAAY,eAAA;;;;;;;;;;;;;;;;;;;;;;;;;;EA2BZ,MAAA,aA3B2B,mBAAA;;;;;;;;;;;;;EAyC3B,KAAA,GAAQ,iBAAA;;;;;;;;;;;;;;;EAgBR,IAAA;2DAEE,QAAA;IAEA,WAAA;IAEA,kBAAA,GAAqB,MAAA;IAErB,OAAA,GAAU,MAAA;IAEV,OAAA;EAAA;;;;;;;;;;;;;EAeF,OAAA;kCAEE,MAAA;IAEA,IAAA;IAEA,OAAA;EAAA;;;;;;;;;;;;EAcF,MAAA;qBAEE,GAAA;IAEA,WAAA;IAEA,OAAA;IAEA,IAAA,GAAO,MAAA;IAEP,OAAA;EAAA;;;;;;;;;;;;;;;;;;;EAqBF,MAAA,aAAmB,YAAA;;;;;EAMnB,KAAA,GAAQ,QAAA;;;;;;;EAQR,cAAA;;;;;;EAOA,SAAA;AAAA;AAAA,cACD,QAAA"}
+{"version":3,"file":"module.d.mts","names":[],"sources":["../../src/nuxt/module.ts"],"mappings":";;;;;UAkBU,qBAAA;;EAER,OAAA;EAFQ;EAIR,MAAA;;;;EAIA,KAAA;EAAA;EAEA,KAAA;EAEA;EAAA,OAAA;AAAA;AAAA,UAGQ,qBAAA;EAAqB;;;;AAQtB;EAFP,OAAA;;EAEA,OAAA;AAAA;AAAA,UAGQ,yBAAA;EAOY;EALpB,OAAA;EAKuB;EAHvB,OAAA;AAAA;AAAA,KAGG,iBAAA,GAAoB,qBAAA,IAAyB,qBAAA,GAAwB,yBAAA;AAAA,UAEzD,aAAA;EAFQ;;;;;EAQvB,OAAA;EAN4B;;;EAW5B,GAAA,GAAM,OAAA,CAAQ,kBAAA;EAoBR;;;;;;EAZN,OAAA;EAoIQ;;;;EA9HR,MAAA;EAgOQ;;;;EA1NR,GAAA,GAAM,gBAAA;EApBA;;;;;;;EA6BN,MAAA;EAgBA;;;;;;EARA,OAAA;EAgDW;;;;;;EAxCX,OAAA;EA+GA;;;;;;;;;;;;;EAhGA,MAAA,GAAS,MAAA,SAAe,WAAA;EAiJtB;;;;;;;;;;;;;AAiDH;;;EAhLC,QAAA,GAAW,cAAA;;;;;;EAOX,QAAA,GAAW,QAAA;;;;;;;;;;;;;EAcX,SAAA,GAAY,eAAA;;;;;;;;;;;;;;;;;;;;;;;;;;EA2BZ,MAAA,aA3B2B,mBAAA;;;;;;;;;;;;;EAyC3B,KAAA,GAAQ,iBAAA;;;;;;;;;;;;;;;EAgBR,IAAA;2DAEE,QAAA;IAEA,WAAA;IAEA,kBAAA,GAAqB,MAAA;IAErB,OAAA,GAAU,MAAA;IAEV,OAAA;EAAA;;;;;;;;;;;;;EAeF,OAAA;kCAEE,MAAA;IAEA,IAAA;IAEA,OAAA;EAAA;;;;;;;;;;;;EAcF,MAAA;qBAEE,GAAA;IAEA,WAAA;IAEA,OAAA;IAEA,IAAA,GAAO,MAAA;IAEP,OAAA;EAAA;;;;;;;;;;;;;;;;;;;EAqBF,MAAA,aAAmB,YAAA;;;;;EAMnB,KAAA,GAAQ,QAAA;;;;;;;EAQR,cAAA;;;;;;EAOA,SAAA;AAAA;AAAA,cACD,QAAA"}

package/dist/nuxt/module.mjs

@@ -1,5 +1,6 @@
-import { n as createStripPlugin, t as createSourceLocationPlugin } from "../source-location-Dco0cRTz.mjs";
-import { n as version, t as name } from "../package-v_MmOZeA.mjs";
+import { r as prependNitroErrorHandler } from "../nitro-ClRZLD1g.mjs";
+import { n as createStripPlugin, t as createSourceLocationPlugin } from "../source-location-xkDGiERl.mjs";
+import { n as version, t as name } from "../package-CUhII9DA.mjs";
 import { addImports, addPlugin, addServerHandler, addServerImports, addServerPlugin, addVitePlugin, createResolver, defineNuxtModule } from "@nuxt/kit";
 //#region src/nuxt/module.ts
 var module_default = defineNuxtModule({
@@ -21,9 +22,15 @@ var module_default = defineNuxtModule({
 		options.stream = normalizedStream;
 		nuxt.options.runtimeConfig.evlog = options;
 		nuxt.hook("nitro:config", (nitroConfig) => {
-			nitroConfig.errorHandler = nitroConfig.errorHandler || resolver.resolve("../nitro/errorHandler");
+			const evlogHandler = resolver.resolve("../nitro/errorHandler").replace(/\\/g, "/");
+			nitroConfig.errorHandler = prependNitroErrorHandler(nitroConfig.errorHandler, evlogHandler);
 			const evlogForNitro = nuxt.options.runtimeConfig.evlog ?? options;
-			if (evlogForNitro !== void 0 && typeof evlogForNitro === "object") process.env.__EVLOG_CONFIG = JSON.stringify(evlogForNitro);
+			if (evlogForNitro !== void 0 && typeof evlogForNitro === "object") {
+				const serialized = JSON.stringify(evlogForNitro);
+				nitroConfig.replace = nitroConfig.replace || {};
+				nitroConfig.replace.__EVLOG_CONFIG__ = serialized;
+				process.env.__EVLOG_CONFIG = serialized;
+			}
 		});
 		nuxt.options.runtimeConfig.public.evlog = {
 			enabled: options.enabled ?? true,

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  addVitePlugin,\n  createResolver,\n  defineNuxtModule,\n} from '@nuxt/kit'\nimport type { NitroConfig } from 'nitropack'\nimport type { EnvironmentContext, LogLevel, RedactConfig, RouteConfig, SamplingConfig, TransportConfig } from '../types'\nimport { createStripPlugin } from '../vite/strip'\nimport { createSourceLocationPlugin } from '../vite/source-location'\nimport { name, version } from '../../package.json'\n\ninterface ModuleAxiomBaseConfig {\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  /** Request timeout in milliseconds. Default: 5000 */\n  timeout?: number\n}\n\ninterface ModuleAxiomEdgeConfig {\n  /**\n   * Edge URL for Axiom ingest/query endpoints.\n   * If no path is provided, uses /v1/ingest/{dataset}.\n   * If a custom path is provided, it is used as-is (trailing slash trimmed).\n   */\n  edgeUrl: string\n  /** Mutually exclusive with edgeUrl. */\n  baseUrl?: never\n}\n\ninterface ModuleAxiomEndpointConfig {\n  /** Base URL for Axiom API. Uses /v1/datasets/{dataset}/ingest. */\n  baseUrl?: string\n  /** Mutually exclusive with baseUrl. */\n  edgeUrl?: never\n}\n\ntype ModuleAxiomConfig = ModuleAxiomBaseConfig & (ModuleAxiomEdgeConfig | ModuleAxiomEndpointConfig)\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 or disable browser console output.\n   * When false, client-side logs are suppressed in the browser DevTools console\n   * but still sent to the server via transport (if enabled).\n   * @default true\n   */\n  console?: boolean\n\n  /**\n   * Enable pretty printing.\n   * @default true in development, false in production\n   */\n  pretty?: boolean\n\n  /**\n   * Suppress built-in console output.\n   * When true, events are still built, sampled, and passed to drains,\n   * but nothing is written to console. Use when drains own the output\n   * channel (e.g., stdout-based platforms like GCP Cloud Run, AWS Lambda).\n   * @default false\n   */\n  silent?: 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   * Minimum severity for the global `log` API on server and client (not request wide events).\n   * Order: debug < info < warn < error.\n   * @default 'debug'\n   */\n  minLevel?: LogLevel\n\n  /**\n   * Transport configuration for sending client logs to the server.\n   *\n   * @example\n   * ```ts\n   * transport: {\n   *   enabled: true, // send client logs to server via API endpoint\n   *   endpoint: '/api/_evlog/ingest', // default endpoint (or custom endpoint)\n   *   credentials: 'include', // optional: cross-origin ingest\n   * }\n   * ```\n   */\n  transport?: TransportConfig\n\n  /**\n   * Live stream of wide events, exposed by a small local HTTP server on\n   * an ephemeral port. Any consumer (browser tab, CLI, devtool) can\n   * subscribe via Server-Sent Events. The URL is printed at startup and\n   * written to `.evlog/stream.url`.\n   *\n   * Strict opt-in — nothing starts unless this is set.\n   *\n   * - `true` — enable with defaults\n   * - `false` — off (same as omitting)\n   * - `StreamServerOptions` — full config (port, host, token, ...)\n   * - `undefined` (default) — off\n   *\n   * Local-only: binds to `127.0.0.1` and does not work on serverless\n   * platforms (each invocation is isolated).\n   *\n   * @example\n   * ```ts\n   * // Enable with defaults\n   * evlog: { stream: true }\n   *\n   * // Custom port + auth token\n   * evlog: { stream: { port: 4317, token: process.env.EVLOG_STREAM_TOKEN } }\n   * ```\n   */\n  stream?: boolean | import('../stream').StreamServerOptions\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?: ModuleAxiomConfig\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   * via PostHog Logs (OTLP).\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    /** 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   * Auto-redaction configuration for PII protection.\n   * `true` enables all built-in PII patterns (email, credit card, IPv4, phone, SSN).\n   * Pass an object for fine-grained control.\n   *\n   * @example\n   * ```ts\n   * // Enable all built-in PII patterns\n   * evlog: { redact: true }\n   *\n   * // Add custom paths on top of built-ins\n   * evlog: {\n   *   redact: {\n   *     paths: ['user.password', 'headers.authorization'],\n   *   }\n   * }\n   * ```\n   */\n  redact?: boolean | RedactConfig\n\n  /**\n   * Log levels to strip from production builds. Set to [] to disable.\n   * @default ['debug']\n   */\n  strip?: LogLevel[]\n\n  /**\n   * Inject source file:line into log calls.\n   * When true, active in both dev and prod.\n   * When 'dev', active only in development.\n   * @default 'dev'\n   */\n  sourceLocation?: boolean | 'dev'\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    const transportCredentials = options.transport?.credentials ?? 'same-origin'\n\n    // Normalize `evlog.stream` into a single canonical shape so the Nitro\n    // plugin (which reads runtimeConfig.evlog at server boot) sees a\n    // consistent value.\n    //\n    // The stream is exposed by a separate mini HTTP server on its own\n    // ephemeral port (see `evlog/stream` → `startStreamServer`). It does\n    // NOT register a route in the user's app.\n    //\n    // Strict opt-in: nothing starts unless the user explicitly asks for it.\n    //   - `stream === true`        → enabled with defaults\n    //   - `stream === false`       → off (alias for undefined)\n    //   - `stream: { ... }`        → enabled with user options\n    //   - `stream === undefined`   → off\n    const streamRaw = options.stream\n    const normalizedStream\n      = streamRaw === true\n        ? true\n        : streamRaw && typeof streamRaw === 'object'\n          ? streamRaw\n          : false\n    const streamEnabled = normalizedStream !== false\n    options.stream = normalizedStream\n\n    nuxt.options.runtimeConfig.evlog = options\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    // Mirror standalone Nitro modules: serialize evlog options into __EVLOG_CONFIG so\n    // resolveEvlogConfigForNitroPlugin() picks them up in dev (Nitro worker threads\n    // often cannot resolve useRuntimeConfig().evlog via dynamic import reliably).\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      const evlogForNitro = nuxt.options.runtimeConfig.evlog ?? options\n      if (evlogForNitro !== undefined && typeof evlogForNitro === 'object') {\n        process.env.__EVLOG_CONFIG = JSON.stringify(evlogForNitro)\n      }\n    })\n    nuxt.options.runtimeConfig.public.evlog = {\n      enabled: options.enabled ?? true,\n      console: options.console,\n      pretty: options.pretty,\n      minLevel: options.minLevel,\n      transport: {\n        enabled: transportEnabled,\n        endpoint: transportEndpoint,\n        credentials: transportCredentials,\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    if (streamEnabled) {\n      // The stream itself is served by an out-of-band HTTP mini-server\n      // started in the Nitro plugin — see startStreamServer() in\n      // packages/evlog/src/stream.ts. Here we only register a discovery\n      // route so a browser tab on the user's app can find the mini-server\n      // URL without having to read `.evlog/stream.url` directly.\n      addServerHandler({\n        route: '/api/_evlog/stream-info',\n        method: 'get',\n        handler: resolver.resolve('../runtime/server/routes/_evlog/stream-info.get'),\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: 'setMinLevel',\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    const stripLevels = options.strip ?? ['debug']\n    if (stripLevels.length > 0) {\n      addVitePlugin(createStripPlugin(stripLevels))\n    }\n\n    const srcLoc = options.sourceLocation ?? 'dev'\n    if (srcLoc === true || (srcLoc === 'dev' && nuxt.options.dev)) {\n      addVitePlugin(createSourceLocationPlugin(true))\n    }\n  },\n})\n"],"mappings":";;;;AAoTA,IAAA,iBAAe,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;EACzD,MAAM,uBAAuB,QAAQ,WAAW,eAAe;EAe/D,MAAM,YAAY,QAAQ;EAC1B,MAAM,mBACF,cAAc,OACZ,OACA,aAAa,OAAO,cAAc,WAChC,YACA;EACR,MAAM,gBAAgB,qBAAqB;AAC3C,UAAQ,SAAS;AAEjB,OAAK,QAAQ,cAAc,QAAQ;AAQnC,OAAK,KAAK,iBAAiB,gBAA6B;AACtD,eAAY,eAAe,YAAY,gBAAgB,SAAS,QAAQ,wBAAwB;GAEhG,MAAM,gBAAgB,KAAK,QAAQ,cAAc,SAAS;AAC1D,OAAI,kBAAkB,KAAA,KAAa,OAAO,kBAAkB,SAC1D,SAAQ,IAAI,iBAAiB,KAAK,UAAU,cAAc;IAE5D;AACF,OAAK,QAAQ,cAAc,OAAO,QAAQ;GACxC,SAAS,QAAQ,WAAW;GAC5B,SAAS,QAAQ;GACjB,QAAQ,QAAQ;GAChB,UAAU,QAAQ;GAClB,WAAW;IACT,SAAS;IACT,UAAU;IACV,aAAa;IACd;GACF;AAED,MAAI,iBACF,kBAAiB;GACf,OAAO;GACP,QAAQ;GACR,SAAS,SAAS,QAAQ,8CAA8C;GACzE,CAAC;AAGJ,MAAI,cAMF,kBAAiB;GACf,OAAO;GACP,QAAQ;GACR,SAAS,SAAS,QAAQ,kDAAkD;GAC7E,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,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;EAEF,MAAM,cAAc,QAAQ,SAAS,CAAC,QAAQ;AAC9C,MAAI,YAAY,SAAS,EACvB,eAAc,kBAAkB,YAAY,CAAC;EAG/C,MAAM,SAAS,QAAQ,kBAAkB;AACzC,MAAI,WAAW,QAAS,WAAW,SAAS,KAAK,QAAQ,IACvD,eAAc,2BAA2B,KAAK,CAAC;;CAGpD,CAAC"}
+{"version":3,"file":"module.mjs","names":[],"sources":["../../src/nuxt/module.ts"],"sourcesContent":["import {\n  addImports,\n  addPlugin,\n  addServerHandler,\n  addServerImports,\n  addServerPlugin,\n  addVitePlugin,\n  createResolver,\n  defineNuxtModule,\n} from '@nuxt/kit'\nimport type { NitroConfig } from 'nitropack'\nimport type { EnvironmentContext, LogLevel, RedactConfig, RouteConfig, SamplingConfig, TransportConfig } from '../types'\nimport type { DevTerminalInput } from '../shared/dev-terminal'\nimport { prependNitroErrorHandler } from '../nitro'\nimport { createStripPlugin } from '../vite/strip'\nimport { createSourceLocationPlugin } from '../vite/source-location'\nimport { name, version } from '../../package.json'\n\ninterface ModuleAxiomBaseConfig {\n  /** Axiom dataset name */\n  dataset: string\n  /** Axiom API token (evlog field `apiKey`) */\n  apiKey?: string\n  /**\n   * @deprecated Renamed to `apiKey`. Will be removed in the next major version.\n   */\n  token?: string\n  /** Organization ID (required for Personal Access Tokens) */\n  orgId?: string\n  /** Request timeout in milliseconds. Default: 5000 */\n  timeout?: number\n}\n\ninterface ModuleAxiomEdgeConfig {\n  /**\n   * Edge URL for Axiom ingest/query endpoints.\n   * If no path is provided, uses /v1/ingest/{dataset}.\n   * If a custom path is provided, it is used as-is (trailing slash trimmed).\n   */\n  edgeUrl: string\n  /** Mutually exclusive with edgeUrl. */\n  baseUrl?: never\n}\n\ninterface ModuleAxiomEndpointConfig {\n  /** Base URL for Axiom API. Uses /v1/datasets/{dataset}/ingest. */\n  baseUrl?: string\n  /** Mutually exclusive with baseUrl. */\n  edgeUrl?: never\n}\n\ntype ModuleAxiomConfig = ModuleAxiomBaseConfig & (ModuleAxiomEdgeConfig | ModuleAxiomEndpointConfig)\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 or disable browser console output.\n   * When false, client-side logs are suppressed in the browser DevTools console\n   * but still sent to the server via transport (if enabled).\n   * @default true\n   */\n  console?: boolean\n\n  /**\n   * Enable pretty printing.\n   * @default true in development, false in production\n   */\n  pretty?: boolean\n\n  /**\n   * Dev terminal output: preset or explicit overlay + pretty-error settings.\n   * @default 'evlog' when pretty in development\n   */\n  dev?: DevTerminalInput\n\n  /**\n   * Suppress built-in console output.\n   * When true, events are still built, sampled, and passed to drains,\n   * but nothing is written to console. Use when drains own the output\n   * channel (e.g., stdout-based platforms like GCP Cloud Run, AWS Lambda).\n   * @default false\n   */\n  silent?: 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   * Minimum severity for the global `log` API on server and client (not request wide events).\n   * Order: debug < info < warn < error.\n   * @default 'debug'\n   */\n  minLevel?: LogLevel\n\n  /**\n   * Transport configuration for sending client logs to the server.\n   *\n   * @example\n   * ```ts\n   * transport: {\n   *   enabled: true, // send client logs to server via API endpoint\n   *   endpoint: '/api/_evlog/ingest', // default endpoint (or custom endpoint)\n   *   credentials: 'include', // optional: cross-origin ingest\n   * }\n   * ```\n   */\n  transport?: TransportConfig\n\n  /**\n   * Live stream of wide events, exposed by a small local HTTP server on\n   * an ephemeral port. Any consumer (browser tab, CLI, devtool) can\n   * subscribe via Server-Sent Events. The URL is printed at startup and\n   * written to `.evlog/stream.url`.\n   *\n   * Strict opt-in — nothing starts unless this is set.\n   *\n   * - `true` — enable with defaults\n   * - `false` — off (same as omitting)\n   * - `StreamServerOptions` — full config (port, host, token, ...)\n   * - `undefined` (default) — off\n   *\n   * Local-only: binds to `127.0.0.1` and does not work on serverless\n   * platforms (each invocation is isolated).\n   *\n   * @example\n   * ```ts\n   * // Enable with defaults\n   * evlog: { stream: true }\n   *\n   * // Custom port + auth token\n   * evlog: { stream: { port: 4317, token: process.env.EVLOG_STREAM_TOKEN } }\n   * ```\n   */\n  stream?: boolean | import('../stream').StreamServerOptions\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   *   apiKey: process.env.AXIOM_API_KEY,\n   * }\n   * ```\n   */\n  axiom?: ModuleAxiomConfig\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   * via PostHog Logs (OTLP).\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    /** 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   * Auto-redaction configuration for PII protection.\n   * `true` enables all built-in PII patterns (email, credit card, IPv4, phone, SSN).\n   * Pass an object for fine-grained control.\n   *\n   * @example\n   * ```ts\n   * // Enable all built-in PII patterns\n   * evlog: { redact: true }\n   *\n   * // Add custom paths on top of built-ins\n   * evlog: {\n   *   redact: {\n   *     paths: ['user.password', 'headers.authorization'],\n   *   }\n   * }\n   * ```\n   */\n  redact?: boolean | RedactConfig\n\n  /**\n   * Log levels to strip from production builds. Set to [] to disable.\n   * @default ['debug']\n   */\n  strip?: LogLevel[]\n\n  /**\n   * Inject source file:line into log calls.\n   * When true, active in both dev and prod.\n   * When 'dev', active only in development.\n   * @default 'dev'\n   */\n  sourceLocation?: boolean | 'dev'\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    const transportCredentials = options.transport?.credentials ?? 'same-origin'\n\n    // Normalize `evlog.stream` into a single canonical shape so the Nitro\n    // plugin (which reads runtimeConfig.evlog at server boot) sees a\n    // consistent value.\n    //\n    // The stream is exposed by a separate mini HTTP server on its own\n    // ephemeral port (see `evlog/stream` → `startStreamServer`). It does\n    // NOT register a route in the user's app.\n    //\n    // Strict opt-in: nothing starts unless the user explicitly asks for it.\n    //   - `stream === true`        → enabled with defaults\n    //   - `stream === false`       → off (alias for undefined)\n    //   - `stream: { ... }`        → enabled with user options\n    //   - `stream === undefined`   → off\n    const streamRaw = options.stream\n    const normalizedStream\n      = streamRaw === true\n        ? true\n        : streamRaw && typeof streamRaw === 'object'\n          ? streamRaw\n          : false\n    const streamEnabled = normalizedStream !== false\n    options.stream = normalizedStream\n\n    nuxt.options.runtimeConfig.evlog = options\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    // Mirror standalone Nitro modules: serialize evlog options into __EVLOG_CONFIG so\n    // resolveEvlogConfigForNitroPlugin() picks them up in dev (Nitro worker threads\n    // often cannot resolve useRuntimeConfig().evlog via dynamic import reliably).\n    // @ts-expect-error nitro:config hook exists but is not in NuxtHooks type\n    nuxt.hook('nitro:config', (nitroConfig: NitroConfig) => {\n      const evlogHandler = resolver.resolve('../nitro/errorHandler').replace(/\\\\/g, '/')\n      nitroConfig.errorHandler = prependNitroErrorHandler(nitroConfig.errorHandler, evlogHandler)\n\n      const evlogForNitro = nuxt.options.runtimeConfig.evlog ?? options\n      if (evlogForNitro !== undefined && typeof evlogForNitro === 'object') {\n        const serialized = JSON.stringify(evlogForNitro)\n        nitroConfig.replace = nitroConfig.replace || {}\n        nitroConfig.replace.__EVLOG_CONFIG__ = serialized\n        process.env.__EVLOG_CONFIG = serialized\n      }\n    })\n    nuxt.options.runtimeConfig.public.evlog = {\n      enabled: options.enabled ?? true,\n      console: options.console,\n      pretty: options.pretty,\n      minLevel: options.minLevel,\n      transport: {\n        enabled: transportEnabled,\n        endpoint: transportEndpoint,\n        credentials: transportCredentials,\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    if (streamEnabled) {\n      // The stream itself is served by an out-of-band HTTP mini-server\n      // started in the Nitro plugin — see startStreamServer() in\n      // packages/evlog/src/stream.ts. Here we only register a discovery\n      // route so a browser tab on the user's app can find the mini-server\n      // URL without having to read `.evlog/stream.url` directly.\n      addServerHandler({\n        route: '/api/_evlog/stream-info',\n        method: 'get',\n        handler: resolver.resolve('../runtime/server/routes/_evlog/stream-info.get'),\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: 'setMinLevel',\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    const stripLevels = options.strip ?? ['debug']\n    if (stripLevels.length > 0) {\n      addVitePlugin(createStripPlugin(stripLevels))\n    }\n\n    const srcLoc = options.sourceLocation ?? 'dev'\n    if (srcLoc === true || (srcLoc === 'dev' && nuxt.options.dev)) {\n      addVitePlugin(createSourceLocationPlugin(true))\n    }\n  },\n})\n"],"mappings":";;;;;AAgUA,IAAA,iBAAe,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;EACzD,MAAM,uBAAuB,QAAQ,WAAW,eAAe;EAe/D,MAAM,YAAY,QAAQ;EAC1B,MAAM,mBACF,cAAc,OACZ,OACA,aAAa,OAAO,cAAc,WAChC,YACA;EACR,MAAM,gBAAgB,qBAAqB;AAC3C,UAAQ,SAAS;AAEjB,OAAK,QAAQ,cAAc,QAAQ;AAQnC,OAAK,KAAK,iBAAiB,gBAA6B;GACtD,MAAM,eAAe,SAAS,QAAQ,wBAAwB,CAAC,QAAQ,OAAO,IAAI;AAClF,eAAY,eAAe,yBAAyB,YAAY,cAAc,aAAa;GAE3F,MAAM,gBAAgB,KAAK,QAAQ,cAAc,SAAS;AAC1D,OAAI,kBAAkB,KAAA,KAAa,OAAO,kBAAkB,UAAU;IACpE,MAAM,aAAa,KAAK,UAAU,cAAc;AAChD,gBAAY,UAAU,YAAY,WAAW,EAAE;AAC/C,gBAAY,QAAQ,mBAAmB;AACvC,YAAQ,IAAI,iBAAiB;;IAE/B;AACF,OAAK,QAAQ,cAAc,OAAO,QAAQ;GACxC,SAAS,QAAQ,WAAW;GAC5B,SAAS,QAAQ;GACjB,QAAQ,QAAQ;GAChB,UAAU,QAAQ;GAClB,WAAW;IACT,SAAS;IACT,UAAU;IACV,aAAa;IACd;GACF;AAED,MAAI,iBACF,kBAAiB;GACf,OAAO;GACP,QAAQ;GACR,SAAS,SAAS,QAAQ,8CAA8C;GACzE,CAAC;AAGJ,MAAI,cAMF,kBAAiB;GACf,OAAO;GACP,QAAQ;GACR,SAAS,SAAS,QAAQ,kDAAkD;GAC7E,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,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;EAEF,MAAM,cAAc,QAAQ,SAAS,CAAC,QAAQ;AAC9C,MAAI,YAAY,SAAS,EACvB,eAAc,kBAAkB,YAAY,CAAC;EAG/C,MAAM,SAAS,QAAQ,kBAAkB;AACzC,MAAI,WAAW,QAAS,WAAW,SAAS,KAAK,QAAQ,IACvD,eAAc,2BAA2B,KAAK,CAAC;;CAGpD,CAAC"}

package/dist/orpc/index.d.mts

@@ -0,0 +1,115 @@
+import { rt as RequestLogger } from "../audit-BUAajsPU.mjs";
+import { t as BaseEvlogOptions } from "../middleware-DQ6-h8h0.mjs";
+import { Context, MiddlewareOptions, MiddlewareResult } from "@orpc/server";
+
+//#region src/orpc/index.d.ts
+declare const useLogger: <T extends object = Record<string, unknown>>() => RequestLogger<T>;
+/** Options accepted by {@link withEvlog} for oRPC request instrumentation. */
+type EvlogOrpcOptions = BaseEvlogOptions;
+/**
+ * Inject this type into your oRPC initial context to access `context.log`
+ * inside procedures.
+ *
+ * @example
+ * ```ts
+ * import { os } from '@orpc/server'
+ * import { evlog, type EvlogOrpcContext } from 'evlog/orpc'
+ *
+ * const base = os.$context<EvlogOrpcContext>().use(evlog())
+ * ```
+ */
+interface EvlogOrpcContext {
+  log: RequestLogger;
+}
+/**
+ * Result shape of `handler.handle()` for oRPC's fetch adapter
+ * ({@link https://orpc.dev/docs/adapters/http RPCHandler / OpenAPIHandler}).
+ */
+type OrpcFetchHandleResult = {
+  matched: true;
+  response: Response;
+} | {
+  matched: false;
+  response: undefined;
+};
+/**
+ * Minimal subset of oRPC's `FetchHandler` that we need to wrap. Anything
+ * compatible (RPCHandler, OpenAPIHandler, custom handler) plugs in.
+ *
+ * `options` is intentionally typed loosely so this matches both the
+ * `(req, opts)` and `(req, opts?)` overloads that oRPC produces depending on
+ * whether the router declares a non-empty initial context. The wrapper just
+ * splats the original options through and injects `log` into `context`.
+ */
+interface OrpcFetchHandlerLike {
+  handle: (request: Request, options?: any) => Promise<OrpcFetchHandleResult>;
+}
+/**
+ * Wrap an oRPC handler so each matched request emits a single wide event.
+ * Works with any handler that exposes `.handle(request, options)` from
+ * `@orpc/server/fetch` (RPCHandler, OpenAPIHandler, custom handlers).
+ *
+ * The returned proxy preserves the original handler's identity (instance
+ * methods, plugins, etc.) and only intercepts `handle`. Inside procedures,
+ * the request logger is exposed as `context.log` — pair this with
+ * `os.use(evlog())` to also accumulate `operation` (`path.join('.')`) on the
+ * wide event.
+ *
+ * Routes that are filtered out by `include`/`exclude` are passed straight to
+ * the underlying handler with no instrumentation.
+ *
+ * @example
+ * ```ts
+ * import { RPCHandler } from '@orpc/server/fetch'
+ * import { withEvlog } from 'evlog/orpc'
+ * import { router } from './router'
+ *
+ * const handler = withEvlog(new RPCHandler(router), {
+ *   include: ['/rpc/**'],
+ * })
+ *
+ * export default async function fetch(request: Request) {
+ *   const { matched, response } = await handler.handle(request, { prefix: '/rpc' })
+ *   return matched ? response : new Response('Not Found', { status: 404 })
+ * }
+ * ```
+ */
+declare function withEvlog<THandler extends OrpcFetchHandlerLike>(handler: THandler, options?: EvlogOrpcOptions): THandler;
+/**
+ * Procedure-level middleware. Three responsibilities:
+ *
+ * 1. Adds `operation` (the procedure path joined by `.`) to the wide event,
+ *    so consumers can group events by procedure without parsing URLs.
+ * 2. Captures errors thrown by the procedure on the wide event so the level
+ *    is promoted to `error`.
+ * 3. Converts {@link EvlogError} (from `createError()` / `defineErrorCatalog`)
+ *    into a structurally-equivalent {@link ORPCError} before re-throwing, so
+ *    the wire response carries the catalog `code`, status, message, and the
+ *    `why` / `fix` / `link` guidance under `data` — instead of being wrapped
+ *    as `INTERNAL_SERVER_ERROR` by oRPC's default handler. The catalog and
+ *    `createError()` stay the canonical evlog way to author errors;
+ *    `evlog/orpc` is the bridge.
+ *
+ * Requires `withEvlog()` to be wrapped around the handler — the request
+ * logger flows in via `context.log`. Declare {@link EvlogOrpcContext} on
+ * your oRPC base for typed access.
+ *
+ * @example
+ * ```ts
+ * import { os } from '@orpc/server'
+ * import { evlog, type EvlogOrpcContext } from 'evlog/orpc'
+ *
+ * const base = os.$context<EvlogOrpcContext>().use(evlog())
+ *
+ * export const getUser = base
+ *   .input(z.object({ id: z.string() }))
+ *   .handler(async ({ input, context }) => {
+ *     context.log.set({ user: { id: input.id } })
+ *     return await db.user.findUnique(input)
+ *   })
+ * ```
+ */
+declare function evlog<TContext extends Partial<EvlogOrpcContext> & Context = EvlogOrpcContext>(): (options: MiddlewareOptions<TContext, unknown, any, any>) => Promise<MiddlewareResult<Record<never, never>, unknown>>;
+//#endregion
+export { EvlogOrpcContext, EvlogOrpcOptions, evlog, useLogger, withEvlog };
+//# sourceMappingURL=index.d.mts.map

package/dist/orpc/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../src/orpc/index.ts"],"mappings":";;;;;cAQiB,SAAA,sBAAS,MAAA,wBAAA,aAAA,CAAA,CAAA;;KAKd,gBAAA,GAAmB,gBAAA;;;;;;;;;AAA/B;;;;UAoBiB,gBAAA;EACf,GAAA,EAAK,aAAA;AAAA;;;;AACN;KAMI,qBAAA;EACC,OAAA;EAAe,QAAA,EAAU,QAAA;AAAA;EACzB,OAAA;EAAgB,QAAA;AAAA;;;;AAAQ;;;;;;UAWpB,oBAAA;EACR,MAAA,GACE,OAAA,EAAS,OAAA,EACT,OAAA,WACG,OAAA,CAAQ,qBAAA;AAAA;;;;;;;;AAkDf;;;;;;;;;;;;;;;;;;AA6EA;;;;;iBA7EgB,SAAA,kBAA2B,oBAAA,CAAA,CACzC,OAAA,EAAS,QAAA,EACT,OAAA,GAAS,gBAAA,GACR,QAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA0Ea,KAAA,kBAAuB,OAAA,CAAQ,gBAAA,IAAoB,OAAA,GAAU,gBAAA,CAAA,CAAA,IAEzE,OAAA,EAAS,iBAAA,CAAkB,QAAA,yBAC1B,OAAA,CAAQ,gBAAA,CAAiB,MAAA"}

package/dist/orpc/index.mjs

@@ -0,0 +1,145 @@
+import { EvlogError } from "../error.mjs";
+import { parseError } from "../runtime/utils/parseError.mjs";
+import { t as defineFrameworkIntegration } from "../integration-CR601uyW.mjs";
+import { t as createLoggerStorage } from "../storage-7X37OToT.mjs";
+import { ORPCError } from "@orpc/server";
+//#region src/orpc/index.ts
+const { storage, useLogger } = createLoggerStorage("oRPC handler. Wrap your handler with `withEvlog()` from evlog/orpc.");
+const integration = defineFrameworkIntegration({
+	name: "orpc",
+	extractRequest: ({ request }) => {
+		const url = new URL(request.url);
+		return {
+			method: request.method,
+			path: url.pathname,
+			headers: request.headers,
+			requestId: request.headers.get("x-request-id") ?? void 0
+		};
+	},
+	attachLogger: () => {},
+	storage
+});
+/**
+* Wrap an oRPC handler so each matched request emits a single wide event.
+* Works with any handler that exposes `.handle(request, options)` from
+* `@orpc/server/fetch` (RPCHandler, OpenAPIHandler, custom handlers).
+*
+* The returned proxy preserves the original handler's identity (instance
+* methods, plugins, etc.) and only intercepts `handle`. Inside procedures,
+* the request logger is exposed as `context.log` — pair this with
+* `os.use(evlog())` to also accumulate `operation` (`path.join('.')`) on the
+* wide event.
+*
+* Routes that are filtered out by `include`/`exclude` are passed straight to
+* the underlying handler with no instrumentation.
+*
+* @example
+* ```ts
+* import { RPCHandler } from '@orpc/server/fetch'
+* import { withEvlog } from 'evlog/orpc'
+* import { router } from './router'
+*
+* const handler = withEvlog(new RPCHandler(router), {
+*   include: ['/rpc/**'],
+* })
+*
+* export default async function fetch(request: Request) {
+*   const { matched, response } = await handler.handle(request, { prefix: '/rpc' })
+*   return matched ? response : new Response('Not Found', { status: 404 })
+* }
+* ```
+*/
+function withEvlog(handler, options = {}) {
+	const handle = async (request, callOptions) => {
+		const { skipped, finish, finishResponse, runWith, logger } = integration.start({ request }, options);
+		const initialContext = callOptions?.context ?? {};
+		const finalOptions = {
+			...callOptions,
+			context: {
+				...initialContext,
+				log: logger
+			}
+		};
+		if (skipped) return handler.handle(request, finalOptions);
+		try {
+			const result = await runWith(() => handler.handle(request, finalOptions));
+			if (result.matched) result.response = await finishResponse(result.response, { status: result.response.status });
+			else await finish({ status: 404 });
+			return result;
+		} catch (error) {
+			await finish({ error });
+			throw error;
+		}
+	};
+	return new Proxy(handler, { get(target, prop, receiver) {
+		if (prop === "handle") return handle;
+		return Reflect.get(target, prop, receiver);
+	} });
+}
+function isEvlogError(error) {
+	return error instanceof EvlogError || error instanceof Error && error.name === "EvlogError";
+}
+/**
+* Procedure-level middleware. Three responsibilities:
+*
+* 1. Adds `operation` (the procedure path joined by `.`) to the wide event,
+*    so consumers can group events by procedure without parsing URLs.
+* 2. Captures errors thrown by the procedure on the wide event so the level
+*    is promoted to `error`.
+* 3. Converts {@link EvlogError} (from `createError()` / `defineErrorCatalog`)
+*    into a structurally-equivalent {@link ORPCError} before re-throwing, so
+*    the wire response carries the catalog `code`, status, message, and the
+*    `why` / `fix` / `link` guidance under `data` — instead of being wrapped
+*    as `INTERNAL_SERVER_ERROR` by oRPC's default handler. The catalog and
+*    `createError()` stay the canonical evlog way to author errors;
+*    `evlog/orpc` is the bridge.
+*
+* Requires `withEvlog()` to be wrapped around the handler — the request
+* logger flows in via `context.log`. Declare {@link EvlogOrpcContext} on
+* your oRPC base for typed access.
+*
+* @example
+* ```ts
+* import { os } from '@orpc/server'
+* import { evlog, type EvlogOrpcContext } from 'evlog/orpc'
+*
+* const base = os.$context<EvlogOrpcContext>().use(evlog())
+*
+* export const getUser = base
+*   .input(z.object({ id: z.string() }))
+*   .handler(async ({ input, context }) => {
+*     context.log.set({ user: { id: input.id } })
+*     return await db.user.findUnique(input)
+*   })
+* ```
+*/
+function evlog() {
+	return async function evlogMiddleware(options) {
+		const { context: { log }, path, next } = options;
+		if (log && path.length > 0) log.set({ operation: path.join(".") });
+		try {
+			return await next();
+		} catch (error) {
+			if (log) log.error(error);
+			if (isEvlogError(error)) throw toOrpcError(error);
+			throw error;
+		}
+	};
+}
+function toOrpcError(error) {
+	const parsed = parseError(error);
+	const data = {};
+	if (parsed.why !== void 0) data.why = parsed.why;
+	if (parsed.fix !== void 0) data.fix = parsed.fix;
+	if (parsed.link !== void 0) data.link = parsed.link;
+	return new ORPCError(parsed.code ?? "EVLOG_ERROR", {
+		status: parsed.status,
+		message: parsed.message,
+		data,
+		cause: error
+	});
+}
+//#endregion
+export { evlog, useLogger, withEvlog };
+
+//# sourceMappingURL=index.mjs.map

package/dist/orpc/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../../src/orpc/index.ts"],"sourcesContent":["import { ORPCError, type Context, type MiddlewareOptions, type MiddlewareResult } from '@orpc/server'\nimport type { RequestLogger } from '../types'\nimport { EvlogError } from '../error'\nimport { parseError } from '../runtime/utils/parseError'\nimport { defineFrameworkIntegration } from '../shared/integration'\nimport type { BaseEvlogOptions } from '../shared/middleware'\nimport { createLoggerStorage } from '../shared/storage'\n\nconst { storage, useLogger } = createLoggerStorage(\n  'oRPC handler. Wrap your handler with `withEvlog()` from evlog/orpc.',\n)\n\n/** Options accepted by {@link withEvlog} for oRPC request instrumentation. */\nexport type EvlogOrpcOptions = BaseEvlogOptions\n\n/**\n * Access the current request-scoped logger outside oRPC context callbacks.\n * Requires {@link withEvlog} on the handler.\n */\nexport { useLogger }\n\n/**\n * Inject this type into your oRPC initial context to access `context.log`\n * inside procedures.\n *\n * @example\n * ```ts\n * import { os } from '@orpc/server'\n * import { evlog, type EvlogOrpcContext } from 'evlog/orpc'\n *\n * const base = os.$context<EvlogOrpcContext>().use(evlog())\n * ```\n */\nexport interface EvlogOrpcContext {\n  log: RequestLogger\n}\n\n/**\n * Result shape of `handler.handle()` for oRPC's fetch adapter\n * ({@link https://orpc.dev/docs/adapters/http RPCHandler / OpenAPIHandler}).\n */\ntype OrpcFetchHandleResult =\n  | { matched: true, response: Response }\n  | { matched: false, response: undefined }\n\n/**\n * Minimal subset of oRPC's `FetchHandler` that we need to wrap. Anything\n * compatible (RPCHandler, OpenAPIHandler, custom handler) plugs in.\n *\n * `options` is intentionally typed loosely so this matches both the\n * `(req, opts)` and `(req, opts?)` overloads that oRPC produces depending on\n * whether the router declares a non-empty initial context. The wrapper just\n * splats the original options through and injects `log` into `context`.\n */\ninterface OrpcFetchHandlerLike {\n  handle: (\n    request: Request,\n    options?: any,\n  ) => Promise<OrpcFetchHandleResult>\n}\n\nconst integration = defineFrameworkIntegration<{ request: Request }>({\n  name: 'orpc',\n  extractRequest: ({ request }) => {\n    const url = new URL(request.url)\n    return {\n      method: request.method,\n      path: url.pathname,\n      headers: request.headers,\n      requestId: request.headers.get('x-request-id') ?? undefined,\n    }\n  },\n  attachLogger: () => {\n    /* logger is injected into the oRPC context inside withEvlog() */\n  },\n  storage,\n})\n\n/**\n * Wrap an oRPC handler so each matched request emits a single wide event.\n * Works with any handler that exposes `.handle(request, options)` from\n * `@orpc/server/fetch` (RPCHandler, OpenAPIHandler, custom handlers).\n *\n * The returned proxy preserves the original handler's identity (instance\n * methods, plugins, etc.) and only intercepts `handle`. Inside procedures,\n * the request logger is exposed as `context.log` — pair this with\n * `os.use(evlog())` to also accumulate `operation` (`path.join('.')`) on the\n * wide event.\n *\n * Routes that are filtered out by `include`/`exclude` are passed straight to\n * the underlying handler with no instrumentation.\n *\n * @example\n * ```ts\n * import { RPCHandler } from '@orpc/server/fetch'\n * import { withEvlog } from 'evlog/orpc'\n * import { router } from './router'\n *\n * const handler = withEvlog(new RPCHandler(router), {\n *   include: ['/rpc/**'],\n * })\n *\n * export default async function fetch(request: Request) {\n *   const { matched, response } = await handler.handle(request, { prefix: '/rpc' })\n *   return matched ? response : new Response('Not Found', { status: 404 })\n * }\n * ```\n */\nexport function withEvlog<THandler extends OrpcFetchHandlerLike>(\n  handler: THandler,\n  options: EvlogOrpcOptions = {},\n): THandler {\n  const handle: THandler['handle'] = async (request, callOptions) => {\n    const { skipped, finish, finishResponse, runWith, logger } = integration.start({ request }, options)\n\n    const initialContext = (callOptions as { context?: Record<string, unknown> } | undefined)?.context ?? {}\n    const finalOptions = {\n      ...callOptions,\n      context: { ...initialContext, log: logger },\n    } as Parameters<THandler['handle']>[1]\n\n    if (skipped) {\n      return handler.handle(request, finalOptions)\n    }\n\n    try {\n      const result = await runWith(() => handler.handle(request, finalOptions))\n      if (result.matched) {\n        result.response = await finishResponse(result.response, { status: result.response.status })\n      } else {\n        await finish({ status: 404 })\n      }\n      return result\n    } catch (error) {\n      await finish({ error: error as Error })\n      throw error\n    }\n  }\n\n  return new Proxy(handler, {\n    get(target, prop, receiver) {\n      if (prop === 'handle') return handle\n      return Reflect.get(target, prop, receiver)\n    },\n  })\n}\n\nfunction isEvlogError(error: unknown): error is EvlogError {\n  return error instanceof EvlogError || (error instanceof Error && error.name === 'EvlogError')\n}\n\n/**\n * Procedure-level middleware. Three responsibilities:\n *\n * 1. Adds `operation` (the procedure path joined by `.`) to the wide event,\n *    so consumers can group events by procedure without parsing URLs.\n * 2. Captures errors thrown by the procedure on the wide event so the level\n *    is promoted to `error`.\n * 3. Converts {@link EvlogError} (from `createError()` / `defineErrorCatalog`)\n *    into a structurally-equivalent {@link ORPCError} before re-throwing, so\n *    the wire response carries the catalog `code`, status, message, and the\n *    `why` / `fix` / `link` guidance under `data` — instead of being wrapped\n *    as `INTERNAL_SERVER_ERROR` by oRPC's default handler. The catalog and\n *    `createError()` stay the canonical evlog way to author errors;\n *    `evlog/orpc` is the bridge.\n *\n * Requires `withEvlog()` to be wrapped around the handler — the request\n * logger flows in via `context.log`. Declare {@link EvlogOrpcContext} on\n * your oRPC base for typed access.\n *\n * @example\n * ```ts\n * import { os } from '@orpc/server'\n * import { evlog, type EvlogOrpcContext } from 'evlog/orpc'\n *\n * const base = os.$context<EvlogOrpcContext>().use(evlog())\n *\n * export const getUser = base\n *   .input(z.object({ id: z.string() }))\n *   .handler(async ({ input, context }) => {\n *     context.log.set({ user: { id: input.id } })\n *     return await db.user.findUnique(input)\n *   })\n * ```\n */\nexport function evlog<TContext extends Partial<EvlogOrpcContext> & Context = EvlogOrpcContext>() {\n  return async function evlogMiddleware(\n    options: MiddlewareOptions<TContext, unknown, any, any>,\n  ): Promise<MiddlewareResult<Record<never, never>, unknown>> {\n    const { context: { log }, path, next } = options\n    if (log && path.length > 0) {\n      log.set({ operation: path.join('.') })\n    }\n    try {\n      return await next()\n    } catch (error) {\n      if (log) log.error(error as Error)\n      if (isEvlogError(error)) {\n        throw toOrpcError(error)\n      }\n      throw error\n    }\n  }\n}\n\nfunction toOrpcError(error: EvlogError): ORPCError<string, Record<string, unknown>> {\n  const parsed = parseError(error)\n  const data: Record<string, unknown> = {}\n  if (parsed.why !== undefined) data.why = parsed.why\n  if (parsed.fix !== undefined) data.fix = parsed.fix\n  if (parsed.link !== undefined) data.link = parsed.link\n  return new ORPCError(parsed.code ?? 'EVLOG_ERROR', {\n    status: parsed.status,\n    message: parsed.message,\n    data,\n    cause: error,\n  })\n}\n"],"mappings":";;;;;;AAQA,MAAM,EAAE,SAAS,cAAc,oBAC7B,sEACD;AAmDD,MAAM,cAAc,2BAAiD;CACnE,MAAM;CACN,iBAAiB,EAAE,cAAc;EAC/B,MAAM,MAAM,IAAI,IAAI,QAAQ,IAAI;AAChC,SAAO;GACL,QAAQ,QAAQ;GAChB,MAAM,IAAI;GACV,SAAS,QAAQ;GACjB,WAAW,QAAQ,QAAQ,IAAI,eAAe,IAAI,KAAA;GACnD;;CAEH,oBAAoB;CAGpB;CACD,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAgCF,SAAgB,UACd,SACA,UAA4B,EAAE,EACpB;CACV,MAAM,SAA6B,OAAO,SAAS,gBAAgB;EACjE,MAAM,EAAE,SAAS,QAAQ,gBAAgB,SAAS,WAAW,YAAY,MAAM,EAAE,SAAS,EAAE,QAAQ;EAEpG,MAAM,iBAAkB,aAAmE,WAAW,EAAE;EACxG,MAAM,eAAe;GACnB,GAAG;GACH,SAAS;IAAE,GAAG;IAAgB,KAAK;IAAQ;GAC5C;AAED,MAAI,QACF,QAAO,QAAQ,OAAO,SAAS,aAAa;AAG9C,MAAI;GACF,MAAM,SAAS,MAAM,cAAc,QAAQ,OAAO,SAAS,aAAa,CAAC;AACzE,OAAI,OAAO,QACT,QAAO,WAAW,MAAM,eAAe,OAAO,UAAU,EAAE,QAAQ,OAAO,SAAS,QAAQ,CAAC;OAE3F,OAAM,OAAO,EAAE,QAAQ,KAAK,CAAC;AAE/B,UAAO;WACA,OAAO;AACd,SAAM,OAAO,EAAS,OAAgB,CAAC;AACvC,SAAM;;;AAIV,QAAO,IAAI,MAAM,SAAS,EACxB,IAAI,QAAQ,MAAM,UAAU;AAC1B,MAAI,SAAS,SAAU,QAAO;AAC9B,SAAO,QAAQ,IAAI,QAAQ,MAAM,SAAS;IAE7C,CAAC;;AAGJ,SAAS,aAAa,OAAqC;AACzD,QAAO,iBAAiB,cAAe,iBAAiB,SAAS,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAqClF,SAAgB,QAAiF;AAC/F,QAAO,eAAe,gBACpB,SAC0D;EAC1D,MAAM,EAAE,SAAS,EAAE,OAAO,MAAM,SAAS;AACzC,MAAI,OAAO,KAAK,SAAS,EACvB,KAAI,IAAI,EAAE,WAAW,KAAK,KAAK,IAAI,EAAE,CAAC;AAExC,MAAI;AACF,UAAO,MAAM,MAAM;WACZ,OAAO;AACd,OAAI,IAAK,KAAI,MAAM,MAAe;AAClC,OAAI,aAAa,MAAM,CACrB,OAAM,YAAY,MAAM;AAE1B,SAAM;;;;AAKZ,SAAS,YAAY,OAA+D;CAClF,MAAM,SAAS,WAAW,MAAM;CAChC,MAAM,OAAgC,EAAE;AACxC,KAAI,OAAO,QAAQ,KAAA,EAAW,MAAK,MAAM,OAAO;AAChD,KAAI,OAAO,QAAQ,KAAA,EAAW,MAAK,MAAM,OAAO;AAChD,KAAI,OAAO,SAAS,KAAA,EAAW,MAAK,OAAO,OAAO;AAClD,QAAO,IAAI,UAAU,OAAO,QAAQ,eAAe;EACjD,QAAQ,OAAO;EACf,SAAS,OAAO;EAChB;EACA,OAAO;EACR,CAAC"}

package/dist/{package-v_MmOZeA.mjs → package-CUhII9DA.mjs}

@@ -1,7 +1,7 @@
 //#region package.json
 var name = "evlog";
-var version = "2.17.0";
+var version = "2.19.0";
 //#endregion
 export { version as n, name as t };
 
-//# sourceMappingURL=package-v_MmOZeA.mjs.map
+//# sourceMappingURL=package-CUhII9DA.mjs.map

package/dist/package-CUhII9DA.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-CUhII9DA.mjs","names":[],"sources":["../package.json"],"sourcesContent":[""],"mappings":""}

package/dist/{parseError-yVZ58wIK.d.mts → parseError-Cagr-Ctc.d.mts}

@@ -1,7 +1,7 @@
-import { J as ParsedError } from "./audit-CC8nfazi.mjs";
+import { Q as ParsedError } from "./audit-BUAajsPU.mjs";
 
 //#region src/runtime/utils/parseError.d.ts
 declare function parseError(error: unknown): ParsedError;
 //#endregion
 export { parseError as t };
-//# sourceMappingURL=parseError-yVZ58wIK.d.mts.map
+//# sourceMappingURL=parseError-Cagr-Ctc.d.mts.map

package/dist/parseError-Cagr-Ctc.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parseError-Cagr-Ctc.d.mts","names":[],"sources":["../src/runtime/utils/parseError.ts"],"mappings":";;;iBAcgB,UAAA,CAAW,KAAA,YAAiB,WAAA"}