jcc-express-mvc 1.8.7 → 1.8.21

package/lib/Database/Drivers/MongooseDriver.d.ts

@@ -0,0 +1,20 @@
+import { DatabaseDriver } from "../interface";
+/** Mongoose connection type - loaded dynamically to avoid hard dependency */
+type MongooseConnection = any;
+/**
+ * Mongoose driver for MongoDB.
+ * Requires: npm install mongoose
+ * Uses MONGODB_URI from .env or constructs from DB_* variables.
+ */
+export declare class MongooseDriver implements DatabaseDriver {
+    private config;
+    private connection;
+    private connected;
+    constructor(config: any);
+    connect(): Promise<void>;
+    private buildUri;
+    getConnection(): MongooseConnection;
+    disconnect(): Promise<void>;
+}
+export {};
+//# sourceMappingURL=MongooseDriver.d.ts.map

package/lib/Database/Drivers/MongooseDriver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MongooseDriver.d.ts","sourceRoot":"","sources":["../../../../jcc-express-mvc/lib/Database/Drivers/MongooseDriver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAG9C,6EAA6E;AAC7E,KAAK,kBAAkB,GAAG,GAAG,CAAC;AAE9B;;;;GAIG;AACH,qBAAa,cAAe,YAAW,cAAc;IAIvC,OAAO,CAAC,MAAM;IAH1B,OAAO,CAAC,UAAU,CAAmC;IACrD,OAAO,CAAC,SAAS,CAAS;gBAEN,MAAM,EAAE,GAAG;IAIzB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IA4B9B,OAAO,CAAC,QAAQ;IAehB,aAAa,IAAI,kBAAkB;IAO7B,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;CAOlC"}

package/lib/Database/Drivers/MongooseDriver.js

@@ -0,0 +1,57 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MongooseDriver = void 0;
+/**
+ * Mongoose driver for MongoDB.
+ * Requires: npm install mongoose
+ * Uses MONGODB_URI from .env or constructs from DB_* variables.
+ */
+class MongooseDriver {
+    constructor(config) {
+        this.config = config;
+        this.connection = null;
+        this.connected = false;
+        this.config = config;
+    }
+    async connect() {
+        if (this.connected && this.connection)
+            return;
+        try {
+            const mongoose = require("mongoose");
+            const uri = this.buildUri(this.config.host, this.config.port, this.config.database, this.config.username, this.config.password);
+            this.connection = await mongoose.connect(this.config.mongoUri || uri, {
+                ...(this.config.options && typeof this.config.options === "object"
+                    ? this.config.options
+                    : {}),
+            });
+            this.connected = true;
+        }
+        catch (error) {
+            throw new Error(`Mongoose connection failed. Install: npm install mongoose. ${error.message}`);
+        }
+    }
+    buildUri(host, port, database, username, password) {
+        if (!host || !database)
+            return "";
+        const auth = username && password ? `${username}:${password}@` : "";
+        if (auth) {
+            return `mongodb+srv://${auth}${host}:${port}/${database}`;
+        }
+        return `mongodb://${auth}${host}:${port}/${database}`;
+    }
+    getConnection() {
+        if (!this.connection) {
+            throw new Error("Database not connected. Call connect() first.");
+        }
+        return this.connection;
+    }
+    async disconnect() {
+        if (!this.connected || !this.connection)
+            return;
+        const mongoose = require("mongoose");
+        await mongoose.disconnect();
+        this.connection = null;
+        this.connected = false;
+    }
+}
+exports.MongooseDriver = MongooseDriver;

package/lib/Database/Drivers/SequelizeDriver.d.ts

@@ -0,0 +1,24 @@
+import { DatabaseDriver } from "../interface";
+/** Sequelize instance type - loaded dynamically to avoid hard dependency */
+type SequelizeInstance = any;
+/**
+ * Sequelize driver for SQL databases via Sequelize ORM.
+ * Requires: npm install sequelize mysql2 (or pg2, sqlite3, etc.)
+ */
+export declare class SequelizeDriver implements DatabaseDriver {
+    private config;
+    private sequelize;
+    private connected;
+    private static instance;
+    constructor(config: any);
+    connect(): Promise<SequelizeInstance>;
+    getConnection(): SequelizeInstance;
+    disconnect(): Promise<void>;
+    /**
+     * Load Sequelize models from app/Models and sync tables
+     */
+    private loadModelsIfSequelize;
+    static getSequelizeInstance(): SequelizeInstance;
+}
+export {};
+//# sourceMappingURL=SequelizeDriver.d.ts.map

package/lib/Database/Drivers/SequelizeDriver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SequelizeDriver.d.ts","sourceRoot":"","sources":["../../../../jcc-express-mvc/lib/Database/Drivers/SequelizeDriver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAK9C,4EAA4E;AAC5E,KAAK,iBAAiB,GAAG,GAAG,CAAC;AAE7B;;;GAGG;AACH,qBAAa,eAAgB,YAAW,cAAc;IAKxC,OAAO,CAAC,MAAM;IAJ1B,OAAO,CAAC,SAAS,CAAkC;IACnD,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAgC;gBAEnC,MAAM,EAAE,GAAG;IAKzB,OAAO,IAAI,OAAO,CAAC,iBAAiB,CAAC;IA8B3C,aAAa,IAAI,iBAAiB;IAO5B,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAOjC;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAmB7B,MAAM,CAAC,oBAAoB,IAAI,iBAAiB;CAGjD"}

package/lib/Database/Drivers/SequelizeDriver.js

@@ -0,0 +1,82 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SequelizeDriver = void 0;
+const path_1 = __importDefault(require("path"));
+const fs_1 = __importDefault(require("fs"));
+const app_root_path_1 = __importDefault(require("app-root-path"));
+/**
+ * Sequelize driver for SQL databases via Sequelize ORM.
+ * Requires: npm install sequelize mysql2 (or pg2, sqlite3, etc.)
+ */
+class SequelizeDriver {
+    constructor(config) {
+        this.config = config;
+        this.sequelize = null;
+        this.connected = false;
+        this.config = config;
+        // console.log(this.app);
+    }
+    async connect() {
+        if (this.connected && this.sequelize)
+            return;
+        try {
+            const { Sequelize } = require("sequelize");
+            this.sequelize = new Sequelize(this.config.database, this.config.username, this.config.password, {
+                ...this.config.options,
+            });
+            await this.sequelize.authenticate();
+            //
+            this.loadModelsIfSequelize();
+            this.sequelize.sync({ ...this.config.sync });
+            if (this.config.dropTables) {
+                await this.sequelize.drop();
+            }
+            this.connected = true;
+        }
+        catch (error) {
+            throw new Error(`Sequelize connection failed. Install: npm install sequelize mysql2. ${error.message}`);
+        }
+    }
+    getConnection() {
+        if (!this.sequelize) {
+            throw new Error("Database not connected. Call connect() first.");
+        }
+        return this.sequelize;
+    }
+    async disconnect() {
+        if (!this.connected || !this.sequelize)
+            return;
+        await this.sequelize.close();
+        this.sequelize = null;
+        this.connected = false;
+    }
+    /**
+     * Load Sequelize models from app/Models and sync tables
+     */
+    loadModelsIfSequelize() {
+        let models = {};
+        const modelsPath = path_1.default.join(app_root_path_1.default.path, "app", "Models");
+        fs_1.default.readdirSync(modelsPath)
+            .filter((f) => f.endsWith(".js") || f.endsWith(".ts"))
+            .sort()
+            .forEach((file) => {
+            const name = path_1.default.parse(file).name;
+            const getModel = require(path_1.default.join(modelsPath, file));
+            models[name] = getModel[name];
+        });
+        Object.keys(models).forEach((modelName) => {
+            if (models[modelName].associate) {
+                models[modelName].associate(models);
+            }
+        });
+    }
+    static getSequelizeInstance() {
+        return this.instance;
+    }
+}
+exports.SequelizeDriver = SequelizeDriver;
+SequelizeDriver.instance = null;
+// export const sequelize = SequelizeDriver.getSequelizeInstance();

package/lib/Database/index.d.ts

@@ -0,0 +1,7 @@
+export { Database } from "./Database";
+export { DatabaseDriver } from "./interface";
+export type { DatabaseConfig, DatabaseDriverName } from "./type";
+export { KnexDriver } from "./Drivers/KnexDriver";
+export { SequelizeDriver } from "./Drivers/SequelizeDriver";
+export { MongooseDriver } from "./Drivers/MongooseDriver";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../jcc-express-mvc/lib/Database/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,YAAY,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,QAAQ,CAAC;AACjE,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC"}

package/lib/Database/index.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MongooseDriver = exports.SequelizeDriver = exports.KnexDriver = exports.Database = void 0;
+var Database_1 = require("./Database");
+Object.defineProperty(exports, "Database", { enumerable: true, get: function () { return Database_1.Database; } });
+var KnexDriver_1 = require("./Drivers/KnexDriver");
+Object.defineProperty(exports, "KnexDriver", { enumerable: true, get: function () { return KnexDriver_1.KnexDriver; } });
+var SequelizeDriver_1 = require("./Drivers/SequelizeDriver");
+Object.defineProperty(exports, "SequelizeDriver", { enumerable: true, get: function () { return SequelizeDriver_1.SequelizeDriver; } });
+var MongooseDriver_1 = require("./Drivers/MongooseDriver");
+Object.defineProperty(exports, "MongooseDriver", { enumerable: true, get: function () { return MongooseDriver_1.MongooseDriver; } });

package/lib/Database/interface.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Base interface for database drivers.
+ * Each driver (Knex/Jcc-eloquent, Sequelize, Mongoose) implements this to provide
+ * a unified connection lifecycle. Use getConnection() for ORM-specific APIs.
+ */
+export interface DatabaseDriver {
+    /** Establish connection to the database */
+    connect(): Promise<void>;
+    /** Return the underlying client (Knex, Sequelize, or Mongoose connection) */
+    getConnection(): unknown;
+    /** Close the database connection */
+    disconnect(): Promise<void>;
+}
+//# sourceMappingURL=interface.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"interface.d.ts","sourceRoot":"","sources":["../../../jcc-express-mvc/lib/Database/interface.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B,2CAA2C;IAC3C,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEzB,6EAA6E;IAC7E,aAAa,IAAI,OAAO,CAAC;IAEzB,oCAAoC;IACpC,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7B"}

package/lib/Database/interface.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/lib/Database/type.d.ts

@@ -0,0 +1,18 @@
+export type DatabaseDriverName = "knex" | "sequelize" | "mongoose" | "sqlite" | "better-sqlite3" | "postgres" | "postgress" | "pg" | "mysql2" | "mysql" | "pg2" | "mongodb";
+export interface DatabaseConfig {
+    driver: DatabaseDriverName;
+    /** Connection name for config lookup (e.g. "mysql", "default") */
+    connection?: string;
+    host?: string;
+    port?: number;
+    database?: string;
+    username?: string;
+    password?: string;
+    /** For SQLite */
+    filename?: string;
+    /** MongoDB connection URI (used by Mongoose) */
+    uri?: string;
+    /** Sequelize/Mongoose options passthrough */
+    options?: Record<string, unknown>;
+}
+//# sourceMappingURL=type.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"type.d.ts","sourceRoot":"","sources":["../../../jcc-express-mvc/lib/Database/type.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,kBAAkB,GAC1B,MAAM,GACN,WAAW,GACX,UAAU,GACV,QAAQ,GACR,gBAAgB,GAChB,UAAU,GACV,WAAW,GACX,IAAI,GACJ,QAAQ,GACR,OAAO,GACP,KAAK,GACL,SAAS,CAAC;AACd,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,kBAAkB,CAAC;IAC3B,kEAAkE;IAClE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iBAAiB;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gDAAgD;IAChD,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,6CAA6C;IAC7C,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC"}

package/lib/Database/type.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/lib/Error/DisplayErrorCode.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DisplayErrorCode.d.ts","sourceRoot":"","sources":["../../../jcc-express-mvc/lib/Error/DisplayErrorCode.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAEvD,qBAAa,YAAa,SAAQ,gBAAgB;IAChD;;OAEG;IACH,MAAM,CAAC,IAAI,CACT,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,GAAG,EACZ,GAAG,EAAE,WAAW,EAChB,GAAG,EAAE,UAAU;IAmEjB,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG;CAGxD"}
+{"version":3,"file":"DisplayErrorCode.d.ts","sourceRoot":"","sources":["../../../jcc-express-mvc/lib/Error/DisplayErrorCode.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAEvD,qBAAa,YAAa,SAAQ,gBAAgB;IAChD;;OAEG;IACH,MAAM,CAAC,IAAI,CACT,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,GAAG,EACZ,GAAG,EAAE,WAAW,EAChB,GAAG,EAAE,UAAU;IAyEjB,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG;CAGxD"}

package/lib/Error/DisplayErrorCode.js

@@ -12,26 +12,33 @@ class DisplayError extends ErrorHighlight_1.ErrorHighLighter {
      */
     static show(errorPath, message, res, req) {
         try {
-            const pathParts = errorPath.replace(/\(|\)/g, "").split(/\//g);
-            const lastIndex = pathParts.length - 1;
-            const [actualPath, startLineStr, endLineStr] = pathParts[lastIndex].split(/:/);
-            let startLine = Number(startLineStr) || 0;
-            let endLine = Number(endLineStr) || startLine;
-            pathParts[lastIndex] = actualPath;
-            // console.log("File Path:", pathParts.join("/"));
-            // console.log("Error at Line:", startLine, "to", endLine);
-            // Ensure startLine is <= endLine
+            const cleaned = errorPath.replace(/\(|\)/g, "").trim();
+            const lineMatch = cleaned.match(/(\d+):(\d+)$/);
+            let fullPath;
+            let startLine;
+            let endLine;
+            if (lineMatch) {
+                fullPath = cleaned
+                    .slice(0, cleaned.length - lineMatch[0].length)
+                    .replace(/[\s:]+$/, "")
+                    .trim();
+                startLine = Math.max(1, Number(lineMatch[1]) || 1);
+                endLine = Math.max(startLine, Number(lineMatch[2]) || startLine);
+            }
+            else {
+                fullPath = cleaned;
+                startLine = 1;
+                endLine = 1;
+            }
             if (startLine > endLine) {
-                [startLine, endLine] = [endLine, startLine]; // Swap if needed
+                [startLine, endLine] = [endLine, startLine];
             }
-            // If API request → send JSON response
             if (req.expectsJson() && !req.isInertia()) {
                 return res.status(500).json({
-                    stack: pathParts.join("/").trim() + ` on line ${startLine}:${endLine}`,
+                    stack: fullPath.trim() + ` on line ${startLine}:${endLine}`,
                     error: ` ${message} `,
                 });
             }
-            const fullPath = pathParts.join("/");
             const code = fs_1.default.readFileSync(fullPath, "utf8");
             const content = code.split(/\n/g);
             // console.log("Total lines in file:", content.length);
@@ -46,16 +53,19 @@ class DisplayError extends ErrorHighlight_1.ErrorHighLighter {
             const formattedContent = snippet
                 .map((line, i) => `${from + i + 1}. ${line}`)
                 .join("\n");
-            const html = this.renderHtml(formattedContent, startLine, `
+            const errorLineInSnippet = startLine - from;
+            const html = this.renderHtml(formattedContent, errorLineInSnippet, `
           <p class='py-2 text-red'>${message.trim()}</p>
           <p class='p-2 text-sm'> ${fullPath.trim()} ${startLine}:${endLine} </p>
         `);
             return res.status(500).send(html);
         }
         catch (error) {
-            return res
-                .status(500)
-                .json({ message: "Internal Error", error: error.message });
+            return res.status(500).json({
+                message: "Internal Error",
+                error: error.message,
+                stack: error.stack,
+            });
         }
     }
     static renderHtml(code, line, message) {

package/lib/Error/MissMatchTokenException/index.d.ts

@@ -0,0 +1,4 @@
+export declare class MissMatchTokenException extends Error {
+    constructor(message: string);
+}
+//# sourceMappingURL=index.d.ts.map

package/lib/Error/MissMatchTokenException/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../jcc-express-mvc/lib/Error/MissMatchTokenException/index.ts"],"names":[],"mappings":"AAAA,qBAAa,uBAAwB,SAAQ,KAAK;gBACpC,OAAO,EAAE,MAAM;CAG5B"}

package/lib/Error/MissMatchTokenException/index.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MissMatchTokenException = void 0;
+class MissMatchTokenException extends Error {
+    constructor(message) {
+        super(message);
+    }
+}
+exports.MissMatchTokenException = MissMatchTokenException;

package/lib/Error/SocialiteAuthError/SocialiteAuthError.d.ts

@@ -0,0 +1,9 @@
+export declare class SocialiteAuthError extends Error {
+    private provider;
+    /**
+     * @param {string} message
+     */
+    constructor(message: string, provider?: string);
+    getProvider(): string;
+}
+//# sourceMappingURL=SocialiteAuthError.d.ts.map

package/lib/Error/SocialiteAuthError/SocialiteAuthError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SocialiteAuthError.d.ts","sourceRoot":"","sources":["../../../../jcc-express-mvc/lib/Error/SocialiteAuthError/SocialiteAuthError.ts"],"names":[],"mappings":"AAAA,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C,OAAO,CAAC,QAAQ,CAAS;IACzB;;OAEG;gBACS,OAAO,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAoB;IAMpD,WAAW,IAAI,MAAM;CAG7B"}

package/lib/Error/SocialiteAuthError/SocialiteAuthError.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SocialiteAuthError = void 0;
+class SocialiteAuthError extends Error {
+    /**
+     * @param {string} message
+     */
+    constructor(message, provider = "socialite") {
+        super(message);
+        this.name = "SocialiteAuthError";
+        this.provider = provider;
+    }
+    getProvider() {
+        return this.provider;
+    }
+}
+exports.SocialiteAuthError = SocialiteAuthError;

package/lib/Global/helpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../../jcc-express-mvc/lib/Global/helpers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAUzD,eAAO,MAAM,aAAa,GAAI,KAAK,WAAW,SAoH7C,CAAC"}
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../../jcc-express-mvc/lib/Global/helpers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAmBzD,eAAO,MAAM,aAAa,GAAI,KAAK,WAAW,SAqH7C,CAAC"}

package/lib/Global/helpers.js

@@ -1,15 +1,16 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.globalHelpers = void 0;
-const Application_1 = require("../Application/Application");
 const Config_1 = require("../Config/Config");
 const Event_1 = require("../Event/Event");
 const Str_1 = require("../util/Str");
 const util_1 = require("../util");
 const Authorization_1 = require("../Authorization");
 const Date_1 = require("../Date");
+const index_1 = require("../Auth/index");
 const globalHelpers = (app) => {
-    globalThis.app = Application_1.Application.getInstance();
+    (0, util_1.assertProductionJwtSecret)();
+    globalThis.app = app;
     //
     globalThis.env = (key, defaultValue) => {
         return Config_1.config.get(key, defaultValue);
@@ -53,7 +54,7 @@ const globalHelpers = (app) => {
         return app.resolve("next");
     };
     globalThis.auth = () => {
-        return app.resolve("request")?.user || null;
+        return index_1.Authentication;
     };
     globalThis.validate = async (validation, customMessages) => {
         return (app
@@ -75,11 +76,11 @@ const globalHelpers = (app) => {
             ? app.resolve("response")["redirect"](url)
             : app.resolve("response")["redirectBack"]();
     };
-    globalThis.auth = () => {
-        return app.resolve("request")?.user;
-    };
     globalThis.now = (date = new Date()) => {
         return new Date_1.Carbon(date);
     };
+    globalThis.session = () => {
+        return app.resolve("request")?.jccSession;
+    };
 };
 exports.globalHelpers = globalHelpers;

package/lib/Http/index.d.ts

@@ -7,7 +7,7 @@ export declare class Http extends HttpHeaders {
     private static body;
     private static resolveParam;
     static get(url: string, params?: Record<string, any>): Promise<axios.AxiosResponse<any, any, {}>>;
-    static post(url: string, data?: Record<string, any>): Promise<axios.AxiosResponse<any, any, {}>>;
+    static post(url: string, data?: Record<string, any> | string): Promise<axios.AxiosResponse<any, any, {}>>;
     static withQueryParameters(params?: Record<string, any>): typeof Http;
     static withBody(data?: Record<string, any>, contentType?: string): typeof Http;
     static patch(url: string, data?: Record<string, any>): Promise<axios.AxiosResponse<any, any, {}>>;
@@ -17,5 +17,7 @@ export declare class Http extends HttpHeaders {
     static delete(url: string): Promise<axios.AxiosResponse<any, any, {}>>;
     static accept(content: string): typeof Http;
     static acceptJson(): typeof Http;
+    /** Clear fluent state so chained headers/query/body do not leak across requests. */
+    static reset(): typeof Http;
 }
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../jcc-express-mvc/lib/Http/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE3C,qBAAa,IAAK,SAAQ,WAAW;IAEnC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAuB;IAG3C,OAAO,CAAC,MAAM,CAAC,WAAW,CAA2B;IAGrD,OAAO,CAAC,MAAM,CAAC,OAAO,CAA2B;IAGjD,OAAO,CAAC,MAAM,CAAC,IAAI,CAA2B;IAG9C,OAAO,CAAC,MAAM,CAAC,YAAY;IAO3B,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAM;IAIxD,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,GAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAM;IAMvD,MAAM,CAAC,mBAAmB,CAAC,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAM;IAK3D,MAAM,CAAC,QAAQ,CACb,IAAI,GAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAM,EAC9B,WAAW,SAA2B;IAOxC,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,GAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAM;IAMxD,MAAM,CAAC,WAAW,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAK/C,MAAM,CAAC,MAAM;IAIb,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,GAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAM;IAMtD,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,MAAM;IAIzB,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM;IAK7B,MAAM,CAAC,UAAU;CAIlB"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../jcc-express-mvc/lib/Http/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE3C,qBAAa,IAAK,SAAQ,WAAW;IAEnC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAuB;IAG3C,OAAO,CAAC,MAAM,CAAC,WAAW,CAA2B;IAGrD,OAAO,CAAC,MAAM,CAAC,OAAO,CAA2B;IAGjD,OAAO,CAAC,MAAM,CAAC,IAAI,CAA2B;IAG9C,OAAO,CAAC,MAAM,CAAC,YAAY;IAO3B,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAM;IAQxD,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,GAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAW;IAQhE,MAAM,CAAC,mBAAmB,CAAC,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAM;IAK3D,MAAM,CAAC,QAAQ,CACb,IAAI,GAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAM,EAC9B,WAAW,SAA2B;IAOxC,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,GAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAM;IAQxD,MAAM,CAAC,WAAW,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAK/C,MAAM,CAAC,MAAM;IAIb,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,GAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAM;IAQtD,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,MAAM;IAQzB,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM;IAK7B,MAAM,CAAC,UAAU;IAKjB,oFAAoF;IACpF,MAAM,CAAC,KAAK,IAAI,OAAO,IAAI;CAM5B"}

package/lib/Http/index.js

@@ -15,12 +15,18 @@ class Http extends HttpHeader_1.HttpHeaders {
         return url;
     }
     static get(url, params = {}) {
-        return this.axios.get(this.resolveParam(url), { headers: this.headers });
+        const response = this.axios.get(this.resolveParam(url), {
+            headers: this.headers,
+        });
+        this.reset();
+        return response;
     }
     static post(url, data = {}) {
-        return this.axios.post(this.resolveParam(url), data, {
+        const response = this.axios.post(this.resolveParam(url), data, {
             headers: this.headers,
         });
+        this.reset();
+        return response;
     }
     static withQueryParameters(params = {}) {
         this.queryParams = params;
@@ -32,9 +38,11 @@ class Http extends HttpHeader_1.HttpHeaders {
         return this;
     }
     static patch(url, data = {}) {
-        return this.axios.patch(this.resolveParam(url), data, {
+        const response = this.axios.patch(this.resolveParam(url), data, {
             headers: this.headers,
         });
+        this.reset();
+        return response;
     }
     static withHeaders(headers) {
         this.headers = headers;
@@ -44,12 +52,18 @@ class Http extends HttpHeader_1.HttpHeaders {
         return this.withHeaders({ "Content-Type": this.HttpHeaders["form-data"] });
     }
     static put(url, data = {}) {
-        return this.axios.put(this.resolveParam(url), data, {
+        const response = this.axios.put(this.resolveParam(url), data, {
             headers: this.headers,
         });
+        this.reset();
+        return response;
     }
     static delete(url) {
-        return this.axios.delete(this.resolveParam(url), { headers: this.headers });
+        const response = this.axios.delete(this.resolveParam(url), {
+            headers: this.headers,
+        });
+        this.reset();
+        return response;
     }
     static accept(content) {
         this.headers = { Accept: content, ...this.headers };
@@ -59,6 +73,13 @@ class Http extends HttpHeader_1.HttpHeaders {
         this.headers = { ...this.headers, Accept: this.HttpHeaders["json"] };
         return this;
     }
+    /** Clear fluent state so chained headers/query/body do not leak across requests. */
+    static reset() {
+        this.queryParams = {};
+        this.headers = {};
+        this.body = {};
+        return this;
+    }
 }
 exports.Http = Http;
 //

package/lib/Interface/index.d.ts

@@ -28,9 +28,10 @@ export interface AppRequest extends Request {
      */
     id: string;
     /**
-     * JCC session instance attached to the request.
+     * JCC session bridge (same backing store as `express-session` + `connect-flash`).
+     * Set after session middleware when `req.session` exists.
      */
-    jccSession: Session;
+    jccSession?: Session;
     /**
      * Adds a validation method to the request object for validating incoming data.
      *
@@ -129,6 +130,11 @@ export interface AppRequest extends Request {
     hasFile(key: string): boolean;
     isMethod(method: string): boolean;
     fullUrl(): string;
+    /**
+     * Returns the CSRF token for the current session.
+     * Available when the csrf() middleware is active.
+     */
+    csrfToken?: () => string;
 }
 export interface AppResponse extends Response {
     redirectBack: () => any;
@@ -223,7 +229,9 @@ export interface CacheConfig {
     };
 }
 export interface SessionConfig {
+    /** `file` | `database` (Knex/Jcc-eloquent) | `redis` */
     driver: "file" | "database" | "redis";
+    /** Session lifetime in milliseconds (express-session cookie maxAge). */
     lifetime: number;
     cookie: {
         name: string;
@@ -231,19 +239,25 @@ export interface SessionConfig {
         secure: boolean;
         sameSite: "strict" | "lax" | "none";
         maxAge: number;
+        path?: string;
+        domain?: string;
     };
     files?: {
         path: string;
     };
     database?: {
-        connection: string;
+        /** Reserved for multi-connection setups; table name is primary. */
+        connection?: string;
         table: string;
     };
     redis?: {
         host: string;
         port: number;
         password?: string;
+        /** Redis DB index (default 0). */
         database?: number;
+        /** Key prefix for session keys (default `session:`). */
+        prefix?: string;
     };
 }
 export interface SessionData {