exisjs 0.7.3 → 0.7.5

package/dist/decorators/middleware.js.map

@@ -1 +1 @@
-{"version":3,"file":"middleware.js","sourceRoot":"","sources":["../../src/decorators/middleware.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"middleware.js","sourceRoot":"","sources":["../../src/decorators/middleware.ts"],"names":[],"mappings":"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"}

package/dist/decorators/upload.d.ts

@@ -0,0 +1,37 @@
+import { type FileUploadOptions } from '../middleware/upload';
+/**
+ * Method or parameter decorator for file uploads.
+ *
+ * When used on a controller method:
+ * Automatically applies the multipart file upload middleware for that route before execution.
+ * ```ts
+ * @Post('/avatar')
+ * @Upload('avatar')
+ * uploadAvatar(@UploadedFile() file: ExisFile) {
+ *   return { filename: file.filename }
+ * }
+ * ```
+ *
+ * When used on a method parameter:
+ * Injects the uploaded file (alias for `@UploadedFile`).
+ * ```ts
+ * @Post('/avatar')
+ * @UseUpload({ field: 'avatar' })
+ * uploadAvatar(@Upload('avatar') file: ExisFile) {
+ *   return { filename: file.filename }
+ * }
+ * ```
+ */
+export declare function Upload(fieldNameOrOptions?: string | FileUploadOptions): any;
+/**
+ * Explicit method decorator for file upload middleware.
+ *
+ * Example:
+ * ```ts
+ * @Post('/gallery')
+ * @UseUpload({ field: 'photos', maxCount: 10, dest: './uploads' })
+ * uploadGallery(@UploadedFiles() photos: ExisFile[]) {}
+ * ```
+ */
+export declare function UseUpload(options?: FileUploadOptions): any;
+//# sourceMappingURL=upload.d.ts.map

package/dist/decorators/upload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upload.d.ts","sourceRoot":"","sources":["../../src/decorators/upload.ts"],"names":[],"mappings":"AAEA,OAAO,EAAc,KAAK,iBAAiB,EAAE,MAAM,sBAAsB,CAAA;AAEzE;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,MAAM,CAAC,kBAAkB,CAAC,EAAE,MAAM,GAAG,iBAAiB,GAAG,GAAG,CAiD3E;AAED;;;;;;;;;GASG;AACH,wBAAgB,SAAS,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,GAAG,CAE1D"}

package/dist/decorators/upload.js

@@ -0,0 +1,78 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Upload = Upload;
+exports.UseUpload = UseUpload;
+const constants_1 = require("./constants");
+const metadata_1 = require("./core/metadata");
+const upload_1 = require("../middleware/upload");
+/**
+ * Method or parameter decorator for file uploads.
+ *
+ * When used on a controller method:
+ * Automatically applies the multipart file upload middleware for that route before execution.
+ * ```ts
+ * @Post('/avatar')
+ * @Upload('avatar')
+ * uploadAvatar(@UploadedFile() file: ExisFile) {
+ *   return { filename: file.filename }
+ * }
+ * ```
+ *
+ * When used on a method parameter:
+ * Injects the uploaded file (alias for `@UploadedFile`).
+ * ```ts
+ * @Post('/avatar')
+ * @UseUpload({ field: 'avatar' })
+ * uploadAvatar(@Upload('avatar') file: ExisFile) {
+ *   return { filename: file.filename }
+ * }
+ * ```
+ */
+function Upload(fieldNameOrOptions) {
+    const options = typeof fieldNameOrOptions === 'string'
+        ? { field: fieldNameOrOptions }
+        : fieldNameOrOptions || {};
+    const uploadMiddleware = options.field
+        ? upload_1.fileUpload.single(options.field, options)
+        : options.fields
+            ? upload_1.fileUpload.fields(options.fields, options)
+            : (0, upload_1.fileUpload)(options);
+    return function (target, propertyKey, descriptorOrIndex) {
+        const isParam = typeof descriptorOrIndex === 'number' ||
+            (propertyKey &&
+                typeof propertyKey === 'object' &&
+                propertyKey.kind === 'parameter');
+        if (isParam) {
+            // Parameter decorator
+            const parameterIndex = typeof descriptorOrIndex === 'number'
+                ? descriptorOrIndex
+                : propertyKey.index;
+            const fn = target[propertyKey] || target;
+            const paramMeta = metadata_1.MetadataEngine.init(fn, constants_1.PARAM_METADATA_PROP, []);
+            paramMeta[parameterIndex] = {
+                type: 'uploadedFile',
+                name: options.field,
+                pipes: [],
+            };
+            return;
+        }
+        // Method decorator
+        const fn = descriptorOrIndex?.value || target[propertyKey] || target;
+        const methodMiddlewares = metadata_1.MetadataEngine.init(fn, constants_1.METHOD_MIDDLEWARES, []);
+        methodMiddlewares.push(uploadMiddleware);
+    };
+}
+/**
+ * Explicit method decorator for file upload middleware.
+ *
+ * Example:
+ * ```ts
+ * @Post('/gallery')
+ * @UseUpload({ field: 'photos', maxCount: 10, dest: './uploads' })
+ * uploadGallery(@UploadedFiles() photos: ExisFile[]) {}
+ * ```
+ */
+function UseUpload(options) {
+    return Upload(options);
+}
+//# sourceMappingURL=upload.js.map

package/dist/decorators/upload.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"upload.js","sourceRoot":"","sources":["../../src/decorators/upload.ts"],"names":[],"mappings":";;AA2BA,wBAiDC;AAYD,8BAEC;AA1FD,2CAAqE;AACrE,8CAAgD;AAChD,iDAAyE;AAEzE;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,SAAgB,MAAM,CAAC,kBAA+C;IACpE,MAAM,OAAO,GACX,OAAO,kBAAkB,KAAK,QAAQ;QACpC,CAAC,CAAC,EAAE,KAAK,EAAE,kBAAkB,EAAE;QAC/B,CAAC,CAAC,kBAAkB,IAAI,EAAE,CAAA;IAE9B,MAAM,gBAAgB,GAAG,OAAO,CAAC,KAAK;QACpC,CAAC,CAAC,mBAAU,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC;QAC3C,CAAC,CAAC,OAAO,CAAC,MAAM;YACd,CAAC,CAAC,mBAAU,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC;YAC5C,CAAC,CAAC,IAAA,mBAAU,EAAC,OAAO,CAAC,CAAA;IAEzB,OAAO,UACL,MAAW,EACX,WAAmC,EACnC,iBAAuB;QAEvB,MAAM,OAAO,GACX,OAAO,iBAAiB,KAAK,QAAQ;YACrC,CAAC,WAAW;gBACV,OAAO,WAAW,KAAK,QAAQ;gBAC/B,WAAW,CAAC,IAAI,KAAK,WAAW,CAAC,CAAA;QAErC,IAAI,OAAO,EAAE,CAAC;YACZ,sBAAsB;YACtB,MAAM,cAAc,GAClB,OAAO,iBAAiB,KAAK,QAAQ;gBACnC,CAAC,CAAC,iBAAiB;gBACnB,CAAC,CAAC,WAAW,CAAC,KAAK,CAAA;YAEvB,MAAM,EAAE,GAAG,MAAM,CAAC,WAAW,CAAC,IAAI,MAAM,CAAA;YACxC,MAAM,SAAS,GAAG,yBAAc,CAAC,IAAI,CAAQ,EAAE,EAAE,+BAAmB,EAAE,EAAE,CAAC,CAAA;YACzE,SAAS,CAAC,cAAc,CAAC,GAAG;gBAC1B,IAAI,EAAE,cAAc;gBACpB,IAAI,EAAE,OAAO,CAAC,KAAK;gBACnB,KAAK,EAAE,EAAE;aACV,CAAA;YACD,OAAM;QACR,CAAC;QAED,mBAAmB;QACnB,MAAM,EAAE,GAAG,iBAAiB,EAAE,KAAK,IAAI,MAAM,CAAC,WAAW,CAAC,IAAI,MAAM,CAAA;QACpE,MAAM,iBAAiB,GAAG,yBAAc,CAAC,IAAI,CAC3C,EAAE,EACF,8BAAkB,EAClB,EAAE,CACH,CAAA;QACD,iBAAiB,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAA;IAC1C,CAAC,CAAA;AACH,CAAC;AAED;;;;;;;;;GASG;AACH,SAAgB,SAAS,CAAC,OAA2B;IACnD,OAAO,MAAM,CAAC,OAAO,CAAC,CAAA;AACxB,CAAC"}

package/dist/docs/content/boundaries.mdx

@@ -21,20 +21,22 @@ A `boundary.ts` has two distinct, independent parts:
 | Signature | Detected as | Execution timing |
 |---|---|---|
 | `(req, res, next)` | Chain Step | Runs in file/declaration order, before the route |
+| `beforeHandle(req, res)` | Boundary Guard Hook | Immediately before the route handler. Short-circuits on `false` or when sending headers |
+| `afterHandle(req, res, data)` | Response Hook | Immediately after the route handler. Mutates returned payload or logs audit data |
 | `(ctx, next)` — default export (functional) or class method `handle(ctx, next)` (OOP) | Request Wrapper | Wraps around all chain steps and the nested route/boundary |
 
 ---
 
 ## 1. Functional Paradigm
 
-In functional style, export `config = defineBoundary(...)`, export named middleware functions `(req, res, next)` for chain steps, and optionally provide a `default export` function `(ctx, next)` as an onion-style wrapper.
+In functional style, export `config = defineBoundary(...)`, export named middleware functions `(req, res, next)` for chain steps, and optionally provide a `default export` function `(ctx, next)` as an onion-style wrapper. You can also configure `beforeHandle` and `afterHandle` hooks directly inside `defineBoundary({ ... })`.
 
 ```typescript filename="src/http/admin/boundary.ts"
 import { defineBoundary } from 'exisjs/router'
 import type { Request, Response, Next, BoundaryContext } from 'exisjs/router'
 import { UnauthorizedError } from 'exisjs/error'
 
-// 1. Configuration (CORS, Headers, Exclusions, DI Providers)
+// 1. Configuration (CORS, Headers, Exclusions, Hooks, DI Providers)
 export const config = defineBoundary({
   cors: {
     origin: ['https://admin.yourdomain.com'],
@@ -47,6 +49,20 @@ export const config = defineBoundary({
     '/admin/health',
     { path: '/admin/public/*', method: 'GET' }
   ],
+
+  // Pre-handler hook: Return false to reject with 403, or send custom response
+  beforeHandle(req, res) {
+    if (!req.headers['x-admin-token']) {
+      res.status(401).json({ error: 'Missing admin access token' })
+      return false
+    }
+  },
+
+  // Post-handler hook: Transform outgoing response payload or perform async audit
+  afterHandle(req, res, data) {
+    res.setHeader('X-Audited', 'true')
+    return { ...data, auditedAt: Date.now() }
+  },
 })
 
 // 2. Chain Step (auto-detected by (req, res, next) signature)
@@ -78,7 +94,7 @@ export default async function (ctx: BoundaryContext, next: Next) {
 
 ## 2. Class-Based (OOP) Paradigm
 
-In OOP style, decorate a class with `@Boundary(...)`. Named methods taking `(req, res, next)` are auto-detected as chain steps, and a method named `handle(ctx, next)` serves as the request wrapper.
+In OOP style, decorate a class with `@Boundary(...)`. Named methods taking `(req, res, next)` are auto-detected as chain steps, `beforeHandle(req, res)` and `afterHandle(req, res, data)` act as lifecycle hooks, and a method named `handle(ctx, next)` serves as the request wrapper.
 
 ```typescript filename="src/http/admin/boundary.ts"
 import { Boundary } from 'exisjs/decorators'
@@ -96,6 +112,20 @@ import { UnauthorizedError } from 'exisjs/error'
   exclude: ['/admin/health'],
 })
 export default class AdminBoundary {
+  // Pre-handler hook
+  beforeHandle(req: Request, res: Response) {
+    if (!req.headers['x-admin-token']) {
+      res.status(401).json({ error: 'Missing admin access token' })
+      return false
+    }
+  }
+
+  // Post-handler hook
+  afterHandle(req: Request, res: Response, data: any) {
+    res.setHeader('X-Audited', 'true')
+    return { ...data, auditedAt: Date.now() }
+  }
+
   // Chain step
   requireAuth(req: Request, res: Response, next: Next) {
     if (!req.headers['x-api-key']) {

package/dist/docs/content/cli/commands.mdx

@@ -92,10 +92,11 @@ $ npx exisjs g <type> <name> [options]
 
 | Schematic | Alias | Description | Output Path |
 | :--- | :--- | :--- | :--- |
-| `resource` | | Complete domain slice (`schema.ts`, `service.ts`, `route.ts` or feature-prefixed named files) | `src/http/<name>/` |
+| `crud` | `resource` | Full 4-file CRUD slice (`schema.ts`, `service.ts`, `route.ts`, and `model.ts` entity), 100% database-agnostic | `src/http/<name>/` & `src/models/` |
+| `model` | | Standalone database-agnostic TypeScript entity and input types | `src/models/<Name>.ts` |
 | `route` | `r`, `c`, `controller` | HTTP route file | `src/http/<name>/route.ts` |
-| `service` | `s` | Injectable service / business logic | `src/http/<name>/service.ts` |
-| `schema` | `sc` | Validation schemas powered by `tex` | `src/http/<name>/schema.ts` |
+| `service` | `s` | Injectable service / business logic with pagination helpers | `src/http/<name>/service.ts` |
+| `schema` | `sc` | Validation schemas powered by `tex` (includes pagination) | `src/http/<name>/schema.ts` |
 | `boundary` | `b` | Folder-scoped configuration and request pipeline | `src/http/<name>/boundary.ts` |
 | `plugin` | `p` | Distributable plugin module | `src/plugins/<name>.ts` |
 | `middleware` | `m` | Standalone middleware handler | `src/middleware/<name>.ts` |

package/dist/docs/content/config.mdx

@@ -155,7 +155,7 @@ Here is a full breakdown of the configuration schema:
 
 ### Performance & Security
 
-- `bodyLimit` _(number)_: The maximum allowed size (in bytes) for incoming request bodies. (Default: `1MB`)
+- `bodyLimit` _(number)_: The maximum allowed size (in bytes) for incoming request bodies. (Default: `10MB` / `10485760` bytes, raising HTTP 413 `PayloadTooLargeError` when exceeded)
 - `trustProxy` _(boolean | number)_: If true, respects `X-Forwarded-For` and `X-Forwarded-Host` headers (essential for apps deployed behind NGINX, Cloudflare, or AWS ELB). If a number, trusts that many hops.
 - `keepAlive` _(object | boolean)_: Tunes the Keep-Alive timeout and Header timeout limits.
 - `workers` _(number | 'safe' | 'max')_: Number of CPU workers for cluster mode. Defaults to 1. 'safe' caps to 2. 'max' uses all available cores.
@@ -219,3 +219,29 @@ If you are building a multi-tenant B2B application, do not boot multiple ExisJS
 1. **Row-Level Tenancy (Recommended)**: Run a single `App` connected to a single database. Use request context or middleware to inject the `tenantId` and scope all queries via Prisma/SQL.
 2. **Factory-Based Clients**: If you need true database-per-tenant isolation, do not use the zero-config singleton exports (like `import { db } from 'exisjs/prisma'`). Instead, manually construct the client factories inside a tenant-resolution middleware and attach them to the request context (`req.tenantDb`).
 3. **Containerized Deployments**: Run separate Node.js processes (Docker containers) for each tenant, passing tenant-specific `DATABASE_URL`s to each container.
+
+---
+
+## 9. Graceful Shutdown & Zero-Downtime Deployments
+
+When deploying in Kubernetes, Docker Swarm, AWS ECS, or PM2, containers receive `SIGTERM` signals when being replaced. ExisJS handles graceful shutdown out of the box:
+
+1. **Stops Accepting New Connections**: Immediately closes the server listener so load balancers stop routing new traffic to the terminating instance.
+2. **Closes Idle Keep-Alive Connections**: Closes lingering idle HTTP keep-alive sockets instantly via `server.closeIdleConnections()`, preventing the process from hanging.
+3. **Drains In-Flight Requests**: Grants in-flight requests time to finish before terminating.
+4. **Lifecycle Teardown**: Automatically invokes your application's `onStop(app)` hook so you can cleanly disconnect databases, Redis pools, or message brokers.
+
+```typescript filename="src/http/server.ts"
+import { exis } from 'exisjs'
+import { db } from './db'
+
+export default exis({
+  async onStart(app) {
+    await db.connect()
+  },
+  async onStop(app) {
+    // Cleanly close database pools when SIGTERM or SIGINT is received
+    await db.disconnect()
+  }
+})
+```

package/dist/docs/content/errors.mdx

@@ -74,7 +74,9 @@ The `HttpError` class provides static factory methods for standard HTTP status c
 - `HttpError.forbidden('Message')` - 403
 - `HttpError.notFound('Resource')` - 404
 - `HttpError.conflict('Message')` - 409
+- `HttpError.payloadTooLarge('Message')` - 413
 - `HttpError.unprocessable('Message', details)` - 422
+- `HttpError.rateLimit('Message')` - 429
 - `HttpError.internal('Message')` - 500
 
 ### Direct Error Classes & Exceptions
@@ -82,15 +84,17 @@ The `HttpError` class provides static factory methods for standard HTTP status c
 If you prefer a class-based approach, ExisJS exports every standard error as its own class. We also provide `Exception` aliases for every error class. You can import and throw them directly:
 
 ```typescript filename="example.ts"
-import { NotFoundException, UnauthorizedException, BadRequestError } from 'exisjs/error'
-
-export const deleteBook = (req, res) => {
-  const book = db.findBook(req.params.id)
-  
-  if (!book) throw new NotFoundException('Book not found')
-  if (book.ownerId !== req.user.id) throw new UnauthorizedException('Unauthorized')
-    
-  // ...
+import { 
+  NotFoundException, 
+  UnauthorizedException, 
+  BadRequestError, 
+  PayloadTooLargeError 
+} from 'exisjs/error'
+
+export const uploadMedia = (req, res) => {
+  if (req.headers['content-length'] > 10 * 1024 * 1024) {
+    throw new PayloadTooLargeError('File exceeds 10MB limit')
+  }
 }
 ```
 
@@ -108,6 +112,36 @@ When an `HttpError` is thrown, the client will automatically receive a structure
 }
 ```
 
+### Validation Error Responses & Diagnostic Visibility
+
+When schema validation fails (via `tex`, Zod, or Yup), ExisJS produces a typed `400 Bad Request` featuring a clean `errors: Record<string, string>` map for seamless frontend form field binding:
+
+```json filename="HTTP 400 Bad Request Response"
+{
+  "statusCode": 400,
+  "error": "Bad Request",
+  "message": "Validation Error: email: Invalid email format, age: Field must be >= 18",
+  "errors": {
+    "email": "Invalid email format",
+    "age": "Field must be >= 18"
+  }
+}
+```
+
+#### Development Terminal Diagnostics
+
+In development mode, ExisJS automatically outputs formatted tabular diagnostics to the terminal displaying the exact HTTP part, field, received value, and expected requirement:
+
+```text
+[VALIDATION FAILED] POST /auth/register (part: body)
+┌─────────────┬───────────────────────────┬──────────────────┐
+│ Field       │ Received                  │ Expected         │
+├─────────────┼───────────────────────────┼──────────────────┤
+│ email       │ "alice"                   │ Valid email      │
+│ age         │ "16"                      │ min: 18          │
+└─────────────┴───────────────────────────┴──────────────────┘
+```
+
 If you throw an unhandled exception (like a database connection failure or a `TypeError`), ExisJS catches it and securely returns a `500 Internal Server Error`, hiding the stack trace from the client in production mode while logging the full trace to your internal logger.
 
 ## Error Handling Decision Tree
@@ -125,9 +159,45 @@ To keep your codebase clean and consistent, use this decision tree when deciding
 
 ## Extended Error Handling
 
-ExisJS provides mechanisms for granular error handling.
+ExisJS provides mechanisms for granular and centralized error handling.
+
+### 1. Framework-Level Exception Handler (`src/http/error.ts`)
+
+Instead of writing manual `try/catch` blocks in every route or calling `app.onError` inside `server.ts`, ExisJS natively discovers and auto-mounts `src/http/error.ts` (or `error.js`).
+
+Export an `onError(err, req, res)` function to centrally format, log, and respond to all unhandled exceptions and validation errors:
+
+```typescript filename="src/http/error.ts"
+import type { Request, Response } from 'exisjs'
+
+/**
+ * Global Exception Handler for ExisJS
+ * Auto-mounted at startup to intercept all unhandled exceptions.
+ */
+export function onError(err: any, req: Request, res: Response) {
+  const status = err.statusCode || err.status || 500
+
+  // Centralized structured error response
+  res.status(status).json({
+    success: false,
+    error: {
+      code: err.code || 'INTERNAL_ERROR',
+      message: err.message || 'Internal Server Error',
+      path: req.path,
+    },
+  })
+}
+```
+
+> [!TIP]
+> You can also scaffold this file instantly via the CLI:
+> ```bash
+> exis generate error
+> # or shorthand:
+> exis g error
+> ```
 
-### 1. Exception Filters (`catchError`)
+### 2. Exception Filters (`catchError`)
 
 ExisJS allows you to create **Exception Filters** to globally intercept specific types of errors. 
 

package/dist/docs/content/middleware.mdx

@@ -213,3 +213,141 @@ const config: ExisConfig = {
 
 export default config
 ```
+
+---
+
+## 9. Request Timeout (`timeout`)
+
+The `timeout()` middleware terminates runaway requests and returns `503 Service Unavailable` (or a custom status code).
+
+ExisJS defaults to **60 seconds (60000ms)** to provide generous headroom for slow network connections and third-party cloud operations (Cloudinary, AWS S3, OpenAI, Stripe).
+
+```typescript filename="src/http/server.ts"
+import { exis } from 'exisjs'
+import { timeout } from 'exisjs/middleware'
+
+export default exis({
+  async onStart(app) {
+    app.use(timeout({
+      ms: 60000,
+      statusCode: 504,
+      message: 'Gateway Timeout connecting to upstream cloud service',
+      // Bypass webhooks or long-lived streaming endpoints
+      exclude: ['/webhooks/*', '/ai/stream'],
+    }))
+  }
+})
+```
+
+Handlers can also dynamically adjust timeouts using `req.setTimeout(ms)` and `req.clearTimeout()`.
+
+### Route-Level Timeout Overrides
+
+Long-running routes (file uploads, PDF exports, AI inferences, data migrations) can declare custom timeouts directly in the route definition, overriding any global application timeout:
+
+```typescript filename="src/http/ai/route.ts"
+import { controller, route } from 'exisjs/router'
+
+export default controller({
+  heavyTask: route.post('/heavy-task', {
+    timeoutMs: 120000, // 2 minutes for this endpoint only
+    async handle({ body }) {
+      return await generateLargeReport(body)
+    }
+  }),
+
+  exportStream: route.get('/export', {
+    timeoutMs: 0, // 0 disables timeout completely for infinite SSE / streaming
+    async handle({ res }) {
+      return streamDataToClient(res)
+    }
+  })
+})
+```
+
+#### Class-Based (OOP) Paradigm
+
+Use the `@Timeout(ms)` decorator on any controller method:
+
+```typescript filename="src/http/ai/controller.ts"
+import { Controller, Post, Timeout } from 'exisjs/decorators'
+
+@Controller('/ai')
+export default class AiController {
+  @Post('/inference')
+  @Timeout(120000)
+  async runInference() {
+    return await computeModel()
+  }
+}
+```
+
+---
+
+### Declarative Route Uploads
+
+You can configure file uploads directly within functional route declarations:
+
+```typescript filename="src/http/media/route.ts"
+import { controller, route } from 'exisjs/router'
+
+export default controller({
+  upload: route.post('/photo', {
+    upload: {
+      field: 'file',
+      maxSize: '10MB',
+      allowedMimeTypes: ['image/jpeg', 'image/png', 'image/webp'],
+      destination: 'memory', // 'memory' | 'disk' | 'stream'
+    },
+    async handle({ file, fields, req }) {
+      // file.buffer, file.mimetype, file.filename are immediately accessible
+      return { success: true, filename: file.filename }
+    }
+  })
+})
+```
+
+### Class-Based (OOP) Upload Decorators
+
+Use `@UseUpload` or `@Upload` to configure file parsing on controller actions:
+
+```typescript filename="src/http/media/controller.ts"
+import { Controller, Post, UseUpload, UploadedFile, Body } from 'exisjs/decorators'
+
+@Controller('/media')
+export default class MediaController {
+  @Post('/photo')
+  @UseUpload({
+    field: 'file',
+    maxSize: '10MB',
+    allowedMimeTypes: ['image/jpeg', 'image/png', 'image/webp'],
+    destination: 'memory',
+  })
+  async uploadPhoto(@UploadedFile() file: any, @Body() fields: any) {
+    return { filename: file.filename, size: file.size }
+  }
+}
+```
+
+### Express / Connect Multer Bridge (`fromExpress`)
+
+Seamlessly run existing Express/Connect middleware such as **Multer** directly in ExisJS without manual Promise wrapping:
+
+```typescript filename="src/http/legacy/route.ts"
+import { controller, route } from 'exisjs/router'
+import { fromExpress } from 'exisjs/middleware'
+import multer from 'multer'
+
+const upload = multer({ storage: multer.memoryStorage() })
+
+export default controller({
+  upload: route.post('/', 
+    fromExpress(upload.single('file')),
+    ({ req }) => {
+      const file = (req.raw as any).file || req.file
+      return { success: true, originalname: file?.originalname }
+    }
+  )
+})
+```
+

package/dist/docs/content/providers.mdx

@@ -177,3 +177,92 @@ export class OperationContext {
 > [!WARNING]
 > **Request Scope Constraints**: A provider marked as `scope: 'request'` **must** be resolved within the lifecycle of an active HTTP request. If you try to `inject()` or resolve a request-scoped provider during application startup, inside a background queue worker, or from a cron job, the container will throw a runtime error.
 
+---
+
+## Database Providers & Lifecycle Interop (`exisjs/database`)
+
+ExisJS provides first-party lifecycle management and transaction coordination for databases (PostgreSQL, SQLite, MySQL, MongoDB, Prisma, Drizzle, Mongoose).
+
+### 1. Registering Database Lifecycle (`registerDatabase`)
+
+Registering your database with `registerDatabase` ensures connections are automatically connected on boot and safely closed with zero leaked sockets when the server receives `SIGTERM` / `SIGINT`:
+
+```typescript filename="src/http/server.ts"
+import { exis } from 'exisjs'
+import { registerDatabase } from 'exisjs/database'
+import mongoose from 'mongoose'
+
+export default exis({
+  async onStart(app) {
+    // Automatically handles startup and graceful shutdown
+    registerDatabase(app, {
+      name: 'mongodb',
+      connect: async () => {
+        await mongoose.connect(process.env.MONGODB_URI!)
+      },
+      disconnect: async () => {
+        await mongoose.disconnect()
+      },
+      healthCheck: async () => {
+        return mongoose.connection.readyState === 1
+      },
+    })
+  }
+})
+```
+
+### 2. Universal Transaction Runner (`withTransaction`)
+
+`withTransaction` provides a duck-typed transaction runner that automatically coordinates transaction lifecycles, commits, aborts, and session cleanups across different ORMs:
+
+```typescript filename="src/http/orders/service.ts"
+import { withTransaction } from 'exisjs/database'
+import mongoose from 'mongoose'
+import { Order } from '@/models/Order'
+import { Inventory } from '@/models/Inventory'
+
+export async function placeOrder(customerId: string, items: { sku: string; qty: number }[]) {
+  return withTransaction(mongoose, async (session) => {
+    // Automatically attaches session to queries and commits/aborts on error
+    const order = await Order.create([{ customerId, items }], { session })
+    
+    for (const item of items) {
+      const updated = await Inventory.findOneAndUpdate(
+        { sku: item.sku, stock: { $gte: item.qty } },
+        { $inc: { stock: -item.qty } },
+        { session, returnDocument: 'after' }
+      )
+      if (!updated) {
+        throw new Error(`Insufficient stock for SKU: ${item.sku}`)
+      }
+    }
+
+    return order[0]
+  })
+}
+```
+
+Works identically with Prisma (`prisma.$transaction`) and Drizzle (`db.transaction`).
+
+### 3. Modern Mongoose 8/9 Interop & Connection Pooling
+
+ExisJS exports helpers to prevent deprecation warnings in modern Mongoose:
+
+```typescript filename="src/models/user.ts"
+import { modernUpdateOptions, mongoPoolOptions } from 'exisjs/database'
+import mongoose from 'mongoose'
+
+// Cloud-hardened pool options (maxPoolSize, serverSelectionTimeoutMS, etc.)
+export const poolConfig = mongoPoolOptions({ maxPoolSize: 50 })
+
+// Automatically maps legacy { new: true } to { returnDocument: 'after' }
+export async function updateUsername(id: string, name: string) {
+  return User.findByIdAndUpdate(
+    id,
+    { $set: { name } },
+    modernUpdateOptions({ returnDocument: 'after' })
+  )
+}
+```
+
+