@buoy-gg/storage 7.0.41 → 7.0.42

package/lib/module/storage/hooks/useMMKVInstances.js

@@ -1,204 +1 @@
-"use strict";
-
-/**
- * useMMKVInstances Hook
- *
- * React hook to monitor all registered MMKV instances and their metadata.
- * Works with MMKVInstanceRegistry to provide UI components with instance information.
- *
- * This hook enables:
- * - Multi-instance dropdown/selector UI
- * - Instance metadata display (encrypted, readOnly, key count)
- * - Dynamic updates when instances are added/removed
- *
- * @see MMKVInstanceRegistry.ts for instance registration
- */
-
-import { useState, useEffect } from 'react';
-// The registry is pure JS (no react-native-mmkv dependency) — import it
-// unconditionally so registered instances show up even without the native
-// module (e.g. remote-backed wrappers on the desktop dashboard).
-import { mmkvInstanceRegistry } from '../utils/MMKVInstanceRegistry';
-
-/**
- * Metadata about an MMKV instance with additional runtime information
- */
-
-/**
- * Hook to monitor all registered MMKV instances
- *
- * @param autoRefresh - If true, refreshes every 1 second to detect new instances
- *
- * @returns Object containing instances array, count, and refresh function
- *
- * @example
- * ```typescript
- * import { useMMKVInstances } from '@buoy-gg/storage';
- *
- * function MMKVInstanceSelector() {
- *   const { instances, instanceCount, refresh } = useMMKVInstances();
- *
- *   return (
- *     <View>
- *       <Text>Found {instanceCount} MMKV instances</Text>
- *       {instances.map(inst => (
- *         <TouchableOpacity key={inst.id} onPress={() => selectInstance(inst)}>
- *           <Text>{inst.id}</Text>
- *           <Text>{inst.keyCount} keys</Text>
- *           {inst.encrypted && <Text>🔒 Encrypted</Text>}
- *           {inst.readOnly && <Text>👁️ Read-only</Text>}
- *         </TouchableOpacity>
- *       ))}
- *       <Button onPress={refresh}>Refresh</Button>
- *     </View>
- *   );
- * }
- * ```
- */
-export function useMMKVInstances(autoRefresh = false) {
-  const [instances, setInstances] = useState([]);
-  const [isLoading, setIsLoading] = useState(true);
-
-  // Fetch all instances and their metadata
-  const fetchInstances = () => {
-    setIsLoading(true);
-    try {
-      const allInstances = mmkvInstanceRegistry.getAll();
-
-      // Enhance with metadata
-      const instancesWithMetadata = allInstances.map(instanceInfo => {
-        const {
-          instance,
-          id,
-          encrypted,
-          readOnly
-        } = instanceInfo;
-
-        // Get key count
-        const keys = instance.getAllKeys();
-        const keyCount = keys?.length || 0;
-
-        // Get size if available (MMKV might not expose this directly)
-        // For now, we don't have a direct way to get size
-        const size = undefined;
-        return {
-          id,
-          instance,
-          encrypted,
-          readOnly,
-          keyCount,
-          size
-        };
-      });
-      setInstances(instancesWithMetadata);
-    } catch (error) {
-      setInstances([]);
-    } finally {
-      setIsLoading(false);
-    }
-  };
-
-  // Initial fetch
-  useEffect(() => {
-    fetchInstances();
-  }, []);
-
-  // Auto-refresh if enabled
-  useEffect(() => {
-    if (!autoRefresh) return;
-    const interval = setInterval(() => {
-      fetchInstances();
-    }, 1000); // Refresh every second
-
-    return () => clearInterval(interval);
-  }, [autoRefresh]);
-  return {
-    instances,
-    instanceCount: instances.length,
-    isLoading,
-    refresh: fetchInstances
-  };
-}
-
-/**
- * Hook to monitor a single MMKV instance by ID
- *
- * @param instanceId - ID of the instance to monitor
- *
- * @returns Instance metadata or null if not found
- *
- * @example
- * ```typescript
- * function MMKVInstanceDetail({ instanceId }: { instanceId: string }) {
- *   const instance = useMMKVInstance(instanceId);
- *
- *   if (!instance) {
- *     return <Text>Instance not found</Text>;
- *   }
- *
- *   return (
- *     <View>
- *       <Text>ID: {instance.id}</Text>
- *       <Text>Keys: {instance.keyCount}</Text>
- *       <Text>Encrypted: {instance.encrypted ? 'Yes' : 'No'}</Text>
- *       <Text>Read-only: {instance.readOnly ? 'Yes' : 'No'}</Text>
- *     </View>
- *   );
- * }
- * ```
- */
-export function useMMKVInstance(instanceId) {
-  const [instance, setInstance] = useState(null);
-  useEffect(() => {
-    if (!mmkvInstanceRegistry) {
-      setInstance(null);
-      return;
-    }
-    const instanceInfo = mmkvInstanceRegistry.get(instanceId);
-    if (!instanceInfo) {
-      setInstance(null);
-      return;
-    }
-    const keys = instanceInfo.instance.getAllKeys();
-    const keyCount = keys?.length || 0;
-    setInstance({
-      ...instanceInfo,
-      keyCount,
-      size: undefined
-    });
-  }, [instanceId]);
-  return instance;
-}
-
-/**
- * Hook to check if a specific instance ID is registered
- *
- * @param instanceId - ID to check
- *
- * @returns True if instance is registered
- *
- * @example
- * ```typescript
- * function MMKVStatus({ instanceId }: { instanceId: string }) {
- *   const isRegistered = useMMKVInstanceExists(instanceId);
- *
- *   return (
- *     <View>
- *       <Text>{instanceId}</Text>
- *       <Text>{isRegistered ? '✅ Registered' : '❌ Not registered'}</Text>
- *     </View>
- *   );
- * }
- * ```
- */
-export function useMMKVInstanceExists(instanceId) {
-  const [exists, setExists] = useState(false);
-  useEffect(() => {
-    if (!mmkvInstanceRegistry) {
-      setExists(false);
-      return;
-    }
-    setExists(mmkvInstanceRegistry.has(instanceId));
-  }, [instanceId]);
-  return exists;
-}
+"use strict";import{useState as i,useEffect as l}from"react";import{mmkvInstanceRegistry as c}from"../utils/MMKVInstanceRegistry";export function useMMKVInstances(n=false){const[e,t]=i([]);const[s,a]=i(true);const r=()=>{a(true);try{const o=c.getAll();const f=o.map(y=>{const{instance:u,id:g,encrypted:I,readOnly:d}=y;const h=u.getAllKeys();const m=h?.length||0;const p=void 0;return{id:g,instance:u,encrypted:I,readOnly:d,keyCount:m,size:p}});t(f)}catch(o){t([])}finally{a(false)}};l(()=>{r()},[]);l(()=>{if(!n)return;const o=setInterval(()=>{r()},1e3);return()=>clearInterval(o)},[n]);return{instances:e,instanceCount:e.length,isLoading:s,refresh:r}}export function useMMKVInstance(n){const[e,t]=i(null);l(()=>{if(!c){t(null);return}const s=c.get(n);if(!s){t(null);return}const a=s.instance.getAllKeys();const r=a?.length||0;t({...s,keyCount:r,size:void 0})},[n]);return e}export function useMMKVInstanceExists(n){const[e,t]=i(false);l(()=>{if(!c){t(false);return}t(c.has(n))},[n]);return e}

package/lib/module/storage/hooks/useMMKVKeys.js

@@ -1,371 +1 @@
-"use strict";
-
-/**
- * useMMKVKeys Hook
- *
- * Fetch and validate MMKV keys from a specific MMKV instance.
- * Equivalent to useAsyncStorageKeys but for MMKV storage.
- *
- * Key Differences from AsyncStorage:
- * - Synchronous API (getAllKeys(), getString(), etc.)
- * - Native types (string, number, boolean, buffer) vs string-only
- * - Multi-instance support (requires instanceId parameter)
- * - No multiGet - must fetch keys individually
- */
-
-import { useState, useEffect, useCallback, useRef } from 'react';
-import { requiredKeyAppliesTo } from '../utils/requiredStorageKeyScope';
-// Pure-JS utilities (no react-native-mmkv dependency) — safe to import
-// unconditionally. They operate on whatever instance objects are registered,
-// including remote-backed wrappers on the desktop dashboard.
-import { detectMMKVType, isTypeMatch } from '../utils/mmkvTypeDetection';
-
-// Conditionally import MMKV types
-// Use 'any' to avoid hard dependency on react-native-mmkv
-
-/**
- * Hook to fetch and monitor keys from an MMKV instance
- *
- * @param instance - MMKV instance to monitor
- * @param instanceId - Unique identifier for this instance (e.g., "mmkv.default", "secure")
- * @param requiredStorageKeys - Optional array of required keys for validation
- *
- * @example
- * ```typescript
- * import { MMKV } from 'react-native-mmkv';
- * import { useMMKVKeys } from '@buoy-gg/storage';
- *
- * const storage = new MMKV();
- *
- * function MyComponent() {
- *   const { storageKeys, isLoading, error, refresh } = useMMKVKeys(
- *     storage,
- *     'mmkv.default',
- *     [
- *       'user.token',
- *       { key: 'user.id', expectedType: 'number' },
- *       { key: 'app.theme', expectedValue: 'dark' }
- *     ]
- *   );
- *
- *   if (isLoading) return <LoadingSpinner />;
- *   if (error) return <ErrorMessage error={error} />;
- *
- *   return (
- *     <View>
- *       {storageKeys.map(keyInfo => (
- *         <StorageKeyCard key={keyInfo.key} keyInfo={keyInfo} />
- *       ))}
- *       <Button onPress={refresh}>Refresh</Button>
- *     </View>
- *   );
- * }
- * ```
- */
-export function useMMKVKeys(instance, instanceId, requiredStorageKeys = []) {
-  // State management
-  const [storageKeys, setStorageKeys] = useState([]);
-  const [isLoading, setIsLoading] = useState(true);
-  const [error, setError] = useState(null);
-
-  // Depend on a stable content signature rather than the array identity — a
-  // fresh `requiredStorageKeys` literal each render would otherwise loop the
-  // fetch effect. Read the latest array via ref inside the fetch.
-  const requiredSignature = JSON.stringify(requiredStorageKeys);
-  const requiredRef = useRef(requiredStorageKeys);
-  requiredRef.current = requiredStorageKeys;
-
-  // Fetch all keys and values from MMKV instance
-  const fetchStorageData = useCallback(() => {
-    const requiredStorageKeys = requiredRef.current;
-    setIsLoading(true);
-    setError(null);
-    try {
-      // Guard: Check if instance is provided. (No isMMKVAvailable() gate —
-      // registered instances may be remote-backed wrappers with no native
-      // module, e.g. on the desktop dashboard.)
-      if (!instance) {
-        setStorageKeys([]);
-        setIsLoading(false);
-        return; // Silently return empty when no instance
-      }
-
-      // 1. Get all keys from MMKV (synchronous)
-      const allKeys = instance.getAllKeys();
-      if (!allKeys || allKeys.length === 0) {
-        // Still need to check for missing required keys scoped to MMKV
-        const missingRequiredKeys = requiredStorageKeys.filter(req => requiredKeyAppliesTo(req, 'mmkv')).map(req => {
-          const key = typeof req === 'string' ? req : req.key;
-          const description = typeof req === 'object' ? req.description : undefined;
-          const expectedValue = typeof req === 'object' ? req.expectedValue : undefined;
-          const expectedType = typeof req === 'object' ? req.expectedType : undefined;
-          return {
-            key,
-            value: undefined,
-            valueType: undefined,
-            storageType: 'mmkv',
-            instanceId,
-            status: 'required_missing',
-            category: 'required',
-            description,
-            expectedValue,
-            expectedType
-          };
-        });
-        setStorageKeys(missingRequiredKeys);
-        setIsLoading(false);
-        return;
-      }
-
-      // 2. Process each key to get value and type
-      const allStorageKeys = [];
-      allKeys.forEach(key => {
-        // Detect value and type using type detection utility
-        const {
-          value,
-          type
-        } = detectMMKVType(instance, key);
-
-        // Check if this is a required key scoped to MMKV
-        const requiredConfig = requiredStorageKeys.find(req => {
-          if (!requiredKeyAppliesTo(req, 'mmkv')) return false;
-          if (typeof req === 'string') return req === key;
-          return req.key === key;
-        });
-
-        // Determine status based on validation rules
-        let status = 'optional_present';
-        if (requiredConfig) {
-          if (value === undefined) {
-            status = 'required_missing';
-          } else if (typeof requiredConfig === 'object' && requiredConfig.expectedValue !== undefined) {
-            // Value validation
-            status = String(value) === String(requiredConfig.expectedValue) ? 'required_present' : 'required_wrong_value';
-          } else if (typeof requiredConfig === 'object' && requiredConfig.expectedType !== undefined) {
-            // Type validation
-            status = isTypeMatch(type, requiredConfig.expectedType) ? 'required_present' : 'required_wrong_type';
-          } else {
-            // Key exists and is required (no specific validation)
-            status = 'required_present';
-          }
-        }
-
-        // Build StorageKeyInfo object
-        const keyInfo = {
-          key,
-          value,
-          valueType: type !== 'unknown' ? type : undefined,
-          storageType: 'mmkv',
-          instanceId,
-          status,
-          category: requiredConfig ? 'required' : 'optional',
-          lastUpdated: new Date(),
-          ...(typeof requiredConfig === 'object' && requiredConfig.expectedValue !== undefined && {
-            expectedValue: requiredConfig.expectedValue
-          }),
-          ...(typeof requiredConfig === 'object' && requiredConfig.expectedType !== undefined && {
-            expectedType: requiredConfig.expectedType
-          }),
-          ...(typeof requiredConfig === 'object' && requiredConfig.description !== undefined && {
-            description: requiredConfig.description
-          })
-        };
-        allStorageKeys.push(keyInfo);
-      });
-
-      // 3. Add missing required keys that weren't found in storage
-      requiredStorageKeys.forEach(req => {
-        if (!requiredKeyAppliesTo(req, 'mmkv')) return;
-        const key = typeof req === 'string' ? req : req.key;
-        const exists = allStorageKeys.some(k => k.key === key);
-        if (!exists) {
-          allStorageKeys.push({
-            key,
-            value: undefined,
-            valueType: undefined,
-            storageType: 'mmkv',
-            instanceId,
-            status: 'required_missing',
-            category: 'required',
-            ...(typeof req === 'object' && req.expectedValue !== undefined && {
-              expectedValue: req.expectedValue
-            }),
-            ...(typeof req === 'object' && req.expectedType !== undefined && {
-              expectedType: req.expectedType
-            }),
-            ...(typeof req === 'object' && req.description !== undefined && {
-              description: req.description
-            })
-          });
-        }
-      });
-      setStorageKeys(allStorageKeys);
-    } catch (err) {
-      setError(err instanceof Error ? err : new Error('Failed to fetch MMKV storage data'));
-      setStorageKeys([]);
-    } finally {
-      setIsLoading(false);
-    }
-    // eslint-disable-next-line react-hooks/exhaustive-deps
-  }, [instance, instanceId, requiredSignature]);
-
-  // Initial fetch
-  useEffect(() => {
-    fetchStorageData();
-  }, [fetchStorageData]);
-  return {
-    storageKeys,
-    isLoading,
-    error,
-    refresh: fetchStorageData
-  };
-}
-
-/**
- * Hook to fetch keys from multiple MMKV instances
- *
- * @param instances - Array of MMKV instances with their IDs
- * @param requiredStorageKeys - Optional array of required keys for validation
- *
- * @example
- * ```typescript
- * import { MMKV } from 'react-native-mmkv';
- * import { useMultiMMKVKeys } from '@buoy-gg/storage';
- *
- * const defaultStorage = new MMKV();
- * const secureStorage = new MMKV({ id: 'secure', encryptionKey: key });
- *
- * function MyComponent() {
- *   const { storageKeys, isLoading, error } = useMultiMMKVKeys(
- *     [
- *       { instance: defaultStorage, id: 'mmkv.default' },
- *       { instance: secureStorage, id: 'secure' }
- *     ],
- *     ['user.token', 'app.theme']
- *   );
- *
- *   // storageKeys will contain keys from both instances
- *   // with instanceId field to identify which instance each key belongs to
- * }
- * ```
- */
-export function useMultiMMKVKeys(instances, requiredStorageKeys = []) {
-  const [storageKeys, setStorageKeys] = useState([]);
-  const [isLoading, setIsLoading] = useState(true);
-  const [error, setError] = useState(null);
-
-  // Depend on a stable content signature rather than the array identity — a
-  // fresh `requiredStorageKeys` literal each render would otherwise loop the
-  // fetch effect. Read the latest array via ref inside the fetch.
-  const requiredSignature = JSON.stringify(requiredStorageKeys);
-  const requiredRef = useRef(requiredStorageKeys);
-  requiredRef.current = requiredStorageKeys;
-  const fetchStorageData = useCallback(() => {
-    const requiredStorageKeys = requiredRef.current;
-    setIsLoading(true);
-    setError(null);
-    try {
-      const allStorageKeys = [];
-
-      // Fetch keys from each instance
-      instances.forEach(({
-        instance,
-        id
-      }) => {
-        const allKeys = instance.getAllKeys();
-        if (!allKeys || allKeys.length === 0) {
-          return;
-        }
-        allKeys.forEach(key => {
-          const {
-            value,
-            type
-          } = detectMMKVType(instance, key);
-          const requiredConfig = requiredStorageKeys.find(req => {
-            if (!requiredKeyAppliesTo(req, 'mmkv')) return false;
-            if (typeof req === 'string') return req === key;
-            return req.key === key;
-          });
-          let status = 'optional_present';
-          if (requiredConfig) {
-            if (value === undefined) {
-              status = 'required_missing';
-            } else if (typeof requiredConfig === 'object' && requiredConfig.expectedValue !== undefined) {
-              status = String(value) === String(requiredConfig.expectedValue) ? 'required_present' : 'required_wrong_value';
-            } else if (typeof requiredConfig === 'object' && requiredConfig.expectedType !== undefined) {
-              status = isTypeMatch(type, requiredConfig.expectedType) ? 'required_present' : 'required_wrong_type';
-            } else {
-              status = 'required_present';
-            }
-          }
-          const keyInfo = {
-            key,
-            value,
-            valueType: type !== 'unknown' ? type : undefined,
-            storageType: 'mmkv',
-            instanceId: id,
-            status,
-            category: requiredConfig ? 'required' : 'optional',
-            lastUpdated: new Date(),
-            ...(typeof requiredConfig === 'object' && requiredConfig.expectedValue !== undefined && {
-              expectedValue: requiredConfig.expectedValue
-            }),
-            ...(typeof requiredConfig === 'object' && requiredConfig.expectedType !== undefined && {
-              expectedType: requiredConfig.expectedType
-            }),
-            ...(typeof requiredConfig === 'object' && requiredConfig.description !== undefined && {
-              description: requiredConfig.description
-            })
-          };
-          allStorageKeys.push(keyInfo);
-        });
-      });
-
-      // Add missing required keys scoped to MMKV
-      requiredStorageKeys.forEach(req => {
-        if (!requiredKeyAppliesTo(req, 'mmkv')) return;
-        const key = typeof req === 'string' ? req : req.key;
-        const exists = allStorageKeys.some(k => k.key === key);
-        if (!exists) {
-          // Add missing key for first instance (or all instances?)
-          // For now, add to first instance
-          const firstInstanceId = instances[0]?.id || 'mmkv.default';
-          allStorageKeys.push({
-            key,
-            value: undefined,
-            valueType: undefined,
-            storageType: 'mmkv',
-            instanceId: firstInstanceId,
-            status: 'required_missing',
-            category: 'required',
-            ...(typeof req === 'object' && req.expectedValue !== undefined && {
-              expectedValue: req.expectedValue
-            }),
-            ...(typeof req === 'object' && req.expectedType !== undefined && {
-              expectedType: req.expectedType
-            }),
-            ...(typeof req === 'object' && req.description !== undefined && {
-              description: req.description
-            })
-          });
-        }
-      });
-      setStorageKeys(allStorageKeys);
-    } catch (err) {
-      setError(err instanceof Error ? err : new Error('Failed to fetch multi-MMKV storage data'));
-      setStorageKeys([]);
-    } finally {
-      setIsLoading(false);
-    }
-    // eslint-disable-next-line react-hooks/exhaustive-deps
-  }, [instances, requiredSignature]);
-  useEffect(() => {
-    fetchStorageData();
-  }, [fetchStorageData]);
-  return {
-    storageKeys,
-    isLoading,
-    error,
-    refresh: fetchStorageData
-  };
-}
+"use strict";import{useState as x,useEffect as j,useCallback as K,useRef as S}from"react";import{requiredKeyAppliesTo as T}from"../utils/requiredStorageKeyScope";import{detectMMKVType as E,isTypeMatch as M}from"../utils/mmkvTypeDetection";export function useMMKVKeys(p,c,m=[]){const[v,f]=x([]);const[V,a]=x(true);const[_,b]=x(null);const h=JSON.stringify(m);const y=S(m);y.current=m;const l=K(()=>{const i=y.current;a(true);b(null);try{if(!p){f([]);a(false);return}const r=p.getAllKeys();if(!r||r.length===0){const t=i.filter(e=>T(e,"mmkv")).map(e=>{const d=typeof e==="string"?e:e.key;const n=typeof e==="object"?e.description:void 0;const o=typeof e==="object"?e.expectedValue:void 0;const u=typeof e==="object"?e.expectedType:void 0;return{key:d,value:void 0,valueType:void 0,storageType:"mmkv",instanceId:c,status:"required_missing",category:"required",description:n,expectedValue:o,expectedType:u}});f(t);a(false);return}const s=[];r.forEach(t=>{const{value:e,type:d}=E(p,t);const n=i.find(g=>{if(!T(g,"mmkv"))return false;if(typeof g==="string")return g===t;return g.key===t});let o="optional_present";if(n){if(e===void 0){o="required_missing"}else if(typeof n==="object"&&n.expectedValue!==void 0){o=String(e)===String(n.expectedValue)?"required_present":"required_wrong_value"}else if(typeof n==="object"&&n.expectedType!==void 0){o=M(d,n.expectedType)?"required_present":"required_wrong_type"}else{o="required_present"}}const u={key:t,value:e,valueType:d!=="unknown"?d:void 0,storageType:"mmkv",instanceId:c,status:o,category:n?"required":"optional",lastUpdated:new Date,...typeof n==="object"&&n.expectedValue!==void 0&&{expectedValue:n.expectedValue},...typeof n==="object"&&n.expectedType!==void 0&&{expectedType:n.expectedType},...typeof n==="object"&&n.description!==void 0&&{description:n.description}};s.push(u)});i.forEach(t=>{if(!T(t,"mmkv"))return;const e=typeof t==="string"?t:t.key;const d=s.some(n=>n.key===e);if(!d){s.push({key:e,value:void 0,valueType:void 0,storageType:"mmkv",instanceId:c,status:"required_missing",category:"required",...typeof t==="object"&&t.expectedValue!==void 0&&{expectedValue:t.expectedValue},...typeof t==="object"&&t.expectedType!==void 0&&{expectedType:t.expectedType},...typeof t==="object"&&t.description!==void 0&&{description:t.description}})}});f(s)}catch(r){b(r instanceof Error?r:new Error("Failed to fetch MMKV storage data"));f([])}finally{a(false)}},[p,c,h]);j(()=>{l()},[l]);return{storageKeys:v,isLoading:V,error:_,refresh:l}}export function useMultiMMKVKeys(p,c=[]){const[m,v]=x([]);const[f,V]=x(true);const[a,_]=x(null);const b=JSON.stringify(c);const h=S(c);h.current=c;const y=K(()=>{const l=h.current;V(true);_(null);try{const i=[];p.forEach(({instance:r,id:s})=>{const t=r.getAllKeys();if(!t||t.length===0){return}t.forEach(e=>{const{value:d,type:n}=E(r,e);const o=l.find(k=>{if(!T(k,"mmkv"))return false;if(typeof k==="string")return k===e;return k.key===e});let u="optional_present";if(o){if(d===void 0){u="required_missing"}else if(typeof o==="object"&&o.expectedValue!==void 0){u=String(d)===String(o.expectedValue)?"required_present":"required_wrong_value"}else if(typeof o==="object"&&o.expectedType!==void 0){u=M(n,o.expectedType)?"required_present":"required_wrong_type"}else{u="required_present"}}const g={key:e,value:d,valueType:n!=="unknown"?n:void 0,storageType:"mmkv",instanceId:s,status:u,category:o?"required":"optional",lastUpdated:new Date,...typeof o==="object"&&o.expectedValue!==void 0&&{expectedValue:o.expectedValue},...typeof o==="object"&&o.expectedType!==void 0&&{expectedType:o.expectedType},...typeof o==="object"&&o.description!==void 0&&{description:o.description}};i.push(g)})});l.forEach(r=>{if(!T(r,"mmkv"))return;const s=typeof r==="string"?r:r.key;const t=i.some(e=>e.key===s);if(!t){const e=p[0]?.id||"mmkv.default";i.push({key:s,value:void 0,valueType:void 0,storageType:"mmkv",instanceId:e,status:"required_missing",category:"required",...typeof r==="object"&&r.expectedValue!==void 0&&{expectedValue:r.expectedValue},...typeof r==="object"&&r.expectedType!==void 0&&{expectedType:r.expectedType},...typeof r==="object"&&r.description!==void 0&&{description:r.description}})}});v(i)}catch(i){_(i instanceof Error?i:new Error("Failed to fetch multi-MMKV storage data"));v([])}finally{V(false)}},[p,b]);j(()=>{y()},[y]);return{storageKeys:m,isLoading:f,error:a,refresh:y}}