@stacksjs/bun-router 0.0.7 → 0.0.8

package/dist/cli.js

@@ -1879,7 +1879,7 @@ var prefix = getPrefix();
 var color18 = __toESM(require_picocolors(), 1);
 var import_picocolors19 = __toESM(require_picocolors(), 1);
 // package.json
-var version = "0.0.7";
+var version = "0.0.8";
 
 // src/cli/middleware.ts
 import fs from "fs/promises";

package/dist/index.js

@@ -9276,6 +9276,10 @@ class Router {
     enhancedReq.header = (name) => {
       return req.headers.get(name) || req.headers.get(name.toLowerCase()) || null;
     };
+    enhancedReq.cookie = (name, defaultValue) => {
+      const value = getCookies()[name];
+      return value !== undefined ? value : defaultValue ?? null;
+    };
     enhancedReq.getParam = (name, defaultValue) => {
       const value = params?.[name];
       return value !== undefined ? value : defaultValue;
@@ -9530,6 +9534,17 @@ class RouteGroupBuilder2 {
     return this;
   }
 }
+var _enhancementHost = null;
+function getEnhancementHost() {
+  if (_enhancementHost === null)
+    _enhancementHost = new Router;
+  return _enhancementHost;
+}
+function applyRequestEnhancements(req, params = {}) {
+  if (typeof req.bearerToken === "function")
+    return req;
+  return getEnhancementHost().enhanceRequest(req, params);
+}
 
 // src/router/server.ts
 function registerServerHandling(RouterClass) {
@@ -13815,6 +13830,7 @@ export {
   authMocks,
   authHelpers,
   auth,
+  applyRequestEnhancements,
   apiKeyAuth,
   WebSocketTester,
   ValidationMiddlewareBuilder,

package/dist/router/index.d.ts

@@ -4,6 +4,7 @@ import { FluentRouteBuilder, FluentRouter, RouteFactory, router, RouterUtils } f
 import { Router } from './router';
 import '../types';
 export { Router };
+export { applyRequestEnhancements } from './router';
 declare module './router' {
     interface Router {
         stream: (callback: () => Generator<string | Uint8Array, void, unknown> | AsyncGenerator<string | Uint8Array, void, unknown>, status?: number, headers?: Record<string, string>) => Response;

package/dist/router/router.d.ts

@@ -274,3 +274,21 @@ export declare class RouteGroupBuilder {
     put(_path: string, _handler: RouteHandler): this;
     delete(_path: string, _handler: RouteHandler): this;
 }
+/**
+ * Attach bun-router's request macros (`bearerToken`, `getParam`, `cookie`,
+ * `cookies`, `header`, `params`, plus the Laravel-style input helpers
+ * `get`, `input`, `string`, `integer`, `float`, `boolean`, `array`, `has`,
+ * `filled`, etc.) to a request.
+ *
+ * Idempotent: calling on an already-enhanced request returns it unchanged.
+ * We sniff `req.bearerToken` as the marker — cheap and reliable since no
+ * native Request has it.
+ *
+ * @example
+ * import { applyRequestEnhancements } from '@stacksjs/bun-router'
+ *
+ * const enhanced = applyRequestEnhancements(req, { id: '42' })
+ * enhanced.bearerToken()  // → string | null
+ * enhanced.getParam('id') // → '42'
+ */
+export declare function applyRequestEnhancements(req: Request | EnhancedRequest, params?: Record<string, string>): EnhancedRequest;

package/dist/types.d.ts

@@ -688,6 +688,12 @@ export interface EnhancedRequest extends Request, Omit<RequestMacroMethods, 'ip'
      * Route parameters extracted from the URL
      */
     params: Record<string, string>;
+    /**
+     * Lookup a single route param. Equivalent to `request.params[name]` but
+     * with optional default-value handling, matching the Laravel-style
+     * `$request->route('name')` ergonomics.
+     */
+    getParam: <T = string>(name: string, defaultValue?: T) => T | undefined;
     /**
      * Query parameters from the URL
      */

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@stacksjs/bun-router",
   "type": "module",
-  "version": "0.0.7",
+  "version": "0.0.8",
   "description": "A fast, type-safe router for Bun.",
   "author": "Chris Breuer <chris@stacksjs.org>",
   "license": "MIT",

package/src/router/index.ts

@@ -33,8 +33,10 @@ registerModelBinding(Router)
 registerFileBasedRouting(Router)
 registerApiRoutes(Router)
 
-// Export the Router class and fluent routing features
+// Export the Router class, the standalone request-enhancement helper, and
+// fluent routing features.
 export { Router }
+export { applyRequestEnhancements } from './router'
 
 // Type augmentation for Laravel-style methods
 declare module './router' {

package/src/router/router.ts

@@ -1147,6 +1147,15 @@ export class Router {
       return req.headers.get(name) || req.headers.get(name.toLowerCase()) || null
     }
 
+    // Convenience cookie reader. The full `enhancedReq.cookies.get(name)` API
+    // is also available below — `cookie(name)` is the shorter form callers
+    // (and the Laravel-style macros) reach for first, so it deserves a
+    // direct method on the enhanced request, not just on the macros class.
+    ;(enhancedReq as any).cookie = (name: string, defaultValue?: string): string | null => {
+      const value = getCookies()[name]
+      return value !== undefined ? value : (defaultValue ?? null)
+    }
+
     ;(enhancedReq as any).getParam = <T = string>(name: string, defaultValue?: T): T | undefined => {
       const value = params?.[name] as T | undefined
       return value !== undefined ? value : defaultValue
@@ -1522,3 +1531,51 @@ export class RouteGroupBuilder {
     return this
   }
 }
+
+// ---------------------------------------------------------------------------
+// Standalone enhancement helper
+// ---------------------------------------------------------------------------
+
+// Singleton scratch Router used to expose `enhanceRequest` as a standalone
+// function. Downstream consumers (frameworks layered on bun-router) often
+// need to attach the request macros to a request that was created outside
+// of `route.serve()` — for instance, when a higher-level router wraps
+// each handler with its own middleware chain. Without an exported function,
+// those consumers either spin up their own `new Router()` per call or
+// duplicate the attachment logic in user code.
+//
+// We share one instance because `enhanceRequest` does not depend on any
+// per-router state (route table, middleware groups, etc.) — it only reads
+// from the request and the supplied params.
+let _enhancementHost: Router | null = null
+
+function getEnhancementHost(): Router {
+  if (_enhancementHost === null) _enhancementHost = new Router()
+  return _enhancementHost
+}
+
+/**
+ * Attach bun-router's request macros (`bearerToken`, `getParam`, `cookie`,
+ * `cookies`, `header`, `params`, plus the Laravel-style input helpers
+ * `get`, `input`, `string`, `integer`, `float`, `boolean`, `array`, `has`,
+ * `filled`, etc.) to a request.
+ *
+ * Idempotent: calling on an already-enhanced request returns it unchanged.
+ * We sniff `req.bearerToken` as the marker — cheap and reliable since no
+ * native Request has it.
+ *
+ * @example
+ * import { applyRequestEnhancements } from '@stacksjs/bun-router'
+ *
+ * const enhanced = applyRequestEnhancements(req, { id: '42' })
+ * enhanced.bearerToken()  // → string | null
+ * enhanced.getParam('id') // → '42'
+ */
+export function applyRequestEnhancements(
+  req: Request | EnhancedRequest,
+  params: Record<string, string> = {},
+): EnhancedRequest {
+  if (typeof (req as any).bearerToken === 'function')
+    return req as EnhancedRequest
+  return getEnhancementHost().enhanceRequest(req as Request, params)
+}

package/src/types.ts

@@ -793,6 +793,12 @@ export interface EnhancedRequest extends Request, Omit<RequestMacroMethods, 'ip'
    * Route parameters extracted from the URL
    */
   params: Record<string, string>
+  /**
+   * Lookup a single route param. Equivalent to `request.params[name]` but
+   * with optional default-value handling, matching the Laravel-style
+   * `$request->route('name')` ergonomics.
+   */
+  getParam: <T = string>(name: string, defaultValue?: T) => T | undefined
   /**
    * Query parameters from the URL
    */