@forinda/kickjs-http 0.3.0

package/dist/chunk-KAWXFLFS.js

@@ -0,0 +1,50 @@
+import {
+  Application
+} from "./chunk-P3YCN5LK.js";
+import {
+  __name
+} from "./chunk-7QVYU63E.js";
+
+// src/bootstrap.ts
+import { createLogger } from "@forinda/kickjs-core";
+var log = createLogger("Process");
+function bootstrap(options) {
+  const g = globalThis;
+  if (!g.__kickBootstrapped) {
+    process.on("uncaughtException", (err) => {
+      log.error(err, "Uncaught exception");
+    });
+    process.on("unhandledRejection", (reason) => {
+      log.error(reason, "Unhandled rejection");
+    });
+    for (const signal of [
+      "SIGINT",
+      "SIGTERM"
+    ]) {
+      process.on(signal, async () => {
+        log.info(`Received ${signal}, shutting down...`);
+        if (g.__app) await g.__app.shutdown();
+        process.exit(0);
+      });
+    }
+    g.__kickBootstrapped = true;
+  }
+  if (g.__app) {
+    log.info("HMR: Rebuilding application...");
+    g.__app.rebuild();
+    return;
+  }
+  const app = new Application(options);
+  g.__app = app;
+  app.start();
+  const meta = import.meta;
+  if (meta.hot) {
+    meta.hot.accept();
+  }
+}
+__name(bootstrap, "bootstrap");
+
+export {
+  bootstrap
+};
+//# sourceMappingURL=chunk-KAWXFLFS.js.map

package/dist/chunk-KAWXFLFS.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/bootstrap.ts"],"sourcesContent":["import { createLogger } from '@forinda/kickjs-core'\nimport { Application, type ApplicationOptions } from './application'\n\nconst log = createLogger('Process')\n\n/**\n * Bootstrap a KickJS application with zero boilerplate.\n *\n * Handles:\n * - Vite HMR (hot-swaps Express handler without restarting the server)\n * - Graceful shutdown on SIGINT / SIGTERM\n * - Global uncaughtException / unhandledRejection handlers\n * - globalThis app storage for HMR rebuild\n *\n * @example\n * ```ts\n * // src/index.ts — that's it, the whole file\n * import 'reflect-metadata'\n * import { bootstrap } from '@forinda/kickjs-http'\n * import { modules } from './modules'\n *\n * bootstrap({ modules })\n * ```\n */\nexport function bootstrap(options: ApplicationOptions): void {\n  const g = globalThis as any\n\n  // ── Global error handlers ────────────────────────────────────────────\n  if (!g.__kickBootstrapped) {\n    process.on('uncaughtException', (err) => {\n      log.error(err, 'Uncaught exception')\n    })\n\n    process.on('unhandledRejection', (reason) => {\n      log.error(reason as any, 'Unhandled rejection')\n    })\n\n    for (const signal of ['SIGINT', 'SIGTERM'] as const) {\n      process.on(signal, async () => {\n        log.info(`Received ${signal}, shutting down...`)\n        if (g.__app) await g.__app.shutdown()\n        process.exit(0)\n      })\n    }\n\n    g.__kickBootstrapped = true\n  }\n\n  // ── HMR rebuild ──────────────────────────────────────────────────────\n  if (g.__app) {\n    log.info('HMR: Rebuilding application...')\n    g.__app.rebuild()\n    return\n  }\n\n  // ── First boot ───────────────────────────────────────────────────────\n  const app = new Application(options)\n  g.__app = app\n  app.start()\n\n  // ── Vite HMR acceptance ──────────────────────────────────────────────\n  const meta = import.meta as any\n  if (meta.hot) {\n    meta.hot.accept()\n  }\n}\n"],"mappings":";;;;;;;;AAAA,SAASA,oBAAoB;AAG7B,IAAMC,MAAMC,aAAa,SAAA;AAqBlB,SAASC,UAAUC,SAA2B;AACnD,QAAMC,IAAIC;AAGV,MAAI,CAACD,EAAEE,oBAAoB;AACzBC,YAAQC,GAAG,qBAAqB,CAACC,QAAAA;AAC/BT,UAAIU,MAAMD,KAAK,oBAAA;IACjB,CAAA;AAEAF,YAAQC,GAAG,sBAAsB,CAACG,WAAAA;AAChCX,UAAIU,MAAMC,QAAe,qBAAA;IAC3B,CAAA;AAEA,eAAWC,UAAU;MAAC;MAAU;OAAqB;AACnDL,cAAQC,GAAGI,QAAQ,YAAA;AACjBZ,YAAIa,KAAK,YAAYD,MAAAA,oBAA0B;AAC/C,YAAIR,EAAEU,MAAO,OAAMV,EAAEU,MAAMC,SAAQ;AACnCR,gBAAQS,KAAK,CAAA;MACf,CAAA;IACF;AAEAZ,MAAEE,qBAAqB;EACzB;AAGA,MAAIF,EAAEU,OAAO;AACXd,QAAIa,KAAK,gCAAA;AACTT,MAAEU,MAAMG,QAAO;AACf;EACF;AAGA,QAAMC,MAAM,IAAIC,YAAYhB,OAAAA;AAC5BC,IAAEU,QAAQI;AACVA,MAAIE,MAAK;AAGT,QAAMC,OAAO;AACb,MAAIA,KAAKC,KAAK;AACZD,SAAKC,IAAIC,OAAM;EACjB;AACF;AAzCgBrB;","names":["createLogger","log","createLogger","bootstrap","options","g","globalThis","__kickBootstrapped","process","on","err","error","reason","signal","info","__app","shutdown","exit","rebuild","app","Application","start","meta","hot","accept"]}

package/dist/chunk-P3YCN5LK.js

@@ -0,0 +1,196 @@
+import {
+  errorHandler,
+  notFoundHandler
+} from "./chunk-BNWCVQQH.js";
+import {
+  requestId
+} from "./chunk-ZI52TGQ4.js";
+import {
+  __name
+} from "./chunk-7QVYU63E.js";
+
+// src/application.ts
+import http from "http";
+import express from "express";
+import { Container, createLogger } from "@forinda/kickjs-core";
+var log = createLogger("Application");
+var Application = class {
+  static {
+    __name(this, "Application");
+  }
+  options;
+  app;
+  container;
+  httpServer = null;
+  adapters;
+  constructor(options) {
+    this.options = options;
+    this.app = express();
+    this.container = Container.getInstance();
+    this.adapters = options.adapters ?? [];
+  }
+  /**
+  * Full setup pipeline:
+  * 1. Adapter beforeMount hooks (early routes — docs, health)
+  * 2. Adapter middleware (phase: beforeGlobal)
+  * 3. Global middleware (user-declared or defaults)
+  * 4. Adapter middleware (phase: afterGlobal)
+  * 5. Module registration + DI bootstrap
+  * 6. Adapter middleware (phase: beforeRoutes)
+  * 7. Module route mounting
+  * 8. Adapter middleware (phase: afterRoutes)
+  * 9. Error handlers (notFound + global)
+  * 10. Adapter beforeStart hooks
+  */
+  setup() {
+    log.info("Bootstrapping application...");
+    const adapterMw = this.collectAdapterMiddleware();
+    for (const adapter of this.adapters) {
+      adapter.beforeMount?.(this.app, this.container);
+    }
+    this.app.disable("x-powered-by");
+    this.app.set("trust proxy", this.options.trustProxy ?? false);
+    this.mountMiddlewareList(adapterMw.beforeGlobal);
+    if (this.options.middleware) {
+      for (const entry of this.options.middleware) {
+        this.mountMiddlewareEntry(entry);
+      }
+    } else {
+      this.app.use(requestId());
+      this.app.use(express.json({
+        limit: this.options.jsonLimit ?? "100kb"
+      }));
+    }
+    this.mountMiddlewareList(adapterMw.afterGlobal);
+    const modules = this.options.modules.map((ModuleClass) => {
+      const mod = new ModuleClass();
+      mod.register(this.container);
+      return mod;
+    });
+    this.container.bootstrap();
+    this.mountMiddlewareList(adapterMw.beforeRoutes);
+    const apiPrefix = this.options.apiPrefix ?? "/api";
+    const defaultVersion = this.options.defaultVersion ?? 1;
+    for (const mod of modules) {
+      const result = mod.routes();
+      const routeSets = Array.isArray(result) ? result : [
+        result
+      ];
+      for (const route of routeSets) {
+        const version = route.version ?? defaultVersion;
+        const mountPath = `${apiPrefix}/v${version}${route.path}`;
+        this.app.use(mountPath, route.router);
+        if (route.controller) {
+          for (const adapter of this.adapters) {
+            adapter.onRouteMount?.(route.controller, mountPath);
+          }
+        }
+      }
+    }
+    this.mountMiddlewareList(adapterMw.afterRoutes);
+    this.app.use(notFoundHandler());
+    this.app.use(errorHandler());
+    for (const adapter of this.adapters) {
+      adapter.beforeStart?.(this.app, this.container);
+    }
+  }
+  /** Start the HTTP server, retrying up to 3 times on port conflict */
+  start() {
+    this.setup();
+    const basePort = this.options.port ?? parseInt(process.env.PORT || "3000", 10);
+    const maxRetries = 3;
+    const tryListen = /* @__PURE__ */ __name((port, attempt) => {
+      this.httpServer = http.createServer(this.app);
+      this.httpServer.on("error", (err) => {
+        if (err.code === "EADDRINUSE" && attempt < maxRetries) {
+          const nextPort = port + 1;
+          log.warn(`Port ${port} in use, trying ${nextPort}... (${attempt + 1}/${maxRetries})`);
+          tryListen(nextPort, attempt + 1);
+        } else {
+          throw err;
+        }
+      });
+      this.httpServer.listen(port, () => {
+        if (port !== basePort) {
+          log.warn(`Port ${basePort} was in use, using ${port} instead`);
+        }
+        log.info(`Server running on http://localhost:${port}`);
+        for (const adapter of this.adapters) {
+          adapter.afterStart?.(this.httpServer, this.container);
+        }
+      });
+    }, "tryListen");
+    tryListen(basePort, 0);
+  }
+  /** HMR rebuild: swap Express handler without restarting the server */
+  rebuild() {
+    Container.reset();
+    this.container = Container.getInstance();
+    this.app = express();
+    this.setup();
+    if (this.httpServer) {
+      this.httpServer.removeAllListeners("request");
+      this.httpServer.on("request", this.app);
+      log.info("HMR: Express app rebuilt and swapped");
+    }
+  }
+  /** 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?.())));
+    for (const result of results) {
+      if (result.status === "rejected") {
+        log.error({
+          err: result.reason
+        }, "Adapter shutdown failed");
+      }
+    }
+    if (this.httpServer) {
+      await new Promise((resolve) => this.httpServer.close(() => resolve()));
+    }
+  }
+  getExpressApp() {
+    return this.app;
+  }
+  getHttpServer() {
+    return this.httpServer;
+  }
+  // ── Internal helpers ────────────────────────────────────────────────
+  collectAdapterMiddleware() {
+    const result = {
+      beforeGlobal: [],
+      afterGlobal: [],
+      beforeRoutes: [],
+      afterRoutes: []
+    };
+    for (const adapter of this.adapters) {
+      const entries = adapter.middleware?.() ?? [];
+      for (const entry of entries) {
+        const phase = entry.phase ?? "afterGlobal";
+        result[phase].push(entry);
+      }
+    }
+    return result;
+  }
+  mountMiddlewareList(entries) {
+    for (const entry of entries) {
+      if (entry.path) {
+        this.app.use(entry.path, entry.handler);
+      } else {
+        this.app.use(entry.handler);
+      }
+    }
+  }
+  mountMiddlewareEntry(entry) {
+    if (typeof entry === "function") {
+      this.app.use(entry);
+    } else {
+      this.app.use(entry.path, entry.handler);
+    }
+  }
+};
+
+export {
+  Application
+};
+//# sourceMappingURL=chunk-P3YCN5LK.js.map

package/dist/chunk-P3YCN5LK.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} 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, retrying up to 3 times on port conflict */\n  start(): void {\n    this.setup()\n\n    const basePort = this.options.port ?? parseInt(process.env.PORT || '3000', 10)\n    const maxRetries = 3\n\n    const tryListen = (port: number, attempt: number) => {\n      this.httpServer = http.createServer(this.app)\n\n      this.httpServer.on('error', (err: NodeJS.ErrnoException) => {\n        if (err.code === 'EADDRINUSE' && attempt < maxRetries) {\n          const nextPort = port + 1\n          log.warn(`Port ${port} in use, trying ${nextPort}... (${attempt + 1}/${maxRetries})`)\n          tryListen(nextPort, attempt + 1)\n        } else {\n          throw err\n        }\n      })\n\n      this.httpServer.listen(port, () => {\n        if (port !== basePort) {\n          log.warn(`Port ${basePort} was in use, using ${port} instead`)\n        }\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    tryListen(basePort, 0)\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","basePort","port","parseInt","process","env","PORT","maxRetries","tryListen","attempt","http","createServer","on","err","code","nextPort","warn","listen","afterStart","rebuild","reset","removeAllListeners","shutdown","results","Promise","allSettled","resolve","status","error","reason","close","getExpressApp","getHttpServer","entries","phase","push","handler"]}

package/dist/chunk-RZUH6NBM.js

@@ -0,0 +1,110 @@
+import {
+  parseQuery
+} from "./chunk-JM7X7SAD.js";
+import {
+  __name
+} from "./chunk-7QVYU63E.js";
+
+// src/context.ts
+var RequestContext = class {
+  static {
+    __name(this, "RequestContext");
+  }
+  req;
+  res;
+  next;
+  metadata = /* @__PURE__ */ new Map();
+  constructor(req, res, next) {
+    this.req = req;
+    this.res = res;
+    this.next = next;
+  }
+  // ── Request Data ────────────────────────────────────────────────────
+  get body() {
+    return this.req.body;
+  }
+  get params() {
+    return this.req.params;
+  }
+  get query() {
+    return this.req.query;
+  }
+  get headers() {
+    return this.req.headers;
+  }
+  get requestId() {
+    return this.req.requestId ?? this.req.headers["x-request-id"];
+  }
+  // ── Query String Parsing ───────────────────────────────────────────
+  /**
+  * Parse the request query string into structured filters, sort, pagination, and search.
+  * Pass the result to an ORM query builder adapter (Drizzle, Prisma, Sequelize, etc.).
+  *
+  * @param fieldConfig - Optional whitelist for filterable, sortable, and searchable fields
+  *
+  * @example
+  * ```ts
+  * @Get('/')
+  * async list(ctx: RequestContext) {
+  *   const parsed = ctx.qs({
+  *     filterable: ['status', 'priority'],
+  *     sortable: ['createdAt', 'title'],
+  *   })
+  *   const q = drizzleAdapter.build(parsed, { columns })
+  *   // ... use q.where, q.orderBy, q.limit, q.offset
+  * }
+  * ```
+  */
+  qs(fieldConfig) {
+    return parseQuery(this.req.query, fieldConfig);
+  }
+  // ── File Uploads ────────────────────────────────────────────────────
+  /** Single uploaded file (requires @FileUpload({ mode: 'single' })) */
+  get file() {
+    return this.req.file;
+  }
+  /** Array of uploaded files (requires @FileUpload({ mode: 'array' })) */
+  get files() {
+    return this.req.files;
+  }
+  // ── Metadata Store ──────────────────────────────────────────────────
+  get(key) {
+    return this.metadata.get(key);
+  }
+  set(key, value) {
+    this.metadata.set(key, value);
+  }
+  // ── Response Helpers ────────────────────────────────────────────────
+  json(data, status = 200) {
+    return this.res.status(status).json(data);
+  }
+  created(data) {
+    return this.res.status(201).json(data);
+  }
+  noContent() {
+    return this.res.status(204).end();
+  }
+  notFound(message = "Not Found") {
+    return this.res.status(404).json({
+      message
+    });
+  }
+  badRequest(message) {
+    return this.res.status(400).json({
+      message
+    });
+  }
+  html(content, status = 200) {
+    return this.res.status(status).type("html").send(content);
+  }
+  download(buffer, filename, contentType = "application/octet-stream") {
+    this.res.setHeader("Content-Disposition", `attachment; filename="${filename}"`);
+    this.res.setHeader("Content-Type", contentType);
+    return this.res.send(buffer);
+  }
+};
+
+export {
+  RequestContext
+};
+//# sourceMappingURL=chunk-RZUH6NBM.js.map

package/dist/chunk-RZUH6NBM.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/context.ts"],"sourcesContent":["import type { Request, Response, NextFunction } from 'express'\nimport { parseQuery, type ParsedQuery, type QueryFieldConfig } 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  // ── 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"],"mappings":";;;;;;;;AAOO,IAAMA,iBAAN,MAAMA;EANb,OAMaA;;;;;;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;;;;;;;;;;;;;;;;;;;;;EAuBAE,GAAGC,aAA6C;AAC9C,WAAOC,WAAW,KAAKV,IAAIK,OAA8BI,WAAAA;EAC3D;;;EAKA,IAAIE,OAAY;AACd,WAAQ,KAAKX,IAAYW;EAC3B;;EAGA,IAAIC,QAA2B;AAC7B,WAAQ,KAAKZ,IAAYY;EAC3B;;EAIAC,IAAaC,KAA4B;AACvC,WAAO,KAAKhB,SAASe,IAAIC,GAAAA;EAC3B;EAEAC,IAAID,KAAaE,OAAkB;AACjC,SAAKlB,SAASiB,IAAID,KAAKE,KAAAA;EACzB;;EAIAC,KAAKC,MAAWC,SAAS,KAAK;AAC5B,WAAO,KAAKlB,IAAIkB,OAAOA,MAAAA,EAAQF,KAAKC,IAAAA;EACtC;EAEAE,QAAQF,MAAW;AACjB,WAAO,KAAKjB,IAAIkB,OAAO,GAAA,EAAKF,KAAKC,IAAAA;EACnC;EAEAG,YAAY;AACV,WAAO,KAAKpB,IAAIkB,OAAO,GAAA,EAAKG,IAAG;EACjC;EAEAC,SAASC,UAAU,aAAa;AAC9B,WAAO,KAAKvB,IAAIkB,OAAO,GAAA,EAAKF,KAAK;MAAEO;IAAQ,CAAA;EAC7C;EAEAC,WAAWD,SAAiB;AAC1B,WAAO,KAAKvB,IAAIkB,OAAO,GAAA,EAAKF,KAAK;MAAEO;IAAQ,CAAA;EAC7C;EAEAE,KAAKC,SAAiBR,SAAS,KAAK;AAClC,WAAO,KAAKlB,IAAIkB,OAAOA,MAAAA,EAAQS,KAAK,MAAA,EAAQC,KAAKF,OAAAA;EACnD;EAEAG,SAASC,QAAgBC,UAAkBC,cAAc,4BAA4B;AACnF,SAAKhC,IAAIiC,UAAU,uBAAuB,yBAAyBF,QAAAA,GAAW;AAC9E,SAAK/B,IAAIiC,UAAU,gBAAgBD,WAAAA;AACnC,WAAO,KAAKhC,IAAI4B,KAAKE,MAAAA;EACvB;AACF;","names":["RequestContext","metadata","Map","req","res","next","body","params","query","headers","requestId","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"]}

package/dist/chunk-U2JYL2NW.js

@@ -0,0 +1,62 @@
+import {
+  validate
+} from "./chunk-JD2RKDKH.js";
+import {
+  RequestContext
+} from "./chunk-RZUH6NBM.js";
+import {
+  __name
+} from "./chunk-7QVYU63E.js";
+
+// src/router-builder.ts
+import "reflect-metadata";
+import { Router } from "express";
+import { Container, METADATA } from "@forinda/kickjs-core";
+function getControllerPath(controllerClass) {
+  return Reflect.getMetadata(METADATA.CONTROLLER_PATH, controllerClass) || "/";
+}
+__name(getControllerPath, "getControllerPath");
+function buildRoutes(controllerClass) {
+  const router = Router();
+  const container = Container.getInstance();
+  const controllerPath = getControllerPath(controllerClass);
+  const routes = Reflect.getMetadata(METADATA.ROUTES, controllerClass) || [];
+  const classMiddlewares = Reflect.getMetadata(METADATA.CLASS_MIDDLEWARES, controllerClass) || [];
+  for (const route of routes) {
+    const method = route.method.toLowerCase();
+    let routePath = route.path === "/" ? "" : route.path;
+    const fullPath = controllerPath === "/" ? routePath || "/" : controllerPath + routePath;
+    const methodMiddlewares = Reflect.getMetadata(METADATA.METHOD_MIDDLEWARES, controllerClass, route.handlerName) || [];
+    const handlers = [];
+    if (route.validation) {
+      handlers.push(validate(route.validation));
+    }
+    for (const mw of [
+      ...classMiddlewares,
+      ...methodMiddlewares
+    ]) {
+      handlers.push((req, res, next) => {
+        const ctx = new RequestContext(req, res, next);
+        Promise.resolve(mw(ctx, next)).catch(next);
+      });
+    }
+    handlers.push(async (req, res, next) => {
+      const ctx = new RequestContext(req, res, next);
+      try {
+        const controller = container.resolve(controllerClass);
+        await controller[route.handlerName](ctx);
+      } catch (err) {
+        next(err);
+      }
+    });
+    router[method](fullPath, ...handlers);
+  }
+  return router;
+}
+__name(buildRoutes, "buildRoutes");
+
+export {
+  getControllerPath,
+  buildRoutes
+};
+//# sourceMappingURL=chunk-U2JYL2NW.js.map

package/dist/chunk-U2JYL2NW.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/router-builder.ts"],"sourcesContent":["import 'reflect-metadata'\nimport { Router, type Request, type Response, type NextFunction } from 'express'\nimport {\n  Container,\n  METADATA,\n  type RouteDefinition,\n  type MiddlewareHandler,\n} from '@forinda/kickjs-core'\nimport { RequestContext } from './context'\nimport { validate } from './middleware/validate'\n\n/** Get the controller path set by @Controller('/path') */\nexport function getControllerPath(controllerClass: any): string {\n  return Reflect.getMetadata(METADATA.CONTROLLER_PATH, controllerClass) || '/'\n}\n\n/**\n * Build an Express Router from a controller class decorated with @Get, @Post, etc.\n * Resolves the controller from the DI container, wraps handlers in RequestContext,\n * and applies class-level and method-level middleware.\n */\nexport function buildRoutes(controllerClass: any): Router {\n  const router = Router()\n  const container = Container.getInstance()\n  const controllerPath = getControllerPath(controllerClass)\n  const routes: RouteDefinition[] = Reflect.getMetadata(METADATA.ROUTES, controllerClass) || []\n\n  // Class-level middleware\n  const classMiddlewares: MiddlewareHandler[] =\n    Reflect.getMetadata(METADATA.CLASS_MIDDLEWARES, controllerClass) || []\n\n  for (const route of routes) {\n    const method = route.method.toLowerCase() as 'get' | 'post' | 'put' | 'delete' | 'patch'\n    let routePath = route.path === '/' ? '' : route.path\n    const fullPath = controllerPath === '/' ? routePath || '/' : controllerPath + routePath\n\n    // Method-level middleware\n    const methodMiddlewares: MiddlewareHandler[] =\n      Reflect.getMetadata(METADATA.METHOD_MIDDLEWARES, controllerClass, route.handlerName) || []\n\n    // Build handler chain\n    const handlers: any[] = []\n\n    // Validation middleware (shared with standalone validate() export)\n    if (route.validation) {\n      handlers.push(validate(route.validation))\n    }\n\n    // Class + method middleware (wrapped as Express middleware with error catching)\n    for (const mw of [...classMiddlewares, ...methodMiddlewares]) {\n      handlers.push((req: Request, res: Response, next: NextFunction) => {\n        const ctx = new RequestContext(req, res, next)\n        Promise.resolve(mw(ctx, next)).catch(next)\n      })\n    }\n\n    // Main handler — resolve controller per-request to respect DI scoping\n    handlers.push(async (req: Request, res: Response, next: NextFunction) => {\n      const ctx = new RequestContext(req, res, next)\n      try {\n        const controller = container.resolve(controllerClass)\n        await controller[route.handlerName](ctx)\n      } catch (err: any) {\n        next(err)\n      }\n    })\n    ;(router as any)[method](fullPath, ...handlers)\n  }\n\n  return router\n}\n"],"mappings":";;;;;;;;;;;AAAA,OAAO;AACP,SAASA,cAA8D;AACvE,SACEC,WACAC,gBAGK;AAKA,SAASC,kBAAkBC,iBAAoB;AACpD,SAAOC,QAAQC,YAAYC,SAASC,iBAAiBJ,eAAAA,KAAoB;AAC3E;AAFgBD;AAST,SAASM,YAAYL,iBAAoB;AAC9C,QAAMM,SAASC,OAAAA;AACf,QAAMC,YAAYC,UAAUC,YAAW;AACvC,QAAMC,iBAAiBZ,kBAAkBC,eAAAA;AACzC,QAAMY,SAA4BX,QAAQC,YAAYC,SAASU,QAAQb,eAAAA,KAAoB,CAAA;AAG3F,QAAMc,mBACJb,QAAQC,YAAYC,SAASY,mBAAmBf,eAAAA,KAAoB,CAAA;AAEtE,aAAWgB,SAASJ,QAAQ;AAC1B,UAAMK,SAASD,MAAMC,OAAOC,YAAW;AACvC,QAAIC,YAAYH,MAAMI,SAAS,MAAM,KAAKJ,MAAMI;AAChD,UAAMC,WAAWV,mBAAmB,MAAMQ,aAAa,MAAMR,iBAAiBQ;AAG9E,UAAMG,oBACJrB,QAAQC,YAAYC,SAASoB,oBAAoBvB,iBAAiBgB,MAAMQ,WAAW,KAAK,CAAA;AAG1F,UAAMC,WAAkB,CAAA;AAGxB,QAAIT,MAAMU,YAAY;AACpBD,eAASE,KAAKC,SAASZ,MAAMU,UAAU,CAAA;IACzC;AAGA,eAAWG,MAAM;SAAIf;SAAqBQ;OAAoB;AAC5DG,eAASE,KAAK,CAACG,KAAcC,KAAeC,SAAAA;AAC1C,cAAMC,MAAM,IAAIC,eAAeJ,KAAKC,KAAKC,IAAAA;AACzCG,gBAAQC,QAAQP,GAAGI,KAAKD,IAAAA,CAAAA,EAAOK,MAAML,IAAAA;MACvC,CAAA;IACF;AAGAP,aAASE,KAAK,OAAOG,KAAcC,KAAeC,SAAAA;AAChD,YAAMC,MAAM,IAAIC,eAAeJ,KAAKC,KAAKC,IAAAA;AACzC,UAAI;AACF,cAAMM,aAAa9B,UAAU4B,QAAQpC,eAAAA;AACrC,cAAMsC,WAAWtB,MAAMQ,WAAW,EAAES,GAAAA;MACtC,SAASM,KAAU;AACjBP,aAAKO,GAAAA;MACP;IACF,CAAA;AACEjC,WAAeW,MAAAA,EAAQI,UAAAA,GAAaI,QAAAA;EACxC;AAEA,SAAOnB;AACT;AAjDgBD;","names":["Router","Container","METADATA","getControllerPath","controllerClass","Reflect","getMetadata","METADATA","CONTROLLER_PATH","buildRoutes","router","Router","container","Container","getInstance","controllerPath","routes","ROUTES","classMiddlewares","CLASS_MIDDLEWARES","route","method","toLowerCase","routePath","path","fullPath","methodMiddlewares","METHOD_MIDDLEWARES","handlerName","handlers","validation","push","validate","mw","req","res","next","ctx","RequestContext","Promise","resolve","catch","controller","err"]}

package/dist/chunk-ZI52TGQ4.js

@@ -0,0 +1,22 @@
+import {
+  __name
+} from "./chunk-7QVYU63E.js";
+
+// src/middleware/request-id.ts
+import { randomUUID } from "crypto";
+var REQUEST_ID_HEADER = "x-request-id";
+function requestId() {
+  return (req, res, next) => {
+    const id = req.headers[REQUEST_ID_HEADER] || randomUUID();
+    req.requestId = id;
+    res.setHeader(REQUEST_ID_HEADER, id);
+    next();
+  };
+}
+__name(requestId, "requestId");
+
+export {
+  REQUEST_ID_HEADER,
+  requestId
+};
+//# sourceMappingURL=chunk-ZI52TGQ4.js.map

package/dist/chunk-ZI52TGQ4.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/middleware/request-id.ts"],"sourcesContent":["import { randomUUID } from 'node:crypto'\nimport type { Request, Response, NextFunction } from 'express'\n\nexport const REQUEST_ID_HEADER = 'x-request-id'\n\n/** Middleware that generates or propagates a unique request ID */\nexport function requestId() {\n  return (req: Request, res: Response, next: NextFunction) => {\n    const id = (req.headers[REQUEST_ID_HEADER] as string) || randomUUID()\n    // Attach to req as a dedicated property (don't mutate headers)\n    ;(req as any).requestId = id\n    res.setHeader(REQUEST_ID_HEADER, id)\n    next()\n  }\n}\n"],"mappings":";;;;;AAAA,SAASA,kBAAkB;AAGpB,IAAMC,oBAAoB;AAG1B,SAASC,YAAAA;AACd,SAAO,CAACC,KAAcC,KAAeC,SAAAA;AACnC,UAAMC,KAAMH,IAAII,QAAQN,iBAAAA,KAAiCO,WAAAA;AAEvDL,QAAYD,YAAYI;AAC1BF,QAAIK,UAAUR,mBAAmBK,EAAAA;AACjCD,SAAAA;EACF;AACF;AARgBH;","names":["randomUUID","REQUEST_ID_HEADER","requestId","req","res","next","id","headers","randomUUID","setHeader"]}

package/dist/context.d.ts

@@ -0,0 +1,55 @@
+import * as http from 'http';
+import { Request, Response, NextFunction } from 'express';
+import { d as QueryFieldConfig, c as ParsedQuery } from './types-Doz6f3AB.js';
+
+/**
+ * Unified request/response abstraction passed to every controller method.
+ * Shields handlers from raw Express objects and provides convenience methods.
+ */
+declare class RequestContext<TBody = any, TParams = any, TQuery = any> {
+    readonly req: Request;
+    readonly res: Response;
+    readonly next: NextFunction;
+    private metadata;
+    constructor(req: Request, res: Response, next: NextFunction);
+    get body(): TBody;
+    get params(): TParams;
+    get query(): TQuery;
+    get headers(): http.IncomingHttpHeaders;
+    get requestId(): string | undefined;
+    /**
+     * Parse the request query string into structured filters, sort, pagination, and search.
+     * Pass the result to an ORM query builder adapter (Drizzle, Prisma, Sequelize, etc.).
+     *
+     * @param fieldConfig - Optional whitelist for filterable, sortable, and searchable fields
+     *
+     * @example
+     * ```ts
+     * @Get('/')
+     * async list(ctx: RequestContext) {
+     *   const parsed = ctx.qs({
+     *     filterable: ['status', 'priority'],
+     *     sortable: ['createdAt', 'title'],
+     *   })
+     *   const q = drizzleAdapter.build(parsed, { columns })
+     *   // ... use q.where, q.orderBy, q.limit, q.offset
+     * }
+     * ```
+     */
+    qs(fieldConfig?: QueryFieldConfig): ParsedQuery;
+    /** Single uploaded file (requires @FileUpload({ mode: 'single' })) */
+    get file(): any;
+    /** Array of uploaded files (requires @FileUpload({ mode: 'array' })) */
+    get files(): any[] | undefined;
+    get<T = any>(key: string): T | undefined;
+    set(key: string, value: any): void;
+    json(data: any, status?: number): Response<any, Record<string, any>>;
+    created(data: any): Response<any, Record<string, any>>;
+    noContent(): Response<any, Record<string, any>>;
+    notFound(message?: string): Response<any, Record<string, 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>>;
+}
+
+export { RequestContext };

package/dist/context.js

@@ -0,0 +1,9 @@
+import {
+  RequestContext
+} from "./chunk-RZUH6NBM.js";
+import "./chunk-JM7X7SAD.js";
+import "./chunk-7QVYU63E.js";
+export {
+  RequestContext
+};
+//# sourceMappingURL=context.js.map

package/dist/context.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/index.d.ts

@@ -0,0 +1,16 @@
+export { Application, ApplicationOptions, MiddlewareEntry } from './application.js';
+export { bootstrap } from './bootstrap.js';
+export { RequestContext } from './context.js';
+export { buildRoutes, getControllerPath } from './router-builder.js';
+export { REQUEST_ID_HEADER, requestId } from './middleware/request-id.js';
+export { validate } from './middleware/validate.js';
+export { errorHandler, notFoundHandler } from './middleware/error-handler.js';
+export { CsrfOptions, csrf } from './middleware/csrf.js';
+export { UploadOptions, cleanupFiles, upload } from './middleware/upload.js';
+export { buildQueryParams, parseFilters, parsePagination, parseQuery, parseSearchQuery, parseSort } from './query/index.js';
+export { F as FILTER_OPERATORS, a as FilterItem, b as FilterOperator, P as PaginationParams, c as ParsedQuery, Q as QueryBuilderAdapter, d as QueryFieldConfig, S as SortItem } from './types-Doz6f3AB.js';
+import 'node:http';
+import 'express';
+import '@forinda/kickjs-core';
+import 'http';
+import 'multer';