routup 5.1.0 → 5.2.0

package/dist/{src-BYuhKm-d.mjs → src-DX0rndew.mjs}

@@ -1,4 +1,5 @@
 import { FastURL } from "srvx";
+import { hasInstanceof, markInstanceof } from "@ebec/core";
 import { HTTPError, isHTTPError } from "@ebec/http";
 import { subtle } from "uncrypto";
 import { merge } from "smob";
@@ -65,10 +66,10 @@ function setResponseCacheHeaders(event, options) {
 //#region src/error/module.ts
 const ErrorSymbol = Symbol.for("RoutupError");
 var RoutupError = class extends HTTPError {
-	"@instanceof" = ErrorSymbol;
 	constructor(input = {}) {
 		super(input);
 		this.name = "RoutupError";
+		markInstanceof(this, ErrorSymbol);
 	}
 };
 //#endregion
@@ -189,12 +190,6 @@ function buildTrustProxyFn(input) {
 	return compile(input || []);
 }
 //#endregion
-//#region src/utils/is-instance.ts
-function isInstance(input, sym) {
-	if (!isObject(input)) return false;
-	return input["@instanceof"] === sym;
-}
-//#endregion
 //#region src/utils/mime.ts
 function getMimeType(type) {
 	if (type.includes("/")) return type;
@@ -341,8 +336,7 @@ function setResponseHeaderContentType(event, input, ifNotExists) {
 //#endregion
 //#region src/error/is.ts
 function isError(input) {
-	if (!isHTTPError(input)) return false;
-	return isInstance(input, ErrorSymbol);
+	return hasInstanceof(input, ErrorSymbol);
 }
 //#endregion
 //#region src/error/create.ts
@@ -833,7 +827,7 @@ const HookName = {
 };
 //#endregion
 //#region src/hook/module.ts
-var HookManager = class {
+var Hooks = class Hooks {
 	items;
 	constructor() {
 		this.items = {};
@@ -863,6 +857,23 @@ var HookManager = class {
 		}
 		if (this.items[name].length === 0) delete this.items[name];
 	}
+	/**
+	* Create a new `Hooks` instance seeded with the same listeners as this
+	* one.
+	*
+	* Listener functions are shared by reference; priority and ordering are
+	* preserved. Future mutations on the returned instance do not affect this
+	* one (and vice versa).
+	*/
+	clone() {
+		const next = new Hooks();
+		const names = Object.keys(this.items);
+		for (const name of names) {
+			const entries = this.items[name];
+			for (const entry of entries) next.addListener(name, entry.fn, entry.priority);
+		}
+		return next;
+	}
 	async trigger(name, event) {
 		if (!this.items[name] || this.items[name].length === 0) return;
 		try {
@@ -973,18 +984,18 @@ function matchHandlerMethod(handlerMethod, requestMethod) {
 //#endregion
 //#region src/handler/module.ts
 var Handler = class {
-	"@instanceof" = HandlerSymbol;
 	config;
-	hookManager;
+	hooks;
 	pathMatcher;
 	method;
 	constructor(handler) {
 		this.config = handler;
-		this.hookManager = new HookManager();
+		this.hooks = new Hooks();
 		this.mountHooks();
 		if (typeof handler.path === "string") this.config.path = withLeadingSlash(handler.path);
 		this.pathMatcher = buildHandlerPathMatcher(this.config.path, !!this.config.method);
 		this.method = this.config.method ? toMethodName(this.config.method) : void 0;
+		markInstanceof(this, HandlerSymbol);
 	}
 	get type() {
 		return this.config.type;
@@ -1000,7 +1011,7 @@ var Handler = class {
 				...pathMatch.params
 			};
 		}
-		await this.hookManager.trigger(HookName.CHILD_DISPATCH_BEFORE, event);
+		await this.hooks.trigger(HookName.CHILD_DISPATCH_BEFORE, event);
 		if (event.dispatched) return;
 		let response;
 		try {
@@ -1039,11 +1050,11 @@ var Handler = class {
 			if (response) event.dispatched = true;
 		} catch (e) {
 			event.error = isError(e) ? e : createError(e);
-			await this.hookManager.trigger(HookName.ERROR, event);
+			await this.hooks.trigger(HookName.ERROR, event);
 			if (event.dispatched) event.error = void 0;
 			else throw event.error;
 		}
-		await this.hookManager.trigger(HookName.CHILD_DISPATCH_AFTER, event);
+		await this.hooks.trigger(HookName.CHILD_DISPATCH_AFTER, event);
 		return response;
 	}
 	matchPath(path) {
@@ -1113,9 +1124,9 @@ var Handler = class {
 		return Math.min(routerDefault, handlerOverride);
 	}
 	mountHooks() {
-		if (this.config.onBefore) this.hookManager.addListener(HookName.CHILD_DISPATCH_BEFORE, this.config.onBefore);
-		if (this.config.onAfter) this.hookManager.addListener(HookName.CHILD_DISPATCH_AFTER, this.config.onAfter);
-		if (this.config.onError) this.hookManager.addListener(HookName.ERROR, this.config.onError);
+		if (this.config.onBefore) this.hooks.addListener(HookName.CHILD_DISPATCH_BEFORE, this.config.onBefore);
+		if (this.config.onAfter) this.hooks.addListener(HookName.CHILD_DISPATCH_AFTER, this.config.onAfter);
+		if (this.config.onError) this.hooks.addListener(HookName.ERROR, this.config.onError);
 	}
 };
 //#endregion
@@ -1275,7 +1286,7 @@ function isHandlerOptions(input) {
 	return isObject(input) && typeof input.fn === "function" && typeof input.type === "string";
 }
 function isHandler(input) {
-	return isInstance(input, HandlerSymbol);
+	return hasInstanceof(input, HandlerSymbol);
 }
 //#endregion
 //#region src/request/helpers/cache.ts
@@ -1496,7 +1507,7 @@ const RouterStackEntryType = {
 //#endregion
 //#region src/router/utils.ts
 function isRouterInstance(input) {
-	return isInstance(input, RouterSymbol);
+	return hasInstanceof(input, RouterSymbol);
 }
 /**
 * Build a non-terminal `PathMatcher` for a router mount path.
@@ -1520,8 +1531,16 @@ function acceptsJson(request) {
 }
 //#endregion
 //#region src/router/module.ts
+const METHOD_TO_REGISTER = {
+	[MethodName.GET]: "get",
+	[MethodName.POST]: "post",
+	[MethodName.PUT]: "put",
+	[MethodName.PATCH]: "patch",
+	[MethodName.DELETE]: "delete",
+	[MethodName.HEAD]: "head",
+	[MethodName.OPTIONS]: "options"
+};
 var Router = class Router {
-	"@instanceof" = RouterSymbol;
 	/**
 	* A label for the router instance.
 	*/
@@ -1541,11 +1560,11 @@ var Router = class Router {
 	*/
 	pathMatcher;
 	/**
-	* A hook manager.
+	* Lifecycle hook registry.
 	*
 	* @protected
 	*/
-	hookManager;
+	hooks;
 	/**
 	* Normalized options for this router instance.
 	*/
@@ -1558,9 +1577,12 @@ var Router = class Router {
 	plugins = /* @__PURE__ */ new Map();
 	constructor(input = {}) {
 		this.name = input.name;
-		this.hookManager = new HookManager();
-		this._options = normalizeRouterOptions(input);
-		this.pathMatcher = buildRouterPathMatcher(input.path);
+		const { hooks = new Hooks(), plugins = /* @__PURE__ */ new Map(), ...options } = input;
+		this.hooks = hooks;
+		this.plugins = new Map(plugins);
+		this._options = normalizeRouterOptions(options);
+		this.pathMatcher = buildRouterPathMatcher(options.path);
+		markInstanceof(this, RouterSymbol);
 	}
 	matchPath(path) {
 		if (this.pathMatcher) return this.pathMatcher.test(path);
@@ -1642,7 +1664,7 @@ var Router = class Router {
 		await this.executePipelineStepFinish(context);
 	}
 	async executePipelineStepStart(context) {
-		await this.hookManager.trigger(HookName.REQUEST, context.event);
+		await this.hooks.trigger(HookName.REQUEST, context.event);
 		if (context.event.dispatched) context.step = RouterPipelineStep.FINISH;
 		else context.step = RouterPipelineStep.LOOKUP;
 	}
@@ -1659,7 +1681,7 @@ var Router = class Router {
 					const method = entry.method ?? handler.method;
 					if (method) context.event.methodsAllowed.add(method);
 					if (matchHandlerMethod(method, context.event.method)) {
-						await this.hookManager.trigger(HookName.CHILD_MATCH, context.event);
+						await this.hooks.trigger(HookName.CHILD_MATCH, context.event);
 						if (context.event.dispatched) context.step = RouterPipelineStep.FINISH;
 						else context.step = RouterPipelineStep.CHILD_BEFORE;
 						return;
@@ -1669,7 +1691,7 @@ var Router = class Router {
 				continue;
 			}
 			if (entry.pathMatcher ? entry.pathMatcher.test(context.event.path) : entry.data.matchPath(context.event.path)) {
-				await this.hookManager.trigger(HookName.CHILD_MATCH, context.event);
+				await this.hooks.trigger(HookName.CHILD_MATCH, context.event);
 				if (context.event.dispatched) context.step = RouterPipelineStep.FINISH;
 				else context.step = RouterPipelineStep.CHILD_BEFORE;
 				return;
@@ -1679,12 +1701,12 @@ var Router = class Router {
 		context.step = RouterPipelineStep.FINISH;
 	}
 	async executePipelineStepChildBefore(context) {
-		await this.hookManager.trigger(HookName.CHILD_DISPATCH_BEFORE, context.event);
+		await this.hooks.trigger(HookName.CHILD_DISPATCH_BEFORE, context.event);
 		if (context.event.dispatched) context.step = RouterPipelineStep.FINISH;
 		else context.step = RouterPipelineStep.CHILD_DISPATCH;
 	}
 	async executePipelineStepChildAfter(context) {
-		await this.hookManager.trigger(HookName.CHILD_DISPATCH_AFTER, context.event);
+		await this.hooks.trigger(HookName.CHILD_DISPATCH_AFTER, context.event);
 		if (context.event.dispatched) context.step = RouterPipelineStep.FINISH;
 		else context.step = RouterPipelineStep.LOOKUP;
 	}
@@ -1735,7 +1757,7 @@ var Router = class Router {
 			}
 		} catch (e) {
 			event.error = createError(e);
-			await this.hookManager.trigger(HookName.ERROR, event);
+			await this.hooks.trigger(HookName.ERROR, event);
 		}
 		if (!event.dispatched) {
 			event.path = savedPath;
@@ -1746,7 +1768,7 @@ var Router = class Router {
 		context.step = RouterPipelineStep.CHILD_AFTER;
 	}
 	async executePipelineStepFinish(context) {
-		if (context.event.error || context.event.dispatched) return this.hookManager.trigger(HookName.RESPONSE, context.event);
+		if (context.event.error || context.event.dispatched) return this.hooks.trigger(HookName.RESPONSE, context.event);
 		if (!context.event.dispatched && context.event.routerPath.length === 1 && context.event.method && context.event.method === MethodName.OPTIONS) {
 			if (context.event.methodsAllowed.has(MethodName.GET)) context.event.methodsAllowed.add(MethodName.HEAD);
 			const options = [...context.event.methodsAllowed].map((key) => key.toUpperCase()).join(",");
@@ -1758,7 +1780,7 @@ var Router = class Router {
 			});
 			context.event.dispatched = true;
 		}
-		return this.hookManager.trigger(HookName.RESPONSE, context.event);
+		return this.hooks.trigger(HookName.RESPONSE, context.event);
 	}
 	async dispatch(event) {
 		const savedPath = event.path;
@@ -1844,6 +1866,7 @@ var Router = class Router {
 				type: RouterStackEntryType.HANDLER,
 				data: handler,
 				method,
+				path,
 				pathMatcher: buildHandlerPathMatcher(path ?? handler.path, true)
 			});
 		}
@@ -1859,6 +1882,7 @@ var Router = class Router {
 				this.stack.push({
 					type: RouterStackEntryType.ROUTER,
 					data: item,
+					path,
 					pathMatcher: buildRouterPathMatcher(path)
 				});
 				continue;
@@ -1870,7 +1894,8 @@ var Router = class Router {
 				});
 				this.stack.push({
 					type: RouterStackEntryType.HANDLER,
-					data: handler
+					data: handler,
+					path
 				});
 				continue;
 			}
@@ -1878,6 +1903,7 @@ var Router = class Router {
 				this.stack.push({
 					type: RouterStackEntryType.HANDLER,
 					data: item,
+					path,
 					pathMatcher: buildHandlerPathMatcher(path, !!item.method)
 				});
 				continue;
@@ -1909,19 +1935,59 @@ var Router = class Router {
 		this.plugins.set(plugin.name, plugin.version);
 		return this;
 	}
+	/**
+	* Return a new `Router` that mirrors this one but owns independent
+	* mountable state.
+	*
+	* The new router has:
+	* - a fresh `stack` array of shallow-copied entries (handlers and child
+	*   routers are shared by reference; only the wrapping entries are new)
+	* - the same `pathMatcher` reference (it is stateless)
+	* - a fresh `Hooks` instance seeded with the current listeners
+	* - a shallow copy of `_options`
+	* - a fresh `plugins` map with the same entries
+	*
+	* Use this when the same logical router needs to be mounted under
+	* multiple paths — each mount can receive its own clone so subsequent
+	* mutations on one mount do not bleed into the others.
+	*/
+	clone() {
+		const next = new Router({
+			...this._options,
+			hooks: this.hooks.clone(),
+			plugins: this.plugins
+		});
+		for (const entry of this.stack) {
+			if (entry.type === RouterStackEntryType.ROUTER) {
+				const data = entry.data.clone();
+				if (entry.path) next.use(entry.path, data);
+				else next.use(data);
+				continue;
+			}
+			if (entry.method) {
+				const register = METHOD_TO_REGISTER[entry.method];
+				if (entry.path) next[register](entry.path, entry.data);
+				else next[register](entry.data);
+				continue;
+			}
+			if (entry.path) next.use(entry.path, entry.data);
+			else next.use(entry.data);
+		}
+		return next;
+	}
 	on(name, fn, priority) {
-		return this.hookManager.addListener(name, fn, priority);
+		return this.hooks.addListener(name, fn, priority);
 	}
 	off(name, fn) {
 		if (typeof fn === "undefined") {
-			this.hookManager.removeListener(name);
+			this.hooks.removeListener(name);
 			return this;
 		}
-		this.hookManager.removeListener(name, fn);
+		this.hooks.removeListener(name, fn);
 		return this;
 	}
 };
 //#endregion
 export { setResponseHeaderAttachment as $, Handler as A, sendRedirect as B, fromWebHandler as C, fromNodeMiddleware as D, fromNodeHandler as E, HandlerSymbol as F, getRequestHeader as G, getRequestAcceptableContentType as H, HandlerType as I, sendAccepted as J, sendFile as K, DispatcherEvent as L, matchHandlerMethod as M, isPath as N, defineErrorHandler as O, PathMatcher as P, setResponseHeaderContentType as Q, RoutupEvent as R, isHandlerOptions as S, isWebHandlerProvider as T, getRequestAcceptableContentTypes as U, sendFormat as V, useRequestNegotiator as W, createError as X, toResponse as Y, isError as Z, getRequestAcceptableEncodings as _, PluginInstallError as a, serializeEventStreamMessage as at, isRequestCacheable as b, isPluginError as c, setResponseCacheHeaders as ct, getRequestIP as d, setResponseHeaderInline as et, getRequestHostName as f, getRequestAcceptableEncoding as g, getRequestAcceptableLanguages as h, PluginNotInstalledError as i, createEventStream as it, buildHandlerPathMatcher as j, defineCoreHandler as k, PluginErrorCode as l, HeaderName as lt, getRequestAcceptableLanguage as m, normalizeRouterOptions as n, appendResponseHeader as nt, PluginAlreadyInstalledError as o, ErrorSymbol as ot, matchRequestContentType as p, sendCreated as q, isPlugin as r, appendResponseHeaderDirective as rt, PluginError as s, RoutupError as st, Router as t, setResponseContentTypeByFileName as tt, getRequestProtocol as u, MethodName as ut, getRequestAcceptableCharset as v, isWebHandler as w, isHandler as x, getRequestAcceptableCharsets as y, sendStream as z };
 
-//# sourceMappingURL=src-BYuhKm-d.mjs.map
+//# sourceMappingURL=src-DX0rndew.mjs.map