react-native-debug-toolkit 3.3.8 → 3.5.1

package/README.md

@@ -4,21 +4,19 @@
 
 [中文](README.zh-CN.md)
 
-React Native Debug Toolkit is a dev-only local debugging toolkit for React Native apps.
-
-Use it to inspect app logs on device, stream logs to a desktop Web Console, and let AI coding agents read real runtime evidence through HTTP or MCP.
+A local debugging toolkit for React Native apps. It provides an in-app debug panel, a desktop Web Console, an HTTP API, and an MCP server — all running locally with no cloud dependency.
 
 ```text
 RN App -> Debug Panel -> local daemon -> Web Console / HTTP API / MCP
 ```
 
-## What You Get
+## Features
 
-- In-app debug panel with Network, Console, Navigation, Track, Zustand, Environment, and Clipboard logs.
-- Desktop Web Console for simulator and real-device logs.
-- Local HTTP API for curl, scripts, Codex, Claude Code, and other AI agents with shell access.
-- Optional MCP server with `list_app_devices` and `get_app_logs`.
-- Local-first workflow. No cloud service. No AI API call inside the package.
+- In-app debug panel: Network, Console, Native, Navigation, Track, Zustand, Environment, Clipboard, and custom tabs.
+- Desktop Web Console for viewing simulator and real-device logs in a browser.
+- Local HTTP API for reading logs with `curl`, scripts, or AI agents (Codex, Claude Code, etc.).
+- Optional MCP server exposing `list_app_devices` and `get_app_logs`.
+- Local-first: no cloud service, no signup, no AI API calls inside the package.
 
 ## Install
 
@@ -26,7 +24,7 @@ RN App -> Debug Panel -> local daemon -> Web Console / HTTP API / MCP
 npm install react-native-debug-toolkit
 ```
 
-Install the native part and rebuild the app:
+Install the native part and rebuild:
 
 ```bash
 cd ios && pod install
@@ -73,13 +71,13 @@ Open the Web Console:
 http://127.0.0.1:3799/console
 ```
 
-In the app, open Debug Panel -> `DevConnect` -> `Send Once` or `Start Live Sync` for desktop logs.
+In the app, go to Debug Panel → `DevConnect` → `Send Once` or `Start Live Sync` to sync logs to the desktop.
 
-DevConnect auto-detects simulator/emulator and uses local host settings automatically. On real devices, enter your computer IP to connect.
+DevConnect auto-detects simulator/emulator and configures host settings. On real devices, enter your computer IP manually.
 
-The IP and ports are persisted through AsyncStorage when installed, or through the native module after rebuild.
+IP and ports are persisted via AsyncStorage (when installed) or through the native module after rebuild.
 
-QR scan is optional. Install `react-native-camera-kit` or `expo-camera` in the app to enable the scan button. The app must request camera permission before scanning.
+QR scan is optional. Install `react-native-camera-kit` or `expo-camera` to enable the scan button. The app must request camera permission before scanning.
 
 ## Device Setup
 
@@ -89,7 +87,7 @@ QR scan is optional. Install `react-native-camera-kit` or `expo-camera` in the a
 | Android emulator | `http://10.0.2.2:3799` |
 | Real device | `http://<mac-ip>:3799` |
 
-For a real device, first open this URL in the phone browser:
+For real devices, first open this URL in the phone browser:
 
 ```text
 http://<mac-ip>:3799/health
@@ -97,7 +95,7 @@ http://<mac-ip>:3799/health
 
 If it does not open, check Mac firewall, Wi-Fi isolation, VPN, local network permission, and cleartext HTTP settings.
 
-The daemon stores logs at:
+Daemon log store:
 
 ```text
 ~/.react-native-debug-toolkit/daemon-devices.json
@@ -113,7 +111,7 @@ DEBUG_TOOLKIT_DAEMON_STORE=/path/to/devices.json npm exec -- debug-toolkit --dae
 
 ## Read Logs With HTTP
 
-HTTP is the best path when your AI agent or script has shell access.
+HTTP is the recommended path when your AI agent or script has shell access.
 
 ```bash
 BASE=http://127.0.0.1:3799
@@ -132,7 +130,7 @@ curl "$BASE/devices/$DEVICE_ID/logs?limit=100&includeBodies=true"
 curl -X DELETE "$BASE/devices"
 ```
 
-Main endpoints:
+Endpoints:
 
 ```text
 GET    /health
@@ -156,14 +154,30 @@ claude mcp add debug-toolkit -- npm exec -- debug-toolkit
 
 Tools:
 
-- `list_app_devices`
-- `get_app_logs`
+- `list_app_devices` — list connected devices
+- `get_app_logs` — fetch device logs
+
+`get_app_logs` excludes bodies by default to reduce token usage. Set `includeBodies=true` or pass `entryId` to fetch a single full entry.
+
+## Native Logs
+
+Native Logs collects native app-process logs and displays them in the `Native` tab.
+
+- Android: captures current app-process `logcat` entries visible to the app.
+- iOS: captures React Native native logs emitted through `RCTLog*`.
+- DevConnect sends Native logs to the desktop daemon with the rest of the current session.
+
+Release builds stay disabled by default. To enable for internal release, TestFlight, QA, or gray rollout builds:
+
+```tsx
+<DebugView enabled={true} />
+```
 
-`get_app_logs` excludes bodies by default to reduce tokens. Set `includeBodies=true` or pass `entryId` to fetch one full log entry.
+Native logs may contain user data, tokens, URLs, or device state. Do not enable by default in public production builds.
 
 ## App Options
 
-Disable features:
+### Disable features
 
 ```tsx
 <DebugView features={{ clipboard: false, zustand: false }}>
@@ -171,7 +185,7 @@ Disable features:
 </DebugView>
 ```
 
-Custom tabs:
+### Custom tabs
 
 ```tsx
 import {
@@ -211,7 +225,7 @@ const userDebugTab = createDebugTab<UserSnapshot>({
 
 Each custom feature becomes a panel tab. `name` is the stable tab id, `label` is shown in the tab bar, `getSnapshot` provides tab data, and `render` controls the UI. Add `subscribe` when the tab should refresh after external state changes.
 
-Navigation tracking:
+### Navigation tracking
 
 ```tsx
 <DebugView navigationRef={navigationRef}>
@@ -221,13 +235,13 @@ Navigation tracking:
 </DebugView>
 ```
 
-Zustand:
+### Zustand
 
 ```tsx
 import { zustandLogMiddleware } from 'react-native-debug-toolkit';
 ```
 
-Track:
+### Track events
 
 ```tsx
 import { addTrackLog } from 'react-native-debug-toolkit';

package/README.zh-CN.md

@@ -4,21 +4,19 @@
 
 [English](README.md)
 
-React Native Debug Toolkit 是 React Native 开发期本地调试工具。
-
-它可以在 App 内查看日志，把模拟器或真机日志同步到桌面 Web Console，也可以让 AI 编程工具通过 HTTP 或 MCP 直接读取真实运行日志。
+React Native 开发期本地调试工具。提供 App 内调试面板、桌面 Web Console、本地 HTTP API 和 MCP server，全部在本地运行，不依赖云服务。
 
 ```text
-RN App -> Debug Panel -> local daemon -> Web Console / HTTP API / MCP
+RN App -> Debug Panel -> 本地 daemon -> Web Console / HTTP API / MCP
 ```
 
-## 能做什么
+## 功能
 
-- App 内调试面板：Network、Console、Navigation、Track、Zustand、Environment、Clipboard。
-- 桌面 Web Console：查看模拟器和真机日志。
-- 本地 HTTP API：给 curl、脚本、Codex、Claude Code、其他有 shell 的 AI 读取。
-- 可选 MCP：提供 `list_app_devices` 和 `get_app_logs`。
-- 本地优先：不接云服务，包内不调用 AI API。
+- App 内调试面板：Network、Console、原生日志(Native)、Navigation、Track、Zustand、Environment、Clipboard，支持自定义 Tab。
+- 桌面 Web Console：在浏览器中查看模拟器和真机日志。
+- 本地 HTTP API：供 `curl`、脚本、AI Agent（Codex、Claude Code 等）读取日志。
+- 可选 MCP server：提供 `list_app_devices` 和 `get_app_logs`。
+- 本地优先：不接云服务，不注册，包内不调用 AI API。
 
 ## 安装
 
@@ -26,14 +24,14 @@ RN App -> Debug Panel -> local daemon -> Web Console / HTTP API / MCP
 npm install react-native-debug-toolkit
 ```
 
-安装原生部分并重新构建 App：
+安装原生部分并重新构建：
 
 ```bash
 cd ios && pod install
 # Android：下次构建时 Gradle autolinking 生效
 ```
 
-Expo Go 不能加载这个原生模块。Expo 项目需用 development build、prebuild，或 bare React Native。
+Expo Go 无法加载此原生模块。Expo 项目需用 development build、prebuild 或 bare React Native。
 
 可选依赖：
 
@@ -44,7 +42,7 @@ npm install @react-native-async-storage/async-storage
 
 ## 快速开始
 
-包住你的 App：
+用 `DebugView` 包裹 App：
 
 ```tsx
 import { DebugView } from 'react-native-debug-toolkit';
@@ -58,7 +56,7 @@ export function App() {
 }
 ```
 
-开发模式打开 App，点击 `DBG`。
+开发模式启动 App，点击 `DBG` 打开调试面板。
 
 启动桌面 daemon：
 
@@ -73,31 +71,31 @@ npm exec -- debug-toolkit --daemon-only
 http://127.0.0.1:3799/console
 ```
 
-App 内打开 Debug Panel -> `DevConnect` -> `Send Once` 或 `Start Live Sync` 同步桌面日志。
+App 内打开 Debug Panel → `DevConnect` → `Send Once` 或 `Start Live Sync` 同步日志到桌面。
 
-DevConnect 自动识别模拟器/真机，模拟器下自动使用本机 Metro/daemon 地址。真机需输入电脑 IP 地址。
+DevConnect 自动识别模拟器/真机并配置主机地址。真机需手动输入电脑 IP。
 
-IP 和端口会通过 AsyncStorage 持久化；如果没装 AsyncStorage，则在重建后通过本库原生模块持久化。
+IP 和端口通过 AsyncStorage（如果装了）或原生模块持久化。
 
-扫码是可选能力。App 安装 `react-native-camera-kit` 或 `expo-camera` 后，DevConnect 才显示扫码按钮。App 仍需自己配置相机权限文案，并在使用扫码前申请相机权限。
+扫码是可选功能。安装 `react-native-camera-kit` 或 `expo-camera` 后 DevConnect 会显示扫码按钮。App 需在使用前自行申请相机权限。
 
 ## 设备连接
 
 | 运行时 | App endpoint |
 | --- | --- |
-| iOS simulator | `http://localhost:3799` |
-| Android emulator | `http://10.0.2.2:3799` |
-| 真机 | `http://<mac-ip>:3799` |
+| iOS 模拟器 | `http://localhost:3799` |
+| Android 模拟器 | `http://10.0.2.2:3799` |
+| 真机 | `http://<电脑IP>:3799` |
 
 真机先用手机浏览器打开：
 
 ```text
-http://<mac-ip>:3799/health
+http://<电脑IP>:3799/health
 ```
 
-打不开就检查 Mac 防火墙、Wi-Fi 隔离、VPN、本地网络权限、明文 HTTP 配置。
+打不开则检查 Mac 防火墙、Wi-Fi 隔离、VPN、本地网络权限、明文 HTTP 配置。
 
-daemon 默认日志文件：
+Daemon 日志存储位置：
 
 ```text
 ~/.react-native-debug-toolkit/daemon-devices.json
@@ -113,7 +111,7 @@ DEBUG_TOOLKIT_DAEMON_STORE=/path/to/devices.json npm exec -- debug-toolkit --dae
 
 ## 用 HTTP 读取日志
 
-AI 或脚本有 shell 时，优先用 HTTP。
+AI 或脚本有 shell 访问时，推荐用 HTTP。
 
 ```bash
 BASE=http://127.0.0.1:3799
@@ -132,7 +130,7 @@ curl "$BASE/devices/$DEVICE_ID/logs?limit=100&includeBodies=true"
 curl -X DELETE "$BASE/devices"
 ```
 
-主要端点：
+端点：
 
 ```text
 GET    /health
@@ -156,14 +154,30 @@ claude mcp add debug-toolkit -- npm exec -- debug-toolkit
 
 工具：
 
-- `list_app_devices`
-- `get_app_logs`
+- `list_app_devices` — 列出已连接设备
+- `get_app_logs` — 拉取设备日志
+
+`get_app_logs` 默认不含 body 以节省 token。设 `includeBodies=true` 或传 `entryId` 获取单条完整日志。
+
+## 原生日志
+
+Native Logs 收集当前 App 进程的原生日志，显示在 `Native` Tab。
+
+- Android：收集当前 App 进程可见的 `logcat` 条目。
+- iOS：收集 React Native 通过 `RCTLog*` 输出的原生日志。
+- DevConnect 会把 Native 日志和当前 session 其他日志一起同步到桌面 daemon。
+
+Release 包默认关闭。内部 release、TestFlight、QA 或灰度构建需要开启时：
+
+```tsx
+<DebugView enabled={true} />
+```
 
-`get_app_logs` 默认不返回 body，减少 token。设置 `includeBodies=true` 或传 `entryId` 可读取单条完整日志。
+原生日志可能包含用户数据、token、URL 或设备状态，不要在公开生产包中默认开启。
 
 ## App 配置
 
-禁用功能：
+### 禁用功能
 
 ```tsx
 <DebugView features={{ clipboard: false, zustand: false }}>
@@ -171,7 +185,7 @@ claude mcp add debug-toolkit -- npm exec -- debug-toolkit
 </DebugView>
 ```
 
-自定义 Tab：
+### 自定义 Tab
 
 ```tsx
 import {
@@ -209,9 +223,9 @@ const userDebugTab = createDebugTab<UserSnapshot>({
 </DebugView>;
 ```
 
-每个自定义 feature 都会变成一个面板 Tab。`name` 是稳定 Tab id，`label` 显示在 Tab 栏，`getSnapshot` 提供展示数据，`render` 控制展示 UI。外部状态变化后需要自动刷新时，给它加 `subscribe`。
+每个自定义 feature 会变成面板 Tab。`name` 是稳定 Tab id，`label` 显示在 Tab 栏，`getSnapshot` 提供数据，`render` 控制展示 UI。需要自动刷新时加 `subscribe`。
 
-导航追踪：
+### 导航追踪
 
 ```tsx
 <DebugView navigationRef={navigationRef}>
@@ -221,13 +235,13 @@ const userDebugTab = createDebugTab<UserSnapshot>({
 </DebugView>
 ```
 
-Zustand：
+### Zustand
 
 ```tsx
 import { zustandLogMiddleware } from 'react-native-debug-toolkit';
 ```
 
-Track：
+### Track 事件
 
 ```tsx
 import { addTrackLog } from 'react-native-debug-toolkit';
@@ -248,13 +262,13 @@ addTrackLog({ eventName: 'button_click' });
 - `stopStreaming`
 - `isStreaming`
 - `autoDetectDaemonIp`
-- feature factories and types
+- feature factories 和类型
 
 ## 边界
 
 - 开发工具，不是生产监控。
-- 本地 daemon，不是云 replay。
-- Network 只观察流量，不自动分析 auth、token、业务错误。
+- 本地 daemon，不是云回放。
+- Network 只观察流量，不分析 auth、token、业务错误。
 - 不默认脱敏。
 - 不替代 React Native DevTools。
 

package/android/src/main/java/com/reactnativedebugtoolkit/DebugToolkitNativeLogsModule.java

@@ -0,0 +1,146 @@
+package com.reactnativedebugtoolkit;
+
+import android.os.Process;
+import androidx.annotation.NonNull;
+import com.facebook.react.bridge.Arguments;
+import com.facebook.react.bridge.Promise;
+import com.facebook.react.bridge.ReactApplicationContext;
+import com.facebook.react.bridge.ReactContextBaseJavaModule;
+import com.facebook.react.bridge.ReactMethod;
+import com.facebook.react.bridge.ReadableMap;
+import com.facebook.react.bridge.WritableArray;
+import com.facebook.react.bridge.WritableMap;
+
+import java.io.BufferedReader;
+import java.io.InputStreamReader;
+import java.util.ArrayDeque;
+import java.util.Locale;
+import java.util.regex.Matcher;
+import java.util.regex.Pattern;
+
+public class DebugToolkitNativeLogsModule extends ReactContextBaseJavaModule {
+  private static final String MODULE_NAME = "DebugToolkitNativeLogs";
+  private static final int MAX_BUFFER = 500;
+  private static final Pattern THREADTIME = Pattern.compile(
+      "^\\s*(\\d+-\\d+)\\s+(\\d+:\\d+:\\d+\\.\\d+)\\s+(\\d+)\\s+(\\d+)\\s+([VDIWEF])\\s+([^:]+):\\s?(.*)$");
+
+  private final Object lock = new Object();
+  private final ArrayDeque<WritableMap> buffer = new ArrayDeque<>();
+  private java.lang.Process logcatProcess;
+  private Thread readerThread;
+  private boolean capturing = false;
+  private String lastError = null;
+
+  public DebugToolkitNativeLogsModule(ReactApplicationContext reactContext) {
+    super(reactContext);
+  }
+
+  @NonNull
+  @Override
+  public String getName() { return MODULE_NAME; }
+
+  @ReactMethod
+  public void startCapture(ReadableMap options, Promise promise) {
+    synchronized (lock) {
+      if (capturing) { promise.resolve(statusMap(true)); return; }
+      capturing = true;
+      lastError = null;
+    }
+    readerThread = new Thread(() -> readLogcat(), "DebugToolkitNativeLogs");
+    readerThread.setDaemon(true);
+    readerThread.start();
+    promise.resolve(statusMap(true));
+  }
+
+  @ReactMethod
+  public void stopCapture(Promise promise) {
+    synchronized (lock) {
+      capturing = false;
+      if (logcatProcess != null) { logcatProcess.destroy(); logcatProcess = null; }
+    }
+    promise.resolve(statusMap(false));
+  }
+
+  @ReactMethod
+  public void drainLogs(double max, Promise promise) {
+    int limit = Math.max(1, (int) Math.floor(max));
+    WritableArray drained = Arguments.createArray();
+    synchronized (lock) {
+      while (!buffer.isEmpty() && limit > 0) { drained.pushMap(buffer.removeFirst()); limit--; }
+    }
+    promise.resolve(drained);
+  }
+
+  @ReactMethod
+  public void getStatus(Promise promise) {
+    synchronized (lock) {
+      WritableMap status = statusMap(capturing);
+      if (lastError != null) status.putString("error", lastError);
+      promise.resolve(status);
+    }
+  }
+
+  private WritableMap statusMap(boolean isCapturing) {
+    WritableMap map = Arguments.createMap();
+    map.putBoolean("ok", true);
+    map.putBoolean("available", true);
+    map.putBoolean("capturing", isCapturing);
+    return map;
+  }
+
+  private void readLogcat() {
+    int pid = Process.myPid();
+    try {
+      ProcessBuilder builder = new ProcessBuilder("logcat", "-v", "threadtime", "--pid", String.valueOf(pid));
+      logcatProcess = builder.redirectErrorStream(true).start();
+      BufferedReader reader = new BufferedReader(new InputStreamReader(logcatProcess.getInputStream()));
+      String line;
+      while (isCapturing() && (line = reader.readLine()) != null) {
+        WritableMap entry = parseLine(line, pid);
+        if (entry != null) push(entry);
+      }
+    } catch (Exception error) {
+      synchronized (lock) { lastError = error.getMessage(); }
+    } finally {
+      synchronized (lock) { capturing = false; logcatProcess = null; }
+    }
+  }
+
+  private boolean isCapturing() { synchronized (lock) { return capturing; } }
+
+  private void push(WritableMap entry) {
+    synchronized (lock) {
+      while (buffer.size() >= MAX_BUFFER) buffer.removeFirst();
+      buffer.addLast(entry);
+    }
+  }
+
+  private WritableMap parseLine(String line, int pid) {
+    Matcher m = THREADTIME.matcher(line);
+    if (!m.matches()) return null;
+    if (Integer.parseInt(m.group(3)) != pid) return null;
+    WritableMap entry = Arguments.createMap();
+    entry.putDouble("timestamp", System.currentTimeMillis());
+    entry.putString("platform", "android");
+    entry.putString("source", "logcat");
+    entry.putString("level", levelFromPriority(m.group(5)));
+    entry.putString("thread", m.group(4));
+    entry.putString("tag", m.group(6).trim());
+    entry.putString("message", m.group(7));
+    entry.putString("raw", line);
+    return entry;
+  }
+
+  private String levelFromPriority(String priority) {
+    String p = priority == null ? "" : priority.toUpperCase(Locale.US);
+    switch (p) {
+      case "V": return "trace";
+      case "D": return "debug";
+      case "I": return "info";
+      case "W": return "warn";
+      case "E": return "error";
+      case "F": return "fatal";
+      default: return "unknown";
+    }
+  }
+}

package/android/src/main/java/com/reactnativedebugtoolkit/ReactNativeDebugToolkitPackage.java

@@ -7,19 +7,21 @@ import com.facebook.react.bridge.NativeModule;
 import com.facebook.react.bridge.ReactApplicationContext;
 import com.facebook.react.uimanager.ViewManager;
 
-import java.util.Collections;
+import java.util.Arrays;
 import java.util.List;
 
 public class ReactNativeDebugToolkitPackage implements ReactPackage {
   @NonNull
   @Override
   public List<NativeModule> createNativeModules(@NonNull ReactApplicationContext reactContext) {
-    return Collections.<NativeModule>singletonList(new DebugToolkitDevConnectModule(reactContext));
+    return Arrays.<NativeModule>asList(
+        new DebugToolkitDevConnectModule(reactContext),
+        new DebugToolkitNativeLogsModule(reactContext));
   }
 
   @NonNull
   @Override
   public List<ViewManager> createViewManagers(@NonNull ReactApplicationContext reactContext) {
-    return Collections.emptyList();
+    return java.util.Collections.emptyList();
   }
 }

package/ios/DebugToolkitNativeLogs.mm

@@ -0,0 +1,92 @@
+#import <Foundation/Foundation.h>
+#import <React/RCTBridgeModule.h>
+#import <React/RCTLog.h>
+
+@interface DebugToolkitNativeLogs : NSObject <RCTBridgeModule>
+@end
+
+@implementation DebugToolkitNativeLogs
+
+RCT_EXPORT_MODULE(DebugToolkitNativeLogs)
+
+static const NSUInteger DebugToolkitNativeLogsMaxBuffer = 500;
+static NSMutableArray<NSDictionary *> *buffer;
+static dispatch_queue_t bufferQueue;
+static BOOL captureEnabled = NO;
+static BOOL logFunctionInstalled = NO;
+
++ (BOOL)requiresMainQueueSetup { return NO; }
+
++ (void)initialize {
+  if (self == [DebugToolkitNativeLogs class]) {
+    buffer = [NSMutableArray new];
+    bufferQueue = dispatch_queue_create("com.reactnativedebugtoolkit.nativeLogs", DISPATCH_QUEUE_SERIAL);
+  }
+}
+
+RCT_EXPORT_METHOD(startCapture:(NSDictionary *)options
+                  resolver:(RCTPromiseResolveBlock)resolve
+                  rejecter:(__unused RCTPromiseRejectBlock)reject) {
+  dispatch_sync(bufferQueue, ^{
+    captureEnabled = YES;
+    if (!logFunctionInstalled) {
+      logFunctionInstalled = YES;
+      RCTAddLogFunction(^(RCTLogLevel level, RCTLogSource source, NSString *fileName, NSNumber *lineNumber, NSString *message) {
+        if (!captureEnabled || !message) return;
+        NSDictionary *entry = @{
+          @"timestamp": @([[NSDate date] timeIntervalSince1970] * 1000),
+          @"platform": @"ios",
+          @"source": @"rctLog",
+          @"level": DebugToolkitNativeLogsLevel(level),
+          @"message": message,
+          @"file": fileName ?: @"",
+          @"line": lineNumber ?: @0,
+          @"raw": RCTFormatLog([NSDate date], level, fileName, lineNumber, message) ?: message
+        };
+        dispatch_async(bufferQueue, ^{
+          if (buffer.count >= DebugToolkitNativeLogsMaxBuffer) [buffer removeObjectAtIndex:0];
+          [buffer addObject:entry];
+        });
+      });
+    }
+  });
+  resolve(@{@"ok": @YES, @"available": @YES, @"capturing": @YES});
+}
+
+RCT_EXPORT_METHOD(stopCapture:(RCTPromiseResolveBlock)resolve
+                  rejecter:(__unused RCTPromiseRejectBlock)reject) {
+  dispatch_sync(bufferQueue, ^{ captureEnabled = NO; });
+  resolve(@{@"ok": @YES, @"available": @YES, @"capturing": @NO});
+}
+
+RCT_EXPORT_METHOD(drainLogs:(nonnull NSNumber *)max
+                  resolver:(RCTPromiseResolveBlock)resolve
+                  rejecter:(__unused RCTPromiseRejectBlock)reject) {
+  __block NSArray<NSDictionary *> *drained = @[];
+  NSUInteger limit = MAX((NSUInteger)1, max.unsignedIntegerValue);
+  dispatch_sync(bufferQueue, ^{
+    NSUInteger count = MIN(limit, buffer.count);
+    drained = [buffer subarrayWithRange:NSMakeRange(0, count)];
+    if (count > 0) [buffer removeObjectsInRange:NSMakeRange(0, count)];
+  });
+  resolve(drained);
+}
+
+RCT_EXPORT_METHOD(getStatus:(RCTPromiseResolveBlock)resolve
+                  rejecter:(__unused RCTPromiseRejectBlock)reject) {
+  __block BOOL current = NO;
+  dispatch_sync(bufferQueue, ^{ current = captureEnabled; });
+  resolve(@{@"available": @YES, @"capturing": @(current)});
+}
+
+static NSString *DebugToolkitNativeLogsLevel(RCTLogLevel level) {
+  switch (level) {
+    case RCTLogLevelTrace: return @"trace";
+    case RCTLogLevelInfo: return @"info";
+    case RCTLogLevelWarning: return @"warn";
+    case RCTLogLevelError: return @"error";
+    case RCTLogLevelFatal: return @"fatal";
+  }
+}
+
+@end

package/lib/commonjs/constants/logLevels.js

@@ -0,0 +1,19 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.LEVEL_ICONS = exports.LEVEL_COLORS = void 0;
+const LEVEL_COLORS = exports.LEVEL_COLORS = {
+  log: '#8E8E93',
+  info: '#007AFF',
+  warn: '#FF9500',
+  error: '#FF3B30'
+};
+const LEVEL_ICONS = exports.LEVEL_ICONS = {
+  log: '●',
+  info: 'ℹ',
+  warn: '⚠',
+  error: '✕'
+};
+//# sourceMappingURL=logLevels.js.map

package/lib/commonjs/constants/logLevels.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["LEVEL_COLORS","exports","log","info","warn","error","LEVEL_ICONS"],"sourceRoot":"../../../src","sources":["constants/logLevels.ts"],"mappings":";;;;;;AAAO,MAAMA,YAAoC,GAAAC,OAAA,CAAAD,YAAA,GAAG;EAClDE,GAAG,EAAE,SAAS;EACdC,IAAI,EAAE,SAAS;EACfC,IAAI,EAAE,SAAS;EACfC,KAAK,EAAE;AACT,CAAC;AAEM,MAAMC,WAAmC,GAAAL,OAAA,CAAAK,WAAA,GAAG;EACjDJ,GAAG,EAAE,GAAG;EACRC,IAAI,EAAE,GAAG;EACTC,IAAI,EAAE,GAAG;EACTC,KAAK,EAAE;AACT,CAAC","ignoreList":[]}