evlog 2.16.0 → 2.18.1

package/dist/nitroConfigBridge-NbFn-sIK.mjs

@@ -0,0 +1,157 @@
+//#region src/shared/nitroConfigBridge.ts
+const EVLOG_NITRO_ENV = "__EVLOG_CONFIG";
+/** Build-time inlined config, or `undefined` if the bundle was not produced by an evlog Nitro module. */
+function readEvlogConfigFromInline() {
+	if (typeof __EVLOG_CONFIG__ === "undefined") return void 0;
+	if (__EVLOG_CONFIG__ === null || typeof __EVLOG_CONFIG__ !== "object") return void 0;
+	return __EVLOG_CONFIG__;
+}
+let activeNitroRuntime;
+/**
+* Declare the active Nitro major version so adapters never probe the other
+* version's modules at runtime. The evlog Nitro plugins call this in their
+* first synchronous statement.
+*
+* Bun's auto-install behavior writes to `node_modules/.cache` whenever a
+* dynamic import targets a missing package, which crashes on Vercel's
+* read-only function filesystem. Restricting probes to the runtime that is
+* actually installed avoids that path entirely.
+*/
+function setActiveNitroRuntime(version) {
+	activeNitroRuntime = version;
+}
+function nitroV3RuntimeConfigSpecifier() {
+	return ["nitro", "runtime-config"].join("/");
+}
+function nitropackRuntimeSpecifier() {
+	return ["nitropack", "runtime"].join("/");
+}
+function nitropackInternalRuntimeConfigSpecifier() {
+	return [
+		"nitropack",
+		"runtime",
+		"internal",
+		"config"
+	].join("/");
+}
+async function importOrNull(specifier) {
+	try {
+		return await import(specifier);
+	} catch {
+		return null;
+	}
+}
+function isRuntimeConfigModule(mod) {
+	return typeof mod === "object" && mod !== null && "useRuntimeConfig" in mod && typeof mod.useRuntimeConfig === "function";
+}
+/** Snapshot from env, or `undefined` if unset / invalid JSON. */
+function readEvlogConfigFromNitroEnv() {
+	const raw = process.env[EVLOG_NITRO_ENV];
+	if (raw === void 0 || raw === "") return void 0;
+	try {
+		return JSON.parse(raw);
+	} catch {
+		return;
+	}
+}
+let cachedNitropackRuntime;
+let cachedNitroV3Runtime;
+let cachedNitropackInternalConfig;
+async function getNitropackRuntime() {
+	if (cachedNitropackRuntime !== void 0) return cachedNitropackRuntime;
+	const mod = await importOrNull(nitropackRuntimeSpecifier());
+	cachedNitropackRuntime = isRuntimeConfigModule(mod) ? mod : null;
+	return cachedNitropackRuntime;
+}
+async function getNitroV3Runtime() {
+	if (cachedNitroV3Runtime !== void 0) return cachedNitroV3Runtime;
+	const mod = await importOrNull(nitroV3RuntimeConfigSpecifier());
+	cachedNitroV3Runtime = isRuntimeConfigModule(mod) ? mod : null;
+	return cachedNitroV3Runtime;
+}
+async function getNitropackInternalRuntimeConfig() {
+	if (cachedNitropackInternalConfig !== void 0) return cachedNitropackInternalConfig;
+	const mod = await importOrNull(nitropackInternalRuntimeConfigSpecifier());
+	cachedNitropackInternalConfig = isRuntimeConfigModule(mod) ? mod : null;
+	return cachedNitropackInternalConfig;
+}
+function evlogSlice(config) {
+	const { evlog } = config;
+	if (evlog && typeof evlog === "object") return evlog;
+}
+/**
+* Options for evlog Nitro plugins (nitropack v2 and Nitro v3).
+*
+* Lookup order:
+* 1. `__EVLOG_CONFIG__` — inlined at build time by the evlog Nitro module.
+*    Hits in every deployed bundle and skips runtime probing entirely.
+* 2. `process.env.__EVLOG_CONFIG`
+* 3. The active runtime declared by {@link setActiveNitroRuntime} — either
+*    Nitro v3 `runtime-config` or nitropack internal config, never both.
+* 4. When no active runtime has been declared (standalone use): probe v3 then
+*    nitropack v2 as a best-effort fallback.
+*/
+async function resolveEvlogConfigForNitroPlugin() {
+	const fromInline = readEvlogConfigFromInline();
+	if (fromInline !== void 0) return fromInline;
+	const fromEnv = readEvlogConfigFromNitroEnv();
+	if (fromEnv !== void 0) return fromEnv;
+	if (activeNitroRuntime === "v3") {
+		const v3 = await getNitroV3Runtime();
+		if (v3) {
+			const slice = evlogSlice(v3.useRuntimeConfig());
+			if (slice !== void 0) return slice;
+		}
+		return;
+	}
+	if (activeNitroRuntime === "v2") {
+		const internal = await getNitropackInternalRuntimeConfig();
+		if (internal) {
+			const slice = evlogSlice(internal.useRuntimeConfig());
+			if (slice !== void 0) return slice;
+		}
+		return;
+	}
+	const v3 = await getNitroV3Runtime();
+	if (v3) {
+		const slice = evlogSlice(v3.useRuntimeConfig());
+		if (slice !== void 0) return slice;
+	}
+	const internal = await getNitropackInternalRuntimeConfig();
+	if (internal) {
+		const slice = evlogSlice(internal.useRuntimeConfig());
+		if (slice !== void 0) return slice;
+	}
+}
+/**
+* Full `useRuntimeConfig()` object for drain adapters.
+*
+* Honors {@link setActiveNitroRuntime}: when a Nitro plugin has declared its
+* version, only that version's runtime module is probed. When no version has
+* been declared (standalone use outside Nitro), falls back to the historical
+* order: nitropack v2 first, then Nitro v3.
+*
+* When `__EVLOG_CONFIG__` was inlined at build time, returns a synthetic
+* `{ evlog: <inlined> }` record so adapters can read `runtimeConfig.evlog.*`
+* without triggering the dynamic import (issue #312).
+*/
+async function getNitroRuntimeConfigRecord() {
+	const inline = readEvlogConfigFromInline();
+	if (inline !== void 0) return { evlog: inline };
+	if (activeNitroRuntime === "v3") {
+		const v3 = await getNitroV3Runtime();
+		return v3 ? v3.useRuntimeConfig() : void 0;
+	}
+	if (activeNitroRuntime === "v2") {
+		const nitropack = await getNitropackRuntime();
+		return nitropack ? nitropack.useRuntimeConfig() : void 0;
+	}
+	const nitropack = await getNitropackRuntime();
+	if (nitropack) return nitropack.useRuntimeConfig();
+	const v3 = await getNitroV3Runtime();
+	if (v3) return v3.useRuntimeConfig();
+}
+//#endregion
+export { resolveEvlogConfigForNitroPlugin as n, setActiveNitroRuntime as r, getNitroRuntimeConfigRecord as t };
+
+//# sourceMappingURL=nitroConfigBridge-NbFn-sIK.mjs.map

package/dist/nitroConfigBridge-NbFn-sIK.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"nitroConfigBridge-NbFn-sIK.mjs","names":[],"sources":["../src/shared/nitroConfigBridge.ts"],"sourcesContent":["/**\n * How evlog reads Nitro runtime config from **published** ESM.\n *\n * **Why not** `import('nitro/runtime-config')` as a string literal in source?\n * Those subpaths are virtual or specially resolved. App Rollup can resolve them\n * for first-party code; for dependency chunks (`node_modules/evlog/dist/...`),\n * strict presets (e.g. `cloudflare-durable`) may fail with “externals are not\n * allowed”. A literal dynamic import is enough for Rollup to pre-resolve.\n *\n * **Strategy**\n *\n * 1. `__EVLOG_CONFIG__` — build-time literal baked in by the evlog Nitro\n *    modules via `nitro.options.replace`. When present, all runtime probing is\n *    skipped (see issue #312: Vercel + Bun crashes if the v3 probe runs).\n * 2. `process.env.__EVLOG_CONFIG` — JSON set by evlog Nitro modules during\n *    build; survives into runtime on platforms that propagate build env vars.\n * 3. Computed module IDs — `['a','b'].join('/')` passed to `import()` so emitted\n *    JS does not contain a static `import(\"a/b\")`.\n * 4. Plugins call {@link setActiveNitroRuntime} so adapters never probe modules\n *    from the other major version.\n * 5. When the active runtime is unknown (standalone use outside a Nitro\n *    plugin), the bridge falls back to the historical probe order.\n *\n * Not exported from `evlog/toolkit` — package-internal only.\n */\n\nimport type { NitroPluginEvlogConfig } from '../nitro'\n\ntype EvlogConfig = NitroPluginEvlogConfig\n\nconst EVLOG_NITRO_ENV = '__EVLOG_CONFIG' as const\n\n// Replaced at build time by `nitro.options.replace` in the evlog Nitro\n// modules. Outside of a Nitro build, this identifier is undeclared and the\n// `typeof` guard below evaluates safely.\n// eslint-disable-next-line @typescript-eslint/naming-convention\ndeclare const __EVLOG_CONFIG__: EvlogConfig | undefined\n\n/** Build-time inlined config, or `undefined` if the bundle was not produced by an evlog Nitro module. */\nexport function readEvlogConfigFromInline(): EvlogConfig | undefined {\n  if (typeof __EVLOG_CONFIG__ === 'undefined') return undefined\n  if (__EVLOG_CONFIG__ === null || typeof __EVLOG_CONFIG__ !== 'object') return undefined\n  return __EVLOG_CONFIG__\n}\n\ntype NitroMajor = 'v2' | 'v3'\n\nlet activeNitroRuntime: NitroMajor | undefined\n\n/**\n * Declare the active Nitro major version so adapters never probe the other\n * version's modules at runtime. The evlog Nitro plugins call this in their\n * first synchronous statement.\n *\n * Bun's auto-install behavior writes to `node_modules/.cache` whenever a\n * dynamic import targets a missing package, which crashes on Vercel's\n * read-only function filesystem. Restricting probes to the runtime that is\n * actually installed avoids that path entirely.\n */\nexport function setActiveNitroRuntime(version: NitroMajor): void {\n  activeNitroRuntime = version\n}\n\n/** @internal Reset the active runtime declaration. Used by tests only. */\nexport function resetActiveNitroRuntime(): void {\n  activeNitroRuntime = undefined\n}\n\ntype NitroRuntimeConfigModule = {\n  useRuntimeConfig: () => Record<string, any>\n}\n\nfunction nitroV3RuntimeConfigSpecifier(): string {\n  return ['nitro', 'runtime-config'].join('/')\n}\n\nfunction nitropackRuntimeSpecifier(): string {\n  return ['nitropack', 'runtime'].join('/')\n}\n\nfunction nitropackInternalRuntimeConfigSpecifier(): string {\n  return ['nitropack', 'runtime', 'internal', 'config'].join('/')\n}\n\nasync function importOrNull(specifier: string): Promise<unknown> {\n  try {\n    return await import(specifier)\n  } catch {\n    return null\n  }\n}\n\nfunction isRuntimeConfigModule(mod: unknown): mod is NitroRuntimeConfigModule {\n  return (\n    typeof mod === 'object'\n    && mod !== null\n    && 'useRuntimeConfig' in mod\n    && typeof (mod as NitroRuntimeConfigModule).useRuntimeConfig === 'function'\n  )\n}\n\n/** Snapshot from env, or `undefined` if unset / invalid JSON. */\nexport function readEvlogConfigFromNitroEnv(): EvlogConfig | undefined {\n  const raw = process.env[EVLOG_NITRO_ENV]\n  if (raw === undefined || raw === '') return undefined\n  try {\n    return JSON.parse(raw) as EvlogConfig\n  } catch {\n    return undefined\n  }\n}\n\nlet cachedNitropackRuntime: NitroRuntimeConfigModule | null | undefined\nlet cachedNitroV3Runtime: NitroRuntimeConfigModule | null | undefined\nlet cachedNitropackInternalConfig: NitroRuntimeConfigModule | null | undefined\n\nasync function getNitropackRuntime(): Promise<NitroRuntimeConfigModule | null> {\n  if (cachedNitropackRuntime !== undefined) return cachedNitropackRuntime\n  const mod = await importOrNull(nitropackRuntimeSpecifier())\n  cachedNitropackRuntime = isRuntimeConfigModule(mod) ? mod : null\n  return cachedNitropackRuntime\n}\n\nasync function getNitroV3Runtime(): Promise<NitroRuntimeConfigModule | null> {\n  if (cachedNitroV3Runtime !== undefined) return cachedNitroV3Runtime\n  const mod = await importOrNull(nitroV3RuntimeConfigSpecifier())\n  cachedNitroV3Runtime = isRuntimeConfigModule(mod) ? mod : null\n  return cachedNitroV3Runtime\n}\n\nasync function getNitropackInternalRuntimeConfig(): Promise<NitroRuntimeConfigModule | null> {\n  if (cachedNitropackInternalConfig !== undefined) return cachedNitropackInternalConfig\n  const mod = await importOrNull(nitropackInternalRuntimeConfigSpecifier())\n  cachedNitropackInternalConfig = isRuntimeConfigModule(mod) ? mod : null\n  return cachedNitropackInternalConfig\n}\n\nfunction evlogSlice(config: Record<string, any>): EvlogConfig | undefined {\n  const { evlog } = config\n  if (evlog && typeof evlog === 'object') return evlog as EvlogConfig\n  return undefined\n}\n\n/**\n * Options for evlog Nitro plugins (nitropack v2 and Nitro v3).\n *\n * Lookup order:\n * 1. `__EVLOG_CONFIG__` — inlined at build time by the evlog Nitro module.\n *    Hits in every deployed bundle and skips runtime probing entirely.\n * 2. `process.env.__EVLOG_CONFIG`\n * 3. The active runtime declared by {@link setActiveNitroRuntime} — either\n *    Nitro v3 `runtime-config` or nitropack internal config, never both.\n * 4. When no active runtime has been declared (standalone use): probe v3 then\n *    nitropack v2 as a best-effort fallback.\n */\nexport async function resolveEvlogConfigForNitroPlugin(): Promise<EvlogConfig | undefined> {\n  const fromInline = readEvlogConfigFromInline()\n  if (fromInline !== undefined) return fromInline\n\n  const fromEnv = readEvlogConfigFromNitroEnv()\n  if (fromEnv !== undefined) return fromEnv\n\n  if (activeNitroRuntime === 'v3') {\n    const v3 = await getNitroV3Runtime()\n    if (v3) {\n      const slice = evlogSlice(v3.useRuntimeConfig())\n      if (slice !== undefined) return slice\n    }\n    return undefined\n  }\n\n  if (activeNitroRuntime === 'v2') {\n    const internal = await getNitropackInternalRuntimeConfig()\n    if (internal) {\n      const slice = evlogSlice(internal.useRuntimeConfig())\n      if (slice !== undefined) return slice\n    }\n    return undefined\n  }\n\n  const v3 = await getNitroV3Runtime()\n  if (v3) {\n    const slice = evlogSlice(v3.useRuntimeConfig())\n    if (slice !== undefined) return slice\n  }\n\n  const internal = await getNitropackInternalRuntimeConfig()\n  if (internal) {\n    const slice = evlogSlice(internal.useRuntimeConfig())\n    if (slice !== undefined) return slice\n  }\n\n  return undefined\n}\n\n/**\n * Full `useRuntimeConfig()` object for drain adapters.\n *\n * Honors {@link setActiveNitroRuntime}: when a Nitro plugin has declared its\n * version, only that version's runtime module is probed. When no version has\n * been declared (standalone use outside Nitro), falls back to the historical\n * order: nitropack v2 first, then Nitro v3.\n *\n * When `__EVLOG_CONFIG__` was inlined at build time, returns a synthetic\n * `{ evlog: <inlined> }` record so adapters can read `runtimeConfig.evlog.*`\n * without triggering the dynamic import (issue #312).\n */\nexport async function getNitroRuntimeConfigRecord(): Promise<Record<string, any> | undefined> {\n  const inline = readEvlogConfigFromInline()\n  if (inline !== undefined) return { evlog: inline }\n\n  if (activeNitroRuntime === 'v3') {\n    const v3 = await getNitroV3Runtime()\n    return v3 ? v3.useRuntimeConfig() : undefined\n  }\n\n  if (activeNitroRuntime === 'v2') {\n    const nitropack = await getNitropackRuntime()\n    return nitropack ? nitropack.useRuntimeConfig() : undefined\n  }\n\n  const nitropack = await getNitropackRuntime()\n  if (nitropack) return nitropack.useRuntimeConfig()\n\n  const v3 = await getNitroV3Runtime()\n  if (v3) return v3.useRuntimeConfig()\n\n  return undefined\n}\n"],"mappings":";AA8BA,MAAM,kBAAkB;;AASxB,SAAgB,4BAAqD;AACnE,KAAI,OAAO,qBAAqB,YAAa,QAAO,KAAA;AACpD,KAAI,qBAAqB,QAAQ,OAAO,qBAAqB,SAAU,QAAO,KAAA;AAC9E,QAAO;;AAKT,IAAI;;;;;;;;;;;AAYJ,SAAgB,sBAAsB,SAA2B;AAC/D,sBAAqB;;AAYvB,SAAS,gCAAwC;AAC/C,QAAO,CAAC,SAAS,iBAAiB,CAAC,KAAK,IAAI;;AAG9C,SAAS,4BAAoC;AAC3C,QAAO,CAAC,aAAa,UAAU,CAAC,KAAK,IAAI;;AAG3C,SAAS,0CAAkD;AACzD,QAAO;EAAC;EAAa;EAAW;EAAY;EAAS,CAAC,KAAK,IAAI;;AAGjE,eAAe,aAAa,WAAqC;AAC/D,KAAI;AACF,SAAO,MAAM,OAAO;SACd;AACN,SAAO;;;AAIX,SAAS,sBAAsB,KAA+C;AAC5E,QACE,OAAO,QAAQ,YACZ,QAAQ,QACR,sBAAsB,OACtB,OAAQ,IAAiC,qBAAqB;;;AAKrE,SAAgB,8BAAuD;CACrE,MAAM,MAAM,QAAQ,IAAI;AACxB,KAAI,QAAQ,KAAA,KAAa,QAAQ,GAAI,QAAO,KAAA;AAC5C,KAAI;AACF,SAAO,KAAK,MAAM,IAAI;SAChB;AACN;;;AAIJ,IAAI;AACJ,IAAI;AACJ,IAAI;AAEJ,eAAe,sBAAgE;AAC7E,KAAI,2BAA2B,KAAA,EAAW,QAAO;CACjD,MAAM,MAAM,MAAM,aAAa,2BAA2B,CAAC;AAC3D,0BAAyB,sBAAsB,IAAI,GAAG,MAAM;AAC5D,QAAO;;AAGT,eAAe,oBAA8D;AAC3E,KAAI,yBAAyB,KAAA,EAAW,QAAO;CAC/C,MAAM,MAAM,MAAM,aAAa,+BAA+B,CAAC;AAC/D,wBAAuB,sBAAsB,IAAI,GAAG,MAAM;AAC1D,QAAO;;AAGT,eAAe,oCAA8E;AAC3F,KAAI,kCAAkC,KAAA,EAAW,QAAO;CACxD,MAAM,MAAM,MAAM,aAAa,yCAAyC,CAAC;AACzE,iCAAgC,sBAAsB,IAAI,GAAG,MAAM;AACnE,QAAO;;AAGT,SAAS,WAAW,QAAsD;CACxE,MAAM,EAAE,UAAU;AAClB,KAAI,SAAS,OAAO,UAAU,SAAU,QAAO;;;;;;;;;;;;;;AAgBjD,eAAsB,mCAAqE;CACzF,MAAM,aAAa,2BAA2B;AAC9C,KAAI,eAAe,KAAA,EAAW,QAAO;CAErC,MAAM,UAAU,6BAA6B;AAC7C,KAAI,YAAY,KAAA,EAAW,QAAO;AAElC,KAAI,uBAAuB,MAAM;EAC/B,MAAM,KAAK,MAAM,mBAAmB;AACpC,MAAI,IAAI;GACN,MAAM,QAAQ,WAAW,GAAG,kBAAkB,CAAC;AAC/C,OAAI,UAAU,KAAA,EAAW,QAAO;;AAElC;;AAGF,KAAI,uBAAuB,MAAM;EAC/B,MAAM,WAAW,MAAM,mCAAmC;AAC1D,MAAI,UAAU;GACZ,MAAM,QAAQ,WAAW,SAAS,kBAAkB,CAAC;AACrD,OAAI,UAAU,KAAA,EAAW,QAAO;;AAElC;;CAGF,MAAM,KAAK,MAAM,mBAAmB;AACpC,KAAI,IAAI;EACN,MAAM,QAAQ,WAAW,GAAG,kBAAkB,CAAC;AAC/C,MAAI,UAAU,KAAA,EAAW,QAAO;;CAGlC,MAAM,WAAW,MAAM,mCAAmC;AAC1D,KAAI,UAAU;EACZ,MAAM,QAAQ,WAAW,SAAS,kBAAkB,CAAC;AACrD,MAAI,UAAU,KAAA,EAAW,QAAO;;;;;;;;;;;;;;;AAkBpC,eAAsB,8BAAwE;CAC5F,MAAM,SAAS,2BAA2B;AAC1C,KAAI,WAAW,KAAA,EAAW,QAAO,EAAE,OAAO,QAAQ;AAElD,KAAI,uBAAuB,MAAM;EAC/B,MAAM,KAAK,MAAM,mBAAmB;AACpC,SAAO,KAAK,GAAG,kBAAkB,GAAG,KAAA;;AAGtC,KAAI,uBAAuB,MAAM;EAC/B,MAAM,YAAY,MAAM,qBAAqB;AAC7C,SAAO,YAAY,UAAU,kBAAkB,GAAG,KAAA;;CAGpD,MAAM,YAAY,MAAM,qBAAqB;AAC7C,KAAI,UAAW,QAAO,UAAU,kBAAkB;CAElD,MAAM,KAAK,MAAM,mBAAmB;AACpC,KAAI,GAAI,QAAO,GAAG,kBAAkB"}

package/dist/nodeResponse-BkkionWl.mjs

@@ -0,0 +1,42 @@
+//#region src/shared/nodeResponse.ts
+/**
+* Bind an evlog middleware {@link MiddlewareLoggerResult.finish | `finish()`}
+* to a Node {@link ServerResponse} lifecycle.
+*
+* Listens to **both** `finish` (response fully transmitted) and `close`
+* (underlying socket closed — including client disconnects mid-response).
+* Idempotent: only the first event to fire calls `finish()`.
+*
+* When `close` fires before `finish`, the client disconnected before the
+* response could complete. In that case the wide event is marked with
+* `connectionClosed: true` so disconnects are observable in the drain.
+*
+* @remarks
+* For background work that must outlive the HTTP response (e.g. resumable
+* streams, post-response usage accounting), use
+* {@link RequestLogger.fork | `req.log.fork(label, fn)`} instead of mutating
+* the request logger after the response has closed — once `finish()` has run,
+* the request logger is sealed.
+*
+* @internal Used by the Express and NestJS integrations.
+*/
+function bindNodeResponseLifecycle(res, logger, finish) {
+	let settled = false;
+	const onFinish = () => {
+		if (settled) return;
+		settled = true;
+		finish({ status: res.statusCode }).catch(() => {});
+	};
+	const onClose = () => {
+		if (settled) return;
+		settled = true;
+		logger.set({ connectionClosed: true });
+		finish({ status: res.statusCode }).catch(() => {});
+	};
+	res.once("finish", onFinish);
+	res.once("close", onClose);
+}
+//#endregion
+export { bindNodeResponseLifecycle as t };
+
+//# sourceMappingURL=nodeResponse-BkkionWl.mjs.map

package/dist/nodeResponse-BkkionWl.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"nodeResponse-BkkionWl.mjs","names":[],"sources":["../src/shared/nodeResponse.ts"],"sourcesContent":["import type { ServerResponse } from 'node:http'\nimport type { RequestLogger } from '../types'\nimport type { MiddlewareLoggerResult } from './middleware'\n\n/**\n * Bind an evlog middleware {@link MiddlewareLoggerResult.finish | `finish()`}\n * to a Node {@link ServerResponse} lifecycle.\n *\n * Listens to **both** `finish` (response fully transmitted) and `close`\n * (underlying socket closed — including client disconnects mid-response).\n * Idempotent: only the first event to fire calls `finish()`.\n *\n * When `close` fires before `finish`, the client disconnected before the\n * response could complete. In that case the wide event is marked with\n * `connectionClosed: true` so disconnects are observable in the drain.\n *\n * @remarks\n * For background work that must outlive the HTTP response (e.g. resumable\n * streams, post-response usage accounting), use\n * {@link RequestLogger.fork | `req.log.fork(label, fn)`} instead of mutating\n * the request logger after the response has closed — once `finish()` has run,\n * the request logger is sealed.\n *\n * @internal Used by the Express and NestJS integrations.\n */\nexport function bindNodeResponseLifecycle(\n  res: ServerResponse,\n  logger: RequestLogger,\n  finish: MiddlewareLoggerResult['finish'],\n): void {\n  let settled = false\n\n  const onFinish = (): void => {\n    if (settled) return\n    settled = true\n    finish({ status: res.statusCode }).catch(() => {})\n  }\n\n  const onClose = (): void => {\n    if (settled) return\n    settled = true\n    logger.set({ connectionClosed: true })\n    finish({ status: res.statusCode }).catch(() => {})\n  }\n\n  res.once('finish', onFinish)\n  res.once('close', onClose)\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;AAyBA,SAAgB,0BACd,KACA,QACA,QACM;CACN,IAAI,UAAU;CAEd,MAAM,iBAAuB;AAC3B,MAAI,QAAS;AACb,YAAU;AACV,SAAO,EAAE,QAAQ,IAAI,YAAY,CAAC,CAAC,YAAY,GAAG;;CAGpD,MAAM,gBAAsB;AAC1B,MAAI,QAAS;AACb,YAAU;AACV,SAAO,IAAI,EAAE,kBAAkB,MAAM,CAAC;AACtC,SAAO,EAAE,QAAQ,IAAI,YAAY,CAAC,CAAC,YAAY,GAAG;;AAGpD,KAAI,KAAK,UAAU,SAAS;AAC5B,KAAI,KAAK,SAAS,QAAQ"}

package/dist/nuxt/module.d.mts

@@ -1,12 +1,17 @@
-import { L as EnvironmentContext, Q as SamplingConfig, W as LogLevel, Z as RouteConfig, q as RedactConfig, rt as TransportConfig } from "../audit-X1uUukm3.mjs";
+import { K as LogLevel, R as EnvironmentContext, Y as RedactConfig, nt as SamplingConfig, st as TransportConfig, tt as RouteConfig } from "../audit-DVdkntSO.mjs";
+import { StreamServerOptions } from "../stream.mjs";
 import * as _$_nuxt_schema0 from "@nuxt/schema";
 
 //#region src/nuxt/module.d.ts
 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 */
@@ -124,6 +129,32 @@ interface ModuleOptions {
    * ```
    */
   transport?: TransportConfig;
+  /**
+   * Live stream of wide events, exposed by a small local HTTP server on
+   * an ephemeral port. Any consumer (browser tab, CLI, devtool) can
+   * subscribe via Server-Sent Events. The URL is printed at startup and
+   * written to `.evlog/stream.url`.
+   *
+   * Strict opt-in — nothing starts unless this is set.
+   *
+   * - `true` — enable with defaults
+   * - `false` — off (same as omitting)
+   * - `StreamServerOptions` — full config (port, host, token, ...)
+   * - `undefined` (default) — off
+   *
+   * Local-only: binds to `127.0.0.1` and does not work on serverless
+   * platforms (each invocation is isolated).
+   *
+   * @example
+   * ```ts
+   * // Enable with defaults
+   * evlog: { stream: true }
+   *
+   * // Custom port + auth token
+   * evlog: { stream: { port: 4317, token: process.env.EVLOG_STREAM_TOKEN } }
+   * ```
+   */
+  stream?: boolean | StreamServerOptions;
   /**
    * Axiom adapter configuration.
    * When configured, use `createAxiomDrain()` from `evlog/axiom` to send logs.
@@ -132,7 +163,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;EAFQ;EAIR,KAAA;;EAEA,KAAA;EAJA;EAMA,OAAA;AAAA;AAAA,UAGQ,qBAAA;EAHD;;AAAA;;;EASP,OAAA;EAEO;EAAP,OAAA;AAAA;AAAA,UAGQ,yBAAA;EAER;EAAA,OAAA;EAKG;EAHH,OAAA;AAAA;AAAA,KAGG,iBAAA,GAAoB,qBAAA,IAAyB,qBAAA,GAAwB,yBAAA;AAAA,UAEzD,aAAA;EAFyD;;;;;EAQxE,OAAA;EARiG;;AAEnG;EAWE,GAAA,GAAM,OAAA,CAAQ,kBAAA;;;;;;;EAQd,OAAA;EAqFY;;;;EA/EZ,MAAA;EAyLmB;;;;;;;EAhLnB,MAAA;EAfA;;;;;;EAuBA,OAAA;EAuBwB;;;;;;EAfxB,OAAA;EAoEA;;;;;;;;;;;;;EArDA,MAAA,GAAS,MAAA,SAAe,WAAA;EAkHxB;;;;;;;;;;;;;;;AAqDD;EArJC,QAAA,GAAW,cAAA;;;;;;EAOX,QAAA,GAAW,QAAA;;;;;;;;;;;;;EAcX,SAAA,GAAY,eAAA;;;;;;;;;;;;;EAcZ,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":";;;;;UAgBU,qBAAA;;EAER,OAAA;;EAEA,MAAA;EAJ6B;;;EAQ7B,KAAA;EAJA;EAMA,KAAA;EAAA;EAEA,OAAA;AAAA;AAAA,UAGQ,qBAAA;EAAA;;;;;EAMR,OAAA;EAKiC;EAHjC,OAAA;AAAA;AAAA,UAGQ,yBAAA;EAOL;EALH,OAAA;;EAEA,OAAA;AAAA;AAAA,KAGG,iBAAA,GAAoB,qBAAA,IAAyB,qBAAA,GAAwB,yBAAA;AAAA,UAEzD,aAAA;EAFkF;;;;;EAQjG,OAAA;EANe;;;EAWf,GAAA,GAAM,OAAA,CAAQ,kBAAA;EAAR;;;;;;EAQN,OAAA;EA8HQ;;;;EAxHR,MAAA;EA0NQ;;;;;;;EAjNR,MAAA;EATA;;;;;;EAiBA,OAAA;EAyCA;;;;;;EAjCA,OAAA;EAiFM;;;;;;;;;;;;;EAlEN,MAAA,GAAS,MAAA,SAAe,WAAA;EA+HtB;;;;;;;;;;;;;;;;EA7GF,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,13 +1,11 @@
 import { n as createStripPlugin, t as createSourceLocationPlugin } from "../source-location-Dco0cRTz.mjs";
+import { n as version, t as name } from "../package-B23bR3tK.mjs";
 import { addImports, addPlugin, addServerHandler, addServerImports, addServerPlugin, addVitePlugin, createResolver, defineNuxtModule } from "@nuxt/kit";
-//#region package.json
-var name = "evlog";
-//#endregion
 //#region src/nuxt/module.ts
 var module_default = defineNuxtModule({
 	meta: {
 		name,
-		version: "2.16.0",
+		version,
 		configKey: name,
 		docs: "https://evlog.dev"
 	},
@@ -17,6 +15,10 @@ var module_default = defineNuxtModule({
 		const transportEnabled = options.transport?.enabled ?? false;
 		const transportEndpoint = options.transport?.endpoint ?? "/api/_evlog/ingest";
 		const transportCredentials = options.transport?.credentials ?? "same-origin";
+		const streamRaw = options.stream;
+		const normalizedStream = streamRaw === true ? true : streamRaw && typeof streamRaw === "object" ? streamRaw : false;
+		const streamEnabled = normalizedStream !== false;
+		options.stream = normalizedStream;
 		nuxt.options.runtimeConfig.evlog = options;
 		nuxt.hook("nitro:config", (nitroConfig) => {
 			nitroConfig.errorHandler = nitroConfig.errorHandler || resolver.resolve("../nitro/errorHandler");
@@ -39,6 +41,11 @@ var module_default = defineNuxtModule({
 			method: "post",
 			handler: resolver.resolve("../runtime/server/routes/_evlog/ingest.post")
 		});
+		if (streamEnabled) addServerHandler({
+			route: "/api/_evlog/stream-info",
+			method: "get",
+			handler: resolver.resolve("../runtime/server/routes/_evlog/stream-info.get")
+		});
 		addServerPlugin(resolver.resolve("../nitro/plugin"));
 		addPlugin({
 			src: resolver.resolve("../runtime/client/plugin"),

package/dist/nuxt/module.mjs.map

@@ -1 +1 @@
-{"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  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   * 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    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    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":";;;;;;ACyRA,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;AAE/D,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,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 { 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   * 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      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":";;;;AAwTA,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"}

package/dist/orpc/index.d.mts

@@ -0,0 +1,115 @@
+import { $ as RequestLogger } from "../audit-DVdkntSO.mjs";
+import { t as BaseEvlogOptions } from "../middleware-31KhtiEF.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;;;;;;;;;;;;;;;;;;AA0EA;;;;;iBA1EgB,SAAA,kBAA2B,oBAAA,CAAA,CACzC,OAAA,EAAS,QAAA,EACT,OAAA,GAAS,gBAAA,GACR,QAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAuEa,KAAA,kBAAuB,OAAA,CAAQ,gBAAA,IAAoB,OAAA,GAAU,gBAAA,CAAA,CAAA,IAEzE,OAAA,EAAS,iBAAA,CAAkB,QAAA,yBAC1B,OAAA,CAAQ,gBAAA,CAAiB,MAAA"}