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

package/babel.native.config.cjs

@@ -0,0 +1,8 @@
+module.exports = {
+    presets: [
+        ["@babel/preset-env", { targets: { node: "current" } }],
+        ["@babel/preset-react", { runtime: "automatic" }],
+        ["@babel/preset-typescript", { isTSX: true, allExtensions: true }],
+    ],
+    compact: false,
+}

package/bin/catalyst.js

@@ -1,128 +1,72 @@
 #!/usr/bin/env node
-"use strict"
-process.on("unhandledRejection", (err) => {
-    throw err
-})
-const { spawnSync } = require("node:child_process")
-const args = process.argv.slice(2)
 
-// Array of valid commands
-const validCommands = [
-    "build",
-    "start",
-    "serve",
-    "devBuild",
-    "devServe",
-    "plugin",
-    "plugins",
-    "buildApp",
-    "buildApp:ios",
-    "buildApp:android",
-    "setupEmulator",
-    "setupEmulator:ios",
-    "setupEmulator:android",
-]
+import { spawnSync } from "node:child_process"
+import { dirname, resolve } from "node:path"
+import { fileURLToPath } from "node:url"
+
+process.on("unhandledRejection", (error) => {
+    throw error
+})
 
-// Map of platform-specific commands to their script paths
+const __dirname = dirname(fileURLToPath(import.meta.url))
+const args = process.argv.slice(2)
+const webCommands = new Set(["build", "start", "serve", "serve:inspect", "plugin", "plugins"])
 const platformScripts = {
     "setupEmulator:ios": "../dist/native/setupEmulatorIos.js",
     "setupEmulator:android": "../dist/native/androidSetup.js",
     "buildApp:ios": "../dist/native/buildAppIos.js",
     "buildApp:android": "../dist/native/buildAppAndroid.js",
 }
+const validCommands = new Set([...webCommands, "buildApp", "setupEmulator", ...Object.keys(platformScripts)])
+
+const scriptIndex = args.findIndex((arg) => validCommands.has(arg))
+const script = scriptIndex === -1 ? args[0] : args[scriptIndex]
+const nodeArgs = scriptIndex > 0 ? args.slice(0, scriptIndex) : []
+const scriptArgs = args.slice(scriptIndex + 1)
 
-// Helper to check if arg is a platform command
-const isPlatformCommand = (arg, prefix) => {
-    if (!arg.startsWith(`${prefix}:`)) return false
-    const platform = arg.split(":")[1]
-    return ["ios", "android"].includes(platform) || platform === undefined
+function handleProcessResult(result) {
+    if (result.signal) {
+        if (result.signal === "SIGKILL") {
+            console.error("The Catalyst process was terminated with SIGKILL.")
+        } else if (result.signal === "SIGTERM") {
+            console.error("The Catalyst process was terminated with SIGTERM.")
+        }
+        process.exit(1)
+    }
+    process.exit(result.status ?? 1)
 }
 
-// Helper function to run a platform command
-const runPlatformCommand = (baseCommand, platform) => {
-    const command = `${baseCommand}:${platform}`
-    const result = spawnSync(
+function runScript(relativePath, extraArgs = []) {
+    return spawnSync(
         process.execPath,
-        nodeArgs.concat(require.resolve(platformScripts[command])).concat(args.slice(scriptIndex + 1)),
-        { stdio: "inherit" }
+        [...nodeArgs, resolve(__dirname, relativePath), ...extraArgs, ...scriptArgs],
+        {
+            stdio: "inherit",
+        }
     )
-    return result
 }
 
-// Helper function to run commands for all platforms
-const runAllPlatforms = (baseCommand) => {
-    const platforms = ["ios", "android"]
-    for (const platform of platforms) {
-        const result = runPlatformCommand(baseCommand, platform)
-        if (result.status !== 0) {
-            handleProcessResult(result)
-            return
-        }
+function runPlatformCommand(command) {
+    return runScript(platformScripts[command])
+}
+
+if (script === "buildApp" || script === "setupEmulator") {
+    for (const platform of ["ios", "android"]) {
+        const result = runPlatformCommand(`${script}:${platform}`)
+        if (result.status !== 0 || result.signal) handleProcessResult(result)
     }
     process.exit(0)
 }
 
-const scriptIndex = args.findIndex(
-    (x) =>
-        x === "build" ||
-        x === "start" ||
-        x === "serve" ||
-        x === "devBuild" ||
-        x === "devServe" ||
-        x === "plugin" ||
-        x === "plugins" ||
-        isPlatformCommand(x, "buildApp") ||
-        isPlatformCommand(x, "setupEmulator")
-)
-const script = scriptIndex === -1 ? args[0] : args[scriptIndex]
-const nodeArgs = scriptIndex > 0 ? args.slice(0, scriptIndex) : []
-const resolvedScript = script === "plugin" ? "plugins" : script
-
-if (validCommands.includes(script)) {
-    // Handle platform-specific or combined commands
-    if (script === "buildApp" || script === "setupEmulator") {
-        // Run for all platforms if no specific platform is specified
-        runAllPlatforms(script)
-    } else if (script in platformScripts) {
-        // Run for specific platform
-        const result = spawnSync(
-            process.execPath,
-            nodeArgs.concat(require.resolve(platformScripts[script])).concat(args.slice(scriptIndex + 1)),
-            { stdio: "inherit" }
-        )
-        handleProcessResult(result)
-    } else {
-        // Original commands
-        const result = spawnSync(
-            process.execPath,
-            nodeArgs
-                .concat(require.resolve("../dist/scripts/" + resolvedScript))
-                .concat(args.slice(scriptIndex + 1)),
-            { stdio: "inherit" }
-        )
-        handleProcessResult(result)
-    }
-} else {
-    console.log('Unknown script "' + script + '".')
+if (platformScripts[script]) {
+    handleProcessResult(runPlatformCommand(script))
 }
 
-// Helper function to handle process results
-function handleProcessResult(result) {
-    if (result.signal) {
-        if (result.signal === "SIGKILL") {
-            console.log(
-                "The build failed because the process exited too early. " +
-                    "This probably means the system ran out of memory or someone called " +
-                    "`kill -9` on the process."
-            )
-        } else if (result.signal === "SIGTERM") {
-            console.log(
-                "The build failed because the process exited too early. " +
-                    "Someone might have called `kill` or `killall`, or the system could " +
-                    "be shutting down."
-            )
-        }
-        process.exit(1)
-    }
-    process.exit(result.status)
+if (webCommands.has(script)) {
+    const scriptName = script === "plugin" ? "plugins" : script === "serve:inspect" ? "serve" : script
+    const extraArgs = script === "serve:inspect" ? ["--inspect"] : []
+    handleProcessResult(runScript(`../dist/scripts/${scriptName}.js`, extraArgs))
 }
+
+console.error(`Unknown script "${script}".`)
+process.exit(1)

package/changelog.md

@@ -1,3 +1,11 @@
+# 1.0.0-beta.1
+
+- Replaced the Webpack build and SSR pipeline with Vite and ESM.
+- Added React 19 Suspense-aware routing, split components, and manifest-based asset loading.
+- Added opt-in request, compression, flush, and bot-aware OpenTelemetry spans.
+- Preserved native application builds, internal plugins, Sentry exports, and safe-area SSR hydration.
+- Removed the legacy `devBuild` and `devServe` commands.
+
 # Changelog
 
 ## [0.1.0-beta.2] - 2026-05-06

package/dist/caching.js

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:true});var _apiCaching=require("@tata1mg/api-caching");Object.keys(_apiCaching).forEach(function(key){if(key==="default"||key==="__esModule")return;if(key in exports&&exports[key]===_apiCaching[key])return;Object.defineProperty(exports,key,{enumerable:true,get:function(){return _apiCaching[key];}});});
+export * from "@tata1mg/api-caching"

package/dist/globals.d.ts

@@ -0,0 +1,7 @@
+// Injected by webpack DefinePlugin in base.babel.js at build time.
+// Reflects which @catalyst/* packages are present in the app's node_modules.
+declare const __CATALYST_PACKAGES__: {
+    readonly ai: boolean
+    readonly webAILocal: boolean
+    readonly nativeAILocal: boolean
+}

package/dist/index.jsx

@@ -0,0 +1,8 @@
+export * from "react-router-dom"
+export * from "./web-router/components/RouterDataProvider.jsx"
+export * from "./web-router/components/MetaTag.jsx"
+export { split, hydrationReady } from "./web-router/components/Split.jsx"
+export { split as default } from "./web-router/components/Split.jsx"
+export * from "./web-router/hooks.jsx"
+export * from "./web-router/utils/metaDataUtils.jsx"
+export * from "./server/renderer/document/index.jsx"

package/dist/logger.js

@@ -1,4 +1,10 @@
-"use strict";const pc=require("picocolors");const winston=require("winston");const DailyRotateFile=require("winston-daily-rotate-file");const{createLogger,format,transports}=winston;/**
+import pc from "picocolors"
+import winston from "winston"
+import DailyRotateFile from "winston-daily-rotate-file"
+
+const { createLogger, format, transports } = winston
+
+/**
  * @description Logger library with rotational strategy. Creates a logs folder in root.
  *              With debug, error and info log directories with their respective log files.
  *
@@ -6,5 +12,70 @@
  * @param config { @enableDebugLogs: Bool // default: true }
  * @returns loggerInstance
  *
- */const configureLogger=(config={})=>{const{enableDebugLogs=true,enableFileLogging=true,enableConsoleLogging=true}=config;const consoleTransport=new transports.Console({level:"debug"});const fileTransport=(type="info")=>{return new DailyRotateFile({filename:`${process.env.src_path}/logs/${type}/%DATE%.${type}.log`,datePattern:"YYYY-MM-DD",maxFiles:"3d",// Logs will be removed after 2days,
-loglevel:type,level:type});};const infoLogger=createLogger({format:format.combine(format.timestamp({format:"YYYY-MM-DD HH:mm:ss"}),format.json()),defaultMeta:{loglevel:"info"}});const debugLogger=createLogger({format:format.combine(format.timestamp({format:"YYYY-MM-DD HH:mm:ss"}),format.json()),defaultMeta:{loglevel:"debug"}});const errorLogger=createLogger({format:format.combine(format.timestamp({format:"YYYY-MM-DD HH:mm:ss"}),format.json()),defaultMeta:{loglevel:"error"}});if(enableConsoleLogging&&JSON.parse(enableConsoleLogging)){infoLogger.add(consoleTransport);debugLogger.add(consoleTransport);errorLogger.add(consoleTransport);}if(enableFileLogging&&JSON.parse(enableFileLogging)){infoLogger.add(fileTransport("info"));debugLogger.add(fileTransport("debug"));errorLogger.add(fileTransport("error"));}const Logger={debug:()=>{},error:msg=>{console.log(pc.red(pc.bold("ERROR: "+JSON.stringify(msg))));errorLogger.error(msg);},info:msg=>{console.log(pc.green(pc.bold("INFO: "+JSON.stringify(msg))));infoLogger.info(msg);}};if(enableDebugLogs&&JSON.parse(enableDebugLogs)){Logger.debug=msg=>{console.log(pc.yellow(pc.bold("DEBUG: "+JSON.stringify(msg))));debugLogger.debug(msg);};}if(global)global.logger=Logger;return Logger;};module.exports={configureLogger};
+ */
+const configureLogger = (config = {}) => {
+    const { enableDebugLogs = true, enableFileLogging = true, enableConsoleLogging = true } = config
+
+    const consoleTransport = new transports.Console({ level: "debug" })
+
+    const fileTransport = (type = "info") => {
+        return new DailyRotateFile({
+            filename: `${process.env.src_path}/logs/${type}/%DATE%.${type}.log`,
+            datePattern: "YYYY-MM-DD",
+            maxFiles: "3d", // Logs will be removed after 2days,
+            loglevel: type,
+            level: type,
+        })
+    }
+
+    const infoLogger = createLogger({
+        format: format.combine(format.timestamp({ format: "YYYY-MM-DD HH:mm:ss" }), format.json()),
+        defaultMeta: { loglevel: "info" },
+    })
+
+    const debugLogger = createLogger({
+        format: format.combine(format.timestamp({ format: "YYYY-MM-DD HH:mm:ss" }), format.json()),
+        defaultMeta: { loglevel: "debug" },
+    })
+
+    const errorLogger = createLogger({
+        format: format.combine(format.timestamp({ format: "YYYY-MM-DD HH:mm:ss" }), format.json()),
+        defaultMeta: { loglevel: "error" },
+    })
+
+    if (enableConsoleLogging && JSON.parse(enableConsoleLogging)) {
+        infoLogger.add(consoleTransport)
+        debugLogger.add(consoleTransport)
+        errorLogger.add(consoleTransport)
+    }
+
+    if (enableFileLogging && JSON.parse(enableFileLogging)) {
+        infoLogger.add(fileTransport("info"))
+        debugLogger.add(fileTransport("debug"))
+        errorLogger.add(fileTransport("error"))
+    }
+
+    const Logger = {
+        debug: () => {},
+        error: (msg) => {
+            console.log(pc.red(pc.bold("ERROR: " + JSON.stringify(msg))))
+            errorLogger.error(msg)
+        },
+        info: (msg) => {
+            console.log(pc.green(pc.bold("INFO: " + JSON.stringify(msg))))
+            infoLogger.info(msg)
+        },
+    }
+
+    if (enableDebugLogs && JSON.parse(enableDebugLogs)) {
+        Logger.debug = (msg) => {
+            console.log(pc.yellow(pc.bold("DEBUG: " + JSON.stringify(msg))))
+            debugLogger.debug(msg)
+        }
+    }
+
+    if (global) global.logger = Logger
+    return Logger
+}
+
+export { configureLogger }

package/dist/native/androidProject/app/build.gradle.kts

@@ -60,6 +60,22 @@ fun isNotificationsEnabled(): Boolean {
     }
 }
 
+fun isAIEnabled(): Boolean {
+    return try {
+        if (configPath == null) return false
+        val configFile = File(configPath!!)
+        if (!configFile.exists()) return false
+
+        val json = JSONObject(configFile.readText())
+        if (!json.has("WEBVIEW_CONFIG")) return false
+
+        val webviewConfig = json.getJSONObject("WEBVIEW_CONFIG")
+        webviewConfig.optJSONObject("ai")?.optBoolean("enabled", false) ?: false
+    } catch (e: Exception) {
+        false
+    }
+}
+
 fun getLocalIpAddress(): String {
     return NetworkInterface.getNetworkInterfaces().toList()
         .flatMap { it.inetAddresses.toList() }
@@ -151,6 +167,7 @@ android {
 
     kotlinOptions {
         jvmTarget = "11"
+        freeCompilerArgs += "-Xskip-metadata-version-check"
     }
 
     buildFeatures {
@@ -168,8 +185,9 @@ android {
             excludes.add("META-INF/io.netty.versions.properties")
         }
         jniLibs {
-            // Enable 16KB page size alignment for all native libraries
-            useLegacyPackaging = false
+            // libLiteRtClGlAccelerator.so must be extracted to disk for GPU dlopen().
+            // This must live in the app module — AGP ignores useLegacyPackaging in library modules.
+            useLegacyPackaging = isAIEnabled()
         }
     }
 
@@ -186,7 +204,7 @@ android {
         }
     }
 
-    // Conditional source sets based on notifications config
+    // Conditional source sets based on feature config
     sourceSets {
         getByName("main") {
             if (isNotificationsEnabled()) {
@@ -196,6 +214,20 @@ android {
                 logger.info("SourceSet selected: noFcm (notifications disabled)")
                 java.srcDirs("src/noFcm/java")
             }
+            // AI has no source-set swap — CatalystAIBridge self-registers via ServiceLoader
+            // when @catalyst/cloud-ai is on the classpath.
+        }
+    }
+}
+
+configurations.all {
+    resolutionStrategy.eachDependency {
+        if (requested.group == "org.jetbrains.kotlin" &&
+            (requested.name == "kotlin-stdlib" ||
+             requested.name == "kotlin-stdlib-jdk7" ||
+             requested.name == "kotlin-stdlib-jdk8" ||
+             requested.name == "kotlin-reflect")) {
+            useVersion("2.0.21")
         }
     }
 }
@@ -217,7 +249,16 @@ dependencies {
     implementation("io.ktor:ktor-server-core:3.0.3")
     implementation("io.ktor:ktor-server-netty:3.0.3")
     implementation("io.ktor:ktor-server-content-negotiation:3.0.3")
-    implementation("org.jetbrains.kotlinx:kotlinx-coroutines-android:1.7.3")
+    implementation("io.ktor:ktor-server-sse:3.0.3")
+    implementation("org.jetbrains.kotlinx:kotlinx-coroutines-android:1.9.0")
+
+    // Native AI — compileOnly always (for types), implementation only when ai.enabled=true (for runtime bundling)
+    if (project.findProject(":catalyst-cloud-ai") != null) {
+        compileOnly(project(":catalyst-cloud-ai"))
+        if (isAIEnabled()) {
+            implementation(project(":catalyst-cloud-ai"))
+        }
+    }
 
     // Security detection dependencies
     implementation("com.scottyab:rootbeer-lib:0.1.1")  // Root detection

package/dist/native/androidProject/app/src/main/java/io/yourname/androidproject/NativeBridge.kt

@@ -16,12 +16,15 @@ import androidx.credentials.exceptions.GetCredentialCancellationException
 import androidx.credentials.exceptions.GetCredentialException
 import com.google.android.libraries.identity.googleid.GetSignInWithGoogleOption
 import com.google.android.libraries.identity.googleid.GoogleIdTokenCredential
+// LiteRT imports removed — AI logic lives in catalyst-ai (CatalystAIBridge plugin)
 import io.yourname.androidproject.MainActivity
 import io.yourname.androidproject.utils.*
 import kotlinx.coroutines.*
 import org.json.JSONArray
 import org.json.JSONObject
+import java.io.File
 import java.util.Properties
+import java.util.ServiceLoader
 import java.util.concurrent.atomic.AtomicBoolean
 
 private data class FilePickerOptions(
@@ -151,6 +154,61 @@ class NativeBridge(
     
     private var networkMonitor: NetworkMonitor? = null
 
+    // AI plugin — loaded via reflection so NativeBridge.kt compiles with no compile-time dep on
+    // :catalyst-ai. When the module is absent the try block returns null gracefully.
+    private val aiBridge: Any? = try {
+        @Suppress("UNCHECKED_CAST")
+        run {
+            val bridgeClass = Class.forName("io.catalyst.nativeai.AIBridge")
+            val callbacksClass = Class.forName("io.catalyst.nativeai.AIBridgeCallbacks")
+            @Suppress("UNCHECKED_CAST")
+            val loader = ServiceLoader.load(bridgeClass as Class<Any>)
+            val bridge = loader.iterator().takeIf { it.hasNext() }?.next() ?: return@run null
+
+            val callbacksProxy = java.lang.reflect.Proxy.newProxyInstance(
+                bridgeClass.classLoader,
+                arrayOf(callbacksClass)
+            ) { _, method, args ->
+                val a = args ?: emptyArray()
+                when (method.name) {
+                    "onReady" -> {
+                        val payload = org.json.JSONObject().apply {
+                            put("url", a[0]); put("port", a[1]); put("sessionId", a[2])
+                        }
+                        BridgeUtils.notifyWebJson(webView, BridgeUtils.WebEvents.ON_AI_READY, payload)
+                    }
+                    "onProgress" -> {
+                        val payload = org.json.JSONObject().apply {
+                            put("phase", a[0]); put("percent", a[1])
+                            put("bytesLoaded", a[2]); put("bytesTotal", a[3]); put("detail", a[4])
+                        }
+                        BridgeUtils.notifyWebJson(webView, BridgeUtils.WebEvents.ON_AI_PROGRESS, payload)
+                    }
+                    "onLog" -> {
+                        val payload = org.json.JSONObject().apply { put("message", a[0]) }
+                        BridgeUtils.notifyWebJson(webView, BridgeUtils.WebEvents.ON_AI_LOG, payload)
+                    }
+                    "onError" -> BridgeUtils.notifyWebError(webView, BridgeUtils.WebEvents.ON_AI_ERROR, a[0] as String)
+                    "isFrameworkServerRunning" -> FrameworkServerUtils.isRunning()
+                    "getFrameworkServerPort" -> FrameworkServerUtils.getServerPort()
+                    "getFrameworkServerSessionId" -> FrameworkServerUtils.getSessionId()
+                    "setNativeAiSupplier" -> {
+                        @Suppress("UNCHECKED_CAST")
+                        FrameworkServerUtils.setNativeAiSupplier(
+                            a[0] as suspend (String, org.json.JSONObject, String?) -> Pair<String, kotlinx.coroutines.flow.Flow<String>>
+                        )
+                    }
+                    "setNativeSystemPrompt" -> FrameworkServerUtils.setNativeSystemPrompt(a[0] as String)
+                    else -> null
+                }
+            }
+
+            bridge.javaClass.getMethod("attach", android.app.Activity::class.java, android.webkit.WebView::class.java, callbacksClass)
+                .invoke(bridge, mainActivity, webView, callbacksProxy)
+            bridge
+        }
+    } catch (_: Throwable) { null }
+
     // Video stream manager
     private var nativeCameraManager: NativeCameraManager? = null
     private var webViewOriginalBackground: Int = android.graphics.Color.WHITE
@@ -1301,6 +1359,34 @@ class NativeBridge(
         }
     }
 
+    // -------------------------------------------------------------------------
+    // Native AI bridge methods — delegated to AIBridge plugin (ServiceLoader)
+    // -------------------------------------------------------------------------
+
+    @JavascriptInterface
+    fun isAIAvailable(): Boolean = aiBridge != null
+
+    @JavascriptInterface
+    fun initAI(optionsRaw: String?) {
+        BridgeUtils.safeExecute(webView, BridgeUtils.WebEvents.ON_AI_ERROR, "initialize AI") {
+            aiBridge?.javaClass?.getMethod("initAI", String::class.java)?.invoke(aiBridge, optionsRaw)
+        }
+    }
+
+    @JavascriptInterface
+    fun generateNative(optionsRaw: String?) {
+        BridgeUtils.safeExecute(webView, BridgeUtils.WebEvents.ON_AI_ERROR, "generate with native AI") {
+            aiBridge?.javaClass?.getMethod("generateNative", String::class.java)?.invoke(aiBridge, optionsRaw)
+        }
+    }
+
+    @JavascriptInterface
+    fun clearNativeConversation() {
+        BridgeUtils.safeExecute(webView, BridgeUtils.WebEvents.ON_AI_ERROR, "clear native conversation") {
+            aiBridge?.javaClass?.getMethod("clearConversation")?.invoke(aiBridge)
+        }
+    }
+
     /**
      * Cleanup method to be called when the bridge is being destroyed
      */

package/dist/native/androidProject/app/src/main/java/io/yourname/androidproject/utils/BridgeUtils.kt

@@ -97,6 +97,14 @@ object BridgeUtils {
         ON_TRANSITION_CANCELLED("ON_TRANSITION_CANCELLED"),
         ON_TRANSITION_TIMEOUT("ON_TRANSITION_TIMEOUT"),
 
+        // Native AI events
+        ON_AI_READY("ON_AI_READY"),
+        ON_AI_ERROR("ON_AI_ERROR"),
+        ON_AI_TOKEN("ON_AI_TOKEN"),
+        ON_AI_DONE("ON_AI_DONE"),
+        ON_AI_PROGRESS("ON_AI_PROGRESS"),
+        ON_AI_LOG("ON_AI_LOG"),
+
         // Perf telemetry
         CATALYST_PERF_EVENT("CATALYST_PERF_EVENT"),
     }