@salve-software/mako-react-native 1.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Gabriel-Pereira1788
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/NitroMako.podspec

@@ -0,0 +1,31 @@
+require "json"
+
+package = JSON.parse(File.read(File.join(__dir__, "package.json")))
+
+Pod::Spec.new do |s|
+  s.name         = "NitroMako"
+  s.version      = package["version"]
+  s.summary      = package["description"]
+  s.homepage     = package["homepage"]
+  s.license      = package["license"]
+  s.authors      = package["author"]
+
+  s.platforms    = { :ios => min_ios_version_supported, :visionos => 1.0 }
+  s.source       = { :git => "https://github.com/gabriel-pereira1788/mako-react-native.git", :tag => "#{s.version}" }
+
+  s.source_files = [
+    # Implementation (Swift)
+    "ios/**/*.{swift}",
+    # Autolinking/Registration (Objective-C++)
+    "ios/**/*.{m,mm}",
+    # Implementation (C++ objects)
+    "cpp/**/*.{hpp,cpp}",
+  ]
+
+  load 'nitrogen/generated/ios/NitroMako+autolinking.rb'
+  add_nitrogen_files(s)
+
+  s.dependency 'React-jsi'
+  s.dependency 'React-callinvoker'
+  install_modules_dependencies(s)
+end

package/README.md

@@ -0,0 +1,90 @@
+# mako-react-native
+
+React Native SDK for [Mako](https://github.com/Gabriel-Pereira1788/mako) - Real-time debugging console for React Native.
+
+[![npm version](https://img.shields.io/npm/v/mako-react-native.svg)](https://www.npmjs.com/package/mako-react-native)
+[![npm downloads](https://img.shields.io/npm/dm/mako-react-native.svg)](https://www.npmjs.com/package/mako-react-native)
+[![license](https://img.shields.io/npm/l/mako-react-native.svg)](https://github.com/Gabriel-Pereira1788/mako/blob/main/LICENSE)
+
+## Requirements
+
+| Requirement | Version |
+|-------------|---------|
+| React Native | 0.73+ |
+| Node.js | 18+ |
+
+## Installation
+
+```bash
+npm install mako-react-native react-native-nitro-modules
+```
+
+For iOS, install pods:
+
+```bash
+cd ios && pod install && cd ..
+```
+
+For Android, the package will auto-link.
+
+## Usage
+
+Add the following code to your app's entry point (e.g., `App.tsx`):
+
+```typescript
+import { Mako } from 'mako-react-native';
+
+if (__DEV__) {
+  Mako.connect({
+    host: '192.168.1.100', // Your Mac's IP address
+    port: 8765,
+    enableNetworkCapture: true,
+  });
+}
+```
+
+> **Tip**: Use `localhost` for iOS Simulator, or your Mac's local IP for physical devices.
+
+## API
+
+### `Mako.connect(config?)`
+
+```typescript
+interface MakoConfig {
+  host?: string;                    // Default: 'localhost'
+  port?: number;                    // Default: 8765
+  enableNetworkCapture?: boolean;   // Default: true
+  ignoredUrls?: RegExp[];           // URL patterns to ignore
+  onConnect?: () => void;
+  onDisconnect?: () => void;
+  onError?: (error: Error) => void;
+}
+```
+
+### `Mako.disconnect()`
+
+Closes the WebSocket connection.
+
+### `Mako.isConnected()`
+
+Returns the current connection status.
+
+### Logging
+
+```typescript
+Mako.log('General message');
+Mako.debug('Debug info', { userId: 123 });
+Mako.info('Info message');
+Mako.warn('Warning message');
+Mako.error('Error message');
+```
+
+## MakoApp
+
+This SDK requires [MakoApp](https://github.com/Gabriel-Pereira1788/mako/releases) (macOS) to receive and display logs.
+
+For full documentation, visit the [main repository](https://github.com/Gabriel-Pereira1788/mako).
+
+## License
+
+MIT

package/android/CMakeLists.txt

@@ -0,0 +1,32 @@
+project(NitroMako)
+cmake_minimum_required(VERSION 3.9.0)
+
+set (PACKAGE_NAME NitroMako)
+set (CMAKE_VERBOSE_MAKEFILE ON)
+set (CMAKE_CXX_STANDARD 20)
+
+# Enable Raw Props parsing in react-native (for Nitro Views)
+add_compile_options(-DRN_SERIALIZABLE_STATE=1)
+
+# Define C++ library and add all sources
+add_library(${PACKAGE_NAME} SHARED
+        src/main/cpp/cpp-adapter.cpp
+)
+
+# Add Nitrogen specs :)
+include(${CMAKE_SOURCE_DIR}/../nitrogen/generated/android/NitroMako+autolinking.cmake)
+
+# Set up local includes
+include_directories(
+        "src/main/cpp"
+        "../cpp"
+)
+
+find_library(LOG_LIB log)
+
+# Link all libraries together
+target_link_libraries(
+        ${PACKAGE_NAME}
+        ${LOG_LIB}
+        android                                   # <-- Android core
+)

package/android/build.gradle

@@ -0,0 +1,148 @@
+buildscript {
+  repositories {
+    google()
+    mavenCentral()
+  }
+
+  dependencies {
+    classpath "com.android.tools.build:gradle:8.8.0"
+  }
+}
+
+def reactNativeArchitectures() {
+  def value = rootProject.getProperties().get("reactNativeArchitectures")
+  return value ? value.split(",") : ["armeabi-v7a", "x86", "x86_64", "arm64-v8a"]
+}
+
+def isNewArchitectureEnabled() {
+  return rootProject.hasProperty("newArchEnabled") && rootProject.getProperty("newArchEnabled") == "true"
+}
+
+apply plugin: "com.android.library"
+apply plugin: 'org.jetbrains.kotlin.android'
+apply from: '../nitrogen/generated/android/NitroMako+autolinking.gradle'
+apply from: "./fix-prefab.gradle"
+
+if (isNewArchitectureEnabled()) {
+  apply plugin: "com.facebook.react"
+}
+
+def getExtOrDefault(name) {
+  return rootProject.ext.has(name) ? rootProject.ext.get(name) : project.properties["NitroMako_" + name]
+}
+
+def getExtOrIntegerDefault(name) {
+  return rootProject.ext.has(name) ? rootProject.ext.get(name) : (project.properties["NitroMako_" + name]).toInteger()
+}
+
+android {
+  namespace "com.margelo.nitro.mako"
+
+  ndkVersion getExtOrDefault("ndkVersion")
+  compileSdkVersion getExtOrIntegerDefault("compileSdkVersion")
+
+  defaultConfig {
+    minSdkVersion getExtOrIntegerDefault("minSdkVersion")
+    targetSdkVersion getExtOrIntegerDefault("targetSdkVersion")
+    buildConfigField "boolean", "IS_NEW_ARCHITECTURE_ENABLED", isNewArchitectureEnabled().toString()
+
+    externalNativeBuild {
+      cmake {
+        cppFlags "-frtti -fexceptions -Wall -Wextra -fstack-protector-all"
+        arguments "-DANDROID_STL=c++_shared", "-DANDROID_SUPPORT_FLEXIBLE_PAGE_SIZES=ON"
+        abiFilters (*reactNativeArchitectures())
+
+        buildTypes {
+          debug {
+            cppFlags "-O1 -g"
+          }
+          release {
+            cppFlags "-O2"
+          }
+        }
+      }
+    }
+  }
+
+  externalNativeBuild {
+    cmake {
+      path "CMakeLists.txt"
+    }
+  }
+
+  packagingOptions {
+    excludes = [
+        "META-INF",
+        "META-INF/**",
+        "**/libc++_shared.so",
+        "**/libfbjni.so",
+        "**/libjsi.so",
+        "**/libfolly_json.so",
+        "**/libfolly_runtime.so",
+        "**/libglog.so",
+        "**/libhermes.so",
+        "**/libhermes-executor-debug.so",
+        "**/libhermes_executor.so",
+        "**/libreactnative.so",
+        "**/libreactnativejni.so",
+        "**/libturbomodulejsijni.so",
+        "**/libreact_nativemodule_core.so",
+        "**/libjscexecutor.so"
+    ]
+  }
+
+  buildFeatures {
+    buildConfig true
+    prefab true
+  }
+
+  buildTypes {
+    release {
+      minifyEnabled false
+    }
+  }
+
+  lintOptions {
+    disable "GradleCompatible"
+  }
+
+  compileOptions {
+    sourceCompatibility JavaVersion.VERSION_1_8
+    targetCompatibility JavaVersion.VERSION_1_8
+  }
+
+  sourceSets {
+    main {
+      if (isNewArchitectureEnabled()) {
+        java.srcDirs += [
+          // React Codegen files
+          "${project.buildDir}/generated/source/codegen/java"
+        ]
+      }
+    }
+  }
+}
+
+repositories {
+  mavenCentral()
+  google()
+}
+
+
+dependencies {
+  // For < 0.71, this will be from the local maven repo
+  // For > 0.71, this will be replaced by `com.facebook.react:react-android:$version` by react gradle plugin
+  //noinspection GradleDynamicVersion
+  implementation "com.facebook.react:react-native:+"
+
+  // Add a dependency on NitroModules
+  implementation project(":react-native-nitro-modules")
+}
+
+if (isNewArchitectureEnabled()) {
+  react {
+    jsRootDir = file("../src/")
+    libraryName = "NitroMako"
+    codegenJavaPackageName = "com.margelo.nitro.mako"
+  }
+}

package/android/fix-prefab.gradle

@@ -0,0 +1,51 @@
+tasks.configureEach { task ->
+  // Make sure that we generate our prefab publication file only after having built the native library
+  // so that not a header publication file, but a full configuration publication will be generated, which
+  // will include the .so file
+
+  def prefabConfigurePattern = ~/^prefab(.+)ConfigurePackage$/
+  def matcher = task.name =~ prefabConfigurePattern
+  if (matcher.matches()) {
+    def variantName = matcher[0][1]
+    task.outputs.upToDateWhen { false }
+    task.dependsOn("externalNativeBuild${variantName}")
+  }
+}
+
+afterEvaluate {
+  def abis = reactNativeArchitectures()
+  rootProject.allprojects.each { proj ->
+    if (proj === rootProject) return
+
+    def dependsOnThisLib = proj.configurations.findAll { it.canBeResolved }.any { config ->
+      config.dependencies.any { dep ->
+        dep.group == project.group && dep.name == project.name
+      }
+    }
+    if (!dependsOnThisLib && proj != project) return
+
+    if (!proj.plugins.hasPlugin('com.android.application') && !proj.plugins.hasPlugin('com.android.library')) {
+      return
+    }
+
+    def variants = proj.android.hasProperty('applicationVariants') ? proj.android.applicationVariants : proj.android.libraryVariants
+    // Touch the prefab_config.json files to ensure that in ExternalNativeJsonGenerator.kt we will re-trigger the prefab CLI to
+    // generate a libnameConfig.cmake file that will contain our native library (.so).
+    // See this condition: https://cs.android.com/android-studio/platform/tools/base/+/mirror-goog-studio-main:build-system/gradle-core/src/main/java/com/android/build/gradle/tasks/ExternalNativeJsonGenerator.kt;l=207-219?q=createPrefabBuildSystemGlue
+    variants.all { variant ->
+      def variantName = variant.name
+      abis.each { abi ->
+        def searchDir = new File(proj.projectDir, ".cxx/${variantName}")
+        if (!searchDir.exists()) return
+        def matches = []
+        searchDir.eachDir { randomDir ->
+          def prefabFile = new File(randomDir, "${abi}/prefab_config.json")
+          if (prefabFile.exists()) matches << prefabFile
+        }
+        matches.each { prefabConfig ->
+          prefabConfig.setLastModified(System.currentTimeMillis())
+        }
+      }
+    }
+  }
+}

package/android/gradle.properties

@@ -0,0 +1,5 @@
+NitroMako_kotlinVersion=2.1.20
+NitroMako_minSdkVersion=23
+NitroMako_targetSdkVersion=35
+NitroMako_compileSdkVersion=34
+NitroMako_ndkVersion=27.1.12297006

package/android/src/main/AndroidManifest.xml

@@ -0,0 +1,2 @@
+<manifest xmlns:android="http://schemas.android.com/apk/res/android">
+</manifest>

package/android/src/main/cpp/cpp-adapter.cpp

@@ -0,0 +1,9 @@
+#include <jni.h>
+#include <fbjni/fbjni.h>
+#include "NitroMakoOnLoad.hpp"
+
+JNIEXPORT jint JNICALL JNI_OnLoad(JavaVM* vm, void*) {
+  return facebook::jni::initialize(vm, []() {
+    margelo::nitro::mako::registerAllNatives();
+  });
+}

package/android/src/main/java/com/margelo/nitro/mako/HybridMako.kt

@@ -0,0 +1,235 @@
+package com.margelo.nitro.mako
+
+import android.content.Context
+import android.os.Build
+import android.provider.Settings
+import com.margelo.nitro.NitroModules
+import com.margelo.nitro.mako.HybridNitroMakoSpec
+import com.margelo.nitro.mako.NativeLogEntry
+import com.margelo.nitro.mako.NativeLogLevel
+import java.io.BufferedReader
+import java.io.InputStreamReader
+import kotlin.concurrent.thread
+
+class HybridMako : HybridNitroMakoSpec() {
+
+    // MARK: - Properties
+
+    private var logCallback: ((log: NativeLogEntry) -> Unit)? = null
+    private var isCapturingLogs = false
+    private var logcatProcess: Process? = null
+    private var readerThread: Thread? = null
+
+    // Storage constants
+    private val PREFS_NAME = "mako_prefs"
+    private val DEVICE_ID_KEY = "mako_device_id"
+
+    // Context accessor
+    private val context: Context?
+        get() = NitroModules.applicationContext
+
+    // Performance monitoring
+    private val performanceMonitor = PerformanceMonitor()
+
+    // MARK: - Existing Methods
+
+    override fun sum(num1: Double, num2: Double): Double {
+        return num1 + num2
+    }
+
+    // MARK: - Log Capture Methods
+
+    override fun startLogCapture(onLog: (log: NativeLogEntry) -> Unit): Boolean {
+        if (isCapturingLogs) {
+            return false // Already capturing
+        }
+
+        logCallback = onLog
+        isCapturingLogs = true
+
+        try {
+            // Get current process PID
+            val pid = android.os.Process.myPid()
+
+            // Clear logcat buffer first
+            try {
+                Runtime.getRuntime().exec(arrayOf("logcat", "-c")).waitFor()
+            } catch (e: Exception) {
+                // Ignore clear errors
+            }
+
+            // Start logcat for current process only
+            logcatProcess = Runtime.getRuntime().exec(
+                arrayOf("logcat", "-v", "threadtime", "--pid=$pid")
+            )
+
+            // Read logcat output in background thread
+            readerThread = thread(start = true, isDaemon = true, name = "Mako-Logcat") {
+                try {
+                    val reader = BufferedReader(
+                        InputStreamReader(logcatProcess!!.inputStream)
+                    )
+
+                    var line: String? = null
+                    while (isCapturingLogs) {
+                        line = reader.readLine() ?: break
+                        processLogLine(line)
+                    }
+                } catch (e: Exception) {
+                    // Thread interrupted or stream closed
+                }
+            }
+
+            return true
+        } catch (e: Exception) {
+            isCapturingLogs = false
+            logCallback = null
+            return false
+        }
+    }
+
+    override fun stopLogCapture() {
+        if (!isCapturingLogs) return
+
+        isCapturingLogs = false
+        logCallback = null
+
+        logcatProcess?.destroy()
+        logcatProcess = null
+
+        readerThread?.interrupt()
+        readerThread = null
+    }
+
+    override fun isCapturing(): Boolean {
+        return isCapturingLogs
+    }
+
+    // MARK: - Device Info Methods
+
+    override fun getDeviceInfo(): DeviceInfoResult {
+        val ctx = context
+        val deviceId = if (ctx != null) {
+            Settings.Secure.getString(ctx.contentResolver, Settings.Secure.ANDROID_ID) ?: generateUUID()
+        } else {
+            generateUUID()
+        }
+        val deviceName = Build.MODEL
+        val appName = ctx?.applicationInfo?.loadLabel(ctx.packageManager)?.toString() ?: "React Native App"
+        val bundleId = ctx?.packageName ?: ""
+
+        return DeviceInfoResult(deviceId, deviceName, appName, bundleId)
+    }
+
+    override fun getStoredDeviceId(): String? {
+        val ctx = context ?: return null
+        val prefs = ctx.getSharedPreferences(PREFS_NAME, Context.MODE_PRIVATE)
+        return prefs.getString(DEVICE_ID_KEY, null)
+    }
+
+    override fun storeDeviceId(deviceId: String) {
+        val ctx = context ?: return
+        val prefs = ctx.getSharedPreferences(PREFS_NAME, Context.MODE_PRIVATE)
+        prefs.edit().putString(DEVICE_ID_KEY, deviceId).apply()
+    }
+
+    private fun generateUUID(): String {
+        return java.util.UUID.randomUUID().toString()
+    }
+
+    // MARK: - Private Helpers
+
+    private fun processLogLine(line: String) {
+        // Logcat threadtime format:
+        // "MM-DD HH:MM:SS.mmm PID TID LEVEL TAG: MESSAGE"
+        // Example: "01-15 10:23:45.123  1234  5678 I MyApp: User logged in"
+
+        val pattern = Regex(
+            """(\d{2}-\d{2})\s+(\d{2}:\d{2}:\d{2}\.\d{3})\s+\d+\s+\d+\s+([VDIWEF])\s+([^:]+):\s*(.*)"""
+        )
+
+        val match = pattern.find(line)
+
+        val (level, tag, message) = if (match != null) {
+            val levelChar = match.groupValues[3]
+            val extractedTag = match.groupValues[4].trim()
+            val extractedMessage = match.groupValues[5]
+
+            val mappedLevel = when (levelChar) {
+                "V", "D" -> NativeLogLevel.VERBOSE
+                "I" -> NativeLogLevel.INFO
+                "W" -> NativeLogLevel.WARN
+                "E", "F" -> NativeLogLevel.ERROR
+                else -> NativeLogLevel.INFO
+            }
+
+            Triple(mappedLevel, extractedTag, extractedMessage)
+        } else {
+            // Fallback for unparseable lines
+            Triple(detectLogLevel(line), "native", line)
+        }
+
+        val entry = NativeLogEntry(
+            level = level,
+            message = if (tag != "native") "[$tag] $message" else message,
+            tag = tag,
+            timestamp = System.currentTimeMillis().toDouble()
+        )
+
+        // Invoke callback (Nitro handles thread scheduling to JS thread)
+        logCallback?.invoke(entry)
+    }
+
+    private fun detectLogLevel(line: String): NativeLogLevel {
+        val lowercased = line.lowercase()
+        return when {
+            lowercased.contains("error") || lowercased.contains("fault") -> NativeLogLevel.ERROR
+            lowercased.contains("warn") -> NativeLogLevel.WARN
+            lowercased.contains("debug") -> NativeLogLevel.VERBOSE
+            else -> NativeLogLevel.INFO
+        }
+    }
+
+    // MARK: - Performance Monitoring Methods
+
+    override fun startPerformanceMonitoring(onMetrics: (metrics: PerformanceMetrics) -> Unit, intervalMs: Double?): Boolean {
+        val interval = intervalMs?.toInt() ?: 1000
+
+        return performanceMonitor.start({ data ->
+            val metrics = PerformanceMetrics(
+                uiFps = data.uiFps,
+                jsFps = data.jsFps,
+                memoryUsageMB = data.memoryUsageMB,
+                cpuUsagePercent = data.cpuUsagePercent
+            )
+            onMetrics(metrics)
+        }, interval)
+    }
+
+    override fun stopPerformanceMonitoring() {
+        performanceMonitor.stop()
+    }
+
+    override fun isPerformanceMonitoring(): Boolean {
+        return performanceMonitor.isRunning()
+    }
+
+    override fun getPerformanceSnapshot(): PerformanceMetrics {
+        val data = performanceMonitor.getSnapshot()
+        return PerformanceMetrics(
+            uiFps = data.uiFps,
+            jsFps = data.jsFps,
+            memoryUsageMB = data.memoryUsageMB,
+            cpuUsagePercent = data.cpuUsagePercent
+        )
+    }
+
+    override fun recordJsFrame() {
+        performanceMonitor.recordJsFrame()
+    }
+
+    protected fun finalize() {
+        stopLogCapture()
+        performanceMonitor.stop()
+    }
+}

package/android/src/main/java/com/margelo/nitro/mako/MakoPackage.kt

@@ -0,0 +1,18 @@
+package com.margelo.nitro.mako
+
+import com.facebook.react.bridge.NativeModule
+import com.facebook.react.bridge.ReactApplicationContext
+import com.facebook.react.module.model.ReactModuleInfoProvider
+import com.facebook.react.TurboReactPackage
+
+class MakoPackage : TurboReactPackage() {
+    override fun getModule(name: String, reactContext: ReactApplicationContext): NativeModule? = null
+
+    override fun getReactModuleInfoProvider(): ReactModuleInfoProvider = ReactModuleInfoProvider { emptyMap() }
+
+    companion object {
+        init {
+            NitroMakoOnLoad.initializeNative()
+        }
+    }
+}