@forinda/kickjs-http 0.5.2 → 0.6.0

package/dist/application.d.ts

@@ -1,6 +1,6 @@
 import http from 'node:http';
 import { RequestHandler, Express } from 'express';
-import { AppModuleClass, AppAdapter } from '@forinda/kickjs-core';
+import { AppModuleClass, AppAdapter, KickPlugin } from '@forinda/kickjs-core';
 
 /**
  * A middleware entry in the declarative pipeline.
@@ -43,6 +43,8 @@ interface ApplicationOptions {
      *   requestId(), express.json({ limit: '100kb' })
      */
     middleware?: MiddlewareEntry[];
+    /** Plugins that bundle modules, adapters, middleware, and DI bindings */
+    plugins?: KickPlugin[];
     /** Express `trust proxy` setting */
     trustProxy?: boolean | number | string | ((ip: string, hopIndex: number) => boolean);
     /** Maximum JSON body size (only used when middleware is not provided) */
@@ -58,6 +60,7 @@ declare class Application {
     private container;
     private httpServer;
     private adapters;
+    private plugins;
     constructor(options: ApplicationOptions);
     /**
      * Full setup pipeline:

package/dist/application.js

@@ -1,6 +1,6 @@
 import {
   Application
-} from "./chunk-OKB76LY2.js";
+} from "./chunk-YRCR6Z5C.js";
 import "./chunk-35NUARK7.js";
 import "./chunk-3NEDJA3J.js";
 import "./chunk-WCQVDF3K.js";

package/dist/bootstrap.js

@@ -1,7 +1,7 @@
 import {
   bootstrap
-} from "./chunk-D76WCWAW.js";
-import "./chunk-OKB76LY2.js";
+} from "./chunk-W35YEQOE.js";
+import "./chunk-YRCR6Z5C.js";
 import "./chunk-35NUARK7.js";
 import "./chunk-3NEDJA3J.js";
 import "./chunk-WCQVDF3K.js";

package/dist/{chunk-S7DJ5HF3.js → chunk-E552HYEB.js}

@@ -6,7 +6,7 @@ import {
 } from "./chunk-RPN7UFUO.js";
 import {
   RequestContext
-} from "./chunk-GDMORQ2P.js";
+} from "./chunk-Y5ZSC2FB.js";
 import {
   __name
 } from "./chunk-WCQVDF3K.js";
@@ -66,4 +66,4 @@ export {
   getControllerPath,
   buildRoutes
 };
-//# sourceMappingURL=chunk-S7DJ5HF3.js.map
+//# sourceMappingURL=chunk-E552HYEB.js.map

package/dist/{chunk-D76WCWAW.js → chunk-W35YEQOE.js}

@@ -1,6 +1,6 @@
 import {
   Application
-} from "./chunk-OKB76LY2.js";
+} from "./chunk-YRCR6Z5C.js";
 import {
   __name,
   __require
@@ -57,4 +57,4 @@ __name(bootstrap, "bootstrap");
 export {
   bootstrap
 };
-//# sourceMappingURL=chunk-D76WCWAW.js.map
+//# sourceMappingURL=chunk-W35YEQOE.js.map

package/dist/{chunk-GDMORQ2P.js → chunk-Y5ZSC2FB.js}

@@ -148,9 +148,67 @@ var RequestContext = class {
     };
     return this.json(response);
   }
+  // ── Server-Sent Events ──────────────────────────────────────────────
+  /**
+  * Start an SSE (Server-Sent Events) stream.
+  * Sets the correct headers and returns helpers to send events.
+  *
+  * @example
+  * ```ts
+  * @Get('/events')
+  * async stream(ctx: RequestContext) {
+  *   const sse = ctx.sse()
+  *
+  *   const interval = setInterval(() => {
+  *     sse.send({ time: new Date().toISOString() }, 'tick')
+  *   }, 1000)
+  *
+  *   sse.onClose(() => clearInterval(interval))
+  * }
+  * ```
+  */
+  sse() {
+    this.res.writeHead(200, {
+      "Content-Type": "text/event-stream",
+      "Cache-Control": "no-cache",
+      Connection: "keep-alive",
+      "X-Accel-Buffering": "no"
+    });
+    this.res.flushHeaders();
+    const closeCallbacks = [];
+    this.req.on("close", () => {
+      for (const cb of closeCallbacks) cb();
+    });
+    return {
+      /** Send an SSE event with optional event name and id */
+      send: /* @__PURE__ */ __name((data, event, id) => {
+        if (id) this.res.write(`id: ${id}
+`);
+        if (event) this.res.write(`event: ${event}
+`);
+        this.res.write(`data: ${JSON.stringify(data)}
+
+`);
+      }, "send"),
+      /** Send a comment (keeps connection alive) */
+      comment: /* @__PURE__ */ __name((text) => {
+        this.res.write(`: ${text}
+
+`);
+      }, "comment"),
+      /** Register a callback when the client disconnects */
+      onClose: /* @__PURE__ */ __name((fn) => {
+        closeCallbacks.push(fn);
+      }, "onClose"),
+      /** End the SSE stream */
+      close: /* @__PURE__ */ __name(() => {
+        this.res.end();
+      }, "close")
+    };
+  }
 };
 
 export {
   RequestContext
 };
-//# sourceMappingURL=chunk-GDMORQ2P.js.map
+//# sourceMappingURL=chunk-Y5ZSC2FB.js.map

package/dist/{chunk-GDMORQ2P.js.map → chunk-Y5ZSC2FB.js.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/context.ts"],"sourcesContent":["import type { Request, Response, NextFunction } from 'express'\nimport {\n  parseQuery,\n  type ParsedQuery,\n  type QueryFieldConfig,\n  type PaginatedResponse,\n} from './query'\n\n/**\n * Unified request/response abstraction passed to every controller method.\n * Shields handlers from raw Express objects and provides convenience methods.\n */\nexport class RequestContext<TBody = any, TParams = any, TQuery = any> {\n  private metadata = new Map<string, any>()\n\n  constructor(\n    public readonly req: Request,\n    public readonly res: Response,\n    public readonly next: NextFunction,\n  ) {}\n\n  // ── Request Data ────────────────────────────────────────────────────\n\n  get body(): TBody {\n    return this.req.body as TBody\n  }\n\n  get params(): TParams {\n    return this.req.params as TParams\n  }\n\n  get query(): TQuery {\n    return this.req.query as TQuery\n  }\n\n  get headers() {\n    return this.req.headers\n  }\n\n  get requestId(): string | undefined {\n    return (this.req as any).requestId ?? (this.req.headers['x-request-id'] as string | undefined)\n  }\n\n  /** Session data (requires session middleware) */\n  get session(): any {\n    return (this.req as any).session\n  }\n\n  // ── Query String Parsing ───────────────────────────────────────────\n\n  /**\n   * Parse the request query string into structured filters, sort, pagination, and search.\n   * Pass the result to an ORM query builder adapter (Drizzle, Prisma, Sequelize, etc.).\n   *\n   * @param fieldConfig - Optional whitelist for filterable, sortable, and searchable fields\n   *\n   * @example\n   * ```ts\n   * @Get('/')\n   * async list(ctx: RequestContext) {\n   *   const parsed = ctx.qs({\n   *     filterable: ['status', 'priority'],\n   *     sortable: ['createdAt', 'title'],\n   *   })\n   *   const q = drizzleAdapter.build(parsed, { columns })\n   *   // ... use q.where, q.orderBy, q.limit, q.offset\n   * }\n   * ```\n   */\n  qs(fieldConfig?: QueryFieldConfig): ParsedQuery {\n    return parseQuery(this.req.query as Record<string, any>, fieldConfig)\n  }\n\n  // ── File Uploads ────────────────────────────────────────────────────\n\n  /** Single uploaded file (requires @FileUpload({ mode: 'single' })) */\n  get file(): any {\n    return (this.req as any).file\n  }\n\n  /** Array of uploaded files (requires @FileUpload({ mode: 'array' })) */\n  get files(): any[] | undefined {\n    return (this.req as any).files\n  }\n\n  // ── Metadata Store ──────────────────────────────────────────────────\n\n  get<T = any>(key: string): T | undefined {\n    return this.metadata.get(key) as T | undefined\n  }\n\n  set(key: string, value: any): void {\n    this.metadata.set(key, value)\n  }\n\n  // ── Response Helpers ────────────────────────────────────────────────\n\n  json(data: any, status = 200) {\n    return this.res.status(status).json(data)\n  }\n\n  created(data: any) {\n    return this.res.status(201).json(data)\n  }\n\n  noContent() {\n    return this.res.status(204).end()\n  }\n\n  notFound(message = 'Not Found') {\n    return this.res.status(404).json({ message })\n  }\n\n  badRequest(message: string) {\n    return this.res.status(400).json({ message })\n  }\n\n  html(content: string, status = 200) {\n    return this.res.status(status).type('html').send(content)\n  }\n\n  download(buffer: Buffer, filename: string, contentType = 'application/octet-stream') {\n    this.res.setHeader('Content-Disposition', `attachment; filename=\"${filename}\"`)\n    this.res.setHeader('Content-Type', contentType)\n    return this.res.send(buffer)\n  }\n\n  /**\n   * Parse query params and return a standardized paginated response.\n   * Calls `ctx.qs()` internally, then wraps your data with pagination meta.\n   *\n   * @param fetcher - Async function that receives ParsedQuery and returns `{ data, total }`\n   * @param fieldConfig - Optional whitelist for filterable, sortable, searchable fields\n   *\n   * @example\n   * ```ts\n   * @Get('/')\n   * async list(ctx: RequestContext) {\n   *   return ctx.paginate(\n   *     async (parsed) => {\n   *       const data = await db.select().from(users)\n   *         .where(query.where).limit(parsed.pagination.limit)\n   *         .offset(parsed.pagination.offset).all()\n   *       const total = await db.select({ count: count() }).from(users).get()\n   *       return { data, total: total?.count ?? 0 }\n   *     },\n   *     { filterable: ['name', 'role'], sortable: ['createdAt'] },\n   *   )\n   * }\n   * ```\n   */\n  async paginate<T>(\n    fetcher: (parsed: ParsedQuery) => Promise<{ data: T[]; total: number }>,\n    fieldConfig?: QueryFieldConfig,\n  ) {\n    const parsed = this.qs(fieldConfig)\n    const { data, total } = await fetcher(parsed)\n    const { page, limit } = parsed.pagination\n    const totalPages = Math.ceil(total / limit) || 1\n\n    const response: PaginatedResponse<T> = {\n      data,\n      meta: {\n        page,\n        limit,\n        total,\n        totalPages,\n        hasNext: page < totalPages,\n        hasPrev: page > 1,\n      },\n    }\n\n    return this.json(response)\n  }\n}\n"],"mappings":";;;;;;;;AAYO,IAAMA,iBAAN,MAAMA;EAXb,OAWaA;;;;;;EACHC,WAAW,oBAAIC,IAAAA;EAEvB,YACkBC,KACAC,KACAC,MAChB;SAHgBF,MAAAA;SACAC,MAAAA;SACAC,OAAAA;EACf;;EAIH,IAAIC,OAAc;AAChB,WAAO,KAAKH,IAAIG;EAClB;EAEA,IAAIC,SAAkB;AACpB,WAAO,KAAKJ,IAAII;EAClB;EAEA,IAAIC,QAAgB;AAClB,WAAO,KAAKL,IAAIK;EAClB;EAEA,IAAIC,UAAU;AACZ,WAAO,KAAKN,IAAIM;EAClB;EAEA,IAAIC,YAAgC;AAClC,WAAQ,KAAKP,IAAYO,aAAc,KAAKP,IAAIM,QAAQ,cAAA;EAC1D;;EAGA,IAAIE,UAAe;AACjB,WAAQ,KAAKR,IAAYQ;EAC3B;;;;;;;;;;;;;;;;;;;;;EAuBAC,GAAGC,aAA6C;AAC9C,WAAOC,WAAW,KAAKX,IAAIK,OAA8BK,WAAAA;EAC3D;;;EAKA,IAAIE,OAAY;AACd,WAAQ,KAAKZ,IAAYY;EAC3B;;EAGA,IAAIC,QAA2B;AAC7B,WAAQ,KAAKb,IAAYa;EAC3B;;EAIAC,IAAaC,KAA4B;AACvC,WAAO,KAAKjB,SAASgB,IAAIC,GAAAA;EAC3B;EAEAC,IAAID,KAAaE,OAAkB;AACjC,SAAKnB,SAASkB,IAAID,KAAKE,KAAAA;EACzB;;EAIAC,KAAKC,MAAWC,SAAS,KAAK;AAC5B,WAAO,KAAKnB,IAAImB,OAAOA,MAAAA,EAAQF,KAAKC,IAAAA;EACtC;EAEAE,QAAQF,MAAW;AACjB,WAAO,KAAKlB,IAAImB,OAAO,GAAA,EAAKF,KAAKC,IAAAA;EACnC;EAEAG,YAAY;AACV,WAAO,KAAKrB,IAAImB,OAAO,GAAA,EAAKG,IAAG;EACjC;EAEAC,SAASC,UAAU,aAAa;AAC9B,WAAO,KAAKxB,IAAImB,OAAO,GAAA,EAAKF,KAAK;MAAEO;IAAQ,CAAA;EAC7C;EAEAC,WAAWD,SAAiB;AAC1B,WAAO,KAAKxB,IAAImB,OAAO,GAAA,EAAKF,KAAK;MAAEO;IAAQ,CAAA;EAC7C;EAEAE,KAAKC,SAAiBR,SAAS,KAAK;AAClC,WAAO,KAAKnB,IAAImB,OAAOA,MAAAA,EAAQS,KAAK,MAAA,EAAQC,KAAKF,OAAAA;EACnD;EAEAG,SAASC,QAAgBC,UAAkBC,cAAc,4BAA4B;AACnF,SAAKjC,IAAIkC,UAAU,uBAAuB,yBAAyBF,QAAAA,GAAW;AAC9E,SAAKhC,IAAIkC,UAAU,gBAAgBD,WAAAA;AACnC,WAAO,KAAKjC,IAAI6B,KAAKE,MAAAA;EACvB;;;;;;;;;;;;;;;;;;;;;;;;;EA0BA,MAAMI,SACJC,SACA3B,aACA;AACA,UAAM4B,SAAS,KAAK7B,GAAGC,WAAAA;AACvB,UAAM,EAAES,MAAMoB,MAAK,IAAK,MAAMF,QAAQC,MAAAA;AACtC,UAAM,EAAEE,MAAMC,MAAK,IAAKH,OAAOI;AAC/B,UAAMC,aAAaC,KAAKC,KAAKN,QAAQE,KAAAA,KAAU;AAE/C,UAAMK,WAAiC;MACrC3B;MACA4B,MAAM;QACJP;QACAC;QACAF;QACAI;QACAK,SAASR,OAAOG;QAChBM,SAAST,OAAO;MAClB;IACF;AAEA,WAAO,KAAKtB,KAAK4B,QAAAA;EACnB;AACF;","names":["RequestContext","metadata","Map","req","res","next","body","params","query","headers","requestId","session","qs","fieldConfig","parseQuery","file","files","get","key","set","value","json","data","status","created","noContent","end","notFound","message","badRequest","html","content","type","send","download","buffer","filename","contentType","setHeader","paginate","fetcher","parsed","total","page","limit","pagination","totalPages","Math","ceil","response","meta","hasNext","hasPrev"]}
+{"version":3,"sources":["../src/context.ts"],"sourcesContent":["import type { Request, Response, NextFunction } from 'express'\nimport {\n  parseQuery,\n  type ParsedQuery,\n  type QueryFieldConfig,\n  type PaginatedResponse,\n} from './query'\n\n/**\n * Unified request/response abstraction passed to every controller method.\n * Shields handlers from raw Express objects and provides convenience methods.\n */\nexport class RequestContext<TBody = any, TParams = any, TQuery = any> {\n  private metadata = new Map<string, any>()\n\n  constructor(\n    public readonly req: Request,\n    public readonly res: Response,\n    public readonly next: NextFunction,\n  ) {}\n\n  // ── Request Data ────────────────────────────────────────────────────\n\n  get body(): TBody {\n    return this.req.body as TBody\n  }\n\n  get params(): TParams {\n    return this.req.params as TParams\n  }\n\n  get query(): TQuery {\n    return this.req.query as TQuery\n  }\n\n  get headers() {\n    return this.req.headers\n  }\n\n  get requestId(): string | undefined {\n    return (this.req as any).requestId ?? (this.req.headers['x-request-id'] as string | undefined)\n  }\n\n  /** Session data (requires session middleware) */\n  get session(): any {\n    return (this.req as any).session\n  }\n\n  // ── Query String Parsing ───────────────────────────────────────────\n\n  /**\n   * Parse the request query string into structured filters, sort, pagination, and search.\n   * Pass the result to an ORM query builder adapter (Drizzle, Prisma, Sequelize, etc.).\n   *\n   * @param fieldConfig - Optional whitelist for filterable, sortable, and searchable fields\n   *\n   * @example\n   * ```ts\n   * @Get('/')\n   * async list(ctx: RequestContext) {\n   *   const parsed = ctx.qs({\n   *     filterable: ['status', 'priority'],\n   *     sortable: ['createdAt', 'title'],\n   *   })\n   *   const q = drizzleAdapter.build(parsed, { columns })\n   *   // ... use q.where, q.orderBy, q.limit, q.offset\n   * }\n   * ```\n   */\n  qs(fieldConfig?: QueryFieldConfig): ParsedQuery {\n    return parseQuery(this.req.query as Record<string, any>, fieldConfig)\n  }\n\n  // ── File Uploads ────────────────────────────────────────────────────\n\n  /** Single uploaded file (requires @FileUpload({ mode: 'single' })) */\n  get file(): any {\n    return (this.req as any).file\n  }\n\n  /** Array of uploaded files (requires @FileUpload({ mode: 'array' })) */\n  get files(): any[] | undefined {\n    return (this.req as any).files\n  }\n\n  // ── Metadata Store ──────────────────────────────────────────────────\n\n  get<T = any>(key: string): T | undefined {\n    return this.metadata.get(key) as T | undefined\n  }\n\n  set(key: string, value: any): void {\n    this.metadata.set(key, value)\n  }\n\n  // ── Response Helpers ────────────────────────────────────────────────\n\n  json(data: any, status = 200) {\n    return this.res.status(status).json(data)\n  }\n\n  created(data: any) {\n    return this.res.status(201).json(data)\n  }\n\n  noContent() {\n    return this.res.status(204).end()\n  }\n\n  notFound(message = 'Not Found') {\n    return this.res.status(404).json({ message })\n  }\n\n  badRequest(message: string) {\n    return this.res.status(400).json({ message })\n  }\n\n  html(content: string, status = 200) {\n    return this.res.status(status).type('html').send(content)\n  }\n\n  download(buffer: Buffer, filename: string, contentType = 'application/octet-stream') {\n    this.res.setHeader('Content-Disposition', `attachment; filename=\"${filename}\"`)\n    this.res.setHeader('Content-Type', contentType)\n    return this.res.send(buffer)\n  }\n\n  /**\n   * Parse query params and return a standardized paginated response.\n   * Calls `ctx.qs()` internally, then wraps your data with pagination meta.\n   *\n   * @param fetcher - Async function that receives ParsedQuery and returns `{ data, total }`\n   * @param fieldConfig - Optional whitelist for filterable, sortable, searchable fields\n   *\n   * @example\n   * ```ts\n   * @Get('/')\n   * async list(ctx: RequestContext) {\n   *   return ctx.paginate(\n   *     async (parsed) => {\n   *       const data = await db.select().from(users)\n   *         .where(query.where).limit(parsed.pagination.limit)\n   *         .offset(parsed.pagination.offset).all()\n   *       const total = await db.select({ count: count() }).from(users).get()\n   *       return { data, total: total?.count ?? 0 }\n   *     },\n   *     { filterable: ['name', 'role'], sortable: ['createdAt'] },\n   *   )\n   * }\n   * ```\n   */\n  async paginate<T>(\n    fetcher: (parsed: ParsedQuery) => Promise<{ data: T[]; total: number }>,\n    fieldConfig?: QueryFieldConfig,\n  ) {\n    const parsed = this.qs(fieldConfig)\n    const { data, total } = await fetcher(parsed)\n    const { page, limit } = parsed.pagination\n    const totalPages = Math.ceil(total / limit) || 1\n\n    const response: PaginatedResponse<T> = {\n      data,\n      meta: {\n        page,\n        limit,\n        total,\n        totalPages,\n        hasNext: page < totalPages,\n        hasPrev: page > 1,\n      },\n    }\n\n    return this.json(response)\n  }\n\n  // ── Server-Sent Events ──────────────────────────────────────────────\n\n  /**\n   * Start an SSE (Server-Sent Events) stream.\n   * Sets the correct headers and returns helpers to send events.\n   *\n   * @example\n   * ```ts\n   * @Get('/events')\n   * async stream(ctx: RequestContext) {\n   *   const sse = ctx.sse()\n   *\n   *   const interval = setInterval(() => {\n   *     sse.send({ time: new Date().toISOString() }, 'tick')\n   *   }, 1000)\n   *\n   *   sse.onClose(() => clearInterval(interval))\n   * }\n   * ```\n   */\n  sse() {\n    this.res.writeHead(200, {\n      'Content-Type': 'text/event-stream',\n      'Cache-Control': 'no-cache',\n      Connection: 'keep-alive',\n      'X-Accel-Buffering': 'no',\n    })\n    this.res.flushHeaders()\n\n    const closeCallbacks: Array<() => void> = []\n\n    this.req.on('close', () => {\n      for (const cb of closeCallbacks) cb()\n    })\n\n    return {\n      /** Send an SSE event with optional event name and id */\n      send: (data: any, event?: string, id?: string) => {\n        if (id) this.res.write(`id: ${id}\\n`)\n        if (event) this.res.write(`event: ${event}\\n`)\n        this.res.write(`data: ${JSON.stringify(data)}\\n\\n`)\n      },\n      /** Send a comment (keeps connection alive) */\n      comment: (text: string) => {\n        this.res.write(`: ${text}\\n\\n`)\n      },\n      /** Register a callback when the client disconnects */\n      onClose: (fn: () => void) => {\n        closeCallbacks.push(fn)\n      },\n      /** End the SSE stream */\n      close: () => {\n        this.res.end()\n      },\n    }\n  }\n}\n"],"mappings":"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","names":["RequestContext","metadata","Map","req","res","next","body","params","query","headers","requestId","session","qs","fieldConfig","parseQuery","file","files","get","key","set","value","json","data","status","created","noContent","end","notFound","message","badRequest","html","content","type","send","download","buffer","filename","contentType","setHeader","paginate","fetcher","parsed","total","page","limit","pagination","totalPages","Math","ceil","response","meta","hasNext","hasPrev","sse","writeHead","Connection","flushHeaders","closeCallbacks","on","cb","event","id","write","JSON","stringify","comment","text","onClose","fn","push","close"]}

package/dist/{chunk-OKB76LY2.js → chunk-YRCR6Z5C.js}

@@ -23,11 +23,17 @@ var Application = class {
   container;
   httpServer = null;
   adapters;
+  plugins;
   constructor(options) {
     this.options = options;
     this.app = express();
     this.container = Container.getInstance();
-    this.adapters = options.adapters ?? [];
+    this.plugins = options.plugins ?? [];
+    this.adapters = [
+      // Plugin adapters first
+      ...this.plugins.flatMap((p) => p.adapters?.() ?? []),
+      ...options.adapters ?? []
+    ];
   }
   /**
   * Full setup pipeline:
@@ -51,6 +57,15 @@ var Application = class {
     this.app.disable("x-powered-by");
     this.app.set("trust proxy", this.options.trustProxy ?? false);
     this.mountMiddlewareList(adapterMw.beforeGlobal);
+    for (const plugin of this.plugins) {
+      plugin.register?.(this.container);
+    }
+    for (const plugin of this.plugins) {
+      const mw = plugin.middleware?.() ?? [];
+      for (const handler of mw) {
+        this.app.use(handler);
+      }
+    }
     if (this.options.middleware) {
       for (const entry of this.options.middleware) {
         this.mountMiddlewareEntry(entry);
@@ -62,7 +77,11 @@ var Application = class {
       }));
     }
     this.mountMiddlewareList(adapterMw.afterGlobal);
-    const modules = this.options.modules.map((ModuleClass) => {
+    const allModuleClasses = [
+      ...this.plugins.flatMap((p) => p.modules?.() ?? []),
+      ...this.options.modules
+    ];
+    const modules = allModuleClasses.map((ModuleClass) => {
       const mod = new ModuleClass();
       mod.register(this.container);
       return mod;
@@ -109,11 +128,14 @@ var Application = class {
       }
       throw err;
     });
-    this.httpServer.listen(port, () => {
+    this.httpServer.listen(port, async () => {
       log.info(`Server running on http://localhost:${port}`);
       for (const adapter of this.adapters) {
         adapter.afterStart?.(this.httpServer, this.container);
       }
+      for (const plugin of this.plugins) {
+        await plugin.onReady?.(this.container);
+      }
     });
   }
   /** HMR rebuild: swap Express handler without restarting the server */
@@ -131,7 +153,10 @@ var Application = class {
   /** Graceful shutdown — runs all adapter shutdowns in parallel, resilient to failures */
   async shutdown() {
     log.info("Shutting down...");
-    const results = await Promise.allSettled(this.adapters.map((adapter) => Promise.resolve(adapter.shutdown?.())));
+    const results = await Promise.allSettled([
+      ...this.plugins.map((plugin) => Promise.resolve(plugin.shutdown?.())),
+      ...this.adapters.map((adapter) => Promise.resolve(adapter.shutdown?.()))
+    ]);
     for (const result of results) {
       if (result.status === "rejected") {
         log.error({
@@ -187,4 +212,4 @@ var Application = class {
 export {
   Application
 };
-//# sourceMappingURL=chunk-OKB76LY2.js.map
+//# sourceMappingURL=chunk-YRCR6Z5C.js.map

package/dist/chunk-YRCR6Z5C.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/application.ts"],"sourcesContent":["import http from 'node:http'\nimport express, { type Express, type RequestHandler } from 'express'\nimport {\n  Container,\n  createLogger,\n  type AppModuleClass,\n  type AppAdapter,\n  type AdapterMiddleware,\n  type KickPlugin,\n} from '@forinda/kickjs-core'\nimport { buildRoutes } from './router-builder'\nimport { requestId } from './middleware/request-id'\nimport { notFoundHandler, errorHandler } from './middleware/error-handler'\n\nconst log = createLogger('Application')\n\n/**\n * A middleware entry in the declarative pipeline.\n * Can be a bare handler or an object with path scoping.\n */\nexport type MiddlewareEntry = RequestHandler | { path: string; handler: RequestHandler }\n\nexport interface ApplicationOptions {\n  /** Feature modules to load */\n  modules: AppModuleClass[]\n  /** Adapters that hook into the lifecycle (DB, Redis, Swagger, etc.) */\n  adapters?: AppAdapter[]\n  /** Server port (falls back to PORT env var, then 3000) */\n  port?: number\n  /** Global API prefix (default: '/api') */\n  apiPrefix?: string\n  /** Default API version (default: 1) — routes become /{prefix}/v{version}/{path} */\n  defaultVersion?: number\n\n  /**\n   * Global middleware pipeline. Declared in order.\n   * Replaces the hardcoded middleware stack — you control exactly what runs.\n   *\n   * @example\n   * ```ts\n   * bootstrap({\n   *   modules,\n   *   middleware: [\n   *     helmet(),\n   *     cors(),\n   *     compression(),\n   *     morgan('dev'),\n   *     express.json({ limit: '1mb' }),\n   *   ],\n   * })\n   * ```\n   *\n   * If omitted, a sensible default is applied:\n   *   requestId(), express.json({ limit: '100kb' })\n   */\n  middleware?: MiddlewareEntry[]\n\n  /** Plugins that bundle modules, adapters, middleware, and DI bindings */\n  plugins?: KickPlugin[]\n\n  /** Express `trust proxy` setting */\n  trustProxy?: boolean | number | string | ((ip: string, hopIndex: number) => boolean)\n  /** Maximum JSON body size (only used when middleware is not provided) */\n  jsonLimit?: string | number\n}\n\n/**\n * The main application class. Wires together Express, the DI container,\n * feature modules, adapters, and the middleware pipeline.\n */\nexport class Application {\n  private app: Express\n  private container: Container\n  private httpServer: http.Server | null = null\n  private adapters: AppAdapter[]\n\n  private plugins: KickPlugin[]\n\n  constructor(private readonly options: ApplicationOptions) {\n    this.app = express()\n    this.container = Container.getInstance()\n    this.plugins = options.plugins ?? []\n    this.adapters = [\n      // Plugin adapters first\n      ...this.plugins.flatMap((p) => p.adapters?.() ?? []),\n      ...(options.adapters ?? []),\n    ]\n  }\n\n  /**\n   * Full setup pipeline:\n   * 1. Adapter beforeMount hooks (early routes — docs, health)\n   * 2. Adapter middleware (phase: beforeGlobal)\n   * 3. Global middleware (user-declared or defaults)\n   * 4. Adapter middleware (phase: afterGlobal)\n   * 5. Module registration + DI bootstrap\n   * 6. Adapter middleware (phase: beforeRoutes)\n   * 7. Module route mounting\n   * 8. Adapter middleware (phase: afterRoutes)\n   * 9. Error handlers (notFound + global)\n   * 10. Adapter beforeStart hooks\n   */\n  setup(): void {\n    log.info('Bootstrapping application...')\n\n    // Collect adapter middleware by phase\n    const adapterMw = this.collectAdapterMiddleware()\n\n    // ── 1. Adapter beforeMount hooks ──────────────────────────────────\n    for (const adapter of this.adapters) {\n      adapter.beforeMount?.(this.app, this.container)\n    }\n\n    // ── 2. Hardened defaults ──────────────────────────────────────────\n    this.app.disable('x-powered-by')\n    this.app.set('trust proxy', this.options.trustProxy ?? false)\n\n    // ── 3. Adapter middleware: beforeGlobal ───────────────────────────\n    this.mountMiddlewareList(adapterMw.beforeGlobal)\n\n    // ── 3b. Plugin registration ──────────────────────────────────────\n    for (const plugin of this.plugins) {\n      plugin.register?.(this.container)\n    }\n\n    // ── 3c. Plugin middleware ─────────────────────────────────────────\n    for (const plugin of this.plugins) {\n      const mw = plugin.middleware?.() ?? []\n      for (const handler of mw) {\n        this.app.use(handler)\n      }\n    }\n\n    // ── 4. Global middleware ─────────────────────────────────────────\n    if (this.options.middleware) {\n      // User-declared pipeline — full control\n      for (const entry of this.options.middleware) {\n        this.mountMiddlewareEntry(entry)\n      }\n    } else {\n      // Sensible defaults when no middleware declared\n      this.app.use(requestId())\n      this.app.use(express.json({ limit: this.options.jsonLimit ?? '100kb' }))\n    }\n\n    // ── 5. Adapter middleware: afterGlobal ────────────────────────────\n    this.mountMiddlewareList(adapterMw.afterGlobal)\n\n    // ── 6. Module registration + DI bootstrap ────────────────────────\n    // Plugin modules first, then user modules\n    const allModuleClasses = [\n      ...this.plugins.flatMap((p) => p.modules?.() ?? []),\n      ...this.options.modules,\n    ]\n    const modules = allModuleClasses.map((ModuleClass) => {\n      const mod = new ModuleClass()\n      mod.register(this.container)\n      return mod\n    })\n    this.container.bootstrap()\n\n    // ── 7. Adapter middleware: beforeRoutes ───────────────────────────\n    this.mountMiddlewareList(adapterMw.beforeRoutes)\n\n    // ── 8. Mount module routes with versioning ───────────────────────\n    const apiPrefix = this.options.apiPrefix ?? '/api'\n    const defaultVersion = this.options.defaultVersion ?? 1\n\n    for (const mod of modules) {\n      const result = mod.routes()\n      const routeSets = Array.isArray(result) ? result : [result]\n\n      for (const route of routeSets) {\n        const version = route.version ?? defaultVersion\n        const mountPath = `${apiPrefix}/v${version}${route.path}`\n        this.app.use(mountPath, route.router)\n\n        // Notify adapters (e.g. SwaggerAdapter for OpenAPI spec generation)\n        if (route.controller) {\n          for (const adapter of this.adapters) {\n            adapter.onRouteMount?.(route.controller, mountPath)\n          }\n        }\n      }\n    }\n\n    // ── 9. Adapter middleware: afterRoutes ────────────────────────────\n    this.mountMiddlewareList(adapterMw.afterRoutes)\n\n    // ── 10. Error handlers ───────────────────────────────────────────\n    this.app.use(notFoundHandler())\n    this.app.use(errorHandler())\n\n    // ── 11. Adapter beforeStart hooks ────────────────────────────────\n    for (const adapter of this.adapters) {\n      adapter.beforeStart?.(this.app, this.container)\n    }\n  }\n\n  /** Start the HTTP server — fails fast if port is in use */\n  start(): void {\n    this.setup()\n\n    const port = this.options.port ?? parseInt(process.env.PORT || '3000', 10)\n    this.httpServer = http.createServer(this.app)\n\n    this.httpServer.on('error', (err: NodeJS.ErrnoException) => {\n      if (err.code === 'EADDRINUSE') {\n        log.error(\n          `Port ${port} is already in use. Kill the existing process or use a different port:\\n` +\n            `  PORT=${port + 1} kick dev\\n` +\n            `  lsof -i :${port}   # find what's using it\\n` +\n            `  kill <PID>          # stop it`,\n        )\n        process.exit(1)\n      }\n      throw err\n    })\n\n    this.httpServer.listen(port, async () => {\n      log.info(`Server running on http://localhost:${port}`)\n\n      for (const adapter of this.adapters) {\n        adapter.afterStart?.(this.httpServer!, this.container)\n      }\n\n      // Plugin onReady hooks\n      for (const plugin of this.plugins) {\n        await plugin.onReady?.(this.container)\n      }\n    })\n  }\n\n  /** HMR rebuild: swap Express handler without restarting the server */\n  rebuild(): void {\n    // Reset the DI container so singletons are re-created with fresh code\n    Container.reset()\n    this.container = Container.getInstance()\n\n    this.app = express()\n    this.setup()\n\n    if (this.httpServer) {\n      this.httpServer.removeAllListeners('request')\n      this.httpServer.on('request', this.app)\n      log.info('HMR: Express app rebuilt and swapped')\n    }\n  }\n\n  /** Graceful shutdown — runs all adapter shutdowns in parallel, resilient to failures */\n  async shutdown(): Promise<void> {\n    log.info('Shutting down...')\n\n    // Run all plugin + adapter shutdowns concurrently\n    const results = await Promise.allSettled([\n      ...this.plugins.map((plugin) => Promise.resolve(plugin.shutdown?.())),\n      ...this.adapters.map((adapter) => Promise.resolve(adapter.shutdown?.())),\n    ])\n    for (const result of results) {\n      if (result.status === 'rejected') {\n        log.error({ err: result.reason }, 'Adapter shutdown failed')\n      }\n    }\n\n    if (this.httpServer) {\n      await new Promise<void>((resolve) => this.httpServer!.close(() => resolve()))\n    }\n  }\n\n  getExpressApp(): Express {\n    return this.app\n  }\n\n  getHttpServer(): http.Server | null {\n    return this.httpServer\n  }\n\n  // ── Internal helpers ────────────────────────────────────────────────\n\n  private collectAdapterMiddleware() {\n    const result = {\n      beforeGlobal: [] as AdapterMiddleware[],\n      afterGlobal: [] as AdapterMiddleware[],\n      beforeRoutes: [] as AdapterMiddleware[],\n      afterRoutes: [] as AdapterMiddleware[],\n    }\n\n    for (const adapter of this.adapters) {\n      const entries = adapter.middleware?.() ?? []\n      for (const entry of entries) {\n        const phase = entry.phase ?? 'afterGlobal'\n        result[phase].push(entry)\n      }\n    }\n\n    return result\n  }\n\n  private mountMiddlewareList(entries: AdapterMiddleware[]): void {\n    for (const entry of entries) {\n      if (entry.path) {\n        this.app.use(entry.path, entry.handler)\n      } else {\n        this.app.use(entry.handler)\n      }\n    }\n  }\n\n  private mountMiddlewareEntry(entry: MiddlewareEntry): void {\n    if (typeof entry === 'function') {\n      this.app.use(entry)\n    } else {\n      this.app.use(entry.path, entry.handler)\n    }\n  }\n}\n"],"mappings":"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","names":["http","express","Container","createLogger","log","createLogger","Application","app","container","httpServer","adapters","plugins","options","express","Container","getInstance","flatMap","p","setup","info","adapterMw","collectAdapterMiddleware","adapter","beforeMount","disable","set","trustProxy","mountMiddlewareList","beforeGlobal","plugin","register","mw","middleware","handler","use","entry","mountMiddlewareEntry","requestId","json","limit","jsonLimit","afterGlobal","allModuleClasses","modules","map","ModuleClass","mod","bootstrap","beforeRoutes","apiPrefix","defaultVersion","result","routes","routeSets","Array","isArray","route","version","mountPath","path","router","controller","onRouteMount","afterRoutes","notFoundHandler","errorHandler","beforeStart","start","port","parseInt","process","env","PORT","http","createServer","on","err","code","error","exit","listen","afterStart","onReady","rebuild","reset","removeAllListeners","shutdown","results","Promise","allSettled","resolve","status","reason","close","getExpressApp","getHttpServer","entries","phase","push"]}

package/dist/context.d.ts

@@ -80,6 +80,34 @@ declare class RequestContext<TBody = any, TParams = any, TQuery = any> {
         data: T[];
         total: number;
     }>, fieldConfig?: QueryFieldConfig): Promise<Response<any, Record<string, any>>>;
+    /**
+     * Start an SSE (Server-Sent Events) stream.
+     * Sets the correct headers and returns helpers to send events.
+     *
+     * @example
+     * ```ts
+     * @Get('/events')
+     * async stream(ctx: RequestContext) {
+     *   const sse = ctx.sse()
+     *
+     *   const interval = setInterval(() => {
+     *     sse.send({ time: new Date().toISOString() }, 'tick')
+     *   }, 1000)
+     *
+     *   sse.onClose(() => clearInterval(interval))
+     * }
+     * ```
+     */
+    sse(): {
+        /** Send an SSE event with optional event name and id */
+        send: (data: any, event?: string, id?: string) => void;
+        /** Send a comment (keeps connection alive) */
+        comment: (text: string) => void;
+        /** Register a callback when the client disconnects */
+        onClose: (fn: () => void) => void;
+        /** End the SSE stream */
+        close: () => void;
+    };
 }
 
 export { RequestContext };

package/dist/context.js

@@ -1,6 +1,6 @@
 import {
   RequestContext
-} from "./chunk-GDMORQ2P.js";
+} from "./chunk-Y5ZSC2FB.js";
 import "./chunk-WYY34UWG.js";
 import "./chunk-WCQVDF3K.js";
 export {

package/dist/index.js

@@ -6,10 +6,10 @@ import {
 } from "./chunk-NQJNMKW5.js";
 import {
   bootstrap
-} from "./chunk-D76WCWAW.js";
+} from "./chunk-W35YEQOE.js";
 import {
   Application
-} from "./chunk-OKB76LY2.js";
+} from "./chunk-YRCR6Z5C.js";
 import {
   REQUEST_ID_HEADER,
   requestId
@@ -20,7 +20,7 @@ import {
 import {
   buildRoutes,
   getControllerPath
-} from "./chunk-S7DJ5HF3.js";
+} from "./chunk-E552HYEB.js";
 import {
   buildUploadMiddleware,
   cleanupFiles,
@@ -32,7 +32,7 @@ import {
 } from "./chunk-RPN7UFUO.js";
 import {
   RequestContext
-} from "./chunk-GDMORQ2P.js";
+} from "./chunk-Y5ZSC2FB.js";
 import {
   FILTER_OPERATORS,
   buildQueryParams,

package/dist/router-builder.js

@@ -1,10 +1,10 @@
 import {
   buildRoutes,
   getControllerPath
-} from "./chunk-S7DJ5HF3.js";
+} from "./chunk-E552HYEB.js";
 import "./chunk-LEILPDMW.js";
 import "./chunk-RPN7UFUO.js";
-import "./chunk-GDMORQ2P.js";
+import "./chunk-Y5ZSC2FB.js";
 import "./chunk-WYY34UWG.js";
 import "./chunk-WCQVDF3K.js";
 export {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@forinda/kickjs-http",
-  "version": "0.5.2",
+  "version": "0.6.0",
   "description": "Express 5 integration, router builder, RequestContext, and middleware for KickJS",
   "keywords": [
     "kickjs",
@@ -98,7 +98,7 @@
     "cookie-parser": "^1.4.7",
     "multer": "^2.1.1",
     "reflect-metadata": "^0.2.2",
-    "@forinda/kickjs-core": "0.5.2"
+    "@forinda/kickjs-core": "0.6.0"
   },
   "peerDependencies": {
     "express": "^5.1.0"

package/dist/chunk-OKB76LY2.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/application.ts"],"sourcesContent":["import http from 'node:http'\nimport express, { type Express, type RequestHandler } from 'express'\nimport {\n  Container,\n  createLogger,\n  type AppModuleClass,\n  type AppAdapter,\n  type AdapterMiddleware,\n} from '@forinda/kickjs-core'\nimport { buildRoutes } from './router-builder'\nimport { requestId } from './middleware/request-id'\nimport { notFoundHandler, errorHandler } from './middleware/error-handler'\n\nconst log = createLogger('Application')\n\n/**\n * A middleware entry in the declarative pipeline.\n * Can be a bare handler or an object with path scoping.\n */\nexport type MiddlewareEntry = RequestHandler | { path: string; handler: RequestHandler }\n\nexport interface ApplicationOptions {\n  /** Feature modules to load */\n  modules: AppModuleClass[]\n  /** Adapters that hook into the lifecycle (DB, Redis, Swagger, etc.) */\n  adapters?: AppAdapter[]\n  /** Server port (falls back to PORT env var, then 3000) */\n  port?: number\n  /** Global API prefix (default: '/api') */\n  apiPrefix?: string\n  /** Default API version (default: 1) — routes become /{prefix}/v{version}/{path} */\n  defaultVersion?: number\n\n  /**\n   * Global middleware pipeline. Declared in order.\n   * Replaces the hardcoded middleware stack — you control exactly what runs.\n   *\n   * @example\n   * ```ts\n   * bootstrap({\n   *   modules,\n   *   middleware: [\n   *     helmet(),\n   *     cors(),\n   *     compression(),\n   *     morgan('dev'),\n   *     express.json({ limit: '1mb' }),\n   *   ],\n   * })\n   * ```\n   *\n   * If omitted, a sensible default is applied:\n   *   requestId(), express.json({ limit: '100kb' })\n   */\n  middleware?: MiddlewareEntry[]\n\n  /** Express `trust proxy` setting */\n  trustProxy?: boolean | number | string | ((ip: string, hopIndex: number) => boolean)\n  /** Maximum JSON body size (only used when middleware is not provided) */\n  jsonLimit?: string | number\n}\n\n/**\n * The main application class. Wires together Express, the DI container,\n * feature modules, adapters, and the middleware pipeline.\n */\nexport class Application {\n  private app: Express\n  private container: Container\n  private httpServer: http.Server | null = null\n  private adapters: AppAdapter[]\n\n  constructor(private readonly options: ApplicationOptions) {\n    this.app = express()\n    this.container = Container.getInstance()\n    this.adapters = options.adapters ?? []\n  }\n\n  /**\n   * Full setup pipeline:\n   * 1. Adapter beforeMount hooks (early routes — docs, health)\n   * 2. Adapter middleware (phase: beforeGlobal)\n   * 3. Global middleware (user-declared or defaults)\n   * 4. Adapter middleware (phase: afterGlobal)\n   * 5. Module registration + DI bootstrap\n   * 6. Adapter middleware (phase: beforeRoutes)\n   * 7. Module route mounting\n   * 8. Adapter middleware (phase: afterRoutes)\n   * 9. Error handlers (notFound + global)\n   * 10. Adapter beforeStart hooks\n   */\n  setup(): void {\n    log.info('Bootstrapping application...')\n\n    // Collect adapter middleware by phase\n    const adapterMw = this.collectAdapterMiddleware()\n\n    // ── 1. Adapter beforeMount hooks ──────────────────────────────────\n    for (const adapter of this.adapters) {\n      adapter.beforeMount?.(this.app, this.container)\n    }\n\n    // ── 2. Hardened defaults ──────────────────────────────────────────\n    this.app.disable('x-powered-by')\n    this.app.set('trust proxy', this.options.trustProxy ?? false)\n\n    // ── 3. Adapter middleware: beforeGlobal ───────────────────────────\n    this.mountMiddlewareList(adapterMw.beforeGlobal)\n\n    // ── 4. Global middleware ─────────────────────────────────────────\n    if (this.options.middleware) {\n      // User-declared pipeline — full control\n      for (const entry of this.options.middleware) {\n        this.mountMiddlewareEntry(entry)\n      }\n    } else {\n      // Sensible defaults when no middleware declared\n      this.app.use(requestId())\n      this.app.use(express.json({ limit: this.options.jsonLimit ?? '100kb' }))\n    }\n\n    // ── 5. Adapter middleware: afterGlobal ────────────────────────────\n    this.mountMiddlewareList(adapterMw.afterGlobal)\n\n    // ── 6. Module registration + DI bootstrap ────────────────────────\n    const modules = this.options.modules.map((ModuleClass) => {\n      const mod = new ModuleClass()\n      mod.register(this.container)\n      return mod\n    })\n    this.container.bootstrap()\n\n    // ── 7. Adapter middleware: beforeRoutes ───────────────────────────\n    this.mountMiddlewareList(adapterMw.beforeRoutes)\n\n    // ── 8. Mount module routes with versioning ───────────────────────\n    const apiPrefix = this.options.apiPrefix ?? '/api'\n    const defaultVersion = this.options.defaultVersion ?? 1\n\n    for (const mod of modules) {\n      const result = mod.routes()\n      const routeSets = Array.isArray(result) ? result : [result]\n\n      for (const route of routeSets) {\n        const version = route.version ?? defaultVersion\n        const mountPath = `${apiPrefix}/v${version}${route.path}`\n        this.app.use(mountPath, route.router)\n\n        // Notify adapters (e.g. SwaggerAdapter for OpenAPI spec generation)\n        if (route.controller) {\n          for (const adapter of this.adapters) {\n            adapter.onRouteMount?.(route.controller, mountPath)\n          }\n        }\n      }\n    }\n\n    // ── 9. Adapter middleware: afterRoutes ────────────────────────────\n    this.mountMiddlewareList(adapterMw.afterRoutes)\n\n    // ── 10. Error handlers ───────────────────────────────────────────\n    this.app.use(notFoundHandler())\n    this.app.use(errorHandler())\n\n    // ── 11. Adapter beforeStart hooks ────────────────────────────────\n    for (const adapter of this.adapters) {\n      adapter.beforeStart?.(this.app, this.container)\n    }\n  }\n\n  /** Start the HTTP server — fails fast if port is in use */\n  start(): void {\n    this.setup()\n\n    const port = this.options.port ?? parseInt(process.env.PORT || '3000', 10)\n    this.httpServer = http.createServer(this.app)\n\n    this.httpServer.on('error', (err: NodeJS.ErrnoException) => {\n      if (err.code === 'EADDRINUSE') {\n        log.error(\n          `Port ${port} is already in use. Kill the existing process or use a different port:\\n` +\n            `  PORT=${port + 1} kick dev\\n` +\n            `  lsof -i :${port}   # find what's using it\\n` +\n            `  kill <PID>          # stop it`,\n        )\n        process.exit(1)\n      }\n      throw err\n    })\n\n    this.httpServer.listen(port, () => {\n      log.info(`Server running on http://localhost:${port}`)\n\n      for (const adapter of this.adapters) {\n        adapter.afterStart?.(this.httpServer!, this.container)\n      }\n    })\n  }\n\n  /** HMR rebuild: swap Express handler without restarting the server */\n  rebuild(): void {\n    // Reset the DI container so singletons are re-created with fresh code\n    Container.reset()\n    this.container = Container.getInstance()\n\n    this.app = express()\n    this.setup()\n\n    if (this.httpServer) {\n      this.httpServer.removeAllListeners('request')\n      this.httpServer.on('request', this.app)\n      log.info('HMR: Express app rebuilt and swapped')\n    }\n  }\n\n  /** Graceful shutdown — runs all adapter shutdowns in parallel, resilient to failures */\n  async shutdown(): Promise<void> {\n    log.info('Shutting down...')\n\n    // Run all adapter shutdowns concurrently — don't let one failure block the rest\n    const results = await Promise.allSettled(\n      this.adapters.map((adapter) => Promise.resolve(adapter.shutdown?.())),\n    )\n    for (const result of results) {\n      if (result.status === 'rejected') {\n        log.error({ err: result.reason }, 'Adapter shutdown failed')\n      }\n    }\n\n    if (this.httpServer) {\n      await new Promise<void>((resolve) => this.httpServer!.close(() => resolve()))\n    }\n  }\n\n  getExpressApp(): Express {\n    return this.app\n  }\n\n  getHttpServer(): http.Server | null {\n    return this.httpServer\n  }\n\n  // ── Internal helpers ────────────────────────────────────────────────\n\n  private collectAdapterMiddleware() {\n    const result = {\n      beforeGlobal: [] as AdapterMiddleware[],\n      afterGlobal: [] as AdapterMiddleware[],\n      beforeRoutes: [] as AdapterMiddleware[],\n      afterRoutes: [] as AdapterMiddleware[],\n    }\n\n    for (const adapter of this.adapters) {\n      const entries = adapter.middleware?.() ?? []\n      for (const entry of entries) {\n        const phase = entry.phase ?? 'afterGlobal'\n        result[phase].push(entry)\n      }\n    }\n\n    return result\n  }\n\n  private mountMiddlewareList(entries: AdapterMiddleware[]): void {\n    for (const entry of entries) {\n      if (entry.path) {\n        this.app.use(entry.path, entry.handler)\n      } else {\n        this.app.use(entry.handler)\n      }\n    }\n  }\n\n  private mountMiddlewareEntry(entry: MiddlewareEntry): void {\n    if (typeof entry === 'function') {\n      this.app.use(entry)\n    } else {\n      this.app.use(entry.path, entry.handler)\n    }\n  }\n}\n"],"mappings":"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","names":["http","express","Container","createLogger","log","createLogger","Application","app","container","httpServer","adapters","options","express","Container","getInstance","setup","info","adapterMw","collectAdapterMiddleware","adapter","beforeMount","disable","set","trustProxy","mountMiddlewareList","beforeGlobal","middleware","entry","mountMiddlewareEntry","use","requestId","json","limit","jsonLimit","afterGlobal","modules","map","ModuleClass","mod","register","bootstrap","beforeRoutes","apiPrefix","defaultVersion","result","routes","routeSets","Array","isArray","route","version","mountPath","path","router","controller","onRouteMount","afterRoutes","notFoundHandler","errorHandler","beforeStart","start","port","parseInt","process","env","PORT","http","createServer","on","err","code","error","exit","listen","afterStart","rebuild","reset","removeAllListeners","shutdown","results","Promise","allSettled","resolve","status","reason","close","getExpressApp","getHttpServer","entries","phase","push","handler"]}