npm - @logtape/elysia - Versions diffs - 2.2.0-dev.685 → 2.2.0-dev.688 - Mend

@logtape/elysia 2.2.0-dev.685 → 2.2.0-dev.688

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (9) hide show

package/README.md CHANGED Viewed

@@ -66,6 +66,51 @@ app.use(elysiaLogger({
   skip: (ctx) => ctx.path === "/health",  // Skip logging for specific paths
   logRequest: true,              // Log at request start (default: false)
   scope: "global",               // Plugin scope (default: "global")
+  context: true,                 // Add requestId to request-scoped logs
+}));
+~~~~
+Request context
+---------------
+Set `context: true` to add request-scoped correlation fields.  By default,
+the plugin reads the `x-request-id` request header, generates an ID when the
+header is missing, writes the resolved ID to the `x-request-id` response
+header, and adds `requestId` to request and error log records.
+To make logs emitted by your route handlers inherit the same `requestId`, also
+configure LogTape with `contextLocalStorage`:
+~~~~ typescript
+import { AsyncLocalStorage } from "node:async_hooks";
+import { configure } from "@logtape/logtape";
+await configure({
+  // ... sinks and loggers ...
+  contextLocalStorage: new AsyncLocalStorage(),
+});
+new Elysia()
+  .use(elysiaLogger({ context: true }))
+  .get("/", () => ({ hello: "world" }));
+~~~~
+The context is still established when `skip` suppresses the request log, so
+application logs inside the skipped request can keep the same request ID.
+You can customize request ID headers and add more request fields:
+~~~~ typescript
+app.use(elysiaLogger({
+  context: {
+    requestId: {
+      headerNames: ["x-correlation-id", "x-request-id"],
+      responseHeader: "x-request-id",
+    },
+    include: ["requestId", "method", "path", "userAgent"],
+    enrich: (ctx) => ({ route: ctx.path }),
+  },
 }));
 ~~~~

package/dist/mod.cjs CHANGED Viewed

@@ -3,6 +3,71 @@ const elysia = require_rolldown_runtime.__toESM(require("elysia"));
 const __logtape_logtape = require_rolldown_runtime.__toESM(require("@logtape/logtape"));
 //#region src/mod.ts
+const defaultRequestIdHeader = "x-request-id";
+/**
+* Normalize request context options.
+*/
+function normalizeRequestContextOptions(options) {
+	if (options === true) return {};
+	if (options === false || options == null) return void 0;
+	return options;
+}
+/**
+* Normalize request ID options.
+*/
+function normalizeRequestIdOptions(options) {
+	if (options === false) return void 0;
+	if (options === true || options == null) return {};
+	return options;
+}
+/**
+* Generate a request ID with Web Crypto when possible.
+*/
+function generateRequestId() {
+	if (typeof globalThis.crypto?.randomUUID === "function") return globalThis.crypto.randomUUID();
+	return `${Date.now().toString(36)}-${Math.random().toString(36).slice(2)}`;
+}
+/**
+* Normalize an incoming request ID.
+*/
+function defaultNormalizeRequestId(value) {
+	const trimmed = value.trim();
+	return trimmed === "" ? null : trimmed;
+}
+/**
+* Resolve a request path from a request URL.
+*/
+function getPath(request) {
+	return new URL(request.url, "http://localhost").pathname;
+}
+/**
+* Resolve the request ID for a request.
+*/
+function resolveRequestId(request, options) {
+	const property = options.property ?? "requestId";
+	const normalize = options.normalize ?? defaultNormalizeRequestId;
+	const headerNames = options.headerNames ?? [defaultRequestIdHeader];
+	for (const headerName of headerNames) {
+		const headerValue = request.headers.get(headerName);
+		if (headerValue == null) continue;
+		const normalized = normalize(headerValue);
+		if (normalized != null) {
+			const responseHeader$1 = options.responseHeader ?? defaultRequestIdHeader;
+			return {
+				property,
+				value: normalized,
+				responseHeader: responseHeader$1 === false ? void 0 : responseHeader$1
+			};
+		}
+	}
+	const generated = (options.generate ?? generateRequestId)();
+	const responseHeader = options.responseHeader ?? defaultRequestIdHeader;
+	return {
+		property,
+		value: generated,
+		responseHeader: responseHeader === false ? void 0 : responseHeader
+	};
+}
 /**
 * Get referrer from request headers.
 */
@@ -27,6 +92,66 @@ function getRemoteAddr(request) {
 	return void 0;
 }
 /**
+* Build request context fields from a request.
+*/
+function buildIncludedContext(request, resolvedRequestId, include) {
+	const context = {};
+	for (const field of include) switch (field) {
+		case "requestId":
+			if (resolvedRequestId != null) context[resolvedRequestId.property] = resolvedRequestId.value;
+			break;
+		case "method":
+			context.method = request.method;
+			break;
+		case "url":
+			context.url = request.url;
+			break;
+		case "path":
+			context.path = getPath(request);
+			break;
+		case "userAgent":
+			context.userAgent = getUserAgent(request);
+			break;
+		case "remoteAddr":
+			context.remoteAddr = getRemoteAddr(request);
+			break;
+		case "referrer":
+			context.referrer = getReferrer(request);
+			break;
+	}
+	return context;
+}
+/**
+* Build the implicit context for a request.
+*/
+async function buildRequestContext(request, options) {
+	const requestIdOptions = normalizeRequestIdOptions(options.requestId);
+	const resolvedRequestId = requestIdOptions == null ? void 0 : resolveRequestId(request, requestIdOptions);
+	const include = options.include ?? (resolvedRequestId == null ? [] : ["requestId"]);
+	const context = buildIncludedContext(request, resolvedRequestId, include);
+	let set;
+	if (options.enrich != null) {
+		set = {
+			status: 200,
+			headers: {}
+		};
+		Object.assign(context, await options.enrich({
+			request,
+			path: getPath(request),
+			set
+		}));
+	}
+	const responseHeader = resolvedRequestId?.responseHeader == null ? void 0 : {
+		name: resolvedRequestId.responseHeader,
+		value: resolvedRequestId.value
+	};
+	return {
+		context,
+		responseHeader,
+		set
+	};
+}
+/**
 * Get content length from response headers.
 */
 function getContentLength(headers) {
@@ -51,6 +176,16 @@ function buildProperties(ctx, responseTime) {
 	};
 }
 /**
+* Add request context fields to a request log result.
+*/
+function withRequestLogContext(result, context) {
+	if (typeof result === "string") return result;
+	return {
+		...result,
+		...context
+	};
+}
+/**
 * Combined format (Apache Combined Log Format).
 * Returns all structured properties.
 */
@@ -188,28 +323,74 @@ function elysiaLogger(options = {}) {
 	const skip = options.skip ?? (() => false);
 	const logRequest = options.logRequest ?? false;
 	const scope = options.scope ?? "global";
+	const contextOptions = normalizeRequestContextOptions(options.context);
+	const requestContextStates = /* @__PURE__ */ new WeakMap();
+	const shouldWrapContext = contextOptions != null && scope !== "local";
 	const formatFn = typeof formatOption === "string" ? predefinedFormats[formatOption] : formatOption;
 	const logMethod = logger[level].bind(logger);
 	const errorLogMethod = logger.error.bind(logger);
+	const buildAndStoreRequestContext = async (request) => {
+		if (contextOptions == null) return void 0;
+		const existingContext = requestContextStates.get(request);
+		if (existingContext != null) return existingContext;
+		const startTime = performance.now();
+		const requestContext = {
+			...await buildRequestContext(request, contextOptions),
+			startTime
+		};
+		requestContextStates.set(request, requestContext);
+		return requestContext;
+	};
+	const applyRequestContextToSet = (set, requestContext) => {
+		if (requestContext?.responseHeader != null) set.headers[requestContext.responseHeader.name] = requestContext.responseHeader.value;
+		if (requestContext?.set != null) {
+			if (requestContext.set.status !== 200) set.status = requestContext.set.status;
+			Object.assign(set.headers, requestContext.set.headers);
+		}
+	};
 	let plugin = new elysia.Elysia({
 		name: "@logtape/elysia",
 		seed: options
-	}).state("startTime", 0).onRequest(({ store }) => {
-		store.startTime = performance.now();
 	});
-	if (logRequest) plugin = plugin.onRequest((ctx) => {
-		if (!skip(ctx)) {
-			const result = formatFn(ctx, 0);
-			if (typeof result === "string") logMethod(result);
+	if (shouldWrapContext) plugin = plugin.wrap((handle) => {
+		return async (request) => {
+			const requestContext = await buildAndStoreRequestContext(request);
+			return await (0, __logtape_logtape.withContext)(requestContext?.context ?? {}, () => handle(request));
+		};
+	});
+	plugin = plugin.state("startTime", 0).onRequest(async ({ request, set, store }) => {
+		let requestContext = requestContextStates.get(request);
+		if (requestContext == null && shouldWrapContext) requestContext = await buildAndStoreRequestContext(request);
+		store.startTime = requestContext?.startTime ?? performance.now();
+		applyRequestContextToSet(set, requestContext);
+	});
+	if (scope === "local" && (contextOptions != null || logRequest)) plugin = plugin.onBeforeHandle(async (ctx) => {
+		const requestContext = await buildAndStoreRequestContext(ctx.request);
+		ctx.store.startTime = requestContext?.startTime ?? performance.now();
+		applyRequestContextToSet(ctx.set, requestContext);
+		if (logRequest && !skip(ctx)) {
+			const context = requestContext?.context ?? {};
+			const result = withRequestLogContext(formatFn(ctx, 0), context);
+			if (typeof result === "string") logMethod(result, context);
 			else logMethod("{method} {url}", result);
 		}
 	});
-	else plugin = plugin.onAfterHandle((ctx) => {
+	if (logRequest) {
+		if (scope !== "local") plugin = plugin.onRequest((ctx) => {
+			if (!skip(ctx)) {
+				const requestContext = requestContextStates.get(ctx.request)?.context ?? {};
+				const result = withRequestLogContext(formatFn(ctx, 0), requestContext);
+				if (typeof result === "string") logMethod(result, requestContext);
+				else logMethod("{method} {url}", result);
+			}
+		});
+	} else plugin = plugin.onAfterHandle((ctx) => {
 		if (skip(ctx)) return;
 		const store = ctx.store;
 		const responseTime = performance.now() - store.startTime;
-		const result = formatFn(ctx, responseTime);
-		if (typeof result === "string") logMethod(result);
+		const requestContext = requestContextStates.get(ctx.request)?.context ?? {};
+		const result = withRequestLogContext(formatFn(ctx, responseTime), requestContext);
+		if (typeof result === "string") logMethod(result, requestContext);
 		else logMethod("{method} {url} {status} - {responseTime} ms", result);
 	});
 	plugin = plugin.onError((ctx) => {
@@ -218,11 +399,13 @@ function elysiaLogger(options = {}) {
 		const elysiaCtx = ctx;
 		if (skip(elysiaCtx)) return;
 		const props = buildProperties(elysiaCtx, responseTime);
+		const requestContext = requestContextStates.get(ctx.request)?.context ?? {};
 		const status = getErrorStatus(ctx.code, ctx.error, elysiaCtx.set.status);
 		const error = ctx.error;
 		const errorMessage = error?.message ?? "Unknown error";
 		errorLogMethod("Error: {method} {url} {status} - {responseTime} ms - {errorMessage}", {
 			...props,
+			...requestContext,
 			status,
 			errorMessage,
 			errorCode: ctx.code

package/dist/mod.d.cts CHANGED Viewed

@@ -58,6 +58,63 @@ interface RequestLogProperties {
   /** Referrer header value */
   referrer: string | undefined;
 }
+/**
+ * Request fields that can be added to the implicit request context.
+ * @since 2.2.0
+ */
+type RequestContextField = "requestId" | "method" | "url" | "path" | "userAgent" | "remoteAddr" | "referrer";
+/**
+ * Options for extracting, generating, and propagating a request ID.
+ * @since 2.2.0
+ */
+interface RequestIdOptions {
+  /**
+   * The property name used in implicit context and request log records.
+   * @default "requestId"
+   */
+  readonly property?: string;
+  /**
+   * Incoming request headers to inspect in order.
+   * @default ["x-request-id"]
+   */
+  readonly headerNames?: readonly string[];
+  /**
+   * Response header that receives the resolved request ID.
+   * Set to `false` to disable response header propagation.
+   * @default "x-request-id"
+   */
+  readonly responseHeader?: string | false;
+  /**
+   * Generates a request ID when no incoming header is present.
+   * @default crypto.randomUUID()
+   */
+  readonly generate?: () => string;
+  /**
+   * Normalizes an incoming request ID.  Return `null` to reject the value and
+   * keep looking for another header or generate a new ID.
+   */
+  readonly normalize?: (value: string) => string | null;
+}
+/**
+ * Options for request-scoped implicit context.
+ * @since 2.2.0
+ */
+interface RequestContextOptions {
+  /**
+   * Enables request ID extraction, generation, and response propagation.
+   * @default true
+   */
+  readonly requestId?: boolean | RequestIdOptions;
+  /**
+   * Fields to add to the implicit context.
+   * @default ["requestId"]
+   */
+  readonly include?: readonly RequestContextField[];
+  /**
+   * Adds application-specific fields to the implicit request context.
+   */
+  readonly enrich?: (ctx: ElysiaContext) => Record<string, unknown> | Promise<Record<string, unknown>>;
+}
 /**
  * Options for configuring the Elysia LogTape middleware.
  * @since 2.0.0
@@ -121,6 +178,18 @@ interface ElysiaLogTapeOptions {
    * @default "global"
    */
   readonly scope?: PluginScope;
+  /**
+   * Enables request-scoped implicit context and request ID correlation.
+   *
+   * When set to `true`, the plugin reads the `x-request-id` header, generates
+   * one when it is absent, writes it to the `x-request-id` response header,
+   * and adds `requestId` to all LogTape records emitted while handling the
+   * request.
+   *
+   * @default false
+   * @since 2.2.0
+   */
+  readonly context?: boolean | RequestContextOptions;
 }
 /**
  * Creates Elysia plugin for HTTP request logging using LogTape.
@@ -177,5 +246,5 @@ interface ElysiaLogTapeOptions {
 declare function elysiaLogger(options?: ElysiaLogTapeOptions): Elysia<any>;
 //# sourceMappingURL=mod.d.ts.map
 //#endregion
-export { ElysiaContext, ElysiaLogTapeOptions, FormatFunction, LogLevel, PluginScope, PredefinedFormat, RequestLogProperties, elysiaLogger };
+export { ElysiaContext, ElysiaLogTapeOptions, FormatFunction, LogLevel, PluginScope, PredefinedFormat, RequestContextField, RequestContextOptions, RequestIdOptions, RequestLogProperties, elysiaLogger };
 //# sourceMappingURL=mod.d.cts.map

package/dist/mod.d.cts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"mod.d.cts","names":[],"sources":["../src/mod.ts"],"sourcesContent":[],"mappings":";;;;;;AASA;;;AAKa,UALI,aAAA,CAKJ;EAAM,OAAA,EAJR,OAIQ;EAQP,IAAA,EAAA,MAAA;EAMA,GAAA,EAAA;IAUA,MAAA,EAAA,MAAc;IAAA,OAAA,EAxBb,MAwBa,CAAA,MAAA,EAAA,MAAA,GAAA,SAAA,CAAA;EAAA,CAAA;;AAGN;AAMpB;AAyBA~~;;AAWmB~~,~~KA7DP~~,WAAA,~~GA6DO~~,~~QAAA~~,GAAA,QAAA,GAAA,OAAA;;;;;~~AAoDW~~,~~KA3GlB~~,gBAAA,~~GA2GkB~~,UAAA,GAAA,QAAA,GAAA,KAAA,GAAA,OAAA,GAAA,MAAA;~~AAmP9B;;;;AAAwE;;;;KApV5D~~,cAAA,~~SACL~~,~~iDAEO;;;;;UAMG~~,oBAAA~~;;;;;;;;;;;;;;;;;;;;;;;;UAyBA~~,oBAAA;;;;;;;;;;mBAWE;;;;;;;;;;;;;;oBAeC,mBAAmB;;;;;;;;;;;;;;wBAef;;;;;;;;;;;;;;;;;;;;mBAsBL;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;~~iBAmPH~~,YAAA,WAAsB,uBAA4B"}
1	+ {"version":3,"file":"mod.d.cts","names":[],"sources":["../src/mod.ts"],"sourcesContent":[],"mappings":";;;;;;AASA;;;AAKa,UALI,aAAA,CAKJ;EAAM,OAAA,EAJR,OAIQ;EAQP,IAAA,EAAA,MAAA;EAMA,GAAA,EAAA;IAUA,MAAA,EAAA,MAAc;IAAA,OAAA,EAxBb,MAwBa,CAAA,MAAA,EAAA,MAAA,GAAA,SAAA,CAAA;EAAA,CAAA;;AAGN;AAMpB;AAyBA;AAaA;AAqCiB,KApGL,WAAA,GAoGK,QAAqB,GAAA,QAAA,GAAA,OAAA;;;;;AAkB/B,KAhHK,gBAAA,GAgHL,UAAA,GAAA,QAAA,GAAA,KAAA,GAAA,OAAA,GAAA,MAAA;;;AAAiC;AAOxC;;;;;AAyCwB,KAtJZ,cAAA,GAsJY,CAAA,GAAA,EArJjB,aAqJiB,EAAA,YAAA,EAAA,MAAA,EAAA,GAAA,MAAA,GAnJV,MAmJU,CAAA,MAAA,EAAA,OAAA,CAAA;;;AAmC4B;AA4apD;AAA4B,UA5lBX,oBAAA,CA4lBW;EAAA;EAAmC,MAAG,EAAA,MAAA;EAAM;;;;;;;;;;;;;;;;;;;;;KAnkB5D,mBAAA;;;;;UAaK,gBAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;UAqCA,qBAAA;;;;;iCAKgB;;;;;8BAMH;;;;0BAMrB,kBACF,0BAA0B,QAAQ;;;;;;UAOxB,oBAAA;;;;;;;;;;mBAWE;;;;;;;;;;;;;;oBAeC,mBAAmB;;;;;;;;;;;;;;wBAef;;;;;;;;;;;;;;;;;;;;mBAsBL;;;;;;;;;;;;+BAaY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA4af,YAAA,WAAsB,uBAA4B"}

package/dist/mod.d.ts CHANGED Viewed

@@ -58,6 +58,63 @@ interface RequestLogProperties {
   /** Referrer header value */
   referrer: string | undefined;
 }
+/**
+ * Request fields that can be added to the implicit request context.
+ * @since 2.2.0
+ */
+type RequestContextField = "requestId" | "method" | "url" | "path" | "userAgent" | "remoteAddr" | "referrer";
+/**
+ * Options for extracting, generating, and propagating a request ID.
+ * @since 2.2.0
+ */
+interface RequestIdOptions {
+  /**
+   * The property name used in implicit context and request log records.
+   * @default "requestId"
+   */
+  readonly property?: string;
+  /**
+   * Incoming request headers to inspect in order.
+   * @default ["x-request-id"]
+   */
+  readonly headerNames?: readonly string[];
+  /**
+   * Response header that receives the resolved request ID.
+   * Set to `false` to disable response header propagation.
+   * @default "x-request-id"
+   */
+  readonly responseHeader?: string | false;
+  /**
+   * Generates a request ID when no incoming header is present.
+   * @default crypto.randomUUID()
+   */
+  readonly generate?: () => string;
+  /**
+   * Normalizes an incoming request ID.  Return `null` to reject the value and
+   * keep looking for another header or generate a new ID.
+   */
+  readonly normalize?: (value: string) => string | null;
+}
+/**
+ * Options for request-scoped implicit context.
+ * @since 2.2.0
+ */
+interface RequestContextOptions {
+  /**
+   * Enables request ID extraction, generation, and response propagation.
+   * @default true
+   */
+  readonly requestId?: boolean | RequestIdOptions;
+  /**
+   * Fields to add to the implicit context.
+   * @default ["requestId"]
+   */
+  readonly include?: readonly RequestContextField[];
+  /**
+   * Adds application-specific fields to the implicit request context.
+   */
+  readonly enrich?: (ctx: ElysiaContext) => Record<string, unknown> | Promise<Record<string, unknown>>;
+}
 /**
  * Options for configuring the Elysia LogTape middleware.
  * @since 2.0.0
@@ -121,6 +178,18 @@ interface ElysiaLogTapeOptions {
    * @default "global"
    */
   readonly scope?: PluginScope;
+  /**
+   * Enables request-scoped implicit context and request ID correlation.
+   *
+   * When set to `true`, the plugin reads the `x-request-id` header, generates
+   * one when it is absent, writes it to the `x-request-id` response header,
+   * and adds `requestId` to all LogTape records emitted while handling the
+   * request.
+   *
+   * @default false
+   * @since 2.2.0
+   */
+  readonly context?: boolean | RequestContextOptions;
 }
 /**
  * Creates Elysia plugin for HTTP request logging using LogTape.
@@ -177,5 +246,5 @@ interface ElysiaLogTapeOptions {
 declare function elysiaLogger(options?: ElysiaLogTapeOptions): Elysia<any>;
 //# sourceMappingURL=mod.d.ts.map
 //#endregion
-export { ElysiaContext, ElysiaLogTapeOptions, FormatFunction, LogLevel, PluginScope, PredefinedFormat, RequestLogProperties, elysiaLogger };
+export { ElysiaContext, ElysiaLogTapeOptions, FormatFunction, LogLevel, PluginScope, PredefinedFormat, RequestContextField, RequestContextOptions, RequestIdOptions, RequestLogProperties, elysiaLogger };
 //# sourceMappingURL=mod.d.ts.map

package/dist/mod.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"mod.d.ts","names":[],"sources":["../src/mod.ts"],"sourcesContent":[],"mappings":";;;;;;AASA;;;AAKa,UALI,aAAA,CAKJ;EAAM,OAAA,EAJR,OAIQ;EAQP,IAAA,EAAA,MAAA;EAMA,GAAA,EAAA;IAUA,MAAA,EAAA,MAAc;IAAA,OAAA,EAxBb,MAwBa,CAAA,MAAA,EAAA,MAAA,GAAA,SAAA,CAAA;EAAA,CAAA;;AAGN;AAMpB;AAyBA~~;;AAWmB~~,~~KA7DP~~,WAAA,~~GA6DO~~,~~QAAA~~,GAAA,QAAA,GAAA,OAAA;;;;;~~AAoDW~~,~~KA3GlB~~,gBAAA,~~GA2GkB~~,UAAA,GAAA,QAAA,GAAA,KAAA,GAAA,OAAA,GAAA,MAAA;~~AAmP9B;;;;AAAwE;;;;KApV5D~~,cAAA,~~SACL~~,~~iDAEO;;;;;UAMG~~,oBAAA~~;;;;;;;;;;;;;;;;;;;;;;;;UAyBA~~,oBAAA;;;;;;;;;;mBAWE;;;;;;;;;;;;;;oBAeC,mBAAmB;;;;;;;;;;;;;;wBAef;;;;;;;;;;;;;;;;;;;;mBAsBL;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;~~iBAmPH~~,YAAA,WAAsB,uBAA4B"}
1	+ {"version":3,"file":"mod.d.ts","names":[],"sources":["../src/mod.ts"],"sourcesContent":[],"mappings":";;;;;;AASA;;;AAKa,UALI,aAAA,CAKJ;EAAM,OAAA,EAJR,OAIQ;EAQP,IAAA,EAAA,MAAA;EAMA,GAAA,EAAA;IAUA,MAAA,EAAA,MAAc;IAAA,OAAA,EAxBb,MAwBa,CAAA,MAAA,EAAA,MAAA,GAAA,SAAA,CAAA;EAAA,CAAA;;AAGN;AAMpB;AAyBA;AAaA;AAqCiB,KApGL,WAAA,GAoGK,QAAqB,GAAA,QAAA,GAAA,OAAA;;;;;AAkB/B,KAhHK,gBAAA,GAgHL,UAAA,GAAA,QAAA,GAAA,KAAA,GAAA,OAAA,GAAA,MAAA;;;AAAiC;AAOxC;;;;;AAyCwB,KAtJZ,cAAA,GAsJY,CAAA,GAAA,EArJjB,aAqJiB,EAAA,YAAA,EAAA,MAAA,EAAA,GAAA,MAAA,GAnJV,MAmJU,CAAA,MAAA,EAAA,OAAA,CAAA;;;AAmC4B;AA4apD;AAA4B,UA5lBX,oBAAA,CA4lBW;EAAA;EAAmC,MAAG,EAAA,MAAA;EAAM;;;;;;;;;;;;;;;;;;;;;KAnkB5D,mBAAA;;;;;UAaK,gBAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;UAqCA,qBAAA;;;;;iCAKgB;;;;;8BAMH;;;;0BAMrB,kBACF,0BAA0B,QAAQ;;;;;;UAOxB,oBAAA;;;;;;;;;;mBAWE;;;;;;;;;;;;;;oBAeC,mBAAmB;;;;;;;;;;;;;;wBAef;;;;;;;;;;;;;;;;;;;;mBAsBL;;;;;;;;;;;;+BAaY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA4af,YAAA,WAAsB,uBAA4B"}

package/dist/mod.js CHANGED Viewed

@@ -1,7 +1,72 @@
 import { Elysia } from "elysia";
-import { getLogger } from "@logtape/logtape";
+import { getLogger, withContext } from "@logtape/logtape";
 //#region src/mod.ts
+const defaultRequestIdHeader = "x-request-id";
+/**
+* Normalize request context options.
+*/
+function normalizeRequestContextOptions(options) {
+	if (options === true) return {};
+	if (options === false || options == null) return void 0;
+	return options;
+}
+/**
+* Normalize request ID options.
+*/
+function normalizeRequestIdOptions(options) {
+	if (options === false) return void 0;
+	if (options === true || options == null) return {};
+	return options;
+}
+/**
+* Generate a request ID with Web Crypto when possible.
+*/
+function generateRequestId() {
+	if (typeof globalThis.crypto?.randomUUID === "function") return globalThis.crypto.randomUUID();
+	return `${Date.now().toString(36)}-${Math.random().toString(36).slice(2)}`;
+}
+/**
+* Normalize an incoming request ID.
+*/
+function defaultNormalizeRequestId(value) {
+	const trimmed = value.trim();
+	return trimmed === "" ? null : trimmed;
+}
+/**
+* Resolve a request path from a request URL.
+*/
+function getPath(request) {
+	return new URL(request.url, "http://localhost").pathname;
+}
+/**
+* Resolve the request ID for a request.
+*/
+function resolveRequestId(request, options) {
+	const property = options.property ?? "requestId";
+	const normalize = options.normalize ?? defaultNormalizeRequestId;
+	const headerNames = options.headerNames ?? [defaultRequestIdHeader];
+	for (const headerName of headerNames) {
+		const headerValue = request.headers.get(headerName);
+		if (headerValue == null) continue;
+		const normalized = normalize(headerValue);
+		if (normalized != null) {
+			const responseHeader$1 = options.responseHeader ?? defaultRequestIdHeader;
+			return {
+				property,
+				value: normalized,
+				responseHeader: responseHeader$1 === false ? void 0 : responseHeader$1
+			};
+		}
+	}
+	const generated = (options.generate ?? generateRequestId)();
+	const responseHeader = options.responseHeader ?? defaultRequestIdHeader;
+	return {
+		property,
+		value: generated,
+		responseHeader: responseHeader === false ? void 0 : responseHeader
+	};
+}
 /**
 * Get referrer from request headers.
 */
@@ -26,6 +91,66 @@ function getRemoteAddr(request) {
 	return void 0;
 }
 /**
+* Build request context fields from a request.
+*/
+function buildIncludedContext(request, resolvedRequestId, include) {
+	const context = {};
+	for (const field of include) switch (field) {
+		case "requestId":
+			if (resolvedRequestId != null) context[resolvedRequestId.property] = resolvedRequestId.value;
+			break;
+		case "method":
+			context.method = request.method;
+			break;
+		case "url":
+			context.url = request.url;
+			break;
+		case "path":
+			context.path = getPath(request);
+			break;
+		case "userAgent":
+			context.userAgent = getUserAgent(request);
+			break;
+		case "remoteAddr":
+			context.remoteAddr = getRemoteAddr(request);
+			break;
+		case "referrer":
+			context.referrer = getReferrer(request);
+			break;
+	}
+	return context;
+}
+/**
+* Build the implicit context for a request.
+*/
+async function buildRequestContext(request, options) {
+	const requestIdOptions = normalizeRequestIdOptions(options.requestId);
+	const resolvedRequestId = requestIdOptions == null ? void 0 : resolveRequestId(request, requestIdOptions);
+	const include = options.include ?? (resolvedRequestId == null ? [] : ["requestId"]);
+	const context = buildIncludedContext(request, resolvedRequestId, include);
+	let set;
+	if (options.enrich != null) {
+		set = {
+			status: 200,
+			headers: {}
+		};
+		Object.assign(context, await options.enrich({
+			request,
+			path: getPath(request),
+			set
+		}));
+	}
+	const responseHeader = resolvedRequestId?.responseHeader == null ? void 0 : {
+		name: resolvedRequestId.responseHeader,
+		value: resolvedRequestId.value
+	};
+	return {
+		context,
+		responseHeader,
+		set
+	};
+}
+/**
 * Get content length from response headers.
 */
 function getContentLength(headers) {
@@ -50,6 +175,16 @@ function buildProperties(ctx, responseTime) {
 	};
 }
 /**
+* Add request context fields to a request log result.
+*/
+function withRequestLogContext(result, context) {
+	if (typeof result === "string") return result;
+	return {
+		...result,
+		...context
+	};
+}
+/**
 * Combined format (Apache Combined Log Format).
 * Returns all structured properties.
 */
@@ -187,28 +322,74 @@ function elysiaLogger(options = {}) {
 	const skip = options.skip ?? (() => false);
 	const logRequest = options.logRequest ?? false;
 	const scope = options.scope ?? "global";
+	const contextOptions = normalizeRequestContextOptions(options.context);
+	const requestContextStates = /* @__PURE__ */ new WeakMap();
+	const shouldWrapContext = contextOptions != null && scope !== "local";
 	const formatFn = typeof formatOption === "string" ? predefinedFormats[formatOption] : formatOption;
 	const logMethod = logger[level].bind(logger);
 	const errorLogMethod = logger.error.bind(logger);
+	const buildAndStoreRequestContext = async (request) => {
+		if (contextOptions == null) return void 0;
+		const existingContext = requestContextStates.get(request);
+		if (existingContext != null) return existingContext;
+		const startTime = performance.now();
+		const requestContext = {
+			...await buildRequestContext(request, contextOptions),
+			startTime
+		};
+		requestContextStates.set(request, requestContext);
+		return requestContext;
+	};
+	const applyRequestContextToSet = (set, requestContext) => {
+		if (requestContext?.responseHeader != null) set.headers[requestContext.responseHeader.name] = requestContext.responseHeader.value;
+		if (requestContext?.set != null) {
+			if (requestContext.set.status !== 200) set.status = requestContext.set.status;
+			Object.assign(set.headers, requestContext.set.headers);
+		}
+	};
 	let plugin = new Elysia({
 		name: "@logtape/elysia",
 		seed: options
-	}).state("startTime", 0).onRequest(({ store }) => {
-		store.startTime = performance.now();
 	});
-	if (logRequest) plugin = plugin.onRequest((ctx) => {
-		if (!skip(ctx)) {
-			const result = formatFn(ctx, 0);
-			if (typeof result === "string") logMethod(result);
+	if (shouldWrapContext) plugin = plugin.wrap((handle) => {
+		return async (request) => {
+			const requestContext = await buildAndStoreRequestContext(request);
+			return await withContext(requestContext?.context ?? {}, () => handle(request));
+		};
+	});
+	plugin = plugin.state("startTime", 0).onRequest(async ({ request, set, store }) => {
+		let requestContext = requestContextStates.get(request);
+		if (requestContext == null && shouldWrapContext) requestContext = await buildAndStoreRequestContext(request);
+		store.startTime = requestContext?.startTime ?? performance.now();
+		applyRequestContextToSet(set, requestContext);
+	});
+	if (scope === "local" && (contextOptions != null || logRequest)) plugin = plugin.onBeforeHandle(async (ctx) => {
+		const requestContext = await buildAndStoreRequestContext(ctx.request);
+		ctx.store.startTime = requestContext?.startTime ?? performance.now();
+		applyRequestContextToSet(ctx.set, requestContext);
+		if (logRequest && !skip(ctx)) {
+			const context = requestContext?.context ?? {};
+			const result = withRequestLogContext(formatFn(ctx, 0), context);
+			if (typeof result === "string") logMethod(result, context);
 			else logMethod("{method} {url}", result);
 		}
 	});
-	else plugin = plugin.onAfterHandle((ctx) => {
+	if (logRequest) {
+		if (scope !== "local") plugin = plugin.onRequest((ctx) => {
+			if (!skip(ctx)) {
+				const requestContext = requestContextStates.get(ctx.request)?.context ?? {};
+				const result = withRequestLogContext(formatFn(ctx, 0), requestContext);
+				if (typeof result === "string") logMethod(result, requestContext);
+				else logMethod("{method} {url}", result);
+			}
+		});
+	} else plugin = plugin.onAfterHandle((ctx) => {
 		if (skip(ctx)) return;
 		const store = ctx.store;
 		const responseTime = performance.now() - store.startTime;
-		const result = formatFn(ctx, responseTime);
-		if (typeof result === "string") logMethod(result);
+		const requestContext = requestContextStates.get(ctx.request)?.context ?? {};
+		const result = withRequestLogContext(formatFn(ctx, responseTime), requestContext);
+		if (typeof result === "string") logMethod(result, requestContext);
 		else logMethod("{method} {url} {status} - {responseTime} ms", result);
 	});
 	plugin = plugin.onError((ctx) => {
@@ -217,11 +398,13 @@ function elysiaLogger(options = {}) {
 		const elysiaCtx = ctx;
 		if (skip(elysiaCtx)) return;
 		const props = buildProperties(elysiaCtx, responseTime);
+		const requestContext = requestContextStates.get(ctx.request)?.context ?? {};
 		const status = getErrorStatus(ctx.code, ctx.error, elysiaCtx.set.status);
 		const error = ctx.error;
 		const errorMessage = error?.message ?? "Unknown error";
 		errorLogMethod("Error: {method} {url} {status} - {responseTime} ms - {errorMessage}", {
 			...props,
+			...requestContext,
 			status,
 			errorMessage,
 			errorCode: ctx.code

package/dist/mod.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"mod.js","names":["request: Request","headers: Record<string, string \| undefined>","ctx: ElysiaContext","responseTime: number","predefinedFormats: Record<PredefinedFormat, FormatFunction>","category: string \| readonly string[]","errorCodeToStatus: Record<string, number>","code: string \| number","error: unknown","setStatus: number","options: ElysiaLogTapeOptions","formatFn: FormatFunction"],"sources":["../src/mod.ts"],"sourcesContent":["import { Elysia } from \"elysia\";\nimport { getLogger, type LogLevel } from \"@logtape/logtape\";\n\nexport type { LogLevel } from \"@logtape/logtape\";\n\n/*\n Minimal Elysia Context interface for compatibility.\n * @since 2.0.0\n /\nexport interface ElysiaContext {\n request: Request;\n path: string;\n set: {\n status: number;\n headers: Record<string, string \| undefined>;\n };\n}\n\n/\n Plugin scope options for controlling hook propagation.\n * @since 2.0.0\n /\nexport type PluginScope = \"global\" \| \"scoped\" \| \"local\";\n\n/\n Predefined log format names compatible with Morgan.\n * @since 2.0.0\n /\nexport type PredefinedFormat = \"combined\" \| \"common\" \| \"dev\" \| \"short\" \| \"tiny\";\n\n/\n Custom format function for request logging.\n \n @param ctx The Elysia context object.\n * @param responseTime The response time in milliseconds.\n * @returns A string message or an object with structured properties.\n * @since 2.0.0\n /\nexport type FormatFunction = (\n ctx: ElysiaContext,\n responseTime: number,\n) => string \| Record<string, unknown>;\n\n/\n Structured log properties for HTTP requests.\n * @since 2.0.0\n /\nexport interface RequestLogProperties {\n /* HTTP request method /\n method: string;\n /* Request URL /\n url: string;\n /* Request path /\n path: string;\n /* HTTP response status code /\n status: number;\n /* Response time in milliseconds /\n responseTime: number;\n /* Response content-length header value /\n contentLength: string \| undefined;\n /* Remote client address (from X-Forwarded-For header) /\n remoteAddr: string \| undefined;\n /* User-Agent header value /\n userAgent: string \| undefined;\n /* Referrer header value /\n referrer: string \| undefined;\n}\n\n/\n Options for configuring the Elysia LogTape middleware.\n * @since 2.0.0\n /\nexport interface ElysiaLogTapeOptions {\n /\n The LogTape category to use for logging.\n * @default [\"elysia\"]\n /\n readonly category?: string \| readonly string[];\n\n /\n The log level to use for request logging.\n * @default \"info\"\n /\n readonly level?: LogLevel;\n\n /\n The format for log output.\n * Can be a predefined format name or a custom format function.\n \n Predefined formats:\n * - `\"combined\"` - Apache Combined Log Format (structured, default)\n * - `\"common\"` - Apache Common Log Format (structured, no referrer/userAgent)\n * - `\"dev\"` - Concise colored output for development (string)\n * - `\"short\"` - Shorter than common (string)\n * - `\"tiny\"` - Minimal output (string)\n \n @default \"combined\"\n /\n readonly format?: PredefinedFormat \| FormatFunction;\n\n /\n Function to determine whether logging should be skipped.\n * Return `true` to skip logging for a request.\n \n @example Skip logging for health check endpoint\n * ```typescript\n * app.use(elysiaLogger({\n * skip: (ctx) => ctx.path === \"/health\",\n * }));\n * ```\n \n @default () => false\n /\n readonly skip?: (ctx: ElysiaContext) => boolean;\n\n /\n If `true`, logs are written immediately when the request is received.\n * If `false` (default), logs are written after the response is sent.\n \n Note: When `logRequest` is `true`, response-related properties\n * (status, responseTime, contentLength) will not be available.\n \n @default false\n /\n readonly logRequest?: boolean;\n\n /\n The plugin scope for controlling how lifecycle hooks are propagated.\n \n - `\"global\"` - Hooks apply to all routes in the application\n * - `\"scoped\"` - Hooks apply to the parent instance where the plugin is used\n * - `\"local\"` - Hooks only apply within the plugin itself\n \n @default \"global\"\n /\n readonly scope?: PluginScope;\n}\n\n/\n Get referrer from request headers.\n /\nfunction getReferrer(request: Request): string \| undefined {\n return request.headers.get(\"referrer\") ??\n request.headers.get(\"referer\") ??\n undefined;\n}\n\n/\n Get user agent from request headers.\n /\nfunction getUserAgent(request: Request): string \| undefined {\n return request.headers.get(\"user-agent\") ?? undefined;\n}\n\n/\n Get remote address from X-Forwarded-For header.\n /\nfunction getRemoteAddr(request: Request): string \| undefined {\n const forwarded = request.headers.get(\"x-forwarded-for\");\n if (forwarded) {\n // X-Forwarded-For can contain multiple IPs, take the first one\n const firstIp = forwarded.split(\",\")[0].trim();\n return firstIp \|\| undefined;\n }\n return undefined;\n}\n\n/\n Get content length from response headers.\n /\nfunction getContentLength(\n headers: Record<string, string \| undefined>,\n): string \| undefined {\n const contentLength = headers[\"content-length\"];\n if (contentLength === undefined \|\| contentLength === null) return undefined;\n return contentLength;\n}\n\n/\n Build structured log properties from context.\n /\nfunction buildProperties(\n ctx: ElysiaContext,\n responseTime: number,\n): RequestLogProperties {\n return {\n method: ctx.request.method,\n url: ctx.request.url,\n path: ctx.path,\n status: ctx.set.status,\n responseTime,\n contentLength: getContentLength(ctx.set.headers),\n remoteAddr: getRemoteAddr(ctx.request),\n userAgent: getUserAgent(ctx.request),\n referrer: getReferrer(ctx.request),\n };\n}\n\n/\n Combined format (Apache Combined Log Format).\n * Returns all structured properties.\n /\nfunction formatCombined(\n ctx: ElysiaContext,\n responseTime: number,\n): Record<string, unknown> {\n return { ...buildProperties(ctx, responseTime) };\n}\n\n/\n Common format (Apache Common Log Format).\n * Like combined but without referrer and userAgent.\n /\nfunction formatCommon(\n ctx: ElysiaContext,\n responseTime: number,\n): Record<string, unknown> {\n const props = buildProperties(ctx, responseTime);\n const { referrer: _referrer, userAgent: _userAgent, ...rest } = props;\n return rest;\n}\n\n/\n Dev format (colored output for development).\n * :method :path :status :response-time ms - :res[content-length]\n /\nfunction formatDev(ctx: ElysiaContext, responseTime: number): string {\n const contentLength = getContentLength(ctx.set.headers) ?? \"-\";\n return `${ctx.request.method} ${ctx.path} ${ctx.set.status} ${\n responseTime.toFixed(3)\n } ms - ${contentLength}`;\n}\n\n/\n Short format.\n * :remote-addr :method :url :status :res[content-length] - :response-time ms\n /\nfunction formatShort(ctx: ElysiaContext, responseTime: number): string {\n const remoteAddr = getRemoteAddr(ctx.request) ?? \"-\";\n const contentLength = getContentLength(ctx.set.headers) ?? \"-\";\n return `${remoteAddr} ${ctx.request.method} ${ctx.request.url} ${ctx.set.status} ${contentLength} - ${\n responseTime.toFixed(3)\n } ms`;\n}\n\n/\n Tiny format (minimal output).\n * :method :path :status :res[content-length] - :response-time ms\n /\nfunction formatTiny(ctx: ElysiaContext, responseTime: number): string {\n const contentLength = getContentLength(ctx.set.headers) ?? \"-\";\n return `${ctx.request.method} ${ctx.path} ${ctx.set.status} ${contentLength} - ${\n responseTime.toFixed(3)\n } ms`;\n}\n\n/\n Map of predefined format functions.\n /\nconst predefinedFormats: Record<PredefinedFormat, FormatFunction> = {\n combined: formatCombined,\n common: formatCommon,\n dev: formatDev,\n short: formatShort,\n tiny: formatTiny,\n};\n\n/\n Normalize category to array format.\n /\nfunction normalizeCategory(\n category: string \| readonly string[],\n): readonly string[] {\n return typeof category === \"string\" ? [category] : category;\n}\n\n/\n Mapping of Elysia error codes to HTTP status codes.\n /\nconst errorCodeToStatus: Record<string, number> = {\n NOT_FOUND: 404,\n VALIDATION: 422,\n PARSE: 400,\n INTERNAL_SERVER_ERROR: 500,\n INVALID_COOKIE_SIGNATURE: 400,\n UNKNOWN: 500,\n};\n\n/\n Get the HTTP status code from an error context.\n * Checks error.status first, then falls back to error code mapping.\n /\nfunction getErrorStatus(\n code: string \| number,\n error: unknown,\n setStatus: number,\n): number {\n // If code is already a number, use it as status\n if (typeof code === \"number\") {\n return code;\n }\n // Check if error has a status property (Elysia custom errors)\n if (\n error != null &&\n typeof error === \"object\" &&\n \"status\" in error &&\n typeof error.status === \"number\"\n ) {\n return error.status;\n }\n // Fall back to error code mapping\n if (code in errorCodeToStatus) {\n return errorCodeToStatus[code];\n }\n // Use set.status as last resort\n return setStatus;\n}\n\n/\n Internal store type for timing.\n /\ninterface LoggerStore {\n startTime: number;\n}\n\n/\n Creates Elysia plugin for HTTP request logging using LogTape.\n \n This plugin provides Morgan-compatible request logging with LogTape\n * as the backend, supporting structured logging and customizable formats.\n \n @example Basic usage\n * ```typescript\n * import { Elysia } from \"elysia\";\n * import { configure, getConsoleSink } from \"@logtape/logtape\";\n * import { elysiaLogger } from \"@logtape/elysia\";\n \n await configure({\n * sinks: { console: getConsoleSink() },\n * loggers: [\n * { category: [\"elysia\"], sinks: [\"console\"], lowestLevel: \"info\" }\n * ],\n * });\n \n const app = new Elysia()\n * .use(elysiaLogger())\n * .get(\"/\", () => ({ hello: \"world\" }))\n * .listen(3000);\n * ```\n \n @example With custom options\n * ```typescript\n * app.use(elysiaLogger({\n * category: [\"myapp\", \"http\"],\n * level: \"debug\",\n * format: \"dev\",\n * skip: (ctx) => ctx.path === \"/health\",\n * scope: \"scoped\",\n * }));\n * ```\n \n @example With custom format function\n * ```typescript\n * app.use(elysiaLogger({\n * format: (ctx, responseTime) => ({\n * method: ctx.request.method,\n * path: ctx.path,\n * status: ctx.set.status,\n * duration: responseTime,\n * }),\n * }));\n * ```\n \n @param options Configuration options for the plugin.\n * @returns Elysia plugin instance.\n * @since 2.0.0\n */\n// deno-lint-ignore no-explicit-any\nexport function elysiaLogger(options: ElysiaLogTapeOptions = {}): Elysia<any> {\n const category = normalizeCategory(options.category ?? [\"elysia\"]);\n const logger = getLogger(category);\n const level = options.level ?? \"info\";\n const formatOption = options.format ?? \"combined\";\n const skip = options.skip ?? (() => false);\n const logRequest = options.logRequest ?? false;\n const scope = options.scope ?? \"global\";\n\n // Resolve format function\n const formatFn: FormatFunction = typeof formatOption === \"string\"\n ? predefinedFormats[formatOption]\n : formatOption;\n\n const logMethod = logger[level].bind(logger);\n const errorLogMethod = logger.error.bind(logger);\n\n let plugin = new Elysia({\n name: \"@logtape/elysia\",\n seed: options,\n })\n .state(\"startTime\", 0)\n .onRequest(({ store }) => {\n (store as LoggerStore).startTime = performance.now();\n });\n\n if (logRequest) {\n // Log immediately when request arrives\n plugin = plugin.onRequest((ctx) => {\n if (!skip(ctx as unknown as ElysiaContext)) {\n const result = formatFn(ctx as unknown as ElysiaContext, 0);\n if (typeof result === \"string\") {\n logMethod(result);\n } else {\n logMethod(\"{method} {url}\", result);\n }\n }\n });\n } else {\n // Log after handler completes\n plugin = plugin.onAfterHandle((ctx) => {\n if (skip(ctx as unknown as ElysiaContext)) return;\n\n const store = ctx.store as LoggerStore;\n const responseTime = performance.now() - store.startTime;\n const result = formatFn(ctx as unknown as ElysiaContext, responseTime);\n\n if (typeof result === \"string\") {\n logMethod(result);\n } else {\n logMethod(\"{method} {url} {status} - {responseTime} ms\", result);\n }\n });\n }\n\n // Add error logging\n plugin = plugin.onError((ctx) => {\n const store = ctx.store as LoggerStore;\n const responseTime = performance.now() - store.startTime;\n const elysiaCtx = ctx as unknown as ElysiaContext;\n\n if (skip(elysiaCtx)) return;\n\n const props = buildProperties(elysiaCtx, responseTime);\n // Get the correct HTTP status code from error context\n const status = getErrorStatus(ctx.code, ctx.error, elysiaCtx.set.status);\n // Extract error message safely\n const error = ctx.error as { message?: string } \| undefined;\n const errorMessage = error?.message ?? \"Unknown error\";\n errorLogMethod(\n \"Error: {method} {url} {status} - {responseTime} ms - {errorMessage}\",\n {\n ...props,\n status,\n errorMessage,\n errorCode: ctx.code,\n },\n );\n });\n\n // Apply scope\n if (scope === \"global\") {\n // deno-lint-ignore no-explicit-any\n return plugin.as(\"global\") as unknown as Elysia<any>;\n } else if (scope === \"scoped\") {\n // deno-lint-ignore no-explicit-any\n return plugin.as(\"scoped\") as unknown as Elysia<any>;\n }\n\n // deno-lint-ignore no-explicit-any\n return plugin as unknown as Elysia<any>;\n}\n"],"mappings":"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"}
1	+ {"version":3,"file":"mod.js","names":["options: boolean \| RequestContextOptions \| undefined","options: boolean \| RequestIdOptions \| undefined","value: string","request: Request","options: RequestIdOptions","responseHeader","resolvedRequestId:\n \| { readonly property: string; readonly value: string }\n \| undefined","include: readonly RequestContextField[]","context: Record<string, unknown>","options: RequestContextOptions","set: ElysiaContext[\"set\"] \| undefined","headers: Record<string, string \| undefined>","ctx: ElysiaContext","responseTime: number","result: string \| Record<string, unknown>","predefinedFormats: Record<PredefinedFormat, FormatFunction>","category: string \| readonly string[]","errorCodeToStatus: Record<string, number>","code: string \| number","error: unknown","setStatus: number","options: ElysiaLogTapeOptions","formatFn: FormatFunction","set: ElysiaContext[\"set\"]","requestContext: ElysiaRequestContextState \| undefined","plugin: Elysia<any, any, any, any, any, any, any>"],"sources":["../src/mod.ts"],"sourcesContent":["import { Elysia } from \"elysia\";\nimport { getLogger, type LogLevel, withContext } from \"@logtape/logtape\";\n\nexport type { LogLevel } from \"@logtape/logtape\";\n\n/*\n Minimal Elysia Context interface for compatibility.\n * @since 2.0.0\n /\nexport interface ElysiaContext {\n request: Request;\n path: string;\n set: {\n status: number;\n headers: Record<string, string \| undefined>;\n };\n}\n\n/\n Plugin scope options for controlling hook propagation.\n * @since 2.0.0\n /\nexport type PluginScope = \"global\" \| \"scoped\" \| \"local\";\n\n/\n Predefined log format names compatible with Morgan.\n * @since 2.0.0\n /\nexport type PredefinedFormat = \"combined\" \| \"common\" \| \"dev\" \| \"short\" \| \"tiny\";\n\n/\n Custom format function for request logging.\n \n @param ctx The Elysia context object.\n * @param responseTime The response time in milliseconds.\n * @returns A string message or an object with structured properties.\n * @since 2.0.0\n /\nexport type FormatFunction = (\n ctx: ElysiaContext,\n responseTime: number,\n) => string \| Record<string, unknown>;\n\n/\n Structured log properties for HTTP requests.\n * @since 2.0.0\n /\nexport interface RequestLogProperties {\n /* HTTP request method /\n method: string;\n /* Request URL /\n url: string;\n /* Request path /\n path: string;\n /* HTTP response status code /\n status: number;\n /* Response time in milliseconds /\n responseTime: number;\n /* Response content-length header value /\n contentLength: string \| undefined;\n /* Remote client address (from X-Forwarded-For header) /\n remoteAddr: string \| undefined;\n /* User-Agent header value /\n userAgent: string \| undefined;\n /* Referrer header value /\n referrer: string \| undefined;\n}\n\n/\n Request fields that can be added to the implicit request context.\n * @since 2.2.0\n /\nexport type RequestContextField =\n \| \"requestId\"\n \| \"method\"\n \| \"url\"\n \| \"path\"\n \| \"userAgent\"\n \| \"remoteAddr\"\n \| \"referrer\";\n\n/\n Options for extracting, generating, and propagating a request ID.\n * @since 2.2.0\n /\nexport interface RequestIdOptions {\n /\n The property name used in implicit context and request log records.\n * @default \"requestId\"\n /\n readonly property?: string;\n\n /\n Incoming request headers to inspect in order.\n * @default [\"x-request-id\"]\n /\n readonly headerNames?: readonly string[];\n\n /\n Response header that receives the resolved request ID.\n * Set to `false` to disable response header propagation.\n * @default \"x-request-id\"\n /\n readonly responseHeader?: string \| false;\n\n /\n Generates a request ID when no incoming header is present.\n * @default crypto.randomUUID()\n /\n readonly generate?: () => string;\n\n /\n Normalizes an incoming request ID. Return `null` to reject the value and\n * keep looking for another header or generate a new ID.\n /\n readonly normalize?: (value: string) => string \| null;\n}\n\n/\n Options for request-scoped implicit context.\n * @since 2.2.0\n /\nexport interface RequestContextOptions {\n /\n Enables request ID extraction, generation, and response propagation.\n * @default true\n /\n readonly requestId?: boolean \| RequestIdOptions;\n\n /\n Fields to add to the implicit context.\n * @default [\"requestId\"]\n /\n readonly include?: readonly RequestContextField[];\n\n /\n Adds application-specific fields to the implicit request context.\n /\n readonly enrich?: (\n ctx: ElysiaContext,\n ) => Record<string, unknown> \| Promise<Record<string, unknown>>;\n}\n\n/\n Options for configuring the Elysia LogTape middleware.\n * @since 2.0.0\n /\nexport interface ElysiaLogTapeOptions {\n /\n The LogTape category to use for logging.\n * @default [\"elysia\"]\n /\n readonly category?: string \| readonly string[];\n\n /\n The log level to use for request logging.\n * @default \"info\"\n /\n readonly level?: LogLevel;\n\n /\n The format for log output.\n * Can be a predefined format name or a custom format function.\n \n Predefined formats:\n * - `\"combined\"` - Apache Combined Log Format (structured, default)\n * - `\"common\"` - Apache Common Log Format (structured, no referrer/userAgent)\n * - `\"dev\"` - Concise colored output for development (string)\n * - `\"short\"` - Shorter than common (string)\n * - `\"tiny\"` - Minimal output (string)\n \n @default \"combined\"\n /\n readonly format?: PredefinedFormat \| FormatFunction;\n\n /\n Function to determine whether logging should be skipped.\n * Return `true` to skip logging for a request.\n \n @example Skip logging for health check endpoint\n * ```typescript\n * app.use(elysiaLogger({\n * skip: (ctx) => ctx.path === \"/health\",\n * }));\n * ```\n \n @default () => false\n /\n readonly skip?: (ctx: ElysiaContext) => boolean;\n\n /\n If `true`, logs are written immediately when the request is received.\n * If `false` (default), logs are written after the response is sent.\n \n Note: When `logRequest` is `true`, response-related properties\n * (status, responseTime, contentLength) will not be available.\n \n @default false\n /\n readonly logRequest?: boolean;\n\n /\n The plugin scope for controlling how lifecycle hooks are propagated.\n \n - `\"global\"` - Hooks apply to all routes in the application\n * - `\"scoped\"` - Hooks apply to the parent instance where the plugin is used\n * - `\"local\"` - Hooks only apply within the plugin itself\n \n @default \"global\"\n /\n readonly scope?: PluginScope;\n\n /\n Enables request-scoped implicit context and request ID correlation.\n \n When set to `true`, the plugin reads the `x-request-id` header, generates\n * one when it is absent, writes it to the `x-request-id` response header,\n * and adds `requestId` to all LogTape records emitted while handling the\n * request.\n \n @default false\n * @since 2.2.0\n /\n readonly context?: boolean \| RequestContextOptions;\n}\n\nconst defaultRequestIdHeader = \"x-request-id\";\n\n/\n Per-request context state stored outside Elysia's shared store.\n /\ninterface ElysiaRequestContextState {\n readonly context: Record<string, unknown>;\n readonly startTime?: number;\n readonly responseHeader?: {\n readonly name: string;\n readonly value: string;\n };\n readonly set?: ElysiaContext[\"set\"];\n}\n\n/\n Normalize request context options.\n /\nfunction normalizeRequestContextOptions(\n options: boolean \| RequestContextOptions \| undefined,\n): RequestContextOptions \| undefined {\n if (options === true) return {};\n if (options === false \|\| options == null) return undefined;\n return options;\n}\n\n/\n Normalize request ID options.\n /\nfunction normalizeRequestIdOptions(\n options: boolean \| RequestIdOptions \| undefined,\n): RequestIdOptions \| undefined {\n if (options === false) return undefined;\n if (options === true \|\| options == null) return {};\n return options;\n}\n\n/\n Generate a request ID with Web Crypto when possible.\n /\nfunction generateRequestId(): string {\n if (typeof globalThis.crypto?.randomUUID === \"function\") {\n return globalThis.crypto.randomUUID();\n }\n return `${Date.now().toString(36)}-${Math.random().toString(36).slice(2)}`;\n}\n\n/\n Normalize an incoming request ID.\n /\nfunction defaultNormalizeRequestId(value: string): string \| null {\n const trimmed = value.trim();\n return trimmed === \"\" ? null : trimmed;\n}\n\n/\n Resolve a request path from a request URL.\n /\nfunction getPath(request: Request): string {\n return new URL(request.url, \"http://localhost\").pathname;\n}\n\n/\n Resolve the request ID for a request.\n /\nfunction resolveRequestId(\n request: Request,\n options: RequestIdOptions,\n): {\n readonly property: string;\n readonly value: string;\n readonly responseHeader?: string;\n} {\n const property = options.property ?? \"requestId\";\n const normalize = options.normalize ?? defaultNormalizeRequestId;\n const headerNames = options.headerNames ?? [defaultRequestIdHeader];\n for (const headerName of headerNames) {\n const headerValue = request.headers.get(headerName);\n if (headerValue == null) continue;\n const normalized = normalize(headerValue);\n if (normalized != null) {\n const responseHeader = options.responseHeader ?? defaultRequestIdHeader;\n return {\n property,\n value: normalized,\n responseHeader: responseHeader === false ? undefined : responseHeader,\n };\n }\n }\n const generated = (options.generate ?? generateRequestId)();\n const responseHeader = options.responseHeader ?? defaultRequestIdHeader;\n return {\n property,\n value: generated,\n responseHeader: responseHeader === false ? undefined : responseHeader,\n };\n}\n\n/\n Get referrer from request headers.\n /\nfunction getReferrer(request: Request): string \| undefined {\n return request.headers.get(\"referrer\") ??\n request.headers.get(\"referer\") ??\n undefined;\n}\n\n/\n Get user agent from request headers.\n /\nfunction getUserAgent(request: Request): string \| undefined {\n return request.headers.get(\"user-agent\") ?? undefined;\n}\n\n/\n Get remote address from X-Forwarded-For header.\n /\nfunction getRemoteAddr(request: Request): string \| undefined {\n const forwarded = request.headers.get(\"x-forwarded-for\");\n if (forwarded) {\n // X-Forwarded-For can contain multiple IPs, take the first one\n const firstIp = forwarded.split(\",\")[0].trim();\n return firstIp \|\| undefined;\n }\n return undefined;\n}\n\n/\n Build request context fields from a request.\n /\nfunction buildIncludedContext(\n request: Request,\n resolvedRequestId:\n \| { readonly property: string; readonly value: string }\n \| undefined,\n include: readonly RequestContextField[],\n): Record<string, unknown> {\n const context: Record<string, unknown> = {};\n for (const field of include) {\n switch (field) {\n case \"requestId\":\n if (resolvedRequestId != null) {\n context[resolvedRequestId.property] = resolvedRequestId.value;\n }\n break;\n case \"method\":\n context.method = request.method;\n break;\n case \"url\":\n context.url = request.url;\n break;\n case \"path\":\n context.path = getPath(request);\n break;\n case \"userAgent\":\n context.userAgent = getUserAgent(request);\n break;\n case \"remoteAddr\":\n context.remoteAddr = getRemoteAddr(request);\n break;\n case \"referrer\":\n context.referrer = getReferrer(request);\n break;\n }\n }\n return context;\n}\n\n/\n Build the implicit context for a request.\n /\nasync function buildRequestContext(\n request: Request,\n options: RequestContextOptions,\n): Promise<ElysiaRequestContextState> {\n const requestIdOptions = normalizeRequestIdOptions(options.requestId);\n const resolvedRequestId = requestIdOptions == null\n ? undefined\n : resolveRequestId(request, requestIdOptions);\n const include = options.include ??\n (resolvedRequestId == null ? [] : [\"requestId\"] as const);\n const context = buildIncludedContext(request, resolvedRequestId, include);\n let set: ElysiaContext[\"set\"] \| undefined;\n if (options.enrich != null) {\n set = { status: 200, headers: {} };\n Object.assign(\n context,\n await options.enrich({\n request,\n path: getPath(request),\n set,\n }),\n );\n }\n const responseHeader = resolvedRequestId?.responseHeader == null\n ? undefined\n : {\n name: resolvedRequestId.responseHeader,\n value: resolvedRequestId.value,\n };\n return { context, responseHeader, set };\n}\n\n/\n Get content length from response headers.\n /\nfunction getContentLength(\n headers: Record<string, string \| undefined>,\n): string \| undefined {\n const contentLength = headers[\"content-length\"];\n if (contentLength === undefined \|\| contentLength === null) return undefined;\n return contentLength;\n}\n\n/\n Build structured log properties from context.\n /\nfunction buildProperties(\n ctx: ElysiaContext,\n responseTime: number,\n): RequestLogProperties {\n return {\n method: ctx.request.method,\n url: ctx.request.url,\n path: ctx.path,\n status: ctx.set.status,\n responseTime,\n contentLength: getContentLength(ctx.set.headers),\n remoteAddr: getRemoteAddr(ctx.request),\n userAgent: getUserAgent(ctx.request),\n referrer: getReferrer(ctx.request),\n };\n}\n\n/\n Add request context fields to a request log result.\n /\nfunction withRequestLogContext(\n result: string \| Record<string, unknown>,\n context: Record<string, unknown>,\n): string \| Record<string, unknown> {\n if (typeof result === \"string\") return result;\n return { ...result, ...context };\n}\n\n/\n Combined format (Apache Combined Log Format).\n * Returns all structured properties.\n /\nfunction formatCombined(\n ctx: ElysiaContext,\n responseTime: number,\n): Record<string, unknown> {\n return { ...buildProperties(ctx, responseTime) };\n}\n\n/\n Common format (Apache Common Log Format).\n * Like combined but without referrer and userAgent.\n /\nfunction formatCommon(\n ctx: ElysiaContext,\n responseTime: number,\n): Record<string, unknown> {\n const props = buildProperties(ctx, responseTime);\n const { referrer: _referrer, userAgent: _userAgent, ...rest } = props;\n return rest;\n}\n\n/\n Dev format (colored output for development).\n * :method :path :status :response-time ms - :res[content-length]\n /\nfunction formatDev(ctx: ElysiaContext, responseTime: number): string {\n const contentLength = getContentLength(ctx.set.headers) ?? \"-\";\n return `${ctx.request.method} ${ctx.path} ${ctx.set.status} ${\n responseTime.toFixed(3)\n } ms - ${contentLength}`;\n}\n\n/\n Short format.\n * :remote-addr :method :url :status :res[content-length] - :response-time ms\n /\nfunction formatShort(ctx: ElysiaContext, responseTime: number): string {\n const remoteAddr = getRemoteAddr(ctx.request) ?? \"-\";\n const contentLength = getContentLength(ctx.set.headers) ?? \"-\";\n return `${remoteAddr} ${ctx.request.method} ${ctx.request.url} ${ctx.set.status} ${contentLength} - ${\n responseTime.toFixed(3)\n } ms`;\n}\n\n/\n Tiny format (minimal output).\n * :method :path :status :res[content-length] - :response-time ms\n /\nfunction formatTiny(ctx: ElysiaContext, responseTime: number): string {\n const contentLength = getContentLength(ctx.set.headers) ?? \"-\";\n return `${ctx.request.method} ${ctx.path} ${ctx.set.status} ${contentLength} - ${\n responseTime.toFixed(3)\n } ms`;\n}\n\n/\n Map of predefined format functions.\n /\nconst predefinedFormats: Record<PredefinedFormat, FormatFunction> = {\n combined: formatCombined,\n common: formatCommon,\n dev: formatDev,\n short: formatShort,\n tiny: formatTiny,\n};\n\n/\n Normalize category to array format.\n /\nfunction normalizeCategory(\n category: string \| readonly string[],\n): readonly string[] {\n return typeof category === \"string\" ? [category] : category;\n}\n\n/\n Mapping of Elysia error codes to HTTP status codes.\n /\nconst errorCodeToStatus: Record<string, number> = {\n NOT_FOUND: 404,\n VALIDATION: 422,\n PARSE: 400,\n INTERNAL_SERVER_ERROR: 500,\n INVALID_COOKIE_SIGNATURE: 400,\n UNKNOWN: 500,\n};\n\n/\n Get the HTTP status code from an error context.\n * Checks error.status first, then falls back to error code mapping.\n /\nfunction getErrorStatus(\n code: string \| number,\n error: unknown,\n setStatus: number,\n): number {\n // If code is already a number, use it as status\n if (typeof code === \"number\") {\n return code;\n }\n // Check if error has a status property (Elysia custom errors)\n if (\n error != null &&\n typeof error === \"object\" &&\n \"status\" in error &&\n typeof error.status === \"number\"\n ) {\n return error.status;\n }\n // Fall back to error code mapping\n if (code in errorCodeToStatus) {\n return errorCodeToStatus[code];\n }\n // Use set.status as last resort\n return setStatus;\n}\n\n/\n Internal store type for timing.\n /\ninterface LoggerStore {\n startTime: number;\n}\n\n/\n Creates Elysia plugin for HTTP request logging using LogTape.\n \n This plugin provides Morgan-compatible request logging with LogTape\n * as the backend, supporting structured logging and customizable formats.\n \n @example Basic usage\n * ```typescript\n * import { Elysia } from \"elysia\";\n * import { configure, getConsoleSink } from \"@logtape/logtape\";\n * import { elysiaLogger } from \"@logtape/elysia\";\n \n await configure({\n * sinks: { console: getConsoleSink() },\n * loggers: [\n * { category: [\"elysia\"], sinks: [\"console\"], lowestLevel: \"info\" }\n * ],\n * });\n \n const app = new Elysia()\n * .use(elysiaLogger())\n * .get(\"/\", () => ({ hello: \"world\" }))\n * .listen(3000);\n * ```\n \n @example With custom options\n * ```typescript\n * app.use(elysiaLogger({\n * category: [\"myapp\", \"http\"],\n * level: \"debug\",\n * format: \"dev\",\n * skip: (ctx) => ctx.path === \"/health\",\n * scope: \"scoped\",\n * }));\n * ```\n \n @example With custom format function\n * ```typescript\n * app.use(elysiaLogger({\n * format: (ctx, responseTime) => ({\n * method: ctx.request.method,\n * path: ctx.path,\n * status: ctx.set.status,\n * duration: responseTime,\n * }),\n * }));\n * ```\n \n @param options Configuration options for the plugin.\n * @returns Elysia plugin instance.\n * @since 2.0.0\n */\n// deno-lint-ignore no-explicit-any\nexport function elysiaLogger(options: ElysiaLogTapeOptions = {}): Elysia<any> {\n const category = normalizeCategory(options.category ?? [\"elysia\"]);\n const logger = getLogger(category);\n const level = options.level ?? \"info\";\n const formatOption = options.format ?? \"combined\";\n const skip = options.skip ?? (() => false);\n const logRequest = options.logRequest ?? false;\n const scope = options.scope ?? \"global\";\n const contextOptions = normalizeRequestContextOptions(options.context);\n const requestContextStates = new WeakMap<\n Request,\n ElysiaRequestContextState\n >();\n const shouldWrapContext = contextOptions != null && scope !== \"local\";\n\n // Resolve format function\n const formatFn: FormatFunction = typeof formatOption === \"string\"\n ? predefinedFormats[formatOption]\n : formatOption;\n\n const logMethod = logger[level].bind(logger);\n const errorLogMethod = logger.error.bind(logger);\n\n const buildAndStoreRequestContext = async (\n request: Request,\n ): Promise<ElysiaRequestContextState \| undefined> => {\n if (contextOptions == null) return undefined;\n const existingContext = requestContextStates.get(request);\n if (existingContext != null) return existingContext;\n const startTime = performance.now();\n const requestContext = {\n ...await buildRequestContext(request, contextOptions),\n startTime,\n };\n requestContextStates.set(request, requestContext);\n return requestContext;\n };\n\n const applyRequestContextToSet = (\n set: ElysiaContext[\"set\"],\n requestContext: ElysiaRequestContextState \| undefined,\n ): void => {\n if (requestContext?.responseHeader != null) {\n set.headers[requestContext.responseHeader.name] =\n requestContext.responseHeader.value;\n }\n if (requestContext?.set != null) {\n if (requestContext.set.status !== 200) {\n set.status = requestContext.set.status;\n }\n Object.assign(set.headers, requestContext.set.headers);\n }\n };\n\n // deno-lint-ignore no-explicit-any\n let plugin: Elysia<any, any, any, any, any, any, any> = new Elysia({\n name: \"@logtape/elysia\",\n seed: options,\n });\n\n if (shouldWrapContext) {\n // Elysia lifecycle hooks cannot wrap downstream handlers, so use wrap()\n // to keep AsyncLocalStorage active for the whole route execution.\n plugin = plugin.wrap((handle) => {\n return async (request: Request) => {\n const requestContext = await buildAndStoreRequestContext(request);\n return await withContext(\n requestContext?.context ?? {},\n () => handle(request),\n );\n };\n });\n }\n\n plugin = plugin\n .state(\"startTime\", 0)\n .onRequest(async ({ request, set, store }) => {\n let requestContext = requestContextStates.get(request);\n if (requestContext == null && shouldWrapContext) {\n requestContext = await buildAndStoreRequestContext(request);\n }\n (store as LoggerStore).startTime = requestContext?.startTime ??\n performance.now();\n applyRequestContextToSet(set, requestContext);\n });\n\n if (scope === \"local\" && (contextOptions != null \|\| logRequest)) {\n plugin = plugin.onBeforeHandle(async (ctx) => {\n const requestContext = await buildAndStoreRequestContext(ctx.request);\n (ctx.store as LoggerStore).startTime = requestContext?.startTime ??\n performance.now();\n applyRequestContextToSet(ctx.set, requestContext);\n if (logRequest && !skip(ctx as unknown as ElysiaContext)) {\n const context = requestContext?.context ?? {};\n const result = withRequestLogContext(\n formatFn(ctx as unknown as ElysiaContext, 0),\n context,\n );\n if (typeof result === \"string\") {\n logMethod(result, context);\n } else {\n logMethod(\"{method} {url}\", result);\n }\n }\n });\n }\n\n if (logRequest) {\n // Log immediately when request arrives\n if (scope !== \"local\") {\n plugin = plugin.onRequest((ctx) => {\n if (!skip(ctx as unknown as ElysiaContext)) {\n const requestContext =\n requestContextStates.get(ctx.request)?.context ??\n {};\n const result = withRequestLogContext(\n formatFn(ctx as unknown as ElysiaContext, 0),\n requestContext,\n );\n if (typeof result === \"string\") {\n logMethod(result, requestContext);\n } else {\n logMethod(\"{method} {url}\", result);\n }\n }\n });\n }\n } else {\n // Log after handler completes\n plugin = plugin.onAfterHandle((ctx) => {\n if (skip(ctx as unknown as ElysiaContext)) return;\n\n const store = ctx.store as LoggerStore;\n const responseTime = performance.now() - store.startTime;\n const requestContext = requestContextStates.get(ctx.request)?.context ??\n {};\n const result = withRequestLogContext(\n formatFn(ctx as unknown as ElysiaContext, responseTime),\n requestContext,\n );\n\n if (typeof result === \"string\") {\n logMethod(result, requestContext);\n } else {\n logMethod(\"{method} {url} {status} - {responseTime} ms\", result);\n }\n });\n }\n\n // Add error logging\n plugin = plugin.onError((ctx) => {\n const store = ctx.store as LoggerStore;\n const responseTime = performance.now() - store.startTime;\n const elysiaCtx = ctx as unknown as ElysiaContext;\n\n if (skip(elysiaCtx)) return;\n\n const props = buildProperties(elysiaCtx, responseTime);\n const requestContext = requestContextStates.get(ctx.request)?.context ?? {};\n // Get the correct HTTP status code from error context\n const status = getErrorStatus(ctx.code, ctx.error, elysiaCtx.set.status);\n // Extract error message safely\n const error = ctx.error as { message?: string } \| undefined;\n const errorMessage = error?.message ?? \"Unknown error\";\n errorLogMethod(\n \"Error: {method} {url} {status} - {responseTime} ms - {errorMessage}\",\n {\n ...props,\n ...requestContext,\n status,\n errorMessage,\n errorCode: ctx.code,\n },\n );\n });\n\n // Apply scope\n if (scope === \"global\") {\n // deno-lint-ignore no-explicit-any\n return plugin.as(\"global\") as unknown as Elysia<any>;\n } else if (scope === \"scoped\") {\n // deno-lint-ignore no-explicit-any\n return plugin.as(\"scoped\") as unknown as Elysia<any>;\n }\n\n // deno-lint-ignore no-explicit-any\n return plugin as unknown as Elysia<any>;\n}\n"],"mappings":"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"}

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@logtape/elysia",
-  "version": "2.2.0-dev.685+1c03a9fb",
+  "version": "2.2.0-dev.688+20e7145c",
   "description": "Elysia adapter for LogTape logging library",
   "keywords": [
     "logging",
@@ -54,7 +54,7 @@
   ],
   "peerDependencies": {
     "elysia": "^1.4.0",
-    "@logtape/logtape": "^2.2.0-dev.685+1c03a9fb"
+    "@logtape/logtape": "^2.2.0-dev.688+20e7145c"
   },
   "devDependencies": {
     "@alinea/suite": "^0.6.3",