jcc-express-mvc 1.8.29 → 1.9.0

package/global.d.ts

@@ -16,6 +16,7 @@ import { Container } from "./lib/Container";
 import { Carbon } from "./lib/Date";
 import { GateFacade } from "./lib/Authorization";
 import { Authentication as Auth } from "./lib/Auth/index";
+import { Log } from "./lib/Logger/Logger";
 
 declare global {
   var app: Container;
@@ -61,6 +62,10 @@ declare global {
   var authorize: typeof GateFacade.authorize;
   var session: () => Request["jccSession"];
   var defer: (callback: () => any) => void;
+  var logger: (
+    message: string | Error,
+    context?: any,
+  ) => OmitThisParameter<(typeof Log)["debug"]>;
 }
 
 export {};

package/lib/Application/ApplicationBuilder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ApplicationBuilder.d.ts","sourceRoot":"","sources":["../../../jcc-express-mvc/lib/Application/ApplicationBuilder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAG/D,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAU3C,qBAAa,kBAAkB;IACtB,GAAG,EAAE,WAAW,CAAC;gBAEZ,GAAG,EAAE,WAAW;IAIrB,UAAU,CAAC,MAAM,EAAE,GAAG;IAKtB,UAAU,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAMtC,WAAW,CAAC,WAAW,EAAE,WAAW,EAAE;IAOtC,aAAa,CAClB,SAAS,EAAE,KAAK,CAAC,KAAK,GAAG,EAAE,WAAW,KAAK,eAAe,CAAC;IA0B7D,OAAO,CAAC,UAAU;IAMlB,OAAO,CAAC,gBAAgB;IAIjB,WAAW;IAKX,cAAc;IAWd,MAAM;CAKd"}
+{"version":3,"file":"ApplicationBuilder.d.ts","sourceRoot":"","sources":["../../../jcc-express-mvc/lib/Application/ApplicationBuilder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAG/D,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAW3C,qBAAa,kBAAkB;IACtB,GAAG,EAAE,WAAW,CAAC;gBAEZ,GAAG,EAAE,WAAW;IAIrB,UAAU,CAAC,MAAM,EAAE,GAAG;IAKtB,UAAU,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAMtC,WAAW,CAAC,WAAW,EAAE,WAAW,EAAE;IAOtC,aAAa,CAClB,SAAS,EAAE,KAAK,CAAC,KAAK,GAAG,EAAE,WAAW,KAAK,eAAe,CAAC;IA2B7D,OAAO,CAAC,UAAU;IAMlB,OAAO,CAAC,gBAAgB;IAIjB,WAAW;IAKX,cAAc;IAWd,MAAM;CAKd"}

package/lib/Application/ApplicationBuilder.js

@@ -9,6 +9,7 @@ const AuthServiceProvider_1 = require("../Providers/AuthServiceProvider");
 const SessionServiceProvider_1 = require("../Providers/SessionServiceProvider");
 const QueueServiceProvider_1 = require("../Queue/QueueServiceProvider");
 const CacheServiceProvider_1 = require("../Providers/CacheServiceProvider");
+const LogServiceProvider_1 = require("../Providers/LogServiceProvider");
 class ApplicationBuilder {
     constructor(app) {
         this.app = app;
@@ -37,6 +38,7 @@ class ApplicationBuilder {
             ]
             : providers;
         const chain = [
+            LogServiceProvider_1.LogServiceProvider,
             DatabaseServiceProvider_1.DatabaseServiceProvider,
             SessionServiceProvider_1.SessionServiceProvider,
             CacheServiceProvider_1.CacheServiceProvider,

package/lib/Command-Line/NodeArtisanCommand.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"NodeArtisanCommand.d.ts","sourceRoot":"","sources":["../../../jcc-express-mvc/lib/Command-Line/NodeArtisanCommand.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAuCpC,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAiB;IACzC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAK1B;IACF,OAAO,CAAC,cAAc,CAA0B;IAChD,OAAO,CAAC,QAAQ,CAAwB;IACxC,OAAO,CAAC,GAAG,CAA0B;IACrC,OAAO,CAAC,KAAK,CAA4B;IACzC,OAAO,CAAC,MAAM,CAA6B;IAC3C,OAAO,CAAC,SAAS,CAAgC;IACjD,OAAO,CAAC,MAAM,CAA6B;IAC3C,OAAO,CAAC,IAAI,CAAc;IAC1B,OAAO,CAAC,MAAM,CAA6B;IAE3C,OAAO,KAAK,OAAO,GAElB;IAED,OAAO,KAAK,EAAE,GAEb;IAED,OAAO,KAAK,IAAI,GAEf;IAED,OAAO,KAAK,KAAK,GAEhB;IAED,OAAO,KAAK,QAAQ,GAEnB;IAED,OAAO,KAAK,KAAK,GAEhB;IAED,OAAO,KAAK,KAAK,GAEhB;IAED,OAAO,CAAC,GAAG;;IAWX,0FAA0F;IAC1F,OAAO,CAAC,kBAAkB;IA0B1B,OAAO,CAAC,aAAa;IAOrB,wFAAwF;IACxF,OAAO,CAAC,SAAS;IAkBjB,OAAO,CAAC,aAAa;IA6MrB,OAAO,CAAC,QAAQ;IA2IhB,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,UAAU,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;CA4BpD"}
+{"version":3,"file":"NodeArtisanCommand.d.ts","sourceRoot":"","sources":["../../../jcc-express-mvc/lib/Command-Line/NodeArtisanCommand.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAwCpC,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAiB;IACzC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAK1B;IACF,OAAO,CAAC,cAAc,CAA0B;IAChD,OAAO,CAAC,QAAQ,CAAwB;IACxC,OAAO,CAAC,GAAG,CAA0B;IACrC,OAAO,CAAC,KAAK,CAA4B;IACzC,OAAO,CAAC,MAAM,CAA6B;IAC3C,OAAO,CAAC,SAAS,CAAgC;IACjD,OAAO,CAAC,MAAM,CAA6B;IAC3C,OAAO,CAAC,IAAI,CAAc;IAC1B,OAAO,CAAC,MAAM,CAA6B;IAE3C,OAAO,KAAK,OAAO,GAElB;IAED,OAAO,KAAK,EAAE,GAEb;IAED,OAAO,KAAK,IAAI,GAEf;IAED,OAAO,KAAK,KAAK,GAEhB;IAED,OAAO,KAAK,QAAQ,GAEnB;IAED,OAAO,KAAK,KAAK,GAEhB;IAED,OAAO,KAAK,KAAK,GAEhB;IAED,OAAO,CAAC,GAAG;;IAWX,0FAA0F;IAC1F,OAAO,CAAC,kBAAkB;IA0B1B,OAAO,CAAC,aAAa;IAOrB,wFAAwF;IACxF,OAAO,CAAC,SAAS;IAkBjB,OAAO,CAAC,aAAa;IA4OrB,OAAO,CAAC,QAAQ;IAmJhB,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,UAAU,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;CA4BpD"}

package/lib/Command-Line/NodeArtisanCommand.js

@@ -23,6 +23,7 @@ const Tinker_1 = require("./NodeTinker/Tinker");
 const WatchCommand_1 = require("./WatchCommand");
 const util_1 = require("../util");
 const CacheCommand_1 = require("./CacheCommand");
+const PublishCommand_1 = require("./PublishCommand");
 /** Parse key=value from secondArg (e.g. steps=2, class=UserSeeder) */
 const parseOption = (secondArg, key) => {
     if (!secondArg?.includes("="))
@@ -190,11 +191,16 @@ class ConsoleKernel {
         }));
         this.defineCommand("db:wipe").action(this.runAction(() => this.db.wipe()));
         // ─── route / queue / tinker / inertia ─────────────────────────────────
-        this.defineCommand("queue:work").action(this.runAction(async (queueName) => {
+        this.defineCommand("queue:work").action(this.runAction(async (queueName, secondArg) => {
+            const rawConcurrency = Number(parseOption(secondArg, "concurrency") ?? 1);
+            const concurrency = Math.min(Math.max(1, rawConcurrency), 5);
             console.log("\n");
             console.log(`${colors_1.default.bgBlue(" INFO ")} Starting the queue worker... \n`);
+            if (concurrency > 1) {
+                console.log(`${colors_1.default.bgBlue(" INFO ")} Running with ${concurrency} concurrent workers \n`);
+            }
             const queue = app.resolve("Queue");
-            await queue.work(queueName || undefined);
+            await queue.work(queueName || undefined, concurrency);
         }, { exit: false }));
         this.defineCommand("route:list").action(this.runAction((firstArg) => {
             const mw = firstArg?.includes("middleware")
@@ -215,6 +221,24 @@ class ConsoleKernel {
             exit: true,
         }));
         //cache
+        // ─── publish ────────────────────────────────────────────────────────
+        this.defineCommand("publish")
+            .description("Publish a framework component (config, providers, routes)")
+            .action(this.runAction((firstArg, secondArg) => {
+            // Support both `publish Monitor` and `publish=Monitor` shorthand
+            // (in which case commander gives us "publish=Monitor" as the cmd
+            // — handled by parsing the first segment).
+            const tag = firstArg.includes("=") ? firstArg.split("=")[1] : firstArg;
+            const force = parseOption(secondArg, "force") === "true" ||
+                secondArg === "--force" ||
+                secondArg === "-f";
+            const cmd = new PublishCommand_1.PublishCommand({ force });
+            if (!tag) {
+                cmd.list();
+                return;
+            }
+            cmd.publish(tag);
+        }));
         // ─── schedule (was missing) ─────────────────────────────────────────
         this.defineCommand("schedule:run").action(this.runAction(() => this.schedule.run(), { exit: false }));
         this.defineCommand("schedule:list").action(this.runAction(() => this.schedule.list()));
@@ -280,6 +304,8 @@ class ConsoleKernel {
         console.log(line("schedule:list", "List all scheduled tasks\n"));
         console.log(section("🌐 Inertia Commands:"));
         console.log(line("inertia:start-ssr", "Start the Inertia.js SSR server\n"));
+        console.log(section("📦 Publish Commands:"));
+        console.log(line("publish [tag] [force=true]", "Publish a framework component (e.g. publish Monitor)\n"));
         if (this.customCommands.length > 0) {
             console.log(section("ℹ️  Custom:"));
             this.customCommands.forEach((c) => console.log(line(c.signature, c.description)));

package/lib/Command-Line/PublishCommand.d.ts

@@ -0,0 +1,13 @@
+export declare class PublishCommand {
+    private opts;
+    constructor(opts?: {
+        force?: boolean;
+    });
+    static availableTags(): string[];
+    list(): void;
+    publish(tag: string): void;
+    private copyFile;
+    private applyInsert;
+    private applyAppend;
+}
+//# sourceMappingURL=PublishCommand.d.ts.map

package/lib/Command-Line/PublishCommand.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PublishCommand.d.ts","sourceRoot":"","sources":["../../../jcc-express-mvc/lib/Command-Line/PublishCommand.ts"],"names":[],"mappings":"AA8OA,qBAAa,cAAc;IACb,OAAO,CAAC,IAAI;gBAAJ,IAAI,GAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAO;IAElD,MAAM,CAAC,aAAa,IAAI,MAAM,EAAE;IAIhC,IAAI,IAAI,IAAI;IAaZ,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAsC1B,OAAO,CAAC,QAAQ;IAehB,OAAO,CAAC,WAAW;IA4BnB,OAAO,CAAC,WAAW;CAkBpB"}

package/lib/Command-Line/PublishCommand.js

@@ -0,0 +1,279 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PublishCommand = void 0;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const colors_1 = __importDefault(require("colors"));
+const app_root_path_1 = __importDefault(require("app-root-path"));
+const MonitorConfigStub_1 = __importDefault(require("./files/MonitorConfigStub"));
+const MonitorRouteStub_1 = __importDefault(require("./files/MonitorRouteStub"));
+const root = app_root_path_1.default.path;
+const rel = (p) => path_1.default.relative(root, p) || p;
+/**
+ * Idempotent file modifier. Logs and returns the new content (or null on
+ * skip). Never throws on already-applied edits.
+ */
+function modify(file, fn) {
+    if (!fs_1.default.existsSync(file))
+        return "missing";
+    const src = fs_1.default.readFileSync(file, "utf8");
+    const next = fn(src);
+    if (next === null)
+        return "skipped";
+    if (next === src)
+        return "skipped";
+    fs_1.default.writeFileSync(file, next, "utf8");
+    return "added";
+}
+/**
+ * Insert `line` after the last existing import, or at the top of the file if
+ * there are no imports yet.
+ */
+function insertImport(source, line) {
+    if (source.includes(line.trim()))
+        return null;
+    const importRe = /^import .+;\s*$/gm;
+    let lastEnd = -1;
+    for (const m of source.matchAll(importRe)) {
+        lastEnd = (m.index ?? 0) + m[0].length;
+    }
+    if (lastEnd === -1)
+        return line + "\n" + source;
+    return source.slice(0, lastEnd) + "\n" + line + source.slice(lastEnd);
+}
+/** Read a framework-bundled Monitor view (Blade) and return it verbatim. */
+function readMonitorView(name) {
+    return () => {
+        const p = path_1.default.join(__dirname, "..", "Monitor", "Views", name);
+        return fs_1.default.readFileSync(p, "utf8");
+    };
+}
+const publishables = {
+    Monitor: {
+        files: [
+            {
+                src: MonitorConfigStub_1.default,
+                dest: path_1.default.join(root, "app", "Config", "monitor.ts"),
+                description: "Monitor config",
+            },
+            {
+                src: MonitorRouteStub_1.default,
+                dest: path_1.default.join(root, "route", "monitor.ts"),
+                description: "Monitor route definitions",
+            },
+            // Page views (each renders one Monitor section under the shared sidebar)
+            ...[
+                "dashboard",
+                "requests",
+                "jobs",
+                "commands",
+                "scheduled",
+                "exceptions",
+                "queries",
+                "notifications",
+                "mail",
+                "cache",
+                "outgoing",
+            ].map((name) => ({
+                src: readMonitorView(`${name}.blade.html`),
+                dest: path_1.default.join(root, "resources", "views", "monitor", `${name}.blade.html`),
+                description: `Monitor ${name} view`,
+            })),
+            // Shared partials (sidebar, top header, empty-state)
+            ...[
+                "sidebar",
+                "top-header",
+                "empty-state",
+            ].map((name) => ({
+                src: readMonitorView(`partials/${name}.blade.html`),
+                dest: path_1.default.join(root, "resources", "views", "partials", "monitor", `${name}.blade.html`),
+                description: `Monitor ${name} partial`,
+            })),
+        ],
+        configInserts: [
+            {
+                file: path_1.default.join(root, "app", "Config", "index.ts"),
+                importLine: `import { monitor } from "./monitor";`,
+                alreadyWiredMarker: /\bmonitor\b\s*[,}\n]/,
+                injector: (src) => {
+                    // 1) Add import.
+                    const withImport = insertImport(src, `import { monitor } from "./monitor";`) ?? src;
+                    // 2) Add `monitor,` inside the exported config object.
+                    //    Find `export const config = {` ... matching `}`.
+                    const startMatch = withImport.match(/export\s+const\s+config\s*=\s*\{/);
+                    if (!startMatch)
+                        return null;
+                    const start = (startMatch.index ?? 0) + startMatch[0].length;
+                    // Find the matching closing brace at depth 0.
+                    let depth = 1;
+                    let i = start;
+                    for (; i < withImport.length; i++) {
+                        const c = withImport[i];
+                        if (c === "{")
+                            depth++;
+                        else if (c === "}") {
+                            depth--;
+                            if (depth === 0)
+                                break;
+                        }
+                    }
+                    if (depth !== 0)
+                        return null;
+                    // Walk back from `}` to find the previous non-whitespace char to
+                    // see if we need a trailing comma before our insert.
+                    let j = i - 1;
+                    while (j > start && /\s/.test(withImport[j]))
+                        j--;
+                    const needsComma = withImport[j] !== "{" && withImport[j] !== ",";
+                    const insertion = `${needsComma ? "," : ""}\n  monitor,\n`;
+                    return (withImport.slice(0, j + 1) +
+                        insertion +
+                        withImport.slice(j + 1).replace(/^\s*/, ""));
+                },
+            },
+        ],
+        appends: [
+            {
+                file: path_1.default.join(root, "route", "web.ts"),
+                line: `require("./monitor");`,
+                presenceMarker: /require\(["']\.\/monitor["']\)/,
+                description: "loaded monitor routes",
+            },
+        ],
+        providerInserts: [
+            {
+                file: path_1.default.join(root, "bootstrap", "providers.ts"),
+                importLine: `import { MonitorServiceProvider } from "jcc-express-mvc/lib/Monitor";`,
+                alreadyWiredMarker: /MonitorServiceProvider/,
+                injector: (src) => {
+                    const withImport = insertImport(src, `import { MonitorServiceProvider } from "jcc-express-mvc/lib/Monitor";`) ?? src;
+                    // Insert `MonitorServiceProvider,` inside `export const providers = [...]`.
+                    const startMatch = withImport.match(/export\s+const\s+providers\s*=\s*\[/);
+                    if (!startMatch)
+                        return null;
+                    const start = (startMatch.index ?? 0) + startMatch[0].length;
+                    let depth = 1;
+                    let i = start;
+                    for (; i < withImport.length; i++) {
+                        const c = withImport[i];
+                        if (c === "[")
+                            depth++;
+                        else if (c === "]") {
+                            depth--;
+                            if (depth === 0)
+                                break;
+                        }
+                    }
+                    if (depth !== 0)
+                        return null;
+                    let j = i - 1;
+                    while (j > start && /\s/.test(withImport[j]))
+                        j--;
+                    const needsComma = withImport[j] !== "[" && withImport[j] !== ",";
+                    const insertion = `${needsComma ? "," : ""}\n  MonitorServiceProvider,\n`;
+                    return (withImport.slice(0, j + 1) +
+                        insertion +
+                        withImport.slice(j + 1).replace(/^\s*/, ""));
+                },
+            },
+        ],
+    },
+};
+class PublishCommand {
+    constructor(opts = {}) {
+        this.opts = opts;
+    }
+    static availableTags() {
+        return Object.keys(publishables);
+    }
+    list() {
+        console.log(colors_1.default.green.bold("\nAvailable publishables:\n"));
+        for (const tag of Object.keys(publishables)) {
+            console.log("  " + colors_1.default.cyan(tag));
+        }
+        console.log();
+        console.log(colors_1.default.gray("Usage: ") +
+            colors_1.default.cyan("bun artisanNode publish <tag> [force=true]"));
+        console.log();
+    }
+    publish(tag) {
+        const spec = publishables[tag];
+        if (!spec) {
+            console.log(colors_1.default.red(`\n❌ Unknown publishable: ${tag}\n`));
+            this.list();
+            return;
+        }
+        console.log(colors_1.default.green.bold(`\n📦 Publishing ${tag}\n`));
+        // 1) Copy stub files.
+        for (const f of spec.files) {
+            this.copyFile(f);
+        }
+        // 2) Wire config.
+        for (const ins of spec.configInserts ?? []) {
+            this.applyInsert(ins, "config");
+        }
+        // 3) Wire providers.
+        for (const ins of spec.providerInserts ?? []) {
+            this.applyInsert(ins, "provider");
+        }
+        // 4) Append require()-style side-effect lines (e.g. route/web.ts).
+        for (const a of spec.appends ?? []) {
+            this.applyAppend(a);
+        }
+        console.log(colors_1.default.green("\n✓ Done.\n"));
+        console.log(colors_1.default.gray("Restart your dev server (") +
+            colors_1.default.cyan("npm run dev") +
+            colors_1.default.gray(") to load the changes.\n"));
+    }
+    copyFile(f) {
+        const exists = fs_1.default.existsSync(f.dest);
+        if (exists && !this.opts.force) {
+            console.log(`  ${colors_1.default.yellow("skip")}    ${rel(f.dest)} (already exists, use force=true to overwrite)`);
+            return;
+        }
+        fs_1.default.mkdirSync(path_1.default.dirname(f.dest), { recursive: true });
+        fs_1.default.writeFileSync(f.dest, f.src(), "utf8");
+        console.log(`  ${colors_1.default.green(exists ? "overwrite" : "create")} ${rel(f.dest)} ${colors_1.default.gray(`— ${f.description}`)}`);
+    }
+    applyInsert(ins, kind) {
+        if (!fs_1.default.existsSync(ins.file)) {
+            console.log(`  ${colors_1.default.red("missing")} ${rel(ins.file)}`);
+            return;
+        }
+        const original = fs_1.default.readFileSync(ins.file, "utf8");
+        const alreadyHasImport = original.includes(ins.importLine.trim());
+        const alreadyWired = ins.alreadyWiredMarker.test(original);
+        if (alreadyHasImport && alreadyWired) {
+            console.log(`  ${colors_1.default.yellow("skip")}    ${rel(ins.file)} (${kind} already registered)`);
+            return;
+        }
+        const result = modify(ins.file, ins.injector);
+        if (result === "added") {
+            console.log(`  ${colors_1.default.green("update")}  ${rel(ins.file)} ${colors_1.default.gray(`— wired ${kind}`)}`);
+        }
+        else if (result === "skipped") {
+            console.log(`  ${colors_1.default.yellow("skip")}    ${rel(ins.file)} (no changes needed)`);
+        }
+        else {
+            console.log(`  ${colors_1.default.red("missing")} ${rel(ins.file)}`);
+        }
+    }
+    applyAppend(a) {
+        if (!fs_1.default.existsSync(a.file)) {
+            console.log(`  ${colors_1.default.red("missing")} ${rel(a.file)}`);
+            return;
+        }
+        const src = fs_1.default.readFileSync(a.file, "utf8");
+        if (a.presenceMarker.test(src)) {
+            console.log(`  ${colors_1.default.yellow("skip")}    ${rel(a.file)} (${a.description} already present)`);
+            return;
+        }
+        const sep = src.endsWith("\n") ? "" : "\n";
+        fs_1.default.writeFileSync(a.file, src + sep + a.line + "\n", "utf8");
+        console.log(`  ${colors_1.default.green("append")}  ${rel(a.file)} ${colors_1.default.gray(`— ${a.description}`)}`);
+    }
+}
+exports.PublishCommand = PublishCommand;

package/lib/Command-Line/files/Controller.js

@@ -16,7 +16,7 @@ const createController = (name) => {
        *@access public
        * @return  Express Request Response
        */
-      async create({ req, res, next } = httpContext)
+      async create({ req, res, next } : httpContext)
       {
           //
       }
@@ -25,7 +25,7 @@ const createController = (name) => {
        * @return  Express Request Response
        */
        @Method()
-      async  index({ req, res, next } = httpContext)
+      async  index({ req, res, next } : httpContext)
       {
           //
       }
@@ -35,7 +35,7 @@ const createController = (name) => {
        *@access public
        * @return Express Request Response
        */
-     async store({ req, res, next } = httpContext)
+     async store({ req, res, next } : httpContext)
       {
           //
       }
@@ -45,7 +45,7 @@ const createController = (name) => {
        *@param {id} - string
        * @return Express Request Response
        */
-     async show({ req, res, next } = httpContext)
+     async show({ req, res, next } : httpContext)
       {
           //
       }
@@ -56,7 +56,7 @@ const createController = (name) => {
        * @param {id} - string
        * @return Express Request Response
        */
-      async update({ req, res, next } = httpContext)
+      async update({ req, res, next } : httpContext)
       {
           //
       }
@@ -66,7 +66,7 @@ const createController = (name) => {
        * @param  {id} - string
        * @return Express Response
        */
-      async destroy({ req, res, next } = httpContext)
+      async destroy({ req, res, next } : httpContext)
       {
          //
       }

package/lib/Command-Line/files/MonitorConfigStub.d.ts

@@ -0,0 +1,3 @@
+declare const monitorConfigStub: () => string;
+export default monitorConfigStub;
+//# sourceMappingURL=MonitorConfigStub.d.ts.map

package/lib/Command-Line/files/MonitorConfigStub.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MonitorConfigStub.d.ts","sourceRoot":"","sources":["../../../../jcc-express-mvc/lib/Command-Line/files/MonitorConfigStub.ts"],"names":[],"mappings":"AAAA,QAAA,MAAM,iBAAiB,QAAO,MAwE7B,CAAC;AAEF,eAAe,iBAAiB,CAAC"}

package/lib/Command-Line/files/MonitorConfigStub.js

@@ -0,0 +1,76 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const monitorConfigStub = () => `import { config } from "jcc-express-mvc";
+import type { MonitorConfig } from "jcc-express-mvc/lib/Monitor";
+
+/**
+ * Monitor configuration. The MonitorServiceProvider is opt-in — add it to
+ * \`bootstrap/providers.ts\` to enable. Until then, this file is a no-op.
+ *
+ * Any field omitted falls back to \`defaultMonitorConfig\` from the framework.
+ */
+export const monitor: Partial<MonitorConfig> = {
+  enabled: config.get("MONITOR_ENABLED", "true") === "true",
+  basePath: config.get("MONITOR_BASE_PATH", "/_monitor"),
+
+  collectors: {
+    http: { enabled: true, sampleRate: 1.0, slowThresholdMs: 1000, ignore: ["/favicon.ico"] },
+    system: { enabled: true, intervalMs: 15_000 },
+    errors: { enabled: true },
+    database: { enabled: false, slowQueryMs: 200 },
+    queue: { enabled: false },
+  },
+
+  exporters: {
+    prometheus: { enabled: true },
+    json: { enabled: true },
+    log: { enabled: false, file: null, level: "info" },
+    push: {
+      enabled: false,
+      url: config.get("MONITOR_PUSH_URL", ""),
+      intervalMs: 30_000,
+      headers: {},
+      format: "json",
+    },
+  },
+
+  healthChecks: {
+    database: { enabled: false, timeoutMs: 2000 },
+    cache: { enabled: false, timeoutMs: 1000 },
+    queue: { enabled: false, timeoutMs: 1000 },
+    disk: { enabled: false, path: ".", warnPercent: 90 },
+    memory: { enabled: true, warnPercent: 85 },
+  },
+
+  buffers: {
+    recentRequests: 200,
+    recentErrors: 100,
+    recentJobs: 100,
+    recentQueries: 100,
+  },
+
+  alerts: {
+    enabled: false,
+    tickIntervalMs: 30_000,
+    notifications: {
+      email: {
+        enabled: config.get("MONITOR_EMAIL_ALERTS", "false") === "true",
+        from: config.get("MONITOR_EMAIL_FROM", "noreply@example.com"),
+        to: config
+          .get("MONITOR_EMAIL_TO", "")
+          .split(",")
+          .map((s: string) => s.trim())
+          .filter(Boolean),
+        throttleMs: 15 * 60 * 1000,
+        severityFloor: "warning",
+      },
+    },
+  },
+
+  dashboard: {
+    enabled: true,
+    guard: null,
+  },
+};
+`;
+exports.default = monitorConfigStub;

package/lib/Command-Line/files/MonitorRouteStub.d.ts

@@ -0,0 +1,3 @@
+declare const monitorRouteStub: () => string;
+export default monitorRouteStub;
+//# sourceMappingURL=MonitorRouteStub.d.ts.map

package/lib/Command-Line/files/MonitorRouteStub.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MonitorRouteStub.d.ts","sourceRoot":"","sources":["../../../../jcc-express-mvc/lib/Command-Line/files/MonitorRouteStub.ts"],"names":[],"mappings":"AAAA,QAAA,MAAM,gBAAgB,QAAO,MAiC5B,CAAC;AAEF,eAAe,gBAAgB,CAAC"}

package/lib/Command-Line/files/MonitorRouteStub.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const monitorRouteStub = () => `import { Route } from "../jcc-express-mvc/Core";
+import { MonitorController } from "../jcc-express-mvc/lib/Monitor/Controllers/MonitorController";
+
+/**
+ * Monitor routes — published from \`bun artisanNode publish Monitor\`.
+ *
+ * Edit freely: change the prefix, attach middleware (auth, IP allowlist),
+ * or swap the controller for your own. The MonitorServiceProvider detects
+ * this file at boot and skips its own auto-mount so routes are not
+ * registered twice.
+ */
+Route.prefix("/_monitor")
+  .controller(MonitorController)
+  .group((Route) => {
+    // API endpoints
+    Route.get("/health", "health");
+    Route.get("/ready", "ready");
+    Route.get("/metrics", "metrics");
+    Route.get("/json", "json");
+
+    // Pages
+    Route.get("/", "dashboard");
+    Route.get("/requests", "requests");
+    Route.get("/jobs", "jobs");
+    Route.get("/commands", "commands");
+    Route.get("/scheduled", "scheduled");
+    Route.get("/exceptions", "exceptions");
+    Route.get("/queries", "queries");
+    Route.get("/notifications", "notifications");
+    Route.get("/mail", "mail");
+    Route.get("/cache", "cache");
+    Route.get("/outgoing", "outgoing");
+  });
+`;
+exports.default = monitorRouteStub;

package/lib/Error/AppErrorHandler.js

@@ -66,7 +66,7 @@ class AppErrorHandler {
                 return res.status(422).redirectBack();
             }
             if (err instanceof MissMatchTokenException_1.MissMatchTokenException) {
-                if (req.expectsJson()) {
+                if (req.expectsJson() && !req.isInertia()) {
                     return res.status(419).json({ error: err.message });
                 }
                 return res.status(419).sendFile(__dirname + "/public/419.html");