@forinda/kickjs-http 0.3.1 → 0.4.0

package/dist/middleware/error-handler.js

@@ -1,8 +1,8 @@
 import {
   errorHandler,
   notFoundHandler
-} from "../chunk-BNWCVQQH.js";
-import "../chunk-7QVYU63E.js";
+} from "../chunk-3NEDJA3J.js";
+import "../chunk-WCQVDF3K.js";
 export {
   errorHandler,
   notFoundHandler

package/dist/middleware/rate-limit.d.ts

@@ -0,0 +1,53 @@
+import { Request, Response, NextFunction } from 'express';
+
+interface RateLimitStore {
+    increment(key: string): Promise<{
+        totalHits: number;
+        resetTime: Date;
+    }>;
+    decrement(key: string): Promise<void>;
+    reset(key: string): Promise<void>;
+}
+interface RateLimitOptions {
+    /** Maximum number of requests per window (default: 100) */
+    max?: number;
+    /** Time window in milliseconds (default: 60_000) */
+    windowMs?: number;
+    /** Response message when rate limit is exceeded (default: 'Too Many Requests') */
+    message?: string;
+    /** HTTP status code when rate limit is exceeded (default: 429) */
+    statusCode?: number;
+    /** Function to generate the key for rate limiting (default: req.ip) */
+    keyGenerator?: (req: Request) => string;
+    /** Whether to send rate limit headers (default: true) */
+    headers?: boolean;
+    /** Custom store implementation (default: in-memory Map) */
+    store?: RateLimitStore;
+    /** Function to skip rate limiting for certain requests */
+    skip?: (req: Request) => boolean;
+    /** Paths to exclude from rate limiting */
+    skipPaths?: string[];
+}
+/**
+ * Rate limiting middleware.
+ *
+ * Limits the number of requests a client can make within a time window.
+ * Uses an in-memory store by default, but accepts a custom store for
+ * distributed deployments (e.g. Redis).
+ *
+ * @example
+ * ```ts
+ * import { rateLimit } from '@forinda/kickjs-http'
+ *
+ * bootstrap({
+ *   modules,
+ *   middleware: [
+ *     rateLimit({ max: 100, windowMs: 60_000 }),
+ *     // ... other middleware
+ *   ],
+ * })
+ * ```
+ */
+declare function rateLimit(options?: RateLimitOptions): (req: Request, res: Response, next: NextFunction) => Promise<void | Response<any, Record<string, any>>>;
+
+export { type RateLimitOptions, type RateLimitStore, rateLimit };

package/dist/middleware/rate-limit.js

@@ -0,0 +1,8 @@
+import {
+  rateLimit
+} from "../chunk-H4S527PH.js";
+import "../chunk-WCQVDF3K.js";
+export {
+  rateLimit
+};
+//# sourceMappingURL=rate-limit.js.map

package/dist/middleware/rate-limit.js.map

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

package/dist/middleware/request-id.js

@@ -1,8 +1,8 @@
 import {
   REQUEST_ID_HEADER,
   requestId
-} from "../chunk-ZI52TGQ4.js";
-import "../chunk-7QVYU63E.js";
+} from "../chunk-35NUARK7.js";
+import "../chunk-WCQVDF3K.js";
 export {
   REQUEST_ID_HEADER,
   requestId

package/dist/middleware/session.d.ts

@@ -0,0 +1,64 @@
+import { Request, Response, NextFunction } from 'express';
+
+interface SessionData {
+    [key: string]: unknown;
+}
+interface SessionStore {
+    get(sid: string): Promise<SessionData | null>;
+    set(sid: string, data: SessionData, maxAge: number): Promise<void>;
+    destroy(sid: string): Promise<void>;
+    touch?(sid: string, maxAge: number): Promise<void>;
+}
+interface Session {
+    id: string;
+    data: SessionData;
+    regenerate(): Promise<void>;
+    destroy(): Promise<void>;
+    save(): Promise<void>;
+}
+interface SessionOptions {
+    /** Secret used to sign the session cookie (required) */
+    secret: string;
+    /** Cookie name (default: 'kick.sid') */
+    cookieName?: string;
+    /** Session max age in milliseconds (default: 86400000 = 24h) */
+    maxAge?: number;
+    /** Reset maxAge on every response (default: false) */
+    rolling?: boolean;
+    /** Save new sessions that have not been modified (default: true) */
+    saveUninitialized?: boolean;
+    /** Cookie options */
+    cookie?: {
+        httpOnly?: boolean;
+        secure?: boolean;
+        sameSite?: 'strict' | 'lax' | 'none';
+        path?: string;
+        domain?: string;
+    };
+    /** Custom session store (default: in-memory store with TTL cleanup) */
+    store?: SessionStore;
+}
+/**
+ * Session management middleware.
+ *
+ * Attaches a `req.session` object with `id`, `data`, `regenerate()`,
+ * `destroy()`, and `save()` methods. Session IDs are signed with
+ * HMAC-SHA256 to prevent cookie tampering.
+ *
+ * @example
+ * ```ts
+ * import { session } from '@forinda/kickjs-http'
+ *
+ * bootstrap({
+ *   modules,
+ *   middleware: [
+ *     cookieParser(),
+ *     session({ secret: process.env.SESSION_SECRET! }),
+ *     // ... other middleware
+ *   ],
+ * })
+ * ```
+ */
+declare function session(options: SessionOptions): (req: Request, res: Response, next: NextFunction) => Promise<void>;
+
+export { type Session, type SessionData, type SessionOptions, type SessionStore, session };

package/dist/middleware/session.js

@@ -0,0 +1,8 @@
+import {
+  session
+} from "../chunk-NQJNMKW5.js";
+import "../chunk-WCQVDF3K.js";
+export {
+  session
+};
+//# sourceMappingURL=session.js.map

package/dist/middleware/session.js.map

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

package/dist/middleware/upload.d.ts

@@ -1,11 +1,24 @@
-import { Request, Response, NextFunction, RequestHandler } from 'express';
+import { RequestHandler, Request, Response, NextFunction } from 'express';
 import { Options } from 'multer';
+import { BaseUploadOptions, FileUploadConfig } from '@forinda/kickjs-core';
 
-interface UploadOptions {
-    /** Max file size in bytes (default: 5MB) */
-    maxSize?: number;
-    /** Allowed MIME types (default: all) */
-    allowedTypes?: string[];
+/**
+ * Resolves a list of file type identifiers to MIME type strings.
+ * Accepts short extensions (`'jpg'`, `'pdf'`) or full MIME types (`'image/jpeg'`).
+ *
+ * @example
+ * ```ts
+ * resolveMimeTypes(['jpg', 'png', 'application/pdf'])
+ * // → ['image/jpeg', 'image/png', 'application/pdf']
+ * ```
+ */
+declare function resolveMimeTypes(types: string[]): string[];
+/**
+ * Upload options for the middleware.
+ * Extends BaseUploadOptions from core (shared with @FileUpload decorator)
+ * and adds Multer-specific storage options.
+ */
+interface UploadOptions extends BaseUploadOptions {
     /** Multer storage config (default: memory storage) */
     storage?: Options['storage'];
     /** Multer dest for disk storage shorthand */
@@ -17,7 +30,7 @@ interface UploadOptions {
  * @example
  * ```ts
  * @Post('/avatar')
- * @Middleware(upload.single('avatar', { maxSize: 2 * 1024 * 1024, allowedTypes: ['image/*'] }))
+ * @Middleware(upload.single('avatar', { maxSize: 2 * 1024 * 1024, allowedTypes: ['jpg', 'png'] }))
  * async uploadAvatar(ctx: RequestContext) {
  *   ctx.json({ filename: ctx.file.originalname })
  * }
@@ -33,20 +46,26 @@ declare function array(fieldName: string, maxCount?: number, options?: UploadOpt
  */
 declare function none(options?: UploadOptions): RequestHandler;
 /**
- * Middleware that automatically cleans up uploaded files after the response
- * is sent. Attach this AFTER your upload middleware.
- *
- * Only cleans up disk-stored files (files with a `path` property).
+ * Removes temporary files from disk after the response is sent.
+ * Attach this as Express middleware after the upload middleware.
+ * Works with both `req.file` (single) and `req.files` (array).
  *
  * @example
  * ```ts
- * middleware: [
- *   upload.single('file', { dest: '/tmp/uploads' }),
- *   cleanupFiles(),
- * ]
+ * @Post('/process')
+ * @Middleware(upload.single('document', { dest: '/tmp/uploads' }), cleanupFiles())
+ * async processDocument(ctx: RequestContext) {
+ *   ctx.json({ ok: true })
+ * }
  * ```
  */
 declare function cleanupFiles(): (req: Request, res: Response, next: NextFunction) => void;
+/**
+ * Build upload middleware from a @FileUpload decorator config.
+ * Used internally by the router builder when it detects FILE_UPLOAD metadata.
+ * Accepts the same FileUploadConfig interface used by the @FileUpload decorator.
+ */
+declare function buildUploadMiddleware(config: FileUploadConfig): RequestHandler;
 /** Upload middleware factory with `.single()`, `.array()`, `.none()` methods */
 declare const upload: {
     single: typeof single;
@@ -54,4 +73,4 @@ declare const upload: {
     none: typeof none;
 };
 
-export { type UploadOptions, cleanupFiles, upload };
+export { type UploadOptions, buildUploadMiddleware, cleanupFiles, resolveMimeTypes, upload };

package/dist/middleware/upload.js

@@ -1,10 +1,14 @@
 import {
+  buildUploadMiddleware,
   cleanupFiles,
+  resolveMimeTypes,
   upload
-} from "../chunk-75Z5FSZN.js";
-import "../chunk-7QVYU63E.js";
+} from "../chunk-LEILPDMW.js";
+import "../chunk-WCQVDF3K.js";
 export {
+  buildUploadMiddleware,
   cleanupFiles,
+  resolveMimeTypes,
   upload
 };
 //# sourceMappingURL=upload.js.map

package/dist/middleware/validate.js

@@ -1,7 +1,7 @@
 import {
   validate
-} from "../chunk-JD2RKDKH.js";
-import "../chunk-7QVYU63E.js";
+} from "../chunk-RPN7UFUO.js";
+import "../chunk-WCQVDF3K.js";
 export {
   validate
 };

package/dist/query/index.js

@@ -6,8 +6,8 @@ import {
   parseQuery,
   parseSearchQuery,
   parseSort
-} from "../chunk-JM7X7SAD.js";
-import "../chunk-7QVYU63E.js";
+} from "../chunk-VXX2Y3TA.js";
+import "../chunk-WCQVDF3K.js";
 export {
   FILTER_OPERATORS,
   buildQueryParams,

package/dist/router-builder.js

@@ -1,11 +1,12 @@
 import {
   buildRoutes,
   getControllerPath
-} from "./chunk-U2JYL2NW.js";
-import "./chunk-JD2RKDKH.js";
-import "./chunk-RZUH6NBM.js";
-import "./chunk-JM7X7SAD.js";
-import "./chunk-7QVYU63E.js";
+} from "./chunk-VFVMIFNZ.js";
+import "./chunk-LEILPDMW.js";
+import "./chunk-RPN7UFUO.js";
+import "./chunk-LQ6RSWMX.js";
+import "./chunk-VXX2Y3TA.js";
+import "./chunk-WCQVDF3K.js";
 export {
   buildRoutes,
   getControllerPath

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@forinda/kickjs-http",
-  "version": "0.3.1",
+  "version": "0.4.0",
   "description": "Express 5 integration, router builder, RequestContext, and middleware for KickJS",
   "type": "module",
   "main": "dist/index.js",
@@ -30,6 +30,14 @@
       "import": "./dist/middleware/csrf.js",
       "types": "./dist/middleware/csrf.d.ts"
     },
+    "./middleware/rate-limit": {
+      "import": "./dist/middleware/rate-limit.js",
+      "types": "./dist/middleware/rate-limit.d.ts"
+    },
+    "./middleware/session": {
+      "import": "./dist/middleware/session.js",
+      "types": "./dist/middleware/session.d.ts"
+    },
     "./middleware/upload": {
       "import": "./dist/middleware/upload.js",
       "types": "./dist/middleware/upload.d.ts"
@@ -46,6 +54,10 @@
       "import": "./dist/middleware/error-handler.js",
       "types": "./dist/middleware/error-handler.d.ts"
     },
+    "./devtools": {
+      "import": "./dist/devtools.js",
+      "types": "./dist/devtools.d.ts"
+    },
     "./query": {
       "import": "./dist/query/index.js",
       "types": "./dist/query/index.d.ts"
@@ -58,7 +70,7 @@
     "cookie-parser": "^1.4.7",
     "multer": "^2.1.1",
     "reflect-metadata": "^0.2.2",
-    "@forinda/kickjs-core": "0.3.1"
+    "@forinda/kickjs-core": "0.4.0"
   },
   "peerDependencies": {
     "express": "^5.1.0"
@@ -82,6 +94,7 @@
   "engines": {
     "node": ">=20.0"
   },
+  "homepage": "https://forinda.github.io/kick-js/",
   "scripts": {
     "build": "tsup",
     "dev": "tsup --watch",

package/dist/chunk-75Z5FSZN.js

@@ -1,88 +0,0 @@
-import {
-  __name
-} from "./chunk-7QVYU63E.js";
-
-// src/middleware/upload.ts
-import { unlink } from "fs/promises";
-import multer from "multer";
-function single(fieldName, options = {}) {
-  const m = createMulter(options);
-  return m.single(fieldName);
-}
-__name(single, "single");
-function array(fieldName, maxCount = 10, options = {}) {
-  const m = createMulter(options);
-  return m.array(fieldName, maxCount);
-}
-__name(array, "array");
-function none(options = {}) {
-  const m = createMulter(options);
-  return m.none();
-}
-__name(none, "none");
-function createMulter(options) {
-  const limits = {
-    fileSize: options.maxSize ?? 5 * 1024 * 1024
-  };
-  const fileFilter = options.allowedTypes ? (_req, file, cb) => {
-    const allowed = options.allowedTypes.some((type) => {
-      if (type.endsWith("/*")) {
-        return file.mimetype.startsWith(type.replace("/*", "/"));
-      }
-      return file.mimetype === type;
-    });
-    if (allowed) {
-      cb(null, true);
-    } else {
-      cb(new Error(`File type ${file.mimetype} is not allowed`));
-    }
-  } : void 0;
-  const multerOptions = {
-    limits,
-    ...fileFilter ? {
-      fileFilter
-    } : {},
-    ...options.storage ? {
-      storage: options.storage
-    } : {},
-    ...options.dest ? {
-      dest: options.dest
-    } : {}
-  };
-  return multer(multerOptions);
-}
-__name(createMulter, "createMulter");
-function cleanupFiles() {
-  return (req, res, next) => {
-    res.on("finish", async () => {
-      const files = [];
-      if (req.file?.path) {
-        files.push(req.file);
-      }
-      if (Array.isArray(req.files)) {
-        for (const f of req.files) {
-          if (f?.path) files.push(f);
-        }
-      }
-      for (const file of files) {
-        try {
-          await unlink(file.path);
-        } catch {
-        }
-      }
-    });
-    next();
-  };
-}
-__name(cleanupFiles, "cleanupFiles");
-var upload = {
-  single,
-  array,
-  none
-};
-
-export {
-  cleanupFiles,
-  upload
-};
-//# sourceMappingURL=chunk-75Z5FSZN.js.map

package/dist/chunk-75Z5FSZN.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/middleware/upload.ts"],"sourcesContent":["import { unlink } from 'node:fs/promises'\nimport type { Request, Response, NextFunction, RequestHandler } from 'express'\nimport multer, { type Options as MulterOptions } from 'multer'\n\nexport interface UploadOptions {\n  /** Max file size in bytes (default: 5MB) */\n  maxSize?: number\n  /** Allowed MIME types (default: all) */\n  allowedTypes?: string[]\n  /** Multer storage config (default: memory storage) */\n  storage?: MulterOptions['storage']\n  /** Multer dest for disk storage shorthand */\n  dest?: string\n}\n\n/**\n * Single file upload middleware. Attaches the file to `req.file`.\n *\n * @example\n * ```ts\n * @Post('/avatar')\n * @Middleware(upload.single('avatar', { maxSize: 2 * 1024 * 1024, allowedTypes: ['image/*'] }))\n * async uploadAvatar(ctx: RequestContext) {\n *   ctx.json({ filename: ctx.file.originalname })\n * }\n * ```\n */\nfunction single(fieldName: string, options: UploadOptions = {}): RequestHandler {\n  const m = createMulter(options)\n  return m.single(fieldName) as RequestHandler\n}\n\n/**\n * Multiple file upload middleware. Attaches files to `req.files`.\n */\nfunction array(fieldName: string, maxCount = 10, options: UploadOptions = {}): RequestHandler {\n  const m = createMulter(options)\n  return m.array(fieldName, maxCount) as RequestHandler\n}\n\n/**\n * No file upload — just parse multipart form data without file fields.\n */\nfunction none(options: UploadOptions = {}): RequestHandler {\n  const m = createMulter(options)\n  return m.none() as RequestHandler\n}\n\nfunction createMulter(options: UploadOptions) {\n  const limits: MulterOptions['limits'] = {\n    fileSize: options.maxSize ?? 5 * 1024 * 1024,\n  }\n\n  const fileFilter: MulterOptions['fileFilter'] = options.allowedTypes\n    ? (_req, file, cb) => {\n        const allowed = options.allowedTypes!.some((type) => {\n          if (type.endsWith('/*')) {\n            return file.mimetype.startsWith(type.replace('/*', '/'))\n          }\n          return file.mimetype === type\n        })\n        if (allowed) {\n          cb(null, true)\n        } else {\n          cb(new Error(`File type ${file.mimetype} is not allowed`))\n        }\n      }\n    : undefined\n\n  const multerOptions: MulterOptions = {\n    limits,\n    ...(fileFilter ? { fileFilter } : {}),\n    ...(options.storage ? { storage: options.storage } : {}),\n    ...(options.dest ? { dest: options.dest } : {}),\n  }\n\n  return multer(multerOptions)\n}\n\n/**\n * Middleware that automatically cleans up uploaded files after the response\n * is sent. Attach this AFTER your upload middleware.\n *\n * Only cleans up disk-stored files (files with a `path` property).\n *\n * @example\n * ```ts\n * middleware: [\n *   upload.single('file', { dest: '/tmp/uploads' }),\n *   cleanupFiles(),\n * ]\n * ```\n */\nexport function cleanupFiles() {\n  return (req: Request, res: Response, next: NextFunction) => {\n    res.on('finish', async () => {\n      const files: any[] = []\n\n      if ((req as any).file?.path) {\n        files.push((req as any).file)\n      }\n      if (Array.isArray((req as any).files)) {\n        for (const f of (req as any).files) {\n          if (f?.path) files.push(f)\n        }\n      }\n\n      for (const file of files) {\n        try {\n          await unlink(file.path)\n        } catch {\n          // File may already be moved/deleted by the handler — ignore\n        }\n      }\n    })\n\n    next()\n  }\n}\n\n/** Upload middleware factory with `.single()`, `.array()`, `.none()` methods */\nexport const upload = { single, array, none }\n"],"mappings":";;;;;AAAA,SAASA,cAAc;AAEvB,OAAOC,YAA+C;AAyBtD,SAASC,OAAOC,WAAmBC,UAAyB,CAAC,GAAC;AAC5D,QAAMC,IAAIC,aAAaF,OAAAA;AACvB,SAAOC,EAAEH,OAAOC,SAAAA;AAClB;AAHSD;AAQT,SAASK,MAAMJ,WAAmBK,WAAW,IAAIJ,UAAyB,CAAC,GAAC;AAC1E,QAAMC,IAAIC,aAAaF,OAAAA;AACvB,SAAOC,EAAEE,MAAMJ,WAAWK,QAAAA;AAC5B;AAHSD;AAQT,SAASE,KAAKL,UAAyB,CAAC,GAAC;AACvC,QAAMC,IAAIC,aAAaF,OAAAA;AACvB,SAAOC,EAAEI,KAAI;AACf;AAHSA;AAKT,SAASH,aAAaF,SAAsB;AAC1C,QAAMM,SAAkC;IACtCC,UAAUP,QAAQQ,WAAW,IAAI,OAAO;EAC1C;AAEA,QAAMC,aAA0CT,QAAQU,eACpD,CAACC,MAAMC,MAAMC,OAAAA;AACX,UAAMC,UAAUd,QAAQU,aAAcK,KAAK,CAACC,SAAAA;AAC1C,UAAIA,KAAKC,SAAS,IAAA,GAAO;AACvB,eAAOL,KAAKM,SAASC,WAAWH,KAAKI,QAAQ,MAAM,GAAA,CAAA;MACrD;AACA,aAAOR,KAAKM,aAAaF;IAC3B,CAAA;AACA,QAAIF,SAAS;AACXD,SAAG,MAAM,IAAA;IACX,OAAO;AACLA,SAAG,IAAIQ,MAAM,aAAaT,KAAKM,QAAQ,iBAAiB,CAAA;IAC1D;EACF,IACAI;AAEJ,QAAMC,gBAA+B;IACnCjB;IACA,GAAIG,aAAa;MAAEA;IAAW,IAAI,CAAC;IACnC,GAAIT,QAAQwB,UAAU;MAAEA,SAASxB,QAAQwB;IAAQ,IAAI,CAAC;IACtD,GAAIxB,QAAQyB,OAAO;MAAEA,MAAMzB,QAAQyB;IAAK,IAAI,CAAC;EAC/C;AAEA,SAAOC,OAAOH,aAAAA;AAChB;AA7BSrB;AA6CF,SAASyB,eAAAA;AACd,SAAO,CAACC,KAAcC,KAAeC,SAAAA;AACnCD,QAAIE,GAAG,UAAU,YAAA;AACf,YAAMC,QAAe,CAAA;AAErB,UAAKJ,IAAYhB,MAAMqB,MAAM;AAC3BD,cAAME,KAAMN,IAAYhB,IAAI;MAC9B;AACA,UAAIuB,MAAMC,QAASR,IAAYI,KAAK,GAAG;AACrC,mBAAWK,KAAMT,IAAYI,OAAO;AAClC,cAAIK,GAAGJ,KAAMD,OAAME,KAAKG,CAAAA;QAC1B;MACF;AAEA,iBAAWzB,QAAQoB,OAAO;AACxB,YAAI;AACF,gBAAMM,OAAO1B,KAAKqB,IAAI;QACxB,QAAQ;QAER;MACF;IACF,CAAA;AAEAH,SAAAA;EACF;AACF;AAzBgBH;AA4BT,IAAMY,SAAS;EAAEzC;EAAQK;EAAOE;AAAK;","names":["unlink","multer","single","fieldName","options","m","createMulter","array","maxCount","none","limits","fileSize","maxSize","fileFilter","allowedTypes","_req","file","cb","allowed","some","type","endsWith","mimetype","startsWith","replace","Error","undefined","multerOptions","storage","dest","multer","cleanupFiles","req","res","next","on","files","path","push","Array","isArray","f","unlink","upload"]}

package/dist/chunk-7QVYU63E.js

@@ -1,7 +0,0 @@
-var __defProp = Object.defineProperty;
-var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
-
-export {
-  __name
-};
-//# sourceMappingURL=chunk-7QVYU63E.js.map

package/dist/chunk-KAWXFLFS.js.map

@@ -1 +0,0 @@
-{"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-RZUH6NBM.js.map

@@ -1 +0,0 @@
-{"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.map

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