exisjs 0.7.3 → 0.7.4

package/dist/database/lifecycle.js

@@ -0,0 +1,122 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DatabaseManager = void 0;
+exports.registerDatabase = registerDatabase;
+/**
+ * Universal Database Manager for ExisJS.
+ * Manages connections, graceful shutdown, and health checks for any database
+ * (Mongoose, Prisma, Drizzle, PostgreSQL, MySQL, SQLite, Redis).
+ */
+class DatabaseManager {
+    /**
+     * Registers a database connection lifecycle with the framework.
+     */
+    static register(db) {
+        this.databases.set(db.name, db);
+        this.ensureShutdownHooks();
+    }
+    /**
+     * Connects all registered databases.
+     */
+    static async connectAll() {
+        for (const [name, db] of this.databases) {
+            try {
+                await db.connect();
+            }
+            catch (err) {
+                throw new Error(`[ExisJS Database] Failed to connect database "${name}": ${err.message}`, { cause: err });
+            }
+        }
+    }
+    /**
+     * Disconnects all registered databases gracefully.
+     */
+    static async disconnectAll() {
+        const disconnectPromises = Array.from(this.databases.values()).map(async (db) => {
+            try {
+                await db.disconnect();
+            }
+            catch (err) {
+                console.error(`[ExisJS Database] Error disconnecting "${db.name}":`, err);
+            }
+        });
+        await Promise.allSettled(disconnectPromises);
+    }
+    /**
+     * Checks the health of all registered databases.
+     */
+    static async checkHealth() {
+        const results = {};
+        let allHealthy = true;
+        for (const [name, db] of this.databases) {
+            const start = Date.now();
+            try {
+                if (!db.isHealthy) {
+                    results[name] = { name, status: 'connected', latencyMs: 0 };
+                    continue;
+                }
+                const healthRes = await db.isHealthy();
+                const latencyMs = Date.now() - start;
+                if (typeof healthRes === 'boolean') {
+                    results[name] = {
+                        name,
+                        status: healthRes ? 'connected' : 'disconnected',
+                        latencyMs,
+                    };
+                    if (!healthRes)
+                        allHealthy = false;
+                }
+                else {
+                    results[name] = {
+                        latencyMs,
+                        ...healthRes,
+                        name: healthRes.name || name,
+                    };
+                    if (healthRes.status !== 'connected')
+                        allHealthy = false;
+                }
+            }
+            catch (err) {
+                allHealthy = false;
+                results[name] = {
+                    name,
+                    status: 'error',
+                    latencyMs: Date.now() - start,
+                    error: err.message,
+                };
+            }
+        }
+        return {
+            healthy: allHealthy,
+            databases: results,
+        };
+    }
+    /**
+     * Clears registered databases (useful for testing).
+     */
+    static clear() {
+        this.databases.clear();
+    }
+    static ensureShutdownHooks() {
+        if (this.isShutdownHookRegistered)
+            return;
+        this.isShutdownHookRegistered = true;
+        const shutdownHandler = async () => {
+            await DatabaseManager.disconnectAll();
+        };
+        if (typeof process !== 'undefined' && typeof process.on === 'function') {
+            process.once('SIGINT', shutdownHandler);
+            process.once('SIGTERM', shutdownHandler);
+        }
+    }
+}
+exports.DatabaseManager = DatabaseManager;
+DatabaseManager.databases = new Map();
+DatabaseManager.isShutdownHookRegistered = false;
+/**
+ * Convenience helper to register database lifecycle hooks.
+ */
+function registerDatabase(db) {
+    DatabaseManager.register(db);
+}
+//# sourceMappingURL=lifecycle.js.map

package/dist/database/lifecycle.js.map

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

package/dist/database/mongoose.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Options for findOneAndUpdate / findByIdAndUpdate in modern Mongoose (8 & 9).
+ */
+export interface ModernUpdateOptions {
+    upsert?: boolean;
+    returnDocument?: 'before' | 'after';
+    /** Legacy option mapped to returnDocument: 'after' */
+    new?: boolean;
+    lean?: boolean;
+    runValidators?: boolean;
+    session?: any;
+    select?: any;
+    populate?: any;
+    sort?: any;
+    [key: string]: any;
+}
+/**
+ * Normalizes findOneAndUpdate / findByIdAndUpdate options for modern Mongoose.
+ * Automatically maps legacy `{ new: true }` to `{ returnDocument: 'after' }`
+ * to prevent deprecation warnings in Mongoose 9 while preserving backward compatibility.
+ *
+ * Example:
+ * ```ts
+ * const user = await User.findOneAndUpdate(
+ *   { email },
+ *   { $set: { lastLogin: new Date() } },
+ *   modernUpdateOptions({ upsert: true, new: true })
+ * )
+ * ```
+ */
+export declare function modernUpdateOptions<T extends ModernUpdateOptions>(options?: T): T & {
+    returnDocument?: 'before' | 'after';
+};
+export interface MongoPoolConfig {
+    maxPoolSize?: number;
+    minPoolSize?: number;
+    serverSelectionTimeoutMS?: number;
+    socketTimeoutMS?: number;
+    heartbeatFrequencyMS?: number;
+    autoIndex?: boolean;
+}
+/**
+ * Generates recommended, production-hardened connection pool options
+ * for MongoDB / Mongoose in cloud environments (Atlas, AWS, GCP, Azure).
+ */
+export declare function mongoPoolOptions(overrides?: MongoPoolConfig): MongoPoolConfig;
+//# sourceMappingURL=mongoose.d.ts.map

package/dist/database/mongoose.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mongoose.d.ts","sourceRoot":"","sources":["../../src/database/mongoose.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,cAAc,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAA;IACnC,sDAAsD;IACtD,GAAG,CAAC,EAAE,OAAO,CAAA;IACb,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB,OAAO,CAAC,EAAE,GAAG,CAAA;IACb,MAAM,CAAC,EAAE,GAAG,CAAA;IACZ,QAAQ,CAAC,EAAE,GAAG,CAAA;IACd,IAAI,CAAC,EAAE,GAAG,CAAA;IACV,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;CACnB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,SAAS,mBAAmB,EAC/D,OAAO,GAAE,CAAW,GACnB,CAAC,GAAG;IAAE,cAAc,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAA;CAAE,CAU7C;AAED,MAAM,WAAW,eAAe;IAC9B,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,wBAAwB,CAAC,EAAE,MAAM,CAAA;IACjC,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,oBAAoB,CAAC,EAAE,MAAM,CAAA;IAC7B,SAAS,CAAC,EAAE,OAAO,CAAA;CACpB;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,SAAS,GAAE,eAAoB,GAC9B,eAAe,CAUjB"}

package/dist/database/mongoose.js

@@ -0,0 +1,44 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.modernUpdateOptions = modernUpdateOptions;
+exports.mongoPoolOptions = mongoPoolOptions;
+/**
+ * Normalizes findOneAndUpdate / findByIdAndUpdate options for modern Mongoose.
+ * Automatically maps legacy `{ new: true }` to `{ returnDocument: 'after' }`
+ * to prevent deprecation warnings in Mongoose 9 while preserving backward compatibility.
+ *
+ * Example:
+ * ```ts
+ * const user = await User.findOneAndUpdate(
+ *   { email },
+ *   { $set: { lastLogin: new Date() } },
+ *   modernUpdateOptions({ upsert: true, new: true })
+ * )
+ * ```
+ */
+function modernUpdateOptions(options = {}) {
+    const normalized = { ...options };
+    if (normalized.new === true && !normalized.returnDocument) {
+        normalized.returnDocument = 'after';
+    }
+    else if (normalized.new === false && !normalized.returnDocument) {
+        normalized.returnDocument = 'before';
+    }
+    return normalized;
+}
+/**
+ * Generates recommended, production-hardened connection pool options
+ * for MongoDB / Mongoose in cloud environments (Atlas, AWS, GCP, Azure).
+ */
+function mongoPoolOptions(overrides = {}) {
+    return {
+        maxPoolSize: 10,
+        minPoolSize: 2,
+        serverSelectionTimeoutMS: 5000,
+        socketTimeoutMS: 45000,
+        heartbeatFrequencyMS: 10000,
+        autoIndex: process.env.NODE_ENV !== 'production',
+        ...overrides,
+    };
+}
+//# sourceMappingURL=mongoose.js.map

package/dist/database/mongoose.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mongoose.js","sourceRoot":"","sources":["../../src/database/mongoose.ts"],"names":[],"mappings":";;AA+BA,kDAYC;AAeD,4CAYC;AArDD;;;;;;;;;;;;;GAaG;AACH,SAAgB,mBAAmB,CACjC,UAAa,EAAO;IAEpB,MAAM,UAAU,GAAQ,EAAE,GAAG,OAAO,EAAE,CAAA;IAEtC,IAAI,UAAU,CAAC,GAAG,KAAK,IAAI,IAAI,CAAC,UAAU,CAAC,cAAc,EAAE,CAAC;QAC1D,UAAU,CAAC,cAAc,GAAG,OAAO,CAAA;IACrC,CAAC;SAAM,IAAI,UAAU,CAAC,GAAG,KAAK,KAAK,IAAI,CAAC,UAAU,CAAC,cAAc,EAAE,CAAC;QAClE,UAAU,CAAC,cAAc,GAAG,QAAQ,CAAA;IACtC,CAAC;IAED,OAAO,UAAU,CAAA;AACnB,CAAC;AAWD;;;GAGG;AACH,SAAgB,gBAAgB,CAC9B,YAA6B,EAAE;IAE/B,OAAO;QACL,WAAW,EAAE,EAAE;QACf,WAAW,EAAE,CAAC;QACd,wBAAwB,EAAE,IAAI;QAC9B,eAAe,EAAE,KAAK;QACtB,oBAAoB,EAAE,KAAK;QAC3B,SAAS,EAAE,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,YAAY;QAChD,GAAG,SAAS;KACb,CAAA;AACH,CAAC"}

package/dist/database/transaction.d.ts

@@ -0,0 +1,39 @@
+export interface TransactionOptions {
+    maxRetries?: number;
+    timeoutMs?: number;
+    readPreference?: string;
+    readConcern?: string | {
+        level: string;
+    };
+    writeConcern?: {
+        w: number | string;
+        j?: boolean;
+        wtimeout?: number;
+    };
+}
+/**
+ * Universal transaction runner for ExisJS.
+ *
+ * Automatically detects whether client is Mongoose, MongoDB, Prisma, or Drizzle/SQL,
+ * runs the operation within an ACID transaction, commits on success, and rolls back on error.
+ *
+ * Example with Mongoose:
+ * ```ts
+ * const result = await withTransaction(mongoose, async (session) => {
+ *   const order = await Order.create([{ userId, total }], { session })
+ *   await Inventory.updateOne({ _id: itemId }, { $inc: { stock: -1 } }, { session })
+ *   return order[0]
+ * })
+ * ```
+ *
+ * Example with Prisma:
+ * ```ts
+ * const result = await withTransaction(prisma, async (tx) => {
+ *   const user = await tx.user.create({ data: { email } })
+ *   await tx.profile.create({ data: { userId: user.id } })
+ *   return user
+ * })
+ * ```
+ */
+export declare function withTransaction<T>(clientOrConnection: any, callback: (sessionOrTx: any) => Promise<T>, options?: TransactionOptions): Promise<T>;
+//# sourceMappingURL=transaction.d.ts.map

package/dist/database/transaction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transaction.d.ts","sourceRoot":"","sources":["../../src/database/transaction.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,kBAAkB;IACjC,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,WAAW,CAAC,EAAE,MAAM,GAAG;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAA;IACxC,YAAY,CAAC,EAAE;QAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;QAAC,CAAC,CAAC,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;CACtE;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAsB,eAAe,CAAC,CAAC,EACrC,kBAAkB,EAAE,GAAG,EACvB,QAAQ,EAAE,CAAC,WAAW,EAAE,GAAG,KAAK,OAAO,CAAC,CAAC,CAAC,EAC1C,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAAC,CAAC,CAAC,CA+EZ"}

package/dist/database/transaction.js

@@ -0,0 +1,99 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.withTransaction = withTransaction;
+/**
+ * Universal transaction runner for ExisJS.
+ *
+ * Automatically detects whether client is Mongoose, MongoDB, Prisma, or Drizzle/SQL,
+ * runs the operation within an ACID transaction, commits on success, and rolls back on error.
+ *
+ * Example with Mongoose:
+ * ```ts
+ * const result = await withTransaction(mongoose, async (session) => {
+ *   const order = await Order.create([{ userId, total }], { session })
+ *   await Inventory.updateOne({ _id: itemId }, { $inc: { stock: -1 } }, { session })
+ *   return order[0]
+ * })
+ * ```
+ *
+ * Example with Prisma:
+ * ```ts
+ * const result = await withTransaction(prisma, async (tx) => {
+ *   const user = await tx.user.create({ data: { email } })
+ *   await tx.profile.create({ data: { userId: user.id } })
+ *   return user
+ * })
+ * ```
+ */
+async function withTransaction(clientOrConnection, callback, options = {}) {
+    if (!clientOrConnection) {
+        throw new Error('[ExisJS Transaction] A valid database client or connection is required');
+    }
+    // 1. Prisma Client Interop (client.$transaction)
+    if (typeof clientOrConnection.$transaction === 'function') {
+        return clientOrConnection.$transaction(async (tx) => {
+            return callback(tx);
+        }, options);
+    }
+    // 2. Drizzle / Knex / Generic SQL Interop (client.transaction)
+    if (typeof clientOrConnection.transaction === 'function') {
+        return clientOrConnection.transaction(async (tx) => {
+            return callback(tx);
+        });
+    }
+    // 3. Mongoose / MongoDB Driver Interop (startSession)
+    const getSessionFn = clientOrConnection.startSession ||
+        clientOrConnection.connection?.startSession ||
+        clientOrConnection.client?.startSession;
+    if (typeof getSessionFn === 'function') {
+        const sessionTarget = clientOrConnection.startSession
+            ? clientOrConnection
+            : clientOrConnection.connection?.startSession
+                ? clientOrConnection.connection
+                : clientOrConnection.client;
+        const session = await sessionTarget.startSession(options);
+        // Use built-in session.withTransaction if available (handles automatic retries for transient errors)
+        if (typeof session.withTransaction === 'function') {
+            try {
+                let result;
+                await session.withTransaction(async () => {
+                    result = await callback(session);
+                }, options);
+                return result;
+            }
+            finally {
+                await session.endSession();
+            }
+        }
+        // Manual startTransaction / commit / abort fallback
+        try {
+            session.startTransaction();
+            const result = await callback(session);
+            await session.commitTransaction();
+            return result;
+        }
+        catch (err) {
+            try {
+                await session.abortTransaction();
+            }
+            catch {
+                /* ignore abort error and bubble original */
+            }
+            throw err;
+        }
+        finally {
+            try {
+                await session.endSession();
+            }
+            catch {
+                /* ignore endSession cleanup error */
+            }
+        }
+    }
+    // 4. If callback was passed directly or connection is already a session
+    if (typeof clientOrConnection.commitTransaction === 'function') {
+        return callback(clientOrConnection);
+    }
+    throw new Error('[ExisJS Transaction] Provided database client does not support transactions (missing startSession, $transaction, or transaction method)');
+}
+//# sourceMappingURL=transaction.js.map

package/dist/database/transaction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transaction.js","sourceRoot":"","sources":["../../src/database/transaction.ts"],"names":[],"mappings":";;AAgCA,0CAmFC;AA3GD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACI,KAAK,UAAU,eAAe,CACnC,kBAAuB,EACvB,QAA0C,EAC1C,UAA8B,EAAE;IAEhC,IAAI,CAAC,kBAAkB,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CACb,wEAAwE,CACzE,CAAA;IACH,CAAC;IAED,iDAAiD;IACjD,IAAI,OAAO,kBAAkB,CAAC,YAAY,KAAK,UAAU,EAAE,CAAC;QAC1D,OAAO,kBAAkB,CAAC,YAAY,CAAC,KAAK,EAAE,EAAO,EAAE,EAAE;YACvD,OAAO,QAAQ,CAAC,EAAE,CAAC,CAAA;QACrB,CAAC,EAAE,OAAO,CAAC,CAAA;IACb,CAAC;IAED,+DAA+D;IAC/D,IAAI,OAAO,kBAAkB,CAAC,WAAW,KAAK,UAAU,EAAE,CAAC;QACzD,OAAO,kBAAkB,CAAC,WAAW,CAAC,KAAK,EAAE,EAAO,EAAE,EAAE;YACtD,OAAO,QAAQ,CAAC,EAAE,CAAC,CAAA;QACrB,CAAC,CAAC,CAAA;IACJ,CAAC;IAED,sDAAsD;IACtD,MAAM,YAAY,GAChB,kBAAkB,CAAC,YAAY;QAC/B,kBAAkB,CAAC,UAAU,EAAE,YAAY;QAC3C,kBAAkB,CAAC,MAAM,EAAE,YAAY,CAAA;IAEzC,IAAI,OAAO,YAAY,KAAK,UAAU,EAAE,CAAC;QACvC,MAAM,aAAa,GAAG,kBAAkB,CAAC,YAAY;YACnD,CAAC,CAAC,kBAAkB;YACpB,CAAC,CAAC,kBAAkB,CAAC,UAAU,EAAE,YAAY;gBAC3C,CAAC,CAAC,kBAAkB,CAAC,UAAU;gBAC/B,CAAC,CAAC,kBAAkB,CAAC,MAAM,CAAA;QAE/B,MAAM,OAAO,GAAG,MAAM,aAAa,CAAC,YAAY,CAAC,OAAO,CAAC,CAAA;QAEzD,qGAAqG;QACrG,IAAI,OAAO,OAAO,CAAC,eAAe,KAAK,UAAU,EAAE,CAAC;YAClD,IAAI,CAAC;gBACH,IAAI,MAAS,CAAA;gBACb,MAAM,OAAO,CAAC,eAAe,CAAC,KAAK,IAAI,EAAE;oBACvC,MAAM,GAAG,MAAM,QAAQ,CAAC,OAAO,CAAC,CAAA;gBAClC,CAAC,EAAE,OAAO,CAAC,CAAA;gBACX,OAAO,MAAO,CAAA;YAChB,CAAC;oBAAS,CAAC;gBACT,MAAM,OAAO,CAAC,UAAU,EAAE,CAAA;YAC5B,CAAC;QACH,CAAC;QAED,oDAAoD;QACpD,IAAI,CAAC;YACH,OAAO,CAAC,gBAAgB,EAAE,CAAA;YAC1B,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,OAAO,CAAC,CAAA;YACtC,MAAM,OAAO,CAAC,iBAAiB,EAAE,CAAA;YACjC,OAAO,MAAM,CAAA;QACf,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,CAAC;gBACH,MAAM,OAAO,CAAC,gBAAgB,EAAE,CAAA;YAClC,CAAC;YAAC,MAAM,CAAC;gBACP,4CAA4C;YAC9C,CAAC;YACD,MAAM,GAAG,CAAA;QACX,CAAC;gBAAS,CAAC;YACT,IAAI,CAAC;gBACH,MAAM,OAAO,CAAC,UAAU,EAAE,CAAA;YAC5B,CAAC;YAAC,MAAM,CAAC;gBACP,qCAAqC;YACvC,CAAC;QACH,CAAC;IACH,CAAC;IAED,wEAAwE;IACxE,IAAI,OAAO,kBAAkB,CAAC,iBAAiB,KAAK,UAAU,EAAE,CAAC;QAC/D,OAAO,QAAQ,CAAC,kBAAkB,CAAC,CAAA;IACrC,CAAC;IAED,MAAM,IAAI,KAAK,CACb,yIAAyI,CAC1I,CAAA;AACH,CAAC"}

package/dist/decorators/index.d.ts

@@ -5,4 +5,5 @@ export * from './routing';
 export * from './params';
 export * from './middleware';
 export * from './response';
+export * from './upload';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/decorators/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAA;AAC3B,cAAc,QAAQ,CAAA;AACtB,cAAc,cAAc,CAAA;AAC5B,cAAc,WAAW,CAAA;AACzB,cAAc,UAAU,CAAA;AACxB,cAAc,cAAc,CAAA;AAC5B,cAAc,YAAY,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/decorators/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAA;AAC3B,cAAc,QAAQ,CAAA;AACtB,cAAc,cAAc,CAAA;AAC5B,cAAc,WAAW,CAAA;AACzB,cAAc,UAAU,CAAA;AACxB,cAAc,cAAc,CAAA;AAC5B,cAAc,YAAY,CAAA;AAC1B,cAAc,UAAU,CAAA"}

package/dist/decorators/index.js

@@ -21,4 +21,5 @@ __exportStar(require("./routing"), exports);
 __exportStar(require("./params"), exports);
 __exportStar(require("./middleware"), exports);
 __exportStar(require("./response"), exports);
+__exportStar(require("./upload"), exports);
 //# sourceMappingURL=index.js.map

package/dist/decorators/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/decorators/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,8CAA2B;AAC3B,yCAAsB;AACtB,+CAA4B;AAC5B,4CAAyB;AACzB,2CAAwB;AACxB,+CAA4B;AAC5B,6CAA0B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/decorators/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,8CAA2B;AAC3B,yCAAsB;AACtB,+CAA4B;AAC5B,4CAAyB;AACzB,2CAAwB;AACxB,+CAA4B;AAC5B,6CAA0B;AAC1B,2CAAwB"}

package/dist/decorators/middleware.d.ts

@@ -34,4 +34,14 @@ export declare function UseFilters(...filters: any[]): any;
  *     checkout() {}
  */
 export declare function Idempotent(options?: import('../middleware/idempotency').IdempotentOptions): any;
+/**
+ * Route-Level Timeout Decorator.
+ * Configures an explicit timeout override for a long-running endpoint.
+ *
+ * Example:
+ *     @Post('/heavy-task')
+ *     @Timeout(120000)
+ *     heavyTask() {}
+ */
+export declare function Timeout(msOrOptions: number | import('../middleware/security').TimeoutOptions): any;
 //# sourceMappingURL=middleware.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"middleware.d.ts","sourceRoot":"","sources":["../../src/decorators/middleware.ts"],"names":[],"mappings":"AAkCA;;;;;;;;;;;;GAYG;AACH,wBAAgB,GAAG,CAAC,GAAG,KAAK,EAAE,GAAG,EAAE,GAAG,GAAG,CAsFxC;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,GAAG,MAAM,EAAE,GAAG,EAAE,GAAG,GAAG,CAE/C;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,GAAG,YAAY,EAAE,GAAG,EAAE,GAAG,GAAG,CAE3D;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,GAAG,GAAG,CAEjD;AAED;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CACxB,OAAO,GAAE,OAAO,2BAA2B,EAAE,iBAAsB,GAClE,GAAG,CA8BL"}
+{"version":3,"file":"middleware.d.ts","sourceRoot":"","sources":["../../src/decorators/middleware.ts"],"names":[],"mappings":"AAkCA;;;;;;;;;;;;GAYG;AACH,wBAAgB,GAAG,CAAC,GAAG,KAAK,EAAE,GAAG,EAAE,GAAG,GAAG,CAsFxC;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,GAAG,MAAM,EAAE,GAAG,EAAE,GAAG,GAAG,CAE/C;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,GAAG,YAAY,EAAE,GAAG,EAAE,GAAG,GAAG,CAE3D;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,GAAG,GAAG,CAEjD;AAED;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CACxB,OAAO,GAAE,OAAO,2BAA2B,EAAE,iBAAsB,GAClE,GAAG,CA8BL;AAED;;;;;;;;GAQG;AACH,wBAAgB,OAAO,CACrB,WAAW,EAAE,MAAM,GAAG,OAAO,wBAAwB,EAAE,cAAc,GACpE,GAAG,CA4BL"}

package/dist/decorators/middleware.js

@@ -38,6 +38,7 @@ exports.UseGuards = UseGuards;
 exports.UseInterceptors = UseInterceptors;
 exports.UseFilters = UseFilters;
 exports.Idempotent = Idempotent;
+exports.Timeout = Timeout;
 const constants_1 = require("./constants");
 const metadata_1 = require("./core/metadata");
 /**
@@ -190,4 +191,30 @@ function Idempotent(options = {}) {
         methodMiddlewares.push(middlewareProxy);
     };
 }
+/**
+ * Route-Level Timeout Decorator.
+ * Configures an explicit timeout override for a long-running endpoint.
+ *
+ * Example:
+ *     @Post('/heavy-task')
+ *     @Timeout(120000)
+ *     heavyTask() {}
+ */
+function Timeout(msOrOptions) {
+    return function (target, contextOrPropertyKey, descriptor) {
+        const isStandard = typeof contextOrPropertyKey === 'object' && contextOrPropertyKey !== null;
+        const fn = isStandard
+            ? target
+            : descriptor
+                ? descriptor.value
+                : target[contextOrPropertyKey];
+        const methodMiddlewares = metadata_1.MetadataEngine.init(fn, constants_1.METHOD_MIDDLEWARES, []);
+        const middlewareProxy = async (req, res, next) => {
+            const { routeTimeout } = await Promise.resolve().then(() => __importStar(require('../middleware/security')));
+            const handler = routeTimeout(msOrOptions);
+            return handler(req, res, next);
+        };
+        methodMiddlewares.unshift(middlewareProxy);
+    };
+}
 //# sourceMappingURL=middleware.js.map

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/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.