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

package/mcp_v2/tools/conversion.js

@@ -1,7 +1,12 @@
 "use strict"
 const fs = require("fs")
 const path = require("path")
-const { makeProjectHelpers, versionOlderThan } = require("../lib/helpers")
+const {
+    makeProjectHelpers,
+    versionOlderThan,
+    catalystGeneration,
+    VITE_RUNTIME_VERSION,
+} = require("../lib/helpers")
 
 // Tasks that require a minimum catalyst-core version.
 // Key = task ID, value = { minVersion, reason, upgradeNote }
@@ -35,6 +40,7 @@ function handle_get_conversion_status({ project_path, include_not_applicable = f
 
     // ── Version gate: read installed catalyst-core version ────────────────────
     const installedVersion = _projectInfo.installedVersion || null
+    const generation = catalystGeneration(installedVersion)
 
     // ── Load project state once ────────────────────────────────────────────────
     const config = readJson("config/config.json")
@@ -78,14 +84,36 @@ function handle_get_conversion_status({ project_path, include_not_applicable = f
         },
 
         T2_ROUTER_DEP: () => {
-            if (!allDeps["@tata1mg/router"])
+            if (generation === "unknown")
+                return {
+                    status: "needs_review",
+                    native_risk: "Router ownership differs between Catalyst 0.2.x and 0.3.x.",
+                    reason: `Unable to determine the installed catalyst-core version. Confirm whether the target is legacy 0.2.x or current ${VITE_RUNTIME_VERSION}+ before changing router dependencies.`,
+                    review_context: {
+                        question: "Which catalyst-core version is this project targeting?",
+                        what_correct_looks_like:
+                            "0.2.x uses @tata1mg/router; 0.3.x+ removes it and imports Catalyst router APIs from catalyst-core.",
+                        what_gap_looks_like:
+                            "Router dependencies and imports are mixed across runtime generations.",
+                    },
+                }
+            if (generation === "legacy") {
+                if (!allDeps["@tata1mg/router"])
+                    return {
+                        status: "gap",
+                        native_risk: "Catalyst 0.2.x requires its external router package for SSR routing.",
+                        reason: "Legacy Catalyst detected but @tata1mg/router is missing",
+                    }
+                return { status: "completed", note: "Legacy 0.2.x external router dependency detected." }
+            }
+            if (allDeps["@tata1mg/router"])
                 return {
                     status: "gap",
                     native_risk:
-                        "react-router-dom does not support SSR + hydration required by catalyst-core. App routing will break on native.",
-                    reason: "@tata1mg/router not in package.json dependencies",
+                        "Catalyst 0.3.x owns the router implementation. Keeping @tata1mg/router can install a second routing runtime and produce incompatible React elements.",
+                    reason: "Remove @tata1mg/router and import router APIs from catalyst-core",
                 }
-            return { status: "completed" }
+            return { status: "completed", note: "Current 0.3.x integrated router contract detected." }
         },
 
         T3_ROUTES_FILE: () => {
@@ -111,6 +139,38 @@ function handle_get_conversion_status({ project_path, include_not_applicable = f
             return { status: "completed" }
         },
 
+        T2b_RUNTIME_DEPS: () => {
+            if (generation !== "current")
+                return {
+                    status: generation === "legacy" ? "completed" : "needs_review",
+                    reason:
+                        generation === "legacy"
+                            ? "Legacy 0.2.x dependency contract retained."
+                            : "Catalyst version is unknown; do not change React versions until the target is confirmed.",
+                    native_risk:
+                        generation === "unknown"
+                            ? "Applying React 19 requirements to an unknown Catalyst runtime can break SSR."
+                            : undefined,
+                    review_context:
+                        generation === "unknown"
+                            ? { question: "Is this project staying on 0.2.x or targeting 0.3.x?" }
+                            : undefined,
+                }
+            const invalid = []
+            if (allDeps.react !== "19.0.0") invalid.push(`react=${allDeps.react || "missing"}`)
+            if (allDeps["react-dom"] !== "19.0.0")
+                invalid.push(`react-dom=${allDeps["react-dom"] || "missing"}`)
+            if (allDeps["@loadable/component"]) invalid.push("@loadable/component is installed")
+            if (invalid.length)
+                return {
+                    status: "gap",
+                    native_risk:
+                        "Mixed React or legacy loadable runtimes can cause invalid React child, hook, or hydration failures.",
+                    reason: invalid.join(", "),
+                }
+            return { status: "completed" }
+        },
+
         T4_DATA_FETCHING: () => {
             const useEffectFiles = grepSrc(
                 /useEffect.*fetch|useEffect.*axios|useEffect.*\.get\(|useEffect.*\.post\(/
@@ -198,6 +258,40 @@ function handle_get_conversion_status({ project_path, include_not_applicable = f
                         "Client entry files are required for hydration. Without them the native WebView loads server HTML but JS never hydrates — app is non-interactive.",
                     reason: `Missing: ${missing.join(", ")}`,
                 }
+            const clientEntry = readText("client/index.js") || ""
+            if (generation === "current" && /@loadable\/component|loadableReady/.test(clientEntry))
+                return {
+                    status: "gap",
+                    native_risk:
+                        "Catalyst 0.3.x uses its Vite split hydration contract; loadableReady belongs to the legacy webpack runtime.",
+                    reason: "Replace loadableReady with hydrationReady from catalyst-core",
+                }
+            return { status: "completed" }
+        },
+
+        T7b_NATIVE_SCRIPTS: () => {
+            const scripts = pkg.scripts || {}
+            const required = [
+                "buildApp",
+                "buildApp:ios",
+                "buildApp:android",
+                "setupEmulator",
+                "setupEmulator:ios",
+                "setupEmulator:android",
+            ]
+            const missing = required.filter((name) => !scripts[name])
+            if (missing.length)
+                return {
+                    status: "gap",
+                    native_risk: `Native Catalyst commands are unavailable: ${missing.join(", ")}.`,
+                    reason: `Missing package scripts: ${missing.join(", ")}`,
+                }
+            if (generation === "current" && (scripts.devBuild || scripts.devServe))
+                return {
+                    status: "gap",
+                    native_risk: "devBuild and devServe were removed from the Catalyst 0.3.x CLI.",
+                    reason: "Remove devBuild/devServe and use start for development or build + serve for production",
+                }
             return { status: "completed" }
         },
 
@@ -657,6 +751,13 @@ function handle_get_conversion_status({ project_path, include_not_applicable = f
         project: pkg.name || root,
         scanned_at: new Date().toISOString(),
         catalyst_core_version: installedVersion || "unknown",
+        catalyst_generation: generation,
+        guidance:
+            generation === "unknown"
+                ? `Specify a target Catalyst version before applying router, build, or hydration changes. Current Vite guidance starts at ${VITE_RUNTIME_VERSION}.`
+                : generation === "legacy"
+                  ? "Using legacy Catalyst 0.2.x webpack/router guidance. Request an upgrade plan explicitly to target 0.3.x."
+                  : "Using current Catalyst 0.3.x Vite/integrated-router guidance.",
         project_context,
         ...(versionBanner ? { version_warning: versionBanner } : {}),
         summary: {

package/mcp_v2/tools/tasks.js

@@ -2,7 +2,7 @@
 
 const fs = require("fs")
 const path = require("path")
-const { findCatalystRoot } = require("../lib/helpers")
+const { findCatalystRoot, catalystGeneration } = require("../lib/helpers")
 const conversion = require("./conversion")
 
 let _db
@@ -597,33 +597,34 @@ function appendToMdFindings(projectRoot, slug, finding) {
 
 // Commands that are verified to exist in catalyst-core projects
 const VALID_COMMANDS = new Set([
-    "npm run build:android",
-    "npm run build:android:release",
-    "npm run build:ios",
+    "npm run start",
+    "npm run build",
+    "npm run serve",
     "npm run buildApp:android",
     "npm run buildApp:ios",
-    "npm run buildApp:android:release",
-    "npm run buildApp:ios:release",
     "npm run setupEmulator:android",
     "npm run setupEmulator:ios",
-    "npm run devBuild",
-    "npm run devServe",
     "npm run prepare",
     "node .catalyst/mcp/setup.js",
 ])
 
-function validateStepCommands(steps) {
+function validateStepCommands(steps, generation) {
+    const validCommands = new Set(VALID_COMMANDS)
+    if (generation === "legacy") {
+        validCommands.add("npm run devBuild")
+        validCommands.add("npm run devServe")
+    }
     const invalid = []
     for (const s of steps) {
         const text = `${typeof s === "string" ? s : (s.title || "") + " " + (s.detail || "")}`
         const cmds = text.match(/npm [\w:]+(?:\s[\w:]+)?|npx [\w@/-]+|node [\w./]+/g) || []
         for (const cmd of cmds) {
-            if (!VALID_COMMANDS.has(cmd)) {
+            if (!validCommands.has(cmd)) {
                 invalid.push(cmd)
             }
         }
     }
-    return invalid
+    return { invalid, validCommands }
 }
 
 function handle_create_task_plan({ goal, steps: customSteps } = {}) {
@@ -650,13 +651,16 @@ function handle_create_task_plan({ goal, steps: customSteps } = {}) {
 
     if (customSteps && Array.isArray(customSteps) && customSteps.length) {
         // Validate any commands in custom steps against known catalyst commands
-        const invalidCmds = validateStepCommands(customSteps)
+        const { invalid: invalidCmds, validCommands } = validateStepCommands(
+            customSteps,
+            catalystGeneration(catalystRoot.installedVersion || catalystRoot.catalystVersion)
+        )
         if (invalidCmds.length > 0) {
             return {
                 error: "invalid_commands_in_steps",
-                message: `Steps contain commands that do not exist in catalyst-core projects: ${invalidCmds.join(", ")}. Do not invent commands. Valid catalyst commands are: ${[...VALID_COMMANDS].join(", ")}. For conversion/migration goals, omit steps entirely — auto-generation runs live file detection and builds accurate steps.`,
+                message: `Steps contain commands that do not exist for this catalyst-core generation: ${invalidCmds.join(", ")}. Do not invent commands. Valid commands are: ${[...validCommands].join(", ")}. For conversion/migration goals, omit steps entirely so live detection can generate version-aware steps.`,
                 invalid_commands: invalidCmds,
-                valid_commands: [...VALID_COMMANDS],
+                valid_commands: [...validCommands],
             }
         }
         steps = customSteps.map((s, i) => ({

package/package.json

@@ -1,7 +1,8 @@
 {
     "name": "catalyst-core",
-    "version": "0.2.0-beta.3",
-    "main": "dist/index.js",
+    "version": "0.3.0-beta.1",
+    "type": "module",
+    "main": "./dist/index.jsx",
     "description": "Web framework that provides great performance out of the box",
     "bin": {
         "catalyst": "bin/catalyst.js"
@@ -12,97 +13,59 @@
         "directory": "packages/catalyst-core"
     },
     "_moduleAliases": {
-        "@catalyst/template": ".",
-        "@catalyst/template/src": "src",
-        "@catalyst/template/routes": "src/js/routes",
-        "@catalyst/template/server": "server",
-        "@catalyst/template/store": "src/js/store",
-        "@catalyst/template/config": "config",
-        "@catalyst": ".",
-        "@catalyst/root": "../",
-        "@catalyst/router": "router",
-        "@catalyst/scripts": "scripts",
-        "@catalyst/server": "server",
-        "@catalyst/webpack": "webpack"
+        "@catalyst/template": "."
     },
     "exports": {
-        ".": "./dist/index.js",
+        ".": "./dist/index.jsx",
         "./package.json": "./package.json",
         "./logger": "./dist/logger.js",
         "./caching": "./dist/caching.js",
         "./router/ClientRouter": "./dist/router/ClientRouter.js",
+        "./document": "./dist/server/renderer/document/index.jsx",
         "./WebBridge": "./dist/native/bridge/WebBridge.js",
         "./hooks": "./dist/native/bridge/hooks.js",
-        "./sentry": "./dist/sentry.js",
+        "./sentry": "./dist/sentry.cjs",
         "./otel": "./dist/otel.js"
     },
     "scripts": {
         "lint": "eslint .",
+        "lint-staged": "lint-staged",
         "prettify": "prettier . --write",
-        "prepare": "babel src --out-dir ./dist --ignore '**/.build/**' && mkdir -p dist/native && cp -r src/native/androidProject src/native/build.swift src/native/assets dist/native/ && mkdir -p dist/native/iosnativeWebView && tar -C src/native/iosnativeWebView --exclude='.build' --exclude='.package-config-hash' -cf - . | tar -C dist/native/iosnativeWebView -xf -",
+        "prepare": "rm -rf ./dist && cp -r ./src ./dist && babel src/native --out-dir dist/native --config-file ./babel.native.config.cjs --ignore '**/.build/**' && babel src/sentry.js --out-file dist/sentry.cjs --config-file ./babel.native.config.cjs",
         "prepublishOnly": "npm run prepare",
         "test:fixture": "sh ../../scripts/test-catalyst-core.sh"
     },
     "license": "MIT",
     "dependencies": {
-        "@babel/cli": "^7.23.0",
-        "@babel/core": "^7.23.2",
-        "@babel/node": "^7.22.19",
-        "@babel/preset-env": "^7.23.2",
-        "@babel/preset-react": "^7.22.15",
-        "@babel/preset-typescript": "^7.24.7",
-        "@babel/register": "^7.22.15",
-        "@dr.pogodin/css-modules-require-hook": "^4.7.3",
-        "@loadable/babel-plugin": "^5.16.1",
-        "@loadable/component": "^5.15.3",
-        "@loadable/server": "^5.16.1",
-        "@loadable/webpack-plugin": "^5.15.2",
-        "@pmmmwh/react-refresh-webpack-plugin": "^0.5.11",
-        "@svgr/webpack": "^8.1.0",
-        "@tata1mg/router": "0.1.0-beta",
-        "app-root-path": "^3.1.0",
-        "babel-loader": "^9.1.3",
-        "babel-plugin-react-compiler": "^19.0.0-beta-decd7b8-20250118",
+        "@vitejs/plugin-react": "^4.4.1",
         "body-parser": "^1.20.2",
-        "chokidar": "^3.6.0",
         "compression": "^1.7.4",
         "cookie-parser": "^1.4.6",
-        "cross-env": "^7.0.3",
-        "css-hot-loader": "^1.4.4",
-        "css-loader": "^6.8.1",
         "express": "^4.18.2",
         "express-static-gzip": "^2.1.7",
-        "file-loader": "^6.2.0",
-        "html-loader": "^4.2.0",
-        "img-loader": "^4.0.0",
-        "mini-css-extract-plugin": "^2.7.6",
-        "module-alias": "^2.2.3",
         "picocolors": "^1.0.0",
-        "postcss-loader": "^7.3.3",
-        "postcss-scss": "^4.0.9",
         "react": "19.0.0",
-        "react-compiler-runtime": "^19.0.0-beta-decd7b8-20250118",
         "react-dom": "19.0.0",
+        "react-helmet-async": "^1.3.0",
         "react-redux": "^9.2.0",
         "react-refresh": "^0.14.0",
         "react-router-dom": "^6.16.0",
-        "sass": "^1.69.5",
-        "sass-loader": "^13.3.2",
-        "sass-resources-loader": "^2.2.5",
+        "redux": "^4.2.1",
+        "sanitize-html": "^2.13.1",
+        "sass": "^1.89.2",
         "ua-parser-js": "^1.0.37",
-        "url": "^0.11.3",
-        "url-loader": "^4.1.1",
-        "webpack": "^5.88.2",
-        "webpack-bundle-analyzer": "^4.9.1",
-        "webpack-cli": "^5.1.4",
-        "webpack-dev-server": "^5.2.4",
-        "webpack-merge": "^5.9.0",
-        "webpack-node-externals": "^3.0.0",
+        "vite": "^6.4.3",
+        "vite-plugin-svgr": "^5.0.0",
         "winston": "^3.11.0",
         "winston-daily-rotate-file": "^5.0.0"
     },
     "devDependencies": {
+        "@babel/cli": "^7.23.0",
+        "@babel/core": "^7.23.2",
         "@babel/eslint-parser": "^7.19.1",
+        "@babel/preset-env": "^7.23.2",
+        "@babel/preset-react": "^7.22.15",
+        "@babel/preset-typescript": "^7.24.7",
         "@commitlint/cli": "^19.3.0",
         "@commitlint/config-conventional": "^19.2.2",
         "eslint": "^8.26.0",
@@ -112,20 +75,24 @@
         "eslint-plugin-react-hooks": "^4.6.0",
         "eslint-plugin-risxss": "^2.1.0",
         "eslint-plugin-security": "^3.0.0",
+        "husky": "^9.0.11",
+        "lint-staged": "^15.2.2",
         "prettier": "^3.2.5"
     },
+    "lint-staged": {
+        "*.{js,jsx}": [
+            "eslint .",
+            "prettier . --write"
+        ]
+    },
     "overrides": {
-        "@loadable/component": {
-            "react": "^16.3.0 || ^17.0.0 || ^18.0.0 || 19.0.0"
-        },
-        "@loadable/server": {
-            "react": "^16.3.0 || ^17.0.0 || ^18.0.0 || 19.0.0"
+        "react-helmet-async": {
+            "react": "19.0.0",
+            "react-dom": "19.0.0"
         },
-        "uuid": "11.1.1",
-        "file-type": "22.0.1",
-        "imagemin": "9.0.1",
-        "webpack-dev-server": {
-            "http-proxy-middleware": "3.0.7"
+        "react-redux": {
+            "react": "19.0.0",
+            "react-dom": "19.0.0"
         }
     }
 }

package/babel.config.js

@@ -1,32 +0,0 @@
-module.exports = (api) => {
-    api.cache(true)
-
-    return {
-        presets: [
-            [
-                "@babel/preset-typescript",
-                {
-                    isTSX: true,
-                    allExtensions: true,
-                },
-            ],
-            [
-                "@babel/preset-env",
-                {
-                    targets: {
-                        node: "current",
-                    },
-                },
-            ],
-            ["@babel/preset-react", { runtime: "automatic" }],
-        ],
-        compact: true,
-        plugins: ["@loadable/babel-plugin"],
-        env: {
-            test: {
-                presets: ["@babel/preset-react"],
-            },
-        },
-        ignore: ["__TEST__"],
-    }
-}

package/dist/index.js

@@ -1 +0,0 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:true});var _index=require("./server/renderer/document/index");Object.keys(_index).forEach(function(key){if(key==="default"||key==="__esModule")return;if(key in exports&&exports[key]===_index[key])return;Object.defineProperty(exports,key,{enumerable:true,get:function(){return _index[key];}});});

package/dist/scripts/devBuild.js

@@ -1,3 +0,0 @@
-"use strict";const path=require("path");const{green,cyan,yellow}=require("picocolors");const{name}=require(`${process.cwd()}/package.json`);const{BUILD_OUTPUT_PATH}=require(`${process.cwd()}/config/config.json`);const{arrayToObject,printBundleInformation,runBuildCommands}=require("./scriptUtils.js");/**
- * @description - creates a production build of the application.
- */function devBuild(){const isWindows=process.platform==="win32";const commandLineArguments=process.argv.slice(2);const argumentsObject=arrayToObject(commandLineArguments);const dirname=path.resolve(__dirname,"../../");const commands=["node ./dist/scripts/checkVersion",`${isWindows?"rd -r -fo":"rm -rf"} ${process.cwd()}/${BUILD_OUTPUT_PATH} & node ./dist/scripts/loadScriptsBeforeServerStarts.js`,`cross-env APPLICATION=${name||"catalyst_app"} webpack --config ./dist/webpack/production.client.babel.js --progress`,`cross-env APPLICATION=${name||"catalyst_app"} SSR=true webpack --config ./dist/webpack/production.ssr.babel.js`,`cross-env APPLICATION=${name||"catalyst_app"} node ./dist/scripts/generateOfflineManifest.js`,`cross-env APPLICATION=${name||"catalyst_app"} npx babel ./dist/server --out-dir ${process.cwd()}/${BUILD_OUTPUT_PATH} --ignore '**/*.test.js,./dist/server/renderer/handler.js' --quiet`,`cross-env APPLICATION=${name||"catalyst_app"} npx babel ${process.cwd()}/server --out-dir ${process.cwd()}/${BUILD_OUTPUT_PATH} --quiet`];console.log("Creating an optimized local build...");runBuildCommands({commands,cwd:dirname,env:{...process.env,src_path:process.cwd(),BUILD_OUTPUT_PATH:BUILD_OUTPUT_PATH,NODE_ENV:"production",IS_DEV_COMMAND:true,...argumentsObject}});console.log(green("Compiled successfully."));console.log("\nFile sizes after gzip:\n");printBundleInformation();console.log(`\nThe ${cyan(BUILD_OUTPUT_PATH)} folder is ready to be deployed.`);console.log("You may serve it with a serve command:");console.log(cyan("\n npm run devServe"));console.log("\nFind out more about deployment here:");console.log(yellow("\n https://catalyst.1mg.com/public_docs/content/Deployment%20and%20Production/deployment\n"));}devBuild();

package/dist/scripts/devServe.js

@@ -1,3 +0,0 @@
-"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 devServe(){const commandLineArguments=process.argv.slice(2);const argumentsObject=arrayToObject(commandLineArguments);const dirname=path.resolve(__dirname,"../../");spawnSync("node",["-r","./dist/scripts/loadScriptsBeforeServerStarts.js",path.join(process.cwd(),BUILD_OUTPUT_PATH,"startServer.js")],{cwd:dirname,stdio:"inherit",env:{...process.env,src_path:process.cwd(),BUILD_OUTPUT_PATH:BUILD_OUTPUT_PATH,NODE_ENV:"production",IS_DEV_COMMAND:true,APPLICATION:name||"catalyst_app",...argumentsObject}});}devServe();

package/dist/scripts/loadScriptsBeforeServerStarts.js

@@ -1,4 +0,0 @@
-"use strict";require("./registerAliases.js");var _cssModulesRequireHook=_interopRequireDefault(require("@dr.pogodin/css-modules-require-hook"));var _path=_interopRequireDefault(require("path"));var _loadEnvironmentVariables=_interopRequireDefault(require("./loadEnvironmentVariables"));var _postcssScss=_interopRequireDefault(require("postcss-scss"));var _logger=require("@catalyst/logger.js");function _interopRequireDefault(e){return e&&e.__esModule?e:{default:e};}/* eslint-disable */const{cssModulesIdentifierDev}=require("@catalyst/root/config.json");// stores your config keys in enviorments variables
-(0,_loadEnvironmentVariables.default)();// creates logger instance with provided config and stores them at global level.
-(0,_logger.configureLogger)({enableDebugLogs:process.env.ENABLE_DEBUG_LOGS,enableFileLogging:process.env.ENABLE_FILE_LOGGING,enableConsoleLogging:process.env.ENABLE_CONSOLE_LOGGING});// compile css-variables in realtime in dev mode.
-if(process.env.NODE_ENV==="development")(0,_cssModulesRequireHook.default)({extensions:[".scss",".css"],processorOpts:{parser:_postcssScss.default.parse},generateScopedName:cssModulesIdentifierDev,devMode:true,ignore:_path.default.posix.join(process.env.src_path,"/src/static/css/base/(?!.*.scss$).*")});

package/dist/scripts/registerAliases.js

@@ -1,6 +0,0 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.catalystResultMap=void 0;var _path=_interopRequireDefault(require("path"));var _moduleAlias=_interopRequireDefault(require("module-alias"));var _package=require("../../package.json");var _validator=require("./validator.js");function _interopRequireDefault(e){return e&&e.__esModule?e:{default:e};}const{_moduleAliases:templateModuleAliases}=require(`${process.env.src_path}/package.json`);const catalystResultMap=exports.catalystResultMap=Object.keys(_package._moduleAliases||[]).reduce((resultMap,aliasName)=>{const aliasPath=_package._moduleAliases[aliasName];if(aliasName?.includes("@catalyst/template")){if(aliasName?.includes("server")&&process.env.NODE_ENV==="production"){resultMap[aliasName]=_path.default.join(process.env.src_path,process.env.BUILD_OUTPUT_PATH);}else{// nosemgrep
-resultMap[aliasName]=_path.default.join(process.env.src_path,aliasPath);}return resultMap;}if(aliasName?.includes("@catalyst")&&!aliasName?.includes("@catalyst/template")){if(aliasName?.includes("server")&&process.env.NODE_ENV==="production"){resultMap[aliasName]=_path.default.join(process.env.src_path,process.env.BUILD_OUTPUT_PATH);}else{// nosemgrep
-resultMap[aliasName]=_path.default.join(__dirname,"../",aliasPath);}return resultMap;}return resultMap;},{});_moduleAlias.default.addAliases(catalystResultMap);// resolves module alias imports
-if((0,_validator.validateModuleAlias)(templateModuleAliases)){_moduleAlias.default.addAliases(Object.keys(templateModuleAliases||[]).reduce((resultMap,aliasName)=>{const aliasPath=templateModuleAliases[aliasName];if(aliasPath.includes("server")){if(process.env.NODE_ENV!=="production"){// nosemgrep
-resultMap[aliasName]=_path.default.join(process.env.src_path,aliasPath);}else{resultMap[aliasName]=_path.default.join(process.env.src_path,process.env.BUILD_OUTPUT_PATH);}}else{// nosemgrep
-resultMap[aliasName]=_path.default.join(process.env.src_path,aliasPath);}return resultMap;},{}));}

package/dist/server/renderer/document/Body.js

@@ -1,11 +0,0 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.Body=Body;var _react=_interopRequireDefault(require("react"));var _jsxRuntime=require("react/jsx-runtime");function _interopRequireDefault(e){return e&&e.__esModule?e:{default:e};}/**
- * Body component which will be used in page component
- * @param {object} jsx - page jsx code
- * @param {object} initialState - initial state object for redux store
- * @param {object} firstFoldCss - style elements extracted for initial page load
- * @param {object} fetcherData - contains data from executing serverFetcher function
- * @param {object} children - contains any child elements defined within the component
- */const DEFAULT_SAFE_AREA={top:0,right:0,bottom:0,left:0};function Body({jsx="",initialState={},fetcherData={},children,safeArea=DEFAULT_SAFE_AREA,nativeWebView=false}){return/*#__PURE__*/(0,_jsxRuntime.jsxs)("body",{children:[/*#__PURE__*/(0,_jsxRuntime.jsx)("script",{/* eslint-disable-next-line risxss/catch-potential-xss-react */dangerouslySetInnerHTML:{__html:`window.__SAFE_AREA_INITIAL__ = ${JSON.stringify(safeArea)}; window.__CATALYST_NATIVE_WEBVIEW__ = ${nativeWebView?"true":"false"}`}}),jsx,/*#__PURE__*/(0,_jsxRuntime.jsx)("script",{/* eslint-disable */dangerouslySetInnerHTML:{__html:`
-                    window.__INITIAL_STATE__ = ${JSON.stringify(initialState)}
-                    window.__ROUTER_INITIAL_DATA__ = ${JSON.stringify(fetcherData)}
-            `}}),children]});}

package/dist/server/renderer/document/Head.js

@@ -1,9 +0,0 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.Head=Head;var _react=_interopRequireDefault(require("react"));var _jsxRuntime=require("react/jsx-runtime");function _interopRequireDefault(e){return e&&e.__esModule?e:{default:e};}/**
- * Head component which will be used in page rendering
- * @param {boolean} isBot - checks if request is made by bot
- * @param {string} pageCss - includes all styles for page css
- * @param {object} preloadJSLinks - async scripts for loading chunks
- * @param {array} metaTags - user defined function which returns meta tags in array
- * @param {string} publicAssetPath - public asset path for assets
- * @param {object} children - contains any child elements defined within the component
- */function Head({pageCss,preloadJSLinks,metaTags,isBot,publicAssetPath,children}){if(children){return/*#__PURE__*/(0,_jsxRuntime.jsxs)("head",{children:[children,metaTags&&metaTags,pageCss&&/*#__PURE__*/(0,_jsxRuntime.jsx)("style",{dangerouslySetInnerHTML:{__html:pageCss}}),!isBot&&preloadJSLinks]});}return/*#__PURE__*/(0,_jsxRuntime.jsxs)("head",{children:[/*#__PURE__*/(0,_jsxRuntime.jsx)("meta",{charSet:"utf-8"}),/*#__PURE__*/(0,_jsxRuntime.jsx)("meta",{name:"viewport",content:"width=device-width, initial-scale=1"}),publicAssetPath&&/*#__PURE__*/(0,_jsxRuntime.jsx)("link",{rel:"preconnect",href:publicAssetPath}),publicAssetPath&&/*#__PURE__*/(0,_jsxRuntime.jsx)("link",{rel:"dns-prefetch",href:publicAssetPath}),metaTags&&metaTags,pageCss&&/*#__PURE__*/(0,_jsxRuntime.jsx)("style",{dangerouslySetInnerHTML:{__html:pageCss}}),!isBot&&preloadJSLinks]});}

package/dist/server/renderer/document/index.js

@@ -1 +0,0 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:true});var _Head=require("./Head");Object.keys(_Head).forEach(function(key){if(key==="default"||key==="__esModule")return;if(key in exports&&exports[key]===_Head[key])return;Object.defineProperty(exports,key,{enumerable:true,get:function(){return _Head[key];}});});var _Body=require("./Body");Object.keys(_Body).forEach(function(key){if(key==="default"||key==="__esModule")return;if(key in exports&&exports[key]===_Body[key])return;Object.defineProperty(exports,key,{enumerable:true,get:function(){return _Body[key];}});});

package/dist/server/renderer/handler.js

@@ -1,47 +0,0 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.default=void 0;var _fs=_interopRequireDefault(require("fs"));var _path=_interopRequireDefault(require("path"));var _react=_interopRequireDefault(require("react"));var _extract=_interopRequireWildcard(require("./extract"));var _otel=require("../../otel");var _reactRedux=require("react-redux");var _document=require("./document");var _server=require("react-router-dom/server");var _ServerRouter=_interopRequireDefault(require("@catalyst/router/ServerRouter.js"));var _index=_interopRequireDefault(require("@catalyst/template/src/js/containers/App/index.js"));var _server2=require("@loadable/server");var _server3=require("react-dom/server");var _userAgentUtil=require("@catalyst/server/utils/userAgentUtil");var _router=require("@tata1mg/router");var _validator=require("@catalyst/server/utils/validator");var _document2=_interopRequireDefault(require("@catalyst/template/server/document.js"));var _utils=require("@catalyst/template/src/js/routes/utils.js");var _index2=require("@catalyst/template/server/index.js");var _jsxRuntime=require("react/jsx-runtime");function _interopRequireWildcard(e,t){if("function"==typeof WeakMap)var r=new WeakMap(),n=new WeakMap();return(_interopRequireWildcard=function(e,t){if(!t&&e&&e.__esModule)return e;var o,i,f={__proto__:null,default:e};if(null===e||"object"!=typeof e&&"function"!=typeof e)return f;if(o=t?n:r){if(o.has(e))return o.get(e);o.set(e,f);}for(const t in e)"default"!==t&&{}.hasOwnProperty.call(e,t)&&((i=(o=Object.defineProperty)&&Object.getOwnPropertyDescriptor(e,t))&&(i.get||i.set)?o(f,t,i):f[t]=e[t]);return f;})(e,t);}function _interopRequireDefault(e){return e&&e.__esModule?e:{default:e};}const storePath=_path.default.resolve(`${process.env.src_path}/src/js/store/index.js`);let createStore;if(_fs.default.existsSync(storePath)){try{const{default:configureStore}=require(`${process.env.src_path}/src/js/store/index.js`);createStore=configureStore;}catch(error){createStore=()=>{return{getState:()=>{}};};}}else{createStore=()=>{return{getState:()=>{}};};}const isProduction=process.env.NODE_ENV==="production";const DEFAULT_SAFE_AREA_INSETS={top:0,right:0,bottom:0,left:0};const parseSafeAreaFromHeaders=req=>{const readEdge=header=>{const raw=req.get(header)??req.headers[header.toLowerCase()];const value=Number(raw);return Number.isFinite(value)&&value>=0?value:null;};const top=readEdge("X-Safe-Area-Top");const right=readEdge("X-Safe-Area-Right");const bottom=readEdge("X-Safe-Area-Bottom");const left=readEdge("X-Safe-Area-Left");const hasAny=[top,right,bottom,left].some(value=>value!==null);if(!hasAny){return null;}return{top:top??0,right:right??0,bottom:bottom??0,left:left??0};};const isNativeWebViewRequest=req=>{const raw=req.get("X-Catalyst-Native-WebView")??req.headers["x-catalyst-native-webview"];return raw==="1"||raw==="true";};// Cache webStats path - computed once at module load
-const webStatsPath=isProduction?_path.default.join(process.env.src_path,`${process.env.BUILD_OUTPUT_PATH}/public/loadable-stats.json`):_path.default.join(__dirname,"../../..",`loadable-stats.json`);// Cache for parsed stats (production only)
-let cachedWebStats=null;const getWebStats=()=>{if(!isProduction){// In development, stats can change; always read fresh.
-return JSON.parse(_fs.default.readFileSync(webStatsPath,"utf-8"));}if(!cachedWebStats){cachedWebStats=JSON.parse(_fs.default.readFileSync(webStatsPath,"utf-8"));logger.info("ChunkExtractor stats cached in memory");}return cachedWebStats;};// Cache for ChunkExtractor instances per route (production only)
-if(!process.extractorCache){process.extractorCache={};}const getOrCreateExtractorForRoute=routePath=>{if(!isProduction){// In dev, always create fresh extractor (HMR compatible)
-return new _server2.ChunkExtractor({stats:getWebStats(),entrypoints:["app"]});}// Production: cache extractor per route
-if(!process.extractorCache[routePath]){process.extractorCache[routePath]=new _server2.ChunkExtractor({stats:getWebStats(),entrypoints:["app"]});logger.info(`ChunkExtractor created and cached for route: ${routePath}`);}return process.extractorCache[routePath];};// Cache routes array - getRoutes() returns same reference, but validate once
-let cachedRoutes=null;const getCachedRoutes=()=>{if(!cachedRoutes){cachedRoutes=(0,_validator.validateGetRoutes)(_utils.getRoutes)?(0,_utils.getRoutes)():[];}return cachedRoutes;};const SSR_SERVICE=process.env.SERVICE_NAME||`pwa-${process.env.APPLICATION}-node-server-otel`;const traceHandlerHook=(fn,spanName)=>typeof fn==="function"?(0,_otel.withSyncObservability)(SSR_SERVICE,fn,spanName):fn;const onRouteMatch=traceHandlerHook(_index2.onRouteMatch,"onRouteMatch");const onFetcherSuccess=traceHandlerHook(_index2.onFetcherSuccess,"onFetcherSuccess");const onFetcherError=traceHandlerHook(_index2.onFetcherError,"onFetcherError");const onAppServerSideSuccess=traceHandlerHook(_index2.onAppServerSideSuccess,"onAppServerSideSuccess");const onAppServerSideError=traceHandlerHook(_index2.onAppServerSideError,"onAppServerSideError");const onRenderError=traceHandlerHook(_index2.onRenderError,"onRenderError");const onRequestError=traceHandlerHook(_index2.onRequestError,"onRequestError");// Phase 1b dry-run: wrapped separately so it appears as a distinct span inside getMatchRoutes.
-const renderToStringWithObservability=(0,_otel.withSyncObservability)(SSR_SERVICE,function dryRunRender(webExtractor,store,context,req,fetcherData){(0,_server3.renderToString)(/*#__PURE__*/(0,_jsxRuntime.jsx)(_server2.ChunkExtractorManager,{extractor:webExtractor,children:/*#__PURE__*/(0,_jsxRuntime.jsx)(_reactRedux.Provider,{store:store,children:/*#__PURE__*/(0,_jsxRuntime.jsx)(_server.StaticRouter,{context:context,location:req.originalUrl,children:/*#__PURE__*/(0,_jsxRuntime.jsx)(_ServerRouter.default,{store:store,intialData:fetcherData})})})}));},"renderToString");// Internal recursive implementation — called directly to avoid creating a new span on each recursion.
-const _getMatchRoutes=(routes,req,res,store,context,fetcherData,basePath="")=>{return routes.reduce((matches,route)=>{const{path}=route;const match=(0,_router.matchPath)({path:`${basePath}/${path}`,caseSensitive:false,end:true},req.baseUrl||"/");if(match){if(!res.locals.pageCss&&!res.locals.preloadJSLinks&&!res.locals.routePath){res.locals.routePath=path;// Phase 1a: try to serve CSS/preloadLinks from the extractor cache (production only).
-// On a cache hit, res.locals.pageCss and preloadJSLinks are populated and
-// the renderToString dry-run below is skipped entirely for this request.
-(0,_extract.default)(res,route);}// Production: reuses the same ChunkExtractor per route (chunks accumulate over time).
-// Dev: always creates a fresh extractor so HMR chunk changes are picked up immediately.
-if(!res.locals.webExtractor){res.locals.webExtractor=getOrCreateExtractorForRoute(path);}if(!res.locals.pageCss&&!res.locals.preloadJSLinks){// Phase 1b: dry-run renderToString solely to let the ChunkExtractor record which
-// chunks this route needs. The output is discarded — the real render happens later
-// in renderMarkUp via renderToPipeableStream.
-renderToStringWithObservability(res.locals.webExtractor,store,context,req,fetcherData);}const wc=route.component;matches.push({route,match,serverSideFunction:wc&&wc.serverSideFunction||(()=>Promise.resolve())});}if(!match&&route.children){const nested=_getMatchRoutes(route.children,req,res,store,context,fetcherData,`${basePath}/${path}`);if(nested.length){matches=matches.concat(nested);}}return matches;},[]);};const getMatchRoutes=(0,_otel.withSyncObservability)(SSR_SERVICE,_getMatchRoutes,"getMatchRoutes");// Preloads chunks required for rendering document
-const getComponent=(store,context,req,fetcherData)=>{return/*#__PURE__*/(0,_jsxRuntime.jsx)("div",{id:"app",children:/*#__PURE__*/(0,_jsxRuntime.jsx)(_reactRedux.Provider,{store:store,children:/*#__PURE__*/(0,_jsxRuntime.jsx)(_server.StaticRouter,{context:context,location:req.originalUrl,children:/*#__PURE__*/(0,_jsxRuntime.jsx)(_ServerRouter.default,{store:store,intialData:fetcherData})})})});};const tracedResWriteFirstFoldCss=(0,_otel.withSyncObservability)(SSR_SERVICE,(res,chunk)=>res.write(chunk),"res.write.firstFoldCss");const tracedResWriteFirstFoldJS=(0,_otel.withSyncObservability)(SSR_SERVICE,(res,chunk)=>res.write(chunk),"res.write.firstFoldJS");const tracedResEnd=(0,_otel.withSyncObservability)(SSR_SERVICE,res=>res.end(),"res.end");const renderMarkUp=async(errorCode,req,res,metaTags,fetcherData,store,matches,context,webExtractor)=>{const deviceDetails=(0,_userAgentUtil.getUserAgentDetails)(req.headers["user-agent"]||"");const isBot=deviceDetails.googleBot||deviceDetails.aiBot?true:false;const safeArea=parseSafeAreaFromHeaders(req)||{...DEFAULT_SAFE_AREA_INSETS};const nativeWebView=isNativeWebViewRequest(req);/* eslint-disable no-undef */const previousSafeArea=globalThis.__SAFE_AREA_INITIAL__;const previousNativeWebView=globalThis.__CATALYST_NATIVE_WEBVIEW__;globalThis.__SAFE_AREA_INITIAL__=safeArea;globalThis.__CATALYST_NATIVE_WEBVIEW__=nativeWebView;/* eslint-enable no-undef */let state=store.getState();// collectChunks wraps the component tree so the extractor can track which loadable
-// chunks are actually rendered, building the final script/link tag lists.
-const jsx=webExtractor.collectChunks(getComponent(store,context,req,fetcherData));const{IS_DEV_COMMAND,WEBPACK_DEV_SERVER_HOSTNAME,WEBPACK_DEV_SERVER_PORT}=process.env;let publicAssetPath=`${process.env.PUBLIC_STATIC_ASSET_URL}${process.env.PUBLIC_STATIC_ASSET_PATH}`;// serves assets from localhost on running devBuild and devServe command
-if(IS_DEV_COMMAND==="true"){publicAssetPath=`http://${WEBPACK_DEV_SERVER_HOSTNAME}:${WEBPACK_DEV_SERVER_PORT}/assets/`;}const finalProps={req,res,lang:"en",pageCss:res.locals.pageCss,preloadJSLinks:res.locals.preloadJSLinks,metaTags,isBot,publicAssetPath,jsx,initialState:state,fetcherData,safeArea,nativeWebView};let CompleteDocument=()=>{if((0,_validator.validateCustomDocument)(_document2.default)){return(0,_document2.default)(finalProps);}else{return/*#__PURE__*/(0,_jsxRuntime.jsxs)("html",{lang:finalProps.lang,children:[/*#__PURE__*/(0,_jsxRuntime.jsx)(_document.Head,{isBot:finalProps.isBot,pageCss:finalProps.pageCss,metaTags:finalProps.metaTags,preloadJSLinks:finalProps.preloadJSLinks,publicAssetPath:finalProps.publicAssetPath}),/*#__PURE__*/(0,_jsxRuntime.jsx)(_document.Body,{jsx:finalProps.jsx,fetcherData:finalProps.fetcherData,initialState:finalProps.initialState,safeArea:finalProps.safeArea,nativeWebView:finalProps.nativeWebView})]});}};const cleanupGlobalThis=()=>{/* eslint-disable no-undef */if(previousSafeArea===undefined){delete globalThis.__SAFE_AREA_INITIAL__;}else{globalThis.__SAFE_AREA_INITIAL__=previousSafeArea;}if(previousNativeWebView===undefined){delete globalThis.__CATALYST_NATIVE_WEBVIEW__;}else{globalThis.__CATALYST_NATIVE_WEBVIEW__=previousNativeWebView;}/* eslint-enable no-undef */};try{let status=errorCode||(matches.length&&matches[0].match.path==="*"?404:200);res.set({"content-type":"text/html; charset=utf-8"});res.status(status);return new Promise((resolve,reject)=>{const{pipe}=(0,_server3.renderToPipeableStream)(/*#__PURE__*/(0,_jsxRuntime.jsx)(CompleteDocument,{}),{onShellReady(){// Start streaming the HTML shell (everything above Suspense boundaries)
-// as soon as it's ready to minimise TTFB.
-res.setHeader("content-type","text/html");pipe(res);},onAllReady(){// All Suspense boundaries have resolved. Append inline CSS and script
-// tags at the end of the stream so the browser can start executing JS.
-const{firstFoldCss,firstFoldJS}=(0,_extract.cacheAndFetchAssets)({webExtractor,res,isBot});tracedResWriteFirstFoldCss(res,firstFoldCss);tracedResWriteFirstFoldJS(res,firstFoldJS);tracedResEnd(res);cleanupGlobalThis();resolve();},onError(error){logger.error({message:`\n Error while renderToPipeableStream : ${error.toString()}`});// function defined by user which needs to run if rendering fails
-(0,_validator.safeCall)(onRenderError,{req,res,store,error});cleanupGlobalThis();reject(error);}});});}catch(error){logger.error({message:`Error in rendering document on server - ${error}`,trace:error.stack,url:req.originalUrl});// function defined by user which needs to run if rendering fails
-(0,_validator.safeCall)(onRenderError,{req,res,store,error});cleanupGlobalThis();return Promise.reject(error);}};const tracedAppServerSideFunction=(0,_otel.withObservability)(SSR_SERVICE,args=>_index.default.serverSideFunction(args),"App.serverSideFunction");const tracedServerDataFetcher=(0,_otel.withObservability)(SSR_SERVICE,_router.serverDataFetcher,"serverDataFetcher");const tracedRenderMarkUp=(0,_otel.withObservability)(SSR_SERVICE,renderMarkUp,"renderMarkUp");const tracedGetMetaData=(0,_otel.withSyncObservability)(SSR_SERVICE,_router.getMetaData,"getMetaData");/**
- * SSR request handler. Execution pipeline per request:
- *   1. Match route → collect loadable chunks (Phase 1 dry-run)
- *   2. App.serverSideFunction (app-level server hook)
- *   3. serverDataFetcher (route-level data fetching)
- *   4. renderMarkUp → renderToPipeableStream (Phase 2 — real render + stream to client)
- *
- * res.headersSent is checked after each async step: if a user hook (onRouteMatch,
- * onAppServerSideSuccess, etc.) has already sent a response (e.g. a redirect), we
- * bail out early without attempting another render.
- */async function _handler(req,res){try{let context={};let fetcherData={};const store=(0,_validator.validateConfigureStore)(createStore)?createStore({},req,res):null;const routes=getCachedRoutes();// matches: routes that exactly match this URL — used for serverSideFunction execution.
-// allMatches: full nested match tree — used by getMetaData to collect meta tags.
-const matches=getMatchRoutes(routes,req,res,store,context,fetcherData);const allMatches=(0,_router.matchRoutes)(routes,req.baseUrl);let allTags=[];// Extractor is attached to res.locals inside getMatchRoutes; reused for collectChunks in renderMarkUp
-const webExtractor=res.locals.webExtractor;(0,_validator.safeCall)(onRouteMatch,{req,res,matches,store});if(res.headersSent){return Promise.resolve(res);}try{await tracedAppServerSideFunction({store,req,res});(0,_validator.safeCall)(onAppServerSideSuccess,{req,res,store});if(res.headersSent){return Promise.resolve(res);}try{fetcherData=await tracedServerDataFetcher({routes:routes,req,res,url:req.originalUrl},{store});if(res.headersSent){return Promise.resolve(res);}// Check if serverDataFetcher returned an error in the response
-const err=fetcherData?.[req.originalUrl]?.error;allTags=tracedGetMetaData(allMatches,fetcherData);if(err){(0,_validator.safeCall)(onFetcherError,{req,res,store,error:err});if(res.headersSent){return Promise.reject(err);}// TODO: this seems very dependent on developers error handling, we are assuming they attach status_code key in their errors (same in App.serverSideFunction error)
-const statusCode=err.status_code||404;return new Promise((resolve,reject)=>{tracedRenderMarkUp(statusCode,req,res,allTags,fetcherData,store,matches,context,webExtractor).then(resolve).catch(reject);});}else{// function defined by user which needs to run after SSR functions are executed successfully
-(0,_validator.safeCall)(onFetcherSuccess,{req,res,store});if(res.headersSent){return Promise.resolve(res);}return new Promise((resolve,reject)=>{tracedRenderMarkUp(null,req,res,allTags,fetcherData,store,matches,context,webExtractor).then(resolve).catch(reject);});}}catch(error){// TODO: This catch block is kept for any unexpected errors from serverDataFetcher or getMetaData
-logger.error("Error in executing serverFetcher functions: "+error);(0,_validator.safeCall)(onFetcherError,{req,res,store,error});if(res.headersSent){return Promise.reject(error);}return new Promise((resolve,reject)=>{tracedRenderMarkUp(404,req,res,allTags,fetcherData,store,matches,context,webExtractor).then(resolve).catch(reject);});}}catch(error){logger.error("Error in executing serverSideFunction inside App: "+error);// function defined by user which needs to run after app server side function fails
-(0,_validator.safeCall)(onAppServerSideError,{req,res,store,error});if(res.headersSent){return Promise.reject(error);}return new Promise((resolve,reject)=>{tracedRenderMarkUp(error.status_code,req,res,allTags,fetcherData,store,matches,context,webExtractor).then(resolve).catch(reject);});}}catch(error){logger.error("Error in handling document request: "+error.toString());// function defined by user which needs to run when an error occurs in the handler
-(0,_validator.safeCall)(onRequestError,{req,res,error});return Promise.reject(error);}}const handler=(0,_otel.withObservability)(SSR_SERVICE,_handler,"handler");var _default=exports.default=handler;