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

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

@@ -0,0 +1,289 @@
+package io.yourname.androidproject.utils
+
+import android.os.Handler
+import android.os.Looper
+import android.os.SystemClock
+import android.webkit.WebView
+import io.yourname.androidproject.BuildConfig
+import org.json.JSONArray
+import org.json.JSONObject
+import java.util.concurrent.ConcurrentLinkedQueue
+import java.util.concurrent.atomic.AtomicBoolean
+
+/**
+ * PerfEventBuffer — native ring buffer for Catalyst profiler events.
+ *
+ * Collects all events from onCreate (boot timing, cache, API calls) and flushes
+ * them as a single JSON array to the web layer after onPageFinished.
+ *
+ * Design:
+ *   - add() is safe from any thread (ConcurrentLinkedQueue)
+ *   - scheduleFlush() called from onPageFinished — posts to main thread after 250ms
+ *     so the JS environment is ready to receive events
+ *   - flush() serialises all events to JSON array, calls window.__catalystPerfBatch()
+ *   - CacheSummarizer: running tally of hit/miss/fetch + top-5 min-heap for InsightsCollector
+ *   - Max ring buffer size: 500 events (oldest dropped if exceeded)
+ *
+ * API call timing:
+ *   - bridgeCallReceived(callId, method) → stamps t0, stores in pendingCalls map
+ *   - bridgeCallDispatched(callId) → stamps t1, computes durationMs, adds api-call event to buffer
+ */
+object PerfEventBuffer {
+
+    private const val TAG = "PerfEventBuffer"
+    private const val MAX_BUFFER_SIZE = 500
+    private const val FLUSH_DELAY_MS = 250L
+    private const val FLUSH_RETRY_DELAY_MS = 250L
+    private const val MAX_FLUSH_RETRIES = 5
+    private const val PERIODIC_FLUSH_INTERVAL_MS = 4000L
+
+    private val buffer = ConcurrentLinkedQueue<JSONObject>()
+    private val mainHandler = Handler(Looper.getMainLooper())
+    private val flushed = AtomicBoolean(false)
+    @Volatile private var profilerEnabled = false
+    private val deliveryState = PerfDeliveryState<JSONArray>()
+
+    // Periodic flush state
+    @Volatile private var periodicWebView: WebView? = null
+    private var lastFlushedSize = 0
+    private val periodicRunnable: Runnable = object : Runnable {
+        override fun run() {
+            if (!isEnabled()) return
+            val wv = periodicWebView ?: return
+            val pendingBatch = deliveryState.current()
+            if (pendingBatch != null) {
+                deliver(wv, pendingBatch)
+            } else if (buffer.size > lastFlushedSize) {
+                val currentSize = buffer.size
+                android.util.Log.d(TAG, "[PerfBuffer] periodicFlush() — $currentSize events since last flush")
+                beginFlush(wv, includeCacheSummary = false)
+            }
+            mainHandler.postDelayed(this, PERIODIC_FLUSH_INTERVAL_MS)
+        }
+    }
+
+    // Pending API call timing: callId → t0 nativeMs + method
+    private val pendingCalls = java.util.concurrent.ConcurrentHashMap<String, Pair<Long, String>>()
+
+    // ─── CacheSummarizer ─────────────────────────────────────────────────────
+
+    private var cacheHits   = 0
+    private var cacheMisses = 0
+    private var cacheFetches = 0
+    private var cacheTotalMs = 0L
+    // top-5 slowest: list of Pair(durationMs, filename)
+    private val cacheTopSlow = java.util.PriorityQueue<Pair<Long, String>>(
+        6, compareBy { it.first }
+    )
+
+    private fun updateCacheSummary(type: String, durationMs: Long, url: String) {
+        val filename = try {
+            val path = java.net.URI(url).path
+            path.split("/").filter { it.isNotEmpty() }.lastOrNull()?.take(40) ?: url.take(40)
+        } catch (e: Exception) { url.take(40) }
+
+        when (type) {
+            "cache-hit-memory", "cache-hit-disk" -> cacheHits++
+            "cache-miss-fetch"                   -> cacheMisses++
+            "network-fetch-complete"             -> {
+                cacheFetches++
+                cacheTotalMs += durationMs
+                cacheTopSlow.add(Pair(durationMs, filename))
+                if (cacheTopSlow.size > 5) cacheTopSlow.poll() // remove smallest
+            }
+        }
+    }
+
+    private fun buildCacheSummaryEvent(): JSONObject? {
+        val total = cacheHits + cacheMisses
+        if (total == 0) return null
+        val hitRate = if (total > 0) (cacheHits * 100.0 / total) else 0.0
+        val avgFetchMs = if (cacheFetches > 0) cacheTotalMs / cacheFetches else 0L
+        val topSlow = JSONArray()
+        cacheTopSlow.sortedByDescending { it.first }.forEach { (ms, name) ->
+            topSlow.put(JSONObject().apply {
+                put("filename", name)
+                put("durationMs", ms)
+            })
+        }
+        return JSONObject().apply {
+            put("type", "cache-summary")
+            put("hits", cacheHits)
+            put("misses", cacheMisses)
+            put("fetches", cacheFetches)
+            put("total", total)
+            put("hitRatePct", Math.round(hitRate * 10) / 10.0)
+            put("avgFetchMs", avgFetchMs)
+            put("topSlowest", topSlow)
+            put("nativeTime", SystemClock.elapsedRealtime())
+        }
+    }
+
+    // ─── Public API ──────────────────────────────────────────────────────────
+
+    fun configure(enabled: Boolean) {
+        profilerEnabled = BuildConfig.DEBUG && enabled
+        if (!profilerEnabled) reset()
+    }
+
+    fun isEnabled(): Boolean = profilerEnabled
+
+    /** Add a perf event to the buffer. Safe from any thread. */
+    fun add(event: JSONObject) {
+        if (!isEnabled()) return
+        if (buffer.size >= MAX_BUFFER_SIZE) {
+            buffer.poll() // drop oldest
+        }
+        // Update cache summary tally
+        val type = event.optString("type")
+        if (type.startsWith("cache-") || type == "network-fetch-complete") {
+            updateCacheSummary(type, event.optLong("durationMs", 0), event.optString("url"))
+        }
+        buffer.add(event)
+        android.util.Log.d(TAG, "[PerfBuffer] add() type=$type bufferSize=${buffer.size}")
+    }
+
+    /**
+     * Record start of an @JavascriptInterface bridge call.
+     * Call this immediately when the method is invoked on the JavascriptInterface.
+     */
+    fun bridgeCallReceived(callId: String, method: String) {
+        if (!isEnabled()) return
+        pendingCalls[callId] = Pair(SystemClock.elapsedRealtime(), method)
+    }
+
+    /**
+     * Record the end of immediate native bridge-handler work and add an api-call event.
+     */
+    fun bridgeCallDispatched(callId: String) {
+        if (!isEnabled()) return
+        val pending = pendingCalls.remove(callId) ?: return
+        val (t0, method) = pending
+        val t1 = SystemClock.elapsedRealtime()
+        val durationMs = t1 - t0
+        add(JSONObject().apply {
+            put("type", "api-call")
+            put("callId", callId)
+            put("method", method)
+            put("nativeStartMs", t0)
+            put("nativeEndMs", t1)
+            put("durationMs", durationMs)
+            put("thread", Thread.currentThread().name)
+        })
+    }
+
+    /**
+     * Schedule a flush after onPageFinished (initial/full page load).
+     * Also starts the periodic flush loop for subsequent SPA navigations.
+     */
+    fun scheduleFlush(webView: WebView) {
+        if (!isEnabled()) return
+        if (flushed.getAndSet(true)) {
+            android.util.Log.d(TAG, "[PerfBuffer] scheduleFlush() skipped — already flushed")
+            return
+        }
+        android.util.Log.d(TAG, "[PerfBuffer] scheduleFlush() scheduled in ${FLUSH_DELAY_MS}ms, bufferSize=${buffer.size}")
+        mainHandler.postDelayed({
+            beginFlush(webView, includeCacheSummary = true)
+            // Start periodic flush loop for SPA navigations after initial load
+            startPeriodicFlush(webView)
+        }, FLUSH_DELAY_MS)
+    }
+
+    /**
+     * Flush any pending events immediately (e.g. before a full URL navigation).
+     * Does NOT reset the buffer — only drains buffered events up to this point.
+     */
+    fun flushNow(webView: WebView) {
+        if (!isEnabled()) return
+        mainHandler.post { beginFlush(webView, includeCacheSummary = false) }
+    }
+
+    /**
+     * Start periodic flush loop — fires every 4s and flushes only if new events exist.
+     * Call after onPageFinished so the JS receiver is registered.
+     */
+    fun startPeriodicFlush(webView: WebView) {
+        if (!isEnabled()) return
+        mainHandler.removeCallbacks(periodicRunnable)
+        periodicWebView = webView
+        lastFlushedSize = 0
+        mainHandler.postDelayed(periodicRunnable, PERIODIC_FLUSH_INTERVAL_MS)
+        android.util.Log.d(TAG, "[PerfBuffer] startPeriodicFlush() — interval=${PERIODIC_FLUSH_INTERVAL_MS}ms")
+    }
+
+    /** Stop periodic flush (call on destroy / loadUrl reset). */
+    fun stopPeriodicFlush() {
+        mainHandler.removeCallbacks(periodicRunnable)
+        periodicWebView = null
+    }
+
+    /**
+     * Reset the buffer for the next page load.
+     * Call this from loadUrl so boot timing events for the new page are captured.
+     */
+    fun reset() {
+        stopPeriodicFlush()
+        buffer.clear()
+        deliveryState.reset()
+        pendingCalls.clear()
+        flushed.set(false)
+        lastFlushedSize = 0
+        cacheHits = 0
+        cacheMisses = 0
+        cacheFetches = 0
+        cacheTotalMs = 0L
+        cacheTopSlow.clear()
+    }
+
+    // ─── Flush ───────────────────────────────────────────────────────────────
+
+    /** Moves the current queue into an immutable in-flight batch until JS acknowledges it. */
+    private fun beginFlush(webView: WebView, includeCacheSummary: Boolean) {
+        if (!isEnabled()) return
+        if (Looper.myLooper() != Looper.getMainLooper()) {
+            mainHandler.post { beginFlush(webView, includeCacheSummary) }
+            return
+        }
+        if (deliveryState.hasInFlight()) return
+        val events = JSONArray()
+        while (buffer.isNotEmpty()) {
+            buffer.poll()?.let { events.put(it) }
+        }
+        if (includeCacheSummary) buildCacheSummaryEvent()?.let { events.put(it) }
+        if (events.length() == 0) return
+
+        val batch = deliveryState.begin(events) ?: return
+        deliver(webView, batch)
+    }
+
+    private fun deliver(webView: WebView, batch: PerfDeliveryState.Batch<JSONArray>) {
+        if (!isEnabled() || !deliveryState.isCurrent(batch)) return
+        try {
+            val json = batch.payload.toString().replace("\\", "\\\\").replace("'", "\\'")
+            val batchId = JSONObject.quote(batch.id)
+            webView.evaluateJavascript(
+                "window.__catalystPerfBatch ? window.__catalystPerfBatch($batchId, '$json') : false",
+            ) { result ->
+                if (result == "true") acknowledge(batch) else retry(webView, batch)
+            }
+        } catch (_: Exception) {
+            retry(webView, batch)
+        }
+    }
+
+    private fun acknowledge(batch: PerfDeliveryState.Batch<JSONArray>) {
+        if (deliveryState.acknowledge(batch)) {
+            lastFlushedSize = 0
+        }
+    }
+
+    private fun retry(webView: WebView, batch: PerfDeliveryState.Batch<JSONArray>) {
+        val retry = deliveryState.retry(batch, MAX_FLUSH_RETRIES)
+        if (retry == null) {
+            android.util.Log.w(TAG, "[PerfBuffer] batch ${batch.id} was not acknowledged; retaining until reset")
+            return
+        }
+        mainHandler.postDelayed({ deliver(webView, retry) }, FLUSH_RETRY_DELAY_MS)
+    }
+}

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

@@ -0,0 +1,13 @@
+package io.yourname.androidproject.utils
+
+internal class ProfilerNavigationState {
+    private var isInitialNavigation = true
+
+    data class Navigation(val url: String, val shouldReset: Boolean)
+
+    fun begin(url: String): Navigation {
+        val shouldReset = !isInitialNavigation
+        isInitialNavigation = false
+        return Navigation(url, shouldReset)
+    }
+}

package/dist/native/androidProject/app/src/test/java/io/yourname/androidproject/ProfilerLifecycleTest.kt

@@ -0,0 +1,51 @@
+package io.yourname.androidproject
+
+import io.yourname.androidproject.utils.PerfDeliveryState
+import io.yourname.androidproject.utils.ProfilerNavigationState
+import org.junit.Assert.assertEquals
+import org.junit.Assert.assertFalse
+import org.junit.Assert.assertNotNull
+import org.junit.Assert.assertNull
+import org.junit.Assert.assertTrue
+import org.junit.Test
+
+class ProfilerLifecycleTest {
+    @Test
+    fun `offline startup and retry navigation record separate page lifecycles`() {
+        val state = ProfilerNavigationState()
+        val offlineStart = state.begin("file:///android_asset/offline/offline.html")
+        val retry = state.begin("https://example.com")
+
+        assertFalse(offlineStart.shouldReset)
+        assertEquals("file:///android_asset/offline/offline.html", offlineStart.url)
+        assertTrue(retry.shouldReset)
+        assertEquals("https://example.com", retry.url)
+    }
+
+    @Test
+    fun `batch remains in flight until acknowledged and retries retain its id`() {
+        val state = PerfDeliveryState<List<String>>()
+        val batch = state.begin(listOf("boot-activity-created"))
+
+        assertNotNull(batch)
+        assertNull(state.begin(listOf("boot-page-started")))
+
+        val retry = state.retry(batch!!, maxRetries = 2)
+        assertNotNull(retry)
+        assertEquals(batch.id, retry!!.id)
+        assertEquals(1, retry.retryCount)
+        assertTrue(state.acknowledge(retry))
+        assertNotNull(state.begin(listOf("boot-page-started")))
+    }
+
+    @Test
+    fun `reset invalidates stale delivery callbacks`() {
+        val state = PerfDeliveryState<List<String>>()
+        val batch = state.begin(listOf("boot-load-url"))!!
+
+        state.reset()
+
+        assertFalse(state.acknowledge(batch))
+        assertNull(state.retry(batch, maxRetries = 2))
+    }
+}

package/dist/native/androidSetup.js

@@ -1,9 +1,301 @@
-"use strict";var _fs=_interopRequireDefault(require("fs"));var _path=_interopRequireDefault(require("path"));var _child_process=require("child_process");var _utils=require("./utils.js");var _TerminalProgress=_interopRequireDefault(require("./TerminalProgress.js"));var _setupServer=require("./setupServer.js");function _interopRequireDefault(e){return e&&e.__esModule?e:{default:e};}const catalystCorePath=_path.default.dirname(require.resolve("catalyst-core/package.json"));const pwd=_path.default.join(catalystCorePath,"dist/native");const configPath=`${process.env.PWD}/config/config.json`;const steps={java:"Check Java Environment",config:"Initialize Configuration",androidTools:"Validate Android Tools",emulator:"Configure Android Emulator",properties:"Update Local Properties",saveConfig:"Save Configuration",setupServer:"Setup Server"};const progressPaddingConfig={titlePaddingTop:2,titlePaddingBottom:1,stepPaddingLeft:4,stepSpacing:1,errorPaddingLeft:6,bottomMargin:2};const progress=new _TerminalProgress.default(steps,"Catalyst Universal Android Setup",progressPaddingConfig);async function checkJavaInstallation(){try{(0,_utils.runCommand)("java -version");(0,_utils.runCommand)("javac -version");progress.log("Java is installed and configured","success");return true;}catch(error){progress.log("Java installation not found or not properly configured","error");return false;}}async function installJava(){progress.log("Installing Java (Zulu JDK 17)...");try{try{(0,_utils.runCommand)("brew --version");}catch(error){throw new Error("Homebrew is required but not installed. Please install Homebrew first.");}const javaHome="/Library/Java/JavaVirtualMachines/zulu-17.jdk/Contents/Home";// Try installing Java
-try{await(0,_utils.runCommand)("brew install --cask zulu@17");}catch(error){if(error.message.includes("already installed")){progress.log("Attempting to reinstall Java...","info");try{await(0,_utils.runCommand)("brew reinstall --cask zulu@17");}catch(reinstallError){throw new Error(`Failed to reinstall Java: ${reinstallError.message}. Please run 'brew reinstall --cask zulu@17' manually.`);}}else{throw error;}}// Verify Java installation
-if(!_fs.default.existsSync(javaHome)){throw new Error(`Java installation not found at ${javaHome}. Please verify the installation manually.`);}// Set up environment variables
-const homeDir=process.env.HOME;const shellProfile=`${homeDir}/.zshrc`;const exportCommand=`\n# Java Configuration\nexport JAVA_HOME=${javaHome}\nexport PATH=$JAVA_HOME/bin:$PATH\n`;try{_fs.default.appendFileSync(shellProfile,exportCommand);}catch(error){throw new Error(`Failed to update ${shellProfile}: ${error.message}. Please add the following lines manually:\n${exportCommand}`);}// Set for current process
-process.env.JAVA_HOME=javaHome;process.env.PATH=`${javaHome}/bin:${process.env.PATH}`;// Verify Java configuration
-try{const javaVersion=(0,_utils.runCommand)("java -version");progress.log("Java installed and configured successfully","success");progress.log(`Java Version: ${javaVersion}`,"info");progress.log(`IMPORTANT: Please run the following commands to complete setup:`,"warning");progress.log(`1. source ${shellProfile}`,"info");progress.log(`2. echo $JAVA_HOME`,"info");return true;}catch(error){throw new Error(`Java installation verified but environment not configured. Please run:\n1. source ${shellProfile}\n2. echo $JAVA_HOME`);}}catch(error){progress.log(error.message,"error");progress.log("Manual Setup Instructions:","info");progress.log("1. Run: brew reinstall --cask zulu@17","info");progress.log("2. Add to ~/.zshrc:","info");progress.log("   export JAVA_HOME=/Library/Java/JavaVirtualMachines/zulu-17.jdk/Contents/Home","info");progress.log("   export PATH=$JAVA_HOME/bin:$PATH","info");progress.log("3. Run: source ~/.zshrc","info");throw error;}}async function validateJavaEnvironment(){progress.start("java");const hasJava=await checkJavaInstallation();if(!hasJava){progress.log("Java installation required. Starting installation process...");const javaInstalled=await installJava();if(!javaInstalled){progress.fail("java","Failed to set up Java environment");throw new Error("Failed to set up Java environment");}}progress.complete("java");}async function initializeConfig(){const configFile=_fs.default.readFileSync(configPath,"utf8");const config=JSON.parse(configFile);const{WEBVIEW_CONFIG}=config;if(!WEBVIEW_CONFIG||Object.keys(WEBVIEW_CONFIG).length===0){progress.log("WebView Config missing in "+configPath,"error");process.exit(1);}if(!WEBVIEW_CONFIG.android){WEBVIEW_CONFIG.android={};}return{WEBVIEW_CONFIG};}async function saveConfig(newConfig){try{const existingConfigFile=_fs.default.readFileSync(configPath,"utf8");const existingConfig=JSON.parse(existingConfigFile);const updatedConfig={...existingConfig,WEBVIEW_CONFIG:{...existingConfig.WEBVIEW_CONFIG,android:newConfig.WEBVIEW_CONFIG.android}};_fs.default.writeFileSync(configPath,JSON.stringify(updatedConfig,null,2));progress.log("Configuration saved successfully","success");}catch(error){progress.log("Failed to save configuration: "+error.message,"error");process.exit(1);}}function validateAndroidTools(androidConfig){const ANDROID_SDK=androidConfig.sdkPath;const EMULATOR_PATH=`${ANDROID_SDK}/emulator/emulator`;const ADB_PATH=`${ANDROID_SDK}/platform-tools/adb`;if(!ANDROID_SDK){throw new Error("Android SDK path is not configured");}if(!_fs.default.existsSync(ANDROID_SDK)){throw new Error(`Android SDK path does not exist: ${ANDROID_SDK}`);}if(!_fs.default.existsSync(ADB_PATH)){throw new Error(`ADB not found at: ${ADB_PATH}`);}try{(0,_utils.runCommand)(`${ADB_PATH} version`);progress.log("ADB is valid","success");}catch(error){throw new Error(`ADB is not working properly: ${error.message}`);}if(!_fs.default.existsSync(EMULATOR_PATH)){throw new Error(`Emulator not found at: ${EMULATOR_PATH}`);}try{(0,_utils.runCommand)(`${EMULATOR_PATH} -version`);progress.log("Emulator is valid","success");}catch(error){throw new Error(`Emulator is not working properly: ${error.message}`);}try{const avdOutput=(0,_utils.runCommand)(`${EMULATOR_PATH} -list-avds`);if(!avdOutput.includes(androidConfig.emulatorName)){throw new Error(`Specified emulator "${androidConfig.emulatorName}" not found in available AVDs`);}progress.log(`Emulator "${androidConfig.emulatorName}" exists`,"success");}catch(error){throw new Error(`Error checking emulator AVD: ${error.message}`);}progress.log("Android tools validation completed successfully!","success");return{EMULATOR_PATH,ADB_PATH};}async function checkEmulator(ADB_PATH){try{const devices=(0,_utils.runCommand)(`${ADB_PATH} devices`);return devices.includes("emulator");}catch(error){progress.log(`Error checking emulator: ${error}`,"error");return false;}}async function startEmulator(EMULATOR_PATH,androidConfig){progress.log(`Starting emulator: ${androidConfig.emulatorName}...`);// eslint-disable-next-line security/detect-child-process
-// nosemgrep: javascript.lang.security.detect-child-process.detect-child-process - EMULATOR_PATH is derived from SDK configuration and emulatorName is local native setup config.
-(0,_child_process.exec)(`${EMULATOR_PATH} -avd ${androidConfig.emulatorName} -read-only > /dev/null &`,error=>{if(error){progress.log(`Error starting emulator: ${error}`,"error");}});}async function updateLocalProperties(sdkPath){progress.start("properties");try{(0,_utils.runCommand)(`cd ${pwd}/androidProject && ./gradlew updateSdkPath -PsdkPath="${sdkPath}"`);progress.log("Updated local.properties successfully","success");progress.complete("properties");}catch(error){progress.fail("properties",`Failed to update local.properties: ${error.message}`);throw error;}}async function setupAndroidEnvironment(){try{await validateJavaEnvironment();progress.start("config");await initializeConfig();const config=await(0,_utils.validateAndCompleteConfig)("android",configPath);progress.complete("config");progress.start("androidTools");const{EMULATOR_PATH,ADB_PATH}=validateAndroidTools(config.android);progress.complete("androidTools");progress.start("emulator");const emulatorRunning=await checkEmulator(ADB_PATH);if(!emulatorRunning){progress.log("No emulator running, attempting to start one...");await startEmulator(EMULATOR_PATH,config.android);}else{progress.log("Emulator already running, proceeding with installation...","success");}progress.complete("emulator");if(config.android?.sdkPath){await updateLocalProperties(config.android.sdkPath);}progress.start("saveConfig");await saveConfig({WEBVIEW_CONFIG:config});progress.complete("saveConfig");progress.start("setupServer");await(0,_setupServer.setupServer)(configPath);progress.complete("setupServer");progress.printTreeContent("Configuration Explanation",["WEBVIEW_CONFIG: Main configuration object for the WebView setup",{text:"port: Port number for the WebView server",indent:1,prefix:"├─ ",color:"gray"},{text:"android: Android-specific configuration",indent:1,prefix:"└─ ",color:"gray"},{text:"buildType: Build type (debug/release)",indent:2,prefix:"├─ ",color:"gray"},{text:"sdkPath: Android SDK path",indent:2,prefix:"├─ ",color:"gray"},{text:"emulatorName: Selected Android emulator name",indent:2,prefix:"└─ ",color:"gray"}]);progress.printTreeContent("Final Configuration",[JSON.stringify(config,null,2)]);process.exit(0);}catch(error){if(progress.currentStep){progress.fail(progress.currentStep.id,error.message);}process.exit(1);}}// Execute the main setup
+"use strict";
+
+var _fs = _interopRequireDefault(require("fs"));
+var _path = _interopRequireDefault(require("path"));
+var _child_process = require("child_process");
+var _utils = require("./utils.js");
+var _TerminalProgress = _interopRequireDefault(require("./TerminalProgress.js"));
+var _setupServer = require("./setupServer.js");
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+const catalystCorePath = _path.default.dirname(require.resolve("catalyst-core/package.json"));
+const pwd = _path.default.join(catalystCorePath, "dist/native");
+const configPath = `${process.env.PWD}/config/config.json`;
+const steps = {
+  java: "Check Java Environment",
+  config: "Initialize Configuration",
+  androidTools: "Validate Android Tools",
+  emulator: "Configure Android Emulator",
+  properties: "Update Local Properties",
+  saveConfig: "Save Configuration",
+  setupServer: "Setup Server"
+};
+const progressPaddingConfig = {
+  titlePaddingTop: 2,
+  titlePaddingBottom: 1,
+  stepPaddingLeft: 4,
+  stepSpacing: 1,
+  errorPaddingLeft: 6,
+  bottomMargin: 2
+};
+const progress = new _TerminalProgress.default(steps, "Catalyst Universal Android Setup", progressPaddingConfig);
+async function checkJavaInstallation() {
+  try {
+    (0, _utils.runCommand)("java -version");
+    (0, _utils.runCommand)("javac -version");
+    progress.log("Java is installed and configured", "success");
+    return true;
+  } catch (error) {
+    progress.log("Java installation not found or not properly configured", "error");
+    return false;
+  }
+}
+async function installJava() {
+  progress.log("Installing Java (Zulu JDK 17)...");
+  try {
+    try {
+      (0, _utils.runCommand)("brew --version");
+    } catch (error) {
+      throw new Error("Homebrew is required but not installed. Please install Homebrew first.");
+    }
+    const javaHome = "/Library/Java/JavaVirtualMachines/zulu-17.jdk/Contents/Home";
+
+    // Try installing Java
+    try {
+      await (0, _utils.runCommand)("brew install --cask zulu@17");
+    } catch (error) {
+      if (error.message.includes("already installed")) {
+        progress.log("Attempting to reinstall Java...", "info");
+        try {
+          await (0, _utils.runCommand)("brew reinstall --cask zulu@17");
+        } catch (reinstallError) {
+          throw new Error(`Failed to reinstall Java: ${reinstallError.message}. Please run 'brew reinstall --cask zulu@17' manually.`);
+        }
+      } else {
+        throw error;
+      }
+    }
+
+    // Verify Java installation
+    if (!_fs.default.existsSync(javaHome)) {
+      throw new Error(`Java installation not found at ${javaHome}. Please verify the installation manually.`);
+    }
+
+    // Set up environment variables
+    const homeDir = process.env.HOME;
+    const shellProfile = `${homeDir}/.zshrc`;
+    const exportCommand = `\n# Java Configuration\nexport JAVA_HOME=${javaHome}\nexport PATH=$JAVA_HOME/bin:$PATH\n`;
+    try {
+      _fs.default.appendFileSync(shellProfile, exportCommand);
+    } catch (error) {
+      throw new Error(`Failed to update ${shellProfile}: ${error.message}. Please add the following lines manually:\n${exportCommand}`);
+    }
+
+    // Set for current process
+    process.env.JAVA_HOME = javaHome;
+    process.env.PATH = `${javaHome}/bin:${process.env.PATH}`;
+
+    // Verify Java configuration
+    try {
+      const javaVersion = (0, _utils.runCommand)("java -version");
+      progress.log("Java installed and configured successfully", "success");
+      progress.log(`Java Version: ${javaVersion}`, "info");
+      progress.log(`IMPORTANT: Please run the following commands to complete setup:`, "warning");
+      progress.log(`1. source ${shellProfile}`, "info");
+      progress.log(`2. echo $JAVA_HOME`, "info");
+      return true;
+    } catch (error) {
+      throw new Error(`Java installation verified but environment not configured. Please run:\n1. source ${shellProfile}\n2. echo $JAVA_HOME`);
+    }
+  } catch (error) {
+    progress.log(error.message, "error");
+    progress.log("Manual Setup Instructions:", "info");
+    progress.log("1. Run: brew reinstall --cask zulu@17", "info");
+    progress.log("2. Add to ~/.zshrc:", "info");
+    progress.log("   export JAVA_HOME=/Library/Java/JavaVirtualMachines/zulu-17.jdk/Contents/Home", "info");
+    progress.log("   export PATH=$JAVA_HOME/bin:$PATH", "info");
+    progress.log("3. Run: source ~/.zshrc", "info");
+    throw error;
+  }
+}
+async function validateJavaEnvironment() {
+  progress.start("java");
+  const hasJava = await checkJavaInstallation();
+  if (!hasJava) {
+    progress.log("Java installation required. Starting installation process...");
+    const javaInstalled = await installJava();
+    if (!javaInstalled) {
+      progress.fail("java", "Failed to set up Java environment");
+      throw new Error("Failed to set up Java environment");
+    }
+  }
+  progress.complete("java");
+}
+async function initializeConfig() {
+  const configFile = _fs.default.readFileSync(configPath, "utf8");
+  const config = JSON.parse(configFile);
+  const {
+    WEBVIEW_CONFIG
+  } = config;
+  if (!WEBVIEW_CONFIG || Object.keys(WEBVIEW_CONFIG).length === 0) {
+    progress.log("WebView Config missing in " + configPath, "error");
+    process.exit(1);
+  }
+  if (!WEBVIEW_CONFIG.android) {
+    WEBVIEW_CONFIG.android = {};
+  }
+  return {
+    WEBVIEW_CONFIG
+  };
+}
+async function saveConfig(newConfig) {
+  try {
+    const existingConfigFile = _fs.default.readFileSync(configPath, "utf8");
+    const existingConfig = JSON.parse(existingConfigFile);
+    const updatedConfig = {
+      ...existingConfig,
+      WEBVIEW_CONFIG: {
+        ...existingConfig.WEBVIEW_CONFIG,
+        android: newConfig.WEBVIEW_CONFIG.android
+      }
+    };
+    _fs.default.writeFileSync(configPath, JSON.stringify(updatedConfig, null, 2));
+    progress.log("Configuration saved successfully", "success");
+  } catch (error) {
+    progress.log("Failed to save configuration: " + error.message, "error");
+    process.exit(1);
+  }
+}
+function validateAndroidTools(androidConfig) {
+  const ANDROID_SDK = androidConfig.sdkPath;
+  const EMULATOR_PATH = `${ANDROID_SDK}/emulator/emulator`;
+  const ADB_PATH = `${ANDROID_SDK}/platform-tools/adb`;
+  if (!ANDROID_SDK) {
+    throw new Error("Android SDK path is not configured");
+  }
+  if (!_fs.default.existsSync(ANDROID_SDK)) {
+    throw new Error(`Android SDK path does not exist: ${ANDROID_SDK}`);
+  }
+  if (!_fs.default.existsSync(ADB_PATH)) {
+    throw new Error(`ADB not found at: ${ADB_PATH}`);
+  }
+  try {
+    (0, _utils.runCommand)(`${ADB_PATH} version`);
+    progress.log("ADB is valid", "success");
+  } catch (error) {
+    throw new Error(`ADB is not working properly: ${error.message}`);
+  }
+  if (!_fs.default.existsSync(EMULATOR_PATH)) {
+    throw new Error(`Emulator not found at: ${EMULATOR_PATH}`);
+  }
+  try {
+    (0, _utils.runCommand)(`${EMULATOR_PATH} -version`);
+    progress.log("Emulator is valid", "success");
+  } catch (error) {
+    throw new Error(`Emulator is not working properly: ${error.message}`);
+  }
+  try {
+    const avdOutput = (0, _utils.runCommand)(`${EMULATOR_PATH} -list-avds`);
+    if (!avdOutput.includes(androidConfig.emulatorName)) {
+      throw new Error(`Specified emulator "${androidConfig.emulatorName}" not found in available AVDs`);
+    }
+    progress.log(`Emulator "${androidConfig.emulatorName}" exists`, "success");
+  } catch (error) {
+    throw new Error(`Error checking emulator AVD: ${error.message}`);
+  }
+  progress.log("Android tools validation completed successfully!", "success");
+  return {
+    EMULATOR_PATH,
+    ADB_PATH
+  };
+}
+async function checkEmulator(ADB_PATH) {
+  try {
+    const devices = (0, _utils.runCommand)(`${ADB_PATH} devices`);
+    return devices.includes("emulator");
+  } catch (error) {
+    progress.log(`Error checking emulator: ${error}`, "error");
+    return false;
+  }
+}
+async function startEmulator(EMULATOR_PATH, androidConfig) {
+  progress.log(`Starting emulator: ${androidConfig.emulatorName}...`);
+  // nosemgrep: javascript.lang.security.detect-child-process.detect-child-process - EMULATOR_PATH is derived from SDK configuration and emulatorName is local native setup config.
+  // eslint-disable-next-line security/detect-child-process
+  (0, _child_process.exec)(`${EMULATOR_PATH} -avd ${androidConfig.emulatorName} -read-only > /dev/null &`, error => {
+    if (error) {
+      progress.log(`Error starting emulator: ${error}`, "error");
+    }
+  });
+}
+async function updateLocalProperties(sdkPath) {
+  progress.start("properties");
+  try {
+    (0, _utils.runCommand)(`cd ${pwd}/androidProject && ./gradlew updateSdkPath -PsdkPath="${sdkPath}"`);
+    progress.log("Updated local.properties successfully", "success");
+    progress.complete("properties");
+  } catch (error) {
+    progress.fail("properties", `Failed to update local.properties: ${error.message}`);
+    throw error;
+  }
+}
+async function setupAndroidEnvironment() {
+  try {
+    await validateJavaEnvironment();
+    progress.start("config");
+    await initializeConfig();
+    const config = await (0, _utils.validateAndCompleteConfig)("android", configPath);
+    progress.complete("config");
+    progress.start("androidTools");
+    const {
+      EMULATOR_PATH,
+      ADB_PATH
+    } = validateAndroidTools(config.android);
+    progress.complete("androidTools");
+    progress.start("emulator");
+    const emulatorRunning = await checkEmulator(ADB_PATH);
+    if (!emulatorRunning) {
+      progress.log("No emulator running, attempting to start one...");
+      await startEmulator(EMULATOR_PATH, config.android);
+    } else {
+      progress.log("Emulator already running, proceeding with installation...", "success");
+    }
+    progress.complete("emulator");
+    if (config.android?.sdkPath) {
+      await updateLocalProperties(config.android.sdkPath);
+    }
+    progress.start("saveConfig");
+    await saveConfig({
+      WEBVIEW_CONFIG: config
+    });
+    progress.complete("saveConfig");
+    progress.start("setupServer");
+    await (0, _setupServer.setupServer)(configPath);
+    progress.complete("setupServer");
+    progress.printTreeContent("Configuration Explanation", ["WEBVIEW_CONFIG: Main configuration object for the WebView setup", {
+      text: "port: Port number for the WebView server",
+      indent: 1,
+      prefix: "├─ ",
+      color: "gray"
+    }, {
+      text: "android: Android-specific configuration",
+      indent: 1,
+      prefix: "└─ ",
+      color: "gray"
+    }, {
+      text: "buildType: Build type (debug/release)",
+      indent: 2,
+      prefix: "├─ ",
+      color: "gray"
+    }, {
+      text: "sdkPath: Android SDK path",
+      indent: 2,
+      prefix: "├─ ",
+      color: "gray"
+    }, {
+      text: "emulatorName: Selected Android emulator name",
+      indent: 2,
+      prefix: "└─ ",
+      color: "gray"
+    }]);
+    progress.printTreeContent("Final Configuration", [JSON.stringify(config, null, 2)]);
+    process.exit(0);
+  } catch (error) {
+    if (progress.currentStep) {
+      progress.fail(progress.currentStep.id, error.message);
+    }
+    process.exit(1);
+  }
+}
+
+// Execute the main setup
 setupAndroidEnvironment();