@forinda/kickjs-http 0.7.0 → 1.0.0

package/dist/{chunk-E552HYEB.js → chunk-2OSVROBK.js}

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

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

@@ -107,6 +107,22 @@ var RequestContext = class {
     return this.res.send(buffer);
   }
   /**
+  * Render a template using the registered view engine (EJS, Pug, Handlebars, etc.).
+  * Requires a ViewAdapter to be configured in bootstrap().
+  *
+  * @param template - Template name (without extension, relative to viewsDir)
+  * @param data - Data to pass to the template
+  *
+  * @example
+  * ```ts
+  * ctx.render('dashboard', { user, title: 'Dashboard' })
+  * ctx.render('emails/welcome', { name: 'Alice' })
+  * ```
+  */
+  render(template, data = {}) {
+    return this.res.render(template, data);
+  }
+  /**
   * Parse query params and return a standardized paginated response.
   * Calls `ctx.qs()` internally, then wraps your data with pagination meta.
   *
@@ -211,4 +227,4 @@ var RequestContext = class {
 export {
   RequestContext
 };
-//# sourceMappingURL=chunk-Y5ZSC2FB.js.map
+//# sourceMappingURL=chunk-IUT42U72.js.map

package/dist/chunk-IUT42U72.js.map

@@ -0,0 +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   * Render a template using the registered view engine (EJS, Pug, Handlebars, etc.).\n   * Requires a ViewAdapter to be configured in bootstrap().\n   *\n   * @param template - Template name (without extension, relative to viewsDir)\n   * @param data - Data to pass to the template\n   *\n   * @example\n   * ```ts\n   * ctx.render('dashboard', { user, title: 'Dashboard' })\n   * ctx.render('emails/welcome', { name: 'Alice' })\n   * ```\n   */\n  render(template: string, data: Record<string, any> = {}) {\n    return this.res.render(template, data)\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","render","template","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/context.d.ts

@@ -52,6 +52,20 @@ declare class RequestContext<TBody = any, TParams = any, TQuery = any> {
     badRequest(message: string): Response<any, Record<string, any>>;
     html(content: string, status?: number): Response<any, Record<string, any>>;
     download(buffer: Buffer, filename: string, contentType?: string): Response<any, Record<string, any>>;
+    /**
+     * Render a template using the registered view engine (EJS, Pug, Handlebars, etc.).
+     * Requires a ViewAdapter to be configured in bootstrap().
+     *
+     * @param template - Template name (without extension, relative to viewsDir)
+     * @param data - Data to pass to the template
+     *
+     * @example
+     * ```ts
+     * ctx.render('dashboard', { user, title: 'Dashboard' })
+     * ctx.render('emails/welcome', { name: 'Alice' })
+     * ```
+     */
+    render(template: string, data?: Record<string, any>): void;
     /**
      * Parse query params and return a standardized paginated response.
      * Calls `ctx.qs()` internally, then wraps your data with pagination meta.

package/dist/context.js

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

package/dist/index.js

@@ -20,7 +20,7 @@ import {
 import {
   buildRoutes,
   getControllerPath
-} from "./chunk-E552HYEB.js";
+} from "./chunk-2OSVROBK.js";
 import {
   buildUploadMiddleware,
   cleanupFiles,
@@ -32,7 +32,7 @@ import {
 } from "./chunk-RPN7UFUO.js";
 import {
   RequestContext
-} from "./chunk-Y5ZSC2FB.js";
+} from "./chunk-IUT42U72.js";
 import {
   FILTER_OPERATORS,
   buildQueryParams,

package/dist/middleware/views.d.ts

@@ -0,0 +1,58 @@
+import { AppAdapter, Container } from '@forinda/kickjs-core';
+
+interface ViewAdapterOptions {
+    /**
+     * Template engine — pass the engine module or a render function.
+     * Supported engines: ejs, pug, handlebars, nunjucks, or any
+     * Express-compatible engine with a __express property.
+     *
+     * @example
+     * ```ts
+     * import ejs from 'ejs'
+     * new ViewAdapter({ engine: ejs, ext: 'ejs' })
+     *
+     * import pug from 'pug'
+     * new ViewAdapter({ engine: pug, ext: 'pug' })
+     * ```
+     */
+    engine: any;
+    /** File extension for templates (e.g., 'ejs', 'pug', 'hbs') */
+    ext: string;
+    /** Directory containing template files (default: 'src/views') */
+    viewsDir?: string;
+    /** Default layout template (optional — depends on engine) */
+    layout?: string;
+}
+/**
+ * View/template adapter — pluggable template engine support for KickJS.
+ *
+ * Registers an Express view engine and sets the views directory.
+ * Use `ctx.render()` in controllers to render templates.
+ *
+ * @example
+ * ```ts
+ * import ejs from 'ejs'
+ * import { ViewAdapter } from '@forinda/kickjs-http/views'
+ *
+ * bootstrap({
+ *   modules,
+ *   adapters: [
+ *     new ViewAdapter({ engine: ejs, ext: 'ejs', viewsDir: 'src/views' }),
+ *   ],
+ * })
+ *
+ * // In a controller:
+ * @Get('/dashboard')
+ * async dashboard(ctx: RequestContext) {
+ *   ctx.render('dashboard', { user: currentUser, title: 'Dashboard' })
+ * }
+ * ```
+ */
+declare class ViewAdapter implements AppAdapter {
+    private options;
+    name: string;
+    constructor(options: ViewAdapterOptions);
+    beforeMount(app: any, _container: Container): void;
+}
+
+export { ViewAdapter, type ViewAdapterOptions };

package/dist/middleware/views.js

@@ -0,0 +1,40 @@
+import {
+  __name
+} from "../chunk-WCQVDF3K.js";
+
+// src/middleware/views.ts
+import { resolve } from "path";
+import { Logger } from "@forinda/kickjs-core";
+var log = Logger.for("ViewEngine");
+var ViewAdapter = class {
+  static {
+    __name(this, "ViewAdapter");
+  }
+  options;
+  name = "ViewAdapter";
+  constructor(options) {
+    this.options = options;
+  }
+  beforeMount(app, _container) {
+    const { engine, ext, viewsDir = "src/views" } = this.options;
+    if (engine.__express) {
+      app.engine(ext, engine.__express);
+    } else if (typeof engine.renderFile === "function") {
+      app.engine(ext, (path, options, callback) => {
+        engine.renderFile(path, options, callback);
+      });
+    } else if (typeof engine === "function") {
+      app.engine(ext, engine);
+    } else {
+      log.warn(`Engine for .${ext} does not have __express or renderFile. Trying as-is.`);
+      app.engine(ext, engine);
+    }
+    app.set("view engine", ext);
+    app.set("views", resolve(viewsDir));
+    log.info(`View engine: ${ext} (${resolve(viewsDir)})`);
+  }
+};
+export {
+  ViewAdapter
+};
+//# sourceMappingURL=views.js.map

package/dist/middleware/views.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/middleware/views.ts"],"sourcesContent":["import { resolve } from 'node:path'\nimport { Logger, type AppAdapter, type Container } from '@forinda/kickjs-core'\n\nconst log = Logger.for('ViewEngine')\n\nexport interface ViewAdapterOptions {\n  /**\n   * Template engine — pass the engine module or a render function.\n   * Supported engines: ejs, pug, handlebars, nunjucks, or any\n   * Express-compatible engine with a __express property.\n   *\n   * @example\n   * ```ts\n   * import ejs from 'ejs'\n   * new ViewAdapter({ engine: ejs, ext: 'ejs' })\n   *\n   * import pug from 'pug'\n   * new ViewAdapter({ engine: pug, ext: 'pug' })\n   * ```\n   */\n  engine: any\n\n  /** File extension for templates (e.g., 'ejs', 'pug', 'hbs') */\n  ext: string\n\n  /** Directory containing template files (default: 'src/views') */\n  viewsDir?: string\n\n  /** Default layout template (optional — depends on engine) */\n  layout?: string\n}\n\n/**\n * View/template adapter — pluggable template engine support for KickJS.\n *\n * Registers an Express view engine and sets the views directory.\n * Use `ctx.render()` in controllers to render templates.\n *\n * @example\n * ```ts\n * import ejs from 'ejs'\n * import { ViewAdapter } from '@forinda/kickjs-http/views'\n *\n * bootstrap({\n *   modules,\n *   adapters: [\n *     new ViewAdapter({ engine: ejs, ext: 'ejs', viewsDir: 'src/views' }),\n *   ],\n * })\n *\n * // In a controller:\n * @Get('/dashboard')\n * async dashboard(ctx: RequestContext) {\n *   ctx.render('dashboard', { user: currentUser, title: 'Dashboard' })\n * }\n * ```\n */\nexport class ViewAdapter implements AppAdapter {\n  name = 'ViewAdapter'\n\n  constructor(private options: ViewAdapterOptions) {}\n\n  beforeMount(app: any, _container: Container): void {\n    const { engine, ext, viewsDir = 'src/views' } = this.options\n\n    // Register the engine\n    if (engine.__express) {\n      // EJS, Pug — have __express method\n      app.engine(ext, engine.__express)\n    } else if (typeof engine.renderFile === 'function') {\n      // Engines with renderFile (nunjucks-style)\n      app.engine(ext, (path: string, options: any, callback: Function) => {\n        engine.renderFile(path, options, callback)\n      })\n    } else if (typeof engine === 'function') {\n      // Custom render function: (path, options, callback) => void\n      app.engine(ext, engine)\n    } else {\n      log.warn(`Engine for .${ext} does not have __express or renderFile. Trying as-is.`)\n      app.engine(ext, engine)\n    }\n\n    app.set('view engine', ext)\n    app.set('views', resolve(viewsDir))\n\n    log.info(`View engine: ${ext} (${resolve(viewsDir)})`)\n  }\n}\n"],"mappings":";;;;;AAAA,SAASA,eAAe;AACxB,SAASC,cAA+C;AAExD,IAAMC,MAAMC,OAAOC,IAAI,YAAA;AAsDhB,IAAMC,cAAN,MAAMA;EAzDb,OAyDaA;;;;EACXC,OAAO;EAEP,YAAoBC,SAA6B;SAA7BA,UAAAA;EAA8B;EAElDC,YAAYC,KAAUC,YAA6B;AACjD,UAAM,EAAEC,QAAQC,KAAKC,WAAW,YAAW,IAAK,KAAKN;AAGrD,QAAII,OAAOG,WAAW;AAEpBL,UAAIE,OAAOC,KAAKD,OAAOG,SAAS;IAClC,WAAW,OAAOH,OAAOI,eAAe,YAAY;AAElDN,UAAIE,OAAOC,KAAK,CAACI,MAAcT,SAAcU,aAAAA;AAC3CN,eAAOI,WAAWC,MAAMT,SAASU,QAAAA;MACnC,CAAA;IACF,WAAW,OAAON,WAAW,YAAY;AAEvCF,UAAIE,OAAOC,KAAKD,MAAAA;IAClB,OAAO;AACLT,UAAIgB,KAAK,eAAeN,GAAAA,uDAA0D;AAClFH,UAAIE,OAAOC,KAAKD,MAAAA;IAClB;AAEAF,QAAIU,IAAI,eAAeP,GAAAA;AACvBH,QAAIU,IAAI,SAASC,QAAQP,QAAAA,CAAAA;AAEzBX,QAAImB,KAAK,gBAAgBT,GAAAA,KAAQQ,QAAQP,QAAAA,CAAAA,GAAY;EACvD;AACF;","names":["resolve","Logger","log","Logger","for","ViewAdapter","name","options","beforeMount","app","_container","engine","ext","viewsDir","__express","renderFile","path","callback","warn","set","resolve","info"]}

package/dist/router-builder.js

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@forinda/kickjs-http",
-  "version": "0.7.0",
+  "version": "1.0.0",
   "description": "Express 5 integration, router builder, RequestContext, and middleware for KickJS",
   "keywords": [
     "kickjs",
@@ -89,6 +89,10 @@
     "./query": {
       "import": "./dist/query/index.js",
       "types": "./dist/query/index.d.ts"
+    },
+    "./views": {
+      "import": "./dist/middleware/views.js",
+      "types": "./dist/middleware/views.d.ts"
     }
   },
   "files": [
@@ -98,7 +102,7 @@
     "cookie-parser": "^1.4.7",
     "multer": "^2.1.1",
     "reflect-metadata": "^0.2.2",
-    "@forinda/kickjs-core": "0.7.0"
+    "@forinda/kickjs-core": "1.0.0"
   },
   "peerDependencies": {
     "express": "^5.1.0"

package/dist/chunk-Y5ZSC2FB.js.map

@@ -1 +0,0 @@
-{"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"]}