Core Configuration

/**
 * Main Reactotron React Native client interface
 */
interface ReactotronReactNative extends Reactotron {
  /** Configure React Native specific plugins and features */
  useReactNative(options?: UseReactNativeOptions): this;
  /** Set AsyncStorage handler for client ID persistence */
  setAsyncStorageHandler(asyncStorage: AsyncStorageStatic): this;
  /** Current AsyncStorage handler instance */
  asyncStorageHandler?: AsyncStorageStatic;
}

/**
 * Configuration options for React Native specific features
 */
interface UseReactNativeOptions {
  /** Enable global error tracking with optional configuration */
  errors?: TrackGlobalErrorsOptions | boolean;
  /** Enable global console log tracking */
  log?: boolean;
  /** Enable editor integration with optional configuration */
  editor?: OpenInEditorOptions | boolean;
  /** Enable debug overlay */
  overlay?: boolean;
  /** Enable AsyncStorage tracking with optional configuration */
  asyncStorage?: AsyncStorageOptions | boolean;
  /** Enable network request tracking with optional configuration */
  networking?: NetworkingOptions | boolean;
  /** Enable Storybook integration */
  storybook?: boolean;
  /** Enable dev tools integration */
  devTools?: boolean;
}

import Reactotron from "reactotron-react-native";

// Enable all plugins with defaults
const reactotron = Reactotron
  .configure({ name: "MyApp" })
  .useReactNative()
  .connect();

// Selective plugin configuration
const reactotron = Reactotron
  .configure({ name: "MyApp" })
  .useReactNative({
    errors: { veto: (frame) => !frame.fileName.includes('node_modules') },
    networking: { ignoreUrls: /localhost/ },
    asyncStorage: { ignore: ['persist:root'] },
    overlay: true,
    devTools: true,
    storybook: false
  })
  .connect();

// Disable specific plugins
const reactotron = Reactotron
  .configure({ name: "MyApp" })
  .useReactNative({
    errors: false,  // Disable error tracking
    log: false,     // Disable log tracking
    networking: true
  })
  .connect();

/**
 * Set AsyncStorage handler for client ID persistence
 * @param asyncStorage - AsyncStorage implementation
 * @returns ReactotronReactNative instance for chaining
 */
setAsyncStorageHandler(asyncStorage: AsyncStorageStatic): this;

import AsyncStorage from "@react-native-async-storage/async-storage";
import Reactotron from "reactotron-react-native";

const reactotron = Reactotron
  .setAsyncStorageHandler(AsyncStorage)
  .configure({ name: "MyApp" })
  .useReactNative()
  .connect();

/**
 * Array of default React Native plugins
 */
const reactNativeCorePlugins: PluginCreator<ReactotronCore>[];

/**
 * Default client options for React Native
 */
interface DefaultClientOptions {
  createSocket: (path: string) => WebSocket;
  host: string;  // Auto-detected from React Native dev server
  port: number;  // Default: 9090
  name: string;  // Default: "React Native App"
  environment: string;  // Auto-detected from NODE_ENV
  client: {
    reactotronLibraryName: string;
    reactotronLibraryVersion: string;
    platform: string;  // iOS or Android
    platformVersion: string | number;
    reactNativeVersion: string | null;
    screenWidth: number;
    screenHeight: number;
    screenScale: number;
    // Additional platform-specific constants
  };
  getClientId: (name?: string) => Promise<string>;
  setClientId: (clientId: string) => Promise<void>;
  proxyHack: boolean;  // Default: true
}