react-native-turbo-preferences/lib/module/hooks/usePreferenceObject.js

Modern TurboModule wrapper for iOS NSUserDefaults and Android SharedPreferences.

"use strict";

import { useState, useCallback, useEffect } from 'react';
import TurboPreferences from "../NativeTurboPreferences.js";

/**
 * React hook for managing an object preference with JSON serialization
 *
 * @param key - The preference key
 * @returns [value, setValue, contains, clear]
 *
 * @example
 * ```tsx
 * interface User {
 *   name: string;
 *   age: number;
 * }
 *
 * function UserProfile() {
 *   const [user, setUser, hasUser, clearUser] = usePreferenceObject<User>('user');
 *
 *   return (
 *     <View>
 *       <Text>Name: {user?.name ?? 'Unknown'}</Text>
 *       <Text>Age: {user?.age ?? 'Unknown'}</Text>
 *       <Button
 *         title="Set John"
 *         onPress={() => setUser({ name: 'John', age: 25 })}
 *       />
 *       <Button title="Clear" onPress={clearUser} />
 *     </View>
 *   );
 * }
 * ```
 */
export function usePreferenceObject(key) {
  const [value, setValue] = useState(null);
  const [contains, setContains] = useState(false);
  const setPreferenceValue = useCallback(async newValue => {
    if (!key) return;
    try {
      // Convert object to JSON string for storage
      const jsonString = JSON.stringify(newValue);
      await TurboPreferences.set(key, jsonString);
      setValue(newValue);
      setContains(true);
    } catch (error) {
      console.warn('usePreferenceObject setValue error:', error);
      throw error;
    }
  }, [key]);
  const clearPreferenceValue = useCallback(async () => {
    if (!key) return;
    try {
      await TurboPreferences.clear(key);
      setValue(null);
      setContains(false);
    } catch (error) {
      console.warn('usePreferenceObject clear error:', error);
      throw error;
    }
  }, [key]);

  // Load initial value on mount and key change
  useEffect(() => {
    if (!key) return;
    const loadInitialValue = async () => {
      try {
        const [currentValue, exists] = await Promise.all([TurboPreferences.get(key), TurboPreferences.contains(key)]);
        if (currentValue !== null) {
          try {
            // Parse JSON string back to object
            const parsedValue = JSON.parse(currentValue);
            setValue(parsedValue);
          } catch (parseError) {
            console.warn('usePreferenceObject parse error:', parseError);
            setValue(null); // Invalid JSON
          }
        } else {
          setValue(null);
        }
        setContains(exists);
      } catch (error) {
        console.warn('usePreferenceObject load error:', error);
      }
    };
    loadInitialValue();
  }, [key]);
  return [value, setPreferenceValue, contains, clearPreferenceValue];
}
//# sourceMappingURL=usePreferenceObject.js.map