@loglayer/express 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Theo Gravity
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,42 @@
+# Express integration for LogLayer
+
+[![NPM Version](https://img.shields.io/npm/v/%40loglayer%2Fexpress)](https://www.npmjs.com/package/@loglayer/express)
+[![NPM Downloads](https://img.shields.io/npm/dm/%40loglayer%2Fexpress)](https://www.npmjs.com/package/@loglayer/express)
+[![TypeScript](https://img.shields.io/badge/%3C%2F%3E-TypeScript-%230074c1.svg)](http://www.typescriptlang.org/)
+
+An [Express](https://expressjs.com) middleware for [LogLayer](https://loglayer.dev) that provides request-scoped logging with automatic request/response logging and error handling.
+
+## Installation
+
+```bash
+npm install @loglayer/express
+```
+
+## Usage
+
+```typescript
+import express from "express";
+import { LogLayer, StructuredTransport } from "loglayer";
+import { expressLogLayer, expressLogLayerErrorHandler } from "@loglayer/express";
+
+const log = new LogLayer({
+  transport: new StructuredTransport({ logger: console }),
+});
+
+const app = express();
+app.use(expressLogLayer({ instance: log }));
+
+app.get("/", (req, res) => {
+  req.log.info("Hello!");
+  res.send("Hello World!");
+});
+
+// Error handler (must be registered after routes)
+app.use(expressLogLayerErrorHandler());
+
+export default app;
+```
+
+## Documentation
+
+For more details, visit [https://loglayer.dev/integrations/express](https://loglayer.dev/integrations/express)

package/dist/index.cjs

@@ -0,0 +1,154 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+
+//#region src/plugin.ts
+function resolveGroupConfig(group) {
+	if (!group) return {
+		nameGroup: void 0,
+		requestGroup: void 0,
+		responseGroup: void 0
+	};
+	if (group === true) return {
+		nameGroup: "express",
+		requestGroup: "express.request",
+		responseGroup: "express.response"
+	};
+	return {
+		nameGroup: group.name ?? "express",
+		requestGroup: group.request ?? "express.request",
+		responseGroup: group.response ?? "express.response"
+	};
+}
+function shouldIgnorePath(path, ignore) {
+	if (!ignore || ignore.length === 0) return false;
+	for (const pattern of ignore) if (typeof pattern === "string") {
+		if (path === pattern) return true;
+	} else if (pattern.test(path)) return true;
+	return false;
+}
+function getRequestId(request, requestIdConfig) {
+	if (requestIdConfig === false) return void 0;
+	if (typeof requestIdConfig === "function") return requestIdConfig(request);
+	return crypto.randomUUID();
+}
+function resolveLoggingConfig(value, defaultEnabled) {
+	if (value === void 0) return defaultEnabled ? {} : false;
+	if (value === true) return {};
+	if (value === false) return false;
+	return value;
+}
+/**
+* Creates an Express middleware that integrates LogLayer for request-scoped logging.
+*
+* The middleware attaches a child LogLayer instance to `req.log` for each request.
+*
+* @example
+* ```typescript
+* import express from "express";
+* import { LogLayer, ConsoleTransport } from "loglayer";
+* import { expressLogLayer } from "@loglayer/express";
+*
+* const log = new LogLayer({ transport: new ConsoleTransport() });
+*
+* const app = express();
+* app.use(expressLogLayer({ instance: log }));
+*
+* app.get("/", (req, res) => {
+*   req.log.info("Hello from route!");
+*   res.send("Hello World!");
+* });
+* ```
+*/
+function expressLogLayer(config) {
+	const { instance, requestId: requestIdConfig = true, autoLogging: autoLoggingConfig = true, contextFn, group: groupConfig } = config;
+	const { requestGroup, responseGroup } = resolveGroupConfig(groupConfig);
+	const autoLogging = autoLoggingConfig === true ? {} : autoLoggingConfig === false ? false : autoLoggingConfig;
+	const requestConfig = autoLogging ? resolveLoggingConfig(autoLogging.request, true) : false;
+	const responseConfig = autoLogging ? resolveLoggingConfig(autoLogging.response, true) : false;
+	const defaultLogLevel = autoLogging ? autoLogging.logLevel ?? "info" : "info";
+	const requestLogLevel = requestConfig ? requestConfig.logLevel ?? defaultLogLevel : defaultLogLevel;
+	const responseLogLevel = responseConfig ? responseConfig.logLevel ?? defaultLogLevel : defaultLogLevel;
+	return (req, res, next) => {
+		const context = {};
+		const reqId = getRequestId(req, requestIdConfig);
+		if (reqId) context.requestId = reqId;
+		if (contextFn) {
+			const additionalContext = contextFn(req);
+			if (additionalContext) Object.assign(context, additionalContext);
+		}
+		const childLogger = instance.child().withContext(context);
+		req.log = childLogger;
+		const startTime = Date.now();
+		const ignorePath = autoLogging ? shouldIgnorePath(req.path, autoLogging.ignore) : true;
+		if (requestConfig && !ignorePath) {
+			let builder = childLogger.withMetadata({ req: {
+				method: req.method,
+				url: req.originalUrl || req.url,
+				remoteAddress: req.ip
+			} });
+			if (requestGroup) builder = builder.withGroup(requestGroup);
+			builder[requestLogLevel]("incoming request");
+		}
+		if (responseConfig && !ignorePath) {
+			const onResponseComplete = () => {
+				res.removeListener("close", onResponseComplete);
+				res.removeListener("finish", onResponseComplete);
+				res.removeListener("error", onResponseComplete);
+				const responseTime = Date.now() - startTime;
+				let builder = childLogger.withMetadata({
+					req: {
+						method: req.method,
+						url: req.originalUrl || req.url,
+						remoteAddress: req.ip
+					},
+					res: { statusCode: res.statusCode },
+					responseTime
+				});
+				if (responseGroup) builder = builder.withGroup(responseGroup);
+				builder[responseLogLevel]("request completed");
+			};
+			res.on("close", onResponseComplete);
+			res.on("finish", onResponseComplete);
+			res.on("error", onResponseComplete);
+		}
+		next();
+	};
+}
+/**
+* Creates an Express error-handling middleware that logs errors via LogLayer.
+*
+* This middleware should be registered after all routes. It logs the error
+* using `req.log` (set by `expressLogLayer`) and passes the error to the
+* next error handler via `next(err)`.
+*
+* @example
+* ```typescript
+* import express from "express";
+* import { expressLogLayer, expressLogLayerErrorHandler } from "@loglayer/express";
+*
+* const app = express();
+* app.use(expressLogLayer({ instance: log }));
+*
+* // ... routes ...
+*
+* app.use(expressLogLayerErrorHandler());
+* app.use((err, req, res, next) => {
+*   res.status(500).send("Internal Server Error");
+* });
+* ```
+*/
+function expressLogLayerErrorHandler(config) {
+	const { nameGroup } = resolveGroupConfig(config?.group);
+	return (err, req, _res, next) => {
+		if (req.log) {
+			let builder = req.log.withError(err).withMetadata({ url: req.originalUrl || req.url });
+			if (nameGroup) builder = builder.withGroup(nameGroup);
+			builder.error("Request error");
+		}
+		next(err);
+	};
+}
+
+//#endregion
+exports.expressLogLayer = expressLogLayer;
+exports.expressLogLayerErrorHandler = expressLogLayerErrorHandler;
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","names":[],"sources":["../src/plugin.ts"],"sourcesContent":["import type { ErrorRequestHandler, NextFunction, Request, Response } from \"express\";\nimport type { ILogLayer } from \"loglayer\";\nimport type {\n  ExpressAutoLoggingConfig,\n  ExpressLogLayerConfig,\n  ExpressRequestLoggingConfig,\n  ExpressResponseLoggingConfig,\n} from \"./types.js\";\n\nfunction resolveGroupConfig(group: ExpressLogLayerConfig[\"group\"]) {\n  if (!group) return { nameGroup: undefined, requestGroup: undefined, responseGroup: undefined };\n  if (group === true)\n    return { nameGroup: \"express\", requestGroup: \"express.request\", responseGroup: \"express.response\" };\n  return {\n    nameGroup: group.name ?? \"express\",\n    requestGroup: group.request ?? \"express.request\",\n    responseGroup: group.response ?? \"express.response\",\n  };\n}\n\nfunction shouldIgnorePath(path: string, ignore?: Array<string | RegExp>): boolean {\n  if (!ignore || ignore.length === 0) return false;\n\n  for (const pattern of ignore) {\n    if (typeof pattern === \"string\") {\n      if (path === pattern) return true;\n    } else if (pattern.test(path)) {\n      return true;\n    }\n  }\n\n  return false;\n}\n\nfunction getRequestId(request: Request, requestIdConfig: ExpressLogLayerConfig[\"requestId\"]): string | undefined {\n  if (requestIdConfig === false) return undefined;\n  if (typeof requestIdConfig === \"function\") return requestIdConfig(request);\n  return crypto.randomUUID();\n}\n\nfunction resolveLoggingConfig<T>(value: boolean | T | undefined, defaultEnabled: boolean): T | false {\n  if (value === undefined) return defaultEnabled ? ({} as T) : false;\n  if (value === true) return {} as T;\n  if (value === false) return false;\n  return value;\n}\n\n/**\n * Creates an Express middleware that integrates LogLayer for request-scoped logging.\n *\n * The middleware attaches a child LogLayer instance to `req.log` for each request.\n *\n * @example\n * ```typescript\n * import express from \"express\";\n * import { LogLayer, ConsoleTransport } from \"loglayer\";\n * import { expressLogLayer } from \"@loglayer/express\";\n *\n * const log = new LogLayer({ transport: new ConsoleTransport() });\n *\n * const app = express();\n * app.use(expressLogLayer({ instance: log }));\n *\n * app.get(\"/\", (req, res) => {\n *   req.log.info(\"Hello from route!\");\n *   res.send(\"Hello World!\");\n * });\n * ```\n */\nexport function expressLogLayer(config: ExpressLogLayerConfig) {\n  const {\n    instance,\n    requestId: requestIdConfig = true,\n    autoLogging: autoLoggingConfig = true,\n    contextFn,\n    group: groupConfig,\n  } = config;\n  const { requestGroup, responseGroup } = resolveGroupConfig(groupConfig);\n\n  const autoLogging: ExpressAutoLoggingConfig | false =\n    autoLoggingConfig === true ? {} : autoLoggingConfig === false ? false : autoLoggingConfig;\n\n  // Resolve auto-logging configs once\n  const requestConfig = autoLogging\n    ? resolveLoggingConfig<ExpressRequestLoggingConfig>(autoLogging.request, true)\n    : false;\n  const responseConfig = autoLogging\n    ? resolveLoggingConfig<ExpressResponseLoggingConfig>(autoLogging.response, true)\n    : false;\n\n  const defaultLogLevel = autoLogging ? (autoLogging.logLevel ?? \"info\") : \"info\";\n  const requestLogLevel = requestConfig ? (requestConfig.logLevel ?? defaultLogLevel) : defaultLogLevel;\n  const responseLogLevel = responseConfig ? (responseConfig.logLevel ?? defaultLogLevel) : defaultLogLevel;\n\n  return (req: Request, res: Response, next: NextFunction) => {\n    const context: Record<string, any> = {};\n\n    const reqId = getRequestId(req, requestIdConfig);\n    if (reqId) {\n      context.requestId = reqId;\n    }\n\n    if (contextFn) {\n      const additionalContext = contextFn(req);\n      if (additionalContext) {\n        Object.assign(context, additionalContext);\n      }\n    }\n\n    // Create child logger and attach to req.log\n    const childLogger = instance.child().withContext(context) as ILogLayer;\n    (req as any).log = childLogger;\n\n    const startTime = Date.now();\n    const ignorePath = autoLogging ? shouldIgnorePath(req.path, autoLogging.ignore) : true;\n\n    // Log incoming request\n    if (requestConfig && !ignorePath) {\n      let builder = childLogger.withMetadata({\n        req: {\n          method: req.method,\n          url: req.originalUrl || req.url,\n          remoteAddress: req.ip,\n        },\n      });\n      if (requestGroup) builder = builder.withGroup(requestGroup);\n      builder[requestLogLevel](\"incoming request\");\n    }\n\n    // Log response on completion (listen on close, finish, and error for reliability)\n    if (responseConfig && !ignorePath) {\n      const onResponseComplete = () => {\n        res.removeListener(\"close\", onResponseComplete);\n        res.removeListener(\"finish\", onResponseComplete);\n        res.removeListener(\"error\", onResponseComplete);\n\n        const responseTime = Date.now() - startTime;\n        let builder = childLogger.withMetadata({\n          req: {\n            method: req.method,\n            url: req.originalUrl || req.url,\n            remoteAddress: req.ip,\n          },\n          res: {\n            statusCode: res.statusCode,\n          },\n          responseTime,\n        });\n        if (responseGroup) builder = builder.withGroup(responseGroup);\n        builder[responseLogLevel](\"request completed\");\n      };\n\n      res.on(\"close\", onResponseComplete);\n      res.on(\"finish\", onResponseComplete);\n      res.on(\"error\", onResponseComplete);\n    }\n\n    next();\n  };\n}\n\n/**\n * Creates an Express error-handling middleware that logs errors via LogLayer.\n *\n * This middleware should be registered after all routes. It logs the error\n * using `req.log` (set by `expressLogLayer`) and passes the error to the\n * next error handler via `next(err)`.\n *\n * @example\n * ```typescript\n * import express from \"express\";\n * import { expressLogLayer, expressLogLayerErrorHandler } from \"@loglayer/express\";\n *\n * const app = express();\n * app.use(expressLogLayer({ instance: log }));\n *\n * // ... routes ...\n *\n * app.use(expressLogLayerErrorHandler());\n * app.use((err, req, res, next) => {\n *   res.status(500).send(\"Internal Server Error\");\n * });\n * ```\n */\nexport function expressLogLayerErrorHandler(config?: { group?: ExpressLogLayerConfig[\"group\"] }): ErrorRequestHandler {\n  const { nameGroup } = resolveGroupConfig(config?.group);\n\n  return (err: Error, req: Request, _res: Response, next: NextFunction) => {\n    if ((req as any).log) {\n      let builder = ((req as any).log as ILogLayer).withError(err).withMetadata({ url: req.originalUrl || req.url });\n      if (nameGroup) builder = builder.withGroup(nameGroup);\n      builder.error(\"Request error\");\n    }\n    next(err);\n  };\n}\n"],"mappings":"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"}

package/dist/index.d.cts

@@ -0,0 +1,184 @@
+import { ILogLayer, LogLevelType } from "loglayer";
+import { ErrorRequestHandler, NextFunction, Request, Response } from "express";
+
+//#region src/types.d.ts
+/**
+ * Configuration for request logging.
+ * Logs when a request is received, before the route handler runs.
+ */
+interface ExpressRequestLoggingConfig {
+  /**
+   * The log level to use for request logs.
+   * @default "info"
+   */
+  logLevel?: LogLevelType;
+}
+/**
+ * Configuration for response logging.
+ * Logs after the route handler completes and the response is sent.
+ */
+interface ExpressResponseLoggingConfig {
+  /**
+   * The log level to use for response logs.
+   * @default "info"
+   */
+  logLevel?: LogLevelType;
+}
+/**
+ * Configuration for the auto-logging feature.
+ */
+interface ExpressAutoLoggingConfig {
+  /**
+   * The log level to use for both request and response logs (can be overridden individually).
+   * @default "info"
+   */
+  logLevel?: LogLevelType;
+  /**
+   * Array of path patterns to ignore from auto-logging.
+   * Supports exact string matches and RegExp.
+   * @example ["/health", /^\/internal\//]
+   */
+  ignore?: Array<string | RegExp>;
+  /**
+   * Controls request logging (fires when request is received).
+   * When enabled, logs: `"incoming request"` with metadata `{ req: { method, url, remoteAddress } }`.
+   * - `true`: enables request logging (default)
+   * - `false`: disables request logging
+   * - `object`: enables with custom configuration
+   * @default true
+   */
+  request?: boolean | ExpressRequestLoggingConfig;
+  /**
+   * Controls response logging (fires after response is sent).
+   * When enabled, logs: `"request completed"` with metadata `{ req: { method, url, remoteAddress }, res: { statusCode }, responseTime }`.
+   * - `true`: enables response logging (default)
+   * - `false`: disables response logging
+   * - `object`: enables with custom configuration
+   * @default true
+   */
+  response?: boolean | ExpressResponseLoggingConfig;
+}
+/**
+ * Group names for auto-logged messages.
+ */
+interface ExpressGroupConfig {
+  /**
+   * Group name for internal auto-logs (errors, etc.).
+   * @default "express"
+   */
+  name?: string;
+  /**
+   * Group name for auto-logged incoming request messages.
+   * @default "express.request"
+   */
+  request?: string;
+  /**
+   * Group name for auto-logged response messages.
+   * @default "express.response"
+   */
+  response?: string;
+}
+/**
+ * Configuration for the Express LogLayer integration middleware.
+ */
+interface ExpressLogLayerConfig {
+  /**
+   * The LogLayer instance to use for logging.
+   * A child logger will be created for each request.
+   */
+  instance: ILogLayer;
+  /**
+   * Controls request ID generation.
+   * - `true`: generates a request ID using `crypto.randomUUID()` (default)
+   * - `false`: disables request ID generation
+   * - `function`: custom function to generate a request ID from the request
+   * @default true
+   */
+  requestId?: boolean | ((request: Request) => string);
+  /**
+   * Controls automatic request/response logging.
+   * - `true`: enables auto-logging with defaults (default)
+   * - `false`: disables auto-logging
+   * - `object`: enables auto-logging with custom configuration
+   * @default true
+   */
+  autoLogging?: boolean | ExpressAutoLoggingConfig;
+  /**
+   * Optional function to extract additional context from the request.
+   * The returned object will be merged into the per-request logger's context.
+   */
+  contextFn?: (request: Request) => Record<string, any>;
+  /**
+   * Tags auto-logged request/response messages with groups for filtering/routing.
+   * - `true`: tag with default group names (`"express.request"`, `"express.response"`)
+   * - `object`: tag with custom group names
+   *
+   * Only affects auto-logged messages. User logs from route handlers are not tagged.
+   *
+   * @see {@link https://loglayer.dev/logging-api/groups.html | Groups Docs}
+   */
+  group?: boolean | ExpressGroupConfig;
+}
+//#endregion
+//#region src/plugin.d.ts
+/**
+ * Creates an Express middleware that integrates LogLayer for request-scoped logging.
+ *
+ * The middleware attaches a child LogLayer instance to `req.log` for each request.
+ *
+ * @example
+ * ```typescript
+ * import express from "express";
+ * import { LogLayer, ConsoleTransport } from "loglayer";
+ * import { expressLogLayer } from "@loglayer/express";
+ *
+ * const log = new LogLayer({ transport: new ConsoleTransport() });
+ *
+ * const app = express();
+ * app.use(expressLogLayer({ instance: log }));
+ *
+ * app.get("/", (req, res) => {
+ *   req.log.info("Hello from route!");
+ *   res.send("Hello World!");
+ * });
+ * ```
+ */
+declare function expressLogLayer(config: ExpressLogLayerConfig): (req: Request, res: Response, next: NextFunction) => void;
+/**
+ * Creates an Express error-handling middleware that logs errors via LogLayer.
+ *
+ * This middleware should be registered after all routes. It logs the error
+ * using `req.log` (set by `expressLogLayer`) and passes the error to the
+ * next error handler via `next(err)`.
+ *
+ * @example
+ * ```typescript
+ * import express from "express";
+ * import { expressLogLayer, expressLogLayerErrorHandler } from "@loglayer/express";
+ *
+ * const app = express();
+ * app.use(expressLogLayer({ instance: log }));
+ *
+ * // ... routes ...
+ *
+ * app.use(expressLogLayerErrorHandler());
+ * app.use((err, req, res, next) => {
+ *   res.status(500).send("Internal Server Error");
+ * });
+ * ```
+ */
+declare function expressLogLayerErrorHandler(config?: {
+  group?: ExpressLogLayerConfig["group"];
+}): ErrorRequestHandler;
+//#endregion
+//#region src/index.d.ts
+declare global {
+  namespace Express {
+    interface Request {
+      log: ILogLayer;
+    }
+  }
+}
+//#endregion
+export { type ExpressAutoLoggingConfig, type ExpressGroupConfig, type ExpressLogLayerConfig, type ExpressRequestLoggingConfig, type ExpressResponseLoggingConfig, expressLogLayer, expressLogLayerErrorHandler };
+//# sourceMappingURL=index.d.cts.map

package/dist/index.d.ts

@@ -0,0 +1,184 @@
+import { ILogLayer, LogLevelType } from "loglayer";
+import { ErrorRequestHandler, NextFunction, Request, Response } from "express";
+
+//#region src/types.d.ts
+/**
+ * Configuration for request logging.
+ * Logs when a request is received, before the route handler runs.
+ */
+interface ExpressRequestLoggingConfig {
+  /**
+   * The log level to use for request logs.
+   * @default "info"
+   */
+  logLevel?: LogLevelType;
+}
+/**
+ * Configuration for response logging.
+ * Logs after the route handler completes and the response is sent.
+ */
+interface ExpressResponseLoggingConfig {
+  /**
+   * The log level to use for response logs.
+   * @default "info"
+   */
+  logLevel?: LogLevelType;
+}
+/**
+ * Configuration for the auto-logging feature.
+ */
+interface ExpressAutoLoggingConfig {
+  /**
+   * The log level to use for both request and response logs (can be overridden individually).
+   * @default "info"
+   */
+  logLevel?: LogLevelType;
+  /**
+   * Array of path patterns to ignore from auto-logging.
+   * Supports exact string matches and RegExp.
+   * @example ["/health", /^\/internal\//]
+   */
+  ignore?: Array<string | RegExp>;
+  /**
+   * Controls request logging (fires when request is received).
+   * When enabled, logs: `"incoming request"` with metadata `{ req: { method, url, remoteAddress } }`.
+   * - `true`: enables request logging (default)
+   * - `false`: disables request logging
+   * - `object`: enables with custom configuration
+   * @default true
+   */
+  request?: boolean | ExpressRequestLoggingConfig;
+  /**
+   * Controls response logging (fires after response is sent).
+   * When enabled, logs: `"request completed"` with metadata `{ req: { method, url, remoteAddress }, res: { statusCode }, responseTime }`.
+   * - `true`: enables response logging (default)
+   * - `false`: disables response logging
+   * - `object`: enables with custom configuration
+   * @default true
+   */
+  response?: boolean | ExpressResponseLoggingConfig;
+}
+/**
+ * Group names for auto-logged messages.
+ */
+interface ExpressGroupConfig {
+  /**
+   * Group name for internal auto-logs (errors, etc.).
+   * @default "express"
+   */
+  name?: string;
+  /**
+   * Group name for auto-logged incoming request messages.
+   * @default "express.request"
+   */
+  request?: string;
+  /**
+   * Group name for auto-logged response messages.
+   * @default "express.response"
+   */
+  response?: string;
+}
+/**
+ * Configuration for the Express LogLayer integration middleware.
+ */
+interface ExpressLogLayerConfig {
+  /**
+   * The LogLayer instance to use for logging.
+   * A child logger will be created for each request.
+   */
+  instance: ILogLayer;
+  /**
+   * Controls request ID generation.
+   * - `true`: generates a request ID using `crypto.randomUUID()` (default)
+   * - `false`: disables request ID generation
+   * - `function`: custom function to generate a request ID from the request
+   * @default true
+   */
+  requestId?: boolean | ((request: Request) => string);
+  /**
+   * Controls automatic request/response logging.
+   * - `true`: enables auto-logging with defaults (default)
+   * - `false`: disables auto-logging
+   * - `object`: enables auto-logging with custom configuration
+   * @default true
+   */
+  autoLogging?: boolean | ExpressAutoLoggingConfig;
+  /**
+   * Optional function to extract additional context from the request.
+   * The returned object will be merged into the per-request logger's context.
+   */
+  contextFn?: (request: Request) => Record<string, any>;
+  /**
+   * Tags auto-logged request/response messages with groups for filtering/routing.
+   * - `true`: tag with default group names (`"express.request"`, `"express.response"`)
+   * - `object`: tag with custom group names
+   *
+   * Only affects auto-logged messages. User logs from route handlers are not tagged.
+   *
+   * @see {@link https://loglayer.dev/logging-api/groups.html | Groups Docs}
+   */
+  group?: boolean | ExpressGroupConfig;
+}
+//#endregion
+//#region src/plugin.d.ts
+/**
+ * Creates an Express middleware that integrates LogLayer for request-scoped logging.
+ *
+ * The middleware attaches a child LogLayer instance to `req.log` for each request.
+ *
+ * @example
+ * ```typescript
+ * import express from "express";
+ * import { LogLayer, ConsoleTransport } from "loglayer";
+ * import { expressLogLayer } from "@loglayer/express";
+ *
+ * const log = new LogLayer({ transport: new ConsoleTransport() });
+ *
+ * const app = express();
+ * app.use(expressLogLayer({ instance: log }));
+ *
+ * app.get("/", (req, res) => {
+ *   req.log.info("Hello from route!");
+ *   res.send("Hello World!");
+ * });
+ * ```
+ */
+declare function expressLogLayer(config: ExpressLogLayerConfig): (req: Request, res: Response, next: NextFunction) => void;
+/**
+ * Creates an Express error-handling middleware that logs errors via LogLayer.
+ *
+ * This middleware should be registered after all routes. It logs the error
+ * using `req.log` (set by `expressLogLayer`) and passes the error to the
+ * next error handler via `next(err)`.
+ *
+ * @example
+ * ```typescript
+ * import express from "express";
+ * import { expressLogLayer, expressLogLayerErrorHandler } from "@loglayer/express";
+ *
+ * const app = express();
+ * app.use(expressLogLayer({ instance: log }));
+ *
+ * // ... routes ...
+ *
+ * app.use(expressLogLayerErrorHandler());
+ * app.use((err, req, res, next) => {
+ *   res.status(500).send("Internal Server Error");
+ * });
+ * ```
+ */
+declare function expressLogLayerErrorHandler(config?: {
+  group?: ExpressLogLayerConfig["group"];
+}): ErrorRequestHandler;
+//#endregion
+//#region src/index.d.ts
+declare global {
+  namespace Express {
+    interface Request {
+      log: ILogLayer;
+    }
+  }
+}
+//#endregion
+export { type ExpressAutoLoggingConfig, type ExpressGroupConfig, type ExpressLogLayerConfig, type ExpressRequestLoggingConfig, type ExpressResponseLoggingConfig, expressLogLayer, expressLogLayerErrorHandler };
+//# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -0,0 +1,151 @@
+//#region src/plugin.ts
+function resolveGroupConfig(group) {
+	if (!group) return {
+		nameGroup: void 0,
+		requestGroup: void 0,
+		responseGroup: void 0
+	};
+	if (group === true) return {
+		nameGroup: "express",
+		requestGroup: "express.request",
+		responseGroup: "express.response"
+	};
+	return {
+		nameGroup: group.name ?? "express",
+		requestGroup: group.request ?? "express.request",
+		responseGroup: group.response ?? "express.response"
+	};
+}
+function shouldIgnorePath(path, ignore) {
+	if (!ignore || ignore.length === 0) return false;
+	for (const pattern of ignore) if (typeof pattern === "string") {
+		if (path === pattern) return true;
+	} else if (pattern.test(path)) return true;
+	return false;
+}
+function getRequestId(request, requestIdConfig) {
+	if (requestIdConfig === false) return void 0;
+	if (typeof requestIdConfig === "function") return requestIdConfig(request);
+	return crypto.randomUUID();
+}
+function resolveLoggingConfig(value, defaultEnabled) {
+	if (value === void 0) return defaultEnabled ? {} : false;
+	if (value === true) return {};
+	if (value === false) return false;
+	return value;
+}
+/**
+* Creates an Express middleware that integrates LogLayer for request-scoped logging.
+*
+* The middleware attaches a child LogLayer instance to `req.log` for each request.
+*
+* @example
+* ```typescript
+* import express from "express";
+* import { LogLayer, ConsoleTransport } from "loglayer";
+* import { expressLogLayer } from "@loglayer/express";
+*
+* const log = new LogLayer({ transport: new ConsoleTransport() });
+*
+* const app = express();
+* app.use(expressLogLayer({ instance: log }));
+*
+* app.get("/", (req, res) => {
+*   req.log.info("Hello from route!");
+*   res.send("Hello World!");
+* });
+* ```
+*/
+function expressLogLayer(config) {
+	const { instance, requestId: requestIdConfig = true, autoLogging: autoLoggingConfig = true, contextFn, group: groupConfig } = config;
+	const { requestGroup, responseGroup } = resolveGroupConfig(groupConfig);
+	const autoLogging = autoLoggingConfig === true ? {} : autoLoggingConfig === false ? false : autoLoggingConfig;
+	const requestConfig = autoLogging ? resolveLoggingConfig(autoLogging.request, true) : false;
+	const responseConfig = autoLogging ? resolveLoggingConfig(autoLogging.response, true) : false;
+	const defaultLogLevel = autoLogging ? autoLogging.logLevel ?? "info" : "info";
+	const requestLogLevel = requestConfig ? requestConfig.logLevel ?? defaultLogLevel : defaultLogLevel;
+	const responseLogLevel = responseConfig ? responseConfig.logLevel ?? defaultLogLevel : defaultLogLevel;
+	return (req, res, next) => {
+		const context = {};
+		const reqId = getRequestId(req, requestIdConfig);
+		if (reqId) context.requestId = reqId;
+		if (contextFn) {
+			const additionalContext = contextFn(req);
+			if (additionalContext) Object.assign(context, additionalContext);
+		}
+		const childLogger = instance.child().withContext(context);
+		req.log = childLogger;
+		const startTime = Date.now();
+		const ignorePath = autoLogging ? shouldIgnorePath(req.path, autoLogging.ignore) : true;
+		if (requestConfig && !ignorePath) {
+			let builder = childLogger.withMetadata({ req: {
+				method: req.method,
+				url: req.originalUrl || req.url,
+				remoteAddress: req.ip
+			} });
+			if (requestGroup) builder = builder.withGroup(requestGroup);
+			builder[requestLogLevel]("incoming request");
+		}
+		if (responseConfig && !ignorePath) {
+			const onResponseComplete = () => {
+				res.removeListener("close", onResponseComplete);
+				res.removeListener("finish", onResponseComplete);
+				res.removeListener("error", onResponseComplete);
+				const responseTime = Date.now() - startTime;
+				let builder = childLogger.withMetadata({
+					req: {
+						method: req.method,
+						url: req.originalUrl || req.url,
+						remoteAddress: req.ip
+					},
+					res: { statusCode: res.statusCode },
+					responseTime
+				});
+				if (responseGroup) builder = builder.withGroup(responseGroup);
+				builder[responseLogLevel]("request completed");
+			};
+			res.on("close", onResponseComplete);
+			res.on("finish", onResponseComplete);
+			res.on("error", onResponseComplete);
+		}
+		next();
+	};
+}
+/**
+* Creates an Express error-handling middleware that logs errors via LogLayer.
+*
+* This middleware should be registered after all routes. It logs the error
+* using `req.log` (set by `expressLogLayer`) and passes the error to the
+* next error handler via `next(err)`.
+*
+* @example
+* ```typescript
+* import express from "express";
+* import { expressLogLayer, expressLogLayerErrorHandler } from "@loglayer/express";
+*
+* const app = express();
+* app.use(expressLogLayer({ instance: log }));
+*
+* // ... routes ...
+*
+* app.use(expressLogLayerErrorHandler());
+* app.use((err, req, res, next) => {
+*   res.status(500).send("Internal Server Error");
+* });
+* ```
+*/
+function expressLogLayerErrorHandler(config) {
+	const { nameGroup } = resolveGroupConfig(config?.group);
+	return (err, req, _res, next) => {
+		if (req.log) {
+			let builder = req.log.withError(err).withMetadata({ url: req.originalUrl || req.url });
+			if (nameGroup) builder = builder.withGroup(nameGroup);
+			builder.error("Request error");
+		}
+		next(err);
+	};
+}
+
+//#endregion
+export { expressLogLayer, expressLogLayerErrorHandler };
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../src/plugin.ts"],"sourcesContent":["import type { ErrorRequestHandler, NextFunction, Request, Response } from \"express\";\nimport type { ILogLayer } from \"loglayer\";\nimport type {\n  ExpressAutoLoggingConfig,\n  ExpressLogLayerConfig,\n  ExpressRequestLoggingConfig,\n  ExpressResponseLoggingConfig,\n} from \"./types.js\";\n\nfunction resolveGroupConfig(group: ExpressLogLayerConfig[\"group\"]) {\n  if (!group) return { nameGroup: undefined, requestGroup: undefined, responseGroup: undefined };\n  if (group === true)\n    return { nameGroup: \"express\", requestGroup: \"express.request\", responseGroup: \"express.response\" };\n  return {\n    nameGroup: group.name ?? \"express\",\n    requestGroup: group.request ?? \"express.request\",\n    responseGroup: group.response ?? \"express.response\",\n  };\n}\n\nfunction shouldIgnorePath(path: string, ignore?: Array<string | RegExp>): boolean {\n  if (!ignore || ignore.length === 0) return false;\n\n  for (const pattern of ignore) {\n    if (typeof pattern === \"string\") {\n      if (path === pattern) return true;\n    } else if (pattern.test(path)) {\n      return true;\n    }\n  }\n\n  return false;\n}\n\nfunction getRequestId(request: Request, requestIdConfig: ExpressLogLayerConfig[\"requestId\"]): string | undefined {\n  if (requestIdConfig === false) return undefined;\n  if (typeof requestIdConfig === \"function\") return requestIdConfig(request);\n  return crypto.randomUUID();\n}\n\nfunction resolveLoggingConfig<T>(value: boolean | T | undefined, defaultEnabled: boolean): T | false {\n  if (value === undefined) return defaultEnabled ? ({} as T) : false;\n  if (value === true) return {} as T;\n  if (value === false) return false;\n  return value;\n}\n\n/**\n * Creates an Express middleware that integrates LogLayer for request-scoped logging.\n *\n * The middleware attaches a child LogLayer instance to `req.log` for each request.\n *\n * @example\n * ```typescript\n * import express from \"express\";\n * import { LogLayer, ConsoleTransport } from \"loglayer\";\n * import { expressLogLayer } from \"@loglayer/express\";\n *\n * const log = new LogLayer({ transport: new ConsoleTransport() });\n *\n * const app = express();\n * app.use(expressLogLayer({ instance: log }));\n *\n * app.get(\"/\", (req, res) => {\n *   req.log.info(\"Hello from route!\");\n *   res.send(\"Hello World!\");\n * });\n * ```\n */\nexport function expressLogLayer(config: ExpressLogLayerConfig) {\n  const {\n    instance,\n    requestId: requestIdConfig = true,\n    autoLogging: autoLoggingConfig = true,\n    contextFn,\n    group: groupConfig,\n  } = config;\n  const { requestGroup, responseGroup } = resolveGroupConfig(groupConfig);\n\n  const autoLogging: ExpressAutoLoggingConfig | false =\n    autoLoggingConfig === true ? {} : autoLoggingConfig === false ? false : autoLoggingConfig;\n\n  // Resolve auto-logging configs once\n  const requestConfig = autoLogging\n    ? resolveLoggingConfig<ExpressRequestLoggingConfig>(autoLogging.request, true)\n    : false;\n  const responseConfig = autoLogging\n    ? resolveLoggingConfig<ExpressResponseLoggingConfig>(autoLogging.response, true)\n    : false;\n\n  const defaultLogLevel = autoLogging ? (autoLogging.logLevel ?? \"info\") : \"info\";\n  const requestLogLevel = requestConfig ? (requestConfig.logLevel ?? defaultLogLevel) : defaultLogLevel;\n  const responseLogLevel = responseConfig ? (responseConfig.logLevel ?? defaultLogLevel) : defaultLogLevel;\n\n  return (req: Request, res: Response, next: NextFunction) => {\n    const context: Record<string, any> = {};\n\n    const reqId = getRequestId(req, requestIdConfig);\n    if (reqId) {\n      context.requestId = reqId;\n    }\n\n    if (contextFn) {\n      const additionalContext = contextFn(req);\n      if (additionalContext) {\n        Object.assign(context, additionalContext);\n      }\n    }\n\n    // Create child logger and attach to req.log\n    const childLogger = instance.child().withContext(context) as ILogLayer;\n    (req as any).log = childLogger;\n\n    const startTime = Date.now();\n    const ignorePath = autoLogging ? shouldIgnorePath(req.path, autoLogging.ignore) : true;\n\n    // Log incoming request\n    if (requestConfig && !ignorePath) {\n      let builder = childLogger.withMetadata({\n        req: {\n          method: req.method,\n          url: req.originalUrl || req.url,\n          remoteAddress: req.ip,\n        },\n      });\n      if (requestGroup) builder = builder.withGroup(requestGroup);\n      builder[requestLogLevel](\"incoming request\");\n    }\n\n    // Log response on completion (listen on close, finish, and error for reliability)\n    if (responseConfig && !ignorePath) {\n      const onResponseComplete = () => {\n        res.removeListener(\"close\", onResponseComplete);\n        res.removeListener(\"finish\", onResponseComplete);\n        res.removeListener(\"error\", onResponseComplete);\n\n        const responseTime = Date.now() - startTime;\n        let builder = childLogger.withMetadata({\n          req: {\n            method: req.method,\n            url: req.originalUrl || req.url,\n            remoteAddress: req.ip,\n          },\n          res: {\n            statusCode: res.statusCode,\n          },\n          responseTime,\n        });\n        if (responseGroup) builder = builder.withGroup(responseGroup);\n        builder[responseLogLevel](\"request completed\");\n      };\n\n      res.on(\"close\", onResponseComplete);\n      res.on(\"finish\", onResponseComplete);\n      res.on(\"error\", onResponseComplete);\n    }\n\n    next();\n  };\n}\n\n/**\n * Creates an Express error-handling middleware that logs errors via LogLayer.\n *\n * This middleware should be registered after all routes. It logs the error\n * using `req.log` (set by `expressLogLayer`) and passes the error to the\n * next error handler via `next(err)`.\n *\n * @example\n * ```typescript\n * import express from \"express\";\n * import { expressLogLayer, expressLogLayerErrorHandler } from \"@loglayer/express\";\n *\n * const app = express();\n * app.use(expressLogLayer({ instance: log }));\n *\n * // ... routes ...\n *\n * app.use(expressLogLayerErrorHandler());\n * app.use((err, req, res, next) => {\n *   res.status(500).send(\"Internal Server Error\");\n * });\n * ```\n */\nexport function expressLogLayerErrorHandler(config?: { group?: ExpressLogLayerConfig[\"group\"] }): ErrorRequestHandler {\n  const { nameGroup } = resolveGroupConfig(config?.group);\n\n  return (err: Error, req: Request, _res: Response, next: NextFunction) => {\n    if ((req as any).log) {\n      let builder = ((req as any).log as ILogLayer).withError(err).withMetadata({ url: req.originalUrl || req.url });\n      if (nameGroup) builder = builder.withGroup(nameGroup);\n      builder.error(\"Request error\");\n    }\n    next(err);\n  };\n}\n"],"mappings":"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"}

package/package.json

@@ -0,0 +1,71 @@
+{
+  "name": "@loglayer/express",
+  "description": "Express integration for LogLayer with request-scoped logging, auto request logging, and error handling.",
+  "version": "0.1.0",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "exports": {
+    "import": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "require": {
+      "types": "./dist/index.d.cts",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "types": "./dist/index.d.ts",
+  "sideEffects": false,
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/loglayer/loglayer.git",
+    "directory": "packages/integrations/express"
+  },
+  "author": "Theo Gravity <theo@suteki.nu>",
+  "keywords": [
+    "logging",
+    "log",
+    "loglayer",
+    "express",
+    "integration",
+    "middleware"
+  ],
+  "devDependencies": {
+    "@types/express": "5.0.6",
+    "@types/node": "25.2.3",
+    "@types/supertest": "6.0.3",
+    "express": "5.2.1",
+    "serialize-error": "13.0.1",
+    "supertest": "7.2.2",
+    "tsdown": "0.20.3",
+    "tsx": "4.21.0",
+    "typescript": "5.9.3",
+    "vitest": "4.0.18",
+    "@internal/tsconfig": "2.1.0",
+    "@loglayer/transport-simple-pretty-terminal": "3.0.2",
+    "loglayer": "9.1.0"
+  },
+  "peerDependencies": {
+    "express": ">=4.0.0",
+    "loglayer": "*"
+  },
+  "bugs": "https://github.com/loglayer/loglayer/issues",
+  "engines": {
+    "node": ">=20"
+  },
+  "files": [
+    "dist"
+  ],
+  "homepage": "https://loglayer.dev",
+  "scripts": {
+    "build": "tsdown src/index.ts",
+    "test": "vitest --run",
+    "livetest": "tsx src/__tests__/livetest.ts",
+    "clean": "rm -rf .turbo node_modules dist",
+    "lint": "biome check --no-errors-on-unmatched --write --unsafe src",
+    "lint:staged": "biome check --no-errors-on-unmatched --write --unsafe --staged src",
+    "verify-types": "tsc --noEmit"
+  }
+}