evlog 1.6.0 → 1.8.0

package/dist/nitro/v3/plugin.mjs

@@ -0,0 +1,157 @@
+import { filterSafeHeaders } from "../../utils.mjs";
+import { createRequestLogger, initLogger, isEnabled } from "../../logger.mjs";
+import { a as shouldLog, n as getServiceForPath, t as extractErrorStatus } from "../../nitro-D57TWGyN.mjs";
+import { definePlugin } from "nitro";
+import { useRuntimeConfig } from "nitro/runtime-config";
+import { parseURL } from "ufo";
+
+//#region src/nitro-v3/plugin.ts
+function getContext(event) {
+	if (!event.req.context) event.req.context = {};
+	return event.req.context;
+}
+function getSafeRequestHeaders(event) {
+	const headers = {};
+	event.req.headers.forEach((value, key) => {
+		headers[key] = value;
+	});
+	return filterSafeHeaders(headers);
+}
+function getSafeResponseHeaders(res) {
+	const headers = {};
+	res.headers.forEach((value, key) => {
+		headers[key] = value;
+	});
+	if (Object.keys(headers).length === 0) return void 0;
+	return filterSafeHeaders(headers);
+}
+function buildHookContext(event, res) {
+	const { pathname } = parseURL(event.req.url);
+	const responseHeaders = res ? getSafeResponseHeaders(res) : void 0;
+	return {
+		request: {
+			method: event.req.method,
+			path: pathname
+		},
+		headers: getSafeRequestHeaders(event),
+		response: {
+			status: res?.status ?? 200,
+			headers: responseHeaders
+		}
+	};
+}
+function callDrainHook(hooks, emittedEvent, event, hookContext) {
+	if (!emittedEvent) return;
+	let drainPromise;
+	try {
+		drainPromise = hooks.callHook("evlog:drain", {
+			event: emittedEvent,
+			request: hookContext.request,
+			headers: hookContext.headers
+		});
+	} catch (err) {
+		console.error("[evlog] drain failed:", err);
+	}
+	if (drainPromise && typeof event.req.waitUntil === "function") event.req.waitUntil(drainPromise);
+}
+async function callEnrichAndDrain(hooks, emittedEvent, event, res) {
+	if (!emittedEvent) return;
+	const hookContext = buildHookContext(event, res);
+	try {
+		await hooks.callHook("evlog:enrich", {
+			event: emittedEvent,
+			...hookContext
+		});
+	} catch (err) {
+		console.error("[evlog] enrich failed:", err);
+	}
+	callDrainHook(hooks, emittedEvent, event, hookContext);
+}
+/**
+* Nitro v3 plugin entry point.
+*
+* Usage in Nitro v3:
+* ```ts
+* // plugins/evlog.ts
+* export { default } from 'evlog/nitro/v3'
+* ```
+*/
+var plugin_default = definePlugin((nitroApp) => {
+	const evlogConfig = useRuntimeConfig().evlog ?? (process.env.__EVLOG_CONFIG ? JSON.parse(process.env.__EVLOG_CONFIG) : void 0);
+	initLogger({
+		enabled: evlogConfig?.enabled,
+		env: evlogConfig?.env,
+		pretty: evlogConfig?.pretty,
+		sampling: evlogConfig?.sampling
+	});
+	if (!isEnabled()) return;
+	const hooks = nitroApp.hooks;
+	hooks.hook("request", (event) => {
+		const { pathname } = parseURL(event.req.url);
+		if (!shouldLog(pathname, evlogConfig?.include, evlogConfig?.exclude)) return;
+		const ctx = getContext(event);
+		ctx._evlogStartTime = Date.now();
+		let requestIdOverride = void 0;
+		if (globalThis.navigator?.userAgent === "Cloudflare-Workers") {
+			const cfRay = event.req.headers.get("cf-ray");
+			if (cfRay) requestIdOverride = cfRay;
+		}
+		const log = createRequestLogger({
+			method: event.req.method,
+			path: pathname,
+			requestId: requestIdOverride || ctx.requestId || crypto.randomUUID()
+		});
+		const routeService = getServiceForPath(pathname, evlogConfig?.routes);
+		if (routeService) log.set({ service: routeService });
+		ctx.log = log;
+	});
+	hooks.hook("response", async (res, event) => {
+		const ctx = event.req.context;
+		if (ctx?._evlogEmitted) return;
+		const log = ctx?.log;
+		if (!log || !ctx) return;
+		const { status } = res;
+		log.set({ status });
+		const startTime = ctx._evlogStartTime;
+		const durationMs = startTime ? Date.now() - startTime : void 0;
+		const { pathname } = parseURL(event.req.url);
+		const tailCtx = {
+			status,
+			duration: durationMs,
+			path: pathname,
+			method: event.req.method,
+			context: log.getContext(),
+			shouldKeep: false
+		};
+		await hooks.callHook("evlog:emit:keep", tailCtx);
+		await callEnrichAndDrain(hooks, log.emit({ _forceKeep: tailCtx.shouldKeep }), event, res);
+	});
+	hooks.hook("error", async (error, { event }) => {
+		if (!event) return;
+		const e = event;
+		const ctx = e.req.context;
+		const log = ctx?.log;
+		if (!log || !ctx) return;
+		const actualError = error.cause?.name === "EvlogError" ? error.cause : error;
+		log.error(actualError);
+		const errorStatus = extractErrorStatus(actualError);
+		log.set({ status: errorStatus });
+		const { pathname } = parseURL(e.req.url);
+		const startTime = ctx._evlogStartTime;
+		const tailCtx = {
+			status: errorStatus,
+			duration: startTime ? Date.now() - startTime : void 0,
+			path: pathname,
+			method: e.req.method,
+			context: log.getContext(),
+			shouldKeep: false
+		};
+		await hooks.callHook("evlog:emit:keep", tailCtx);
+		ctx._evlogEmitted = true;
+		await callEnrichAndDrain(hooks, log.emit({ _forceKeep: tailCtx.shouldKeep }), e);
+	});
+});
+
+//#endregion
+export { plugin_default as default };
+//# sourceMappingURL=plugin.mjs.map

package/dist/nitro/v3/plugin.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.mjs","names":[],"sources":["../../../src/nitro-v3/plugin.ts"],"sourcesContent":["import { definePlugin } from 'nitro'\nimport { useRuntimeConfig } from 'nitro/runtime-config'\nimport type { CaptureError } from 'nitro/types'\nimport type { HTTPEvent } from 'nitro/h3'\nimport { parseURL } from 'ufo'\nimport { createRequestLogger, initLogger, isEnabled } from '../logger'\nimport { shouldLog, getServiceForPath, extractErrorStatus } from '../nitro'\nimport type { EvlogConfig } from '../nitro'\nimport type { EnrichContext, RequestLogger, TailSamplingContext, WideEvent } from '../types'\nimport { filterSafeHeaders } from '../utils'\n\n// Nitro v3 doesn't fully export hook types yet\n// https://github.com/nitrojs/nitro/blob/8882bc9e1dbf2d342e73097f22a2156f70f50575/src/types/runtime/nitro.ts#L48-L53\ninterface NitroV3Hooks {\n  close: () => void\n  error: CaptureError\n  request: (event: HTTPEvent) => void | Promise<void>\n  response: (res: Response, event: HTTPEvent) => void | Promise<void>\n  'evlog:emit:keep': (ctx: TailSamplingContext) => void | Promise<void>\n  'evlog:enrich': (ctx: EnrichContext) => void | Promise<void>\n  'evlog:drain': (ctx: { event: WideEvent; request?: { method?: string; path: string; requestId?: string }; headers?: Record<string, string> }) => void | Promise<void>\n}\n\ntype Hooks = {\n  hook: <T extends keyof NitroV3Hooks>(name: T, listener: NitroV3Hooks[T]) => void\n  callHook: <T extends keyof NitroV3Hooks>(name: T, ...args: Parameters<NitroV3Hooks[T]>) => Promise<void>\n}\n\nfunction getContext(event: HTTPEvent): Record<string, unknown> {\n  if (!event.req.context) {\n    event.req.context = {}\n  }\n  return event.req.context\n}\n\nfunction getSafeRequestHeaders(event: HTTPEvent): Record<string, string> {\n  const headers: Record<string, string> = {}\n  event.req.headers.forEach((value, key) => {\n    headers[key] = value\n  })\n  return filterSafeHeaders(headers)\n}\n\nfunction getSafeResponseHeaders(res: Response): Record<string, string> | undefined {\n  const headers: Record<string, string> = {}\n  res.headers.forEach((value, key) => {\n    headers[key] = value\n  })\n  if (Object.keys(headers).length === 0) return undefined\n  return filterSafeHeaders(headers)\n}\n\nfunction buildHookContext(\n  event: HTTPEvent,\n  res?: Response,\n): Omit<EnrichContext, 'event'> {\n  const { pathname } = parseURL(event.req.url)\n  const responseHeaders = res ? getSafeResponseHeaders(res) : undefined\n  return {\n    request: { method: event.req.method, path: pathname },\n    headers: getSafeRequestHeaders(event),\n    response: {\n      status: res?.status ?? 200,\n      headers: responseHeaders,\n    },\n  }\n}\n\nfunction callDrainHook(\n  hooks: Hooks,\n  emittedEvent: WideEvent | null,\n  event: HTTPEvent,\n  hookContext: Omit<EnrichContext, 'event'>,\n): void {\n  if (!emittedEvent) return\n  let drainPromise: Promise<any> | undefined\n  try {\n    drainPromise = hooks.callHook('evlog:drain', {\n      event: emittedEvent,\n      request: hookContext.request,\n      headers: hookContext.headers,\n    })\n  } catch (err) {\n    console.error('[evlog] drain failed:', err)\n  }\n\n  // Use waitUntil if available (srvx native — Cloudflare Workers, Vercel Edge, etc.)\n  // This ensures drains complete before the runtime terminates\n  if (drainPromise && typeof event.req.waitUntil === 'function') {\n    event.req.waitUntil(drainPromise)\n  }\n}\n\nasync function callEnrichAndDrain(\n  hooks: Hooks,\n  emittedEvent: WideEvent | null,\n  event: HTTPEvent,\n  res?: Response,\n): Promise<void> {\n  if (!emittedEvent) return\n\n  const hookContext = buildHookContext(event, res)\n\n  try {\n    await hooks.callHook('evlog:enrich', { event: emittedEvent, ...hookContext })\n  } catch (err) {\n    console.error('[evlog] enrich failed:', err)\n  }\n\n  callDrainHook(hooks, emittedEvent, event, hookContext)\n}\n\n/**\n * Nitro v3 plugin entry point.\n *\n * Usage in Nitro v3:\n * ```ts\n * // plugins/evlog.ts\n * export { default } from 'evlog/nitro/v3'\n * ```\n */\nexport default definePlugin((nitroApp) => {\n  // In production builds the plugin is bundled and useRuntimeConfig()\n  // resolves the virtual module correctly. In dev mode the plugin is\n  // loaded externally so useRuntimeConfig() returns a stub — fall back\n  // to the env var bridge set by the module.\n  const evlogConfig = (useRuntimeConfig().evlog ?? (process.env.__EVLOG_CONFIG ? JSON.parse(process.env.__EVLOG_CONFIG) : undefined)) as EvlogConfig | undefined\n\n  initLogger({\n    enabled: evlogConfig?.enabled,\n    env: evlogConfig?.env,\n    pretty: evlogConfig?.pretty,\n    sampling: evlogConfig?.sampling,\n  })\n\n  if (!isEnabled()) return\n\n  const hooks = nitroApp.hooks as unknown as Hooks\n\n  hooks.hook('request', (event) => {\n    const { pathname } = parseURL(event.req.url)\n\n    // Skip logging for routes not matching include/exclude patterns\n    if (!shouldLog(pathname, evlogConfig?.include, evlogConfig?.exclude)) {\n      return\n    }\n\n    const ctx = getContext(event)\n\n    // Store start time for duration calculation in tail sampling\n    ctx._evlogStartTime = Date.now()\n\n    let requestIdOverride: string | undefined = undefined\n    if (globalThis.navigator?.userAgent === 'Cloudflare-Workers') {\n      const cfRay = event.req.headers.get('cf-ray')\n      if (cfRay) requestIdOverride = cfRay\n    }\n\n    const log = createRequestLogger({\n      method: event.req.method,\n      path: pathname,\n      requestId: requestIdOverride || ctx.requestId as string | undefined || crypto.randomUUID(),\n    })\n\n    // Apply route-based service configuration if a matching route is found\n    const routeService = getServiceForPath(pathname, evlogConfig?.routes)\n    if (routeService) {\n      log.set({ service: routeService })\n    }\n\n    ctx.log = log\n  })\n\n  hooks.hook('response', async (res, event) => {\n    const ctx = event.req.context\n    // Skip if already emitted by error hook\n    if (ctx?._evlogEmitted) return\n\n    const log = ctx?.log as RequestLogger | undefined\n    if (!log || !ctx) return\n\n    const { status } = res\n    log.set({ status })\n\n    const startTime = ctx._evlogStartTime as number | undefined\n    const durationMs = startTime ? Date.now() - startTime : undefined\n\n    const { pathname } = parseURL(event.req.url)\n\n    const tailCtx: TailSamplingContext = {\n      status,\n      duration: durationMs,\n      path: pathname,\n      method: event.req.method,\n      context: log.getContext(),\n      shouldKeep: false,\n    }\n\n    await hooks.callHook('evlog:emit:keep', tailCtx)\n\n    const emittedEvent = log.emit({ _forceKeep: tailCtx.shouldKeep })\n    await callEnrichAndDrain(hooks, emittedEvent, event, res)\n  })\n\n  hooks.hook('error', async (error, { event }) => {\n    if (!event) return\n    const e = event as HTTPEvent\n\n    const ctx = e.req.context\n    const log = ctx?.log as RequestLogger | undefined\n    if (!log || !ctx) return\n\n    // Check if error.cause is an EvlogError (thrown errors get wrapped in HTTPError by nitro)\n    const actualError = (error.cause as Error)?.name === 'EvlogError' \n      ? error.cause as Error \n      : error as Error\n\n    log.error(actualError)\n\n    const errorStatus = extractErrorStatus(actualError)\n    log.set({ status: errorStatus })\n\n    const { pathname } = parseURL(e.req.url)\n    const startTime = ctx._evlogStartTime as number | undefined\n    const durationMs = startTime ? Date.now() - startTime : undefined\n\n    const tailCtx: TailSamplingContext = {\n      status: errorStatus,\n      duration: durationMs,\n      path: pathname,\n      method: e.req.method,\n      context: log.getContext(),\n      shouldKeep: false,\n    }\n\n    await hooks.callHook('evlog:emit:keep', tailCtx)\n\n    ctx._evlogEmitted = true\n\n    const emittedEvent = log.emit({ _forceKeep: tailCtx.shouldKeep })\n    await callEnrichAndDrain(hooks, emittedEvent, e)\n  })\n})\n"],"mappings":"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"}

package/dist/nitro/v3/useLogger.d.mts

@@ -0,0 +1,24 @@
+import { RequestLogger } from "../../types.mjs";
+import { HTTPEvent } from "nitro/h3";
+
+//#region src/nitro-v3/useLogger.d.ts
+/**
+ * Returns the request logger attached to the given Nitro v3 HTTP event.
+ *
+ * @param event - The current HTTPEvent from Nitro v3.
+ * @param service - Optional service name to override the default service.
+ * @returns The request-scoped logger.
+ * @throws Error if the logger is not initialized on the event context.
+ *
+ * @example
+ * import { useLogger } from 'evlog/nitro/v3'
+ *
+ * export default defineHandler((event) => {
+ *   const log = useLogger(event)
+ *   log.set({ foo: 'bar' })
+ * })
+ */
+declare function useLogger<T extends object = Record<string, unknown>>(event: HTTPEvent, service?: string): RequestLogger<T>;
+//#endregion
+export { useLogger };
+//# sourceMappingURL=useLogger.d.mts.map

package/dist/nitro/v3/useLogger.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useLogger.d.mts","names":[],"sources":["../../../src/nitro-v3/useLogger.ts"],"mappings":";;;;;;AAmBA;;;;;;;;;;;;;;iBAAgB,SAAA,oBAA6B,MAAA,kBAAA,CAAyB,KAAA,EAAO,SAAA,EAAW,OAAA,YAAmB,aAAA,CAAc,CAAA"}

package/dist/nitro/v3/useLogger.mjs

@@ -0,0 +1,27 @@
+//#region src/nitro-v3/useLogger.ts
+/**
+* Returns the request logger attached to the given Nitro v3 HTTP event.
+*
+* @param event - The current HTTPEvent from Nitro v3.
+* @param service - Optional service name to override the default service.
+* @returns The request-scoped logger.
+* @throws Error if the logger is not initialized on the event context.
+*
+* @example
+* import { useLogger } from 'evlog/nitro/v3'
+*
+* export default defineHandler((event) => {
+*   const log = useLogger(event)
+*   log.set({ foo: 'bar' })
+* })
+*/
+function useLogger(event, service) {
+	const log = event.req.context?.log;
+	if (!log) throw new Error("[evlog] Logger not initialized. Make sure the evlog Nitro module is registered in nitro.config.ts. Example: modules: [evlog({ env: { service: 'my-app' } })]");
+	if (service) log.set({ service });
+	return log;
+}
+
+//#endregion
+export { useLogger };
+//# sourceMappingURL=useLogger.mjs.map

package/dist/nitro/v3/useLogger.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"useLogger.mjs","names":[],"sources":["../../../src/nitro-v3/useLogger.ts"],"sourcesContent":["import type { HTTPEvent } from 'nitro/h3'\nimport type { RequestLogger } from '../types'\n\n/**\n * Returns the request logger attached to the given Nitro v3 HTTP event.\n *\n * @param event - The current HTTPEvent from Nitro v3.\n * @param service - Optional service name to override the default service.\n * @returns The request-scoped logger.\n * @throws Error if the logger is not initialized on the event context.\n *\n * @example\n * import { useLogger } from 'evlog/nitro/v3'\n *\n * export default defineHandler((event) => {\n *   const log = useLogger(event)\n *   log.set({ foo: 'bar' })\n * })\n */\nexport function useLogger<T extends object = Record<string, unknown>>(event: HTTPEvent, service?: string): RequestLogger<T> {\n  const ctx = event.req.context as Record<string, unknown> | undefined\n  const log = ctx?.log as RequestLogger<T> | undefined\n\n  if (!log) {\n    throw new Error(\n      '[evlog] Logger not initialized. Make sure the evlog Nitro module is registered in nitro.config.ts. '\n      + 'Example: modules: [evlog({ env: { service: \\'my-app\\' } })]',\n    )\n  }\n\n  if (service) {\n    const untyped = log as unknown as RequestLogger\n    untyped.set({ service })\n  }\n\n  return log\n}\n"],"mappings":";;;;;;;;;;;;;;;;;AAmBA,SAAgB,UAAsD,OAAkB,SAAoC;CAE1H,MAAM,MADM,MAAM,IAAI,SACL;AAEjB,KAAI,CAAC,IACH,OAAM,IAAI,MACR,+JAED;AAGH,KAAI,QAEF,CADgB,IACR,IAAI,EAAE,SAAS,CAAC;AAG1B,QAAO"}

package/dist/nitro-D57TWGyN.mjs

@@ -0,0 +1,73 @@
+import { matchesPattern } from "./utils.mjs";
+
+//#region src/nitro.ts
+/**
+* Resolve an EvlogError from an error or its cause chain.
+* Both Nitro v2 (h3) and v3 wrap thrown errors — this unwraps them.
+*/
+function resolveEvlogError(error) {
+	if (error.name === "EvlogError") return error;
+	if (error.cause?.name === "EvlogError") return error.cause;
+	return null;
+}
+/**
+* Extract HTTP status from an error, checking both `status` and `statusCode`.
+*/
+function extractErrorStatus(error) {
+	return error.status ?? error.statusCode ?? 500;
+}
+/**
+* Build a standard evlog error JSON response body.
+* Used by both v2 and v3 error handlers to ensure consistent shape.
+*/
+function serializeEvlogErrorResponse(error, url) {
+	const status = extractErrorStatus(error);
+	const { data } = error;
+	const statusMessage = error.statusMessage || error.message;
+	return {
+		url,
+		status,
+		statusCode: status,
+		statusText: statusMessage,
+		statusMessage,
+		message: error.message,
+		error: true,
+		...data !== void 0 && { data }
+	};
+}
+function shouldLog(path, include, exclude) {
+	if (exclude && exclude.length > 0) {
+		if (exclude.some((pattern) => matchesPattern(path, pattern))) return false;
+	}
+	if (!include || include.length === 0) return true;
+	return include.some((pattern) => matchesPattern(path, pattern));
+}
+/**
+* Find the service name for a given path based on route patterns.
+*
+* When multiple patterns match the same path, the first matching pattern wins
+* based on object iteration order. To ensure predictable behavior, order your
+* route patterns from most specific to most general.
+*
+* @param path - The request path to match
+* @param routes - Route configuration mapping patterns to service names
+* @returns The service name for the matching route, or undefined if no match
+*
+* @example
+* ```ts
+* // Good: specific patterns first, general patterns last
+* routes: {
+*   '/api/auth/admin/**': { service: 'admin-service' },
+*   '/api/auth/**': { service: 'auth-service' },
+*   '/api/**': { service: 'api-service' },
+* }
+* ```
+*/
+function getServiceForPath(path, routes) {
+	if (!routes) return void 0;
+	for (const [pattern, config] of Object.entries(routes)) if (matchesPattern(path, pattern)) return config.service;
+}
+
+//#endregion
+export { shouldLog as a, serializeEvlogErrorResponse as i, getServiceForPath as n, resolveEvlogError as r, extractErrorStatus as t };
+//# sourceMappingURL=nitro-D57TWGyN.mjs.map

package/dist/nitro-D57TWGyN.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"nitro-D57TWGyN.mjs","names":[],"sources":["../src/nitro.ts"],"sourcesContent":["import type { EnvironmentContext, RouteConfig, SamplingConfig } from './types'\nimport { matchesPattern } from './utils'\n\nexport interface NitroModuleOptions {\n  /**\n   * Enable or disable all logging globally.\n   * @default true\n   */\n  enabled?: boolean\n\n  /**\n   * Environment context overrides.\n   */\n  env?: Partial<EnvironmentContext>\n\n  /**\n   * Enable pretty printing.\n   * @default true in development, false in production\n   */\n  pretty?: boolean\n\n  /**\n   * Route patterns to include in logging.\n   * Supports glob patterns like '/api/**'.\n   * If not set, all routes are logged.\n   */\n  include?: string[]\n\n  /**\n   * Route patterns to exclude from logging.\n   * Supports glob patterns like '/_nitro/**'.\n   * Exclusions take precedence over inclusions.\n   */\n  exclude?: string[]\n\n  /**\n   * Route-specific service configuration.\n   */\n  routes?: Record<string, RouteConfig>\n\n  /**\n   * Sampling configuration for filtering logs.\n   */\n  sampling?: SamplingConfig\n}\n\nexport interface EvlogConfig {\n  enabled?: boolean\n  env?: Record<string, unknown>\n  pretty?: boolean\n  include?: string[]\n  exclude?: string[]\n  routes?: Record<string, RouteConfig>\n  sampling?: SamplingConfig\n}\n\n/**\n * Resolve an EvlogError from an error or its cause chain.\n * Both Nitro v2 (h3) and v3 wrap thrown errors — this unwraps them.\n */\nexport function resolveEvlogError(error: Error): Error | null {\n  if (error.name === 'EvlogError') return error\n  if ((error.cause as Error)?.name === 'EvlogError') return error.cause as Error\n  return null\n}\n\n/**\n * Extract HTTP status from an error, checking both `status` and `statusCode`.\n */\nexport function extractErrorStatus(error: unknown): number {\n  return (error as { status?: number }).status\n    ?? (error as { statusCode?: number }).statusCode\n    ?? 500\n}\n\n/**\n * Build a standard evlog error JSON response body.\n * Used by both v2 and v3 error handlers to ensure consistent shape.\n */\nexport function serializeEvlogErrorResponse(error: Error, url: string): Record<string, unknown> {\n  const status = extractErrorStatus(error)\n  const { data } = error as { data?: unknown }\n  const statusMessage = (error as { statusMessage?: string }).statusMessage || error.message\n  return {\n    url,\n    status,\n    statusCode: status,\n    statusText: statusMessage,\n    statusMessage,\n    message: error.message,\n    error: true,\n    ...(data !== undefined && { data }),\n  }\n}\n\nexport function shouldLog(path: string, include?: string[], exclude?: string[]): boolean {\n  // Check exclusions first (they take precedence)\n  if (exclude && exclude.length > 0) {\n    if (exclude.some(pattern => matchesPattern(path, pattern))) {\n      return false\n    }\n  }\n\n  // If no include patterns, log everything (that wasn't excluded)\n  if (!include || include.length === 0) {\n    return true\n  }\n\n  // Log only if path matches at least one include pattern\n  return include.some(pattern => matchesPattern(path, pattern))\n}\n\n/**\n * Find the service name for a given path based on route patterns.\n *\n * When multiple patterns match the same path, the first matching pattern wins\n * based on object iteration order. To ensure predictable behavior, order your\n * route patterns from most specific to most general.\n *\n * @param path - The request path to match\n * @param routes - Route configuration mapping patterns to service names\n * @returns The service name for the matching route, or undefined if no match\n *\n * @example\n * ```ts\n * // Good: specific patterns first, general patterns last\n * routes: {\n *   '/api/auth/admin/**': { service: 'admin-service' },\n *   '/api/auth/**': { service: 'auth-service' },\n *   '/api/**': { service: 'api-service' },\n * }\n * ```\n */\nexport function getServiceForPath(path: string, routes?: Record<string, RouteConfig>): string | undefined {\n  if (!routes) return undefined\n\n  for (const [pattern, config] of Object.entries(routes)) {\n    if (matchesPattern(path, pattern)) {\n      return config.service\n    }\n  }\n\n  return undefined\n}\n"],"mappings":";;;;;;;AA4DA,SAAgB,kBAAkB,OAA4B;AAC5D,KAAI,MAAM,SAAS,aAAc,QAAO;AACxC,KAAK,MAAM,OAAiB,SAAS,aAAc,QAAO,MAAM;AAChE,QAAO;;;;;AAMT,SAAgB,mBAAmB,OAAwB;AACzD,QAAQ,MAA8B,UAChC,MAAkC,cACnC;;;;;;AAOP,SAAgB,4BAA4B,OAAc,KAAsC;CAC9F,MAAM,SAAS,mBAAmB,MAAM;CACxC,MAAM,EAAE,SAAS;CACjB,MAAM,gBAAiB,MAAqC,iBAAiB,MAAM;AACnF,QAAO;EACL;EACA;EACA,YAAY;EACZ,YAAY;EACZ;EACA,SAAS,MAAM;EACf,OAAO;EACP,GAAI,SAAS,UAAa,EAAE,MAAM;EACnC;;AAGH,SAAgB,UAAU,MAAc,SAAoB,SAA6B;AAEvF,KAAI,WAAW,QAAQ,SAAS,GAC9B;MAAI,QAAQ,MAAK,YAAW,eAAe,MAAM,QAAQ,CAAC,CACxD,QAAO;;AAKX,KAAI,CAAC,WAAW,QAAQ,WAAW,EACjC,QAAO;AAIT,QAAO,QAAQ,MAAK,YAAW,eAAe,MAAM,QAAQ,CAAC;;;;;;;;;;;;;;;;;;;;;;;AAwB/D,SAAgB,kBAAkB,MAAc,QAA0D;AACxG,KAAI,CAAC,OAAQ,QAAO;AAEpB,MAAK,MAAM,CAAC,SAAS,WAAW,OAAO,QAAQ,OAAO,CACpD,KAAI,eAAe,MAAM,QAAQ,CAC/B,QAAO,OAAO"}

package/dist/nitro-D81NBVPi.d.mts

@@ -0,0 +1,42 @@
+import { EnvironmentContext, RouteConfig, SamplingConfig } from "./types.mjs";
+
+//#region src/nitro.d.ts
+interface NitroModuleOptions {
+  /**
+   * Enable or disable all logging globally.
+   * @default true
+   */
+  enabled?: boolean;
+  /**
+   * Environment context overrides.
+   */
+  env?: Partial<EnvironmentContext>;
+  /**
+   * Enable pretty printing.
+   * @default true in development, false in production
+   */
+  pretty?: boolean;
+  /**
+   * Route patterns to include in logging.
+   * Supports glob patterns like '/api/**'.
+   * If not set, all routes are logged.
+   */
+  include?: string[];
+  /**
+   * Route patterns to exclude from logging.
+   * Supports glob patterns like '/_nitro/**'.
+   * Exclusions take precedence over inclusions.
+   */
+  exclude?: string[];
+  /**
+   * Route-specific service configuration.
+   */
+  routes?: Record<string, RouteConfig>;
+  /**
+   * Sampling configuration for filtering logs.
+   */
+  sampling?: SamplingConfig;
+}
+//#endregion
+export { NitroModuleOptions as t };
+//# sourceMappingURL=nitro-D81NBVPi.d.mts.map

package/dist/nitro-D81NBVPi.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nitro-D81NBVPi.d.mts","names":[],"sources":["../src/nitro.ts"],"mappings":";;;UAGiB,kBAAA;;AAAjB;;;EAKE,OAAA;EAKM;;;EAAN,GAAA,GAAM,OAAA,CAAQ,kBAAA;EA8BW;;;;EAxBzB,MAAA;EANc;;;;;EAad,OAAA;EAYwB;;;;;EALxB,OAAA;;;;EAKA,MAAA,GAAS,MAAA,SAAe,WAAA;;;;EAKxB,QAAA,GAAW,cAAA;AAAA"}