stratal 0.0.18 → 0.0.20

package/dist/{index-BrmS34sa.d.mts → index-D0US0X14.d.mts}

@@ -1,7 +1,9 @@
-import { t as Constructor } from "./types-CN0zONAZ.mjs";
-import { t as index_d_exports } from "./index-BDh9J2KD.mjs";
-import { _ as II18nService, a as index_d_exports$1, b as MessageParams, i as ZodError, o as z, t as OpenAPIHono, v as MessageKeyPrefix, y as MessageKeys } from "./index-Dfpd_ypO.mjs";
-import { i as LoggerService, l as LogLevel } from "./index-BR23zDMy.mjs";
+import { t as Constructor } from "./types-cySNS_lp.mjs";
+import { t as Macroable } from "./index-7-hU3GTV.mjs";
+import { t as StratalEnv } from "./env-D1rcZ8_r.mjs";
+import { t as index_d_exports } from "./index-C1KvMncZ.mjs";
+import { C as MessageParams, S as MessageKeys, a as index_d_exports$1, b as II18nService, i as ZodError, o as z, t as OpenAPIHono, x as MessageKeyPrefix } from "./index-Bnpfq6uk.mjs";
+import { i as LoggerService, l as LogLevel } from "./index-DBd_2wv8.mjs";
 import { DependencyContainer, DependencyContainer as DependencyContainer$1, container as container$1, delay, inject as inject$1, injectable as injectable$1, instancePerContainerCachingFactory as instancePerContainerCachingFactory$1, singleton } from "tsyringe";
 import { AsyncLocalStorage } from "node:async_hooks";
 import { SSEMessage, SSEStreamingApi, SSEStreamingApi as SSEStreamingApi$1 } from "hono/streaming";
@@ -314,6 +316,47 @@ interface SerializedRoute {
  * Serialized from `RouteRegistry.named()` on the server, consumed by `useRoute()` on the client.
  */
 type SerializedRoutes = Record<string, SerializedRoute>;
+/**
+ * Snapshot of the route bound to the current request — shared with the client
+ * so URL helpers can answer "which route am I on?", "what are its params?",
+ * and "which sticky defaults should I auto-apply?" without parsing the URL.
+ *
+ * Discriminated by `name`. When `StratalRouteMap` is augmented, narrowing on
+ * `name` strictly types `params` per route:
+ *
+ * ```ts
+ * if (route.name === 'users.show') {
+ *   route.params.id // typed as string
+ * }
+ * ```
+ */
+type CurrentRoute = { [K in RouteName]: {
+  name: K;
+  params: NonNullable<RouteParams<K>>;
+  defaults: Record<string, string>;
+} }[RouteName] | {
+  name: null;
+  params: Record<string, string>;
+  defaults: Record<string, string>;
+};
+/**
+ * All valid arguments to `current(name)` — strict route names plus dotted
+ * wildcard patterns like `'users.*'` derived from real route prefixes.
+ *
+ * When `StratalRouteMap` is augmented and contains `'admin.users.show'`,
+ * valid wildcards are `'admin.*'` and `'admin.users.*'`. When un-augmented,
+ * collapses to `string`. When augmented but no route name has a `.`
+ * separator, the wildcard alternative resolves to `never` and the union
+ * collapses to just `RouteName`.
+ */
+type RouteMatcher = keyof StratalRouteMap extends never ? string : RouteName | `${RoutePrefixes<RouteName>}.*`;
+/**
+ * Recursively split a dotted name into all its prefix segments.
+ *
+ * @example
+ * RoutePrefixes<'admin.users.show'> // 'admin' | 'admin.users'
+ */
+type RoutePrefixes<S extends string> = S extends `${infer Head}.${infer Rest}` ? Head | `${Head}.${RoutePrefixes<Rest>}` : never;
 //#endregion
 //#region src/di/tokens.d.ts
 /**
@@ -499,28 +542,6 @@ declare function getContainer(): Container;
  */
 declare function runWithContainer<T>(container: Container, fn: () => T): T;
 //#endregion
-//#region src/env.d.ts
-/**
- * Cloudflare Worker Environment Bindings
- *
- * This interface defines the base environment bindings required by Stratal.
- * Use TypeScript module augmentation to add your own application-specific bindings.
- *
- * @example
- * ```typescript
- * declare module 'stratal' {
- *   interface StratalEnv {
- *     DATABASE: D1Database
- *     NOTIFICATIONS_QUEUE: Queue
- *   }
- * }
- * ```
- */
-interface StratalEnv {
-  ENVIRONMENT: string;
-  CACHE: KVNamespace;
-}
-//#endregion
 //#region src/router/constants.d.ts
 /**
  * Type-safe context keys for Hono router variables
@@ -545,6 +566,7 @@ declare const ROUTE_METADATA_KEYS: {
   readonly WS_ON_MESSAGE: symbol;
   readonly WS_ON_CLOSE: symbol;
   readonly WS_ON_ERROR: symbol;
+  readonly RATE_LIMIT: symbol;
 };
 /**
  * Security scheme identifiers for OpenAPI
@@ -679,7 +701,7 @@ interface RouteConfig {
    * Status code auto-derived: create()->201, others->200
    * @example userSchema or { schema: userSchema, description: 'User details' }
    */
-  response: RouteResponse;
+  response?: RouteResponse;
   /**
    * OpenAPI tags for grouping endpoints
    * Merged with controller-level tags
@@ -790,6 +812,15 @@ interface ControllerOptions {
    */
   domain?: string;
 }
+/**
+ * Trailing-slash handling for incoming requests.
+ *
+ * - `'ignore'` (default) — match both `/foo` and `/foo/` for the same route, no redirect.
+ * - `'always'`  — non-trailing requests redirect (308) to the trailing-slash form.
+ *                 Paths whose last segment contains `.` (e.g. `/api/openapi.json`) are skipped.
+ * - `'never'`   — trailing requests redirect (308) to the non-trailing form.
+ */
+type TrailingSlashMode = 'ignore' | 'always' | 'never';
 /**
  * Versioning configuration for the application.
  * Enables URI-based API versioning when provided to Stratal config.
@@ -829,100 +860,6 @@ interface LocalePathConfig {
   defaultLocale: string | null;
 }
 //#endregion
-//#region src/router/hono-app.d.ts
-/**
- * HonoApp — extends OpenAPIHono with Stratal-specific setup
- *
- * - Request scope middleware (child container per request)
- * - Global middleware (CORS, logging, error handling)
- * - defaultHook for validation errors
- * - `use()` overload for Stratal middleware classes
- * - `configure()` for OpenAPI, routes, and 404
- */
-declare class HonoApp extends OpenAPIHono<RouterEnv> {
-  private configured;
-  private readonly _container;
-  private readonly _logger;
-  /**
-   * Reference to the original Hono `use` implementation.
-   * Captured in constructor after super() sets it as an instance property.
-   * Used by private methods to register middleware without going through the override.
-   */
-  private nativeUse;
-  constructor(container: Container, logger: LoggerService);
-  /**
-   * Apply global middleware (logger + error handler).
-   * Called by Application after locale middleware is applied by LocalePathService.
-   */
-  private applyGlobalMiddleware;
-  /**
-   * Configure OpenAPI endpoints, controller routes, and 404 handler.
-   * Called once by Application.initialize().
-   */
-  configure(): Promise<void>;
-  private setupRequestScope;
-  private handleException;
-}
-//#endregion
-//#region src/router/services/locale-path.service.d.ts
-/**
- * A resolved path with locale variant metadata.
- */
-interface ResolvedPath {
-  /** The fully resolved path (may include /:locale prefix) */
-  path: string;
-  /** Whether this path is a locale-prefixed variant */
-  isLocaleVariant: boolean;
-}
-/**
- * Resolves locale path variants for route paths.
- *
- * Computes `LocalePathConfig` from `I18nModuleOptions` and provides
- * path expansion for locale-prefixed route variants.
- *
- * Also applies language detection and default locale redirect middleware
- * to HonoApp when resolved from the container.
- *
- * Registered as a singleton in the container.
- */
-declare class LocalePathService {
-  private readonly honoApp;
-  private readonly _config;
-  private readonly _pathDetectionEnabled;
-  private readonly _prefixDefaultLocale;
-  constructor(container: Container, honoApp: HonoApp);
-  /** Whether path-based locale detection is enabled */
-  get enabled(): boolean;
-  /** The computed locale path config, or null if path detection is disabled */
-  get localePathConfig(): LocalePathConfig | null;
-  /** The prefixDefaultLocale setting (false, true, or 'redirect') */
-  get prefixDefaultLocale(): false | true | 'redirect';
-  /**
-   * Expand a path into primary + locale-prefixed variants.
-   *
-   * @param path - The base path to expand
-   * @returns Array of resolved paths with locale metadata
-   */
-  resolve(path: string): ResolvedPath[];
-  /**
-   * Build a Hono regex constraint from prefixed locales.
-   * e.g., `{en|de|fr}` — restricts `:locale` to only match known values.
-   */
-  private buildLocaleConstraint;
-  /**
-   * Apply Hono's languageDetector middleware and bridge the detected language
-   * to Stratal's LOCALE context variable.
-   */
-  private setupLanguageDetection;
-  /**
-   * Redirect requests that include the default locale prefix to the unprefixed path.
-   * For example, `/en/users` → 301 redirect to `/users`.
-   *
-   * Only active when `prefixDefaultLocale` is `'redirect'`.
-   */
-  private setupDefaultLocaleRedirect;
-}
-//#endregion
 //#region src/execution-context.d.ts
 interface StratalExecutionContext {
   waitUntil(promise: Promise<unknown>): void;
@@ -1668,6 +1605,100 @@ interface Middleware {
   handle(ctx: RouterContext, next: Next$1): Promise<Response | void>;
 }
 //#endregion
+//#region src/router/hono-app.d.ts
+/**
+ * HonoApp — extends OpenAPIHono with Stratal-specific setup
+ *
+ * - Request scope middleware (child container per request)
+ * - Global middleware (CORS, logging, error handling)
+ * - defaultHook for validation errors
+ * - `use()` overload for Stratal middleware classes
+ * - `configure()` for OpenAPI, routes, and 404
+ */
+declare class HonoApp extends OpenAPIHono<RouterEnv> {
+  private configured;
+  private readonly _container;
+  private readonly _logger;
+  /**
+   * Reference to the original Hono `use` implementation.
+   * Captured in constructor after super() sets it as an instance property.
+   * Used by private methods to register middleware without going through the override.
+   */
+  private nativeUse;
+  constructor(container: Container, logger: LoggerService, application: Application);
+  /**
+   * Apply global middleware (logger + error handler).
+   * Called by Application after locale middleware is applied by LocalePathService.
+   */
+  private applyGlobalMiddleware;
+  /**
+   * Configure OpenAPI endpoints, controller routes, and 404 handler.
+   * Called once by Application.initialize().
+   */
+  configure(): Promise<void>;
+  private setupRequestScope;
+  private handleException;
+}
+//#endregion
+//#region src/router/services/locale-path.service.d.ts
+/**
+ * A resolved path with locale variant metadata.
+ */
+interface ResolvedPath {
+  /** The fully resolved path (may include /:locale prefix) */
+  path: string;
+  /** Whether this path is a locale-prefixed variant */
+  isLocaleVariant: boolean;
+}
+/**
+ * Resolves locale path variants for route paths.
+ *
+ * Computes `LocalePathConfig` from `I18nModuleOptions` and provides
+ * path expansion for locale-prefixed route variants.
+ *
+ * Also applies language detection and default locale redirect middleware
+ * to HonoApp when resolved from the container.
+ *
+ * Registered as a singleton in the container.
+ */
+declare class LocalePathService {
+  private readonly honoApp;
+  private readonly _config;
+  private readonly _pathDetectionEnabled;
+  private readonly _prefixDefaultLocale;
+  constructor(container: Container, honoApp: HonoApp);
+  /** Whether path-based locale detection is enabled */
+  get enabled(): boolean;
+  /** The computed locale path config, or null if path detection is disabled */
+  get localePathConfig(): LocalePathConfig | null;
+  /** The prefixDefaultLocale setting (false, true, or 'redirect') */
+  get prefixDefaultLocale(): false | true | 'redirect';
+  /**
+   * Expand a path into primary + locale-prefixed variants.
+   *
+   * @param path - The base path to expand
+   * @returns Array of resolved paths with locale metadata
+   */
+  resolve(path: string): ResolvedPath[];
+  /**
+   * Build a Hono regex constraint from prefixed locales.
+   * e.g., `{en|de|fr}` — restricts `:locale` to only match known values.
+   */
+  private buildLocaleConstraint;
+  /**
+   * Apply Hono's languageDetector middleware and bridge the detected language
+   * to Stratal's LOCALE context variable.
+   */
+  private setupLanguageDetection;
+  /**
+   * Redirect requests that include the default locale prefix to the unprefixed path.
+   * For example, `/en/users` → 301 redirect to `/users`.
+   *
+   * Only active when `prefixDefaultLocale` is `'redirect'`.
+   */
+  private setupDefaultLocaleRedirect;
+}
+//#endregion
 //#region src/router/router.internals.d.ts
 /**
  * Symbol keys for Router internal accessors.
@@ -1762,6 +1793,20 @@ declare class Router {
   name(prefix: string): this;
   /** Middleware applied to controllers in this scope */
   middleware(...middlewares: Constructor<Middleware>[]): this;
+  /**
+   * Apply a named rate limiter to controllers in this scope.
+   *
+   * The named limiter must be registered via `RateLimiterRegistry.for(name, ...)`
+   * (typically inside a module's `onInitialize` hook), and the user must
+   * import `RateLimiterModule.forRoot({ store: ... })` in their AppModule.
+   *
+   * @example
+   * ```typescript
+   * router.prefix('/uploads').throttle('uploads')
+   * router.group([AdminController], (admin) => admin.throttle('admin'))
+   * ```
+   */
+  throttle(name: string): this;
   /** API version for controllers in this scope */
   version(version: string | string[]): this;
   /** Hide/show routes in this scope from OpenAPI docs */
@@ -1848,7 +1893,8 @@ declare class ModuleRegistry {
    */
   getAllSeeders(): Constructor[];
   /**
-   * Get all Router configurations from modules implementing RouteConfigurable
+   * Get all Router configurations from modules implementing RouteConfigurable.
+   * Runs configureRoutes() lazily on first call (deferred from initialize()).
    */
   getAllRouterConfigs(): {
     router: Router;
@@ -1911,6 +1957,114 @@ declare class ModuleRegistry {
   private collectIfListener;
 }
 //#endregion
+//#region src/router/services/versioning.service.d.ts
+/**
+ * Resolves version prefixes for route paths.
+ *
+ * Handles VERSION_NEUTRAL, multi-version arrays, default version fallback,
+ * and configurable prefix (default: 'v').
+ *
+ * Registered as a singleton in the container.
+ */
+declare class VersioningService {
+  private readonly options;
+  constructor(app: Application);
+  /** Whether versioning is enabled */
+  get enabled(): boolean;
+  /**
+   * Resolve versioned paths for a base path.
+   *
+   * @param basePath - The base path (e.g., '/users')
+   * @param version - Explicit version from controller/router config
+   * @returns Array of versioned path strings (e.g., ['/v1/users', '/v2/users'])
+   */
+  resolve(basePath: string, version?: string | string[] | typeof VERSION_NEUTRAL): string[];
+}
+//#endregion
+//#region src/router/route-registry.d.ts
+/**
+ * A single registered route in the application.
+ * Tracks both named and unnamed routes, HTTP and WebSocket.
+ */
+interface RegisteredRoute {
+  /** Route name for URL generation (undefined = unnamed, still tracked) */
+  name?: string;
+  /** HTTP method or 'ws' for WebSocket gateways */
+  method: HttpMethod | 'ws';
+  /** Primary path in Hono-style :param format */
+  path: string;
+  /** Locale-prefixed path variants (e.g., '/:locale/users/:id') */
+  localePaths?: string[];
+  /** Parameter names extracted from path */
+  paramNames: string[];
+  /** Domain pattern (e.g., '{tenant}.example.com') */
+  domain?: string;
+  /** Parameter names extracted from domain */
+  domainParamNames: string[];
+  /** Controller class name */
+  controller: string;
+  /** Controller method name */
+  action: string;
+  /** Whether the route is hidden from OpenAPI docs */
+  hidden: boolean;
+  /** Middleware class names applied to this route */
+  middleware: string[];
+  /** Whether this is a locale-prefixed variant */
+  isLocaleVariant?: boolean;
+}
+/**
+ * Input for registering a route. The registry auto-extracts param names
+ * and expands versioned/locale paths via injected services.
+ */
+type RouteRegistrationInput = Omit<RegisteredRoute, 'paramNames' | 'domainParamNames' | 'path' | 'localePaths' | 'isLocaleVariant'> & {
+  /** Base path before versioning/locale expansion */basePath: string; /** Version from controller/router config (used by VersioningService). Accepts VERSION_NEUTRAL symbol. */
+  version?: string | string[] | typeof VERSION_NEUTRAL; /** Pre-computed param names (optional, auto-extracted if omitted) */
+  paramNames?: string[]; /** Pre-computed domain param names (optional, auto-extracted if omitted) */
+  domainParamNames?: string[];
+};
+/**
+ * Central registry for all application routes.
+ * Single source of truth — used by `route:list`, `route:types`, and URL generation.
+ *
+ * Routes are automatically expanded via VersioningService and LocalePathService
+ * during registration, and sorted by specificity when retrieved via `all()`.
+ *
+ * Registered as a singleton in the container.
+ */
+declare class RouteRegistry {
+  private readonly versioningService;
+  private readonly localePathService;
+  private readonly routes;
+  private readonly namedRoutes;
+  private _sortedCache;
+  private _routeToNameCache;
+  constructor(versioningService: VersioningService, localePathService: LocalePathService);
+  /**
+   * Register a route. Expands via VersioningService + LocalePathService.
+   * Named routes must have unique names.
+   *
+   * @returns Array of expanded RegisteredRoute entries (primary + locale variants)
+   * @throws DuplicateRouteNameError if a named route with the same name already exists
+   */
+  register(input: RouteRegistrationInput): RegisteredRoute[];
+  /** Get a named route by name */
+  get(name: string): RegisteredRoute | undefined;
+  /** Check if a named route exists */
+  has(name: string): boolean;
+  /**
+   * Resolve a Hono-style route path pattern (e.g. as exposed by `c.req.routePath`)
+   * back to its registered name, scoped to the request's HTTP method. Locale variant
+   * paths resolve to the canonical primary route name. Method matching is
+   * case-insensitive; routes registered with `'all'` resolve under any verb.
+   */
+  findNameByRoute(method: string, path: string): string | undefined;
+  private buildRouteToNameCache;
+  /** Get all routes sorted by specificity (static > param > wildcard, primary before locale) */
+  all(): RegisteredRoute[];
+  /** Get only named routes */
+  named(): RegisteredRoute[];
+}
+//#endregion
 //#region src/router/router-resolver.d.ts
 /**
  * Resolved configuration for a single controller.
@@ -2013,6 +2167,17 @@ declare class RouteRegistrationService {
    * @returns Hono middleware function
    */
   private createGuardMiddleware;
+  /**
+   * Wrap a controller handler with a `scopedMiddleware → guards → handler`
+   * chain that runs *inside* the Hono route handler — after request
+   * validators have populated `c.req.valid(...)`. This is the only place
+   * we can run user middleware after `@hono/zod-openapi`'s validators in
+   * the same pipeline.
+   *
+   * Returns a Hono handler with the same signature as the original so
+   * `app.openapi(route, wrapped)` works transparently.
+   */
+  private wrapHandlerWithChain;
   /**
    * Register wildcard route for non-RESTful controllers
    */
@@ -2038,10 +2203,11 @@ declare class RouteRegistrationService {
   private mergeMetadata;
   /**
    * Build OpenAPI route configuration from metadata
-   * Creates a route definition compatible with @hono/zod-openapi
-   * Includes guard execution for proper access control
+   * Creates a route definition compatible with @hono/zod-openapi.
    *
-   * Execution order: Global middlewares → Guards → Handler
+   * Scoped middleware and guards are NOT attached to `route.middleware`
+   * here — they're composed into a wrapped handler in `collectRoutes` so
+   * they run after Hono's request validators. See `wrapHandlerWithChain`.
    */
   private buildOpenAPIRoute;
   /**
@@ -2847,6 +3013,15 @@ declare class RouteNameNotFoundError extends ApplicationError {
 declare class RouterUseScopeError extends ApplicationError {
   constructor();
 }
+/**
+ * Thrown when a middleware calls next() more than once.
+ * This is a programming error — each middleware must call next() at most once.
+ *
+ * Error Code: 9014
+ */
+declare class MiddlewareNextCalledMultipleTimesError extends ApplicationError {
+  constructor(middlewareName: string);
+}
 //#endregion
 //#region src/application.d.ts
 interface ApplicationConfig {
@@ -2862,6 +3037,16 @@ interface ApplicationConfig {
    * When provided, enables URI-based versioning for controllers.
    */
   versioning?: VersioningOptions;
+  /**
+   * Trailing-slash handling for incoming requests.
+   *
+   * Defaults to `'ignore'` — both `/foo` and `/foo/` resolve to the same route.
+   *
+   * - `'ignore'` — match both, no redirect.
+   * - `'always'` — non-trailing requests redirect (308) to the trailing-slash form.
+   * - `'never'`  — trailing requests redirect (308) to the non-trailing form.
+   */
+  trailingSlash?: TrailingSlashMode;
   /**
    * Custom exception handler class.
    *
@@ -2916,6 +3101,8 @@ declare class Application {
   private cronManager;
   private quarry;
   private initialized;
+  private routingInitPromise;
+  private handlerInitPromise;
   readonly env: StratalEnv;
   private readonly appConfig;
   constructor({
@@ -2928,9 +3115,13 @@ declare class Application {
    */
   get container(): Container;
   /**
-   * Get the HonoApp instance
+   * Lazily initialize routing and return the HonoApp instance.
+   *
+   * Routing (service registration, HonoApp resolution, route configuration)
+   * is deferred so that `scheduled` and `queue` handlers don't pay the CPU
+   * cost of route setup on cold start.
    */
-  get hono(): HonoApp;
+  ensureHono(): Promise<HonoApp>;
   /**
    * Get the application configuration
    */
@@ -2942,6 +3133,16 @@ declare class Application {
    * Called after module initialization so I18N_TOKENS.Options is available.
    */
   private registerRoutingServices;
+  /**
+   * Wire up queue consumers and event listeners.
+   * Called lazily on first fetch/queue — not during scheduled handling.
+   */
+  private initializeHandlers;
+  /**
+   * Register routing services, resolve HonoApp, and configure routes.
+   * Called lazily on first fetch — not during scheduled/queue handling.
+   */
+  private initializeRouting;
   /**
    * Resolve a service from the container
    */
@@ -2985,105 +3186,6 @@ declare class Application {
   private initializeExceptionHandler;
 }
 //#endregion
-//#region src/router/services/versioning.service.d.ts
-/**
- * Resolves version prefixes for route paths.
- *
- * Handles VERSION_NEUTRAL, multi-version arrays, default version fallback,
- * and configurable prefix (default: 'v').
- *
- * Registered as a singleton in the container.
- */
-declare class VersioningService {
-  private readonly options;
-  constructor(app: Application);
-  /** Whether versioning is enabled */
-  get enabled(): boolean;
-  /**
-   * Resolve versioned paths for a base path.
-   *
-   * @param basePath - The base path (e.g., '/users')
-   * @param version - Explicit version from controller/router config
-   * @returns Array of versioned path strings (e.g., ['/v1/users', '/v2/users'])
-   */
-  resolve(basePath: string, version?: string | string[] | typeof VERSION_NEUTRAL): string[];
-}
-//#endregion
-//#region src/router/route-registry.d.ts
-/**
- * A single registered route in the application.
- * Tracks both named and unnamed routes, HTTP and WebSocket.
- */
-interface RegisteredRoute {
-  /** Route name for URL generation (undefined = unnamed, still tracked) */
-  name?: string;
-  /** HTTP method or 'ws' for WebSocket gateways */
-  method: HttpMethod | 'ws';
-  /** Primary path in Hono-style :param format */
-  path: string;
-  /** Locale-prefixed path variants (e.g., '/:locale/users/:id') */
-  localePaths?: string[];
-  /** Parameter names extracted from path */
-  paramNames: string[];
-  /** Domain pattern (e.g., '{tenant}.example.com') */
-  domain?: string;
-  /** Parameter names extracted from domain */
-  domainParamNames: string[];
-  /** Controller class name */
-  controller: string;
-  /** Controller method name */
-  action: string;
-  /** Whether the route is hidden from OpenAPI docs */
-  hidden: boolean;
-  /** Middleware class names applied to this route */
-  middleware: string[];
-  /** Whether this is a locale-prefixed variant */
-  isLocaleVariant?: boolean;
-}
-/**
- * Input for registering a route. The registry auto-extracts param names
- * and expands versioned/locale paths via injected services.
- */
-type RouteRegistrationInput = Omit<RegisteredRoute, 'paramNames' | 'domainParamNames' | 'path' | 'localePaths' | 'isLocaleVariant'> & {
-  /** Base path before versioning/locale expansion */basePath: string; /** Version from controller/router config (used by VersioningService). Accepts VERSION_NEUTRAL symbol. */
-  version?: string | string[] | typeof VERSION_NEUTRAL; /** Pre-computed param names (optional, auto-extracted if omitted) */
-  paramNames?: string[]; /** Pre-computed domain param names (optional, auto-extracted if omitted) */
-  domainParamNames?: string[];
-};
-/**
- * Central registry for all application routes.
- * Single source of truth — used by `route:list`, `route:types`, and URL generation.
- *
- * Routes are automatically expanded via VersioningService and LocalePathService
- * during registration, and sorted by specificity when retrieved via `all()`.
- *
- * Registered as a singleton in the container.
- */
-declare class RouteRegistry {
-  private readonly versioningService;
-  private readonly localePathService;
-  private readonly routes;
-  private readonly namedRoutes;
-  private _sortedCache;
-  constructor(versioningService: VersioningService, localePathService: LocalePathService);
-  /**
-   * Register a route. Expands via VersioningService + LocalePathService.
-   * Named routes must have unique names.
-   *
-   * @returns Array of expanded RegisteredRoute entries (primary + locale variants)
-   * @throws DuplicateRouteNameError if a named route with the same name already exists
-   */
-  register(input: RouteRegistrationInput): RegisteredRoute[];
-  /** Get a named route by name */
-  get(name: string): RegisteredRoute | undefined;
-  /** Check if a named route exists */
-  has(name: string): boolean;
-  /** Get all routes sorted by specificity (static > param > wildcard, primary before locale) */
-  all(): RegisteredRoute[];
-  /** Get only named routes */
-  named(): RegisteredRoute[];
-}
-//#endregion
 //#region src/router/uri.d.ts
 /**
  * Options for URL generation methods.
@@ -3132,7 +3234,8 @@ declare class Uri {
   private readonly registry;
   private readonly routerContext;
   private _defaults;
-  constructor(registry: RouteRegistry, routerContext: RouterContext);
+  private readonly trailingSlash;
+  constructor(registry: RouteRegistry, routerContext: RouterContext, application: Application);
   /**
    * Set default URL parameters for this request.
    * Applied to all subsequent `route()` calls — explicit params override defaults.
@@ -3140,6 +3243,14 @@ declare class Uri {
    * @param params - Default parameters (e.g., `{ locale: 'en' }`)
    */
   defaults(params: Record<string, string>): void;
+  /**
+   * Read the currently configured default URL parameters.
+   *
+   * Used by frameworks that need to share these with the client (e.g. the
+   * Inertia adapter ships them as a shared prop so `route()` calls in the
+   * browser auto-fill the same sticky params as the server).
+   */
+  getDefaults(): Record<string, string>;
   /**
    * Generate a URL from a named route.
    *
@@ -3255,13 +3366,18 @@ type ContextQueryResult<R extends Record<string, unknown> | undefined, K extends
  * }
  * ```
  */
-declare class RouterContext<T extends RouterEnv = RouterEnv> {
+declare class RouterContext<T extends RouterEnv = RouterEnv> extends Macroable {
   readonly c: Context<T>;
   /**
    * Native Hono context
    * Access for advanced use cases not covered by helper methods
    */
   constructor(c: Context<T>);
+  /**
+   * Cloudflare-provided request properties (geo, TLS, bot management, etc.).
+   * Always available on Cloudflare Workers requests via `c.req.raw.cf`.
+   */
+  get cf(): CfProperties;
   /**
    * Get request-scoped DI container
    * Contains request-specific services and context (AuthContext)
@@ -3291,10 +3407,20 @@ declare class RouterContext<T extends RouterEnv = RouterEnv> {
    */
   json(data: object | null, status?: ContentfulStatusCode): Response;
   /**
-   * Get route parameter value
+   * Get route parameter value(s).
+   *
+   * Reads the validated, Zod-coerced param record from `c.req.valid('param')`,
+   * which is what `@hono/zod-openapi` populates for every route registered
+   * via `app.openapi(...)`. Bare `c.req.param()` returns `undefined` for those
+   * routes — always go through the validated record.
+   *
+   * - With a key → returns the single string value.
+   * - With no args → returns the full `Record<string, string>` (or `{}` when
+   *   the matched route has no path params).
    *
    * @param key - Parameter name (e.g., 'id' for /users/:id)
    */
+  param(): Record<string, string>;
   param(key: string): string;
   /**
    * Get query parameter value
@@ -3871,7 +3997,13 @@ declare const ERROR_CODES: {
     readonly FAILED_TO_CREATE_SESSION: 3012; /** User update failed */
     readonly FAILED_TO_UPDATE_USER: 3013; /** Social account already linked */
     readonly SOCIAL_ACCOUNT_LINKED: 3014; /** Last account cannot be unlinked */
-    readonly CANNOT_UNLINK_LAST_ACCOUNT: 3015;
+    readonly CANNOT_UNLINK_LAST_ACCOUNT: 3015; /** Organization not found */
+    readonly ORGANIZATION_NOT_FOUND: 3020; /** Organization member not found */
+    readonly MEMBER_NOT_FOUND: 3021; /** Organization invitation not found */
+    readonly INVITATION_NOT_FOUND: 3022; /** Invitation recipient mismatch */
+    readonly INVITATION_RECIPIENT_MISMATCH: 3023; /** Organization limit reached */
+    readonly ORGANIZATION_LIMIT_REACHED: 3024; /** Organization membership constraint violation */
+    readonly ORGANIZATION_MEMBERSHIP_REQUIRED: 3025;
   };
   /**
    * Authorization Errors (3100-3199)
@@ -3890,7 +4022,8 @@ declare const ERROR_CODES: {
     /** Generic resource not found */readonly NOT_FOUND: 4000; /** Route/endpoint not found */
     readonly ROUTE_NOT_FOUND: 4004; /** Resource conflict or duplicate */
     readonly CONFLICT: 4100; /** Resource already exists */
-    readonly ALREADY_EXISTS: 4101;
+    readonly ALREADY_EXISTS: 4101; /** Rate limit exceeded */
+    readonly TOO_MANY_REQUESTS: 4290;
   };
   /**
    * Validation Errors (1000-1999)
@@ -3915,7 +4048,8 @@ declare const ERROR_CODES: {
     readonly DUPLICATE_ROUTE_NAME: 9010; /** Named route not found in RouteRegistry */
     readonly ROUTE_NAME_NOT_FOUND: 9011; /** Required route parameter missing during URL generation */
     readonly MISSING_ROUTE_PARAM: 9012; /** router.use() called inside group() callback */
-    readonly USE_SCOPE_VIOLATION: 9013;
+    readonly USE_SCOPE_VIOLATION: 9013; /** next() called more than once in a middleware */
+    readonly MIDDLEWARE_NEXT_CALLED_MULTIPLE_TIMES: 9014;
   };
   /**
    * I18n Errors (9300-9399)
@@ -4241,7 +4375,13 @@ declare class InternalError extends ApplicationError {
 //#endregion
 //#region src/errors/is-application-error.d.ts
 /**
- * Type guard to check if an error is an ApplicationError
+ * Type guard to check if an error is an ApplicationError.
+ *
+ * Uses `instanceof` first, then falls back to a structural check
+ * for the `code` and `timestamp` properties that all ApplicationError
+ * instances have. This handles cross-module boundary cases where
+ * `instanceof` fails due to duplicate class identities (e.g., Vite's
+ * module graph in workerd).
  *
  * @param error - The error to check
  * @returns True if the error is an ApplicationError instance
@@ -4283,5 +4423,5 @@ declare class StratalNotInitializedError extends ApplicationError {
   constructor();
 }
 //#endregion
-export { SSEMessage as $, HTTP_METHODS as $n, RouteConfigurable as $t, LocaleNotSupportedError as A, LogSeverity as An, instancePerContainerCachingFactory$1 as Ar, getRouteDecoratedMethods as At, ContextQueryResult as B, ConventionRouteMetadata as Bn, WhenOptions as Br, getControllerRoute as Bt, DetectionStrategy as C, OnShutdown as Cn, Container as Cr, errorResponseSchema as Ct, buildDetectorOptions as D, ExceptionHandler as Dn, delay as Dr, uuidParamSchema as Dt, ResolvedI18nOptions as E, ValueProvider as En, container$1 as Er, successMessageSchema as Et, QueueExceptionContext as F, StratalExecutionContext as Fn, ConditionalBindingUse as Fr, Patch as Ft, buildRouteUrl as G, RouteConfig as Gn, generateConventionRouteName as Gt, SignedUriOptions as H, LocalePathConfig as Hn, ErrorResponse as Hr, createMiddlewareChain as Ht, createCliExceptionContext as I, LocalePathService as In, PredicateContainer as Ir, Post as It, RouteRegistry as J, RouteResponseObject as Jn, toOpenAPIPath as Jt, RegisteredRoute as K, RouteMetadata as Kn, getPathSpecificityScore as Kt, createCronExceptionContext as L, ResolvedPath as Ln, ContainerLike as Lr, Put as Lt, CronExceptionContext as M, Reportable as Mn, ConditionalBindingBuilder as Mr, All as Mt, ExceptionContext as N, ReportableCallback as Nn, ConditionalBindingBuilderImpl as Nr, Delete as Nt, resolveI18nOptions as O, ApplicationErrorConstructor as On, inject$1 as Or, validationErrorResponseSchema as Ot, HttpExceptionContext as P, RespondCallback as Pn, ConditionalBindingGive as Pr, Get as Pt, ApplicationOptions as Q, VersioningOptions as Qn, ModuleRegistry as Qt, createHttpExceptionContext as R, HonoApp as Rn, ExtensionDecorator as Rr, Controller as Rt, I18nModule as S, OnInitialize as Sn, StratalRouteMap as Sr, commonErrorSchemas as St, LanguageDetectionOptions as T, RegistryEntry as Tn, DependencyContainer$1 as Tr, paginationQuerySchema as Tt, Uri as U, RouteBody as Un, isErrorResponse as Ur, extractDomainParamNames as Ut, RouterContext as V, ExplicitRouteMetadata as Vn, Environment as Vr, getControllerVersion as Vt, UriOptions as W, RouteBodyObject as Wn, extractParamNames as Wt, Application as X, RouterVariables as Xn, ROUTER_TOKENS as Xt, VersioningService as Y, RouterEnv as Yn, route as Yt, ApplicationConfig as Z, SecurityScheme as Zn, RouteRegistrationService as Zt, Messages as _, InjectionToken$2 as _n, DI_TOKENS as _r, signUrl as _t, InternalError as a, CommandInput as an, containerStorage as ar, MissingEnvironmentVariableError as at, messages as b, ModuleOptions as bn, SerializedRoute as br, createDomainMiddleware as bt, getHttpStatus as c, ParsedArgument as cn, RequestScopeOperationNotAllowedError as cr, RouteNameNotFoundError as ct, ApplicationError as d, Quarry as dn, INJECT_PARAM_METADATA_KEY as dr, RouteNotFoundError as dt, Router as en, ROUTER_CONTEXT_KEYS as er, SSEStreamingApi$1 as et, ERROR_CODES as f, AsyncModuleOptions as fn, InjectParam as fr, OpenAPIValidationError as ft, MessageRegistry as g, FactoryProvider as gn, DIToken as gr, SignedUrlOptions as gt, MessageLoaderService as h, ExistingProvider as hn, CONTAINER_TOKEN as hr, ControllerRegistrationError as ht, isApplicationError as i, IController as in, StratalEnv as ir, InvalidSignatureError as it, CliExceptionContext as j, RenderableCallback as jn, singleton as jr, getRouteMetadata as jt, TranslationMissingError as k, ContextCallback as kn, injectable$1 as kr, Route as kt, resolveHttpStatus as l, ParsedOption as ln, ConditionalBindingFallbackError as lr, RouterUseScopeError as lt, I18nContextMiddleware as m, DynamicModule as mn, getMethodInjections as mr, HonoAppAlreadyConfiguredError as mt, RequestContainerNotInitializedError as n, Middleware as nn, SECURITY_SCHEMES as nr, DomainMismatchError as nt, HttpException as o, CommandInternals as on, getContainer as or, MissingRouteParamError as ot, ErrorCode as p, ClassProvider as pn, ParamInjection as pr, OpenAPIRouteRegistrationError as pt, RouteRegistrationInput as q, RouteResponse as qn, sortRoutesBySpecificity as qt, ContainerNotInitializedError as r, Next$1 as rn, VERSION_NEUTRAL as rr, DuplicateRouteNameError as rt, abort as s, CommandResult as sn, runWithContainer as sr, ResponseValidationError as st, StratalNotInitializedError as t, RouterGroupConfig as tn, ROUTE_METADATA_KEYS as tr, StreamingApi$1 as tt, DefaultExceptionHandler as u, ParsedSignature as un, Transient as ur, SchemaValidationError as ut, getLocales as v, ModuleClass as vn, RouteName as vr, verifySignedUrl as vt, I18nModuleOptions as w, Provider as wn, ContainerOptions as wr, paginatedResponseSchema as wt, I18N_TOKENS as x, OnException as xn, SerializedRoutes as xr, parseDomainPattern as xt, getMessages as y, ModuleContext as yn, RouteParams as yr, VerifySignatureMiddleware as yt, createQueueExceptionContext as z, ControllerOptions as zn, Scope as zr, getControllerOptions as zt };
-//# sourceMappingURL=index-BrmS34sa.d.mts.map
+export { DuplicateRouteNameError as $, TrailingSlashMode as $n, ModuleRegistry as $t, LocaleNotSupportedError as A, ValueProvider as An, container$1 as Ar, Delete as At, ContextQueryResult as B, ControllerOptions as Bn, PredicateContainer as Br, extractDomainParamNames as Bt, DetectionStrategy as C, ModuleContext as Cn, RoutePrefixes as Cr, successMessageSchema as Ct, buildDetectorOptions as D, OnShutdown as Dn, Container as Dr, getRouteDecoratedMethods as Dt, ResolvedI18nOptions as E, OnInitialize as En, StratalRouteMap as Er, Route as Et, QueueExceptionContext as F, RenderableCallback as Fn, singleton as Fr, Controller as Ft, buildRouteUrl as G, RouteBodyObject as Gn, Environment as Gr, toOpenAPIPath as Gt, SignedUriOptions as H, ExplicitRouteMetadata as Hn, ExtensionDecorator as Hr, generateConventionRouteName as Ht, createCliExceptionContext as I, Reportable as In, ConditionalBindingBuilder as Ir, getControllerOptions as It, ApplicationOptions as J, RouteResponse as Jn, RouteRegistrationService as Jt, Application as K, RouteConfig as Kn, ErrorResponse as Kr, route as Kt, createCronExceptionContext as L, ReportableCallback as Ln, ConditionalBindingBuilderImpl as Lr, getControllerRoute as Lt, CronExceptionContext as M, ApplicationErrorConstructor as Mn, inject$1 as Mr, Patch as Mt, ExceptionContext as N, ContextCallback as Nn, injectable$1 as Nr, Post as Nt, resolveI18nOptions as O, Provider as On, ContainerOptions as Or, getRouteMetadata as Ot, HttpExceptionContext as P, LogSeverity as Pn, instancePerContainerCachingFactory$1 as Pr, Put as Pt, DomainMismatchError as Q, SecurityScheme as Qn, VersioningService as Qt, createHttpExceptionContext as R, RespondCallback as Rn, ConditionalBindingGive as Rr, getControllerVersion as Rt, I18nModule as S, ModuleClass as Sn, RouteParams as Sr, paginationQuerySchema as St, LanguageDetectionOptions as T, OnException as Tn, SerializedRoutes as Tr, validationErrorResponseSchema as Tt, Uri as U, LocalePathConfig as Un, Scope as Ur, getPathSpecificityScore as Ut, RouterContext as V, ConventionRouteMetadata as Vn, ContainerLike as Vr, extractParamNames as Vt, UriOptions as W, RouteBody as Wn, WhenOptions as Wr, sortRoutesBySpecificity as Wt, SSEStreamingApi$1 as X, RouterEnv as Xn, RouteRegistrationInput as Xt, SSEMessage as Y, RouteResponseObject as Yn, RegisteredRoute as Yt, StreamingApi$1 as Z, RouterVariables as Zn, RouteRegistry as Zt, Messages as _, ClassProvider as _n, DIToken as _r, createDomainMiddleware as _t, InternalError as a, HonoApp as an, VERSION_NEUTRAL as ar, RouteNameNotFoundError as at, messages as b, FactoryProvider as bn, RouteMatcher as br, errorResponseSchema as bt, getHttpStatus as c, IController as cn, runWithContainer as cr, RouteNotFoundError as ct, ApplicationError as d, CommandResult as dn, Transient as dr, HonoAppAlreadyConfiguredError as dt, RouteConfigurable as en, VersioningOptions as er, InvalidSignatureError as et, ERROR_CODES as f, ParsedArgument as fn, INJECT_PARAM_METADATA_KEY as fr, ControllerRegistrationError as ft, MessageRegistry as g, AsyncModuleOptions as gn, CONTAINER_TOKEN as gr, VerifySignatureMiddleware as gt, MessageLoaderService as h, Quarry as hn, getMethodInjections as hr, verifySignedUrl as ht, isApplicationError as i, ResolvedPath as in, SECURITY_SCHEMES as ir, ResponseValidationError as it, CliExceptionContext as j, ExceptionHandler as jn, delay as jr, Get as jt, TranslationMissingError as k, RegistryEntry as kn, DependencyContainer$1 as kr, All as kt, resolveHttpStatus as l, CommandInput as ln, RequestScopeOperationNotAllowedError as lr, OpenAPIValidationError as lt, I18nContextMiddleware as m, ParsedSignature as mn, ParamInjection as mr, signUrl as mt, RequestContainerNotInitializedError as n, RouterGroupConfig as nn, ROUTER_CONTEXT_KEYS as nr, MissingEnvironmentVariableError as nt, HttpException as o, Middleware as on, containerStorage as or, RouterUseScopeError as ot, ErrorCode as p, ParsedOption as pn, InjectParam as pr, SignedUrlOptions as pt, ApplicationConfig as q, RouteMetadata as qn, isErrorResponse as qr, ROUTER_TOKENS as qt, ContainerNotInitializedError as r, LocalePathService as rn, ROUTE_METADATA_KEYS as rr, MissingRouteParamError as rt, abort as s, Next$1 as sn, getContainer as sr, SchemaValidationError as st, StratalNotInitializedError as t, Router as tn, HTTP_METHODS as tr, MiddlewareNextCalledMultipleTimesError as tt, DefaultExceptionHandler as u, CommandInternals as un, ConditionalBindingFallbackError as ur, OpenAPIRouteRegistrationError as ut, getLocales as v, DynamicModule as vn, DI_TOKENS as vr, parseDomainPattern as vt, I18nModuleOptions as w, ModuleOptions as wn, SerializedRoute as wr, uuidParamSchema as wt, I18N_TOKENS as x, InjectionToken$2 as xn, RouteName as xr, paginatedResponseSchema as xt, getMessages as y, ExistingProvider as yn, CurrentRoute as yr, commonErrorSchemas as yt, createQueueExceptionContext as z, StratalExecutionContext as zn, ConditionalBindingUse as zr, createMiddlewareChain as zt };
+//# sourceMappingURL=index-D0US0X14.d.mts.map