react-native-storage-inspector 1.0.2 → 1.0.3

package/README.md

@@ -49,12 +49,11 @@ The component fills its container. The consumer is responsible for header, back
 
 ### Props
 
-| Prop              | Type                | Description                                                                                                                   |
-| ----------------- | ------------------- | ----------------------------------------------------------------------------------------------------------------------------- |
-| `mmkvInstances`   | `MMKV[]`            | **Required for MMKV.** Pass your MMKV instances to inspect.                                                                   |
-| `secureStoreKeys` | `string[]`          | **Required for Secure Store.** Keys to list (no list API).                                                                    |
-| `keychainKeys`    | `string[]`          | Optional. Only for internet credentials (no list API). Generic passwords auto-discovered via `getAllGenericPasswordServices`. |
-| `customAdapters`  | `IStorageAdapter[]` | Optional. Custom adapters for other storages.                                                                                 |
+| Prop              | Type                | Description                                                                                       |
+| ----------------- | ------------------- | ------------------------------------------------------------------------------------------------- |
+| `mmkvInstances`   | `MMKV[]`            | **Required for MMKV.** Pass your MMKV instances to inspect.                                       |
+| `secureStoreKeys` | `string[]`          | Optional. Known keys for Secure Store (no list API). Merged with keys persisted by the inspector. |
+| `customAdapters`  | `IStorageAdapter[]` | Optional. Custom adapters for other storages.                                                     |
 
 ## Expo
 

package/dist/index.d.mts

@@ -16,81 +16,6 @@ interface IStorageAdapter {
     isAvailable(): boolean;
 }
 
-/**
- * AsyncStorage-compatible module interface.
- * Pass your AsyncStorage instance to avoid Metro "unknown module" errors in Expo:
- * @example
- * import AsyncStorage from '@react-native-async-storage/async-storage';
- * createAsyncStorageAdapter(AsyncStorage)
- */
-type AsyncStorageModule = {
-    getAllKeys(): Promise<string[]>;
-    getItem(key: string): Promise<string | null>;
-    setItem(key: string, value: string): Promise<void>;
-    removeItem(key: string): Promise<void>;
-};
-/**
- * Creates an AsyncStorage adapter. Pass the AsyncStorage instance for reliable
- * bundling in Expo/Metro (avoids "unknown module" errors):
- *
- * @example
- * import AsyncStorage from '@react-native-async-storage/async-storage';
- * createAsyncStorageAdapter(AsyncStorage)
- */
-declare function createAsyncStorageAdapter(instance?: AsyncStorageModule | null): IStorageAdapter;
-
-/**
- * Keychain-compatible module. Pass your keychain instance to avoid Metro
- * "unknown module" errors in Expo.
- */
-type KeychainModule = {
-    getAllGenericPasswordServices?(options?: object): Promise<string[]>;
-    getGenericPassword?(options?: {
-        service?: string;
-    }): Promise<{
-        password: string;
-    } | false>;
-    setGenericPassword?(username: string, password: string, options?: {
-        service?: string;
-    }): Promise<{
-        storage: string;
-    } | false>;
-    resetGenericPassword?(options?: {
-        service?: string;
-    }): Promise<void>;
-    setInternetCredentials(server: string, username: string, password: string): Promise<{
-        storage: string;
-    } | false>;
-    getInternetCredentials(server: string): Promise<{
-        username: string;
-        password: string;
-    } | null>;
-    resetInternetCredentials(server: string): Promise<void>;
-};
-/**
- * Keychain adapter. Pass the keychain instance for reliable bundling in Expo:
- * @example import * as Keychain from 'react-native-keychain';
- * createKeychainAdapter([], Keychain)
- */
-declare function createKeychainAdapter(knownKeys?: string[], instance?: KeychainModule | null): IStorageAdapter;
-
-/**
- * expo-secure-store compatible module. Pass the module to avoid Metro
- * "unknown module" errors in Expo.
- */
-type SecureStoreModule = {
-    getItemAsync(key: string): Promise<string | null>;
-    setItemAsync(key: string, value: string): Promise<void>;
-    deleteItemAsync(key: string): Promise<void>;
-};
-/**
- * expo-secure-store has no API to list all keys. Pass knownKeys to inspect
- * those entries. Pass the module for reliable bundling in Expo:
- * @example import * as SecureStore from 'expo-secure-store';
- * createSecureStoreAdapter([], SecureStore)
- */
-declare function createSecureStoreAdapter(knownKeys?: string[], instance?: SecureStoreModule | null): IStorageAdapter;
-
 interface StorageInspectorProps {
     mmkvInstances?: Array<{
         getAllKeys(): string[];
@@ -98,17 +23,10 @@ interface StorageInspectorProps {
         set(k: string, v: string | number | boolean): void;
         delete(k: string): void;
     }>;
-    /** Pass AsyncStorage to avoid Metro "unknown module" in Expo. */
-    asyncStorageInstance?: AsyncStorageModule | null;
-    keychainKeys?: string[];
-    /** Pass Keychain module to avoid Metro "unknown module" in Expo. */
-    keychainInstance?: KeychainModule | null;
     secureStoreKeys?: string[];
-    /** Pass SecureStore module to avoid Metro "unknown module" in Expo. */
-    secureStoreInstance?: SecureStoreModule | null;
     customAdapters?: IStorageAdapter[];
 }
-declare function StorageInspector({ mmkvInstances, asyncStorageInstance, keychainKeys: keychainKeysProp, keychainInstance, secureStoreKeys: secureStoreKeysProp, secureStoreInstance, customAdapters, }: StorageInspectorProps): React.JSX.Element;
+declare function StorageInspector(props: StorageInspectorProps): React.JSX.Element;
 
 /**
  * Centralized user-facing text for the storage inspector.
@@ -116,19 +34,18 @@ declare function StorageInspector({ mmkvInstances, asyncStorageInstance, keychai
  */
 declare const strings: {
     readonly noAdapterAvailable: "No storage adapter available. Install at least one of: react-native-mmkv, @react-native-async-storage/async-storage, react-native-keychain, expo-secure-store";
-    readonly keychainHint: "No generic password items yet. Add a key using + above, or pass keychainKeys for internet credentials.";
+    readonly keychainHint: "No generic password items yet. Add a key using + above.";
     readonly secureStoreHint: "Secure Store has no list API. Pass secureStoreKeys prop with known keys, or add a key using + above.";
     readonly loading: "Loading…";
     readonly noItems: "No items";
     readonly valueLabel: "Value";
-    readonly emptyValue: "(empty)";
     readonly charCount: (n: number) => string;
     readonly deleteItemTitle: (key: string) => string;
     readonly deleteItemMessage: (key: string) => string;
     readonly clearAllTitle: (name: string) => string;
     readonly clearAllMessage: (count: number, name: string) => string;
     readonly storageNotAvailable: "This storage is not available.";
-    readonly keychainHintShort: "No items yet. Add a key below, or pass keychainKeys for internet credentials.";
+    readonly keychainHintShort: "No items yet. Add a key below.";
     readonly edit: "Edit";
     readonly delete: "Delete";
     readonly addItem: "Add item";
@@ -163,6 +80,7 @@ declare const theme: {
         readonly textSecondary: "#666666";
         readonly textMuted: "#999999";
         readonly inverted: "#ffffff";
+        readonly overlayBackdrop: "rgba(0,0,0,0.5)";
     };
 };
 type Theme = typeof theme;
@@ -175,4 +93,56 @@ type MMKVInstance = {
 };
 declare function createMMKVAdapter(instance: MMKVInstance, name?: string): IStorageAdapter;
 
+/**
+ * AsyncStorage-compatible module interface.
+ */
+type AsyncStorageModule = {
+    getAllKeys(): Promise<string[]>;
+    getItem(key: string): Promise<string | null>;
+    setItem(key: string, value: string): Promise<void>;
+    removeItem(key: string): Promise<void>;
+};
+/**
+ * Creates an AsyncStorage adapter.
+ */
+declare function createAsyncStorageAdapter(): IStorageAdapter;
+
+/**
+ * Keychain-compatible module (generic password only).
+ */
+type KeychainModule = {
+    getAllGenericPasswordServices?(options?: object): Promise<string[]>;
+    getGenericPassword?(options?: {
+        service?: string;
+    }): Promise<{
+        password: string;
+    } | false>;
+    setGenericPassword?(username: string, password: string, options?: {
+        service?: string;
+    }): Promise<{
+        storage: string;
+    } | false>;
+    resetGenericPassword?(options?: {
+        service?: string;
+    }): Promise<void>;
+};
+/**
+ * Creates a Keychain adapter.
+ */
+declare function createKeychainAdapter(): IStorageAdapter;
+
+/**
+ * expo-secure-store compatible module. Pass the module to avoid Metro
+ * "unknown module" errors in Expo.
+ */
+type SecureStoreModule = {
+    getItemAsync(key: string): Promise<string | null>;
+    setItemAsync(key: string, value: string): Promise<void>;
+    deleteItemAsync(key: string): Promise<void>;
+};
+/**
+ * Creates a Secure Store adapter. Since expo-secure-store has no API to list all keys, we persist the list of keys in Secure Store.
+ */
+declare function createSecureStoreAdapter(knownKeys?: string[]): IStorageAdapter;
+
 export { type AsyncStorageModule, type IStorageAdapter, type KeychainModule, type SecureStoreModule, StorageInspector, type StorageInspectorProps, type StorageItem, type Theme, createAsyncStorageAdapter, createKeychainAdapter, createMMKVAdapter, createSecureStoreAdapter, strings, theme };

package/dist/index.d.ts

@@ -16,81 +16,6 @@ interface IStorageAdapter {
     isAvailable(): boolean;
 }
 
-/**
- * AsyncStorage-compatible module interface.
- * Pass your AsyncStorage instance to avoid Metro "unknown module" errors in Expo:
- * @example
- * import AsyncStorage from '@react-native-async-storage/async-storage';
- * createAsyncStorageAdapter(AsyncStorage)
- */
-type AsyncStorageModule = {
-    getAllKeys(): Promise<string[]>;
-    getItem(key: string): Promise<string | null>;
-    setItem(key: string, value: string): Promise<void>;
-    removeItem(key: string): Promise<void>;
-};
-/**
- * Creates an AsyncStorage adapter. Pass the AsyncStorage instance for reliable
- * bundling in Expo/Metro (avoids "unknown module" errors):
- *
- * @example
- * import AsyncStorage from '@react-native-async-storage/async-storage';
- * createAsyncStorageAdapter(AsyncStorage)
- */
-declare function createAsyncStorageAdapter(instance?: AsyncStorageModule | null): IStorageAdapter;
-
-/**
- * Keychain-compatible module. Pass your keychain instance to avoid Metro
- * "unknown module" errors in Expo.
- */
-type KeychainModule = {
-    getAllGenericPasswordServices?(options?: object): Promise<string[]>;
-    getGenericPassword?(options?: {
-        service?: string;
-    }): Promise<{
-        password: string;
-    } | false>;
-    setGenericPassword?(username: string, password: string, options?: {
-        service?: string;
-    }): Promise<{
-        storage: string;
-    } | false>;
-    resetGenericPassword?(options?: {
-        service?: string;
-    }): Promise<void>;
-    setInternetCredentials(server: string, username: string, password: string): Promise<{
-        storage: string;
-    } | false>;
-    getInternetCredentials(server: string): Promise<{
-        username: string;
-        password: string;
-    } | null>;
-    resetInternetCredentials(server: string): Promise<void>;
-};
-/**
- * Keychain adapter. Pass the keychain instance for reliable bundling in Expo:
- * @example import * as Keychain from 'react-native-keychain';
- * createKeychainAdapter([], Keychain)
- */
-declare function createKeychainAdapter(knownKeys?: string[], instance?: KeychainModule | null): IStorageAdapter;
-
-/**
- * expo-secure-store compatible module. Pass the module to avoid Metro
- * "unknown module" errors in Expo.
- */
-type SecureStoreModule = {
-    getItemAsync(key: string): Promise<string | null>;
-    setItemAsync(key: string, value: string): Promise<void>;
-    deleteItemAsync(key: string): Promise<void>;
-};
-/**
- * expo-secure-store has no API to list all keys. Pass knownKeys to inspect
- * those entries. Pass the module for reliable bundling in Expo:
- * @example import * as SecureStore from 'expo-secure-store';
- * createSecureStoreAdapter([], SecureStore)
- */
-declare function createSecureStoreAdapter(knownKeys?: string[], instance?: SecureStoreModule | null): IStorageAdapter;
-
 interface StorageInspectorProps {
     mmkvInstances?: Array<{
         getAllKeys(): string[];
@@ -98,17 +23,10 @@ interface StorageInspectorProps {
         set(k: string, v: string | number | boolean): void;
         delete(k: string): void;
     }>;
-    /** Pass AsyncStorage to avoid Metro "unknown module" in Expo. */
-    asyncStorageInstance?: AsyncStorageModule | null;
-    keychainKeys?: string[];
-    /** Pass Keychain module to avoid Metro "unknown module" in Expo. */
-    keychainInstance?: KeychainModule | null;
     secureStoreKeys?: string[];
-    /** Pass SecureStore module to avoid Metro "unknown module" in Expo. */
-    secureStoreInstance?: SecureStoreModule | null;
     customAdapters?: IStorageAdapter[];
 }
-declare function StorageInspector({ mmkvInstances, asyncStorageInstance, keychainKeys: keychainKeysProp, keychainInstance, secureStoreKeys: secureStoreKeysProp, secureStoreInstance, customAdapters, }: StorageInspectorProps): React.JSX.Element;
+declare function StorageInspector(props: StorageInspectorProps): React.JSX.Element;
 
 /**
  * Centralized user-facing text for the storage inspector.
@@ -116,19 +34,18 @@ declare function StorageInspector({ mmkvInstances, asyncStorageInstance, keychai
  */
 declare const strings: {
     readonly noAdapterAvailable: "No storage adapter available. Install at least one of: react-native-mmkv, @react-native-async-storage/async-storage, react-native-keychain, expo-secure-store";
-    readonly keychainHint: "No generic password items yet. Add a key using + above, or pass keychainKeys for internet credentials.";
+    readonly keychainHint: "No generic password items yet. Add a key using + above.";
     readonly secureStoreHint: "Secure Store has no list API. Pass secureStoreKeys prop with known keys, or add a key using + above.";
     readonly loading: "Loading…";
     readonly noItems: "No items";
     readonly valueLabel: "Value";
-    readonly emptyValue: "(empty)";
     readonly charCount: (n: number) => string;
     readonly deleteItemTitle: (key: string) => string;
     readonly deleteItemMessage: (key: string) => string;
     readonly clearAllTitle: (name: string) => string;
     readonly clearAllMessage: (count: number, name: string) => string;
     readonly storageNotAvailable: "This storage is not available.";
-    readonly keychainHintShort: "No items yet. Add a key below, or pass keychainKeys for internet credentials.";
+    readonly keychainHintShort: "No items yet. Add a key below.";
     readonly edit: "Edit";
     readonly delete: "Delete";
     readonly addItem: "Add item";
@@ -163,6 +80,7 @@ declare const theme: {
         readonly textSecondary: "#666666";
         readonly textMuted: "#999999";
         readonly inverted: "#ffffff";
+        readonly overlayBackdrop: "rgba(0,0,0,0.5)";
     };
 };
 type Theme = typeof theme;
@@ -175,4 +93,56 @@ type MMKVInstance = {
 };
 declare function createMMKVAdapter(instance: MMKVInstance, name?: string): IStorageAdapter;
 
+/**
+ * AsyncStorage-compatible module interface.
+ */
+type AsyncStorageModule = {
+    getAllKeys(): Promise<string[]>;
+    getItem(key: string): Promise<string | null>;
+    setItem(key: string, value: string): Promise<void>;
+    removeItem(key: string): Promise<void>;
+};
+/**
+ * Creates an AsyncStorage adapter.
+ */
+declare function createAsyncStorageAdapter(): IStorageAdapter;
+
+/**
+ * Keychain-compatible module (generic password only).
+ */
+type KeychainModule = {
+    getAllGenericPasswordServices?(options?: object): Promise<string[]>;
+    getGenericPassword?(options?: {
+        service?: string;
+    }): Promise<{
+        password: string;
+    } | false>;
+    setGenericPassword?(username: string, password: string, options?: {
+        service?: string;
+    }): Promise<{
+        storage: string;
+    } | false>;
+    resetGenericPassword?(options?: {
+        service?: string;
+    }): Promise<void>;
+};
+/**
+ * Creates a Keychain adapter.
+ */
+declare function createKeychainAdapter(): IStorageAdapter;
+
+/**
+ * expo-secure-store compatible module. Pass the module to avoid Metro
+ * "unknown module" errors in Expo.
+ */
+type SecureStoreModule = {
+    getItemAsync(key: string): Promise<string | null>;
+    setItemAsync(key: string, value: string): Promise<void>;
+    deleteItemAsync(key: string): Promise<void>;
+};
+/**
+ * Creates a Secure Store adapter. Since expo-secure-store has no API to list all keys, we persist the list of keys in Secure Store.
+ */
+declare function createSecureStoreAdapter(knownKeys?: string[]): IStorageAdapter;
+
 export { type AsyncStorageModule, type IStorageAdapter, type KeychainModule, type SecureStoreModule, StorageInspector, type StorageInspectorProps, type StorageItem, type Theme, createAsyncStorageAdapter, createKeychainAdapter, createMMKVAdapter, createSecureStoreAdapter, strings, theme };