@forinda/kickjs 8.6.0 → 9.0.0

package/README.md

@@ -1,212 +1,75 @@
 # @forinda/kickjs
 
-Decorator-driven Node.js framework for TypeScript — runs on **Express, Fastify, or h3** (swap the engine in one line). Custom DI container, factory-first module system, code generators, Zod-native validation, end-to-end type safety via typegen, and Vite HMR for sub-200ms dev reloads.
+Modern type-safe backend framework, powered by Vite. Built for developer experience, and pluggable as you need: DI, modules, a typed request context, validation and generators, on Express (default), Fastify or h3, and on Workers, Bun and Deno through a web-standard entry.
 
 ## Install
 
 ```bash
-# Scaffold a new project (recommended) — gets you a complete layout in seconds
 npx @forinda/kickjs-cli new my-api && cd my-api && pnpm dev
+```
+
+Or add it to an existing project:
 
-# Or add to an existing project (Express is the zero-config default engine)
+```bash
 pnpm add @forinda/kickjs express reflect-metadata zod
 pnpm add -D @forinda/kickjs-cli @forinda/kickjs-vite
-
-# Prefer another engine? Install its peer and swap one line (see HTTP Runtimes):
-#   pnpm add fastify @fastify/middie   →  runtime: fastifyRuntime()
-#   pnpm add h3                        →  runtime: h3Runtime()
 ```
 
-## Getting Started
-
-The CLI scaffolds a complete layout. The files below show the canonical shapes — copy them into an existing project if you're not using `kick new`.
-
-### 1. Service (`@Service` + DI)
+## Quick example
 
 ```ts
-// src/modules/users/user.service.ts
-import { Service } from '@forinda/kickjs'
+// src/modules/users/user.controller.ts
+import { Autowired, Controller, Get, Post, Service, type Ctx } from '@forinda/kickjs'
+import { z } from 'zod'
 
 @Service()
 export class UserService {
   list() {
     return [{ id: '1', name: 'Alice' }]
   }
-
-  create(input: { name: string; email: string }) {
-    return { id: '2', ...input }
-  }
 }
-```
-
-### 2. Controller (`@Controller`, decorators, typed `ctx`)
-
-```ts
-// src/modules/users/user.controller.ts
-import { Controller, Get, Post, Autowired, type Ctx } from '@forinda/kickjs'
-import { z } from 'zod'
-import { UserService } from './user.service'
-
-const createUserSchema = z.object({
-  name: z.string().min(1),
-  email: z.string().email(),
-})
 
 @Controller()
 export class UserController {
   @Autowired() private readonly users!: UserService
 
   @Get('/')
-  list(ctx: Ctx<KickRoutes.UserController['list']>) {
-    ctx.json(this.users.list())
+  list() {
+    return this.users.list()
   }
 
-  @Post('/', { body: createUserSchema, name: 'CreateUser' })
+  @Post('/', { body: z.object({ name: z.string().min(1) }) })
   create(ctx: Ctx<KickRoutes.UserController['create']>) {
-    // ctx.body is validated + typed from the Zod schema
-    ctx.created(this.users.create(ctx.body))
+    ctx.created({ id: '2', name: ctx.body.name })
   }
 }
 ```
 
-`Ctx<KickRoutes.UserController['list']>` is generated by `kick typegen` (auto-runs on `kick dev`) — `ctx.params`, `ctx.body`, `ctx.query` all narrow to the Zod-derived shape as you save.
-
-### 3. Module (`defineModule()` factory)
-
-```ts
-// src/modules/users/user.module.ts
-import { defineModule } from '@forinda/kickjs'
-import { UserController } from './user.controller'
-
-export const UserModule = defineModule({
-  name: 'UserModule',
-  build: () => ({
-    routes() {
-      return { path: '/users', controller: UserController }
-    },
-  }),
-})
-```
-
-The framework derives the router from `controller` — never import `buildRoutes` directly. `path` is the **single source of truth** for the mount prefix; `@Controller()` takes no path argument.
-
-### 4. Module registry (`defineModules()` fluent chain)
-
-```ts
-// src/modules/index.ts
-import { defineModules } from '@forinda/kickjs'
-import { UserModule } from './users/user.module'
-
-// Factories are called at the registration site — `UserModule()` produces
-// the AppModule instance bootstrap registers. Each `.mount(...)` call adds
-// one module; chain as many as you need.
-export const modules = defineModules().mount(UserModule())
-```
-
-### 5. Bootstrap entry
-
 ```ts
 // src/index.ts
 import 'reflect-metadata'
-import './config' // side-effect — registers env schema BEFORE bootstrap runs
-import { bootstrap } from '@forinda/kickjs'
-import { modules } from './modules'
-
-// Always export the app. The Vite plugin reads this symbol to wire HMR;
-// skipping `export` works in production but degrades dev mode to full restarts.
-export const app = await bootstrap({ modules })
-```
-
-That's it — `http://localhost:3000/api/v1/users` returns Alice; `POST /api/v1/users` with `{ name, email }` validates against the Zod schema.
-
-## HTTP Runtimes — Express, Fastify, or h3
-
-The HTTP engine is pluggable. Controllers, DI, decorators, and `ctx` are engine-neutral; pick the engine in `bootstrap()` (Express is the default — no import needed):
-
-```ts
-import { bootstrap } from '@forinda/kickjs'
-import { fastifyRuntime } from '@forinda/kickjs/fastify' // or @forinda/kickjs/h3 → h3Runtime
-
-export const app = await bootstrap({ modules, runtime: fastifyRuntime() })
-```
+import { bootstrap, defineModule, defineModules } from '@forinda/kickjs'
+import { UserController } from './modules/users/user.controller'
 
-`kick new --runtime express|fastify|h3` scaffolds the right peers. File uploads (`@FileUpload` → `ctx.file` / `ctx.files`) and the rest of the surface work the same on all three. See [HTTP Runtimes](https://kickjs.app/guide/http-runtimes.html).
-
-Two web-standard entries sit alongside them (h3 v2 engine — additive, the v1 runtime is untouched):
-
-```ts
-import { h3WebRuntime } from '@forinda/kickjs/h3-web' // bootstrap() on node, WHATWG pipeline
-import { createWebApp } from '@forinda/kickjs/web' // fetch(Request) → Response — Workers / Bun / Deno
-import * as h3 from 'h3' // v2 — passed in: edge bundlers have no createRequire
-import { modules } from './modules'
-
-const app = createWebApp({ h3, modules })
-export default { fetch: (req: Request) => app.fetch(req) }
-```
+const UserModule = defineModule({
+  name: 'UserModule',
+  build: () => ({ routes: () => ({ path: '/users', controller: UserController }) }),
+})
 
-See [Edge Deployment](https://kickjs.app/guide/edge-deployment.html).
-
-## Project Layout
-
-`kick new` produces this convention; everything except the bootstrap entry is configurable via `kick.config.ts`:
-
-```text
-src/
-  index.ts                  # bootstrap entry — exports `app`
-  config/index.ts           # env schema via defineEnv() + loadEnv()
-  modules/
-    index.ts                # defineModules() chain
-    <name>/<name>.module.ts # one module per feature
-    <name>/<name>.controller.ts
-    <name>/<name>.service.ts
-  middleware/               # optional — `@Middleware()` factories + global stack
-  adapters/                 # optional — `defineAdapter()` integrations
-  plugins/                  # optional — `definePlugin()` bundles
-.agents/                    # AI agent context — AGENTS.md + skills/<slug>/SKILL.md
-CLAUDE.md                   # Claude Code root (thin pointer to .agents/)
-kick.config.ts              # CLI configuration (optional)
-vite.config.ts              # Vite + KickJS HMR
+export const app = await bootstrap({ modules: defineModules().mount(UserModule()) })
 ```
 
-## Core Concepts
-
-- **Pluggable HTTP runtimes** — one `HttpRuntime` seam over Express (default), Fastify, or h3. Swap the engine in one line; everything above stays the same. See [HTTP Runtimes](https://kickjs.app/guide/http-runtimes.html).
-- **Return-value handlers + typed client** — `return` the payload (`reply(201, body)` for other statuses) and the response type flows through `kick typegen` into `KickRoutes.Api`, consumed by [`@forinda/kickjs-client`](https://kickjs.app/guide/typed-client.html) on the frontend. Declare `{ response: schema }` on a route and the same contract feeds the OpenAPI success response. See [Controllers](https://kickjs.app/guide/controllers.html#return-value-handlers), [Typed Client](https://kickjs.app/guide/typed-client.html).
-- **First-class database** — `kick/db`: code-first schema, fully typed queries, and migrations for PostgreSQL / SQLite / MySQL. `kick add db` (or `pg` / `sqlite` / `mysql`). See [Database](https://kickjs.app/guide/database/).
-- **Custom DI container** — three scopes (singleton / transient / request), slash-delimited tokens (`createToken<T>('app/users/repository')`), constructor + property injection. No external DI dep. See [Dependency Injection](https://kickjs.app/guide/dependency-injection.html).
-- **Factory-first** — `defineAdapter()`, `definePlugin()`, `defineModule()`, `defineHttpContextDecorator()`. No class hierarchies to inherit from. See [Adapters](https://kickjs.app/guide/adapters.html), [Plugins](https://kickjs.app/guide/plugins.html).
-- **Context Contributors** — replace single-purpose middleware that only sets `ctx` values. Typed `dependsOn` (typos are TS errors, not boot-time crashes), topo-sorted at startup. (`@forinda/kickjs-ws` handlers don't run contributors — a socket isn't a request.) See [Context Decorators](https://kickjs.app/guide/context-decorators.html).
-- **Built-in health probes** — `GET /health/live` and `GET /health/ready` ship as a module, mounted at the root outside `apiPrefix` so a probe URL an orchestrator is configured against does not move. Readiness runs every adapter's `onHealthCheck()`. They sit inside your middleware chain, so app-wide auth applies — pass `bootstrap({ health: false })` to mount your own.
-- **Env wiring** — `defineEnv()` + `loadEnv()` in `src/config/index.ts`. The `import './config'` side-effect import at the top of `src/index.ts` MUST happen before any `@Value()` injection resolves. See [Configuration](https://kickjs.app/guide/configuration.html).
-- **Asset Manager** — typed `assets.<ns>.<key>()` accessor, configured via `assetMap` in `kick.config.ts`. Drops the `__dirname` arithmetic that production builds get wrong. See [Asset Manager](https://kickjs.app/guide/asset-manager.html).
-- **Reactive primitives** — `ref()` / `computed()` / `reactive()` / `watch()` Vue-style; `ref` and `computed` auto-unwrap on `JSON.stringify` so they drop straight into `introspect()` snapshots.
-- **DevTools** — `/_debug` browser panel with topology, container, contributors, metrics. Adapters expose state via `introspect(): IntrospectionSnapshot` (type lives in `@forinda/kickjs` — no extra import needed). See [DevTools](https://kickjs.app/guide/devtools.html).
-
-## Common Add-Ons
-
-```bash
-kick add db           # kick/db — typed, code-first DB (+ pg / sqlite / mysql)
-kick add upload       # file-upload driver for your runtime (multer / @fastify/multipart / native)
-kick add swagger      # OpenAPI docs from decorators + Zod schemas
-kick add devtools     # /_debug dashboard
-kick add ws           # WebSocket with @WsController, rooms, heartbeat
-kick add queue        # BullMQ / RabbitMQ / Kafka jobs
-kick add testing      # createTestApp + createTestModule helpers
-kick add --list       # full live catalog
-
-kick doctor           # pre-flight checks: engine peers, upload driver, env wiring
-```
+`GET /api/v1/users` returns the list. `KickRoutes` comes from `kick typegen`, which `kick dev` runs for you. To use another engine, pass `runtime: fastifyRuntime()` (from `@forinda/kickjs/fastify`) or `h3Runtime()` to `bootstrap()`.
 
 ## Documentation
 
-**[kickjs.app](https://kickjs.app/)** — full guide, API reference, BYO recipes (auth, GraphQL, OTel, cron, mailer, multi-tenancy, notifications), example apps.
-
-Start here:
+**[kickjs.app](https://kickjs.app/)**. Good places to start:
 
-- [Getting Started](https://kickjs.app/guide/getting-started.html)
-- [Modules](https://kickjs.app/guide/modules.html) · [Controllers](https://kickjs.app/guide/controllers.html) · [Middleware](https://kickjs.app/guide/middleware.html)
-- [Context Decorators](https://kickjs.app/guide/context-decorators.html) · [Adapters](https://kickjs.app/guide/adapters.html) · [Plugins](https://kickjs.app/guide/plugins.html)
-- [BYO Recipes](https://kickjs.app/guide/byo-recipes.html) — auth, GraphQL, OpenTelemetry, cron, mailer, multi-tenancy, notifications
+- [Getting Started](https://kickjs.app/guide/getting-started)
+- [Modules](https://kickjs.app/guide/modules), [Controllers](https://kickjs.app/guide/controllers), [Dependency Injection](https://kickjs.app/guide/dependency-injection)
+- [HTTP Runtimes](https://kickjs.app/guide/http-runtimes), [Edge Deployment](https://kickjs.app/guide/edge-deployment)
+- [Context Decorators](https://kickjs.app/guide/context-decorators), [Adapters](https://kickjs.app/guide/adapters), [Plugins](https://kickjs.app/guide/plugins)
+- [BYO Recipes](https://kickjs.app/guide/byo-recipes): auth, GraphQL, OpenTelemetry, cron, mailer, multi-tenancy
 
 ## License
 

package/dist/{adapter-2bnoYEPX.d.mts → adapter-DhjoIYVI.d.mts}

@@ -1,15 +1,53 @@
 
 import { i as Constructor, o as MaybePromise } from "./interfaces-C1hCSoLD.mjs";
 import { s as InjectionToken, t as Container } from "./container-Dpvd66Yt.mjs";
-import { g as FileUploadConfig, k as RouteDefinition, x as MiddlewareHandler } from "./decorators-mg0qJ6Qc.mjs";
+import { g as FileUploadConfig, k as RouteDefinition, x as MiddlewareHandler } from "./decorators-DOcWsXci.mjs";
 import { p as RouteFlags } from "./route-flag-B1lQht6v.mjs";
 import { C as MetaValue, S as ExecutionContext, m as ContributorRegistrations, o as AnyContributorRegistration, r as AppModuleEntry, t as AppModule, x as ContextMetaKey } from "./app-module-DCA65GZZ.mjs";
 import "./cache-C0qL0NSD.mjs";
 import { i as ProblemDetails } from "./errors-By6UueCm.mjs";
+import { t as Session } from "./session-4Tb6q0Ny.mjs";
 import { S as QueryFieldConfig, T as TypedParsedQuery, t as ParseQueryOptions, v as PaginatedResponse } from "./index-BfT5KZ-M.mjs";
 import "reflect-metadata";
 import http, { IncomingMessage, ServerResponse } from "node:http";
+import https from "node:https";
+import http2 from "node:http2";
 import { ErrorRequestHandler, Express as Express$1, NextFunction, Request as Request$1, RequestHandler, Response as Response$1 } from "express";
+//#region src/core/observers.d.ts
+/** Where an error came from. Integrations may report their own sources. */
+type ErrorSource = 'request' | 'uncaught' | 'unhandled-rejection' | 'background' | 'job' | (string & {});
+interface ErrorInfo {
+  source: ErrorSource;
+  requestId?: string;
+  method?: string;
+  /** The request URL path, as received. */
+  path?: string;
+  /** The matched route pattern, e.g. `/api/v1/users/:id`, when one matched. */
+  route?: string;
+  /** The status the error was answered with, for request errors. */
+  status?: number;
+  /** Anything else the reporter knows — a queue and job name, a cron schedule. */
+  context?: Record<string, unknown>;
+}
+interface ResponseInfo {
+  method: string;
+  path: string;
+  /** The matched route pattern, or undefined when no route matched (404s). */
+  route?: string;
+  status: number;
+  durationMs: number;
+  requestId?: string;
+}
+/**
+ * Report an error to every observer. The framework calls this for request
+ * errors, uncaught exceptions, unhandled rejections, `waitUntil` failures and
+ * queue job failures; call it from your own integrations too (a cron runner,
+ * a message consumer). Never throws.
+ */
+declare function reportError(error: unknown, info: ErrorInfo): void;
+/** Report a finished response to every observer. Never throws. */
+declare function reportResponse(info: ResponseInfo): void;
+//#endregion
 //#region src/core/introspect.d.ts
 /**
  * Per-primitive introspection snapshot — the JSON shape an adapter or
@@ -80,8 +118,8 @@ type IntrospectFn = () => IntrospectionSnapshot | Promise<IntrospectionSnapshot>
 //#endregion
 //#region src/core/augmentation.d.ts
 /**
- * Augmentation registry — runtime no-op + the canonical
- * `KickJsPluginRegistry` interface that `kick typegen` augments.
+ * The canonical `KickJsPluginRegistry` interface that `kick typegen`
+ * augments, for typed `dependsOn` between plugins and adapters.
  *
  * See `architecture.md` §21.2.1 (typegen for `dependsOn`) and §21.3.3
  * (standardized augmentation registry) for the design rationale.
@@ -109,103 +147,6 @@ interface KickJsPluginRegistry {}
  * narrowing is a progressive enhancement, not a hard prerequisite.
  */
 type KickJsPluginName = keyof KickJsPluginRegistry extends never ? string : keyof KickJsPluginRegistry & string;
-/**
- * Metadata attached to a `defineAugmentation` call. The fields are
- * documentation-only — `kick typegen` surfaces them in the generated
- * `.kickjs/types/kick__augmentations.d.ts` so adopters can browse every
- * augmentable interface from one place.
- *
- * `description` and `example` may both be multi-line — typegen preserves
- * line breaks when rendering them as JSDoc. There is no upper limit on
- * the example size; entire shape definitions or worked snippets are fine.
- */
-interface AugmentationMeta {
-  /**
-   * Free-form description of what the augmentation customises. May be
-   * multi-line — newlines are preserved in the generated JSDoc.
-   */
-  description?: string;
-  /**
-   * TS snippet showing a typical shape. May be multi-line; rendered
-   * inside a fenced code block in the generated catalogue. Use this
-   * for anything from `'{ foo: string }'` up to a full interface body
-   * — typegen no longer flattens newlines.
-   */
-  example?: string;
-}
-/**
- * @deprecated Since 7.2. This was tooling for a time when Context
- * Contributors were still settling — a catalogue so adopters could discover
- * which interfaces were augmentable. Contributors are a stable, typed API now
- * (`defineContextDecorator`, `ContextMeta`), and the catalogue adds a second
- * call that must be kept in step with the `declare module` block for no
- * type-level benefit.
- *
- * Nothing breaks: `kick typegen` still discovers the call and still writes the
- * catalogue. Just drop it — the `declare module '@forinda/kickjs'` block alone
- * gives you the types, which is all it ever gave you.
- *
- * What it actually emits, for the record: one empty marker interface per call
- * in `.kickjs/types/kick__augmentations.d.ts` —
- *
- * ```ts
- * // from defineAugmentation('ContextMeta', { description, example })
- * export interface ContextMetaAugmentation {}
- * ```
- *
- * with your `description` / `example` rendered as its JSDoc and a `@see` back
- * to the call site. The interface is empty and unreferenced; nothing consumes
- * it at type level.
- *
- * Advertise an augmentable interface so `kick typegen` can list it in
- * `.kickjs/types/kick__augmentations.d.ts` for project-wide discovery.
- *
- * **This function is a runtime AND type-level no-op.** It does NOT
- * augment the interface for TypeScript. The actual augmentation is
- * the `declare module` block — `defineAugmentation` only adds an
- * entry to the typegen catalogue (`.kickjs/types/kick__augmentations.d.ts`)
- * so other contributors / adopters can find the interface and know its
- * expected shape.
- *
- * Both calls are needed:
- *
- * ```ts
- * import { defineAugmentation } from '@forinda/kickjs'
- *
- * // (1) The actual TS augmentation — what `ctx.get('tenant')` reads.
- * declare module '@forinda/kickjs' {
- *   interface ContextMeta {
- *     tenant: { id: string; name: string }
- *   }
- * }
- *
- * // (2) Catalogue entry — what `kick typegen` lists in
- * //     `.kickjs/types/kick__augmentations.d.ts` for browseability.
- * defineAugmentation('ContextMeta', {
- *   description: 'Tenant resolved from x-tenant-id by TenantAdapter',
- *   example: `{
- *     tenant: {
- *       id: string
- *       name: string
- *       plan: 'free' | 'pro' | 'enterprise'
- *       featureFlags: Record<string, boolean>
- *     }
- *   }`,
- * })
- * ```
- *
- * Skip `defineAugmentation` if you don't care about the catalogue — the
- * `declare module` block alone is enough for runtime + type behaviour.
- *
- * @deprecated Low value in practice: it does nothing at runtime or at
- * the type level — the `declare module` block alone gives you the
- * augmentation, and the generated `.kickjs/types/kick__augmentations.d.ts`
- * catalogue it feeds is documentation-only. Prefer a plain
- * `declare module '@forinda/kickjs' { ... }` block and (optionally) a
- * JSDoc comment on your own interface. `defineAugmentation` and the
- * `kick/augmentations` typegen plugin will be removed in a future major.
- */
-declare function defineAugmentation(name: string, meta?: AugmentationMeta): void;
 //#endregion
 //#region src/core/module-registry.d.ts
 /**
@@ -436,6 +377,19 @@ interface KickPlugin {
    * Use for post-startup logic like logging, health registration, etc.
    */
   onReady?(container: Container): void | Promise<void>;
+  /**
+   * Observe every error the app reports — request errors (any status; filter
+   * on `info.status`), uncaught exceptions, unhandled rejections, failed
+   * `waitUntil` work, failed queue jobs, and anything passed to
+   * `reportError()`. Observe-only: the response is not yours to change, and a
+   * throw here is logged and skipped. The place to wire Sentry & co.
+   */
+  onError?(error: unknown, info: ErrorInfo): void | Promise<void>;
+  /**
+   * Observe every finished response — method, path, the matched route
+   * pattern, status, duration. Only timed while something listens.
+   */
+  onResponse?(info: ResponseInfo): void | Promise<void>;
   /**
    * Called during application shutdown — release what this plugin owns
    * (connections, intervals, subscriptions).
@@ -1189,8 +1143,17 @@ TKeys extends ContextMetaKey = ContextMetaKey> implements ExecutionContext<TKeys
    * idempotent).
    */
   get signal(): AbortSignal;
-  /** Session data (requires session middleware) */
-  get session(): any;
+  /**
+   * The request's session — set by the `session()` middleware, which must be
+   * installed. Type your keys once by augmenting `SessionData`:
+   *
+   * ```ts
+   * declare module '@forinda/kickjs' {
+   *   interface SessionData { userId?: string }
+   * }
+   * ```
+   */
+  get session(): Session;
   /**
    * The authenticated user set by AuthAdapter.
    * Reads from the per-request metadata store first (`ctx.set('user', ...)`),
@@ -1439,6 +1402,11 @@ TKeys extends ContextMetaKey = ContextMetaKey> implements ExecutionContext<TKeys
    */
   redirect(url: string, status?: number): unknown;
   html(content: string, status?: number): RuntimeResponse;
+  /**
+   * Send `buffer` as a file download named `filename`. The name is written
+   * per RFC 6266 — an ASCII fallback plus `filename*` in UTF-8 — so a name
+   * from an upload (quotes, line breaks, non-Latin text) can't break the header.
+   */
   download(buffer: Buffer, filename: string, contentType?: string): RuntimeResponse;
   /**
    * Render a template using the registered view engine (EJS, Pug, Handlebars, etc.).
@@ -1527,6 +1495,14 @@ TKeys extends ContextMetaKey = ContextMetaKey> implements ExecutionContext<TKeys
    * ```
    */
   sendResponse(response: Response): Promise<void>;
+  /**
+   * Keep `promise` running after the response is sent — an audit log, an
+   * email, an analytics call. The Node server's `shutdown()` waits for it;
+   * `createHandler()` and the web entry hand it to the platform's
+   * `waitUntil` when you pass the platform context in. A rejection is
+   * logged, never unhandled. Same as the standalone `waitUntil()` export.
+   */
+  waitUntil(promise: Promise<unknown>): void;
   sse<T = unknown>(): SseHandler<T>;
 }
 /**
@@ -1591,6 +1567,8 @@ type Ctx<TRoute extends RouteShape = RouteShape> = RequestContext<TRoute extends
 declare global {
   namespace KickRoutes {}
 }
+/** `attachment; filename="…"; filename*=UTF-8''…` for any file name (RFC 6266 / RFC 8187). */
+declare function contentDisposition(filename: string): string;
 //#endregion
 //#region src/http/runtime.d.ts
 /** HTTP verbs the router emits. Mirrors the decorator surface (@Get/@Post/...). */
@@ -1672,11 +1650,22 @@ interface RouteMeta {
    * question. See `core/route-flag.ts`.
    */
   flags?: RouteFlags;
+  /**
+   * The full mounted pattern (`/api/v1/users/:id`) — set by the Application
+   * for controller routes. `path` is relative to the module mount.
+   */
+  pattern?: string;
 }
 interface MatchedRoute {
   method: RouteMethod;
   /** Path as declared on the handler, e.g. `/:id`. */
   path: string;
+  /**
+   * The full route pattern including the mount prefix and version, e.g.
+   * `/api/v1/users/:id` — what metrics and spans should be keyed by. Falls
+   * back to `path` for routes registered without a mount.
+   */
+  pattern: string;
   controller?: Constructor;
   handlerName?: string;
   /** Enabled flags only — see {@link RouteMeta.flags}. */
@@ -1781,6 +1770,13 @@ interface RuntimeCapabilities {
    * false — it relies on the `express.json()` connect middleware.
    */
   nativeBodyParsing: boolean;
+  /**
+   * The engine's `nodeHandler` works behind `node:http2` (the HTTP/2
+   * compatibility API), so `server: { http2: true }` may use it. Fastify/h3:
+   * true. Express: false — it does not run on that layer. Absent = false, so
+   * custom runtimes opt in explicitly.
+   */
+  http2?: boolean;
 }
 /**
  * The engine driver. KickJS owns decorators → {@link RouteTable}, the
@@ -1904,6 +1900,8 @@ interface AdapterMiddleware {
  * }
  * ```
  */
+/** The Node server behind the app — see `ApplicationOptions.server`. */
+type KickServer = http.Server | https.Server | http2.Http2SecureServer;
 interface AdapterContext {
   /**
    * Engine-agnostic HTTP surface — the supported way to add routes, mounts,
@@ -1932,8 +1930,13 @@ interface AdapterContext {
   fetch(request: Request): Promise<Response>;
   /** DI container */
   container: Container;
-  /** Node.js http.Server — only available in afterStart */
-  server?: http.Server;
+  /**
+   * The Node server the app listens on — only available in afterStart. An
+   * `http.Server` by default; an `https.Server` or `Http2SecureServer` when
+   * `bootstrap({ server })` sets `tls` / `http2`. All three emit `upgrade`
+   * for HTTP/1.1 clients, which is what WebSocket libraries attach to.
+   */
+  server?: KickServer;
   /** Current NODE_ENV value (default: 'development') */
   env: string;
   /** true when NODE_ENV === 'production' */
@@ -2058,6 +2061,19 @@ interface AppAdapter {
     name: string;
     status: 'up' | 'down';
   }>;
+  /**
+   * Observe every error the app reports — request errors (any status; filter
+   * on `info.status`), uncaught exceptions, unhandled rejections, failed
+   * `waitUntil` work, failed queue jobs, and anything passed to
+   * `reportError()`. Observe-only: the response is not yours to change, and a
+   * throw here is logged and skipped. The place to wire Sentry & co.
+   */
+  onError?(error: unknown, info: ErrorInfo): void | Promise<void>;
+  /**
+   * Observe every finished response — method, path, the matched route
+   * pattern, status, duration. Only timed while something listens.
+   */
+  onResponse?(info: ResponseInfo): void | Promise<void>;
   /**
    * Called on shutdown — release what this adapter owns.
    *
@@ -2102,5 +2118,5 @@ interface AppAdapter {
 /** Constructor type for AppAdapter classes */
 type AppAdapterClass = new () => AppAdapter;
 //#endregion
-export { ModuleList as $, AdapterFactory as A, getClassMeta as B, UseConnectOptions as C, RouteShape as D, RequestContext as E, BuildPipelineOptions as F, getMethodMetaOrUndefined as G, getMetaMap as H, ContributorPipeline as I, pushMethodMeta as J, hasClassMeta as K, ContributorSource as L, defineAdapter as M, RunContributorsOptions as N, SseHandler as O, runContributors as P, setMethodMeta as Q, SourcedRegistration as R, RuntimeTypeMap as S, DeepReadonly as T, getMetaRecord as U, getClassMetaOrUndefined as V, getMethodMeta as W, setInMetaMap as X, setClassMeta as Y, setInMetaRecord as Z, RouteMethod as _, IntrospectionKind as _t, MiddlewarePath as a, DefinePluginOptions as at, RuntimeCapabilities as b, AdapterHttp as c, definePlugin as ct, ExpressRuntimeTypes as d, MutableModuleRegistry as dt, defineModules as et, HttpRuntime as f, AugmentationMeta as ft, RouteMeta as g, IntrospectFn as gt, RouteEntry as h, defineAugmentation as ht, AppAdapterClass as i, BuildContext as it, DefineAdapterOptions as j, AdapterAsyncOptions as k, ConnectMiddleware as l, KickPlugin as lt, MatchedRoute as m, KickJsPluginRegistry as mt, AdapterMiddleware as n, ModuleFactory as nt, MiddlewarePhase as o, PluginAsyncOptions as ot, KickRuntimeRegister as p, KickJsPluginName as pt, pushClassMeta as q, AppAdapter as r, defineModule as rt, ActiveRuntime as s, PluginFactory as st, AdapterContext as t, DefineModuleOptions as tt, CtxHandler as u, ModuleRegistry as ut, RouteTable as v, IntrospectionSnapshot as vt, Ctx as w, RuntimeResponse as x, RuntimeAppOptions as y, buildPipeline as z };
-//# sourceMappingURL=adapter-2bnoYEPX.d.mts.map
+export { setInMetaRecord as $, contentDisposition as A, SourcedRegistration as B, RuntimeTypeMap as C, reportResponse as Ct, RequestContext as D, DeepReadonly as E, RunContributorsOptions as F, getMetaRecord as G, getClassMeta as H, runContributors as I, hasClassMeta as J, getMethodMeta as K, BuildPipelineOptions as L, AdapterFactory as M, DefineAdapterOptions as N, RouteShape as O, defineAdapter as P, setInMetaMap as Q, ContributorPipeline as R, RuntimeResponse as S, reportError as St, Ctx as T, getClassMetaOrUndefined as U, buildPipeline as V, getMetaMap as W, pushMethodMeta as X, pushClassMeta as Y, setClassMeta as Z, RouteMeta as _, IntrospectionKind as _t, KickServer as a, defineModule as at, RuntimeAppOptions as b, ErrorSource as bt, ActiveRuntime as c, PluginAsyncOptions as ct, CtxHandler as d, KickPlugin as dt, setMethodMeta as et, ExpressRuntimeTypes as f, ModuleRegistry as ft, RouteEntry as g, IntrospectFn as gt, MatchedRoute as h, KickJsPluginRegistry as ht, AppAdapterClass as i, ModuleFactory as it, AdapterAsyncOptions as j, SseHandler as k, AdapterHttp as l, PluginFactory as lt, KickRuntimeRegister as m, KickJsPluginName as mt, AdapterMiddleware as n, defineModules as nt, MiddlewarePath as o, BuildContext as ot, HttpRuntime as p, MutableModuleRegistry as pt, getMethodMetaOrUndefined as q, AppAdapter as r, DefineModuleOptions as rt, MiddlewarePhase as s, DefinePluginOptions as st, AdapterContext as t, ModuleList as tt, ConnectMiddleware as u, definePlugin as ut, RouteMethod as v, IntrospectionSnapshot as vt, UseConnectOptions as w, RuntimeCapabilities as x, ResponseInfo as xt, RouteTable as y, ErrorInfo as yt, ContributorSource as z };
+//# sourceMappingURL=adapter-DhjoIYVI.d.mts.map

package/dist/adapter-DhjoIYVI.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter-DhjoIYVI.d.mts","names":[],"sources":["../src/core/observers.ts","../src/core/introspect.ts","../src/core/augmentation.ts","../src/core/module-registry.ts","../src/core/plugin.ts","../src/core/define-plugin.ts","../src/core/define-module.ts","../src/core/define-modules.ts","../src/core/metadata.ts","../src/core/contributor-pipeline.ts","../src/core/contributor-runner.ts","../src/core/define-adapter.ts","../src/http/context.ts","../src/http/runtime.ts","../src/core/adapter.ts"],"mappings":"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"}