@buoy-gg/storage 7.0.41 → 7.0.43

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

@@ -1,210 +1 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.useMMKVInstance = useMMKVInstance;
-exports.useMMKVInstanceExists = useMMKVInstanceExists;
-exports.useMMKVInstances = useMMKVInstances;
-var _react = require("react");
-var _MMKVInstanceRegistry = require("../utils/MMKVInstanceRegistry");
-/**
- * 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
- */
-
-// 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).
-
-/**
- * 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>
- *   );
- * }
- * ```
- */
-function useMMKVInstances(autoRefresh = false) {
-  const [instances, setInstances] = (0, _react.useState)([]);
-  const [isLoading, setIsLoading] = (0, _react.useState)(true);
-
-  // Fetch all instances and their metadata
-  const fetchInstances = () => {
-    setIsLoading(true);
-    try {
-      const allInstances = _MMKVInstanceRegistry.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
-  (0, _react.useEffect)(() => {
-    fetchInstances();
-  }, []);
-
-  // Auto-refresh if enabled
-  (0, _react.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>
- *   );
- * }
- * ```
- */
-function useMMKVInstance(instanceId) {
-  const [instance, setInstance] = (0, _react.useState)(null);
-  (0, _react.useEffect)(() => {
-    if (!_MMKVInstanceRegistry.mmkvInstanceRegistry) {
-      setInstance(null);
-      return;
-    }
-    const instanceInfo = _MMKVInstanceRegistry.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>
- *   );
- * }
- * ```
- */
-function useMMKVInstanceExists(instanceId) {
-  const [exists, setExists] = (0, _react.useState)(false);
-  (0, _react.useEffect)(() => {
-    if (!_MMKVInstanceRegistry.mmkvInstanceRegistry) {
-      setExists(false);
-      return;
-    }
-    setExists(_MMKVInstanceRegistry.mmkvInstanceRegistry.has(instanceId));
-  }, [instanceId]);
-  return exists;
-}
+"use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.useMMKVInstance=useMMKVInstance;exports.useMMKVInstanceExists=useMMKVInstanceExists;exports.useMMKVInstances=useMMKVInstances;var _react=require("react");var _MMKVInstanceRegistry=require("../utils/MMKVInstanceRegistry");function useMMKVInstances(t=false){const[s,e]=(0,_react.useState)([]);const[n,c]=(0,_react.useState)(true);const r=()=>{c(true);try{const a=_MMKVInstanceRegistry.mmkvInstanceRegistry.getAll();const i=a.map(l=>{const{instance:u,id:o,encrypted:f,readOnly:I}=l;const y=u.getAllKeys();const M=y?.length||0;const g=void 0;return{id:o,instance:u,encrypted:f,readOnly:I,keyCount:M,size:g}});e(i)}catch(a){e([])}finally{c(false)}};(0,_react.useEffect)(()=>{r()},[]);(0,_react.useEffect)(()=>{if(!t)return;const a=setInterval(()=>{r()},1e3);return()=>clearInterval(a)},[t]);return{instances:s,instanceCount:s.length,isLoading:n,refresh:r}}function useMMKVInstance(t){const[s,e]=(0,_react.useState)(null);(0,_react.useEffect)(()=>{if(!_MMKVInstanceRegistry.mmkvInstanceRegistry){e(null);return}const n=_MMKVInstanceRegistry.mmkvInstanceRegistry.get(t);if(!n){e(null);return}const c=n.instance.getAllKeys();const r=c?.length||0;e({...n,keyCount:r,size:void 0})},[t]);return s}function useMMKVInstanceExists(t){const[s,e]=(0,_react.useState)(false);(0,_react.useEffect)(()=>{if(!_MMKVInstanceRegistry.mmkvInstanceRegistry){e(false);return}e(_MMKVInstanceRegistry.mmkvInstanceRegistry.has(t))},[t]);return s}

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

@@ -1,376 +1 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.useMMKVKeys = useMMKVKeys;
-exports.useMultiMMKVKeys = useMultiMMKVKeys;
-var _react = require("react");
-var _requiredStorageKeyScope = require("../utils/requiredStorageKeyScope");
-var _mmkvTypeDetection = require("../utils/mmkvTypeDetection");
-/**
- * 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
- */
-
-// 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.
-
-// 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>
- *   );
- * }
- * ```
- */
-function useMMKVKeys(instance, instanceId, requiredStorageKeys = []) {
-  // State management
-  const [storageKeys, setStorageKeys] = (0, _react.useState)([]);
-  const [isLoading, setIsLoading] = (0, _react.useState)(true);
-  const [error, setError] = (0, _react.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 = (0, _react.useRef)(requiredStorageKeys);
-  requiredRef.current = requiredStorageKeys;
-
-  // Fetch all keys and values from MMKV instance
-  const fetchStorageData = (0, _react.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 => (0, _requiredStorageKeyScope.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
-        } = (0, _mmkvTypeDetection.detectMMKVType)(instance, key);
-
-        // Check if this is a required key scoped to MMKV
-        const requiredConfig = requiredStorageKeys.find(req => {
-          if (!(0, _requiredStorageKeyScope.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 = (0, _mmkvTypeDetection.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 (!(0, _requiredStorageKeyScope.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
-  (0, _react.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
- * }
- * ```
- */
-function useMultiMMKVKeys(instances, requiredStorageKeys = []) {
-  const [storageKeys, setStorageKeys] = (0, _react.useState)([]);
-  const [isLoading, setIsLoading] = (0, _react.useState)(true);
-  const [error, setError] = (0, _react.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 = (0, _react.useRef)(requiredStorageKeys);
-  requiredRef.current = requiredStorageKeys;
-  const fetchStorageData = (0, _react.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
-          } = (0, _mmkvTypeDetection.detectMMKVType)(instance, key);
-          const requiredConfig = requiredStorageKeys.find(req => {
-            if (!(0, _requiredStorageKeyScope.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 = (0, _mmkvTypeDetection.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 (!(0, _requiredStorageKeyScope.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]);
-  (0, _react.useEffect)(() => {
-    fetchStorageData();
-  }, [fetchStorageData]);
-  return {
-    storageKeys,
-    isLoading,
-    error,
-    refresh: fetchStorageData
-  };
-}
+"use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.useMMKVKeys=useMMKVKeys;exports.useMultiMMKVKeys=useMultiMMKVKeys;var _react=require("react");var _requiredStorageKeyScope=require("../utils/requiredStorageKeyScope");var _mmkvTypeDetection=require("../utils/mmkvTypeDetection");function useMMKVKeys(p,c,x=[]){const[T,a]=(0,_react.useState)([]);const[m,f]=(0,_react.useState)(true);const[v,K]=(0,_react.useState)(null);const V=JSON.stringify(x);const y=(0,_react.useRef)(x);y.current=x;const l=(0,_react.useCallback)(()=>{const s=y.current;f(true);K(null);try{if(!p){a([]);f(false);return}const i=p.getAllKeys();if(!i||i.length===0){const t=s.filter(e=>(0,_requiredStorageKeyScope.requiredKeyAppliesTo)(e,"mmkv")).map(e=>{const o=typeof e==="string"?e:e.key;const n=typeof e==="object"?e.description:void 0;const r=typeof e==="object"?e.expectedValue:void 0;const d=typeof e==="object"?e.expectedType:void 0;return{key:o,value:void 0,valueType:void 0,storageType:"mmkv",instanceId:c,status:"required_missing",category:"required",description:n,expectedValue:r,expectedType:d}});a(t);f(false);return}const u=[];i.forEach(t=>{const{value:e,type:o}=(0,_mmkvTypeDetection.detectMMKVType)(p,t);const n=s.find(g=>{if(!(0,_requiredStorageKeyScope.requiredKeyAppliesTo)(g,"mmkv"))return false;if(typeof g==="string")return g===t;return g.key===t});let r="optional_present";if(n){if(e===void 0){r="required_missing"}else if(typeof n==="object"&&n.expectedValue!==void 0){r=String(e)===String(n.expectedValue)?"required_present":"required_wrong_value"}else if(typeof n==="object"&&n.expectedType!==void 0){r=(0,_mmkvTypeDetection.isTypeMatch)(o,n.expectedType)?"required_present":"required_wrong_type"}else{r="required_present"}}const d={key:t,value:e,valueType:o!=="unknown"?o:void 0,storageType:"mmkv",instanceId:c,status:r,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}};u.push(d)});s.forEach(t=>{if(!(0,_requiredStorageKeyScope.requiredKeyAppliesTo)(t,"mmkv"))return;const e=typeof t==="string"?t:t.key;const o=u.some(n=>n.key===e);if(!o){u.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}})}});a(u)}catch(i){K(i instanceof Error?i:new Error("Failed to fetch MMKV storage data"));a([])}finally{f(false)}},[p,c,V]);(0,_react.useEffect)(()=>{l()},[l]);return{storageKeys:T,isLoading:m,error:v,refresh:l}}function useMultiMMKVKeys(p,c=[]){const[x,T]=(0,_react.useState)([]);const[a,m]=(0,_react.useState)(true);const[f,v]=(0,_react.useState)(null);const K=JSON.stringify(c);const V=(0,_react.useRef)(c);V.current=c;const y=(0,_react.useCallback)(()=>{const l=V.current;m(true);v(null);try{const s=[];p.forEach(({instance:i,id:u})=>{const t=i.getAllKeys();if(!t||t.length===0){return}t.forEach(e=>{const{value:o,type:n}=(0,_mmkvTypeDetection.detectMMKVType)(i,e);const r=l.find(_=>{if(!(0,_requiredStorageKeyScope.requiredKeyAppliesTo)(_,"mmkv"))return false;if(typeof _==="string")return _===e;return _.key===e});let d="optional_present";if(r){if(o===void 0){d="required_missing"}else if(typeof r==="object"&&r.expectedValue!==void 0){d=String(o)===String(r.expectedValue)?"required_present":"required_wrong_value"}else if(typeof r==="object"&&r.expectedType!==void 0){d=(0,_mmkvTypeDetection.isTypeMatch)(n,r.expectedType)?"required_present":"required_wrong_type"}else{d="required_present"}}const g={key:e,value:o,valueType:n!=="unknown"?n:void 0,storageType:"mmkv",instanceId:u,status:d,category:r?"required":"optional",lastUpdated:new Date,...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}};s.push(g)})});l.forEach(i=>{if(!(0,_requiredStorageKeyScope.requiredKeyAppliesTo)(i,"mmkv"))return;const u=typeof i==="string"?i:i.key;const t=s.some(e=>e.key===u);if(!t){const e=p[0]?.id||"mmkv.default";s.push({key:u,value:void 0,valueType:void 0,storageType:"mmkv",instanceId:e,status:"required_missing",category:"required",...typeof i==="object"&&i.expectedValue!==void 0&&{expectedValue:i.expectedValue},...typeof i==="object"&&i.expectedType!==void 0&&{expectedType:i.expectedType},...typeof i==="object"&&i.description!==void 0&&{description:i.description}})}});T(s)}catch(s){v(s instanceof Error?s:new Error("Failed to fetch multi-MMKV storage data"));T([])}finally{m(false)}},[p,K]);(0,_react.useEffect)(()=>{y()},[y]);return{storageKeys:x,isLoading:a,error:f,refresh:y}}