jcc-express-mvc 1.8.7 → 1.8.21

package/lib/Queue/Queue.js

@@ -15,14 +15,27 @@ class Queue {
         this.events = new events_1.default();
         this.jobClasses = {};
         this.driver = this.resolveDriver(config);
+        this.processSync = config.processSync ?? false;
+        if (config.queue) {
+            this.defaultQueue = config.queue;
+        }
     }
     resolveDriver(config) {
         switch (config.driver) {
             case "database":
                 return new DatabaseDriver_1.DatabaseDriver();
+            case "redis": {
+                const { RedisDriver } = require("./Drivers/RedisDriver");
+                return new RedisDriver(config);
+            }
             case "memory":
-            default:
-                return new MemoryDriver_1.MemoryDriver(this.defaultQueue);
+            default: {
+                const memoryConfig = config.memory ?? { queue: "default" };
+                return new MemoryDriver_1.MemoryDriver({
+                    defaultQueue: memoryConfig.queue ?? config.queue ?? "default",
+                    file: memoryConfig.file,
+                });
+            }
         }
     }
     /**
@@ -41,6 +54,7 @@ class Queue {
             queue,
             payload: {
                 job: job.constructor.name,
+                path: job.jobPath,
                 data: job.data,
                 maxAttempts: job.maxAttempts,
                 timeout: job.timeout,
@@ -51,8 +65,11 @@ class Queue {
             availableAt: new Date(),
             createdAt: new Date(),
         };
-        this.jobClasses[job.constructor.name] = job;
+        this.jobClasses[job.constructor.name] = job.constructor;
         await this.driver.push(queuedJob, queue);
+        if (this.processSync) {
+            await this.processNext(queue);
+        }
         return queuedJob.id;
     }
     /**
@@ -65,6 +82,7 @@ class Queue {
             queue,
             payload: {
                 job: job.constructor.name,
+                path: job.jobPath,
                 data: job.data,
                 maxAttempts: job.maxAttempts,
                 timeout: job.timeout,
@@ -75,7 +93,11 @@ class Queue {
             availableAt: new Date(Date.now() + delay * 1000),
             createdAt: new Date(),
         };
+        this.jobClasses[job.constructor.name] = job.constructor;
         await this.driver.later(queuedJob, delay, queue);
+        if (this.processSync && delay <= 0) {
+            await this.processNext(queue);
+        }
         return queuedJob.id;
     }
     /**
@@ -88,10 +110,10 @@ class Queue {
             // console.log(`[Queue] No jobs found in queue: ${queue}`);
             return false;
         }
-        console.log(`[Queue] Processing job: ${queuedJob.id}`);
         const payload = JSON.parse(queuedJob.payload);
         try {
-            const JobClass = this.jobClasses[payload.job] || (0, util_1.getJobClass)(payload.job);
+            const jobPath = payload.path || payload.job;
+            const JobClass = this.jobClasses[payload.job] || (0, util_1.getJobClass)(jobPath);
             if (!JobClass) {
                 throw new Error(`Unknown job class: ${payload.job}`);
             }
@@ -109,14 +131,17 @@ class Queue {
             queuedJob.maxAttempts = job.maxAttempts;
             queuedJob.timeout = job.timeout;
             await job.handle();
-            await this.driver.delete(queuedJob.id);
+            await this.driver.updateStatus(queuedJob.id, {
+                status: "completed",
+                finishedAt: new Date(),
+            });
             logger.success();
             return true;
         }
         catch (error) {
-            console.error(`[Queue] Error processing job ${queuedJob.id}:`, error);
             // Handle failure
-            const JobClass = this.jobClasses[payload.job] || (0, util_1.getJobClass)(payload.job);
+            const jobPath = payload.path || payload.job;
+            const JobClass = this.jobClasses[payload.job] || (0, util_1.getJobClass)(jobPath);
             const job = app.make(JobClass, [payload.data]);
             const logger = new JobsLogger_1.JobLogger(job);
             if (job) {
@@ -141,10 +166,12 @@ class Queue {
             await this.driver.release(queuedJob, delay);
         }
         else {
-            // Move to failed queue
+            // Mark as failed in jobs table
+            await this.driver.updateStatus(queuedJob.id, {
+                status: "failed",
+                failedAt: new Date(),
+            });
             await this.driver.failed(queuedJob, error);
-            // Remove from the main jobs table since it has officially failed
-            await this.driver.delete(queuedJob.id);
         }
     }
     /**
@@ -169,5 +196,113 @@ class Queue {
             }
         }
     }
+    async getQueues() {
+        return await this.driver.getQueues();
+    }
+    async findQueueById(id) {
+        return await this.driver.findQueueById(id);
+    }
+    async findQueueBy(key, value) {
+        return await this.driver.findQueueBy(key, value);
+    }
+    /** Delete a job by ID (for dashboard manual delete). */
+    async deleteJob(jobId) {
+        await this.driver.delete(jobId);
+    }
+    /**
+     * Retry a failed job — removes it from failed state, re-queues, and runs it immediately.
+     * Returns the new job ID on success, or null if the job was not found.
+     */
+    async retry(jobId) {
+        const record = await this.driver.findQueueById(jobId);
+        if (!record)
+            return null;
+        const payload = typeof record.payload === "string"
+            ? JSON.parse(record.payload)
+            : record.payload;
+        await this.driver.delete(jobId);
+        const newId = crypto.randomUUID();
+        const queuedJob = {
+            id: newId,
+            queue: record.queue || this.defaultQueue,
+            status: "pending",
+            payload,
+            attempts: 0,
+            maxAttempts: payload.maxAttempts || 3,
+            timeout: payload.timeout || 60,
+            availableAt: new Date(),
+            createdAt: new Date(),
+        };
+        await this.driver.push(queuedJob, queuedJob.queue);
+        await this.runJob(newId);
+        return newId;
+    }
+    /**
+     * Run a specific job by ID immediately.
+     * Works for pending, failed, and processing jobs.
+     * Deletes the old record, executes handle(), then writes the final status.
+     */
+    async runJob(jobId) {
+        const record = await this.driver.findQueueById(jobId);
+        if (!record)
+            return false;
+        const payload = typeof record.payload === "string"
+            ? JSON.parse(record.payload)
+            : record.payload;
+        const queuedJob = {
+            id: jobId,
+            queue: record.queue || this.defaultQueue,
+            payload,
+            attempts: record.attempts || 0,
+            maxAttempts: payload.maxAttempts || 3,
+            timeout: payload.timeout || 60,
+            availableAt: new Date(),
+            createdAt: record.created_at ? new Date(record.created_at) : new Date(),
+        };
+        await this.driver.delete(jobId);
+        try {
+            const jobPath = payload.path || payload.job;
+            const JobClass = this.jobClasses[payload.job] || (0, util_1.getJobClass)(jobPath);
+            if (!JobClass) {
+                throw new Error(`Unknown job class: ${payload.job}`);
+            }
+            const job = app.make(JobClass, [payload.data]);
+            if (!job) {
+                throw new Error(`Failed to instantiate job: ${payload.job}`);
+            }
+            const logger = new JobsLogger_1.JobLogger(job);
+            logger.processing();
+            job.id = jobId;
+            job.attempts = queuedJob.attempts;
+            job.maxAttempts = queuedJob.maxAttempts;
+            job.timeout = queuedJob.timeout;
+            queuedJob.maxAttempts = job.maxAttempts;
+            queuedJob.timeout = job.timeout;
+            await job.handle();
+            // Re-push so updateStatus has something to update
+            await this.driver.push(queuedJob, queuedJob.queue);
+            await this.driver.updateStatus(jobId, {
+                status: "completed",
+                finishedAt: new Date(),
+            });
+            logger.success();
+            return true;
+        }
+        catch (error) {
+            const jobPath = payload.path || payload.job;
+            const JobClass = this.jobClasses[payload.job] || (0, util_1.getJobClass)(jobPath);
+            const job = app.make(JobClass, [payload.data]);
+            const logger = new JobsLogger_1.JobLogger(job);
+            if (job) {
+                job.id = jobId;
+                job.attempts = queuedJob.attempts;
+            }
+            // Re-push so handleFailedJob can update/release it
+            await this.driver.push(queuedJob, queuedJob.queue);
+            await this.handleFailedJob(queuedJob, error, job);
+            logger.failed(error);
+            return false;
+        }
+    }
 }
 exports.Queue = Queue;

package/lib/Queue/QueueServiceProvider.d.ts

@@ -0,0 +1,6 @@
+import { ServiceProvider } from "../Providers/ServiceProvider";
+export declare class QueueServiceProvider extends ServiceProvider {
+    register(): void;
+    boot(): void;
+}
+//# sourceMappingURL=QueueServiceProvider.d.ts.map

package/lib/Queue/QueueServiceProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"QueueServiceProvider.d.ts","sourceRoot":"","sources":["../../../jcc-express-mvc/lib/Queue/QueueServiceProvider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAE/D,qBAAa,oBAAqB,SAAQ,eAAe;IAChD,QAAQ,IAAI,IAAI;IAQhB,IAAI,IAAI,IAAI;CAGpB"}

package/lib/Queue/QueueServiceProvider.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.QueueServiceProvider = void 0;
+const ServiceProvider_1 = require("../Providers/ServiceProvider");
+const Queue_1 = require("./Queue");
+class QueueServiceProvider extends ServiceProvider_1.ServiceProvider {
+    register() {
+        this.app.singleton("Queue", () => {
+            const queueConfig = this.app.config.queue;
+            const config = queueConfig.connections;
+            return new Queue_1.Queue({ ...config, driver: queueConfig?.driver });
+        });
+    }
+    boot() {
+        //
+    }
+}
+exports.QueueServiceProvider = QueueServiceProvider;

package/lib/Queue/Route/web.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=web.d.ts.map

package/lib/Queue/Route/web.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"web.d.ts","sourceRoot":"","sources":["../../../../jcc-express-mvc/lib/Queue/Route/web.ts"],"names":[],"mappings":""}

package/lib/Queue/Route/web.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const Route_1 = require("../../Routes/Route");
+const QueueControllers_1 = require("../Controllers/QueueControllers");
+const queueDashboardGuard_1 = require("../middleware/queueDashboardGuard");
+Route_1.Route.middleware([queueDashboardGuard_1.queueDashboardGuard])
+    .controller(QueueControllers_1.QueueControllers)
+    .group((Route) => {
+    Route.get("/dashboard", "dashboard");
+    Route.get("/jobs", "index");
+    Route.get("/jobs/{status}", "show");
+    Route.post("/jobs", "runJob");
+    Route.put("/jobs/{id}/{status}", "update");
+    Route.patch("/jobs/{id}/{status}", "update");
+    Route.delete("/jobs/{id}", "destroy");
+});

package/lib/Queue/index.d.ts

@@ -2,4 +2,5 @@ export * from "./Queue";
 export * from "./Job";
 export * from "./type";
 export * from "./interface";
+export { queueDashboardGuard } from "./middleware/queueDashboardGuard";
 //# sourceMappingURL=index.d.ts.map

package/lib/Queue/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../jcc-express-mvc/lib/Queue/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,OAAO,CAAC;AACtB,cAAc,QAAQ,CAAC;AACvB,cAAc,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../jcc-express-mvc/lib/Queue/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,OAAO,CAAC;AACtB,cAAc,QAAQ,CAAC;AACvB,cAAc,aAAa,CAAC;AAC5B,OAAO,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC"}

package/lib/Queue/index.js

@@ -14,7 +14,10 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.queueDashboardGuard = void 0;
 __exportStar(require("./Queue"), exports);
 __exportStar(require("./Job"), exports);
 __exportStar(require("./type"), exports);
 __exportStar(require("./interface"), exports);
+var queueDashboardGuard_1 = require("./middleware/queueDashboardGuard");
+Object.defineProperty(exports, "queueDashboardGuard", { enumerable: true, get: function () { return queueDashboardGuard_1.queueDashboardGuard; } });

package/lib/Queue/interface.d.ts

@@ -1,8 +1,10 @@
+export type JobStatus = "pending" | "processing" | "completed" | "failed";
 export interface QueuedJob {
     id: string;
     queue: string;
     payload: {
         job: string;
+        path?: string;
         data: any;
         maxAttempts?: number;
         timeout?: number;
@@ -12,8 +14,21 @@ export interface QueuedJob {
     timeout: number;
     availableAt: Date;
     createdAt: Date;
+    status?: JobStatus;
+    startedAt?: Date;
+    finishedAt?: Date;
+    failedAt?: Date;
+}
+export interface JobStatusUpdate {
+    status: JobStatus;
+    startedAt?: Date;
+    finishedAt?: Date;
+    failedAt?: Date;
 }
 export interface QueueDriver {
+    getQueues(): Promise<any[]>;
+    findQueueById(id: string): Promise<any>;
+    findQueueBy(key: string, value: any): Promise<any[]>;
     /**
      * Push a job onto the queue
      */
@@ -38,11 +53,20 @@ export interface QueueDriver {
      * Mark a job as failed
      */
     failed(job: QueuedJob, error: any): Promise<void>;
+    /**
+     * Update job status (processing, completed, failed) with started_at, finished_at, failed_at.
+     */
+    updateStatus(jobId: string, update: JobStatusUpdate): Promise<void>;
 }
 export interface QueueItem {
     id: string;
     job: QueuedJob;
     availableAt: number;
+    status?: JobStatus;
+    startedAt?: number;
+    finishedAt?: number;
+    failedAt?: number;
+    exception?: string;
 }
 export interface FailedItem {
     id: string;
@@ -52,5 +76,6 @@ export interface FailedItem {
         stack?: string;
     };
     failedAt: number;
+    exception?: string;
 }
 //# sourceMappingURL=interface.d.ts.map

package/lib/Queue/interface.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"interface.d.ts","sourceRoot":"","sources":["../../../jcc-express-mvc/lib/Queue/interface.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE;QACP,GAAG,EAAE,MAAM,CAAC;QACZ,IAAI,EAAE,GAAG,CAAC;QACV,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,IAAI,CAAC;IAClB,SAAS,EAAE,IAAI,CAAC;CACjB;AAED,MAAM,WAAW,WAAW;IAC1B;;OAEG;IACH,IAAI,CAAC,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEnD;;OAEG;IACH,KAAK,CAAC,CAAC,EAAE,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEtE;;OAEG;IACH,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CAAC;IAE9C;;OAEG;IACH,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAErC;;OAEG;IACH,OAAO,CAAC,GAAG,EAAE,SAAS,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEvD;;OAEG;IACH,MAAM,CAAC,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACnD;AAED,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,SAAS,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,SAAS,CAAC;IACf,KAAK,EAAE;QACL,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,QAAQ,EAAE,MAAM,CAAC;CAClB"}
+{"version":3,"file":"interface.d.ts","sourceRoot":"","sources":["../../../jcc-express-mvc/lib/Queue/interface.ts"],"names":[],"mappings":"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"}

package/lib/Queue/middleware/queueDashboardGuard.d.ts

@@ -0,0 +1,7 @@
+import type { AppNext, AppRequest, AppResponse } from "../../Interface";
+/**
+ * Protects all `/queue/*` routes: in non-local env runs session auth then `viewJobs` gate.
+ * In `APP_ENV=local`, skips checks (development convenience).
+ */
+export declare function queueDashboardGuard(req: AppRequest, res: AppResponse, next: AppNext): void;
+//# sourceMappingURL=queueDashboardGuard.d.ts.map

package/lib/Queue/middleware/queueDashboardGuard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queueDashboardGuard.d.ts","sourceRoot":"","sources":["../../../../jcc-express-mvc/lib/Queue/middleware/queueDashboardGuard.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAQxE;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,UAAU,EACf,GAAG,EAAE,WAAW,EAChB,IAAI,EAAE,OAAO,GACZ,IAAI,CA4BN"}

package/lib/Queue/middleware/queueDashboardGuard.js

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.queueDashboardGuard = queueDashboardGuard;
+const Config_1 = require("../../Config/Config");
+const Authorization_1 = require("../../Authorization");
+const AuthMiddleware_1 = require("../../Auth/AuthMiddleware");
+const VIEW_JOBS_ABILITY = "viewJobs";
+function isLocalEnv() {
+    return String(Config_1.config.get("APP_ENV", "") ?? "").toLowerCase() === "local";
+}
+/**
+ * Protects all `/queue/*` routes: in non-local env runs session auth then `viewJobs` gate.
+ * In `APP_ENV=local`, skips checks (development convenience).
+ */
+function queueDashboardGuard(req, res, next) {
+    if (isLocalEnv()) {
+        next();
+        return;
+    }
+    void AuthMiddleware_1.authMiddleware.auth(req, res, () => {
+        void (async () => {
+            try {
+                const user = req.user;
+                if (!user) {
+                    req.jccSession?.put("redirect", req.originalUrl || req.url || "/");
+                    return res.redirect(303, `/login?redirect=${encodeURIComponent(req.originalUrl || req.url || "/")}`);
+                }
+                if (!(await Authorization_1.GateFacade.can(user, VIEW_JOBS_ABILITY))) {
+                    if (req.expectsJson() && !req.isInertia()) {
+                        return res
+                            .status(403)
+                            .json({ message: "This action is unauthorized." });
+                    }
+                    return res.status(403).send("Forbidden");
+                }
+                next();
+            }
+            catch (e) {
+                next(e);
+            }
+        })();
+    });
+}

package/lib/Queue/type.d.ts

@@ -10,14 +10,25 @@ export type JobType = {
 };
 export type QueueConfig = {
     driver: "memory" | "redis" | "database";
-    connection?: any;
+    connection?: string | {
+        host?: string;
+        port?: number;
+        password?: string;
+    };
     table?: string;
     queue?: string;
+    prefix?: string;
     retryAfter?: number;
+    /** Redis: seconds to block when waiting for jobs (BLPOP). Default 5. */
     blockFor?: number;
+    /** When true (memory driver only), process jobs immediately on push. Use when not running a separate worker. */
+    processSync?: boolean;
+    /** Memory driver: file path to persist queue (enables queue:work across processes). e.g. "storage/queue.json" */
+    file?: string;
 };
 export interface JobData {
     id?: string;
+    path?: string;
     displayName?: string;
     maxAttempts?: number;
     timeout?: number;

package/lib/Queue/type.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"type.d.ts","sourceRoot":"","sources":["../../../jcc-express-mvc/lib/Queue/type.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,OAAO,GAAG;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC;IAC1B,aAAa,EAAE,MAAM,GAAG,MAAM,CAAC;IAC/B,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB,UAAU,EAAE,MAAM,GAAG,MAAM,CAAC;IAC5B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,CAAC;IACjC,MAAM,EAAE,MAAM,GAAG,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACxB,MAAM,EAAE,QAAQ,GAAG,OAAO,GAAG,UAAU,CAAC;IACxC,UAAU,CAAC,EAAE,GAAG,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,WAAW,OAAO;IACtB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,MAAM,CAAC;IACtC,IAAI,EAAE,GAAG,CAAC;CACX"}
+{"version":3,"file":"type.d.ts","sourceRoot":"","sources":["../../../jcc-express-mvc/lib/Queue/type.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,OAAO,GAAG;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC;IAC1B,aAAa,EAAE,MAAM,GAAG,MAAM,CAAC;IAC/B,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB,UAAU,EAAE,MAAM,GAAG,MAAM,CAAC;IAC5B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,CAAC;IACjC,MAAM,EAAE,MAAM,GAAG,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACxB,MAAM,EAAE,QAAQ,GAAG,OAAO,GAAG,UAAU,CAAC;IACxC,UAAU,CAAC,EAAE,MAAM,GAAG;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC1E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,wEAAwE;IACxE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gHAAgH;IAChH,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,iHAAiH;IACjH,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,MAAM,WAAW,OAAO;IACtB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,MAAM,CAAC;IACtC,IAAI,EAAE,GAAG,CAAC;CACX"}

package/lib/Response/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../jcc-express-mvc/lib/Response/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAGvD;;;;;GAKG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,OAAO,CAAa;IAC5B,OAAO,CAAC,QAAQ,CAAc;gBAClB,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,WAAW;IAYtD;;;OAGG;IACH,SAAS,CAAC,WAAW;IAerB;;;OAGG;IACH,OAAO,CAAC,YAAY;IAQpB,OAAO,CAAC,IAAI;CAIb"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../jcc-express-mvc/lib/Response/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAGvD;;;;;GAKG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,OAAO,CAAa;IAC5B,OAAO,CAAC,QAAQ,CAAc;gBAClB,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,WAAW;IAYtD;;;OAGG;IACH,SAAS,CAAC,WAAW;IAerB;;;OAGG;IACH,OAAO,CAAC,YAAY;IAQpB,OAAO,CAAC,IAAI;CAQb"}

package/lib/Response/index.js

@@ -47,7 +47,12 @@ class HttpResponse {
         //   : this.response.redirect(303, reqUrls[0]);
     }
     with(message, type) {
-        this.request.flash(type, message);
+        if (this.request.jccSession) {
+            this.request.jccSession.flash(type, message);
+        }
+        else {
+            this.request.flash(type, message);
+        }
         return this;
     }
 }

package/lib/Routes/Route.d.ts

@@ -1,6 +1,6 @@
 import { RequestHandler } from "express";
 import { ResourceOption } from "../Interface/index";
-import { Constructor, Middleware, RouteHandler } from "../Type";
+import { Constructor, MiddlewareInput, RouteHandler } from "../Type";
 export declare class Route<T extends Record<string, RequestHandler>> {
     private static routeBuilder;
     /**
@@ -20,7 +20,7 @@ export declare class Route<T extends Record<string, RequestHandler>> {
      * @param {Array | function} middleware - Array of middleware functions.
      * @returns {Route} - Returns the route instance.
      */
-    static middleware(middleware: string | Middleware | string[]): typeof Route;
+    static middleware(middleware: MiddlewareInput): typeof Route;
     /**
      * Groups routes using a callback function.
      * @param {Function} callback - Callback function for defining grouped routes.

package/lib/Routes/Route.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Route.d.ts","sourceRoot":"","sources":["../../../jcc-express-mvc/lib/Routes/Route.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEpD,OAAO,EAAE,WAAW,EAAkB,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEhF,qBAAa,KAAK,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC;IACzD,OAAO,CAAC,MAAM,CAAC,YAAY,CAAqC;IAEhE;;;;OAIG;WACW,UAAU,CAAC,UAAU,EAAE,GAAG,GAAG,OAAO,KAAK;IAOvD;;;;OAIG;WACW,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,KAAK;IAK/C;;;;OAIG;WACW,UAAU,CACtB,UAAU,EAAE,MAAM,GAAG,UAAU,GAAG,MAAM,EAAE,GACzC,OAAO,KAAK;IAKf;;;;OAIG;WACW,KAAK,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,KAAK,IAAI,GAAG,OAAO,KAAK;IAQ3E;;;;;OAKG;WACW,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,YAAY,GAAG,IAAI;IAS5D;;;;;OAKG;WACW,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,YAAY,GAAG,IAAI;IAI7D;;;;;OAKG;WACW,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,YAAY,GAAG,IAAI;IAI9D;;;;;OAKG;WACW,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,YAAY,GAAG,IAAI;IAI5D;;;;;OAKG;WACW,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,YAAY,GAAG,IAAI;WAIjD,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM;WAM7C,QAAQ,CACpB,GAAG,EAAE,MAAM,EACX,UAAU,EAAE,WAAW,CAAC,GAAG,CAAC,EAC5B,MAAM,GAAE,cAAyC;WAarC,QAAQ,CAAC,IAAI,EAAE,MAAM;IAMnC,OAAO,CAAC,MAAM,CAAC,mBAAmB;CAOnC"}
+{"version":3,"file":"Route.d.ts","sourceRoot":"","sources":["../../../jcc-express-mvc/lib/Routes/Route.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEpD,OAAO,EACL,WAAW,EAGX,eAAe,EACf,YAAY,EACb,MAAM,SAAS,CAAC;AAEjB,qBAAa,KAAK,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC;IACzD,OAAO,CAAC,MAAM,CAAC,YAAY,CAAqC;IAEhE;;;;OAIG;WACW,UAAU,CAAC,UAAU,EAAE,GAAG,GAAG,OAAO,KAAK;IAOvD;;;;OAIG;WACW,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,KAAK;IAK/C;;;;OAIG;WACW,UAAU,CAAC,UAAU,EAAE,eAAe,GAAG,OAAO,KAAK;IAKnE;;;;OAIG;WACW,KAAK,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,KAAK,IAAI,GAAG,OAAO,KAAK;IAQ3E;;;;;OAKG;WACW,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,YAAY,GAAG,IAAI;IAS5D;;;;;OAKG;WACW,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,YAAY,GAAG,IAAI;IAI7D;;;;;OAKG;WACW,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,YAAY,GAAG,IAAI;IAI9D;;;;;OAKG;WACW,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,YAAY,GAAG,IAAI;IAI5D;;;;;OAKG;WACW,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,YAAY,GAAG,IAAI;WAIjD,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM;WAM7C,QAAQ,CACpB,GAAG,EAAE,MAAM,EACX,UAAU,EAAE,WAAW,CAAC,GAAG,CAAC,EAC5B,MAAM,GAAE,cAAyC;WAarC,QAAQ,CAAC,IAAI,EAAE,MAAM;IAMnC,OAAO,CAAC,MAAM,CAAC,mBAAmB;CAOnC"}

package/lib/Routes/RouteBuilder.d.ts

@@ -1,6 +1,6 @@
 import { Application as ExpressApplication, RequestHandler } from "express";
 import { BaseController, ExpressCallback, MethodsInterface, ResourceOption } from "../Interface";
-import { HttpMethodType, HttpRoutes, Middleware, ObjectType, RouteHandler } from "../Type";
+import { HttpMethodType, HttpRoutes, MiddlewareInput, ObjectType, RouteHandler } from "../Type";
 import type { Application } from "../Application/Application";
 export declare class RouteBuilder {
     private static middlewareStack;
@@ -18,7 +18,7 @@ export declare class RouteBuilder {
     static validateResourceOption(option: ResourceOption, methods: ObjectType): boolean | ObjectType;
     static setPrefix(prefix: string): void;
     private static replaceRouteParameters;
-    static setMiddle(middleware: string | Middleware | string[]): number | RequestHandler<import("express-serve-static-core").ParamsDictionary, any, any, import("qs").ParsedQs, Record<string, any>>[] | undefined;
+    static setMiddle(middleware: MiddlewareInput): number | RequestHandler<import("express-serve-static-core").ParamsDictionary, any, any, import("qs").ParsedQs, Record<string, any>>[] | undefined;
     static setController(Controller: new (...args: any[]) => any): void;
     static buildRoute(httpMethod: HttpMethodType, url: string, callback: RouteHandler): void;
     static setServiceContainer(container: Application): void;

package/lib/Routes/RouteBuilder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"RouteBuilder.d.ts","sourceRoot":"","sources":["../../../jcc-express-mvc/lib/Routes/RouteBuilder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,IAAI,kBAAkB,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAC5E,OAAO,EAIL,cAAc,EACd,eAAe,EAEf,gBAAgB,EAChB,cAAc,EACf,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,cAAc,EACd,UAAU,EACV,UAAU,EACV,UAAU,EACV,YAAY,EACb,MAAM,SAAS,CAAC;AAMjB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAG9D,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAC,eAAe,CAA0B;IACxD,OAAO,CAAC,MAAM,CAAC,UAAU,CAAwB;IACjD,OAAO,CAAC,MAAM,CAAC,MAAM,CAAS;IAC9B,OAAO,CAAC,MAAM,CAAC,SAAS,CAAS;IACjC,SAAS,CAAC,MAAM,CAAC,gBAAgB,EAAE,WAAW,CAAC;IAC/C,SAAS,CAAC,MAAM,CAAC,UAAU,EAAE,cAAc,CAAC;IAC5C,OAAO,CAAC,MAAM,CAAC,MAAM,CAAkB;WAEzB,UAAU;WAKV,QAAQ;IAItB,SAAS,CAAC,MAAM,CAAC,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;WAOpC,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,gBAAgB;WAahD,YAAY,CAAC,GAAG,EAAE,MAAM;WAIxB,sBAAsB,CAClC,MAAM,EAAE,cAAc,EACtB,OAAO,EAAE,UAAU,GAClB,OAAO,GAAG,UAAU;WAmBT,SAAS,CAAC,MAAM,EAAE,MAAM;IAItC,OAAO,CAAC,MAAM,CAAC,sBAAsB;WAKvB,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,UAAU,GAAG,MAAM,EAAE;WA4BpD,aAAa,CAAC,UAAU,EAAE,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG;WAIrD,UAAU,CACtB,UAAU,EAAE,cAAc,EAC1B,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,YAAY;WA0BV,mBAAmB,CAAC,SAAS,EAAE,WAAW;IAIxD,SAAS,CAAC,MAAM,CAAC,QAAQ,CACvB,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,cAAc,EACtB,QAAQ,EAAE,YAAY,EACtB,UAAU,EAAE,cAAc,GAAG,cAAc,EAAE,GAC5C,GAAG;IASN,SAAS,CAAC,MAAM,CAAC,gBAAgB,CAC/B,QAAQ,EAAE,cAAc,GAAG,KAAK,CAAC,GAAG,CAAC,GACpC,eAAe;IAwBlB,OAAO,CAAC,MAAM,CAAC,cAAc;WAgCf,aAAa,CAAC,GAAG,EAAE,kBAAkB;IAoCnD,WAAkB,SAAS,IAAI,UAAU,CAExC;CACF"}
+{"version":3,"file":"RouteBuilder.d.ts","sourceRoot":"","sources":["../../../jcc-express-mvc/lib/Routes/RouteBuilder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,IAAI,kBAAkB,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAC5E,OAAO,EAIL,cAAc,EACd,eAAe,EAEf,gBAAgB,EAChB,cAAc,EACf,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,cAAc,EACd,UAAU,EAEV,eAAe,EACf,UAAU,EACV,YAAY,EACb,MAAM,SAAS,CAAC;AAMjB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAG9D,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAC,eAAe,CAA0B;IACxD,OAAO,CAAC,MAAM,CAAC,UAAU,CAAwB;IACjD,OAAO,CAAC,MAAM,CAAC,MAAM,CAAS;IAC9B,OAAO,CAAC,MAAM,CAAC,SAAS,CAAS;IACjC,SAAS,CAAC,MAAM,CAAC,gBAAgB,EAAE,WAAW,CAAC;IAC/C,SAAS,CAAC,MAAM,CAAC,UAAU,EAAE,cAAc,CAAC;IAC5C,OAAO,CAAC,MAAM,CAAC,MAAM,CAAkB;WAEzB,UAAU;WAKV,QAAQ;IAItB,SAAS,CAAC,MAAM,CAAC,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;WAOpC,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,gBAAgB;WAahD,YAAY,CAAC,GAAG,EAAE,MAAM;WAIxB,sBAAsB,CAClC,MAAM,EAAE,cAAc,EACtB,OAAO,EAAE,UAAU,GAClB,OAAO,GAAG,UAAU;WAmBT,SAAS,CAAC,MAAM,EAAE,MAAM;IAItC,OAAO,CAAC,MAAM,CAAC,sBAAsB;WAKvB,SAAS,CAAC,UAAU,EAAE,eAAe;WA4BrC,aAAa,CAAC,UAAU,EAAE,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG;WAIrD,UAAU,CACtB,UAAU,EAAE,cAAc,EAC1B,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,YAAY;WA0BV,mBAAmB,CAAC,SAAS,EAAE,WAAW;IAIxD,SAAS,CAAC,MAAM,CAAC,QAAQ,CACvB,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,cAAc,EACtB,QAAQ,EAAE,YAAY,EACtB,UAAU,EAAE,cAAc,GAAG,cAAc,EAAE,GAC5C,GAAG;IASN,SAAS,CAAC,MAAM,CAAC,gBAAgB,CAC/B,QAAQ,EAAE,cAAc,GAAG,KAAK,CAAC,GAAG,CAAC,GACpC,eAAe;IAwBlB,OAAO,CAAC,MAAM,CAAC,cAAc;WAgCf,aAAa,CAAC,GAAG,EAAE,kBAAkB;IAoCnD,WAAkB,SAAS,IAAI,UAAU,CAExC;CACF"}

package/lib/Security/CsrfMiddleware.d.ts

@@ -0,0 +1,37 @@
+import { AppNext, AppRequest, AppResponse } from "../Interface";
+export interface CsrfOptions {
+    /** Routes to exclude from CSRF verification (supports string and regex). */
+    except?: (string | RegExp)[];
+    /** Session key used to store the token. Default: "_csrf_token" */
+    sessionKey?: string;
+    /** Name of the hidden form field. Default: "_token" */
+    fieldName?: string;
+    /** Name of the HTTP header to check. Default: "x-csrf-token" */
+    headerName?: string;
+    /** Token byte length (hex-encoded = 2x). Default: 32 */
+    tokenLength?: number;
+    /** Skip CSRF for API routes (paths starting with /api). Default: true */
+    skipApi?: boolean;
+}
+/**
+ * CSRF protection middleware.
+ *
+ * Generates a per-session token and validates it on unsafe HTTP methods.
+ * The token is available via:
+ *   - `req.csrfToken()` (programmatic)
+ *   - `res.locals._token` (for templates / @csrf directive)
+ *
+ * Usage in Kernel:
+ * ```ts
+ * import { csrf } from "../../jcc-express-mvc";
+ * export class Kernel {
+ *   public middlewares = [
+ *     // ...session, cookieParser, etc.
+ *     csrf(),                // default options
+ *     csrf({ except: ["/webhooks"] }),  // with exclusions
+ *   ];
+ * }
+ * ```
+ */
+export declare function csrf(options?: CsrfOptions): (req: AppRequest, res: AppResponse, next: AppNext) => void;
+//# sourceMappingURL=CsrfMiddleware.d.ts.map

package/lib/Security/CsrfMiddleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CsrfMiddleware.d.ts","sourceRoot":"","sources":["../../../jcc-express-mvc/lib/Security/CsrfMiddleware.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAGhE,MAAM,WAAW,WAAW;IAC1B,4EAA4E;IAC5E,MAAM,CAAC,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC;IAC7B,kEAAkE;IAClE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,uDAAuD;IACvD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gEAAgE;IAChE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,wDAAwD;IACxD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yEAAyE;IACzE,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAmBD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,IAAI,CAAC,OAAO,GAAE,WAAgB,IAUpC,KAAK,UAAU,EAAE,KAAK,WAAW,EAAE,MAAM,OAAO,UAkDzD"}