jcc-express-mvc 1.8.7 → 1.8.21

package/Core/index.d.ts

@@ -1,3 +1,7 @@
 export * from "../lib/Application/Application";
 export * from "../lib/Routes/Route";
+export { csrf } from "../lib/Security/CsrfMiddleware";
+export type { CsrfOptions } from "../lib/Security/CsrfMiddleware";
+export { methodSpoofing } from "../lib/Security/MethodSpoofingMiddleware";
+export type { MethodSpoofingOptions } from "../lib/Security/MethodSpoofingMiddleware";
 //# sourceMappingURL=index.d.ts.map

package/Core/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../jcc-express-mvc/Core/index.ts"],"names":[],"mappings":"AAAA,cAAc,gCAAgC,CAAC;AAC/C,cAAc,qBAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../jcc-express-mvc/Core/index.ts"],"names":[],"mappings":"AAAA,cAAc,gCAAgC,CAAC;AAC/C,cAAc,qBAAqB,CAAC;AACpC,OAAO,EAAE,IAAI,EAAE,MAAM,gCAAgC,CAAC;AACtD,YAAY,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAClE,OAAO,EAAE,cAAc,EAAE,MAAM,0CAA0C,CAAC;AAC1E,YAAY,EAAE,qBAAqB,EAAE,MAAM,0CAA0C,CAAC"}

package/Core/index.js

@@ -14,5 +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.methodSpoofing = exports.csrf = void 0;
 __exportStar(require("../lib/Application/Application"), exports);
 __exportStar(require("../lib/Routes/Route"), exports);
+var CsrfMiddleware_1 = require("../lib/Security/CsrfMiddleware");
+Object.defineProperty(exports, "csrf", { enumerable: true, get: function () { return CsrfMiddleware_1.csrf; } });
+var MethodSpoofingMiddleware_1 = require("../lib/Security/MethodSpoofingMiddleware");
+Object.defineProperty(exports, "methodSpoofing", { enumerable: true, get: function () { return MethodSpoofingMiddleware_1.methodSpoofing; } });

package/__tests__/Job.test.d.ts

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

package/__tests__/Job.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Job.test.d.ts","sourceRoot":"","sources":["../../jcc-express-mvc/__tests__/Job.test.ts"],"names":[],"mappings":""}

package/__tests__/Job.test.js

@@ -0,0 +1,205 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const Job_1 = require("../lib/Queue/Job");
+const Application_1 = require("../lib/Application/Application");
+const ApplicationBuilder_1 = require("../lib/Application/ApplicationBuilder");
+const util_1 = require("../lib/util");
+class TestJob extends Job_1.Job {
+    async handle() {
+        // no-op for tests
+    }
+}
+class DelayedTestJob extends Job_1.Job {
+    constructor() {
+        super(...arguments);
+        this.delay = 5;
+    }
+    async handle() {
+        // no-op for tests
+    }
+}
+class NestedFolderJob extends Job_1.Job {
+    constructor() {
+        super(...arguments);
+        this.path = "Notifications/SendEmail";
+    }
+    async handle() {
+        // no-op for tests
+    }
+}
+(0, vitest_1.describe)("Job", () => {
+    (0, vitest_1.describe)("serialize", () => {
+        (0, vitest_1.it)("includes job name, data, and metadata", () => {
+            const job = new TestJob({ value: "hello" });
+            const serialized = job.serialize();
+            const parsed = JSON.parse(serialized);
+            (0, vitest_1.expect)(parsed.job).toBe("TestJob");
+            (0, vitest_1.expect)(parsed.data).toEqual({ value: "hello" });
+            (0, vitest_1.expect)(parsed.displayName).toBe("TestJob");
+            (0, vitest_1.expect)(parsed.maxAttempts).toBe(3);
+            (0, vitest_1.expect)(parsed.timeout).toBe(60);
+            (0, vitest_1.expect)(parsed.attempts).toBe(0);
+            (0, vitest_1.expect)(parsed.delay).toBe(0);
+        });
+        (0, vitest_1.it)("includes delay when set", () => {
+            const job = new DelayedTestJob({ value: "delayed" });
+            const serialized = job.serialize();
+            const parsed = JSON.parse(serialized);
+            (0, vitest_1.expect)(parsed.delay).toBe(5);
+        });
+        (0, vitest_1.it)("uses default path (constructor name) when path is empty", () => {
+            const job = new TestJob({ value: "x" });
+            (0, vitest_1.expect)(job.jobPath).toBe("TestJob");
+            const serialized = job.serialize();
+            const parsed = JSON.parse(serialized);
+            (0, vitest_1.expect)(parsed.path).toBe("TestJob");
+        });
+        (0, vitest_1.it)("includes custom path when set for nested folders", () => {
+            const job = new NestedFolderJob({ value: "x" });
+            (0, vitest_1.expect)(job.jobPath).toBe("Notifications/SendEmail");
+            const serialized = job.serialize();
+            const parsed = JSON.parse(serialized);
+            (0, vitest_1.expect)(parsed.path).toBe("Notifications/SendEmail");
+        });
+    });
+    (0, vitest_1.describe)("fromSerialized", () => {
+        (0, vitest_1.it)("reconstructs job from serialized string", () => {
+            const job = new TestJob({ value: "restored" });
+            job.id = "test-id";
+            job.attempts = 2;
+            const serialized = job.serialize();
+            const jobClasses = { TestJob };
+            const restored = Job_1.Job.fromSerialized(serialized, jobClasses);
+            (0, vitest_1.expect)(restored).toBeInstanceOf(TestJob);
+            (0, vitest_1.expect)(restored.data).toEqual({ value: "restored" });
+            (0, vitest_1.expect)(restored.id).toBe("test-id");
+            (0, vitest_1.expect)(restored.attempts).toBe(2);
+            (0, vitest_1.expect)(restored.path).toBe("TestJob");
+        });
+        (0, vitest_1.it)("restores custom path from serialized string", () => {
+            const job = new NestedFolderJob({ value: "x" });
+            const serialized = job.serialize();
+            const jobClasses = { NestedFolderJob };
+            const restored = Job_1.Job.fromSerialized(serialized, jobClasses);
+            (0, vitest_1.expect)(restored.path).toBe("Notifications/SendEmail");
+        });
+        (0, vitest_1.it)("throws for unknown job class", () => {
+            const serialized = JSON.stringify({
+                job: "UnknownJob",
+                data: {},
+                id: "x",
+                displayName: "UnknownJob",
+                maxAttempts: 3,
+                timeout: 60,
+                attempts: 0,
+            });
+            (0, vitest_1.expect)(() => Job_1.Job.fromSerialized(serialized, { TestJob })).toThrow(/Unknown job class: UnknownJob/);
+        });
+    });
+    (0, vitest_1.describe)("backoff", () => {
+        (0, vitest_1.it)("returns exponential backoff in ms", () => {
+            const job = new TestJob({ value: "x" });
+            (0, vitest_1.expect)(job.backoff(0)).toBe(1000);
+            (0, vitest_1.expect)(job.backoff(1)).toBe(2000);
+            (0, vitest_1.expect)(job.backoff(2)).toBe(4000);
+        });
+    });
+    (0, vitest_1.describe)("dispatch", () => {
+        let app;
+        let originalApp;
+        (0, vitest_1.beforeEach)(() => {
+            app = Application_1.Application.getInstance();
+            originalApp = globalThis.app;
+            globalThis.app = app;
+            const config = {
+                queue: {
+                    default: "memory",
+                    connections: {
+                        memory: { driver: "memory", queue: "default" },
+                    },
+                },
+            };
+            new ApplicationBuilder_1.ApplicationBuilder(app).withConfig(config);
+        });
+        (0, vitest_1.afterEach)(() => {
+            globalThis.app = originalApp;
+        });
+        (0, vitest_1.it)("dispatches job to queue and returns job id", async () => {
+            const id = await TestJob.dispatch({ value: "dispatched" });
+            (0, vitest_1.expect)(id).toBeDefined();
+            (0, vitest_1.expect)(typeof id).toBe("string");
+            (0, vitest_1.expect)(id.length).toBeGreaterThan(0);
+        });
+        (0, vitest_1.it)("throws when Queue is not registered", async () => {
+            globalThis.app = { resolve: () => undefined };
+            await (0, vitest_1.expect)(TestJob.dispatch({ value: "x" })).rejects.toThrow(/Queue not registered/);
+        });
+    });
+});
+(0, vitest_1.describe)("Queue", () => {
+    let queue;
+    let app;
+    let originalApp;
+    (0, vitest_1.beforeEach)(() => {
+        app = Application_1.Application.getInstance();
+        originalApp = globalThis.app;
+        globalThis.app = app;
+        const config = {
+            queue: {
+                default: "memory",
+                connections: {
+                    memory: { driver: "memory", queue: "default" },
+                },
+            },
+        };
+        new ApplicationBuilder_1.ApplicationBuilder(app).withConfig(config);
+        queue = app.resolve("Queue");
+    });
+    (0, vitest_1.afterEach)(() => {
+        globalThis.app = originalApp;
+    });
+    (0, vitest_1.describe)("push", () => {
+        (0, vitest_1.it)("stores job class (constructor) not instance for later resolution", async () => {
+            const job = new TestJob({ value: "push-test" });
+            const id = await queue.push(job);
+            (0, vitest_1.expect)(id).toBeDefined();
+            // Process the job - this would fail if we stored the instance
+            // because we need to instantiate a fresh job from the class
+            const processed = await queue.processNext();
+            (0, vitest_1.expect)(processed).toBe(true);
+        });
+        (0, vitest_1.it)("returns a valid uuid", async () => {
+            const job = new TestJob({ value: "uuid-test" });
+            const id = await queue.push(job);
+            const uuidRegex = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+            (0, vitest_1.expect)(id).toMatch(uuidRegex);
+        });
+    });
+    (0, vitest_1.describe)("later", () => {
+        (0, vitest_1.it)("registers job class for delayed jobs", async () => {
+            const job = new TestJob({ value: "later-test" });
+            const id = await queue.later(job, 0);
+            (0, vitest_1.expect)(id).toBeDefined();
+            // With delay 0, job should be available immediately
+            const processed = await queue.processNext();
+            (0, vitest_1.expect)(processed).toBe(true);
+        });
+        (0, vitest_1.it)("processes job with custom path (nested folder)", async () => {
+            const job = new NestedFolderJob({ value: "nested-test" });
+            const id = await queue.push(job);
+            (0, vitest_1.expect)(id).toBeDefined();
+            // jobClasses has the class, so path is used for getJobClass fallback only
+            const processed = await queue.processNext();
+            (0, vitest_1.expect)(processed).toBe(true);
+        });
+    });
+});
+(0, vitest_1.describe)("getJobClass", () => {
+    (0, vitest_1.it)("returns false for non-existent job", () => {
+        const spy = vitest_1.vi.spyOn(console, "log").mockImplementation(() => { });
+        const result = (0, util_1.getJobClass)("NonExistentJob12345");
+        (0, vitest_1.expect)(result).toBe(false);
+        spy.mockRestore();
+    });
+});

package/__tests__/MySqlSchemaBlueprint.test.d.ts

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

package/__tests__/MySqlSchemaBlueprint.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MySqlSchemaBlueprint.test.d.ts","sourceRoot":"","sources":["../../jcc-express-mvc/__tests__/MySqlSchemaBlueprint.test.ts"],"names":[],"mappings":""}

package/__tests__/MySqlSchemaBlueprint.test.js

@@ -0,0 +1,55 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const BluePrint_1 = require("../lib/Jcc-eloquent/lib/Schema/BluePrint");
+const Translator_1 = require("../lib/Jcc-eloquent/lib/Schema/Translator");
+(0, vitest_1.describe)("MySQL schema blueprint behavior", () => {
+    const originalDbConnection = process.env.DB_CONNECTION;
+    (0, vitest_1.beforeEach)(() => {
+        process.env.DB_CONNECTION = "mysql2";
+    });
+    (0, vitest_1.afterEach)(() => {
+        process.env.DB_CONNECTION = originalDbConnection;
+    });
+    (0, vitest_1.it)("builds Laravel-style index SQL for a single column", () => {
+        const table = new BluePrint_1.Blueprint("users");
+        table.index("email");
+        const sql = table.toSQL("CREATE", "users");
+        (0, vitest_1.expect)(sql).toContain("INDEX idx_users_email (email)");
+    });
+    (0, vitest_1.it)("builds Laravel-style index SQL for composite columns", () => {
+        const table = new BluePrint_1.Blueprint("users");
+        table.index(["email", "status"]);
+        const sql = table.toSQL("CREATE", "users");
+        (0, vitest_1.expect)(sql).toContain("INDEX idx_users_email_status (email, status)");
+    });
+    (0, vitest_1.it)("supports custom index names", () => {
+        const table = new BluePrint_1.Blueprint("users");
+        table.index("email", "idx_custom_email");
+        const sql = table.toSQL("CREATE", "users");
+        (0, vitest_1.expect)(sql).toContain("INDEX idx_custom_email (email)");
+    });
+    (0, vitest_1.it)("emits ADD ... AFTER for alter add-column positioning", () => {
+        const table = new BluePrint_1.Blueprint("users");
+        table.string("nickname").after("email");
+        const sql = table.toSQL("ALTER", "users");
+        (0, vitest_1.expect)(sql).toBe("ALTER TABLE users ADD nickname VARCHAR(255) NOT NULL AFTER email;");
+    });
+    (0, vitest_1.it)("emits ADD ... FIRST for alter add-column positioning", () => {
+        const table = new BluePrint_1.Blueprint("users");
+        table.string("nickname").first();
+        const sql = table.toSQL("ALTER", "users");
+        (0, vitest_1.expect)(sql).toBe("ALTER TABLE users ADD nickname VARCHAR(255) NOT NULL FIRST;");
+    });
+    (0, vitest_1.it)("applies change() as MODIFY COLUMN on the same declared column", () => {
+        const table = new BluePrint_1.Blueprint("users");
+        table.string("display_name").change();
+        const sql = table.toSQL("ALTER", "users");
+        (0, vitest_1.expect)(sql).toBe("ALTER TABLE users MODIFY COLUMN display_name VARCHAR(255) NOT NULL;");
+    });
+    (0, vitest_1.it)("keeps SQL unchanged for mysql client in Translator.compile", () => {
+        const raw = "ALTER TABLE users ADD nickname VARCHAR(255) NOT NULL AFTER email;";
+        const out = Translator_1.Translator.compile("mysql2", raw);
+        (0, vitest_1.expect)(out).toBe(raw);
+    });
+});

package/__tests__/PostgresTranslator.test.d.ts

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

package/__tests__/PostgresTranslator.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PostgresTranslator.test.d.ts","sourceRoot":"","sources":["../../jcc-express-mvc/__tests__/PostgresTranslator.test.ts"],"names":[],"mappings":""}

package/__tests__/PostgresTranslator.test.js

@@ -0,0 +1,82 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const postgres_1 = require("../lib/Jcc-eloquent/lib/Schema/Translator/postgres");
+(0, vitest_1.describe)("PostgresTranslator", () => {
+    (0, vitest_1.it)("translates CREATE TABLE core MySQL types and auto increment", () => {
+        const sql = "CREATE TABLE users (id BIGINT UNSIGNED AUTO_INCREMENT, age INT NOT NULL, score DOUBLE NOT NULL, ratio FLOAT NOT NULL, body LONGTEXT NOT NULL, data MEDIUMBLOB NOT NULL, created_at DATETIME NOT NULL);";
+        const out = postgres_1.PostgresTranslator.translate(sql);
+        (0, vitest_1.expect)(out).toContain("id BIGSERIAL");
+        (0, vitest_1.expect)(out).toContain("age INTEGER NOT NULL");
+        (0, vitest_1.expect)(out).toContain("score DOUBLE PRECISION NOT NULL");
+        (0, vitest_1.expect)(out).toContain("ratio REAL NOT NULL");
+        (0, vitest_1.expect)(out).toContain("body TEXT NOT NULL");
+        (0, vitest_1.expect)(out).toContain("data BYTEA NOT NULL");
+        (0, vitest_1.expect)(out).toContain("created_at TIMESTAMP NOT NULL");
+        (0, vitest_1.expect)(out).not.toContain("UNSIGNED");
+        (0, vitest_1.expect)(out).not.toContain("AUTO_INCREMENT");
+    });
+    (0, vitest_1.it)("converts composite UNIQUE KEY to CONSTRAINT UNIQUE", () => {
+        const sql = "CREATE TABLE docs (slug VARCHAR(255) NOT NULL, version_id BIGINT NOT NULL, UNIQUE KEY uk_docs_slug_version (slug, version_id));";
+        const out = postgres_1.PostgresTranslator.translate(sql);
+        (0, vitest_1.expect)(out).toContain("CONSTRAINT uk_docs_slug_version UNIQUE (slug, version_id)");
+        (0, vitest_1.expect)(out).not.toContain("UNIQUE KEY");
+    });
+    (0, vitest_1.it)("converts boolean numeric defaults to TRUE/FALSE", () => {
+        const sql = "CREATE TABLE flags (is_active BOOLEAN NOT NULL DEFAULT 1, is_public BOOLEAN DEFAULT 0, attempts INT DEFAULT 0);";
+        const out = postgres_1.PostgresTranslator.translate(sql);
+        (0, vitest_1.expect)(out).toContain("is_active BOOLEAN NOT NULL DEFAULT TRUE");
+        (0, vitest_1.expect)(out).toContain("is_public BOOLEAN DEFAULT FALSE");
+        (0, vitest_1.expect)(out).toContain("attempts INTEGER DEFAULT 0");
+    });
+    (0, vitest_1.it)("removes MySQL ON UPDATE CURRENT_TIMESTAMP and table options", () => {
+        const sql = "CREATE TABLE logs (updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;";
+        const out = postgres_1.PostgresTranslator.translate(sql);
+        (0, vitest_1.expect)(out).toContain("updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP");
+        (0, vitest_1.expect)(out).not.toContain("ON UPDATE CURRENT_TIMESTAMP");
+        (0, vitest_1.expect)(out).not.toContain("ENGINE=");
+        (0, vitest_1.expect)(out).not.toContain("DEFAULT CHARSET=");
+        (0, vitest_1.expect)(out).not.toContain("COLLATE=");
+    });
+    (0, vitest_1.it)("removes MySQL inline INDEX/KEY clauses inside CREATE TABLE", () => {
+        const sql = "CREATE TABLE users (id BIGINT UNSIGNED AUTO_INCREMENT, email VARCHAR(255) NOT NULL, INDEX idx_users_email (email), KEY idx_users_email2 (email));";
+        const out = postgres_1.PostgresTranslator.translate(sql);
+        (0, vitest_1.expect)(out).not.toContain("INDEX idx_users_email");
+        (0, vitest_1.expect)(out).not.toContain("KEY idx_users_email2");
+        (0, vitest_1.expect)(out).not.toMatch(/,\s*\)/);
+    });
+    (0, vitest_1.it)("converts ALTER TABLE drop foreign/index to drop constraint", () => {
+        const sql = "ALTER TABLE posts DROP FOREIGN KEY fk_posts_user, DROP INDEX idx_posts_title;";
+        const out = postgres_1.PostgresTranslator.translate(sql);
+        (0, vitest_1.expect)(out).toContain("DROP CONSTRAINT fk_posts_user");
+        (0, vitest_1.expect)(out).toContain("DROP CONSTRAINT idx_posts_title");
+    });
+    (0, vitest_1.it)("converts ALTER TABLE MODIFY COLUMN with nullability/default", () => {
+        const sql = "ALTER TABLE users MODIFY COLUMN is_active BOOLEAN NOT NULL DEFAULT 1;";
+        const out = postgres_1.PostgresTranslator.translate(sql);
+        (0, vitest_1.expect)(out).toContain("ALTER COLUMN is_active TYPE BOOLEAN");
+        (0, vitest_1.expect)(out).toContain("ALTER COLUMN is_active SET NOT NULL");
+        (0, vitest_1.expect)(out).toContain("ALTER COLUMN is_active SET DEFAULT TRUE");
+    });
+    (0, vitest_1.it)("converts ALTER TABLE CHANGE COLUMN with rename/type/default", () => {
+        const sql = "ALTER TABLE users CHANGE COLUMN old_name name VARCHAR(255) NOT NULL DEFAULT 'guest';";
+        const out = postgres_1.PostgresTranslator.translate(sql);
+        (0, vitest_1.expect)(out).toContain("RENAME COLUMN old_name TO name");
+        (0, vitest_1.expect)(out).toContain("ALTER COLUMN name TYPE VARCHAR(255)");
+        (0, vitest_1.expect)(out).toContain("ALTER COLUMN name SET NOT NULL");
+        (0, vitest_1.expect)(out).toContain("ALTER COLUMN name SET DEFAULT 'guest'");
+    });
+    (0, vitest_1.it)("removes MySQL-only ALTER hints AFTER/FIRST", () => {
+        const sql = "ALTER TABLE users MODIFY COLUMN score INT NOT NULL AFTER id, MODIFY COLUMN rank INT NOT NULL FIRST;";
+        const out = postgres_1.PostgresTranslator.translate(sql);
+        (0, vitest_1.expect)(out).not.toContain("AFTER id");
+        (0, vitest_1.expect)(out).not.toContain(" FIRST");
+        (0, vitest_1.expect)(out).toContain("ALTER COLUMN score TYPE INTEGER");
+        (0, vitest_1.expect)(out).toContain("ALTER COLUMN rank TYPE INTEGER");
+    });
+    (0, vitest_1.it)("removes backticks and replaces question marks with positional params", () => {
+        const sql = "SELECT * FROM `users` WHERE `id` = ? AND `email` = ?;";
+        const out = postgres_1.PostgresTranslator.translate(sql);
+        (0, vitest_1.expect)(out).toBe("SELECT * FROM users WHERE id = $1 AND email = $2;");
+    });
+});

package/__tests__/SQLiteTranslator.test.d.ts

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

package/__tests__/SQLiteTranslator.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SQLiteTranslator.test.d.ts","sourceRoot":"","sources":["../../jcc-express-mvc/__tests__/SQLiteTranslator.test.ts"],"names":[],"mappings":""}

package/__tests__/SQLiteTranslator.test.js

@@ -0,0 +1,125 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const Sqlite_1 = require("../lib/Jcc-eloquent/lib/Schema/Translator/Sqlite");
+(0, vitest_1.describe)("SQLiteTranslator", () => {
+    (0, vitest_1.it)("translates integer and float family types", () => {
+        const sql = "CREATE TABLE nums (a TINYINT, b SMALLINT, c MEDIUMINT, d INT, e BIGINT, f FLOAT(8,2), g DOUBLE(10,2), h DECIMAL(12,4));";
+        const out = Sqlite_1.SQLiteTranslator.translate(sql);
+        (0, vitest_1.expect)(out).toContain("a INTEGER");
+        (0, vitest_1.expect)(out).toContain("b INTEGER");
+        (0, vitest_1.expect)(out).toContain("c INTEGER");
+        (0, vitest_1.expect)(out).toContain("d INTEGER");
+        (0, vitest_1.expect)(out).toContain("e INTEGER");
+        (0, vitest_1.expect)(out).toContain("f REAL");
+        (0, vitest_1.expect)(out).toContain("g REAL");
+        (0, vitest_1.expect)(out).toContain("h REAL");
+    });
+    (0, vitest_1.it)("translates text and binary families", () => {
+        const sql = "CREATE TABLE docs (a CHAR(36), b VARCHAR(255), c TINYTEXT, d MEDIUMTEXT, e LONGTEXT, f BINARY(8), g VARBINARY(255), h MEDIUMBLOB, i LONGBLOB);";
+        const out = Sqlite_1.SQLiteTranslator.translate(sql);
+        (0, vitest_1.expect)(out).toContain("a TEXT");
+        (0, vitest_1.expect)(out).toContain("b TEXT");
+        (0, vitest_1.expect)(out).toContain("c TEXT");
+        (0, vitest_1.expect)(out).toContain("d TEXT");
+        (0, vitest_1.expect)(out).toContain("e TEXT");
+        (0, vitest_1.expect)(out).toContain("f BLOB");
+        (0, vitest_1.expect)(out).toContain("g BLOB");
+        (0, vitest_1.expect)(out).toContain("h BLOB");
+        (0, vitest_1.expect)(out).toContain("i BLOB");
+    });
+    (0, vitest_1.it)("translates date/time and special types", () => {
+        const sql = "CREATE TABLE meta (a DATETIME, b TIMESTAMP, c DATE, d TIME, e YEAR, f ENUM('a','b'), g SET('x','y'), h BOOLEAN, i JSON);";
+        const out = Sqlite_1.SQLiteTranslator.translate(sql);
+        (0, vitest_1.expect)(out).toContain("a TEXT");
+        (0, vitest_1.expect)(out).toContain("b TEXT");
+        (0, vitest_1.expect)(out).toContain("c TEXT");
+        (0, vitest_1.expect)(out).toContain("d TEXT");
+        (0, vitest_1.expect)(out).toContain("e INTEGER");
+        (0, vitest_1.expect)(out).toContain("f TEXT");
+        (0, vitest_1.expect)(out).toContain("g TEXT");
+        (0, vitest_1.expect)(out).toContain("h INTEGER");
+        (0, vitest_1.expect)(out).toContain("i TEXT");
+    });
+    (0, vitest_1.it)("removes mysql table options and unsupported modifiers", () => {
+        const sql = "CREATE TABLE users (id INT UNSIGNED ZEROFILL AUTO_INCREMENT, name VARCHAR(255)) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE utf8mb4_unicode_ci ROW_FORMAT=DYNAMIC;";
+        const out = Sqlite_1.SQLiteTranslator.translate(sql);
+        (0, vitest_1.expect)(out).toContain("id INTEGER AUTOINCREMENT");
+        (0, vitest_1.expect)(out).not.toContain("UNSIGNED");
+        (0, vitest_1.expect)(out).not.toContain("ZEROFILL");
+        (0, vitest_1.expect)(out).not.toContain("ENGINE=");
+        (0, vitest_1.expect)(out).not.toContain("DEFAULT CHARSET=");
+        (0, vitest_1.expect)(out).not.toContain("COLLATE ");
+        (0, vitest_1.expect)(out).not.toContain("ROW_FORMAT=");
+    });
+    (0, vitest_1.it)("converts mysql functions and limit syntax", () => {
+        const sql = "SELECT DATE_FORMAT(created_at, '%Y-%m-%d'), NOW(), IFNULL(name, 'n/a'), SUBSTRING(title,1,3), CONVERT(age, SIGNED) FROM users LIMIT 10, 20;";
+        const out = Sqlite_1.SQLiteTranslator.translate(sql);
+        (0, vitest_1.expect)(out).toContain("strftime('%Y-%m-%d', created_at)");
+        (0, vitest_1.expect)(out).toContain("datetime('now', 'localtime')");
+        (0, vitest_1.expect)(out).toContain("COALESCE(name, 'n/a')");
+        (0, vitest_1.expect)(out).toContain("SUBSTR(title,1,3)");
+        (0, vitest_1.expect)(out).toContain("CAST(age AS SIGNED)");
+        (0, vitest_1.expect)(out).toContain("LIMIT 20 OFFSET 10");
+    });
+    (0, vitest_1.it)("converts DATE_ADD and DATE_SUB", () => {
+        const sql = "SELECT DATE_ADD(created_at, INTERVAL 7 DAY), DATE_SUB(created_at, INTERVAL 2 MONTH) FROM users;";
+        const out = Sqlite_1.SQLiteTranslator.translate(sql);
+        (0, vitest_1.expect)(out).toContain("datetime(created_at, '+7 days')");
+        (0, vitest_1.expect)(out).toContain("datetime(created_at, '-2 months')");
+    });
+    (0, vitest_1.it)("strips backticks and normalizes IF NOT EXISTS", () => {
+        const sql = "CREATE TABLE IF NOT EXISTS `users` (`id` INT, `name` VARCHAR(255));";
+        const out = Sqlite_1.SQLiteTranslator.translate(sql);
+        (0, vitest_1.expect)(out).toContain("CREATE TABLE IF NOT EXISTS users");
+        (0, vitest_1.expect)(out).not.toContain("`");
+    });
+    (0, vitest_1.it)("keeps foreign keys and moves them after columns", () => {
+        const sql = "CREATE TABLE posts (id INT, user_id INT, FOREIGN KEY (user_id) REFERENCES users(id) ON DELETE CASCADE, title VARCHAR(255));";
+        const out = Sqlite_1.SQLiteTranslator.translate(sql);
+        const idxTitle = out.indexOf("title TEXT");
+        const idxFk = out.indexOf("FOREIGN KEY (user_id) REFERENCES users(id) ON DELETE CASCADE");
+        (0, vitest_1.expect)(idxTitle).toBeGreaterThan(-1);
+        (0, vitest_1.expect)(idxFk).toBeGreaterThan(-1);
+        (0, vitest_1.expect)(idxFk).toBeGreaterThan(idxTitle);
+    });
+    (0, vitest_1.it)("converts key declarations to index", () => {
+        const sql = "CREATE TABLE users (email VARCHAR(255), KEY idx_users_email (email));";
+        const out = Sqlite_1.SQLiteTranslator.translate(sql);
+        (0, vitest_1.expect)(out).toContain("INDEX idx_users_email(email)");
+    });
+    (0, vitest_1.it)("converts multi-column key declarations to index", () => {
+        const sql = "CREATE TABLE users (email VARCHAR(255), role VARCHAR(50), KEY idx_users_email_role (email, role));";
+        const out = Sqlite_1.SQLiteTranslator.translate(sql);
+        (0, vitest_1.expect)(out).toContain("INDEX idx_users_email_role(email, role)");
+    });
+    (0, vitest_1.it)("rewrites unsupported ALTER MODIFY with guidance comment", () => {
+        const sql = "ALTER TABLE users MODIFY COLUMN name VARCHAR(100);";
+        const out = Sqlite_1.SQLiteTranslator.translate(sql);
+        (0, vitest_1.expect)(out).toContain("SQLite doesn't support MODIFY COLUMN directly");
+        (0, vitest_1.expect)(out).toContain("ALTER TABLE users attempted to modify column name");
+    });
+    (0, vitest_1.it)("rewrites unsupported ALTER CHANGE with guidance comment", () => {
+        const sql = "ALTER TABLE users CHANGE COLUMN old_name name VARCHAR(100) NOT NULL;";
+        const out = Sqlite_1.SQLiteTranslator.translate(sql);
+        (0, vitest_1.expect)(out).toContain("SQLite doesn't support CHANGE COLUMN directly");
+        (0, vitest_1.expect)(out).toContain("ALTER TABLE users attempted to change column old_name to name");
+    });
+    (0, vitest_1.it)("rewrites ALTER TABLE DROP COLUMN with guidance comment", () => {
+        const sql = "ALTER TABLE users DROP COLUMN middle_name;";
+        const out = Sqlite_1.SQLiteTranslator.translate(sql);
+        (0, vitest_1.expect)(out).toContain("Safer cross-version approach is table rebuild");
+        (0, vitest_1.expect)(out).toContain("ALTER TABLE users attempted to drop column middle_name");
+    });
+    (0, vitest_1.it)("rewrites ALTER TABLE DROP INDEX to SQLite DROP INDEX", () => {
+        const sql = "ALTER TABLE users DROP INDEX idx_users_email;";
+        const out = Sqlite_1.SQLiteTranslator.translate(sql);
+        (0, vitest_1.expect)(out).toContain("DROP INDEX IF EXISTS idx_users_email;");
+    });
+    (0, vitest_1.it)("rewrites ALTER TABLE DROP FOREIGN KEY with rebuild guidance", () => {
+        const sql = "ALTER TABLE users DROP FOREIGN KEY fk_users_roles;";
+        const out = Sqlite_1.SQLiteTranslator.translate(sql);
+        (0, vitest_1.expect)(out).toContain("doesn't support dropping a foreign key constraint directly");
+        (0, vitest_1.expect)(out).toContain("ALTER TABLE users attempted to drop foreign key fk_users_roles");
+    });
+});

package/__tests__/SchemaAlterBlueprint.test.d.ts

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

package/__tests__/SchemaAlterBlueprint.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SchemaAlterBlueprint.test.d.ts","sourceRoot":"","sources":["../../jcc-express-mvc/__tests__/SchemaAlterBlueprint.test.ts"],"names":[],"mappings":""}

package/__tests__/SchemaAlterBlueprint.test.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const BluePrint_1 = require("../lib/Jcc-eloquent/lib/Schema/BluePrint");
+(0, vitest_1.describe)("Schema ALTER blueprint behavior", () => {
+    const originalDbConnection = process.env.DB_CONNECTION;
+    (0, vitest_1.beforeEach)(() => {
+        // Use mysql-like output to assert raw ALTER SQL shape.
+        process.env.DB_CONNECTION = "mysql2";
+    });
+    (0, vitest_1.afterEach)(() => {
+        process.env.DB_CONNECTION = originalDbConnection;
+    });
+    (0, vitest_1.it)("adds ADD prefix for new column with after()", () => {
+        const table = new BluePrint_1.Blueprint("users");
+        table.string("nickname").after("email");
+        const sql = table.toSQL("ALTER", "users");
+        (0, vitest_1.expect)(sql).toContain("ALTER TABLE users ADD nickname VARCHAR(255) NOT NULL AFTER email;");
+    });
+    (0, vitest_1.it)("adds ADD prefix for new column with first()", () => {
+        const table = new BluePrint_1.Blueprint("users");
+        table.string("nickname").first();
+        const sql = table.toSQL("ALTER", "users");
+        (0, vitest_1.expect)(sql).toContain("ALTER TABLE users ADD nickname VARCHAR(255) NOT NULL FIRST;");
+    });
+    (0, vitest_1.it)("change() applies MODIFY COLUMN to the last declared column", () => {
+        const table = new BluePrint_1.Blueprint("users");
+        table.string("first_col");
+        table.string("last_col").change();
+        const sql = table.toSQL("ALTER", "users");
+        (0, vitest_1.expect)(sql).toContain("ADD first_col VARCHAR(255) NOT NULL");
+        (0, vitest_1.expect)(sql).toContain("MODIFY COLUMN last_col VARCHAR(255) NOT NULL");
+        (0, vitest_1.expect)(sql).not.toContain("MODIFY COLUMN first_col");
+    });
+});

package/global.d.ts

@@ -15,6 +15,7 @@ import { Queue } from "./lib/Queue";
 import { Container } from "./lib/Container";
 import { Carbon } from "./lib/Date";
 import { GateFacade } from "./lib/Authorization";
+import { Authentication as Auth } from "./lib/Auth/index";
 
 declare global {
   var app: Container;
@@ -32,7 +33,7 @@ declare global {
   var request: () => Request;
   var response: () => Response;
   var next: () => Next;
-  var auth: () => Request["user"];
+  var auth: () => typeof Auth;
 
   var view: (
     view: string,
@@ -58,6 +59,7 @@ declare global {
   var Gate: typeof GateFacade;
   var can: typeof GateFacade.can;
   var authorize: typeof GateFacade.authorize;
+  var session: () => Request["jccSession"];
 }
 
 export {};