@batkit/express-middleware 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Ken Courville
+
+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,331 @@
+# @batkit/express-middleware
+
+Express middleware for error handling with RFC 9457 Problem Details format.
+
+## Installation
+
+```bash
+npm install @batkit/express-middleware express
+```
+
+## Overview
+
+Production-ready Express middleware for error handling with automatic RFC 9457 Problem Details formatting.
+
+## Features
+
+- ✅ RFC 9457 Problem Details error responses
+- ✅ Handles common error types (AppError, Axios, Zod)
+- ✅ Customizable error formatters
+- ✅ Support for async route handlers
+- ✅ TypeScript-first
+- ✅ Production and development modes
+
+## Usage
+
+### Basic Setup
+
+```typescript
+import { errorHandler } from '@batkit/express-middleware';
+import express from 'express';
+
+const app = express();
+
+// Your routes
+app.get('/users/:id', (req, res) => {
+  // ... your logic
+  res.json({ user: {} });
+});
+
+// Add error handler (must be LAST)
+app.use(errorHandler());
+
+app.listen(3000);
+```
+
+### Error Handling
+
+```typescript
+import { asyncHandler, errorHandler } from "@batkit/express-middleware";
+import { NotFoundError, ValidationError } from "@batkit/errors";
+import express from "express";
+
+const app = express();
+
+// Async route handler with error handling
+app.get(
+  "/users/:id",
+  asyncHandler(async (req, res) => {
+    const user = await db.users.findById(req.params.id);
+
+    if (!user) {
+      // Automatically converted to RFC 9457 format
+      throw new NotFoundError("User", req.params.id);
+    }
+
+    res.json(user);
+  }),
+);
+
+// Synchronous route
+app.post("/users", (req, res) => {
+  if (!req.body.email) {
+    throw new ValidationError("Invalid user data", [
+      { field: "email", message: "Email is required" },
+    ]);
+  }
+
+  res.json({ created: true });
+});
+
+// Error handler converts all errors to RFC 9457
+app.use(errorHandler());
+```
+
+### Async-local log context
+
+`logContextMiddleware` wraps each request in [`runWithContext`](https://nodejs.org/api/async_context.html#asynchronous-context-tracking) from `@batkit/logger/async-local` so your code can call `mergeLogContext`, use `getLogContext`, and attach a [`ContextualLoggerProvider`](../logger/README.md)—without `req.logger` or Express-specific types inside the logger package.
+
+**Background:** see the toolkit guide [Understanding AsyncLocalStorage](../../docs/async-local-storage.md).
+
+```typescript
+import { logContextMiddleware } from "@batkit/express-middleware";
+import { LoggerFacade } from "@batkit/logger";
+import { ContextualLoggerProvider, mergeLogContext } from "@batkit/logger/async-local";
+import { PinoLoggerProvider } from "@batkit/logger-pino";
+import express from "express";
+import { randomUUID } from "node:crypto";
+
+LoggerFacade.setProvider(new ContextualLoggerProvider(new PinoLoggerProvider({ level: "info" })));
+
+const app = express();
+app.use(express.json());
+
+app.use(
+  logContextMiddleware({
+    initialContext: (req) => ({
+      requestId: req.get("x-request-id") ?? randomUUID(),
+    }),
+  }),
+);
+
+app.post("/orders/:id/submit", (req, res) => {
+  mergeLogContext({ transactionId: req.get("x-transaction-id") ?? randomUUID() });
+  LoggerFacade.getLogger("orders").info("Submitting"); // includes requestId + transactionId in structured output
+  res.status(204).end();
+});
+```
+
+### Custom Error Formatter
+
+```typescript
+import { errorHandler, type ErrorFormatter } from "@batkit/express-middleware";
+import type { ExtendedProblemDetails } from "@batkit/rfc9457";
+
+class CustomErrorFormatter implements ErrorFormatter {
+  canFormat(error: unknown): boolean {
+    return error instanceof MyCustomError;
+  }
+
+  format(error: MyCustomError): ExtendedProblemDetails {
+    return {
+      type: "error:custom",
+      title: "Custom Error",
+      status: 400,
+      detail: error.message,
+      customField: error.customData,
+    };
+  }
+}
+
+app.use(
+  errorHandler({
+    formatters: [new CustomErrorFormatter()],
+    includeStack: true, // Include stack traces
+    logErrors: true,
+  }),
+);
+```
+
+## API Reference
+
+### Log context middleware
+
+#### `logContextMiddleware(options?): Middleware`
+
+Runs `next()` inside `runWithContext(initialContext(req), …)` so nested async work can use `getLogContext` / `mergeLogContext` from `@batkit/logger/async-local`.
+
+**Options:**
+
+```typescript
+interface LogContextMiddlewareOptions {
+  /** Default: `() => ({})` */
+  initialContext?: (req: Request) => Record<string, import("@batkit/logger").LogValue>;
+}
+```
+
+**Returns:** Express middleware function. Mount it **early** (after body parsers if you need `req` fields).
+
+**Note:** Prefer a synchronous call to `next()` inside the ALS scope. Avoid `async` middleware that `await`s before calling `next()` unless the entire downstream pipeline stays in the same async context.
+
+### Error Handler
+
+#### `errorHandler(options?): ErrorMiddleware`
+
+Creates error handling middleware that converts errors to RFC 9457 format.
+
+**Options:**
+
+```typescript
+interface ErrorHandlerOptions {
+  formatters?: ErrorFormatter[]; // Custom error formatters
+  includeStack?: boolean; // Include stack traces (default: only in dev)
+  logErrors?: boolean; // Whether to log errors (default: true)
+  onError?: (error: unknown, req: Request) => void; // Custom error logger
+}
+```
+
+**Returns:** Express error middleware function (must have 4 parameters)
+
+#### `asyncHandler(fn): Middleware`
+
+Wraps async route handlers to catch errors.
+
+**Parameters:**
+
+- `fn`: Async route handler function
+
+**Returns:** Express middleware function
+
+### Types
+
+#### `RequestContext`
+
+```typescript
+interface RequestContext {
+  requestId: string;
+  logger: Logger;
+  userId?: string;
+  metadata: Record<string, unknown>;
+}
+```
+
+#### `ErrorFormatter`
+
+```typescript
+interface ErrorFormatter {
+  canFormat(error: unknown): boolean;
+  format(error: unknown): ExtendedProblemDetails;
+}
+```
+
+## Error Response Format
+
+All errors are returned in RFC 9457 format:
+
+```json
+{
+  "type": "error:not-found",
+  "title": "Resource Not Found",
+  "status": 404,
+  "detail": "User with id '123' was not found",
+  "instance": "/users/123",
+  "entityName": "User",
+  "entityId": "123"
+}
+```
+
+## Built-in Error Support
+
+The default error formatter handles:
+
+- **@batkit/errors** - All AppError subclasses
+- **Axios errors** - Formatted as upstream service errors
+- **Zod errors** - Formatted as validation errors
+- **Standard Error** - Formatted as internal server errors
+
+## Best Practices
+
+1. **Add `logContextMiddleware` early** in the middleware chain when using async-local logging
+2. **Add `errorHandler` last** after all routes
+3. **Use `asyncHandler`** for async routes to catch errors
+4. **Use `ContextualLoggerProvider`** with `LoggerFacade` (or your DI) so structured logs pick up ALS fields automatically
+5. **Throw `@batkit/errors`** for consistent error handling
+6. **Don't expose stack traces** in production (default behavior)
+
+## Example: Complete Setup
+
+```typescript
+import { errorHandler, asyncHandler, logContextMiddleware } from "@batkit/express-middleware";
+import { NotFoundError, ValidationError } from "@batkit/errors";
+import { LoggerFacade } from "@batkit/logger";
+import { ContextualLoggerProvider } from "@batkit/logger/async-local";
+import { PinoLoggerProvider } from "@batkit/logger-pino";
+import express from "express";
+import { randomUUID } from "node:crypto";
+
+LoggerFacade.setProvider(new ContextualLoggerProvider(new PinoLoggerProvider({ level: "info" })));
+
+const app = express();
+const logger = LoggerFacade.getLogger("server");
+
+// Middleware
+app.use(express.json());
+app.use(
+  logContextMiddleware({
+    initialContext: (req) => ({ requestId: req.get("x-request-id") ?? randomUUID() }),
+  }),
+);
+
+// Routes
+app.get("/health", (req, res) => {
+  res.json({ status: "ok" });
+});
+
+app.get(
+  "/users/:id",
+  asyncHandler(async (req, res) => {
+    LoggerFacade.getLogger("users").info("Fetching user", { userId: req.params.id });
+
+    const user = await db.users.findById(req.params.id);
+    if (!user) {
+      throw new NotFoundError("User", req.params.id);
+    }
+
+    res.json(user);
+  }),
+);
+
+app.post(
+  "/users",
+  asyncHandler(async (req, res) => {
+    const validation = validateUser(req.body);
+    if (!validation.success) {
+      throw new ValidationError("Invalid user data", validation.errors);
+    }
+
+    const user = await db.users.create(req.body);
+    res.status(201).json(user);
+  }),
+);
+
+// Error handler (MUST be last)
+app.use(
+  errorHandler({
+    includeStack: true,
+  }),
+);
+
+const PORT = process.env.PORT || 3000;
+app.listen(PORT, () => {
+  logger.info(`Server listening on port ${PORT}`);
+});
+```
+
+## TypeScript
+
+`logContextMiddleware` uses standard Express typings. Use `getLogContext()` from `@batkit/logger/async-local` when you need the current bag of log fields in a handler or service.
+
+## License
+
+MIT © Ken Courville

package/dist/error-handler.d.ts

@@ -0,0 +1,23 @@
+import { type ExtendedProblemDetails } from "@batkit/rfc9457";
+import type { NextFunction, Request, Response } from "express";
+export interface ErrorFormatter {
+    canFormat(error: unknown): boolean;
+    format(error: unknown): ExtendedProblemDetails;
+}
+export declare class DefaultErrorFormatter implements ErrorFormatter {
+    canFormat(error: unknown): boolean;
+    format(error: unknown): ExtendedProblemDetails;
+    private isAxiosError;
+    private isZodError;
+    private formatAxiosError;
+    private formatZodError;
+}
+export interface ErrorHandlerOptions {
+    formatters?: ErrorFormatter[];
+    includeStack?: boolean;
+    logErrors?: boolean;
+    onError?: (error: unknown, req: Request) => void;
+}
+export declare function errorHandler(options?: ErrorHandlerOptions): (error: Error, req: Request, res: Response, next: NextFunction) => void;
+export declare function asyncHandler(fn: (req: Request, res: Response, next: NextFunction) => Promise<unknown>): (req: Request, res: Response, next: NextFunction) => void;
+//# sourceMappingURL=error-handler.d.ts.map

package/dist/error-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-handler.d.ts","sourceRoot":"","sources":["../src/error-handler.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,KAAK,sBAAsB,EAG5B,MAAM,iBAAiB,CAAC;AACzB,OAAO,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAM/D,MAAM,WAAW,cAAc;IAI7B,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC;IAKnC,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,sBAAsB,CAAC;CAChD;AAKD,qBAAa,qBAAsB,YAAW,cAAc;IAC1D,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO;IASlC,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,sBAAsB;IAmC9C,OAAO,CAAC,YAAY;IASpB,OAAO,CAAC,UAAU;IASlB,OAAO,CAAC,gBAAgB;IAaxB,OAAO,CAAC,cAAc;CAevB;AAKD,MAAM,WAAW,mBAAmB;IAIlC,UAAU,CAAC,EAAE,cAAc,EAAE,CAAC;IAK9B,YAAY,CAAC,EAAE,OAAO,CAAC;IAKvB,SAAS,CAAC,EAAE,OAAO,CAAC;IAKpB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,OAAO,KAAK,IAAI,CAAC;CAClD;AAwBD,wBAAgB,YAAY,CAC1B,OAAO,GAAE,mBAAwB,GAChC,CAAC,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,YAAY,KAAK,IAAI,CAwEzE;AAsBD,wBAAgB,YAAY,CAC1B,EAAE,EAAE,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,YAAY,KAAK,OAAO,CAAC,OAAO,CAAC,GACxE,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,YAAY,KAAK,IAAI,CAI3D"}

package/dist/error-handler.js

@@ -0,0 +1,138 @@
+import { isAppError } from "@batkit/errors";
+import { LoggerFacade } from "@batkit/logger";
+import { PROBLEM_DETAILS_CONTENT_TYPE, createExtendedProblemDetails, } from "@batkit/rfc9457";
+const logger = LoggerFacade.getLogger("error-handler");
+export class DefaultErrorFormatter {
+    canFormat(error) {
+        return (isAppError(error) ||
+            error instanceof Error ||
+            this.isAxiosError(error) ||
+            this.isZodError(error));
+    }
+    format(error) {
+        if (isAppError(error)) {
+            return error.toRFC9457();
+        }
+        if (this.isAxiosError(error)) {
+            return this.formatAxiosError(error);
+        }
+        if (this.isZodError(error)) {
+            return this.formatZodError(error);
+        }
+        if (error instanceof Error) {
+            return createExtendedProblemDetails({
+                type: "error:internal",
+                title: "Internal Server Error",
+                status: 500,
+                detail: error.message,
+            });
+        }
+        return createExtendedProblemDetails({
+            type: "error:unknown",
+            title: "Unknown Error",
+            status: 500,
+            detail: "An unknown error occurred",
+        });
+    }
+    isAxiosError(error) {
+        return (typeof error === "object" &&
+            error !== null &&
+            "isAxiosError" in error &&
+            error.isAxiosError === true);
+    }
+    isZodError(error) {
+        return (typeof error === "object" &&
+            error !== null &&
+            "issues" in error &&
+            Array.isArray(error.issues));
+    }
+    formatAxiosError(error) {
+        const status = error.response?.status || 502;
+        return createExtendedProblemDetails({
+            type: "error:upstream",
+            title: "Upstream Service Error",
+            status,
+            detail: error.message,
+            upstreamUrl: error.config?.url,
+            upstreamMethod: error.config?.method?.toUpperCase(),
+            upstreamStatus: error.response?.status,
+        });
+    }
+    formatZodError(error) {
+        const validationErrors = error.issues.map((issue) => ({
+            field: issue.path.join("."),
+            message: issue.message,
+            code: issue.code,
+        }));
+        return createExtendedProblemDetails({
+            type: "error:validation",
+            title: "Validation Error",
+            status: 400,
+            detail: "Request validation failed",
+            validationErrors,
+        });
+    }
+}
+export function errorHandler(options = {}) {
+    const { formatters = [new DefaultErrorFormatter()], includeStack = true, logErrors = true, onError, } = options;
+    return (error, req, res, next) => {
+        if (res.headersSent) {
+            next(error);
+            return;
+        }
+        if (logErrors) {
+            if (onError) {
+                onError(error, req);
+            }
+            else {
+                if (isAppError(error) && error.isOperational) {
+                    logger.warn("Operational error occurred", {
+                        error: error.message,
+                        code: error.code,
+                        statusCode: error.statusCode,
+                        path: req.path,
+                        method: req.method,
+                    });
+                }
+                else {
+                    logger.error(error, {
+                        path: req.path,
+                        method: req.method,
+                        querd: req.method,
+                        consoley: req.query,
+                        body: req.body,
+                    });
+                }
+            }
+        }
+        let problemDetails;
+        const formatter = formatters.find((f) => f.canFormat(error));
+        if (formatter) {
+            problemDetails = formatter.format(error);
+        }
+        else {
+            problemDetails = createExtendedProblemDetails({
+                type: "error:internal",
+                title: "Internal Server Error",
+                status: 500,
+                detail: "An unexpected error occurred",
+            });
+        }
+        if (includeStack && error.stack) {
+            problemDetails.stack = error.stack.split("\n").map((line) => line.trim());
+        }
+        if (!problemDetails.instance) {
+            problemDetails.instance = req.path;
+        }
+        res
+            .status(problemDetails.status || 500)
+            .set("Content-Type", PROBLEM_DETAILS_CONTENT_TYPE)
+            .json(problemDetails);
+    };
+}
+export function asyncHandler(fn) {
+    return (req, res, next) => {
+        Promise.resolve(fn(req, res, next)).catch(next);
+    };
+}
+//# sourceMappingURL=error-handler.js.map

package/dist/error-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-handler.js","sourceRoot":"","sources":["../src/error-handler.ts"],"names":[],"mappings":"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"}

package/dist/index.cjs

@@ -0,0 +1,169 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+let _batkit_errors = require("@batkit/errors");
+let _batkit_logger = require("@batkit/logger");
+let _batkit_rfc9457 = require("@batkit/rfc9457");
+let _batkit_logger_async_local = require("@batkit/logger/async-local");
+//#region src/error-handler.ts
+const logger = _batkit_logger.LoggerFacade.getLogger("error-handler");
+/**
+* Default error formatter that handles common error types
+*/
+var DefaultErrorFormatter = class {
+	canFormat(error) {
+		return (0, _batkit_errors.isAppError)(error) || error instanceof Error || this.isAxiosError(error) || this.isZodError(error);
+	}
+	format(error) {
+		if ((0, _batkit_errors.isAppError)(error)) return error.toRFC9457();
+		if (this.isAxiosError(error)) return this.formatAxiosError(error);
+		if (this.isZodError(error)) return this.formatZodError(error);
+		if (error instanceof Error) return (0, _batkit_rfc9457.createExtendedProblemDetails)({
+			type: "error:internal",
+			title: "Internal Server Error",
+			status: 500,
+			detail: error.message
+		});
+		return (0, _batkit_rfc9457.createExtendedProblemDetails)({
+			type: "error:unknown",
+			title: "Unknown Error",
+			status: 500,
+			detail: "An unknown error occurred"
+		});
+	}
+	isAxiosError(error) {
+		return typeof error === "object" && error !== null && "isAxiosError" in error && error.isAxiosError === true;
+	}
+	isZodError(error) {
+		return typeof error === "object" && error !== null && "issues" in error && Array.isArray(error.issues);
+	}
+	formatAxiosError(error) {
+		return (0, _batkit_rfc9457.createExtendedProblemDetails)({
+			type: "error:upstream",
+			title: "Upstream Service Error",
+			status: error.response?.status || 502,
+			detail: error.message,
+			upstreamUrl: error.config?.url,
+			upstreamMethod: (error.config?.method)?.toUpperCase(),
+			upstreamStatus: error.response?.status
+		});
+	}
+	formatZodError(error) {
+		return (0, _batkit_rfc9457.createExtendedProblemDetails)({
+			type: "error:validation",
+			title: "Validation Error",
+			status: 400,
+			detail: "Request validation failed",
+			validationErrors: error.issues.map((issue) => ({
+				field: issue.path.join("."),
+				message: issue.message,
+				code: issue.code
+			}))
+		});
+	}
+};
+/**
+* Express error handling middleware that converts errors to RFC 9457 format
+*
+* @param options - Configuration options
+* @returns Express error middleware function
+*
+* @example
+* ```ts
+* import { errorHandler } from '@batkit/express-middleware';
+* import { NotFoundError } from '@batkit/errors';
+* import express from 'express';
+*
+* const app = express();
+*
+* app.get('/users/:id', (req, res) => {
+*   throw new NotFoundError('User', req.params.id);
+* });
+*
+* // Must be added AFTER all routes
+* app.use(errorHandler());
+* ```
+*/
+function errorHandler(options = {}) {
+	const { formatters = [new DefaultErrorFormatter()], includeStack = true, logErrors = true, onError } = options;
+	return (error, req, res, next) => {
+		if (res.headersSent) {
+			next(error);
+			return;
+		}
+		if (logErrors) if (onError) onError(error, req);
+		else if ((0, _batkit_errors.isAppError)(error) && error.isOperational) logger.warn("Operational error occurred", {
+			error: error.message,
+			code: error.code,
+			statusCode: error.statusCode,
+			path: req.path,
+			method: req.method
+		});
+		else logger.error(error, {
+			path: req.path,
+			method: req.method,
+			querd: req.method,
+			consoley: req.query,
+			body: req.body
+		});
+		let problemDetails;
+		const formatter = formatters.find((f) => f.canFormat(error));
+		if (formatter) problemDetails = formatter.format(error);
+		else problemDetails = (0, _batkit_rfc9457.createExtendedProblemDetails)({
+			type: "error:internal",
+			title: "Internal Server Error",
+			status: 500,
+			detail: "An unexpected error occurred"
+		});
+		if (includeStack && error.stack) problemDetails.stack = error.stack.split("\n").map((line) => line.trim());
+		if (!problemDetails.instance) problemDetails.instance = req.path;
+		res.status(problemDetails.status || 500).set("Content-Type", _batkit_rfc9457.PROBLEM_DETAILS_CONTENT_TYPE).json(problemDetails);
+	};
+}
+/**
+* Express middleware to catch async errors
+* Wraps async route handlers to ensure errors are passed to error middleware
+*
+* @param fn - Async route handler
+* @returns Wrapped route handler
+*
+* @example
+* ```ts
+* import { asyncHandler } from '@batkit/express-middleware';
+*
+* app.get('/users/:id', asyncHandler(async (req, res) => {
+*   const user = await db.users.findById(req.params.id);
+*   if (!user) {
+*     throw new NotFoundError('User', req.params.id);
+*   }
+*   res.json(user);
+* }));
+* ```
+*/
+function asyncHandler(fn) {
+	return (req, res, next) => {
+		Promise.resolve(fn(req, res, next)).catch(next);
+	};
+}
+//#endregion
+//#region src/log-context-middleware.ts
+/**
+* Runs each request inside {@link runWithContext} so later code can use
+* {@link mergeLogContext} and a {@link ContextualLoggerProvider} without
+* depending on Express (`req`) deep in the stack.
+*
+* Mount this **early** in the middleware chain. Use synchronous `next()` inside
+* the callback; avoid `async` middleware that calls `next` after an `await`
+* without keeping the rest of the work in the same async context.
+*/
+function logContextMiddleware(options = {}) {
+	const initialContext = options.initialContext ?? (() => ({}));
+	return (req, _res, next) => {
+		(0, _batkit_logger_async_local.runWithContext)(initialContext(req), () => next());
+	};
+}
+//#endregion
+exports.DefaultErrorFormatter = DefaultErrorFormatter;
+exports.asyncHandler = asyncHandler;
+exports.errorHandler = errorHandler;
+exports.logContextMiddleware = logContextMiddleware;
+
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","names":["LoggerFacade","PROBLEM_DETAILS_CONTENT_TYPE"],"sources":["../src/error-handler.ts","../src/log-context-middleware.ts"],"sourcesContent":["import { isAppError } from \"@batkit/errors\";\nimport { LoggerFacade } from \"@batkit/logger\";\nimport {\n  type ExtendedProblemDetails,\n  PROBLEM_DETAILS_CONTENT_TYPE,\n  createExtendedProblemDetails,\n} from \"@batkit/rfc9457\";\nimport type { NextFunction, Request, Response } from \"express\";\n\nconst logger = LoggerFacade.getLogger(\"error-handler\");\n/**\n * Interface for custom error formatters\n */\nexport interface ErrorFormatter {\n  /**\n   * Check if this formatter can handle the error\n   */\n  canFormat(error: unknown): boolean;\n\n  /**\n   * Format the error as RFC 9457 Problem Details\n   */\n  format(error: unknown): ExtendedProblemDetails;\n}\n\n/**\n * Default error formatter that handles common error types\n */\nexport class DefaultErrorFormatter implements ErrorFormatter {\n  canFormat(error: unknown): boolean {\n    return (\n      isAppError(error) ||\n      error instanceof Error ||\n      this.isAxiosError(error) ||\n      this.isZodError(error)\n    );\n  }\n\n  format(error: unknown): ExtendedProblemDetails {\n    // Handle AppError (from @batkit/errors)\n    if (isAppError(error)) {\n      return error.toRFC9457();\n    }\n\n    // Handle Axios errors\n    if (this.isAxiosError(error)) {\n      return this.formatAxiosError(error as Record<string, unknown>);\n    }\n\n    // Handle Zod validation errors\n    if (this.isZodError(error)) {\n      return this.formatZodError(error as Record<string, unknown>);\n    }\n\n    // Handle generic Error\n    if (error instanceof Error) {\n      return createExtendedProblemDetails({\n        type: \"error:internal\",\n        title: \"Internal Server Error\",\n        status: 500,\n        detail: error.message,\n      });\n    }\n\n    // Unknown error type\n    return createExtendedProblemDetails({\n      type: \"error:unknown\",\n      title: \"Unknown Error\",\n      status: 500,\n      detail: \"An unknown error occurred\",\n    });\n  }\n\n  private isAxiosError(error: unknown): boolean {\n    return (\n      typeof error === \"object\" &&\n      error !== null &&\n      \"isAxiosError\" in error &&\n      error.isAxiosError === true\n    );\n  }\n\n  private isZodError(error: unknown): boolean {\n    return (\n      typeof error === \"object\" &&\n      error !== null &&\n      \"issues\" in error &&\n      Array.isArray((error as Record<string, unknown>).issues)\n    );\n  }\n\n  private formatAxiosError(error: Record<string, unknown>): ExtendedProblemDetails {\n    const status = ((error.response as Record<string, unknown>)?.status as number) || 502;\n    return createExtendedProblemDetails({\n      type: \"error:upstream\",\n      title: \"Upstream Service Error\",\n      status,\n      detail: error.message as string,\n      upstreamUrl: (error.config as Record<string, unknown>)?.url as string | undefined,\n      upstreamMethod: ((error.config as Record<string, unknown>)?.method as string)?.toUpperCase(),\n      upstreamStatus: (error.response as Record<string, unknown>)?.status as number | undefined,\n    });\n  }\n\n  private formatZodError(error: Record<string, unknown>): ExtendedProblemDetails {\n    const validationErrors = (error.issues as Array<Record<string, unknown>>).map((issue) => ({\n      field: (issue.path as unknown[]).join(\".\"),\n      message: issue.message as string,\n      code: issue.code as string,\n    }));\n\n    return createExtendedProblemDetails({\n      type: \"error:validation\",\n      title: \"Validation Error\",\n      status: 400,\n      detail: \"Request validation failed\",\n      validationErrors,\n    });\n  }\n}\n\n/**\n * Options for error handler middleware\n */\nexport interface ErrorHandlerOptions {\n  /**\n   * Custom error formatters (in order of precedence)\n   */\n  formatters?: ErrorFormatter[];\n\n  /**\n   * Whether to include stack traces in responses (default: only in non-production)\n   */\n  includeStack?: boolean;\n\n  /**\n   * Whether to log errors (default: true)\n   */\n  logErrors?: boolean;\n\n  /**\n   * Custom error logger function\n   */\n  onError?: (error: unknown, req: Request) => void;\n}\n\n/**\n * Express error handling middleware that converts errors to RFC 9457 format\n *\n * @param options - Configuration options\n * @returns Express error middleware function\n *\n * @example\n * ```ts\n * import { errorHandler } from '@batkit/express-middleware';\n * import { NotFoundError } from '@batkit/errors';\n * import express from 'express';\n *\n * const app = express();\n *\n * app.get('/users/:id', (req, res) => {\n *   throw new NotFoundError('User', req.params.id);\n * });\n *\n * // Must be added AFTER all routes\n * app.use(errorHandler());\n * ```\n */\nexport function errorHandler(\n  options: ErrorHandlerOptions = {},\n): (error: Error, req: Request, res: Response, next: NextFunction) => void {\n  const {\n    formatters = [new DefaultErrorFormatter()],\n    includeStack = true,\n    logErrors = true,\n    onError,\n  } = options;\n\n  return (error: Error, req: Request, res: Response, next: NextFunction): void => {\n    // If headers already sent, delegate to default Express error handler\n    if (res.headersSent) {\n      next(error);\n      return;\n    }\n\n    // Log the error\n    if (logErrors) {\n      if (onError) {\n        onError(error, req);\n      } else {\n        if (isAppError(error) && error.isOperational) {\n          logger.warn(\"Operational error occurred\", {\n            error: error.message,\n            code: error.code,\n            statusCode: error.statusCode,\n            path: req.path,\n            method: req.method,\n          });\n        } else {\n          logger.error(error, {\n            path: req.path,\n            method: req.method,\n            querd: req.method,\n            consoley: req.query,\n            body: req.body,\n          });\n        }\n      }\n    }\n\n    // Format the error\n    let problemDetails: ExtendedProblemDetails;\n\n    const formatter = formatters.find((f) => f.canFormat(error));\n    if (formatter) {\n      problemDetails = formatter.format(error);\n    } else {\n      // Fallback to generic error\n      problemDetails = createExtendedProblemDetails({\n        type: \"error:internal\",\n        title: \"Internal Server Error\",\n        status: 500,\n        detail: \"An unexpected error occurred\",\n      });\n    }\n\n    // Add stack trace if enabled\n    if (includeStack && error.stack) {\n      problemDetails.stack = error.stack.split(\"\\n\").map((line) => line.trim());\n    }\n\n    // Add instance (request path)\n    if (!problemDetails.instance) {\n      problemDetails.instance = req.path;\n    }\n\n    // Send RFC 9457 response\n    res\n      .status(problemDetails.status || 500)\n      .set(\"Content-Type\", PROBLEM_DETAILS_CONTENT_TYPE)\n      .json(problemDetails);\n  };\n}\n\n/**\n * Express middleware to catch async errors\n * Wraps async route handlers to ensure errors are passed to error middleware\n *\n * @param fn - Async route handler\n * @returns Wrapped route handler\n *\n * @example\n * ```ts\n * import { asyncHandler } from '@batkit/express-middleware';\n *\n * app.get('/users/:id', asyncHandler(async (req, res) => {\n *   const user = await db.users.findById(req.params.id);\n *   if (!user) {\n *     throw new NotFoundError('User', req.params.id);\n *   }\n *   res.json(user);\n * }));\n * ```\n */\nexport function asyncHandler(\n  fn: (req: Request, res: Response, next: NextFunction) => Promise<unknown>,\n): (req: Request, res: Response, next: NextFunction) => void {\n  return (req: Request, res: Response, next: NextFunction): void => {\n    Promise.resolve(fn(req, res, next)).catch(next);\n  };\n}\n","import type { LogValue } from \"@batkit/logger\";\nimport { runWithContext } from \"@batkit/logger/async-local\";\nimport type { NextFunction, Request, Response } from \"express\";\n\nexport type LogContextInitializer = (req: Request) => Record<string, LogValue>;\n\nexport interface LogContextMiddlewareOptions {\n  /**\n   * Build initial async-local log fields for this HTTP request.\n   * @default () => ({})\n   */\n  initialContext?: LogContextInitializer;\n}\n\n/**\n * Runs each request inside {@link runWithContext} so later code can use\n * {@link mergeLogContext} and a {@link ContextualLoggerProvider} without\n * depending on Express (`req`) deep in the stack.\n *\n * Mount this **early** in the middleware chain. Use synchronous `next()` inside\n * the callback; avoid `async` middleware that calls `next` after an `await`\n * without keeping the rest of the work in the same async context.\n */\nexport function logContextMiddleware(\n  options: LogContextMiddlewareOptions = {},\n): (req: Request, res: Response, next: NextFunction) => void {\n  const initialContext = options.initialContext ?? (() => ({}));\n\n  return (req: Request, _res: Response, next: NextFunction) => {\n    runWithContext(initialContext(req), () => next());\n  };\n}\n"],"mappings":"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"}

package/dist/index.d.cts

@@ -0,0 +1,35 @@
+import { ExtendedProblemDetails } from "@batkit/rfc9457";
+import { NextFunction, Request, Response } from "express";
+import { LogValue } from "@batkit/logger";
+
+//#region src/error-handler.d.ts
+interface ErrorFormatter {
+  canFormat(error: unknown): boolean;
+  format(error: unknown): ExtendedProblemDetails;
+}
+declare class DefaultErrorFormatter implements ErrorFormatter {
+  canFormat(error: unknown): boolean;
+  format(error: unknown): ExtendedProblemDetails;
+  private isAxiosError;
+  private isZodError;
+  private formatAxiosError;
+  private formatZodError;
+}
+interface ErrorHandlerOptions {
+  formatters?: ErrorFormatter[];
+  includeStack?: boolean;
+  logErrors?: boolean;
+  onError?: (error: unknown, req: Request) => void;
+}
+declare function errorHandler(options?: ErrorHandlerOptions): (error: Error, req: Request, res: Response, next: NextFunction) => void;
+declare function asyncHandler(fn: (req: Request, res: Response, next: NextFunction) => Promise<unknown>): (req: Request, res: Response, next: NextFunction) => void;
+//#endregion
+//#region src/log-context-middleware.d.ts
+type LogContextInitializer = (req: Request) => Record<string, LogValue>;
+interface LogContextMiddlewareOptions {
+  initialContext?: LogContextInitializer;
+}
+declare function logContextMiddleware(options?: LogContextMiddlewareOptions): (req: Request, res: Response, next: NextFunction) => void;
+//#endregion
+export { DefaultErrorFormatter, type ErrorFormatter, type ErrorHandlerOptions, type LogContextInitializer, type LogContextMiddlewareOptions, asyncHandler, errorHandler, logContextMiddleware };
+//# sourceMappingURL=index.d.cts.map

package/dist/index.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.cts","names":[],"sources":["../src/error-handler.ts","../src/log-context-middleware.ts"],"mappings":";;;;;UAaiB,cAAA;EAIf,SAAA,CAAU,KAAA;EAKV,MAAA,CAAO,KAAA,YAAiB,sBAAsB;AAAA;AAAA,cAMnC,qBAAA,YAAiC,cAAc;EAC1D,SAAA,CAAU,KAAA;EASV,MAAA,CAAO,KAAA,YAAiB,sBAAA;EAAA,QAmChB,YAAA;EAAA,QASA,UAAA;EAAA,QASA,gBAAA;EAAA,QAaA,cAAA;AAAA;AAAA,UAoBO,mBAAA;EAIf,UAAA,GAAa,cAAA;EAKb,YAAA;EAKA,SAAA;EAKA,OAAA,IAAW,KAAA,WAAgB,GAAA,EAAK,OAAO;AAAA;AAAA,iBAyBzB,YAAA,CACd,OAAA,GAAS,mBAAA,IACP,KAAA,EAAO,KAAA,EAAO,GAAA,EAAK,OAAA,EAAS,GAAA,EAAK,QAAA,EAAU,IAAA,EAAM,YAAA;AAAA,iBA8FrC,YAAA,CACd,EAAA,GAAK,GAAA,EAAK,OAAA,EAAS,GAAA,EAAK,QAAA,EAAU,IAAA,EAAM,YAAA,KAAiB,OAAA,aACvD,GAAA,EAAK,OAAA,EAAS,GAAA,EAAK,QAAA,EAAU,IAAA,EAAM,YAAA;;;KCtQ3B,qBAAA,IAAyB,GAAA,EAAK,OAAA,KAAY,MAAA,SAAe,QAAA;AAAA,UAEpD,2BAAA;EAKf,cAAA,GAAiB,qBAAqB;AAAA;AAAA,iBAYxB,oBAAA,CACd,OAAA,GAAS,2BAAA,IACP,GAAA,EAAK,OAAA,EAAS,GAAA,EAAK,QAAA,EAAU,IAAA,EAAM,YAAA"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { DefaultErrorFormatter, asyncHandler, errorHandler, type ErrorFormatter, type ErrorHandlerOptions, } from "./error-handler.js";
+export { logContextMiddleware, type LogContextInitializer, type LogContextMiddlewareOptions, } from "./log-context-middleware.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,qBAAqB,EACrB,YAAY,EACZ,YAAY,EACZ,KAAK,cAAc,EACnB,KAAK,mBAAmB,GACzB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,oBAAoB,EACpB,KAAK,qBAAqB,EAC1B,KAAK,2BAA2B,GACjC,MAAM,6BAA6B,CAAC"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export { DefaultErrorFormatter, asyncHandler, errorHandler, } from "./error-handler.js";
+export { logContextMiddleware, } from "./log-context-middleware.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,qBAAqB,EACrB,YAAY,EACZ,YAAY,GAGb,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,oBAAoB,GAGrB,MAAM,6BAA6B,CAAC"}

package/dist/log-context-middleware.d.ts

@@ -0,0 +1,8 @@
+import type { LogValue } from "@batkit/logger";
+import type { NextFunction, Request, Response } from "express";
+export type LogContextInitializer = (req: Request) => Record<string, LogValue>;
+export interface LogContextMiddlewareOptions {
+    initialContext?: LogContextInitializer;
+}
+export declare function logContextMiddleware(options?: LogContextMiddlewareOptions): (req: Request, res: Response, next: NextFunction) => void;
+//# sourceMappingURL=log-context-middleware.d.ts.map

package/dist/log-context-middleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-context-middleware.d.ts","sourceRoot":"","sources":["../src/log-context-middleware.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE/C,OAAO,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAE/D,MAAM,MAAM,qBAAqB,GAAG,CAAC,GAAG,EAAE,OAAO,KAAK,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;AAE/E,MAAM,WAAW,2BAA2B;IAK1C,cAAc,CAAC,EAAE,qBAAqB,CAAC;CACxC;AAWD,wBAAgB,oBAAoB,CAClC,OAAO,GAAE,2BAAgC,GACxC,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,YAAY,KAAK,IAAI,CAM3D"}

package/dist/log-context-middleware.js

@@ -0,0 +1,8 @@
+import { runWithContext } from "@batkit/logger/async-local";
+export function logContextMiddleware(options = {}) {
+    const initialContext = options.initialContext ?? (() => ({}));
+    return (req, _res, next) => {
+        runWithContext(initialContext(req), () => next());
+    };
+}
+//# sourceMappingURL=log-context-middleware.js.map

package/dist/log-context-middleware.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-context-middleware.js","sourceRoot":"","sources":["../src/log-context-middleware.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAsB5D,MAAM,UAAU,oBAAoB,CAClC,UAAuC,EAAE;IAEzC,MAAM,cAAc,GAAG,OAAO,CAAC,cAAc,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAE9D,OAAO,CAAC,GAAY,EAAE,IAAc,EAAE,IAAkB,EAAE,EAAE;QAC1D,cAAc,CAAC,cAAc,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC;IACpD,CAAC,CAAC;AACJ,CAAC"}

package/package.json

@@ -0,0 +1,74 @@
+{
+  "name": "@batkit/express-middleware",
+  "version": "0.1.0",
+  "description": "Express middleware for error handling and request context (Node.js only)",
+  "keywords": [
+    "error-handling",
+    "express",
+    "middleware",
+    "rfc9457",
+    "typescript"
+  ],
+  "homepage": "https://github.com/krcourville/better-application-toolkit/tree/main/packages/express-middleware#readme",
+  "bugs": {
+    "url": "https://github.com/krcourville/better-application-toolkit/issues"
+  },
+  "license": "MIT",
+  "author": "Ken Courville",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/krcourville/better-application-toolkit.git",
+    "directory": "packages/express-middleware"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "pnpm clean && vp pack",
+    "dev": "vp pack -w",
+    "test": "vp test",
+    "test:watch": "vp test -w",
+    "typecheck": "tsc --noEmit",
+    "lint": "vp check .",
+    "clean": "rm -rf dist"
+  },
+  "dependencies": {
+    "@batkit/errors": "workspace:*",
+    "@batkit/logger": "workspace:*",
+    "@batkit/rfc9457": "workspace:*"
+  },
+  "devDependencies": {
+    "@types/express": "^5.0.0",
+    "express": "^4.21.2",
+    "typescript": "^5.7.2",
+    "vite-plus": "^0.1.14",
+    "vitest": "^4.1.2"
+  },
+  "peerDependencies": {
+    "express": "^4.18.0 || ^5.0.0"
+  },
+  "engines": {
+    "node": ">=22.0.0"
+  }
+}