catalyst-core 0.2.0-beta.2 → 0.3.0-beta.1

package/dist/scripts/generateOfflineManifest.js

@@ -1 +1,116 @@
-"use strict";const fs=require("fs");const path=require("path");function toRoutePath(basePath,routePath,isIndex){if(isIndex||routePath===undefined||routePath===null||routePath===""){return basePath||"/";}const nextPath=String(routePath).startsWith("/")?routePath:`${basePath}/${routePath}`;return`/${nextPath}`.replace(/\/+/g,"/").replace(/\/$/,"")||"/";}function routeRegex(pattern,exact=false){if(pattern==="*"||pattern==="/*")return"^/.*$";if(pattern==="/")return exact?"^/$":"^/.*$";const parts=pattern.split("/").filter(Boolean);const regex=parts.map(part=>{if(part==="*")return".*";if(part.startsWith(":"))return"[^/]+";return part.replace(/[|\\{}()[\]^$+?.]/g,"\\$&");}).join("/");return exact?`^/${regex}$`:`^/${regex}(?:/.*)?$`;}function collectOfflineRoutes(routes,basePath="",parentOffline=false,result=[]){for(const route of Array.isArray(routes)?routes:[]){if(!route||typeof route!=="object")continue;const offline=Object.prototype.hasOwnProperty.call(route,"offline")?route.offline===true:parentOffline;const isIndexRoute=route.index===true||route.path==="";const pattern=toRoutePath(basePath,route.path,isIndexRoute);const regex=routeRegex(pattern,isIndexRoute);if(offline&&!result.some(item=>item.pattern===pattern&&item.regex===regex)){result.push({pattern,regex});}collectOfflineRoutes(route.children,pattern,offline,result);}return result;}function loadAppRoutes(){require("./loadScriptsBeforeServerStarts.js");const emptyModule=()=>null;[".css",".scss",".sass",".less",".png",".jpg",".jpeg",".gif",".svg",".webp"].forEach(ext=>{require.extensions[ext]=emptyModule;});require("@babel/register")({babelrc:false,extensions:[".js",".jsx",".ts",".tsx"],ignore:[/node_modules/],presets:[["@babel/preset-env",{targets:{node:"current"}}],["@babel/preset-react",{runtime:"automatic"}],["@babel/preset-typescript",{isTSX:true,allExtensions:true}]],plugins:["@loadable/babel-plugin"]});const{getRoutes}=require(path.join(process.env.src_path,"src/js/routes/utils.js"));return typeof getRoutes==="function"?getRoutes():[];}function copyIfExists(source,destination){if(fs.existsSync(source))fs.copyFileSync(source,destination);}function main(){const appConfig=require(path.join(process.env.src_path,"config/config.json"));const publicDir=path.join(process.env.src_path,process.env.BUILD_OUTPUT_PATH||appConfig.BUILD_OUTPUT_PATH,"public");const routes=collectOfflineRoutes(loadAppRoutes());fs.mkdirSync(publicDir,{recursive:true});fs.writeFileSync(path.join(publicDir,"catalyst-offline-manifest.json"),`${JSON.stringify({schemaVersion:1,buildId:Date.now().toString(36),routes},null,2)}\n`);copyIfExists(path.join(process.env.src_path,"public/offline.html"),path.join(publicDir,"offline.html"));fs.copyFileSync(path.join(__dirname,"../offline/catalyst-sw.js"),path.join(publicDir,"catalyst-sw.js"));console.log(`Catalyst offline manifest generated: ${routes.length} route(s)`);}main();
+import fs from "fs"
+import path from "path"
+import { createServer as createViteServer } from "vite"
+import { fileURLToPath } from "url"
+
+const __filename = fileURLToPath(import.meta.url)
+const __dirname = path.dirname(__filename)
+
+function toRoutePath(basePath, routePath, isIndex) {
+    if (isIndex || routePath === undefined || routePath === null || routePath === "") {
+        return basePath || "/"
+    }
+
+    const nextPath = String(routePath).startsWith("/") ? routePath : `${basePath}/${routePath}`
+    return `/${nextPath}`.replace(/\/+/g, "/").replace(/\/$/, "") || "/"
+}
+
+function routeRegex(pattern, exact = false) {
+    if (pattern === "*" || pattern === "/*") return "^/.*$"
+    if (pattern === "/") return exact ? "^/$" : "^/.*$"
+
+    const parts = pattern.split("/").filter(Boolean)
+    const regex = parts
+        .map((part) => {
+            if (part === "*") return ".*"
+            if (part.startsWith(":")) return "[^/]+"
+            return part.replace(/[|\\{}()[\]^$+?.]/g, "\\$&")
+        })
+        .join("/")
+
+    return exact ? `^/${regex}$` : `^/${regex}(?:/.*)?$`
+}
+
+export function collectOfflineRoutes(routes, basePath = "", parentOffline = false, result = []) {
+    for (const route of Array.isArray(routes) ? routes : []) {
+        if (!route || typeof route !== "object") continue
+
+        const offline = Object.prototype.hasOwnProperty.call(route, "offline")
+            ? route.offline === true
+            : parentOffline
+        const isIndexRoute = route.index === true || route.path === ""
+        const pattern = toRoutePath(basePath, route.path, isIndexRoute)
+        const regex = routeRegex(pattern, isIndexRoute)
+
+        if (offline && !result.some((item) => item.pattern === pattern && item.regex === regex)) {
+            result.push({ pattern, regex })
+        }
+
+        collectOfflineRoutes(route.children, pattern, offline, result)
+    }
+
+    return result
+}
+
+async function loadAppRoutes(appRoot) {
+    const vite = await createViteServer({
+        configFile: path.resolve(__dirname, "../vite/vite.config.js"),
+        root: appRoot,
+        appType: "custom",
+        logLevel: "error",
+        server: {
+            middlewareMode: true,
+            hmr: false,
+        },
+        optimizeDeps: {
+            noDiscovery: true,
+        },
+    })
+
+    try {
+        const routesModule = await vite.ssrLoadModule(path.join(appRoot, "src/js/routes/utils.js"))
+        return typeof routesModule.getRoutes === "function" ? routesModule.getRoutes() : []
+    } finally {
+        await vite.close()
+    }
+}
+
+function copyIfExists(source, destination) {
+    if (fs.existsSync(source)) fs.copyFileSync(source, destination)
+}
+
+export async function generateOfflineManifest() {
+    const appRoot = process.env.src_path
+    const appConfig = JSON.parse(fs.readFileSync(path.join(appRoot, "config/config.json"), "utf8"))
+    const buildDir = path.join(
+        appRoot,
+        process.env.BUILD_OUTPUT_PATH || appConfig.BUILD_OUTPUT_PATH || "build"
+    )
+    const routes = collectOfflineRoutes(await loadAppRoutes(appRoot))
+
+    fs.mkdirSync(buildDir, { recursive: true })
+    fs.writeFileSync(
+        path.join(buildDir, "catalyst-offline-manifest.json"),
+        `${JSON.stringify(
+            {
+                schemaVersion: 1,
+                buildId: Date.now().toString(36),
+                routes,
+            },
+            null,
+            2
+        )}\n`
+    )
+
+    copyIfExists(path.join(appRoot, "public/offline.html"), path.join(buildDir, "offline.html"))
+    fs.copyFileSync(path.join(__dirname, "../offline/catalyst-sw.js"), path.join(buildDir, "catalyst-sw.js"))
+
+    console.log(`Catalyst offline manifest generated: ${routes.length} route(s)`)
+}
+
+if (process.argv[1] && path.resolve(process.argv[1]) === __filename) {
+    generateOfflineManifest().catch((error) => {
+        console.error("Failed to generate Catalyst offline manifest:", error)
+        process.exit(1)
+    })
+}

package/dist/scripts/loadEnvironmentVariables.js

@@ -1,7 +1,33 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.default=void 0;const appConfig=require("@catalyst/template/config/config.json");const{validateConfigFile}=require("@catalyst/scripts/validator.js");/**
+import path from "path"
+import fs from "fs"
+
+const appConfigPath = path.resolve(process.env.src_path, "config/config.json")
+// import { validateConfigFile } from "../scripts/validator"
+/**
  * @description stores all config.json key value into process.env before server starts.
- */const loadEnvironmentVariables=()=>{if(validateConfigFile(appConfig)){for(let k in appConfig){// below code provides support for object handling present in config.
-// However, for usage on client the client logic in define plugin needs to be checked and updated
-process.env[k]=typeof appConfig[k]==="object"?JSON.stringify(appConfig[k]):appConfig[k];}}// Load Sentry configuration if it exists
-try{const sentryConfig=require("@catalyst/template/config/sentry.config.json");process.env.SENTRY_CONFIG=JSON.stringify(sentryConfig);}catch(error){// Sentry config is optional
-}};var _default=exports.default=loadEnvironmentVariables;
+ */
+const loadEnvironmentVariables = async () => {
+    try {
+        const filterKeys = JSON.parse(process.env.filterKeys)
+        const configContent = fs.readFileSync(appConfigPath, "utf8")
+        const appConfig = JSON.parse(configContent)
+        const newConfig = {}
+        // Set environment variables from config
+        for (let k in appConfig) {
+            // Handle both primitive values and objects
+            newConfig[k] = typeof appConfig[k] === "object" ? JSON.stringify(appConfig[k]) : appConfig[k]
+        }
+        for (let i = 0; i < filterKeys.length; i++) {
+            const key = filterKeys[i]
+            // Handle both primitive values and objects
+            newConfig[key] =
+                typeof process.env[key] === "object" ? JSON.stringify(process.env[key]) : process.env[key]
+        }
+        process.env = newConfig
+    } catch (error) {
+        console.error("Error loading environment variables:", error)
+        throw error
+    }
+}
+
+export default loadEnvironmentVariables

package/dist/scripts/plugins.js

@@ -1 +1,309 @@
-"use strict";const fs=require("fs");const path=require("path");const readline=require("node:readline");const{bold,cyan,dim,green,red,yellow}=require("picocolors");const{discoverInternalPlugins,resolveInternalPluginsRoot}=require("../native/internalPluginUtils.js");const CONFIG_PATH=path.join(process.cwd(),"config","config.json");const TICK="x";function detectIndent(rawConfig){const indentMatch=rawConfig.match(/\n([ \t]+)"/);return indentMatch?indentMatch[1]:"    ";}function readJsonFile(filePath,label){if(!fs.existsSync(filePath)){throw new Error(`${label} not found at ${filePath}`);}const raw=fs.readFileSync(filePath,"utf8");try{return{raw,json:JSON.parse(raw)};}catch(error){throw new Error(`Invalid JSON in ${filePath}: ${error.message}`);}}function ensureObject(value,label){if(value==null){return{};}if(typeof value!=="object"||Array.isArray(value)){throw new Error(`${label} must be an object`);}return value;}function splitPluginConfig(pluginConfig,plugins){const selectorToPlugin=new Map();const matchesByConfigKey=new Map();const staleToggleKeys=[];plugins.forEach(plugin=>{selectorToPlugin.set(plugin.configKey,plugin);selectorToPlugin.set(plugin.id,plugin);});for(const[key,value]of Object.entries(pluginConfig)){if(typeof value!=="boolean"){throw new Error(`WEBVIEW_CONFIG.plugins.${key} must be boolean`);}const plugin=selectorToPlugin.get(key);if(!plugin){staleToggleKeys.push(key);continue;}const matches=matchesByConfigKey.get(plugin.configKey)||[];matches.push({key,value,plugin});matchesByConfigKey.set(plugin.configKey,matches);}const knownToggles={};for(const plugin of plugins){const matches=matchesByConfigKey.get(plugin.configKey)||[];const uniqueValues=[...new Set(matches.map(entry=>entry.value))];if(uniqueValues.length>1){throw new Error(`Conflicting toggle values for plugin '${plugin.id}' across keys: ${matches.map(entry=>`${entry.key}=${entry.value}`).join(", ")}`);}if(matches.length>0){knownToggles[plugin.configKey]=matches[0].value;}}return{knownToggles,staleToggleKeys};}function createSession({configPath,rawConfig,config,plugins,pluginsRoot}){const webviewConfig=config.WEBVIEW_CONFIG==null?{}:ensureObject(config.WEBVIEW_CONFIG,"WEBVIEW_CONFIG");const pluginConfig=ensureObject(webviewConfig.plugins,"WEBVIEW_CONFIG.plugins");const{knownToggles,staleToggleKeys}=splitPluginConfig(pluginConfig,plugins);return{configPath,config,indent:detectIndent(rawConfig),pluginsRoot,plugins:plugins.map(plugin=>({...plugin,enabled:knownToggles[plugin.configKey]??false})),staleToggleKeys,notice:"",selectedIndex:0};}function buildPersistedPluginConfig(session){const nextConfig={};for(const plugin of session.plugins){nextConfig[plugin.configKey]=plugin.enabled;}return nextConfig;}function renderSession(session){if(typeof console.clear==="function"){console.clear();}console.log(bold("Catalyst Internal Plugins"));console.log(dim(`Config: ${session.configPath}`));console.log(dim(`Catalog: ${session.pluginsRoot}`));console.log("");if(session.staleToggleKeys.length>0){console.log(yellow(`Stale plugin toggle keys will be removed on save: ${session.staleToggleKeys.join(", ")}`));console.log("");}session.plugins.forEach((plugin,index)=>{const isSelected=index===session.selectedIndex;const pointer=isSelected?cyan(">"):" ";const checkbox=plugin.enabled?green(`[${TICK}]`):dim("[ ]");const title=isSelected?bold(plugin.displayName):plugin.displayName;const meta=dim(`(${plugin.configKey})`);console.log(`${pointer} ${checkbox} ${title} ${meta}`);console.log(`    ${plugin.description}`);console.log(dim(`    category: ${plugin.category} | platforms: ${plugin.platforms.join(", ")}`));console.log(dim(`    id: ${plugin.id}`));console.log("");});console.log("Controls: up/down move, space or enter toggle, a enable all, n disable all, s save, q quit");if(session.notice){console.log("");console.log(session.notice);}}function saveSession(session){if(session.config.WEBVIEW_CONFIG==null){session.config.WEBVIEW_CONFIG={};}session.config.WEBVIEW_CONFIG.plugins=buildPersistedPluginConfig(session);fs.writeFileSync(session.configPath,`${JSON.stringify(session.config,null,session.indent)}\n`);}async function runInteractiveSession(session){if(!process.stdin.isTTY||!process.stdout.isTTY){renderSession(session);console.log("");console.log(yellow("Interactive mode requires a TTY. Re-run this command in a terminal session."));return;}const rl=readline.createInterface({input:process.stdin,output:process.stdout});readline.emitKeypressEvents(process.stdin,rl);if(typeof process.stdin.setRawMode==="function"){process.stdin.setRawMode(true);}try{renderSession(session);await new Promise(resolve=>{const finish=()=>{process.stdin.off("keypress",onKeypress);resolve();};const onKeypress=(_,key={})=>{if(key.ctrl&&key.name==="c"){session.notice=yellow("Exited without saving.");renderSession(session);finish();return;}if(key.name==="up"){session.selectedIndex=session.selectedIndex===0?session.plugins.length-1:session.selectedIndex-1;session.notice="";renderSession(session);return;}if(key.name==="down"){session.selectedIndex=session.selectedIndex===session.plugins.length-1?0:session.selectedIndex+1;session.notice="";renderSession(session);return;}if(key.name==="space"||key.name==="return"){const plugin=session.plugins[session.selectedIndex];plugin.enabled=!plugin.enabled;session.notice=green(`${plugin.displayName} is now ${plugin.enabled?"enabled":"disabled"} in the pending config.`);renderSession(session);return;}if(key.name==="a"){session.plugins.forEach(plugin=>{plugin.enabled=true;});session.notice=green("Enabled all discovered plugins.");renderSession(session);return;}if(key.name==="n"){session.plugins.forEach(plugin=>{plugin.enabled=false;});session.notice=yellow("Disabled all discovered plugins.");renderSession(session);return;}if(key.name==="s"){saveSession(session);session.notice=session.staleToggleKeys.length>0?green(`Saved plugin toggles to config/config.json and removed stale keys: ${session.staleToggleKeys.join(", ")}.`):green("Saved plugin toggles to config/config.json.");renderSession(session);finish();return;}if(key.name==="q"){session.notice=yellow("Exited without saving.");renderSession(session);finish();return;}session.notice=red(`Unsupported key: ${key.name||"unknown"}`);renderSession(session);};process.stdin.on("keypress",onKeypress);});}finally{if(typeof process.stdin.setRawMode==="function"){process.stdin.setRawMode(false);}rl.close();}}async function main(){const{raw:rawConfig,json:config}=readJsonFile(CONFIG_PATH,"App config");const catalystCoreRoot=path.dirname(require.resolve("catalyst-core/package.json"));const pluginsRoot=resolveInternalPluginsRoot(catalystCoreRoot);const plugins=discoverInternalPlugins(pluginsRoot);if(plugins.length===0){console.log(yellow(`No internal plugins were discovered at ${pluginsRoot}`));return;}const session=createSession({configPath:CONFIG_PATH,rawConfig,config,plugins,pluginsRoot});await runInteractiveSession(session);}main().catch(error=>{console.error(red(`Plugin manager failed: ${error.message}`));process.exit(1);});
+import fs from "node:fs"
+import path from "node:path"
+import readline from "node:readline"
+import { createRequire } from "node:module"
+import { fileURLToPath } from "node:url"
+import { bold, cyan, dim, green, red, yellow } from "picocolors"
+
+const require = createRequire(import.meta.url)
+const { discoverInternalPlugins, resolveInternalPluginsRoot } = require("../native/internalPluginUtils.js")
+
+const CONFIG_PATH = path.join(process.cwd(), "config", "config.json")
+const TICK = "x"
+
+function detectIndent(rawConfig) {
+    const indentMatch = rawConfig.match(/\n([ \t]+)"/)
+    return indentMatch ? indentMatch[1] : "    "
+}
+
+function readJsonFile(filePath, label) {
+    if (!fs.existsSync(filePath)) {
+        throw new Error(`${label} not found at ${filePath}`)
+    }
+
+    const raw = fs.readFileSync(filePath, "utf8")
+
+    try {
+        return {
+            raw,
+            json: JSON.parse(raw),
+        }
+    } catch (error) {
+        throw new Error(`Invalid JSON in ${filePath}: ${error.message}`)
+    }
+}
+
+function ensureObject(value, label) {
+    if (value == null) {
+        return {}
+    }
+
+    if (typeof value !== "object" || Array.isArray(value)) {
+        throw new Error(`${label} must be an object`)
+    }
+
+    return value
+}
+
+function splitPluginConfig(pluginConfig, plugins) {
+    const selectorToPlugin = new Map()
+    const matchesByConfigKey = new Map()
+    const staleToggleKeys = []
+
+    plugins.forEach((plugin) => {
+        selectorToPlugin.set(plugin.configKey, plugin)
+        selectorToPlugin.set(plugin.id, plugin)
+    })
+
+    for (const [key, value] of Object.entries(pluginConfig)) {
+        if (typeof value !== "boolean") {
+            throw new Error(`WEBVIEW_CONFIG.plugins.${key} must be boolean`)
+        }
+
+        const plugin = selectorToPlugin.get(key)
+        if (!plugin) {
+            staleToggleKeys.push(key)
+            continue
+        }
+
+        const matches = matchesByConfigKey.get(plugin.configKey) || []
+        matches.push({ key, value, plugin })
+        matchesByConfigKey.set(plugin.configKey, matches)
+    }
+
+    const knownToggles = {}
+    for (const plugin of plugins) {
+        const matches = matchesByConfigKey.get(plugin.configKey) || []
+        const uniqueValues = [...new Set(matches.map((entry) => entry.value))]
+        if (uniqueValues.length > 1) {
+            throw new Error(
+                `Conflicting toggle values for plugin '${plugin.id}' across keys: ${matches
+                    .map((entry) => `${entry.key}=${entry.value}`)
+                    .join(", ")}`
+            )
+        }
+        if (matches.length > 0) {
+            knownToggles[plugin.configKey] = matches[0].value
+        }
+    }
+
+    return { knownToggles, staleToggleKeys }
+}
+
+function createSession({ configPath, rawConfig, config, plugins, pluginsRoot }) {
+    const webviewConfig =
+        config.WEBVIEW_CONFIG == null ? {} : ensureObject(config.WEBVIEW_CONFIG, "WEBVIEW_CONFIG")
+    const pluginConfig = ensureObject(webviewConfig.plugins, "WEBVIEW_CONFIG.plugins")
+    const { knownToggles, staleToggleKeys } = splitPluginConfig(pluginConfig, plugins)
+
+    return {
+        configPath,
+        config,
+        indent: detectIndent(rawConfig),
+        pluginsRoot,
+        plugins: plugins.map((plugin) => ({
+            ...plugin,
+            enabled: knownToggles[plugin.configKey] ?? false,
+        })),
+        staleToggleKeys,
+        notice: "",
+        selectedIndex: 0,
+    }
+}
+
+function buildPersistedPluginConfig(session) {
+    const nextConfig = {}
+
+    for (const plugin of session.plugins) {
+        nextConfig[plugin.configKey] = plugin.enabled
+    }
+
+    return nextConfig
+}
+
+function renderSession(session) {
+    if (typeof console.clear === "function") {
+        console.clear()
+    }
+
+    console.log(bold("Catalyst Internal Plugins"))
+    console.log(dim(`Config: ${session.configPath}`))
+    console.log(dim(`Catalog: ${session.pluginsRoot}`))
+    console.log("")
+
+    if (session.staleToggleKeys.length > 0) {
+        console.log(
+            yellow(`Stale plugin toggle keys will be removed on save: ${session.staleToggleKeys.join(", ")}`)
+        )
+        console.log("")
+    }
+
+    session.plugins.forEach((plugin, index) => {
+        const isSelected = index === session.selectedIndex
+        const pointer = isSelected ? cyan(">") : " "
+        const checkbox = plugin.enabled ? green(`[${TICK}]`) : dim("[ ]")
+        const title = isSelected ? bold(plugin.displayName) : plugin.displayName
+        const meta = dim(`(${plugin.configKey})`)
+
+        console.log(`${pointer} ${checkbox} ${title} ${meta}`)
+        console.log(`    ${plugin.description}`)
+        console.log(dim(`    category: ${plugin.category} | platforms: ${plugin.platforms.join(", ")}`))
+        console.log(dim(`    id: ${plugin.id}`))
+        console.log("")
+    })
+
+    console.log("Controls: up/down move, space or enter toggle, a enable all, n disable all, s save, q quit")
+    if (session.notice) {
+        console.log("")
+        console.log(session.notice)
+    }
+}
+
+function saveSession(session) {
+    if (session.config.WEBVIEW_CONFIG == null) {
+        session.config.WEBVIEW_CONFIG = {}
+    }
+
+    session.config.WEBVIEW_CONFIG.plugins = buildPersistedPluginConfig(session)
+    fs.writeFileSync(session.configPath, `${JSON.stringify(session.config, null, session.indent)}\n`)
+}
+
+async function runInteractiveSession(session) {
+    if (!process.stdin.isTTY || !process.stdout.isTTY) {
+        renderSession(session)
+        console.log("")
+        console.log(yellow("Interactive mode requires a TTY. Re-run this command in a terminal session."))
+        return
+    }
+
+    const rl = readline.createInterface({
+        input: process.stdin,
+        output: process.stdout,
+    })
+
+    readline.emitKeypressEvents(process.stdin, rl)
+    if (typeof process.stdin.setRawMode === "function") {
+        process.stdin.setRawMode(true)
+    }
+
+    try {
+        renderSession(session)
+
+        await new Promise((resolve) => {
+            const finish = () => {
+                process.stdin.off("keypress", onKeypress)
+                resolve()
+            }
+
+            const onKeypress = (_, key = {}) => {
+                if (key.ctrl && key.name === "c") {
+                    session.notice = yellow("Exited without saving.")
+                    renderSession(session)
+                    finish()
+                    return
+                }
+
+                if (key.name === "up") {
+                    session.selectedIndex =
+                        session.selectedIndex === 0 ? session.plugins.length - 1 : session.selectedIndex - 1
+                    session.notice = ""
+                    renderSession(session)
+                    return
+                }
+
+                if (key.name === "down") {
+                    session.selectedIndex =
+                        session.selectedIndex === session.plugins.length - 1 ? 0 : session.selectedIndex + 1
+                    session.notice = ""
+                    renderSession(session)
+                    return
+                }
+
+                if (key.name === "space" || key.name === "return") {
+                    const plugin = session.plugins[session.selectedIndex]
+                    plugin.enabled = !plugin.enabled
+                    session.notice = green(
+                        `${plugin.displayName} is now ${plugin.enabled ? "enabled" : "disabled"} in the pending config.`
+                    )
+                    renderSession(session)
+                    return
+                }
+
+                if (key.name === "a") {
+                    session.plugins.forEach((plugin) => {
+                        plugin.enabled = true
+                    })
+                    session.notice = green("Enabled all discovered plugins.")
+                    renderSession(session)
+                    return
+                }
+
+                if (key.name === "n") {
+                    session.plugins.forEach((plugin) => {
+                        plugin.enabled = false
+                    })
+                    session.notice = yellow("Disabled all discovered plugins.")
+                    renderSession(session)
+                    return
+                }
+
+                if (key.name === "s") {
+                    saveSession(session)
+                    session.notice =
+                        session.staleToggleKeys.length > 0
+                            ? green(
+                                  `Saved plugin toggles to config/config.json and removed stale keys: ${session.staleToggleKeys.join(", ")}.`
+                              )
+                            : green("Saved plugin toggles to config/config.json.")
+                    renderSession(session)
+                    finish()
+                    return
+                }
+
+                if (key.name === "q") {
+                    session.notice = yellow("Exited without saving.")
+                    renderSession(session)
+                    finish()
+                    return
+                }
+
+                session.notice = red(`Unsupported key: ${key.name || "unknown"}`)
+                renderSession(session)
+            }
+
+            process.stdin.on("keypress", onKeypress)
+        })
+    } finally {
+        if (typeof process.stdin.setRawMode === "function") {
+            process.stdin.setRawMode(false)
+        }
+        rl.close()
+    }
+}
+
+async function main() {
+    const { raw: rawConfig, json: config } = readJsonFile(CONFIG_PATH, "App config")
+    const catalystCoreRoot = fileURLToPath(new URL("../..", import.meta.url))
+    const pluginsRoot = resolveInternalPluginsRoot(catalystCoreRoot)
+    const plugins = discoverInternalPlugins(pluginsRoot)
+
+    if (plugins.length === 0) {
+        console.log(yellow(`No internal plugins were discovered at ${pluginsRoot}`))
+        return
+    }
+
+    const session = createSession({
+        configPath: CONFIG_PATH,
+        rawConfig,
+        config,
+        plugins,
+        pluginsRoot,
+    })
+
+    await runInteractiveSession(session)
+}
+
+main().catch((error) => {
+    console.error(red(`Plugin manager failed: ${error.message}`))
+    process.exit(1)
+})

package/dist/scripts/preServerInit.js

@@ -0,0 +1,13 @@
+import path from "path"
+import loadEnvironmentVariables from "./loadEnvironmentVariables.js"
+import { safeCall } from "../server/utils/validator.js"
+
+let preServerInit
+try {
+    const hooks = await import(path.join(process.env.src_path, "server/index.js"))
+    preServerInit = hooks.preServerInit
+} catch {
+    // No hooks file — preServerInit remains undefined
+}
+await loadEnvironmentVariables()
+safeCall(preServerInit)

package/dist/scripts/scriptUtils.js

@@ -1,3 +1,54 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.arrayToObject=arrayToObject;exports.runBuildCommands=exports.printBundleInformation=void 0;const fs=require("fs");const path=require("path");const util=require("node:util");const{spawnSync}=require("child_process");const{gray,cyan}=require("picocolors");const{BUILD_OUTPUT_PATH}=require(`${process.cwd()}/config/config.json`);// Function to get file size synchronously
-function getFileSizeSync(filePath){try{const stats=fs.statSync(filePath);return stats.size;}catch(err){console.error(`Error getting bundle information for file ${filePath}: ${err}`);return null;}}const printBundleInformation=()=>{let bundleList=[];const directoryPath=path.join(process.cwd(),`${BUILD_OUTPUT_PATH}/public`);try{const files=fs.readdirSync(directoryPath);files.forEach(file=>{if(!file.includes("txt")&&!file.includes("json")){const filePath=`${directoryPath}${path.sep}${file}`;const fileSize=getFileSizeSync(filePath);if(fileSize!==null){bundleList.push({file,fileSize});}}});}catch(err){console.error("Unable to scan build folder: "+err);}bundleList.sort((a,b)=>b.fileSize-a.fileSize);bundleList.forEach(({file,fileSize})=>{const fileName=`${gray(`${BUILD_OUTPUT_PATH}/public/`)}${cyan(file)}`;const fileSizeInKb=(fileSize/1024).toFixed(2);const size=`\t${fileSizeInKb} kB`.padEnd(16);console.log(util.format(size,fileName));});};exports.printBundleInformation=printBundleInformation;function arrayToObject(array){const obj={};array.forEach(item=>{const[key,value]=item.split("=");if(value)obj[key]=value;});return obj;}const BUILD_FAILURE_MESSAGE="\nBuild Failed!";function shouldFailBuild(result){return result.error||result.signal||result.status!==null&&result.status!==0;}function logBuildFailure(result,failureMessage=BUILD_FAILURE_MESSAGE){console.error(failureMessage);if(result.error){console.error(`Error: ${result.error?.message||result.error}\n`);}if(result.signal){console.error(`Signal: ${result.signal}\n`);}if(result.status!==null){console.error(`Exit code: ${result.status}\n`);}}const runBuildCommands=({commands,cwd,env,failureMessage=BUILD_FAILURE_MESSAGE})=>{const command=commands.join(" && ");// nosemgrep
-const result=spawnSync(command,[],{cwd,stdio:"inherit",shell:true,env});if(shouldFailBuild(result)){logBuildFailure(result,failureMessage);process.exit(result.status||1);}return result;};exports.runBuildCommands=runBuildCommands;
+import fs from "fs"
+import path from "path"
+import util from "node:util"
+import pkg from "picocolors"
+const { gray, cyan } = pkg
+
+// Function to get file size synchronously
+function getFileSizeSync(filePath) {
+    try {
+        const stats = fs.statSync(filePath)
+        return stats.size
+    } catch (err) {
+        console.error(`Error getting bundle information for file ${filePath}: ${err}`)
+        return null
+    }
+}
+
+export const printBundleInformation = () => {
+    let bundleList = []
+    const directoryPath = path.join(process.env.src_path, `build/public`)
+
+    try {
+        const files = fs.readdirSync(directoryPath)
+        files.forEach((file) => {
+            if (!file.includes("txt") && !file.includes("json")) {
+                const filePath = path.join(directoryPath, file)
+                const fileSize = getFileSizeSync(filePath)
+                if (fileSize !== null) {
+                    bundleList.push({ file, fileSize })
+                }
+            }
+        })
+    } catch (err) {
+        console.error("Unable to scan build folder: " + err)
+    }
+
+    bundleList.sort((a, b) => b.fileSize - a.fileSize)
+    bundleList.forEach(({ file, fileSize }) => {
+        const fileName = `${gray(`build/public/`)}${cyan(file)}`
+        const fileSizeInKb = (fileSize / 1024).toFixed(2)
+        const size = `\t${fileSizeInKb} kB`.padEnd(16)
+
+        console.log(util.format(size, fileName))
+    })
+}
+
+export function arrayToObject(array) {
+    const obj = {}
+    array.forEach((item) => {
+        const [key, value] = item.split("=")
+        if (value) obj[key] = value
+    })
+    return obj
+}

package/dist/scripts/serve.js

@@ -1,4 +1,51 @@
-"use strict";const path=require("path");const{spawnSync}=require("child_process");const{arrayToObject}=require("./scriptUtils");const{name}=require(`${process.cwd()}/package.json`);const{BUILD_OUTPUT_PATH}=require(`${process.cwd()}/config/config.json`);/**
- * @description -  Serves production build of the application.
- */function serve(){const commandLineArguments=process.argv.slice(2);const argumentsObject=arrayToObject(commandLineArguments);const dirname=path.resolve(__dirname,"../../");// nosemgrep: javascript.lang.security.audit.spawn-shell-true.spawn-shell-true - Production serve keeps shell execution for existing script compatibility.
-spawnSync("node",["-r","./dist/scripts/loadScriptsBeforeServerStarts.js",path.join(process.cwd(),BUILD_OUTPUT_PATH,"startServer.js")],{cwd:dirname,stdio:"inherit",shell:true,env:{...process.env,src_path:process.cwd(),BUILD_OUTPUT_PATH:BUILD_OUTPUT_PATH,NODE_ENV:"production",IS_DEV_COMMAND:false,APPLICATION:name||"catalyst_app",...argumentsObject}});}serve();
+import path from "path"
+import { spawnSync } from "child_process"
+import { arrayToObject } from "./scriptUtils.js"
+import { fileURLToPath } from "url"
+import { dirname } from "path"
+import { readFileSync } from "fs"
+
+const __filename = fileURLToPath(import.meta.url)
+const __dirname = dirname(__filename)
+const loaderPath = path.resolve(__dirname, "../../dist/vite/node-loader.mjs")
+const preInitPath = path.resolve(__dirname, "preServerInit.js")
+
+/**
+ * @description - starts the application in production mode
+ */
+function startProd() {
+    const commandLineArguments = process.argv.slice(2)
+    const argumentsObject = arrayToObject(commandLineArguments)
+    const dirname = path.resolve(__dirname, "../../")
+
+    // Read package.json
+    const packageJson = JSON.parse(readFileSync(path.join(process.env.PWD, "package.json"), "utf-8"))
+    const { name } = packageJson
+
+    console.log("🚀 Starting production server...")
+
+    const inspectFlag = commandLineArguments.includes("--inspect") ? "--inspect" : ""
+    const command = `node ${inspectFlag} --import ${preInitPath} --loader ${loaderPath} ./dist/server/expressServer.js`
+    spawnSync(command, [], {
+        cwd: dirname,
+        stdio: "inherit",
+        shell: true,
+        env: {
+            ...process.env,
+            src_path: process.env.PWD,
+            NODE_ENV: "production",
+            IS_DEV_COMMAND: false,
+            APPLICATION: name || "catalyst_app",
+            ...argumentsObject,
+            filterKeys: JSON.stringify([
+                "src_path",
+                "NODE_ENV",
+                "IS_DEV_COMMAND",
+                "APPLICATION",
+                ...Object.keys(argumentsObject),
+            ]),
+        },
+    })
+}
+
+startProd()