@morojs/moro 1.8.12 → 1.8.14

package/dist/core/routing/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/routing/index.ts"],"names":[],"mappings":"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","sourcesContent":["// Intelligent Routing System for Moro Framework\n// Schema-first with automatic middleware ordering and chainable API\n//\n// NOTE: This file exports types and thin facades to UnifiedRouter\n// All routing logic has been consolidated in unified-router.ts\n\nimport { ValidationSchema } from '../validation/schema-interface.js';\nimport { HttpRequest, HttpResponse } from '../http/index.js';\nimport {\n  UnifiedRouter,\n  compileStaticRoute,\n  type RouteSchema as UnifiedRouteSchema,\n  type StaticBody,\n  type StaticResponse,\n} from './unified-router.js';\n\nexport type { StaticBody, StaticResponse };\n\n// ===== TYPE EXPORTS (Keep all - used by app code) =====\n\nexport type HttpMethod = 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH' | 'HEAD' | 'OPTIONS';\nexport type RouteHandler<T = any> = (req: HttpRequest, res: HttpResponse) => T | Promise<T>;\nexport type Middleware = (\n  req: HttpRequest,\n  res: HttpResponse,\n  next: () => void\n) => void | Promise<void>;\n\nexport interface ValidationConfig {\n  body?: ValidationSchema;\n  query?: ValidationSchema;\n  params?: ValidationSchema;\n  headers?: ValidationSchema;\n}\n\nexport interface AuthConfig {\n  roles?: string[];\n  permissions?: string[];\n  optional?: boolean;\n}\n\nexport interface RateLimitConfig {\n  requests: number;\n  window: number;\n  skipSuccessfulRequests?: boolean;\n  skipFailedRequests?: boolean;\n}\n\nexport interface CacheConfig {\n  ttl: number;\n  key?: string;\n  tags?: string[];\n}\n\nexport interface MiddlewarePhases {\n  before?: Middleware[];\n  after?: Middleware[];\n  transform?: Middleware[];\n}\n\nexport interface RouteSchema {\n  method: HttpMethod;\n  path: string;\n  /** A function, or the response body itself (see StaticBody / .handler()) */\n  handler: RouteHandler | StaticBody;\n  validation?: ValidationConfig;\n  auth?: AuthConfig;\n  rateLimit?: RateLimitConfig;\n  cache?: CacheConfig;\n  middleware?: MiddlewarePhases;\n  description?: string;\n  tags?: string[];\n  /** Fixed reply of a literal handler; see StaticResponse */\n  static?: StaticResponse;\n}\n\nexport const EXECUTION_PHASES = [\n  'security',\n  'parsing',\n  'rateLimit',\n  'before',\n  'auth',\n  'validation',\n  'transform',\n  'cache',\n  'after',\n  'handler',\n] as const;\n\nexport type ExecutionPhase = (typeof EXECUTION_PHASES)[number];\n\nexport interface ValidatedRequest<T = any> extends HttpRequest {\n  validatedBody?: T;\n  validatedQuery?: any;\n  validatedParams?: any;\n  validatedHeaders?: any;\n  user?: any;\n}\n\n// ===== ROUTE BUILDER INTERFACE (Public API) =====\n\nexport interface RouteBuilder {\n  validate(config: ValidationConfig): RouteBuilder;\n  body<T>(schema: ValidationSchema<T>): RouteBuilder;\n  query<T>(schema: ValidationSchema<T>): RouteBuilder;\n  params<T>(schema: ValidationSchema<T>): RouteBuilder;\n  headers<T>(schema: ValidationSchema<T>): RouteBuilder;\n  auth(config: AuthConfig): RouteBuilder;\n  rateLimit(config: RateLimitConfig): RouteBuilder;\n  cache(config: CacheConfig): RouteBuilder;\n  before(...middleware: Middleware[]): RouteBuilder;\n  after(...middleware: Middleware[]): RouteBuilder;\n  transform(...middleware: Middleware[]): RouteBuilder;\n  use(...middleware: Middleware[]): RouteBuilder;\n  describe(description: string): RouteBuilder;\n  tag(...tags: string[]): RouteBuilder;\n  /** Terminal. A function handles the request; a string or Buffer IS the\n   *  response body (as res.send would send it), and on a route with nothing\n   *  else configured Moro's native engine answers it without calling JS. */\n  handler<T>(handler: RouteHandler<T> | StaticBody): void;\n}\n\n// ===== COMPILED ROUTE INTERFACE (Public API) =====\n\nexport interface CompiledRoute {\n  schema: RouteSchema;\n  execute(req: HttpRequest, res: HttpResponse): Promise<void>;\n}\n\n// ===== FACADE IMPLEMENTATIONS (Delegate to UnifiedRouter) =====\n\n/**\n * Thin facade to UnifiedRouter.RouteBuilder\n * Maintains backward compatibility while using optimized implementation\n */\nexport class IntelligentRouteBuilder implements RouteBuilder {\n  private schema: Partial<RouteSchema>;\n  private router = UnifiedRouter.getInstance();\n\n  constructor(method: HttpMethod, path: string) {\n    this.schema = {\n      method,\n      path,\n      middleware: {} as MiddlewarePhases,\n    };\n  }\n\n  validate(config: ValidationConfig): RouteBuilder {\n    // Avoid spread operator - manually merge properties\n    if (!this.schema.validation) {\n      this.schema.validation = config;\n    } else {\n      if (config.body !== undefined) this.schema.validation.body = config.body;\n      if (config.query !== undefined) this.schema.validation.query = config.query;\n      if (config.params !== undefined) this.schema.validation.params = config.params;\n      if (config.headers !== undefined) this.schema.validation.headers = config.headers;\n    }\n    return this;\n  }\n\n  body<T>(schema: ValidationSchema<T>): RouteBuilder {\n    if (!this.schema.validation) this.schema.validation = {};\n    this.schema.validation.body = schema;\n    return this;\n  }\n\n  query<T>(schema: ValidationSchema<T>): RouteBuilder {\n    if (!this.schema.validation) this.schema.validation = {};\n    this.schema.validation.query = schema;\n    return this;\n  }\n\n  params<T>(schema: ValidationSchema<T>): RouteBuilder {\n    if (!this.schema.validation) this.schema.validation = {};\n    this.schema.validation.params = schema;\n    return this;\n  }\n\n  headers<T>(schema: ValidationSchema<T>): RouteBuilder {\n    if (!this.schema.validation) this.schema.validation = {};\n    this.schema.validation.headers = schema;\n    return this;\n  }\n\n  auth(config: AuthConfig): RouteBuilder {\n    this.schema.auth = config;\n    return this;\n  }\n\n  rateLimit(config: RateLimitConfig): RouteBuilder {\n    this.schema.rateLimit = config;\n    return this;\n  }\n\n  cache(config: CacheConfig): RouteBuilder {\n    this.schema.cache = config;\n    return this;\n  }\n\n  before(...middleware: Middleware[]): RouteBuilder {\n    if (!this.schema.middleware) this.schema.middleware = {};\n    const phases = this.schema.middleware as MiddlewarePhases;\n    // Avoid spread, use push for better performance\n    if (!phases.before) phases.before = [];\n    for (let i = 0; i < middleware.length; i++) {\n      phases.before.push(middleware[i] as Middleware);\n    }\n    return this;\n  }\n\n  after(...middleware: Middleware[]): RouteBuilder {\n    if (!this.schema.middleware) this.schema.middleware = {};\n    const phases = this.schema.middleware as MiddlewarePhases;\n    // Avoid spread, use push for better performance\n    if (!phases.after) phases.after = [];\n    for (let i = 0; i < middleware.length; i++) {\n      phases.after.push(middleware[i] as Middleware);\n    }\n    return this;\n  }\n\n  transform(...middleware: Middleware[]): RouteBuilder {\n    if (!this.schema.middleware) this.schema.middleware = {};\n    const phases = this.schema.middleware as MiddlewarePhases;\n    // Avoid spread, use push for better performance\n    if (!phases.transform) phases.transform = [];\n    for (let i = 0; i < middleware.length; i++) {\n      phases.transform.push(middleware[i] as Middleware);\n    }\n    return this;\n  }\n\n  use(...middleware: Middleware[]): RouteBuilder {\n    return this.after(...middleware);\n  }\n\n  describe(description: string): RouteBuilder {\n    this.schema.description = description;\n    return this;\n  }\n\n  tag(...tags: string[]): RouteBuilder {\n    // Avoid spread, use push for better performance\n    if (!this.schema.tags) this.schema.tags = [];\n    for (let i = 0; i < tags.length; i++) {\n      this.schema.tags.push(tags[i] as string);\n    }\n    return this;\n  }\n\n  handler<T>(handler: RouteHandler<T> | StaticBody): void {\n    if (typeof handler === 'function') {\n      // Avoid spread operator - add handler directly\n      this.schema.handler = handler;\n\n      // Delegate to UnifiedRouter\n      this.router.registerRoute(this.schema as RouteSchema);\n      return;\n    }\n    if (typeof handler === 'string' || Buffer.isBuffer(handler)) {\n      this.router.registerRoute(\n        compileStaticRoute(this.schema as Partial<UnifiedRouteSchema>, handler)\n      );\n      return;\n    }\n    throw new Error('Handler is required: a function, or the response body as a string or Buffer');\n  }\n}\n\n/**\n * Thin facade implementing CompiledRoute interface\n * Just stores schema for documentation purposes\n */\nexport class ExecutableRoute implements CompiledRoute {\n  constructor(public readonly schema: RouteSchema) {\n    // Register with UnifiedRouter\n    UnifiedRouter.getInstance().registerRoute(schema);\n  }\n\n  async execute(_req: HttpRequest, _res: HttpResponse): Promise<void> {\n    // This is never called - UnifiedRouter handles execution\n    // But we implement it for interface compatibility\n    throw new Error(\n      'ExecutableRoute.execute() should not be called directly - routing handled by UnifiedRouter'\n    );\n  }\n}\n\n// ===== FACTORY FUNCTIONS (Backward Compatibility) =====\n\nexport function createRoute(method: HttpMethod, path: string): RouteBuilder {\n  return new IntelligentRouteBuilder(method, path);\n}\n\nexport function defineRoute(schema: RouteSchema): CompiledRoute {\n  return new ExecutableRoute(schema);\n}\n\n// ===== RE-EXPORTS FROM UNIFIED ROUTER =====\n\nexport { UnifiedRouter } from './unified-router.js';\nexport { RouteBuilder as UnifiedRouteBuilder } from './unified-router.js';\nexport { PathMatcher, type CompiledPath, type MatchResult } from './path-matcher.js';\nexport { ObjectPoolManager, getPoolManager } from '../pooling/object-pool-manager.js';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/routing/index.ts"],"names":[],"mappings":"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","sourcesContent":["// Intelligent Routing System for Moro Framework\n// Schema-first with automatic middleware ordering and chainable API\n//\n// NOTE: This file exports types and thin facades to UnifiedRouter\n// All routing logic has been consolidated in unified-router.ts\n\nimport { ValidationSchema } from '../validation/schema-interface.js';\nimport { HttpRequest, HttpResponse } from '../http/index.js';\nimport {\n  UnifiedRouter,\n  compileStaticRoute,\n  compileParamRoute,\n  isParamEcho,\n  param,\n  type RouteSchema as UnifiedRouteSchema,\n  type StaticBody,\n  type StaticResponse,\n  type ParamEcho,\n  type ParamRouteReply,\n} from './unified-router.js';\n\nexport type { StaticBody, StaticResponse, ParamEcho, ParamRouteReply };\nexport { param };\n\n// ===== TYPE EXPORTS (Keep all - used by app code) =====\n\nexport type HttpMethod = 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH' | 'HEAD' | 'OPTIONS';\nexport type RouteHandler<T = any> = (req: HttpRequest, res: HttpResponse) => T | Promise<T>;\nexport type Middleware = (\n  req: HttpRequest,\n  res: HttpResponse,\n  next: () => void\n) => void | Promise<void>;\n\nexport interface ValidationConfig {\n  body?: ValidationSchema;\n  query?: ValidationSchema;\n  params?: ValidationSchema;\n  headers?: ValidationSchema;\n}\n\nexport interface AuthConfig {\n  roles?: string[];\n  permissions?: string[];\n  optional?: boolean;\n}\n\nexport interface RateLimitConfig {\n  requests: number;\n  window: number;\n  skipSuccessfulRequests?: boolean;\n  skipFailedRequests?: boolean;\n}\n\nexport interface CacheConfig {\n  ttl: number;\n  key?: string;\n  tags?: string[];\n}\n\nexport interface MiddlewarePhases {\n  before?: Middleware[];\n  after?: Middleware[];\n  transform?: Middleware[];\n}\n\nexport interface RouteSchema {\n  method: HttpMethod;\n  path: string;\n  /** A function, the response body itself (StaticBody), or param(name) */\n  handler: RouteHandler | StaticBody | ParamEcho;\n  validation?: ValidationConfig;\n  auth?: AuthConfig;\n  rateLimit?: RateLimitConfig;\n  cache?: CacheConfig;\n  middleware?: MiddlewarePhases;\n  description?: string;\n  tags?: string[];\n  /** Fixed reply of a literal handler; see StaticResponse */\n  static?: StaticResponse;\n  /** Engine shape of a param(name) handler; see ParamRouteReply */\n  paramEcho?: ParamRouteReply;\n}\n\nexport const EXECUTION_PHASES = [\n  'security',\n  'parsing',\n  'rateLimit',\n  'before',\n  'auth',\n  'validation',\n  'transform',\n  'cache',\n  'after',\n  'handler',\n] as const;\n\nexport type ExecutionPhase = (typeof EXECUTION_PHASES)[number];\n\nexport interface ValidatedRequest<T = any> extends HttpRequest {\n  validatedBody?: T;\n  validatedQuery?: any;\n  validatedParams?: any;\n  validatedHeaders?: any;\n  user?: any;\n}\n\n// ===== ROUTE BUILDER INTERFACE (Public API) =====\n\nexport interface RouteBuilder {\n  validate(config: ValidationConfig): RouteBuilder;\n  body<T>(schema: ValidationSchema<T>): RouteBuilder;\n  query<T>(schema: ValidationSchema<T>): RouteBuilder;\n  params<T>(schema: ValidationSchema<T>): RouteBuilder;\n  headers<T>(schema: ValidationSchema<T>): RouteBuilder;\n  auth(config: AuthConfig): RouteBuilder;\n  rateLimit(config: RateLimitConfig): RouteBuilder;\n  cache(config: CacheConfig): RouteBuilder;\n  before(...middleware: Middleware[]): RouteBuilder;\n  after(...middleware: Middleware[]): RouteBuilder;\n  transform(...middleware: Middleware[]): RouteBuilder;\n  use(...middleware: Middleware[]): RouteBuilder;\n  describe(description: string): RouteBuilder;\n  tag(...tags: string[]): RouteBuilder;\n  /** Terminal. A function handles the request; a string or Buffer IS the\n   *  response body (as res.send would send it); param(name) echoes that path\n   *  parameter as the body. On a route with nothing else configured Moro's\n   *  native engine answers the last two without calling JS. */\n  handler<T>(handler: RouteHandler<T> | StaticBody | ParamEcho): void;\n}\n\n// ===== COMPILED ROUTE INTERFACE (Public API) =====\n\nexport interface CompiledRoute {\n  schema: RouteSchema;\n  execute(req: HttpRequest, res: HttpResponse): Promise<void>;\n}\n\n// ===== FACADE IMPLEMENTATIONS (Delegate to UnifiedRouter) =====\n\n/**\n * Thin facade to UnifiedRouter.RouteBuilder\n * Maintains backward compatibility while using optimized implementation\n */\nexport class IntelligentRouteBuilder implements RouteBuilder {\n  private schema: Partial<RouteSchema>;\n  private router = UnifiedRouter.getInstance();\n\n  constructor(method: HttpMethod, path: string) {\n    this.schema = {\n      method,\n      path,\n      middleware: {} as MiddlewarePhases,\n    };\n  }\n\n  validate(config: ValidationConfig): RouteBuilder {\n    // Avoid spread operator - manually merge properties\n    if (!this.schema.validation) {\n      this.schema.validation = config;\n    } else {\n      if (config.body !== undefined) this.schema.validation.body = config.body;\n      if (config.query !== undefined) this.schema.validation.query = config.query;\n      if (config.params !== undefined) this.schema.validation.params = config.params;\n      if (config.headers !== undefined) this.schema.validation.headers = config.headers;\n    }\n    return this;\n  }\n\n  body<T>(schema: ValidationSchema<T>): RouteBuilder {\n    if (!this.schema.validation) this.schema.validation = {};\n    this.schema.validation.body = schema;\n    return this;\n  }\n\n  query<T>(schema: ValidationSchema<T>): RouteBuilder {\n    if (!this.schema.validation) this.schema.validation = {};\n    this.schema.validation.query = schema;\n    return this;\n  }\n\n  params<T>(schema: ValidationSchema<T>): RouteBuilder {\n    if (!this.schema.validation) this.schema.validation = {};\n    this.schema.validation.params = schema;\n    return this;\n  }\n\n  headers<T>(schema: ValidationSchema<T>): RouteBuilder {\n    if (!this.schema.validation) this.schema.validation = {};\n    this.schema.validation.headers = schema;\n    return this;\n  }\n\n  auth(config: AuthConfig): RouteBuilder {\n    this.schema.auth = config;\n    return this;\n  }\n\n  rateLimit(config: RateLimitConfig): RouteBuilder {\n    this.schema.rateLimit = config;\n    return this;\n  }\n\n  cache(config: CacheConfig): RouteBuilder {\n    this.schema.cache = config;\n    return this;\n  }\n\n  before(...middleware: Middleware[]): RouteBuilder {\n    if (!this.schema.middleware) this.schema.middleware = {};\n    const phases = this.schema.middleware as MiddlewarePhases;\n    // Avoid spread, use push for better performance\n    if (!phases.before) phases.before = [];\n    for (let i = 0; i < middleware.length; i++) {\n      phases.before.push(middleware[i] as Middleware);\n    }\n    return this;\n  }\n\n  after(...middleware: Middleware[]): RouteBuilder {\n    if (!this.schema.middleware) this.schema.middleware = {};\n    const phases = this.schema.middleware as MiddlewarePhases;\n    // Avoid spread, use push for better performance\n    if (!phases.after) phases.after = [];\n    for (let i = 0; i < middleware.length; i++) {\n      phases.after.push(middleware[i] as Middleware);\n    }\n    return this;\n  }\n\n  transform(...middleware: Middleware[]): RouteBuilder {\n    if (!this.schema.middleware) this.schema.middleware = {};\n    const phases = this.schema.middleware as MiddlewarePhases;\n    // Avoid spread, use push for better performance\n    if (!phases.transform) phases.transform = [];\n    for (let i = 0; i < middleware.length; i++) {\n      phases.transform.push(middleware[i] as Middleware);\n    }\n    return this;\n  }\n\n  use(...middleware: Middleware[]): RouteBuilder {\n    return this.after(...middleware);\n  }\n\n  describe(description: string): RouteBuilder {\n    this.schema.description = description;\n    return this;\n  }\n\n  tag(...tags: string[]): RouteBuilder {\n    // Avoid spread, use push for better performance\n    if (!this.schema.tags) this.schema.tags = [];\n    for (let i = 0; i < tags.length; i++) {\n      this.schema.tags.push(tags[i] as string);\n    }\n    return this;\n  }\n\n  handler<T>(handler: RouteHandler<T> | StaticBody | ParamEcho): void {\n    if (typeof handler === 'function') {\n      // Avoid spread operator - add handler directly\n      this.schema.handler = handler;\n\n      // Delegate to UnifiedRouter\n      this.router.registerRoute(this.schema as RouteSchema);\n      return;\n    }\n    if (typeof handler === 'string' || Buffer.isBuffer(handler)) {\n      this.router.registerRoute(\n        compileStaticRoute(this.schema as Partial<UnifiedRouteSchema>, handler)\n      );\n      return;\n    }\n    if (isParamEcho(handler)) {\n      this.router.registerRoute(\n        compileParamRoute(this.schema as Partial<UnifiedRouteSchema>, handler)\n      );\n      return;\n    }\n    throw new Error(\n      'Handler is required: a function, the response body as a string or Buffer, or param(name)'\n    );\n  }\n}\n\n/**\n * Thin facade implementing CompiledRoute interface\n * Just stores schema for documentation purposes\n */\nexport class ExecutableRoute implements CompiledRoute {\n  constructor(public readonly schema: RouteSchema) {\n    // Register with UnifiedRouter\n    UnifiedRouter.getInstance().registerRoute(schema);\n  }\n\n  async execute(_req: HttpRequest, _res: HttpResponse): Promise<void> {\n    // This is never called - UnifiedRouter handles execution\n    // But we implement it for interface compatibility\n    throw new Error(\n      'ExecutableRoute.execute() should not be called directly - routing handled by UnifiedRouter'\n    );\n  }\n}\n\n// ===== FACTORY FUNCTIONS (Backward Compatibility) =====\n\nexport function createRoute(method: HttpMethod, path: string): RouteBuilder {\n  return new IntelligentRouteBuilder(method, path);\n}\n\nexport function defineRoute(schema: RouteSchema): CompiledRoute {\n  return new ExecutableRoute(schema);\n}\n\n// ===== RE-EXPORTS FROM UNIFIED ROUTER =====\n\nexport { UnifiedRouter } from './unified-router.js';\nexport { RouteBuilder as UnifiedRouteBuilder } from './unified-router.js';\nexport { PathMatcher, type CompiledPath, type MatchResult } from './path-matcher.js';\nexport { ObjectPoolManager, getPoolManager } from '../pooling/object-pool-manager.js';\n"]}

package/dist/core/routing/unified-router.d.ts

@@ -21,7 +21,7 @@ export interface RouteSchema {
     method: HttpMethod;
     path: string;
     /** A function, or the response body itself (see StaticBody) */
-    handler: RouteHandler | StaticBody;
+    handler: RouteHandler | StaticBody | ParamEcho;
     validation?: ValidationConfig;
     auth?: AuthConfig;
     rateLimit?: RateLimitConfig;
@@ -34,6 +34,18 @@ export interface RouteSchema {
      *  calling into JS; every other server runs `handler`, which sends the
      *  same bytes. */
     static?: StaticResponse;
+    /** The engine shape of a param(name) handler on a bare route with exactly
+     *  that one parameter: the path segment between prefix and suffix is the
+     *  body. MoroEngineServer on @morojs/engine >= 1.1.9 (paramRoutes) answers
+     *  it without calling into JS; every other server runs `handler`. */
+    paramEcho?: ParamRouteReply;
+}
+export interface ParamRouteReply {
+    name: string;
+    prefix: string;
+    suffix: string;
+    status: number;
+    headers: string[] | null;
 }
 /** The reply a literal handler sends, in the engine's shape. */
 export interface StaticResponse {
@@ -44,14 +56,40 @@ export interface StaticResponse {
 }
 /** What .handler() accepts in place of a function: the response body itself. */
 export type StaticBody = string | Buffer;
+export declare const PARAM_ECHO: unique symbol;
+/** The marker param(name) produces: "answer with this path parameter as the
+ *  body". `.handler(param('id'))` on `/user/:id` answers `GET /user/42` with
+ *  `42`, as `res.end(req.params.id)` would - and on Moro's native engine, on
+ *  a route with nothing else configured, without entering JS at all. */
+export interface ParamEcho {
+    readonly [PARAM_ECHO]: true;
+    readonly name: string;
+}
+export declare function param(name: string): ParamEcho;
+export declare function isParamEcho(value: unknown): value is ParamEcho;
+/**
+ * param(name) in place of a handler: the route answers with that path
+ * parameter as the body, as res.end(req.params[name]) would. When `:name` is
+ * a whole segment of the path, the only parameter in it, and nothing else is
+ * configured, the schema also carries `paramEcho` - prefix and suffix around
+ * the segment - so a server that can answer it natively does so without
+ * calling into JS. The engine echoes the segment as it is on the wire,
+ * undecoded (as uWS does); a parameter that needs decoding stays a function
+ * handler.
+ */
+export declare function compileParamRoute(schema: Partial<RouteSchema>, echo: ParamEcho): RouteSchema;
 /**
  * A literal body in place of a handler: the route answers with exactly that
- * body, as res.send(body) would (status 200, the implied content-type). When
- * nothing else is configured on the route - no auth, validation, rate limit,
- * cache or middleware, and a literal path - the schema also carries `static`,
- * so a server that can answer it natively does so without calling into JS.
- * Anything configured keeps the route on the normal pipeline, where the
- * handler sends the same bytes after that configuration has run.
+ * body. A non-empty body goes out as res.send(body) would (status 200, the
+ * implied content-type). An empty body has nothing a content-type could
+ * describe, so it goes out as res.end() would: status and Content-Length: 0,
+ * no header block - 38 bytes less per response, and byte-identical to the
+ * engine's own static reply with no headers. When nothing else is configured
+ * on the route - no auth, validation, rate limit, cache or middleware, and a
+ * literal path - the schema also carries `static`, so a server that can
+ * answer it natively does so without calling into JS. Anything configured
+ * keeps the route on the normal pipeline, where the handler sends the same
+ * bytes after that configuration has run.
  */
 export declare function compileStaticRoute(schema: Partial<RouteSchema>, body: StaticBody): RouteSchema;
 export declare class RouteBuilder {
@@ -72,7 +110,7 @@ export declare class RouteBuilder {
     use(...middleware: Middleware[]): this;
     describe(description: string): this;
     tag(...tags: string[]): this;
-    handler<T>(handler: RouteHandler<T> | StaticBody): void;
+    handler<T>(handler: RouteHandler<T> | StaticBody | ParamEcho): void;
 }
 export declare class UnifiedRouter {
     private static instance;

package/dist/core/routing/unified-router.js

@@ -13,6 +13,74 @@ const logger = createFrameworkLogger('UnifiedRouter');
 const rateLimitCore = new RateLimitCore();
 const cacheCore = new CacheCore();
 const validationCore = new ValidationCore();
+export const PARAM_ECHO = Symbol.for('moro.paramEcho');
+export function param(name) {
+    if (typeof name !== 'string' || name.length === 0) {
+        throw new Error('param(name) needs the parameter name, e.g. param("id") for "/user/:id"');
+    }
+    return Object.freeze({ [PARAM_ECHO]: true, name });
+}
+export function isParamEcho(value) {
+    return (typeof value === 'object' &&
+        value !== null &&
+        value[PARAM_ECHO] === true);
+}
+// Nothing configured that a reply answered inside the engine would skip:
+// no auth, validation, rate limit, cache or middleware. (Static replies also
+// need a literal path; parameter echoes need exactly one parameter.)
+function isBareRoute(schema) {
+    const mw = schema.middleware;
+    const hasMiddleware = Array.isArray(mw)
+        ? mw.length > 0
+        : mw !== undefined &&
+            Object.keys(mw).some(phase => {
+                const list = mw[phase];
+                return Array.isArray(list) && list.length > 0;
+            });
+    return !schema.auth && !schema.validation && !schema.rateLimit && !schema.cache && !hasMiddleware;
+}
+/**
+ * param(name) in place of a handler: the route answers with that path
+ * parameter as the body, as res.end(req.params[name]) would. When `:name` is
+ * a whole segment of the path, the only parameter in it, and nothing else is
+ * configured, the schema also carries `paramEcho` - prefix and suffix around
+ * the segment - so a server that can answer it natively does so without
+ * calling into JS. The engine echoes the segment as it is on the wire,
+ * undecoded (as uWS does); a parameter that needs decoding stays a function
+ * handler.
+ */
+export function compileParamRoute(schema, echo) {
+    const name = echo.name;
+    schema.handler = (req, res) => {
+        const value = req.params?.[name];
+        res.end(value === undefined ? undefined : String(value));
+    };
+    const path = schema.path ?? '';
+    const segments = path.split('/');
+    const marker = `:${name}`;
+    const at = segments.indexOf(marker);
+    if (at === -1) {
+        // The router names a parameter after its whole segment, so ":name.json"
+        // is a parameter called "name.json" and param('name') would never see it.
+        // (":names" is a different parameter, not a misuse; it gets no echo.)
+        const partial = segments.some(seg => seg.startsWith(marker) && /^[^A-Za-z0-9_$]/.test(seg.slice(marker.length)));
+        if (partial) {
+            throw new Error(`param('${name}') needs '${marker}' as a whole segment of the route path; ` +
+                `'${path}' has it inside a segment`);
+        }
+        return schema;
+    }
+    const rest = segments.slice(at + 1);
+    const plainShape = !segments.some((seg, i) => i !== at && seg.startsWith(':')) &&
+        !path.includes('*') &&
+        !rest.includes(''); // no trailing or doubled slash after the parameter
+    if (plainShape && isBareRoute(schema)) {
+        const prefix = segments.slice(0, at).join('/') + '/';
+        const suffix = rest.length > 0 ? '/' + rest.join('/') : '';
+        schema.paramEcho = { name, prefix, suffix, status: 200, headers: null };
+    }
+    return schema;
+}
 // The content-type res.send() implies for a body it was given no header for:
 // the same three cases MoroEngineServer's send() picks a template by, spelled
 // out here so an engine-answered reply carries the bytes send() would have.
@@ -26,35 +94,34 @@ function impliedContentType(body) {
 }
 /**
  * A literal body in place of a handler: the route answers with exactly that
- * body, as res.send(body) would (status 200, the implied content-type). When
- * nothing else is configured on the route - no auth, validation, rate limit,
- * cache or middleware, and a literal path - the schema also carries `static`,
- * so a server that can answer it natively does so without calling into JS.
- * Anything configured keeps the route on the normal pipeline, where the
- * handler sends the same bytes after that configuration has run.
+ * body. A non-empty body goes out as res.send(body) would (status 200, the
+ * implied content-type). An empty body has nothing a content-type could
+ * describe, so it goes out as res.end() would: status and Content-Length: 0,
+ * no header block - 38 bytes less per response, and byte-identical to the
+ * engine's own static reply with no headers. When nothing else is configured
+ * on the route - no auth, validation, rate limit, cache or middleware, and a
+ * literal path - the schema also carries `static`, so a server that can
+ * answer it natively does so without calling into JS. Anything configured
+ * keeps the route on the normal pipeline, where the handler sends the same
+ * bytes after that configuration has run.
  */
 export function compileStaticRoute(schema, body) {
-    schema.handler = (_req, res) => {
-        res.send(body);
-    };
+    const empty = body.length === 0;
+    schema.handler = empty
+        ? (_req, res) => {
+            res.end();
+        }
+        : (_req, res) => {
+            res.send(body);
+        };
     const path = schema.path ?? '';
-    const mw = schema.middleware;
-    const hasMiddleware = Array.isArray(mw)
-        ? mw.length > 0
-        : mw !== undefined &&
-            Object.keys(mw).some(phase => {
-                const list = mw[phase];
-                return Array.isArray(list) && list.length > 0;
-            });
-    const bare = !path.includes(':') &&
-        !path.includes('*') &&
-        !schema.auth &&
-        !schema.validation &&
-        !schema.rateLimit &&
-        !schema.cache &&
-        !hasMiddleware;
+    const bare = !path.includes(':') && !path.includes('*') && isBareRoute(schema);
     if (bare) {
-        schema.static = { status: 200, headers: ['content-type', impliedContentType(body)], body };
+        schema.static = {
+            status: 200,
+            headers: empty ? null : ['content-type', impliedContentType(body)],
+            body,
+        };
     }
     return schema;
 }
@@ -188,8 +255,8 @@ export class RouteBuilder {
         }
         return this;
     }
-    // Terminal method: a function, or the response body itself (see
-    // compileStaticRoute for what a literal body means).
+    // Terminal method: a function, the response body itself (see
+    // compileStaticRoute), or param(name) (see compileParamRoute).
     handler(handler) {
         if (typeof handler === 'function') {
             // Avoid spread operator - add handler directly
@@ -201,7 +268,11 @@ export class RouteBuilder {
             this.router.registerRoute(compileStaticRoute(this.schema, handler));
             return;
         }
-        throw new Error('Handler is required: a function, or the response body as a string or Buffer');
+        if (isParamEcho(handler)) {
+            this.router.registerRoute(compileParamRoute(this.schema, handler));
+            return;
+        }
+        throw new Error('Handler is required: a function, the response body as a string or Buffer, or param(name)');
     }
 }
 // ===== Unified Router =====
@@ -334,12 +405,17 @@ export class UnifiedRouter {
         // - so this is where the body becomes a handler and, on a bare route, a
         // reply the native engine can answer itself.
         if (typeof schema.handler !== 'function') {
-            const body = schema.handler;
-            if (typeof body !== 'string' && !Buffer.isBuffer(body)) {
+            const given = schema.handler;
+            if (isParamEcho(given)) {
+                compileParamRoute(schema, given);
+            }
+            else if (typeof given === 'string' || Buffer.isBuffer(given)) {
+                compileStaticRoute(schema, given);
+            }
+            else {
                 throw new Error(`Handler for ${schema.method} ${schema.path} must be a function, ` +
-                    'or the response body as a string or Buffer');
+                    'the response body as a string or Buffer, or param(name)');
             }
-            compileStaticRoute(schema, body);
         }
         // From here on the handler is a function, whichever form was registered.
         const registered = schema;