wooks 0.7.28 → 0.7.29

package/dist/index.cjs

@@ -46,37 +46,51 @@ var Wooks = class {
 		return {};
 	}
 	/**
-	* Looks up a route by method and path, setting route params in the current event context.
+	* Matches a route by method and path without touching any event context:
+	* no route params are seeded and no `ContextInjector` hooks fire.
+	*
+	* Use it to decide whether a request is handled here before creating an event
+	* context, then call `applyRoute()` inside the context with the returned match.
 	* @param method - HTTP method (e.g., "GET", "POST").
 	* @param path - URL path to match against registered routes.
+	* @returns The route match, or `null` when no route with handlers matches.
 	*/
-	lookup(method, path, ctx = (0, _wooksjs_event_core.current)()) {
+	matchRoute(method, path) {
 		const found = this.getRouter().lookup(method, path || "");
-		ctx.set(_wooksjs_event_core.routeParamsKey, found?.ctx?.params || {});
+		return found && found.route.handlers.length ? found : null;
+	}
+	applyRoute(method, match, ctx = (0, _wooksjs_event_core.current)()) {
 		const ci = (0, _wooksjs_event_core.getContextInjector)();
-		if (found?.route?.handlers.length) ci?.hook(method, "Handler:routed", found.route.path);
-		else ci?.hook(method, "Handler:not_found");
+		if (match) {
+			ctx.set(_wooksjs_event_core.routeParamsKey, match.ctx.params || {});
+			ci?.hook(method, "Handler:routed", match.route.path);
+			return match.route.handlers;
+		}
+		ctx.set(_wooksjs_event_core.routeParamsKey, {});
+		ci?.hook(method, "Handler:not_found");
+		return null;
+	}
+	/**
+	* Looks up a route by method and path, setting route params in the current event context.
+	* @param method - HTTP method (e.g., "GET", "POST").
+	* @param path - URL path to match against registered routes.
+	*/
+	lookup(method, path, ctx = (0, _wooksjs_event_core.current)()) {
+		const match = this.matchRoute(method, path);
 		return {
-			handlers: found?.route?.handlers || null,
-			segments: found?.route?.segments || null,
-			firstStatic: found?.route?.firstStatic || null,
-			path: found?.route?.path || null
+			handlers: this.applyRoute(method, match, ctx),
+			segments: match?.route.segments || null,
+			firstStatic: match?.route.firstStatic || null,
+			path: match?.route.path || null
 		};
 	}
 	/**
 	* Fast lookup that returns only the handlers array (or null).
 	* Avoids allocating a result object on each request.
+	* Equivalent to `applyRoute(method, matchRoute(method, path), ctx)`.
 	*/
 	lookupHandlers(method, path, ctx = (0, _wooksjs_event_core.current)()) {
-		const found = this.getRouter().lookup(method, path || "");
-		ctx.set(_wooksjs_event_core.routeParamsKey, found?.ctx?.params || {});
-		const ci = (0, _wooksjs_event_core.getContextInjector)();
-		if (found?.route?.handlers.length) {
-			ci?.hook(method, "Handler:routed", found.route.path);
-			return found.route.handlers;
-		}
-		ci?.hook(method, "Handler:not_found");
-		return null;
+		return this.applyRoute(method, this.matchRoute(method, path), ctx);
 	}
 	/**
 	* Registers a route handler for the given method and path.

package/dist/index.d.ts

@@ -3,7 +3,7 @@ export { EventContextOptions, Logger, useEventId, useLogger, useRouteParams } fr
 import { IncomingMessage } from 'http';
 import { Duplex } from 'stream';
 import { TConsoleBase, TProstoLoggerOptions } from '@prostojs/logger';
-import { ProstoRouter, TParsedSegment, TProstoRouterPathHandle } from '@prostojs/router';
+import { TProstoLookupResult, ProstoRouter, TParsedSegment, TProstoRouterPathHandle } from '@prostojs/router';
 export { TProstoRouterPathHandle } from '@prostojs/router';
 
 /** A route handler function that returns a response synchronously or asynchronously. */
@@ -40,6 +40,8 @@ interface TWooksOptions {
         cacheLimit?: number;
     };
 }
+/** A matched route (from `Wooks.matchRoute()`): the route with its handlers plus the parsed route params. */
+type TWooksRouteMatch = TProstoLookupResult<TWooksHandler>;
 /**
  * Core Wooks framework class that manages routing and logging.
  *
@@ -63,6 +65,27 @@ declare class Wooks {
     getLogger(topic: string): TConsoleBase;
     /** Returns the current logger configuration options. */
     getLoggerOptions(): TProstoLoggerOptions;
+    /**
+     * Matches a route by method and path without touching any event context:
+     * no route params are seeded and no `ContextInjector` hooks fire.
+     *
+     * Use it to decide whether a request is handled here before creating an event
+     * context, then call `applyRoute()` inside the context with the returned match.
+     * @param method - HTTP method (e.g., "GET", "POST").
+     * @param path - URL path to match against registered routes.
+     * @returns The route match, or `null` when no route with handlers matches.
+     */
+    matchRoute(method: string, path: string): TWooksRouteMatch | null;
+    /**
+     * Applies a route match (from `matchRoute()`) to an event context: seeds route params
+     * (`useRouteParams()`) and fires the `Handler:routed` / `Handler:not_found` hook.
+     * @param method - HTTP method the match was made for.
+     * @param match - Result of `matchRoute()` (`null` = not found).
+     * @param ctx - Event context to seed (defaults to the current one).
+     * @returns The matched route's handlers, or `null` when `match` is `null`.
+     */
+    applyRoute(method: string, match: TWooksRouteMatch, ctx?: EventContext): TWooksHandler[];
+    applyRoute(method: string, match: TWooksRouteMatch | null, ctx?: EventContext): TWooksHandler[] | null;
     /**
      * Looks up a route by method and path, setting route params in the current event context.
      * @param method - HTTP method (e.g., "GET", "POST").
@@ -77,6 +100,7 @@ declare class Wooks {
     /**
      * Fast lookup that returns only the handlers array (or null).
      * Avoids allocating a result object on each request.
+     * Equivalent to `applyRoute(method, matchRoute(method, path), ctx)`.
      */
     lookupHandlers(method: string, path: string, ctx?: EventContext): TWooksHandler[] | null;
     /**
@@ -144,4 +168,4 @@ declare class WooksAdapterBase {
 }
 
 export { Wooks, WooksAdapterBase, clearGlobalWooks, getGlobalWooks };
-export type { TWooksHandler, TWooksOptions, WooksUpgradeHandler };
+export type { TWooksHandler, TWooksOptions, TWooksRouteMatch, WooksUpgradeHandler };

package/dist/index.mjs

@@ -45,37 +45,51 @@ var Wooks = class {
 		return {};
 	}
 	/**
-	* Looks up a route by method and path, setting route params in the current event context.
+	* Matches a route by method and path without touching any event context:
+	* no route params are seeded and no `ContextInjector` hooks fire.
+	*
+	* Use it to decide whether a request is handled here before creating an event
+	* context, then call `applyRoute()` inside the context with the returned match.
 	* @param method - HTTP method (e.g., "GET", "POST").
 	* @param path - URL path to match against registered routes.
+	* @returns The route match, or `null` when no route with handlers matches.
 	*/
-	lookup(method, path, ctx = current()) {
+	matchRoute(method, path) {
 		const found = this.getRouter().lookup(method, path || "");
-		ctx.set(routeParamsKey, found?.ctx?.params || {});
+		return found && found.route.handlers.length ? found : null;
+	}
+	applyRoute(method, match, ctx = current()) {
 		const ci = getContextInjector();
-		if (found?.route?.handlers.length) ci?.hook(method, "Handler:routed", found.route.path);
-		else ci?.hook(method, "Handler:not_found");
+		if (match) {
+			ctx.set(routeParamsKey, match.ctx.params || {});
+			ci?.hook(method, "Handler:routed", match.route.path);
+			return match.route.handlers;
+		}
+		ctx.set(routeParamsKey, {});
+		ci?.hook(method, "Handler:not_found");
+		return null;
+	}
+	/**
+	* Looks up a route by method and path, setting route params in the current event context.
+	* @param method - HTTP method (e.g., "GET", "POST").
+	* @param path - URL path to match against registered routes.
+	*/
+	lookup(method, path, ctx = current()) {
+		const match = this.matchRoute(method, path);
 		return {
-			handlers: found?.route?.handlers || null,
-			segments: found?.route?.segments || null,
-			firstStatic: found?.route?.firstStatic || null,
-			path: found?.route?.path || null
+			handlers: this.applyRoute(method, match, ctx),
+			segments: match?.route.segments || null,
+			firstStatic: match?.route.firstStatic || null,
+			path: match?.route.path || null
 		};
 	}
 	/**
 	* Fast lookup that returns only the handlers array (or null).
 	* Avoids allocating a result object on each request.
+	* Equivalent to `applyRoute(method, matchRoute(method, path), ctx)`.
 	*/
 	lookupHandlers(method, path, ctx = current()) {
-		const found = this.getRouter().lookup(method, path || "");
-		ctx.set(routeParamsKey, found?.ctx?.params || {});
-		const ci = getContextInjector();
-		if (found?.route?.handlers.length) {
-			ci?.hook(method, "Handler:routed", found.route.path);
-			return found.route.handlers;
-		}
-		ci?.hook(method, "Handler:not_found");
-		return null;
+		return this.applyRoute(method, this.matchRoute(method, path), ctx);
 	}
 	/**
 	* Registers a route handler for the given method and path.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wooks",
-  "version": "0.7.28",
+  "version": "0.7.29",
   "description": "wooks",
   "keywords": [
     "api",
@@ -42,13 +42,13 @@
   "dependencies": {
     "@prostojs/logger": "^0.4.3",
     "@prostojs/router": "^0.3.5",
-    "@wooksjs/event-core": "^0.7.28"
+    "@wooksjs/event-core": "^0.7.29"
   },
   "devDependencies": {
     "typescript": "^5.9.3",
     "vitest": "^3.2.7",
-    "@wooksjs/http-body": "^0.7.28",
-    "@wooksjs/event-http": "^0.7.28"
+    "@wooksjs/event-http": "^0.7.29",
+    "@wooksjs/http-body": "^0.7.29"
   },
   "scripts": {
     "build": "rolldown -c ../../rolldown.config.mjs"