@forinda/kickjs 6.4.0 → 6.5.0

package/dist/{adapter-BjxEv8oW.d.mts → adapter-CEt1MEdF.d.mts}

@@ -2,7 +2,7 @@
 import { i as Constructor, o as MaybePromise } from "./interfaces-CayXPOAf.mjs";
 import { s as InjectionToken, t as Container } from "./container-iED1swkd.mjs";
 import { g as FileUploadConfig, k as RouteDefinition, x as MiddlewareHandler } from "./decorators-wEJBqXHg.mjs";
-import { _ as ExecutionContext, a as AnyContributorRegistration, d as ContributorRegistrations, r as AppModuleEntry, t as AppModule, v as MetaValue } from "./app-module-BwYtACD6.mjs";
+import { _ as ExecutionContext, a as AnyContributorRegistration, d as ContributorRegistrations, r as AppModuleEntry, t as AppModule, v as MetaValue } from "./app-module-BSpHKlhE.mjs";
 import { i as ProblemDetails } from "./errors-n0H96eEz.mjs";
 import { S as QueryFieldConfig, T as TypedParsedQuery, t as ParseQueryOptions } from "./index-BtWJ9SLP.mjs";
 import http, { IncomingMessage, ServerResponse } from "node:http";
@@ -875,11 +875,18 @@ declare class CircuitBreaker {
 /**
  * Errors thrown by the Context Contributor pipeline.
  *
- * All three are startup-time errors raised during pipeline build (topo-sort
- * + validation), not per-request — a misconfigured app fails to boot rather
- * than fails a request. Per the locked design in `architecture.md` §20.4,
- * the pipeline is validated once when each route is mounted and the
- * resolved order is cached on the route.
+ * `MissingContributorError`, `ContributorCycleError`, and
+ * `DuplicateContributorError` are startup-time errors raised during
+ * pipeline build (topo-sort + validation), not per-request — a
+ * misconfigured app fails to boot rather than fails a request. Per the
+ * locked design in `architecture.md` §20.4, the pipeline is validated
+ * once when each route is mounted and the resolved order is cached on
+ * the route.
+ *
+ * `MissingContextValueError` is the one request-time error here: it is
+ * raised by `ctx.require(key)` when a value a handler declared it needs
+ * is absent. See its doc comment for why that case can't be caught at
+ * startup today.
  */
 /**
  * A contributor declared `dependsOn: ['<key>']` but no other contributor
@@ -898,6 +905,41 @@ declare class MissingContributorError extends Error {
   readonly dependentDefinedAt?: string;
   constructor(key: string, dependent: string, route?: string, dependentDefinedAt?: string);
 }
+/**
+ * `ctx.require(key)` found no value under `key` in the per-request
+ * metadata store.
+ *
+ * Thrown at request time, by design. `ctx.get(key)` returns
+ * `T | undefined` for every key, so the usual workaround is a
+ * non-null assertion — `ctx.get('tenant')!` — which compiles whether or
+ * not the route actually carries the contributor that produces it. On
+ * an authorization value that is the worst possible thing to leave
+ * untypeable: dropping the decorator produces no diagnostic anywhere,
+ * and the handler reads `undefined` as though it were a real value.
+ *
+ * `ctx.require()` converts that silent hole into a loud, named failure
+ * that points at the missing contributor.
+ *
+ * A handler typed with a generated route type (`Ctx<KickRoutes…>`) also
+ * gets compile-time narrowing, so a dropped decorator fails `tsc` rather
+ * than reaching this error at all. This error remains the backstop for
+ * routes typegen couldn't prove (module/adapter/bootstrap registrations),
+ * handlers typed as plain `RequestContext`, and contributors that ran but
+ * resolved to `undefined`. See `architecture.md` §20.14.
+ *
+ * @example
+ * ```text
+ * MissingContextValueError: No context value for 'tenantPerm' on GET /projects/:id
+ *     Nothing wrote this key before the handler ran. Either the contributor
+ *     that produces it isn't applied to this route, or it ran and resolved
+ *     to undefined (check `optional: true` contributors).
+ * ```
+ */
+declare class MissingContextValueError extends Error {
+  readonly key: string;
+  readonly route?: string;
+  constructor(key: string, route?: string);
+}
 /**
  * Topo-sort detected a cycle in `dependsOn` declarations. The `cycle` field
  * lists the keys in the order they form the loop, with the first key
@@ -1326,6 +1368,21 @@ interface RouteShape {
   body?: unknown;
   query?: unknown;
   response?: unknown;
+  /**
+   * Union of context keys `kick typegen` proved are populated for this
+   * route — the keys of every context contributor applied at method or
+   * class level. Drives {@link RequestContext.require} narrowing, so
+   * calling `ctx.require()` for a key this route doesn't carry is a
+   * compile error instead of a request-time throw.
+   *
+   * `string` (the default) means "not proven", not "no keys". Typegen
+   * emits `string` whenever it cannot see the full picture — a
+   * contributor registered at module / adapter / bootstrap level, or an
+   * unrecognised decorator that might bundle contributors of its own.
+   * Narrowing an unprovable route would produce compile errors for keys
+   * that really are present.
+   */
+  contextKeys?: string;
 }
 /**
  * Unified request/response abstraction passed to every controller method.
@@ -1335,7 +1392,14 @@ interface RouteShape {
  * Contributor pipeline (#107) can run against this concrete HTTP context
  * the same way it will run against future WS / queue / cron contexts.
  */
-declare class RequestContext<TBody = any, TParams = any, TQuery = any> implements ExecutionContext {
+declare class RequestContext<TBody = any, TParams = any, TQuery = any,
+/**
+ * Context keys proven present for this route. Defaults to `string`, so
+ * a handler typed as plain `RequestContext` keeps today's unnarrowed
+ * behaviour — which is also the deliberate escape hatch when typegen's
+ * view is incomplete.
+ */
+TKeys extends string = string> implements ExecutionContext<TKeys> {
   readonly req: ActiveRuntime['request'];
   readonly res: ActiveRuntime['response'];
   readonly next: NextFunction;
@@ -1523,6 +1587,50 @@ declare class RequestContext<TBody = any, TParams = any, TQuery = any> implement
    * `ctx.get<MyType>('custom')`.
    */
   get<K extends string>(key: K): MetaValue<K> | undefined;
+  /**
+   * Read a value that a contributor is expected to have produced, and
+   * throw {@link MissingContextValueError} when it hasn't.
+   *
+   * Use this instead of `ctx.get(key)!` anywhere the value is a
+   * precondition rather than an optional extra — permissions, tenants,
+   * the resolved subject of the route. The non-null assertion compiles
+   * whether or not the producing contributor is actually applied to the
+   * route, so a dropped `@LoadTenant` turns into `undefined` flowing
+   * silently into an auth check. `require()` fails loudly at that point
+   * instead, naming the key.
+   *
+   * ```ts
+   * // before — compiles even if @OperatorPerm was never applied
+   * const perm = ctx.get('operatorPerm')!
+   *
+   * // after — throws MissingContextValueError naming the key + route
+   * const perm = ctx.require('operatorPerm')
+   * ```
+   *
+   * When `TKeys` is narrowed — which it is for a handler typed as
+   * `Ctx<KickRoutes…>`, from typegen's per-route `contextKeys` — asking
+   * for a key the route doesn't carry is a compile error, so a dropped
+   * decorator fails the build. `TKeys` stays `string` (no narrowing) for
+   * a plain `RequestContext` and for any route typegen couldn't prove
+   * complete; there this is a runtime guarantee only.
+   * See `architecture.md` §20.14.
+   *
+   * `null` counts as present; only `undefined` (or a missing entry)
+   * throws. A contributor that deliberately resolves to `null` is
+   * expressing "looked, found nothing", which is a real value — which
+   * is why the return type is `Exclude<…, undefined>` and NOT
+   * `NonNullable<…>`. The latter would strip `null` from the type while
+   * the runtime still hands it back, so a caller would be told a value
+   * is non-null and then get `null`.
+   */
+  require<K extends TKeys>(key: K): Exclude<MetaValue<K>, undefined>;
+  /**
+   * Best-effort `"GET /path"` label for error messages. Runtime-agnostic:
+   * express/fastify requests and web-standard `Request` all expose
+   * `method` + `url`, but none of them are guaranteed here, so every
+   * access is defensive and the whole thing is optional.
+   */
+  private routeLabel;
   /**
    * Write a value to the per-request metadata store. Throws when no
    * AsyncLocalStorage frame is active — see {@link metadataForWrite}
@@ -1699,7 +1807,9 @@ type Ctx<TRoute extends RouteShape = RouteShape> = RequestContext<TRoute extends
   params: infer P;
 } ? P : any, TRoute extends {
   query: infer Q;
-} ? Q : any>;
+} ? Q : any, TRoute extends {
+  contextKeys: infer K;
+} ? (K extends string ? K : string) : string>;
 /**
  * Global ambient registry of typed routes, populated by `kick typegen`.
  *
@@ -2169,5 +2279,5 @@ interface AppAdapter {
 /** Constructor type for AppAdapter classes */
 type AppAdapterClass = new () => AppAdapter;
 //#endregion
-export { MissingContributorError as $, GroupAssetKeysOptions as A, BuildContext as At, MountCycleError as B, KickJsPluginRegistry as Bt, Ctx as C, disposeAll as Ct, SseHandler as D, DefineModuleOptions as Dt, RouteShape as E, defineModules as Et, AdapterFactory as F, KickPlugin as Ft, runContributors as G, MountSortItem as H, IntrospectFn as Ht, DefineAdapterOptions as I, ModuleRegistry as It, ContributorSource as J, BuildPipelineOptions as K, defineAdapter as L, MutableModuleRegistry as Lt, groupAssetKeys as M, PluginAsyncOptions as Mt, stripExt as N, PluginFactory as Nt, AssetKeyPair as O, ModuleFactory as Ot, AdapterAsyncOptions as P, definePlugin as Pt, DuplicateContributorError as Q, DuplicateMountNameError as R, AugmentationMeta as Rt, UseConnectOptions as S, Disposable as St, RequestContext as T, ModuleList as Tt, mountSort as U, IntrospectionKind as Ut, MountKind as V, defineAugmentation as Vt, RunContributorsOptions as W, IntrospectionSnapshot as Wt, buildPipeline as X, SourcedRegistration as Y, ContributorCycleError as Z, RouteTable as _, setMethodMeta as _t, MiddlewarePath as a, getClassMeta as at, RuntimeResponse as b, KickErrorInit as bt, AdapterHttp as c, getMetaRecord as ct, ExpressRuntimeTypes as d, hasClassMeta as dt, CircuitBreaker as et, HttpRuntime as f, pushClassMeta as ft, RouteMethod as g, setInMetaRecord as gt, RouteMeta as h, setInMetaMap as ht, AppAdapterClass as i, CircuitOpenError as it, GroupAssetKeysResult as j, DefinePluginOptions as jt, AssetKeyStrategy as k, defineModule as kt, ConnectMiddleware as l, getMethodMeta as lt, RouteEntry as m, setClassMeta as mt, AdapterMiddleware as n, CircuitBreakerState as nt, MiddlewarePhase as o, getClassMetaOrUndefined as ot, KickRuntimeRegister as p, pushMethodMeta as pt, ContributorPipeline as q, AppAdapter as r, CircuitBreakerStats as rt, ActiveRuntime as s, getMetaMap as st, AdapterContext as t, CircuitBreakerOptions as tt, CtxHandler as u, getMethodMetaOrUndefined as ut, RuntimeAppOptions as v, FormatKickErrorOptions as vt, DeepReadonly as w, registerDisposable as wt, RuntimeTypeMap as x, formatKickError as xt, RuntimeCapabilities as y, KickError as yt, MissingMountDepError as z, KickJsPluginName as zt };
-//# sourceMappingURL=adapter-BjxEv8oW.d.mts.map
+export { MissingContextValueError as $, GroupAssetKeysOptions as A, defineModule as At, MountCycleError as B, KickJsPluginName as Bt, Ctx as C, Disposable as Ct, SseHandler as D, defineModules as Dt, RouteShape as E, ModuleList as Et, AdapterFactory as F, definePlugin as Ft, runContributors as G, IntrospectionSnapshot as Gt, MountSortItem as H, defineAugmentation as Ht, DefineAdapterOptions as I, KickPlugin as It, ContributorSource as J, BuildPipelineOptions as K, defineAdapter as L, ModuleRegistry as Lt, groupAssetKeys as M, DefinePluginOptions as Mt, stripExt as N, PluginAsyncOptions as Nt, AssetKeyPair as O, DefineModuleOptions as Ot, AdapterAsyncOptions as P, PluginFactory as Pt, DuplicateContributorError as Q, DuplicateMountNameError as R, MutableModuleRegistry as Rt, UseConnectOptions as S, formatKickError as St, RequestContext as T, registerDisposable as Tt, mountSort as U, IntrospectFn as Ut, MountKind as V, KickJsPluginRegistry as Vt, RunContributorsOptions as W, IntrospectionKind as Wt, buildPipeline as X, SourcedRegistration as Y, ContributorCycleError as Z, RouteTable as _, setInMetaRecord as _t, MiddlewarePath as a, CircuitOpenError as at, RuntimeResponse as b, KickError as bt, AdapterHttp as c, getMetaMap as ct, ExpressRuntimeTypes as d, getMethodMetaOrUndefined as dt, MissingContributorError as et, HttpRuntime as f, hasClassMeta as ft, RouteMethod as g, setInMetaMap as gt, RouteMeta as h, setClassMeta as ht, AppAdapterClass as i, CircuitBreakerStats as it, GroupAssetKeysResult as j, BuildContext as jt, AssetKeyStrategy as k, ModuleFactory as kt, ConnectMiddleware as l, getMetaRecord as lt, RouteEntry as m, pushMethodMeta as mt, AdapterMiddleware as n, CircuitBreakerOptions as nt, MiddlewarePhase as o, getClassMeta as ot, KickRuntimeRegister as p, pushClassMeta as pt, ContributorPipeline as q, AppAdapter as r, CircuitBreakerState as rt, ActiveRuntime as s, getClassMetaOrUndefined as st, AdapterContext as t, CircuitBreaker as tt, CtxHandler as u, getMethodMeta as ut, RuntimeAppOptions as v, setMethodMeta as vt, DeepReadonly as w, disposeAll as wt, RuntimeTypeMap as x, KickErrorInit as xt, RuntimeCapabilities as y, FormatKickErrorOptions as yt, MissingMountDepError as z, AugmentationMeta as zt };
+//# sourceMappingURL=adapter-CEt1MEdF.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"adapter-CEt1MEdF.d.mts","names":[],"sources":["../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/disposables.ts","../src/core/kick-error.ts","../src/core/metadata.ts","../src/core/circuit-breaker.ts","../src/core/context-errors.ts","../src/core/contributor-pipeline.ts","../src/core/contributor-runner.ts","../src/core/mount-sort.ts","../src/core/define-adapter.ts","../src/core/asset-keys.ts","../src/http/context.ts","../src/http/runtime.ts","../src/core/adapter.ts"],"mappings":"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"}

package/dist/{app-module-BwYtACD6.d.mts → app-module-BSpHKlhE.d.mts}

@@ -87,9 +87,30 @@ type MetaValue<K extends string, Fallback = unknown> = K extends keyof ContextMe
  * pipeline only depends on this interface — contributors authored against
  * `ExecutionContext` work across every transport that adopts it.
  */
-interface ExecutionContext {
-  /** Read a typed value from per-request metadata. */
+interface ExecutionContext<TKeys extends string = string> {
+  /**
+   * Read a typed value from per-request metadata.
+   *
+   * Deliberately NOT narrowed by `TKeys`: `get` accepts any key and
+   * always returns `| undefined`. Narrowing it would mean claiming a key
+   * is present, and a wrong claim there fails open — exactly the silent
+   * failure `require` exists to prevent.
+   */
   get<K extends string>(key: K): MetaValue<K> | undefined;
+  /**
+   * Read a value that must be present, throwing `MissingContextValueError`
+   * when it isn't. Use for preconditions (permissions, tenant, resolved
+   * subject) where `get(key)!` would silently paper over a contributor
+   * that never ran. Only `undefined` throws — `null` is a real value,
+   * hence `Exclude<…, undefined>` rather than `NonNullable<…>`.
+   *
+   * When `TKeys` is narrowed (via a typegen'd `Ctx<KickRoutes…>`), asking
+   * for a key the route doesn't carry is a compile error — which is how a
+   * dropped decorator stops being invisible. The narrowing direction is
+   * deliberate: an incomplete typegen view produces a false *error*, not
+   * a false guarantee.
+   */
+  require<K extends TKeys>(key: K): Exclude<MetaValue<K>, undefined>;
   /** Write a typed value into per-request metadata. */
   set<K extends string>(key: K, value: MetaValue<K>): void;
   /** Unique per-request identifier (HTTP: x-request-id; WS/queue/cron: transport-defined). */
@@ -137,6 +158,30 @@ type DepValue = InjectionToken<unknown> | Constructor<unknown>;
  * against the DI container and hands the result to `resolve()`.
  */
 type ResolvedDeps<D extends Record<string, DepValue>> = { [K in keyof D]: D[K] extends InjectionToken<infer T> ? T : D[K] extends Constructor<infer T> ? T : never };
+/**
+ * Keys of `T` that are declared required (i.e. not `?`-optional).
+ */
+type RequiredParamKeys<T> = { [K in keyof T]-?: {} extends Pick<T, K> ? never : K }[keyof T];
+/**
+ * Params a call site MUST supply: the required keys of `P` that
+ * `paramDefaults` (type `PD`) doesn't already provide.
+ *
+ * The `string extends keyof P` guard short-circuits the index-signature
+ * case — `P` defaults to `Record<string, never>` for the overwhelmingly
+ * common zero-params contributor, and a mapped type over `string` would
+ * otherwise report "every key is required" and break `@Foo` for every
+ * existing decorator in the wild.
+ */
+type MissingParamKeys<P, PD> = string extends keyof P ? never : Exclude<RequiredParamKeys<P>, keyof PD>;
+/**
+ * The argument type for a call site (`@Foo({...})`, `.with({...})`).
+ *
+ * `Partial<P>` when every required field has a default, so adopters keep
+ * overriding just the fields they care about. Otherwise `Partial<P>`
+ * intersected with the undefaulted required fields, making those
+ * mandatory at each call site.
+ */
+type CallSiteParams<P, PD> = [MissingParamKeys<P, PD>] extends [never] ? Partial<P> : Partial<P> & Pick<P, MissingParamKeys<P, PD> & keyof P>;
 /**
  * Spec passed to {@link defineContextDecorator}. Describes one entry in
  * the per-request contributor pipeline.
@@ -146,8 +191,11 @@ type ResolvedDeps<D extends Record<string, DepValue>> = { [K in keyof D]: D[K] e
  * @typeParam Ctx - Concrete execution-context type. Defaults to the abstract
  *                  {@link ExecutionContext}; HTTP contributors typically
  *                  default to `RequestContext` at the call site.
+ * @typeParam PD  - Inferred from `paramDefaults`. Drives which params each
+ *                  call site is required to supply — see {@link CallSiteParams}.
+ *                  Never spell this by hand.
  */
-interface ContextDecoratorSpec<K extends string = string, D extends Record<string, DepValue> = Record<string, never>, P extends Record<string, unknown> = Record<string, never>, Ctx extends ExecutionContext = ExecutionContext> {
+interface ContextDecoratorSpec<K extends string = string, D extends Record<string, DepValue> = Record<string, never>, P extends Record<string, unknown> = Record<string, never>, Ctx extends ExecutionContext = ExecutionContext, PD extends Partial<P> = Partial<P>> {
   /** ContextMeta key the resolved value is written to. */
   key: K;
   /**
@@ -186,23 +234,36 @@ interface ContextDecoratorSpec<K extends string = string, D extends Record<strin
    * validator-agnostic so projects can plug Zod / Valibot / hand-rolled
    * checks without the framework caring.
    *
-   * **Required-field caveat.** The factory call signature accepts
-   * `Partial<P>` so adopters can override only the fields they care
-   * about. If your `P` declares a *required* field that isn't in
-   * `paramDefaults`, the merged runtime value can be missing that
-   * field even though TypeScript types `params` as `P` inside
-   * `resolve()`. Mitigate by either:
+   * **Required fields are enforced at the call site.** A required field
+   * of `P` that has no entry here must be supplied wherever the
+   * decorator is applied — `@Foo({ action: 'audit:read' })`. The bare
+   * `@Foo` form and `.registration` stop type-checking for such a
+   * decorator, because neither can supply the value.
+   *
+   * This exists so nobody has to invent a meaningless default just to
+   * satisfy the type (`action: 'settings:read'` on a permission
+   * contributor every call site overrides anyway). A default that is
+   * never correct is worse than no default: forget the argument at one
+   * call site and the route silently gates on the placeholder instead
+   * of failing to compile.
    *
-   * 1. Marking the field optional in `P` and `if`-checking inside
-   *    `resolve()`, or
-   * 2. Providing a default for every required field in
-   *    `paramDefaults`.
+   * Omit this entirely for the common zero-params case — `P` defaults
+   * to `Record<string, never>`, which requires nothing.
+   */
+  paramDefaults?: PD;
+  /**
+   * Runtime mirror of the compile-time requirement above: param names
+   * that must be present after merging call-site params over
+   * `paramDefaults`. A missing one throws `TypeError` at the point of
+   * use (decoration time for `@Foo`, call time for `@Foo({...})` /
+   * `.with({...})`), naming the decorator and the field.
    *
-   * The framework can't enforce option 2 at compile time without
-   * giving up the back-compat that lets `paramDefaults` be omitted
-   * entirely for `P = Record<string, never>`.
+   * The type-level check already covers TypeScript call sites, so this
+   * is for the paths types can't reach: plain-JS adopters, `as any`
+   * escapes, and params assembled dynamically. Optional — list only
+   * fields whose absence is a correctness bug rather than a default.
    */
-  paramDefaults?: Partial<P>;
+  requiredParams?: readonly (keyof P & string)[];
   /**
    * Hook invoked when `resolve()` throws and `optional` is `false`.
    * Returning a value writes it to `ctx.set(key, …)`; returning
@@ -303,15 +364,32 @@ interface ContextDecoratorTarget {
   (target: object, propertyKey: string | symbol, descriptor?: PropertyDescriptor): void;
 }
 /**
- * The value returned by {@link defineContextDecorator}. Callable as
- * either a class or method decorator (with `paramDefaults` applied),
- * as a factory (`@Foo({...})` returning a per-site decorator), or
- * via `.with(params)` for non-decorator registration sites (module
- * hooks, adapter hooks, bootstrap option). `.registration` exposes
- * the underlying frozen {@link ContributorRegistration} for the
- * default-params case.
+ * The value returned by {@link defineContextDecorator}.
+ *
+ * Resolves to one of two shapes depending on whether every required
+ * field of `P` has a `paramDefaults` entry:
+ *
+ * - {@link ContextDecoratorWithDefaults} — the classic shape. Usable
+ *   bare (`@Foo`), as a factory (`@Foo({...})`), via `.with(params)`,
+ *   and via `.registration`.
+ * - {@link ContextDecoratorRequiringParams} — when `P` has required
+ *   fields `paramDefaults` doesn't cover. Only the factory and
+ *   `.with(params)` forms exist, because the others have no way to
+ *   supply the missing values. Applying such a decorator bare is a
+ *   compile error rather than a silent `undefined` at request time.
+ *
+ * `PD` is inferred from the spec's `paramDefaults`; the default here
+ * (`Partial<P>`) keeps hand-written `ContextDecorator<K, D, P>`
+ * annotations resolving to the permissive shape as before.
  */
-interface ContextDecorator<K extends string = string, D extends Record<string, DepValue> = Record<string, never>, P extends Record<string, unknown> = Record<string, never>, Ctx extends ExecutionContext = ExecutionContext> {
+type ContextDecorator<K extends string = string, D extends Record<string, DepValue> = Record<string, never>, P extends Record<string, unknown> = Record<string, never>, Ctx extends ExecutionContext = ExecutionContext, PD = Partial<P>> = [MissingParamKeys<P, PD>] extends [never] ? ContextDecoratorWithDefaults<K, D, P, Ctx> : ContextDecoratorRequiringParams<K, D, P, Ctx, PD>;
+/**
+ * Decorator whose params are fully defaulted (or which takes none).
+ * Callable as a class or method decorator directly, as a factory, or
+ * via `.with(params)` / `.registration` at non-decorator registration
+ * sites.
+ */
+interface ContextDecoratorWithDefaults<K extends string = string, D extends Record<string, DepValue> = Record<string, never>, P extends Record<string, unknown> = Record<string, never>, Ctx extends ExecutionContext = ExecutionContext> {
   /**
    * Class decorator usage with `paramDefaults` — `@Foo class C {}`.
    * The class constructor is a `Function`, so this overload only
@@ -372,6 +450,49 @@ interface ContextDecorator<K extends string = string, D extends Record<string, D
     readonly registration: ContributorRegistration<K, D, Ctx>;
   };
 }
+/**
+ * Decorator with at least one required param that `paramDefaults`
+ * doesn't cover. Deliberately narrower than
+ * {@link ContextDecoratorWithDefaults}: the bare `@Foo` form, the
+ * zero-arg `@Foo()` form, and the `.registration` accessor are all
+ * absent, because none of them can supply the missing value.
+ *
+ * ```ts
+ * const OperatorPerm = defineContextDecorator.withParams<{ action: string }>()({
+ *   key: 'operatorPerm',
+ *   resolve: (ctx, _deps, { action }) => check(ctx, action),
+ * })
+ *
+ * class Ops {
+ *   @OperatorPerm                     // ✗ compile error — `action` missing
+ *   @Get('/a')
+ *   a(ctx: RequestContext) {}
+ *
+ *   @OperatorPerm({ action: 'read' }) // ✓
+ *   @Get('/b')
+ *   b(ctx: RequestContext) {}
+ * }
+ * ```
+ *
+ * If you want the bare form back, give `action` a default in
+ * `paramDefaults` — but only when the default is genuinely correct for
+ * an undecorated route, which for a permission string it usually isn't.
+ */
+interface ContextDecoratorRequiringParams<K extends string = string, D extends Record<string, DepValue> = Record<string, never>, P extends Record<string, unknown> = Record<string, never>, Ctx extends ExecutionContext = ExecutionContext, PD = Partial<P>> {
+  /**
+   * Factory usage — the only decorator form available here. The
+   * argument type carries every required field `paramDefaults` didn't
+   * provide, so omitting one is a compile error at this call site.
+   */
+  (params: CallSiteParams<P, PD>): ContextDecoratorTarget;
+  /**
+   * Build a registration for non-decorator registration sites. Same
+   * required-field rule as the factory form.
+   */
+  with(params: CallSiteParams<P, PD>): {
+    readonly registration: ContributorRegistration<K, D, Ctx>;
+  };
+}
 /**
  * Curried params-first helper for {@link defineContextDecorator}.
  *
@@ -402,7 +523,7 @@ interface ContextDecorator<K extends string = string, D extends Record<string, D
  * positional form when there are no params (the common case).
  */
 interface DefineContextDecoratorWithParams<P extends Record<string, unknown>> {
-  <K extends string, D extends Record<string, DepValue> = Record<string, never>, Ctx extends ExecutionContext = ExecutionContext>(spec: ContextDecoratorSpec<K, D, P, Ctx>): ContextDecorator<K, D, P, Ctx>;
+  <K extends string, D extends Record<string, DepValue> = Record<string, never>, Ctx extends ExecutionContext = ExecutionContext, PD extends Partial<P> = Record<never, never>>(spec: ContextDecoratorSpec<K, D, P, Ctx, PD>): ContextDecorator<K, D, P, Ctx, PD>;
 }
 /**
  * The public shape of {@link defineContextDecorator}. Combines the
@@ -411,7 +532,7 @@ interface DefineContextDecoratorWithParams<P extends Record<string, unknown>> {
  * parameterised case.
  */
 interface DefineContextDecoratorFn {
-  <K extends string, D extends Record<string, DepValue> = Record<string, never>, P extends Record<string, unknown> = Record<string, never>, Ctx extends ExecutionContext = ExecutionContext>(spec: ContextDecoratorSpec<K, D, P, Ctx>): ContextDecorator<K, D, P, Ctx>;
+  <K extends string, D extends Record<string, DepValue> = Record<string, never>, P extends Record<string, unknown> = Record<string, never>, Ctx extends ExecutionContext = ExecutionContext, PD extends Partial<P> = Record<never, never>>(spec: ContextDecoratorSpec<K, D, P, Ctx, PD>): ContextDecorator<K, D, P, Ctx, PD>;
   /**
    * Curried entry point. Spell only the per-call params shape `P`;
    * `K`, `D`, and `Ctx` are inferred from the spec passed to the
@@ -522,4 +643,4 @@ type AppModuleClass = new () => AppModule;
 type AppModuleEntry = AppModuleClass | AppModule;
 //#endregion
 export { ExecutionContext as _, AnyContributorRegistration as a, ContextDecoratorTarget as c, ContributorRegistrations as d, DepValue as f, ContextMeta as g, ContextKeys as h, ModuleRoutes as i, ContextMetaKey as l, defineContextDecorator as m, AppModuleClass as n, ContextDecorator as o, ResolvedDeps as p, AppModuleEntry as r, ContextDecoratorSpec as s, AppModule as t, ContributorRegistration as u, MetaValue as v };
-//# sourceMappingURL=app-module-BwYtACD6.d.mts.map
+//# sourceMappingURL=app-module-BSpHKlhE.d.mts.map

package/dist/app-module-BSpHKlhE.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-module-BSpHKlhE.d.mts","names":[],"sources":["../src/core/execution-context.ts","../src/core/context-decorator.ts","../src/core/app-module.ts"],"mappings":"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"}

package/dist/{application-Bo3jSfmL.d.mts → application-Bzdzl5wP.d.mts}

@@ -1,7 +1,7 @@
 
 import { t as Container } from "./container-iED1swkd.mjs";
-import { d as ContributorRegistrations, r as AppModuleEntry } from "./app-module-BwYtACD6.mjs";
-import { Ft as KickPlugin, It as ModuleRegistry, f as HttpRuntime, r as AppAdapter, s as ActiveRuntime, y as RuntimeCapabilities } from "./adapter-BjxEv8oW.mjs";
+import { d as ContributorRegistrations, r as AppModuleEntry } from "./app-module-BSpHKlhE.mjs";
+import { It as KickPlugin, Lt as ModuleRegistry, f as HttpRuntime, r as AppAdapter, s as ActiveRuntime, y as RuntimeCapabilities } from "./adapter-CEt1MEdF.mjs";
 import http from "node:http";
 import { Express, RequestHandler } from "express";
 
@@ -439,4 +439,4 @@ declare class Application {
 }
 //#endregion
 export { ApplicationOptions as n, MiddlewareEntry as r, Application as t };
-//# sourceMappingURL=application-Bo3jSfmL.d.mts.map
+//# sourceMappingURL=application-Bzdzl5wP.d.mts.map

package/dist/{application-Bo3jSfmL.d.mts.map → application-Bzdzl5wP.d.mts.map}

@@ -1 +1 @@
-{"version":3,"file":"application-Bo3jSfmL.d.mts","names":[],"sources":["../src/http/application.ts"],"mappings":";;;;;;;;;;;AAwDA;KAAY,eAAA,GAAkB,cAAA;EAAmB,IAAA;EAAc,OAAA,EAAS,cAAc;AAAA;AAAA,UAErE,kBAAA;EAF8C;;;AAAuB;AAEtF;;;;;;EAWE,OAAA,EAAS,cAAA;EAwDI;;;;;;;;;;;;;;;;;EArCb,KAAA,EAAO,QAAA,EAAU,cAAA;EAqCjB;EAnCA,QAAA,GAAW,UAAA;EAsCX;EApCA,IAAA;EA0DA;EAxDA,SAAA;EA4EA;EA1EA,cAAA;EAkHA;;;;;;;;;;;;;;;;;;;;;EA3FA,WAAA,GAAc,eAAA;EA8LN;AAAA;AAQV;;;EAhME,UAAA,GAAa,eAAA;EAuRG;EApRhB,OAAA,GAAU,UAAA;EAsS6B;;;;;;;;;;;;;;;;;;;;EAhRvC,YAAA,GAAe,wBAAA;EA+KE;;;;;;;;;;;;;;;;;;EA3JjB,YAAA;EA4PkC;;;;;;;;;;;;;;;;;;;;;;;;;EAjOlC,YAAA;EA42BA;;;;;;;;;;;EA/1BA,OAAA,GAAU,WAAA;EAo8BF;EAj8BR,UAAA,iCAA2C,EAAA,UAAY,QAAA;EA89B/C;EA59BR,SAAA;EA2/BQ;;AAAoB;;;;;EAn/B5B,aAAA;;;;;EAKA,cAAA;;;;;EAKA,eAAA;;;;;;;;;;;;;;;;;;;EAoBA,OAAA;IAAsB,OAAA;EAAA;;;;;;;;;;;;;;;;EAiBtB,UAAA,IAAc,GAAA,OAAU,GAAA,OAAU,IAAA;;;;;;;;;;;;;;;;;EAkBlC,OAAA,IAAW,GAAA,OAAU,GAAA,OAAU,GAAA,OAAU,IAAA;;;;;;;;;;;;;;;;;;EAmBzC,QAAA;6DAEE,MAAA;EAAA;AAAA;;;;;cAQS,WAAA;EAAA,iBAoCkB,OAAA;EAAA,QAnCrB,GAAA;;mBAES,OAAA;EAAA,QACT,SAAA;EAAA,QACA,UAAA;EAAA,iBACS,QAAA;EAAA,iBAEA,OAAA;;;;;;;;;;;;;UAcT,mBAAA;;UAMA,iBAAA;;UAEA,SAAA;;UAEA,kBAAA;;UAEA,eAAA;EAER,WAAA,CAA6B,OAAA,EAAS,kBAAA;;MAyClC,UAAA;;MAKA,gBAAA;;EAKJ,YAAA,IAAgB,SAAA;;;;;;;;;;;;;;;EAkBhB,MAAA,CAAO,GAAA,EAAK,IAAA,CAAK,eAAA,EAAiB,GAAA,EAAK,IAAA,CAAK,cAAA,EAAgB,IAAA,IAAQ,GAAA;;;;;;;;;;;;;;;UAuB5D,UAAA;;;;;;UAiBA,WAAA;;UA0BM,QAAA;EAeR,KAAA,IAAS,OAAA;;EA0UT,YAAA,IAAgB,OAAA;;;;;;;;;;EAahB,KAAA,IAAS,OAAA;;EA0ET,OAAA,IAAW,OAAA;;;;;;;;;;;EA8CX,QAAA,IAAY,OAAA;;;;;;;EA6ElB,aAAA,IAAiB,aAAA;;;;;;;;EAWjB,gBAAA;IAAsB,IAAA;IAAc,YAAA,EAAc,mBAAA;EAAA;;EAKlD,aAAA,IAAiB,OAAA;;EAKjB,WAAA,IAAe,UAAA;;;;;;EASf,UAAA,aAAuB,UAAA;;;;;;;;;;;;;;;;;;;EAsBvB,eAAA,IAAmB,aAAA;IACjB,GAAA;IACA,MAAA;IACA,KAAA;IACA,SAAA;EAAA;EA6CF,aAAA,IAAiB,IAAA,CAAK,MAAA;;;;;;;;;;;;;;UAmBd,2BAAA;EAAA,QAWA,wBAAA;EAAA,QAmBA,mBAAA;EAAA,QAUA,oBAAA;;UASA,yBAAA;;UAsBA,oBAAA;AAAA"}
+{"version":3,"file":"application-Bzdzl5wP.d.mts","names":[],"sources":["../src/http/application.ts"],"mappings":";;;;;;;;;;;AAwDA;KAAY,eAAA,GAAkB,cAAA;EAAmB,IAAA;EAAc,OAAA,EAAS,cAAc;AAAA;AAAA,UAErE,kBAAA;EAF8C;;;AAAuB;AAEtF;;;;;;EAWE,OAAA,EAAS,cAAA;EAwDI;;;;;;;;;;;;;;;;;EArCb,KAAA,EAAO,QAAA,EAAU,cAAA;EAqCjB;EAnCA,QAAA,GAAW,UAAA;EAsCX;EApCA,IAAA;EA0DA;EAxDA,SAAA;EA4EA;EA1EA,cAAA;EAkHA;;;;;;;;;;;;;;;;;;;;;EA3FA,WAAA,GAAc,eAAA;EA8LN;AAAA;AAQV;;;EAhME,UAAA,GAAa,eAAA;EAuRG;EApRhB,OAAA,GAAU,UAAA;EAsS6B;;;;;;;;;;;;;;;;;;;;EAhRvC,YAAA,GAAe,wBAAA;EA+KE;;;;;;;;;;;;;;;;;;EA3JjB,YAAA;EA4PkC;;;;;;;;;;;;;;;;;;;;;;;;;EAjOlC,YAAA;EA42BA;;;;;;;;;;;EA/1BA,OAAA,GAAU,WAAA;EAo8BF;EAj8BR,UAAA,iCAA2C,EAAA,UAAY,QAAA;EA89B/C;EA59BR,SAAA;EA2/BQ;;AAAoB;;;;;EAn/B5B,aAAA;;;;;EAKA,cAAA;;;;;EAKA,eAAA;;;;;;;;;;;;;;;;;;;EAoBA,OAAA;IAAsB,OAAA;EAAA;;;;;;;;;;;;;;;;EAiBtB,UAAA,IAAc,GAAA,OAAU,GAAA,OAAU,IAAA;;;;;;;;;;;;;;;;;EAkBlC,OAAA,IAAW,GAAA,OAAU,GAAA,OAAU,GAAA,OAAU,IAAA;;;;;;;;;;;;;;;;;;EAmBzC,QAAA;6DAEE,MAAA;EAAA;AAAA;;;;;cAQS,WAAA;EAAA,iBAoCkB,OAAA;EAAA,QAnCrB,GAAA;;mBAES,OAAA;EAAA,QACT,SAAA;EAAA,QACA,UAAA;EAAA,iBACS,QAAA;EAAA,iBAEA,OAAA;;;;;;;;;;;;;UAcT,mBAAA;;UAMA,iBAAA;;UAEA,SAAA;;UAEA,kBAAA;;UAEA,eAAA;EAER,WAAA,CAA6B,OAAA,EAAS,kBAAA;;MAyClC,UAAA;;MAKA,gBAAA;;EAKJ,YAAA,IAAgB,SAAA;;;;;;;;;;;;;;;EAkBhB,MAAA,CAAO,GAAA,EAAK,IAAA,CAAK,eAAA,EAAiB,GAAA,EAAK,IAAA,CAAK,cAAA,EAAgB,IAAA,IAAQ,GAAA;;;;;;;;;;;;;;;UAuB5D,UAAA;;;;;;UAiBA,WAAA;;UA0BM,QAAA;EAeR,KAAA,IAAS,OAAA;;EA0UT,YAAA,IAAgB,OAAA;;;;;;;;;;EAahB,KAAA,IAAS,OAAA;;EA0ET,OAAA,IAAW,OAAA;;;;;;;;;;;EA8CX,QAAA,IAAY,OAAA;;;;;;;EA6ElB,aAAA,IAAiB,aAAA;;;;;;;;EAWjB,gBAAA;IAAsB,IAAA;IAAc,YAAA,EAAc,mBAAA;EAAA;;EAKlD,aAAA,IAAiB,OAAA;;EAKjB,WAAA,IAAe,UAAA;;;;;;EASf,UAAA,aAAuB,UAAA;;;;;;;;;;;;;;;;;;;EAsBvB,eAAA,IAAmB,aAAA;IACjB,GAAA;IACA,MAAA;IACA,KAAA;IACA,SAAA;EAAA;EA6CF,aAAA,IAAiB,IAAA,CAAK,MAAA;;;;;;;;;;;;;;UAmBd,2BAAA;EAAA,QAWA,wBAAA;EAAA,QAmBA,mBAAA;EAAA,QAUA,oBAAA;;UASA,yBAAA;;UAsBA,oBAAA;AAAA"}

package/dist/{application-TiHVcGRL.mjs → application-C-r79XqD.mjs}

@@ -1,5 +1,5 @@
 /**
- * @forinda/kickjs v6.4.0
+ * @forinda/kickjs v6.5.0
  *
  * Copyright (c) Felix Orinda
  *
@@ -8,5 +8,5 @@
  *
  * @license MIT
  */
-import{METADATA}from"./core/interfaces.mjs";import{n as tokenName,s as moduleRouteMissingControllerError,t as Container}from"./container-Da9BLMHy.mjs";import{Logger,createLogger}from"./core/logger.mjs";import{t as getClassMeta}from"./metadata-BhKXlN2F.mjs";import{g as mountSort}from"./core-CQ6u5kOq.mjs";import{t as MutableModuleRegistry}from"./module-registry-CvP9mee-.mjs";import{i as runDisposables,n as drainDisposables,r as registerDisposable,t as disposeAll}from"./disposables-rPSyh69r.mjs";import{joinPaths,normalizePath}from"./core/path.mjs";import{requestId}from"./http/middleware/request-id.mjs";import{errorHandler,notFoundHandler}from"./http/middleware/error-handler.mjs";import{i as requestStore,t as RequestContext}from"./context-Cs0939u1.mjs";import{o as isRequestScopeMiddleware,s as requestScopeMiddleware,t as applyHandlerResult}from"./reply-edT8RGBB.mjs";import{_setExternalContributorSources,assertRouteUnique,buildRouteTable}from"./http/router-builder.mjs";import{validate}from"./http/middleware/validate.mjs";import{buildUploadMiddleware}from"./http/middleware/upload.mjs";import http from"node:http";import express,{Router}from"express";function materializeRouter(entries){let router=Router();for(let entry of entries){let method=entry.method.toLowerCase(),handlers=[];entry.meta.validation&&handlers.push(validate(entry.meta.validation)),entry.meta.upload&&handlers.push(buildUploadMiddleware(entry.meta.upload));for(let mw of entry.middlewares)handlers.push((req,res,next)=>{let ctx=new RequestContext(req,res,next);Promise.resolve(mw(ctx,next)).catch(next)});if(entry.contributorRunner){let run=entry.contributorRunner;handlers.push(async(req,res,next)=>{let ctx=new RequestContext(req,res,next);try{await run(ctx),next()}catch(err){next(err)}})}handlers.push(async(req,res,next)=>{let ctx=new RequestContext(req,res,next);try{let result=await entry.handler(ctx);res.headersSent||applyHandlerResult(ctx,result)}catch(err){next(err)}}),router[method](entry.path,...handlers)}return router}function buildRoutes(controllerClass,options={}){return materializeRouter(buildRouteTable(controllerClass,options))}function expressRuntime(){return{name:`express`,createApp(options={}){let app=express();return app.disable(`x-powered-by`),app.set(`trust proxy`,options.trustProxy??!1),app},nodeHandler(app){return(req,res,next)=>{next?app(req,res,next):app(req,res)}},mountRoutes(app,table){for(let{mountPath,routes}of table)app.use(mountPath,materializeRouter(routes))},useConnect(app,mw,opts={}){opts.path===void 0?app.use(mw):app.use(opts.path,mw)},serveStatic(app,prefix,dir){app.use(prefix,express.static(dir))},setNotFound(app,mw){app.use(mw)},setErrorHandler(app,mw){app.use(mw)},capabilities:{render:!0,uploads:!0,connectMiddleware:!0,nativeBodyParsing:!1}}}const log=createLogger(`Application`);var Application=class{options;app;runtime;container;httpServer=null;adapters;plugins;_moduleContributors=[];_inFlightRequests=0;_draining=!1;_shutdownInitiated=!1;_drainResolvers=[];constructor(options){this.options=options,this.runtime=options.runtime??expressRuntime(),this.app=this.runtime.createApp({trustProxy:options.trustProxy}),this.container=Container.getInstance(),this.plugins=mountSort(options.plugins??[],`plugin`);let allAdapters=[...this.plugins.flatMap(p=>p.adapters?.()??[]),...options.adapters??[]],anonAdapterCount=0,namedAdapters=allAdapters.map(adapter=>{if(!adapter.name){let ctorName=adapter.constructor?.name,fallback=ctorName&&ctorName!==`Object`?ctorName:`AnonymousAdapter#${anonAdapterCount++}`;return Object.assign(adapter,{name:fallback})}return adapter});this.adapters=mountSort(namedAdapters,`adapter`),Container._requestStoreProvider=()=>requestStore.getStore()??null}get isDraining(){return this._draining}get inFlightRequests(){return this._inFlightRequests}getContainer(){return this.container}handle(req,res,next){let handler=this.runtime.nodeHandler(this.app);next?handler(req,res,next):handler(req,res)}adapterCtx(server){let env=process.env.NODE_ENV??`development`;return{http:this.adapterHttp(),app:this.app,container:this.container,server,env,isProduction:env===`production`}}adapterHttp(){return{route:(method,path,handler)=>{let entry={method,path,middlewares:[],contributorRunner:null,handler,meta:{}};this.runtime.mountRoutes(this.app,[{mountPath:`/`,routes:[entry]}])},mount:(prefix,routes)=>{this.runtime.mountRoutes(this.app,[{mountPath:prefix,routes}])},serveStatic:(prefix,dir)=>{this.runtime.serveStatic(this.app,prefix,dir)},use:(mw,opts)=>{this.runtime.useConnect(this.app,mw,opts)}}}async callHook(hook,ctx){if(hook)try{let result=hook(ctx);result&&typeof result.then==`function`&&await result}catch(err){log.error(err,`Adapter hook failed`)}}async setup(){log.debug(`Bootstrapping application...`),this._moduleContributors=[];let adapterMw=this.collectAdapterMiddleware();this.app.__kickApp=this;let ctx=this.adapterCtx();for(let adapter of this.adapters)await this.callHook(adapter.beforeMount?.bind(adapter),ctx);this.runtime.useConnect(this.app,this.requestTrackingMiddleware()),this.mountHealthEndpoints(),this.shouldAutoMountRequestScope()&&this.runtime.useConnect(this.app,requestScopeMiddleware()),this.mountMiddlewareList(adapterMw.beforeGlobal);for(let plugin of this.plugins)plugin.register?.(this.container);for(let plugin of this.plugins)try{let mw=plugin.middleware?.()??[];for(let handler of mw)this.runtime.useConnect(this.app,handler)}catch(err){log.error(err,`Plugin middleware failed: ${plugin.name??`unknown`}`)}if(this.options.security?.helmet!==!1)try{let{helmet:helmetFn}=await import(`./http/middleware/helmet.mjs`);this.runtime.useConnect(this.app,helmetFn())}catch{}let userMiddlewares=this.options.middlewares??this.options.middleware;if(userMiddlewares)for(let entry of userMiddlewares)this.mountMiddlewareEntry(entry);else this.runtime.useConnect(this.app,requestId()),this.runtime.capabilities.nativeBodyParsing||this.runtime.useConnect(this.app,express.json({limit:this.options.jsonLimit??`1mb`}));this.mountMiddlewareList(adapterMw.afterGlobal);let moduleRegistry=new MutableModuleRegistry;for(let plugin of this.plugins){for(let m of plugin.modules?.()??[])moduleRegistry.mount(m);plugin.setup?.(moduleRegistry)}for(let m of this.options.modules)moduleRegistry.mount(m);this.options.setup?.(moduleRegistry);let modules=moduleRegistry.entries.map(entry=>{let mod=typeof entry==`function`?new entry:entry;return mod.register?.(this.container),mod});this.container.bootstrap(),this.container.has(Logger)||this.container.registerInstance(Logger,new Logger),this.mountMiddlewareList(adapterMw.beforeRoutes);let apiPrefix=this.options.apiPrefix??`/api`,defaultVersion=this.options.defaultVersion??1,shouldLogRoutes=this.options.logRouteTable??this.options.logRoutesTable??!1,mountedRoutes=[],adapterSources=[];for(let adapter of this.adapters){let adapterContribs=adapter.contributors?.()??[],adapterLabel=adapter.name??adapter.constructor.name??`adapter`;for(let registration of adapterContribs)adapterSources.push({source:`adapter`,registration,label:adapterLabel})}for(let plugin of this.plugins){let pluginContribs=plugin.contributors?.()??[],pluginLabel=plugin.name??plugin.constructor?.name??`plugin`;for(let registration of pluginContribs)adapterSources.push({source:`adapter`,registration,label:pluginLabel})}let globalSources=(this.options.contributors??[]).map(registration=>({source:`global`,registration,label:`bootstrap`}));this._moduleContributors=[];let seenRoutes=new Map;for(let mod of modules){let declaredName=mod.name,ctorName=mod.constructor?.name,moduleLabel=typeof declaredName==`string`&&declaredName.length>0?declaredName:ctorName&&ctorName!==`Object`?ctorName:`module`,moduleSources=(mod.contributors?.()??[]).map(registration=>({source:`module`,registration,label:moduleLabel}));for(let src of moduleSources)this._moduleContributors.push({registration:src.registration,label:moduleLabel});_setExternalContributorSources([...moduleSources,...adapterSources,...globalSources]);try{let result=mod.routes();if(!result)continue;let routeSets=Array.isArray(result)?result:[result];for(let route of routeSets){let mountPath=`${apiPrefix}/v${route.version??defaultVersion}${normalizePath(route.path)}`;if(route.router)this.runtime.useConnect(this.app,route.router,{path:mountPath});else if(route.controller){let routeTable=buildRouteTable(route.controller),ctrl=route.controller.name??`controller`;for(let entry of routeTable){let owner=`${ctrl}.${String(entry.meta.handlerName??`?`)}`;assertRouteUnique(seenRoutes,entry.method,joinPaths(mountPath,entry.path),owner)}this.runtime.mountRoutes(this.app,[{mountPath,routes:routeTable}])}else throw moduleRouteMissingControllerError(mountPath);if(route.controller){for(let adapter of this.adapters)try{adapter.onRouteMount?.(route.controller,mountPath)}catch(err){log.error(err,`adapter.onRouteMount() failed for ${mountPath}`)}shouldLogRoutes&&mountedRoutes.push({controller:route.controller,mountPath})}}}finally{_setExternalContributorSources([])}}if(shouldLogRoutes&&mountedRoutes.length>0){let methodOrder=[`GET`,`POST`,`PUT`,`PATCH`,`DELETE`,`HEAD`,`OPTIONS`],methodRank=m=>{let i=methodOrder.indexOf(m);return i===-1?99:i},totalRoutes=0;log.info(`Routes:`);for(let{controller,mountPath}of mountedRoutes){let defs=getClassMeta(METADATA.ROUTES,controller,[]);if(defs.length===0)continue;let counts={};for(let def of defs){let m=def.method.toUpperCase();counts[m]=(counts[m]||0)+1}totalRoutes+=defs.length;let methods=Object.entries(counts).toSorted(([a],[b])=>methodRank(a)-methodRank(b)).map(([m,n])=>`${n} ${m}`).join(`, `),name=controller.name||`Controller`;log.info(`  ${name.padEnd(30)} ${mountPath.padEnd(25)} ${defs.length} routes (${methods})`)}log.info(`  Total: ${totalRoutes} routes`)}this.mountMiddlewareList(adapterMw.afterRoutes);for(let adapter of this.adapters)await this.callHook(adapter.beforeStart?.bind(adapter),ctx);this.runtime.setNotFound(this.app,this.options.onNotFound??notFoundHandler()),this.runtime.setErrorHandler(this.app,this.options.onError??errorHandler())}async registerOnly(){await this.setup()}async start(){await this.setup();let g=globalThis;if(g.__kickjs_httpServer){this.httpServer=g.__kickjs_httpServer,log.debug(`Attached to Vite dev server`),g.__kickjs_app_shutdown=()=>this.shutdown();for(let adapter of this.adapters){let ctx=this.adapterCtx(this.httpServer);await this.callHook(adapter.afterStart?.bind(adapter),ctx)}for(let plugin of this.plugins)await plugin.onReady?.(this.container);return}let port=this.options.port??parseInt(process.env.PORT||`3000`,10);this.httpServer=http.createServer(this.runtime.nodeHandler(this.app)),this.httpServer.on(`error`,err=>{throw err.code===`EADDRINUSE`&&(log.error(`Port ${port} is already in use. Kill the existing process or use a different port:\n  PORT=${port+1} kick dev\n  lsof -i :${port}   # find what's using it\n  kill <PID>          # stop it`),process.exit(1)),err}),await new Promise((resolve,reject)=>{this.httpServer.listen(port,async()=>{try{log.info(`Server running on http://localhost:${port}`);for(let adapter of this.adapters){let afterCtx=this.adapterCtx(this.httpServer);await this.callHook(adapter.afterStart?.bind(adapter),afterCtx)}for(let plugin of this.plugins)await plugin.onReady?.(this.container);resolve()}catch(err){reject(err)}})})}async rebuild(){let prevApp=this.app,prevContainer=this.container,staleDisposables=drainDisposables();try{Container.reset(),this.container=Container.getInstance(),this.app=this.runtime.createApp({trustProxy:this.options.trustProxy}),await this.setup()}catch(err){log.error(err,`HMR rebuild failed, keeping previous app`),await runDisposables(drainDisposables());for(let d of staleDisposables)registerDisposable(d);this.app=prevApp,this.container=prevContainer;return}await runDisposables(staleDisposables),this.httpServer&&(this.httpServer.removeAllListeners(`request`),this.httpServer.on(`request`,this.runtime.nodeHandler(this.app)),log.debug(`HMR: app rebuilt and swapped`))}async shutdown(){if(this._shutdownInitiated){log.debug(`Shutdown already in progress, skipping duplicate call`);return}this._shutdownInitiated=!0,this._draining=!0,log.debug(`Shutting down — draining in-flight requests...`);let timeoutMs=this.options.shutdownTimeout??3e4,timer,forceExitPromise=timeoutMs>0?new Promise(resolve=>{timer=setTimeout(()=>resolve(`timeout`),timeoutMs),timer.unref()}):new Promise(()=>{});try{if(this.httpServer&&this.httpServer.close(()=>{}),this._inFlightRequests>0){log.debug(`Waiting for ${this._inFlightRequests} in-flight request(s) to complete...`);let drainPromise=new Promise(resolve=>{this._drainResolvers.push(()=>resolve(`drained`))});await Promise.race([drainPromise,forceExitPromise])===`timeout`?log.warn(`Shutdown timeout (${timeoutMs}ms) reached with ${this._inFlightRequests} request(s) still in-flight, forcing shutdown`):log.debug(`All in-flight requests completed`)}let results=await Promise.allSettled([...this.plugins.map(plugin=>Promise.resolve(plugin.shutdown?.())),...this.adapters.map(adapter=>Promise.resolve(adapter.shutdown?.()))]);for(let result of results)result.status===`rejected`&&log.error({err:result.reason},`Adapter shutdown failed`);await disposeAll(),this.container.flushChanges()}finally{timer&&clearTimeout(timer)}}getRuntimeApp(){return this.app}getActiveRuntime(){return{name:this.runtime.name,capabilities:this.runtime.capabilities}}getExpressApp(){return this.app}getAdapters(){return this.adapters}getPlugins(){return this.plugins}getContributors(){let out=[],ingest=(list,source,label)=>{if(list)for(let reg of list){let r=reg;if(r.key===void 0||r.key===null)continue;let key=typeof r.key==`string`?r.key:tokenName(r.key);out.push({key,source,label,dependsOn:Array.isArray(r.dependsOn)?r.dependsOn:[]})}};for(let adapter of this.adapters)ingest(adapter.contributors?.(),`adapter`,adapter.name??`adapter`);for(let plugin of this.plugins)ingest(plugin.contributors?.(),`plugin`,plugin.name??`plugin`);for(let{registration,label}of this._moduleContributors)ingest([registration],`module`,label);return ingest(this.options.contributors,`global`,`bootstrap`),out}getHttpServer(){return this.httpServer}shouldAutoMountRequestScope(){if(this.options.contextStore===`manual`)return!1;let userEntries=this.options.middlewares??this.options.middleware??[];for(let entry of userEntries)if(isRequestScopeMiddleware(typeof entry==`function`?entry:entry.handler))return!1;return!0}collectAdapterMiddleware(){let result={beforeGlobal:[],afterGlobal:[],beforeRoutes:[],afterRoutes:[]};for(let adapter of this.adapters){let entries=adapter.middleware?.()??[];for(let entry of entries)result[entry.phase??`afterGlobal`].push(entry)}return result}mountMiddlewareList(entries){for(let entry of entries){if(entry.path===void 0){this.runtime.useConnect(this.app,entry.handler);continue}this.runtime.useConnect(this.app,entry.handler,{path:entry.path})}}mountMiddlewareEntry(entry){typeof entry==`function`?this.runtime.useConnect(this.app,entry):this.runtime.useConnect(this.app,entry.handler,{path:entry.path})}requestTrackingMiddleware(){return(_req,res,next)=>{this._inFlightRequests++;let onFinish=()=>{if(res.removeListener(`finish`,onFinish),res.removeListener(`close`,onFinish),this._inFlightRequests--,this._draining&&this._inFlightRequests===0){for(let resolve of this._drainResolvers)resolve();this._drainResolvers=[]}};res.on(`finish`,onFinish),res.on(`close`,onFinish),next()}}mountHealthEndpoints(){let http=this.adapterHttp();http.route(`GET`,`/health/live`,ctx=>{this._draining?ctx.res.status(503).json({status:`draining`,uptime:process.uptime()}):ctx.json({status:`ok`,uptime:process.uptime()})}),http.route(`GET`,`/health/ready`,async ctx=>{if(this._draining){ctx.res.status(503).json({status:`draining`,checks:[]});return}let adaptersWithHealth=this.adapters.filter(a=>a.onHealthCheck),results=(await Promise.allSettled(adaptersWithHealth.map(a=>a.onHealthCheck()))).map((c,i)=>c.status===`fulfilled`?c.value:{name:adaptersWithHealth[i].name??`unknown`,status:`down`}),healthy=results.every(r=>r.status===`up`);ctx.res.status(healthy?200:503).json({status:healthy?`ready`:`degraded`,checks:results})})}};export{materializeRouter as i,buildRoutes as n,expressRuntime as r,Application as t};
-//# sourceMappingURL=application-TiHVcGRL.mjs.map
+import{METADATA}from"./core/interfaces.mjs";import{n as tokenName,s as moduleRouteMissingControllerError,t as Container}from"./container-CBaL5lus.mjs";import{Logger,createLogger}from"./core/logger.mjs";import{t as getClassMeta}from"./metadata-CUDfhy4e.mjs";import{g as mountSort}from"./core-TDR0XGzO.mjs";import{t as MutableModuleRegistry}from"./module-registry-Mv5FqVlq.mjs";import{i as runDisposables,n as drainDisposables,r as registerDisposable,t as disposeAll}from"./disposables-mnjJuaVx.mjs";import{joinPaths,normalizePath}from"./core/path.mjs";import{requestId}from"./http/middleware/request-id.mjs";import{errorHandler,notFoundHandler}from"./http/middleware/error-handler.mjs";import{i as requestStore,t as RequestContext}from"./context-BS5o1IuU.mjs";import{o as isRequestScopeMiddleware,s as requestScopeMiddleware,t as applyHandlerResult}from"./reply-BMBvs-FB.mjs";import{_setExternalContributorSources,assertRouteUnique,buildRouteTable}from"./http/router-builder.mjs";import{validate}from"./http/middleware/validate.mjs";import{buildUploadMiddleware}from"./http/middleware/upload.mjs";import http from"node:http";import express,{Router}from"express";function materializeRouter(entries){let router=Router();for(let entry of entries){let method=entry.method.toLowerCase(),handlers=[];entry.meta.validation&&handlers.push(validate(entry.meta.validation)),entry.meta.upload&&handlers.push(buildUploadMiddleware(entry.meta.upload));for(let mw of entry.middlewares)handlers.push((req,res,next)=>{let ctx=new RequestContext(req,res,next);Promise.resolve(mw(ctx,next)).catch(next)});if(entry.contributorRunner){let run=entry.contributorRunner;handlers.push(async(req,res,next)=>{let ctx=new RequestContext(req,res,next);try{await run(ctx),next()}catch(err){next(err)}})}handlers.push(async(req,res,next)=>{let ctx=new RequestContext(req,res,next);try{let result=await entry.handler(ctx);res.headersSent||applyHandlerResult(ctx,result)}catch(err){next(err)}}),router[method](entry.path,...handlers)}return router}function buildRoutes(controllerClass,options={}){return materializeRouter(buildRouteTable(controllerClass,options))}function expressRuntime(){return{name:`express`,createApp(options={}){let app=express();return app.disable(`x-powered-by`),app.set(`trust proxy`,options.trustProxy??!1),app},nodeHandler(app){return(req,res,next)=>{next?app(req,res,next):app(req,res)}},mountRoutes(app,table){for(let{mountPath,routes}of table)app.use(mountPath,materializeRouter(routes))},useConnect(app,mw,opts={}){opts.path===void 0?app.use(mw):app.use(opts.path,mw)},serveStatic(app,prefix,dir){app.use(prefix,express.static(dir))},setNotFound(app,mw){app.use(mw)},setErrorHandler(app,mw){app.use(mw)},capabilities:{render:!0,uploads:!0,connectMiddleware:!0,nativeBodyParsing:!1}}}const log=createLogger(`Application`);var Application=class{options;app;runtime;container;httpServer=null;adapters;plugins;_moduleContributors=[];_inFlightRequests=0;_draining=!1;_shutdownInitiated=!1;_drainResolvers=[];constructor(options){this.options=options,this.runtime=options.runtime??expressRuntime(),this.app=this.runtime.createApp({trustProxy:options.trustProxy}),this.container=Container.getInstance(),this.plugins=mountSort(options.plugins??[],`plugin`);let allAdapters=[...this.plugins.flatMap(p=>p.adapters?.()??[]),...options.adapters??[]],anonAdapterCount=0,namedAdapters=allAdapters.map(adapter=>{if(!adapter.name){let ctorName=adapter.constructor?.name,fallback=ctorName&&ctorName!==`Object`?ctorName:`AnonymousAdapter#${anonAdapterCount++}`;return Object.assign(adapter,{name:fallback})}return adapter});this.adapters=mountSort(namedAdapters,`adapter`),Container._requestStoreProvider=()=>requestStore.getStore()??null}get isDraining(){return this._draining}get inFlightRequests(){return this._inFlightRequests}getContainer(){return this.container}handle(req,res,next){let handler=this.runtime.nodeHandler(this.app);next?handler(req,res,next):handler(req,res)}adapterCtx(server){let env=process.env.NODE_ENV??`development`;return{http:this.adapterHttp(),app:this.app,container:this.container,server,env,isProduction:env===`production`}}adapterHttp(){return{route:(method,path,handler)=>{let entry={method,path,middlewares:[],contributorRunner:null,handler,meta:{}};this.runtime.mountRoutes(this.app,[{mountPath:`/`,routes:[entry]}])},mount:(prefix,routes)=>{this.runtime.mountRoutes(this.app,[{mountPath:prefix,routes}])},serveStatic:(prefix,dir)=>{this.runtime.serveStatic(this.app,prefix,dir)},use:(mw,opts)=>{this.runtime.useConnect(this.app,mw,opts)}}}async callHook(hook,ctx){if(hook)try{let result=hook(ctx);result&&typeof result.then==`function`&&await result}catch(err){log.error(err,`Adapter hook failed`)}}async setup(){log.debug(`Bootstrapping application...`),this._moduleContributors=[];let adapterMw=this.collectAdapterMiddleware();this.app.__kickApp=this;let ctx=this.adapterCtx();for(let adapter of this.adapters)await this.callHook(adapter.beforeMount?.bind(adapter),ctx);this.runtime.useConnect(this.app,this.requestTrackingMiddleware()),this.mountHealthEndpoints(),this.shouldAutoMountRequestScope()&&this.runtime.useConnect(this.app,requestScopeMiddleware()),this.mountMiddlewareList(adapterMw.beforeGlobal);for(let plugin of this.plugins)plugin.register?.(this.container);for(let plugin of this.plugins)try{let mw=plugin.middleware?.()??[];for(let handler of mw)this.runtime.useConnect(this.app,handler)}catch(err){log.error(err,`Plugin middleware failed: ${plugin.name??`unknown`}`)}if(this.options.security?.helmet!==!1)try{let{helmet:helmetFn}=await import(`./http/middleware/helmet.mjs`);this.runtime.useConnect(this.app,helmetFn())}catch{}let userMiddlewares=this.options.middlewares??this.options.middleware;if(userMiddlewares)for(let entry of userMiddlewares)this.mountMiddlewareEntry(entry);else this.runtime.useConnect(this.app,requestId()),this.runtime.capabilities.nativeBodyParsing||this.runtime.useConnect(this.app,express.json({limit:this.options.jsonLimit??`1mb`}));this.mountMiddlewareList(adapterMw.afterGlobal);let moduleRegistry=new MutableModuleRegistry;for(let plugin of this.plugins){for(let m of plugin.modules?.()??[])moduleRegistry.mount(m);plugin.setup?.(moduleRegistry)}for(let m of this.options.modules)moduleRegistry.mount(m);this.options.setup?.(moduleRegistry);let modules=moduleRegistry.entries.map(entry=>{let mod=typeof entry==`function`?new entry:entry;return mod.register?.(this.container),mod});this.container.bootstrap(),this.container.has(Logger)||this.container.registerInstance(Logger,new Logger),this.mountMiddlewareList(adapterMw.beforeRoutes);let apiPrefix=this.options.apiPrefix??`/api`,defaultVersion=this.options.defaultVersion??1,shouldLogRoutes=this.options.logRouteTable??this.options.logRoutesTable??!1,mountedRoutes=[],adapterSources=[];for(let adapter of this.adapters){let adapterContribs=adapter.contributors?.()??[],adapterLabel=adapter.name??adapter.constructor.name??`adapter`;for(let registration of adapterContribs)adapterSources.push({source:`adapter`,registration,label:adapterLabel})}for(let plugin of this.plugins){let pluginContribs=plugin.contributors?.()??[],pluginLabel=plugin.name??plugin.constructor?.name??`plugin`;for(let registration of pluginContribs)adapterSources.push({source:`adapter`,registration,label:pluginLabel})}let globalSources=(this.options.contributors??[]).map(registration=>({source:`global`,registration,label:`bootstrap`}));this._moduleContributors=[];let seenRoutes=new Map;for(let mod of modules){let declaredName=mod.name,ctorName=mod.constructor?.name,moduleLabel=typeof declaredName==`string`&&declaredName.length>0?declaredName:ctorName&&ctorName!==`Object`?ctorName:`module`,moduleSources=(mod.contributors?.()??[]).map(registration=>({source:`module`,registration,label:moduleLabel}));for(let src of moduleSources)this._moduleContributors.push({registration:src.registration,label:moduleLabel});_setExternalContributorSources([...moduleSources,...adapterSources,...globalSources]);try{let result=mod.routes();if(!result)continue;let routeSets=Array.isArray(result)?result:[result];for(let route of routeSets){let mountPath=`${apiPrefix}/v${route.version??defaultVersion}${normalizePath(route.path)}`;if(route.router)this.runtime.useConnect(this.app,route.router,{path:mountPath});else if(route.controller){let routeTable=buildRouteTable(route.controller),ctrl=route.controller.name??`controller`;for(let entry of routeTable){let owner=`${ctrl}.${String(entry.meta.handlerName??`?`)}`;assertRouteUnique(seenRoutes,entry.method,joinPaths(mountPath,entry.path),owner)}this.runtime.mountRoutes(this.app,[{mountPath,routes:routeTable}])}else throw moduleRouteMissingControllerError(mountPath);if(route.controller){for(let adapter of this.adapters)try{adapter.onRouteMount?.(route.controller,mountPath)}catch(err){log.error(err,`adapter.onRouteMount() failed for ${mountPath}`)}shouldLogRoutes&&mountedRoutes.push({controller:route.controller,mountPath})}}}finally{_setExternalContributorSources([])}}if(shouldLogRoutes&&mountedRoutes.length>0){let methodOrder=[`GET`,`POST`,`PUT`,`PATCH`,`DELETE`,`HEAD`,`OPTIONS`],methodRank=m=>{let i=methodOrder.indexOf(m);return i===-1?99:i},totalRoutes=0;log.info(`Routes:`);for(let{controller,mountPath}of mountedRoutes){let defs=getClassMeta(METADATA.ROUTES,controller,[]);if(defs.length===0)continue;let counts={};for(let def of defs){let m=def.method.toUpperCase();counts[m]=(counts[m]||0)+1}totalRoutes+=defs.length;let methods=Object.entries(counts).toSorted(([a],[b])=>methodRank(a)-methodRank(b)).map(([m,n])=>`${n} ${m}`).join(`, `),name=controller.name||`Controller`;log.info(`  ${name.padEnd(30)} ${mountPath.padEnd(25)} ${defs.length} routes (${methods})`)}log.info(`  Total: ${totalRoutes} routes`)}this.mountMiddlewareList(adapterMw.afterRoutes);for(let adapter of this.adapters)await this.callHook(adapter.beforeStart?.bind(adapter),ctx);this.runtime.setNotFound(this.app,this.options.onNotFound??notFoundHandler()),this.runtime.setErrorHandler(this.app,this.options.onError??errorHandler())}async registerOnly(){await this.setup()}async start(){await this.setup();let g=globalThis;if(g.__kickjs_httpServer){this.httpServer=g.__kickjs_httpServer,log.debug(`Attached to Vite dev server`),g.__kickjs_app_shutdown=()=>this.shutdown();for(let adapter of this.adapters){let ctx=this.adapterCtx(this.httpServer);await this.callHook(adapter.afterStart?.bind(adapter),ctx)}for(let plugin of this.plugins)await plugin.onReady?.(this.container);return}let port=this.options.port??parseInt(process.env.PORT||`3000`,10);this.httpServer=http.createServer(this.runtime.nodeHandler(this.app)),this.httpServer.on(`error`,err=>{throw err.code===`EADDRINUSE`&&(log.error(`Port ${port} is already in use. Kill the existing process or use a different port:\n  PORT=${port+1} kick dev\n  lsof -i :${port}   # find what's using it\n  kill <PID>          # stop it`),process.exit(1)),err}),await new Promise((resolve,reject)=>{this.httpServer.listen(port,async()=>{try{log.info(`Server running on http://localhost:${port}`);for(let adapter of this.adapters){let afterCtx=this.adapterCtx(this.httpServer);await this.callHook(adapter.afterStart?.bind(adapter),afterCtx)}for(let plugin of this.plugins)await plugin.onReady?.(this.container);resolve()}catch(err){reject(err)}})})}async rebuild(){let prevApp=this.app,prevContainer=this.container,staleDisposables=drainDisposables();try{Container.reset(),this.container=Container.getInstance(),this.app=this.runtime.createApp({trustProxy:this.options.trustProxy}),await this.setup()}catch(err){log.error(err,`HMR rebuild failed, keeping previous app`),await runDisposables(drainDisposables());for(let d of staleDisposables)registerDisposable(d);this.app=prevApp,this.container=prevContainer;return}await runDisposables(staleDisposables),this.httpServer&&(this.httpServer.removeAllListeners(`request`),this.httpServer.on(`request`,this.runtime.nodeHandler(this.app)),log.debug(`HMR: app rebuilt and swapped`))}async shutdown(){if(this._shutdownInitiated){log.debug(`Shutdown already in progress, skipping duplicate call`);return}this._shutdownInitiated=!0,this._draining=!0,log.debug(`Shutting down — draining in-flight requests...`);let timeoutMs=this.options.shutdownTimeout??3e4,timer,forceExitPromise=timeoutMs>0?new Promise(resolve=>{timer=setTimeout(()=>resolve(`timeout`),timeoutMs),timer.unref()}):new Promise(()=>{});try{if(this.httpServer&&this.httpServer.close(()=>{}),this._inFlightRequests>0){log.debug(`Waiting for ${this._inFlightRequests} in-flight request(s) to complete...`);let drainPromise=new Promise(resolve=>{this._drainResolvers.push(()=>resolve(`drained`))});await Promise.race([drainPromise,forceExitPromise])===`timeout`?log.warn(`Shutdown timeout (${timeoutMs}ms) reached with ${this._inFlightRequests} request(s) still in-flight, forcing shutdown`):log.debug(`All in-flight requests completed`)}let results=await Promise.allSettled([...this.plugins.map(plugin=>Promise.resolve(plugin.shutdown?.())),...this.adapters.map(adapter=>Promise.resolve(adapter.shutdown?.()))]);for(let result of results)result.status===`rejected`&&log.error({err:result.reason},`Adapter shutdown failed`);await disposeAll(),this.container.flushChanges()}finally{timer&&clearTimeout(timer)}}getRuntimeApp(){return this.app}getActiveRuntime(){return{name:this.runtime.name,capabilities:this.runtime.capabilities}}getExpressApp(){return this.app}getAdapters(){return this.adapters}getPlugins(){return this.plugins}getContributors(){let out=[],ingest=(list,source,label)=>{if(list)for(let reg of list){let r=reg;if(r.key===void 0||r.key===null)continue;let key=typeof r.key==`string`?r.key:tokenName(r.key);out.push({key,source,label,dependsOn:Array.isArray(r.dependsOn)?r.dependsOn:[]})}};for(let adapter of this.adapters)ingest(adapter.contributors?.(),`adapter`,adapter.name??`adapter`);for(let plugin of this.plugins)ingest(plugin.contributors?.(),`plugin`,plugin.name??`plugin`);for(let{registration,label}of this._moduleContributors)ingest([registration],`module`,label);return ingest(this.options.contributors,`global`,`bootstrap`),out}getHttpServer(){return this.httpServer}shouldAutoMountRequestScope(){if(this.options.contextStore===`manual`)return!1;let userEntries=this.options.middlewares??this.options.middleware??[];for(let entry of userEntries)if(isRequestScopeMiddleware(typeof entry==`function`?entry:entry.handler))return!1;return!0}collectAdapterMiddleware(){let result={beforeGlobal:[],afterGlobal:[],beforeRoutes:[],afterRoutes:[]};for(let adapter of this.adapters){let entries=adapter.middleware?.()??[];for(let entry of entries)result[entry.phase??`afterGlobal`].push(entry)}return result}mountMiddlewareList(entries){for(let entry of entries){if(entry.path===void 0){this.runtime.useConnect(this.app,entry.handler);continue}this.runtime.useConnect(this.app,entry.handler,{path:entry.path})}}mountMiddlewareEntry(entry){typeof entry==`function`?this.runtime.useConnect(this.app,entry):this.runtime.useConnect(this.app,entry.handler,{path:entry.path})}requestTrackingMiddleware(){return(_req,res,next)=>{this._inFlightRequests++;let onFinish=()=>{if(res.removeListener(`finish`,onFinish),res.removeListener(`close`,onFinish),this._inFlightRequests--,this._draining&&this._inFlightRequests===0){for(let resolve of this._drainResolvers)resolve();this._drainResolvers=[]}};res.on(`finish`,onFinish),res.on(`close`,onFinish),next()}}mountHealthEndpoints(){let http=this.adapterHttp();http.route(`GET`,`/health/live`,ctx=>{this._draining?ctx.res.status(503).json({status:`draining`,uptime:process.uptime()}):ctx.json({status:`ok`,uptime:process.uptime()})}),http.route(`GET`,`/health/ready`,async ctx=>{if(this._draining){ctx.res.status(503).json({status:`draining`,checks:[]});return}let adaptersWithHealth=this.adapters.filter(a=>a.onHealthCheck),results=(await Promise.allSettled(adaptersWithHealth.map(a=>a.onHealthCheck()))).map((c,i)=>c.status===`fulfilled`?c.value:{name:adaptersWithHealth[i].name??`unknown`,status:`down`}),healthy=results.every(r=>r.status===`up`);ctx.res.status(healthy?200:503).json({status:healthy?`ready`:`degraded`,checks:results})})}};export{materializeRouter as i,buildRoutes as n,expressRuntime as r,Application as t};
+//# sourceMappingURL=application-C-r79XqD.mjs.map