Memory-leak-mointor NPM

React Native Memory Leak Monitor 🔍

🔥 A powerful memory leak detection tool for React Native, inspired by LeakCanary! Monitor and catch memory leaks in real-time.

⚠️ Currently Android Only (iOS coming soon! 🍎)

✨ Features

🔄 Real-time memory usage monitoring
🎯 Component-level leak detection
⏱️ Session-based memory analysis
📊 Zustand store integration
📱 Memory metrics tracking
🚨 Automatic leak notifications
🎁 Easy-to-use HOC wrapper

🚀 Installation

npm install memory-leak-monitor
# or
yarn add memory-leak-monitor

🤖 Android Setup

Add to android/app/build.gradle:

dependencies {
    // ... other dependencies
    implementation project(':memory-leak-monitor')
}

📖 Basic Usage

1. 🌍 Wrap Your App

import { MonitorMemory } from "memory-leak-monitor";

function App() {
  return (
    <MonitorMemory
      interval={1000} // Update interval in ms
      sessionDurationMinutes={0.5} // Session duration
    >
      {/* Your app content */}
    </MonitorMemory>
  );
}

2. 🎯 Monitor Components

import { withLeakDetection } from "memory-leak-monitor";

const MyComponent = () => {
  // Your component code
};

export default withLeakDetection(MyComponent, "MyComponent");

3. 📊 Track Memory Stats

import { useLeakDetectionStore } from "memory-leak-monitor";

function MemoryDisplay() {
  const memoryInfo = useLeakDetectionStore((state) => state.memoryInfo);

  return (
    <View>
      <Text>Used Memory: {memoryInfo?.usedMemory} MB</Text>
      <Text>Available: {memoryInfo?.availableMemory} MB</Text>
    </View>
  );
}

🛠️ API Reference

🌟 MonitorMemory Component

<MonitorMemory
  interval?: number;          // Memory check interval (ms)
  sessionDurationMinutes?: number;  // Monitoring session duration
>

🎨 withLeakDetection HOC

withLeakDetection(
  WrappedComponent: React.ComponentType,
  componentName: string
)

🪝 useLeakDetectionStore Hook

const {
  memoryInfo, // Current memory metrics
  leaks, // Detected memory leaks
  startTracking, // Start tracking a component
  stopTracking, // Stop tracking a component
  subscribeToMemoryUpdates, // Subscribe to memory updates
} = useLeakDetectionStore();

📋 Memory Info Type

type MemoryInfo = {
  totalMemory: number; // Total device memory (MB)
  availableMemory: number; // Available memory (MB)
  usedMemory: number; // Used memory (MB)
  appMemory: number; // App's memory usage (MB)
  isLowMemory: boolean; // Low memory warning
  lowMemoryThreshold: number; // Low memory threshold (MB)
};