react-native-inapp-inspector 1.1.3 → 1.1.5

package/README.md

@@ -16,6 +16,10 @@
 
 A self-contained in-app debugging overlay for React Native. Inspect network traffic, console output, analytics events, Redux state, and WebView activity directly inside your app.
 
+<p align="center">
+  <img src="https://raw.githubusercontent.com/vengatmacuser/react-native-inapp-inspector/main/assets/walkthrough.gif" alt="React Native In-App Inspector Walkthrough" width="360" style="border-radius: 20px;" />
+</p>
+
 ---
 
 ## Features
@@ -105,6 +109,22 @@ You can disable the overlay without removing it from your tree:
 
 ---
 
+## Settings Persistence
+
+By default, the inspector preserves configuration preferences (such as dark mode, default landing tab, and module visibilities):
+- **iOS:** Settings are persisted automatically using React Native's built-in `Settings` module (`NSUserDefaults`) with zero configuration or additional packages required.
+- **Android / Custom:** To persist settings on Android (or to use a custom storage mechanism on both platforms), pass a storage instance such as `@react-native-async-storage/async-storage` or `react-native-mmkv` to the `storage` prop:
+
+```tsx
+import AsyncStorage from '@react-native-async-storage/async-storage';
+
+<NetworkInspector storage={AsyncStorage} />
+```
+
+If no `storage` prop is passed, Android will fall back to an in-memory store (settings reset when the app is restarted).
+
+---
+
 ## Network Logging
 
 `setupNetworkLogger()` patches global `fetch`, the default axios instance, and future axios instances created with `axios.create()`.

package/dist/commonjs/components/LogCard.js

@@ -96,8 +96,8 @@ const LogCard = react_1.default.memo(function LogCard({ item, onPress, timelineM
 
           <react_native_1.Text style={styles_1.default.serialNumber}>#{item.id + 1}</react_native_1.Text>
 
-          <react_native_1.View style={[styles_1.default.methodBadge, { backgroundColor: `${methodColor}15` }]}>
-            <react_native_1.Text style={[styles_1.default.methodBadgeText, { color: methodColor }]}>
+          <react_native_1.View style={[styles_1.default.methodBadge, { backgroundColor: methodColor }]}>
+            <react_native_1.Text style={[styles_1.default.methodBadgeText, { color: '#FFFFFF' }]}>
               {item.method}
             </react_native_1.Text>
           </react_native_1.View>

package/dist/commonjs/constants/version.d.ts

@@ -1 +1 @@
-export declare const LIB_VERSION = "1.1.3";
+export declare const LIB_VERSION = "1.1.5";

package/dist/commonjs/constants/version.js

@@ -3,4 +3,4 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.LIB_VERSION = void 0;
 // AUTO-GENERATED FILE — do not edit by hand.
 // Regenerated from package.json on every build by scripts/gen-version.js.
-exports.LIB_VERSION = '1.1.3';
+exports.LIB_VERSION = '1.1.5';

package/dist/commonjs/helpers/settingsStore.d.ts

@@ -1,3 +1,8 @@
+export interface InspectorStorage {
+    getItem: (key: string) => string | null | Promise<string | null>;
+    setItem: (key: string, value: string) => void | Promise<void>;
+}
+export declare function setCustomStorage(storage: InspectorStorage | null): void;
 export interface PersistedSettings {
     isDark?: boolean;
     modalHeightPercent?: number;
@@ -18,7 +23,6 @@ export interface PersistedSettings {
     showDuplicateLogs?: boolean;
 }
 export declare function loadSettings(): Promise<PersistedSettings>;
-/** Debounced save so rapid toggling doesn't hammer storage. */
 export declare function saveSettings(settings: PersistedSettings): void;
 export declare function clearPersistedSettings(): Promise<void>;
 export declare const isPersistentStorageAvailable: () => boolean;

package/dist/commonjs/helpers/settingsStore.js

@@ -1,33 +1,43 @@
 "use strict";
 // #5 — Persistence layer for the inspector's settings selections.
 //
-// Backed by @react-native-async-storage/async-storage when the host app has it
-// installed (most RN apps do), with a transparent in-memory fallback so this
-// library never crashes and never forces a new native dependency.
+// Backed by iOS Settings (NSUserDefaults) for iOS, or custom storage if passed (e.g. AsyncStorage/MMKV).
+// Contains an in-memory fallback for Android or Jest test environments.
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.isPersistentStorageAvailable = void 0;
+exports.setCustomStorage = setCustomStorage;
 exports.loadSettings = loadSettings;
 exports.saveSettings = saveSettings;
 exports.clearPersistedSettings = clearPersistedSettings;
-let storage = null;
-try {
-    // Optional dependency — resolved only if the host app already ships it.
-    const mod = require('@react-native-async-storage/async-storage');
-    storage = mod?.default ?? mod ?? null;
-    if (storage && typeof storage.getItem !== 'function')
-        storage = null;
-}
-catch {
-    storage = null;
-}
+const react_native_1 = require("react-native");
 // In-memory fallback (settings survive for the app session only).
 const memory = new Map();
+let customStorage = null;
+function setCustomStorage(storage) {
+    customStorage = storage;
+}
 const SETTINGS_KEY = 'rn-inapp-inspector.settings.v1';
 async function loadSettings() {
     try {
-        const raw = storage
-            ? await storage.getItem(SETTINGS_KEY)
-            : memory.get(SETTINGS_KEY) ?? null;
+        if (customStorage) {
+            const raw = await customStorage.getItem(SETTINGS_KEY);
+            if (!raw)
+                return {};
+            const parsed = JSON.parse(raw);
+            return parsed && typeof parsed === 'object' ? parsed : {};
+        }
+        if (react_native_1.Platform.OS === 'ios') {
+            const raw = react_native_1.Settings.get(SETTINGS_KEY);
+            if (!raw)
+                return {};
+            if (typeof raw === 'string') {
+                const parsed = JSON.parse(raw);
+                return parsed && typeof parsed === 'object' ? parsed : {};
+            }
+            return raw && typeof raw === 'object' ? raw : {};
+        }
+        // Android/fallback: memory
+        const raw = memory.get(SETTINGS_KEY);
         if (!raw)
             return {};
         const parsed = JSON.parse(raw);
@@ -37,38 +47,46 @@ async function loadSettings() {
         return {};
     }
 }
-let saveTimer = null;
-/** Debounced save so rapid toggling doesn't hammer storage. */
 function saveSettings(settings) {
-    if (saveTimer)
-        clearTimeout(saveTimer);
-    saveTimer = setTimeout(async () => {
-        try {
-            const raw = JSON.stringify(settings);
-            if (storage) {
-                await storage.setItem(SETTINGS_KEY, raw);
-            }
-            else {
-                memory.set(SETTINGS_KEY, raw);
-            }
+    try {
+        const raw = JSON.stringify(settings);
+        if (customStorage) {
+            customStorage.setItem(SETTINGS_KEY, raw);
+            return;
         }
-        catch {
-            // Persistence is best-effort — never crash the host app over it.
+        if (react_native_1.Platform.OS === 'ios') {
+            react_native_1.Settings.set({ [SETTINGS_KEY]: raw });
+            return;
         }
-    }, 250);
+        // Android/fallback: memory
+        memory.set(SETTINGS_KEY, raw);
+    }
+    catch {
+        // ignore
+    }
 }
 async function clearPersistedSettings() {
     try {
-        if (storage) {
-            await storage.removeItem(SETTINGS_KEY);
+        if (customStorage) {
+            if (typeof customStorage.removeItem === 'function') {
+                await customStorage.removeItem(SETTINGS_KEY);
+            }
+            else {
+                await customStorage.setItem(SETTINGS_KEY, '');
+            }
+            return;
         }
-        else {
-            memory.delete(SETTINGS_KEY);
+        if (react_native_1.Platform.OS === 'ios') {
+            react_native_1.Settings.set({ [SETTINGS_KEY]: null });
+            return;
         }
+        memory.delete(SETTINGS_KEY);
     }
     catch {
         // ignore
     }
 }
-const isPersistentStorageAvailable = () => storage != null;
+const isPersistentStorageAvailable = () => {
+    return customStorage !== null || react_native_1.Platform.OS === 'ios';
+};
 exports.isPersistentStorageAvailable = isPersistentStorageAvailable;