woodland 22.1.0 → 22.2.0

package/README.md

@@ -155,6 +155,22 @@ app.use((error, req, res, next) => {
 });
 ```
 
+### Global Error Handling
+
+Set `app.error` to intercept all unhandled errors before the error middleware chain:
+
+```javascript
+const app = woodland();
+
+app.error = (err, _req, res) => {
+  console.error("Unhandled error:", err);
+  res.status(500).send("Internal server error");
+};
+```
+
+The handler receives 3 arguments `(err, req, res)` and must terminate the request itself. When set, the error middleware chain is skipped.
+
+
 ## Configuration
 
 ```javascript
@@ -196,6 +212,7 @@ req.cors;       // CORS enabled
 req.body;       // Request body
 req.host;       // Hostname
 req.valid;      // Request validity
+req.app;        // Woodland application instance (provides access to app.error)
 ```
 
 ## Event Handlers

package/dist/cli.cjs

@@ -4,7 +4,7 @@
  *
  * @copyright 2026 Jason Mulligan <jason.mulligan@avoidwork.com>
  * @license BSD-3-Clause
- * @version 22.1.0
+ * @version 22.2.0
  */
 'use strict';
 

package/dist/woodland.cjs

@@ -3,7 +3,7 @@
  *
  * @copyright 2026 Jason Mulligan <jason.mulligan@avoidwork.com>
  * @license BSD-3-Clause
- * @version 22.1.0
+ * @version 22.2.0
  */
 'use strict';
 
@@ -110,7 +110,6 @@ const INT_60 = 60;
 const INT_255 = 255;
 const INT_1e3 = 1e3;
 const INT_1e4 = 1e4;
-const INT_1e6$1 = 1e6;
 const INT_8000 = 8000;
 const INT_NEG_1 = -1;
 
@@ -166,6 +165,7 @@ const NEWLINE = "\n";
 const ROUTE_PATTERN = "(/.*)?";
 const MSG_USE_MIDDLEWARE_REQUIRED =
 	"useMiddleware is required or config.use must be a function";
+const MSG_MIDDLEWARE_REQUIRED = "Expected a function in the parameters";
 const EXTRACT_PATH_REPLACE = "(?<$1>[^/]+)";
 const TPL_DIR = "tpl";
 const INDEX_HTML_FILE = "index.html";
@@ -1164,6 +1164,10 @@ function next(req, res, middleware, immediate = false) {
 	 */
 	const execute = (err) => {
 		if (err !== void 0) {
+			if (typeof req.app?.error === FUNCTION) {
+				req.app.error(err, req, res);
+				return;
+			}
 			handleError(err, execute);
 		} else {
 			handleMiddleware(execute);
@@ -1357,7 +1361,7 @@ function registerMiddleware(middleware, ignored, methods, rpath, ...fn) {
 
 const DEFAULTS = {
 	autoIndex: false,
-	bodyLimit: INT_10 * INT_1e6$1,
+	bodyLimit: INT_10 * 1e6,
 	cacheSize: INT_1e3,
 	cacheTTL: INT_1e4,
 	charset: UTF_8,
@@ -1747,6 +1751,7 @@ async function serve(config, req, res, arg, folder = process.cwd()) {
 
 	if (!valid) {
 		res.error(INT_404, new Error(node_http.STATUS_CODES[INT_404]));
+		return;
 	} else if (!stats.isDirectory()) {
 		config.stream(req, res, {
 			charset: config.charset,
@@ -1754,8 +1759,10 @@ async function serve(config, req, res, arg, folder = process.cwd()) {
 			path: realFp,
 			stats: stats,
 		});
+		return;
 	} else if (!req.parsed.pathname.endsWith(SLASH)) {
 		res.redirect(`${req.parsed.pathname}${SLASH}${req.parsed.search}`);
+		return;
 	} else {
 		let files;
 		/* node:coverage ignore next 7 */
@@ -1780,13 +1787,16 @@ async function serve(config, req, res, arg, folder = process.cwd()) {
 		if (!result.length) {
 			if (!config.autoIndex) {
 				res.error(INT_404, new Error(node_http.STATUS_CODES[INT_404]));
+				return;
 			} else {
 				try {
 					const body = autoIndex(decodeURIComponent(req.parsed.pathname), files);
 					res.header(CONTENT_TYPE, `${TEXT_HTML}; charset=${config.charset}`);
 					res.send(body);
+					return;
 				} catch {
 					res.error(INT_400, new Error(node_http.STATUS_CODES[INT_400]));
+					return;
 				}
 			}
 		} else {
@@ -1805,6 +1815,7 @@ async function serve(config, req, res, arg, folder = process.cwd()) {
 				path: result,
 				stats: rstats,
 			});
+			return;
 		}
 	}
 }
@@ -1878,6 +1889,7 @@ class Woodland extends node_events.EventEmitter {
 	#logger;
 	#fileServer;
 	#middleware;
+	#error;
 
 	/**
 	 * Creates a new Woodland instance
@@ -1924,6 +1936,7 @@ class Woodland extends node_events.EventEmitter {
 		this.#logger = this.#createLogger();
 		this.#fileServer = this.#createFileServer();
 		this.#middleware = createMiddlewareRegistry(this.#methods, this.#cache);
+		this.#error = null;
 
 		this.#setupMiddleware();
 		this.#setupErrorHandling();
@@ -2097,6 +2110,10 @@ class Woodland extends node_events.EventEmitter {
 	 * @returns {Woodland} Returns self for chaining
 	 */
 	#registerMethod(method, ...args) {
+		if (args.length === INT_1 && typeof args[INT_0] === STRING) {
+			throw new TypeError(MSG_MIDDLEWARE_REQUIRED);
+		}
+
 		return this.use(...args, method);
 	}
 
@@ -2127,6 +2144,7 @@ class Woodland extends node_events.EventEmitter {
 		req.host = parsed.hostname;
 		req.params = {};
 		req.valid = true;
+		req.app = this;
 
 		const allowString = this.#allows(parsed.pathname);
 		const headersBatch = Object.create(null);
@@ -2340,7 +2358,7 @@ class Woodland extends node_events.EventEmitter {
 		/* node:coverage ignore next 5 */
 		if (this.#time && res.getHeader(X_RESPONSE_TIME) === void 0) {
 			const diff = req.precise.stop().diff();
-			const msValue = Number(diff / INT_1e6).toFixed(this.#digit);
+			const msValue = Number(diff / 1e6).toFixed(this.#digit);
 			res.header(X_RESPONSE_TIME, `${msValue}${RESPONSE_TIME_UNIT}`);
 		}
 
@@ -2543,6 +2561,19 @@ class Woodland extends node_events.EventEmitter {
 	get logger() {
 		return this.#logger;
 	}
+
+	/**
+	 * Global error handler property
+	 * @param {Function} [fn] - Error handler function
+	 * @returns {Function|null} Current error handler or null
+	 */
+	get error() {
+		return this.#error;
+	}
+
+	set error(fn) {
+		this.#error = typeof fn === FUNCTION ? fn : null;
+	}
 }
 
 /**

package/dist/woodland.js

@@ -3,7 +3,7 @@
  *
  * @copyright 2026 Jason Mulligan <jason.mulligan@avoidwork.com>
  * @license BSD-3-Clause
- * @version 22.1.0
+ * @version 22.2.0
  */
 import {STATUS_CODES}from'node:http';import {EventEmitter}from'node:events';import {readFileSync,createReadStream}from'node:fs';import {etag}from'tiny-etag';import {lru}from'tiny-lru';import {precise}from'precise';import {createRequire}from'node:module';import {join,extname,resolve,sep}from'node:path';import {fileURLToPath,URL as URL$1}from'node:url';import mimeDb from'mime-db';import {coerce}from'tiny-coerce';import {Validator}from'jsonschema';import {realpath,stat,readdir}from'node:fs/promises';const __dirname$2 = fileURLToPath(new URL$1(".", import.meta.url));
 const require$1 = createRequire(import.meta.url);
@@ -93,7 +93,6 @@ const INT_60 = 60;
 const INT_255 = 255;
 const INT_1e3 = 1e3;
 const INT_1e4 = 1e4;
-const INT_1e6$1 = 1e6;
 const INT_8000 = 8000;
 const INT_NEG_1 = -1;
 
@@ -149,6 +148,7 @@ const NEWLINE = "\n";
 const ROUTE_PATTERN = "(/.*)?";
 const MSG_USE_MIDDLEWARE_REQUIRED =
 	"useMiddleware is required or config.use must be a function";
+const MSG_MIDDLEWARE_REQUIRED = "Expected a function in the parameters";
 const EXTRACT_PATH_REPLACE = "(?<$1>[^/]+)";
 const TPL_DIR = "tpl";
 const INDEX_HTML_FILE = "index.html";
@@ -1141,6 +1141,10 @@ function next(req, res, middleware, immediate = false) {
 	 */
 	const execute = (err) => {
 		if (err !== void 0) {
+			if (typeof req.app?.error === FUNCTION) {
+				req.app.error(err, req, res);
+				return;
+			}
 			handleError(err, execute);
 		} else {
 			handleMiddleware(execute);
@@ -1332,7 +1336,7 @@ function registerMiddleware(middleware, ignored, methods, rpath, ...fn) {
 	});
 }const DEFAULTS = {
 	autoIndex: false,
-	bodyLimit: INT_10 * INT_1e6$1,
+	bodyLimit: INT_10 * 1e6,
 	cacheSize: INT_1e3,
 	cacheTTL: INT_1e4,
 	charset: UTF_8,
@@ -1718,6 +1722,7 @@ async function serve(config, req, res, arg, folder = process.cwd()) {
 
 	if (!valid) {
 		res.error(INT_404, new Error(STATUS_CODES[INT_404]));
+		return;
 	} else if (!stats.isDirectory()) {
 		config.stream(req, res, {
 			charset: config.charset,
@@ -1725,8 +1730,10 @@ async function serve(config, req, res, arg, folder = process.cwd()) {
 			path: realFp,
 			stats: stats,
 		});
+		return;
 	} else if (!req.parsed.pathname.endsWith(SLASH)) {
 		res.redirect(`${req.parsed.pathname}${SLASH}${req.parsed.search}`);
+		return;
 	} else {
 		let files;
 		/* node:coverage ignore next 7 */
@@ -1751,13 +1758,16 @@ async function serve(config, req, res, arg, folder = process.cwd()) {
 		if (!result.length) {
 			if (!config.autoIndex) {
 				res.error(INT_404, new Error(STATUS_CODES[INT_404]));
+				return;
 			} else {
 				try {
 					const body = autoIndex(decodeURIComponent(req.parsed.pathname), files);
 					res.header(CONTENT_TYPE, `${TEXT_HTML}; charset=${config.charset}`);
 					res.send(body);
+					return;
 				} catch {
 					res.error(INT_400, new Error(STATUS_CODES[INT_400]));
+					return;
 				}
 			}
 		} else {
@@ -1776,6 +1786,7 @@ async function serve(config, req, res, arg, folder = process.cwd()) {
 				path: result,
 				stats: rstats,
 			});
+			return;
 		}
 	}
 }
@@ -1847,6 +1858,7 @@ class Woodland extends EventEmitter {
 	#logger;
 	#fileServer;
 	#middleware;
+	#error;
 
 	/**
 	 * Creates a new Woodland instance
@@ -1893,6 +1905,7 @@ class Woodland extends EventEmitter {
 		this.#logger = this.#createLogger();
 		this.#fileServer = this.#createFileServer();
 		this.#middleware = createMiddlewareRegistry(this.#methods, this.#cache);
+		this.#error = null;
 
 		this.#setupMiddleware();
 		this.#setupErrorHandling();
@@ -2066,6 +2079,10 @@ class Woodland extends EventEmitter {
 	 * @returns {Woodland} Returns self for chaining
 	 */
 	#registerMethod(method, ...args) {
+		if (args.length === INT_1 && typeof args[INT_0] === STRING) {
+			throw new TypeError(MSG_MIDDLEWARE_REQUIRED);
+		}
+
 		return this.use(...args, method);
 	}
 
@@ -2096,6 +2113,7 @@ class Woodland extends EventEmitter {
 		req.host = parsed.hostname;
 		req.params = {};
 		req.valid = true;
+		req.app = this;
 
 		const allowString = this.#allows(parsed.pathname);
 		const headersBatch = Object.create(null);
@@ -2309,7 +2327,7 @@ class Woodland extends EventEmitter {
 		/* node:coverage ignore next 5 */
 		if (this.#time && res.getHeader(X_RESPONSE_TIME) === void 0) {
 			const diff = req.precise.stop().diff();
-			const msValue = Number(diff / INT_1e6).toFixed(this.#digit);
+			const msValue = Number(diff / 1e6).toFixed(this.#digit);
 			res.header(X_RESPONSE_TIME, `${msValue}${RESPONSE_TIME_UNIT}`);
 		}
 
@@ -2512,6 +2530,19 @@ class Woodland extends EventEmitter {
 	get logger() {
 		return this.#logger;
 	}
+
+	/**
+	 * Global error handler property
+	 * @param {Function} [fn] - Error handler function
+	 * @returns {Function|null} Current error handler or null
+	 */
+	get error() {
+		return this.#error;
+	}
+
+	set error(fn) {
+		this.#error = typeof fn === FUNCTION ? fn : null;
+	}
 }
 
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "woodland",
-  "version": "22.1.0",
+  "version": "22.2.0",
   "description": "Secure HTTP framework for Node.js. Express-compatible with built-in security, no performance tradeoff.",
   "keywords": [
     "api",
@@ -73,7 +73,7 @@
   "devDependencies": {
     "auto-changelog": "^2.5.0",
     "husky": "^9.1.7",
-    "oxfmt": "^0.46.0",
+    "oxfmt": "^0.49.0",
     "oxlint": "^1.57.0",
     "rimraf": "^6.1.3",
     "rollup": "^4.60.0"

package/types/woodland.d.ts

@@ -49,6 +49,9 @@ export class Woodland extends EventEmitter {
 		clf: (...args: any[]) => string;
 	}>;
 
+	// Public error handler property (getter/setter)
+	error: ((err: Error, req: any, res: any) => void) | null;
+
 	constructor(config?: WoodlandConfig);
 
 	// Public routing methods - with path