@buoy-gg/storage 7.0.6 → 7.0.8

package/lib/commonjs/storage/utils/safeAsyncStorage.js

@@ -1,140 +0,0 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.getAsyncStorageInstance = getAsyncStorageInstance;
-exports.isAsyncStorageAvailable = isAsyncStorageAvailable;
-exports.safeAsyncStorage = void 0;
-/**
- * Safe AsyncStorage wrapper that handles missing dependencies gracefully.
- *
- * This wrapper allows the storage dev tools to work even when
- * @react-native-async-storage/async-storage is not installed in the host app.
- *
- * When AsyncStorage is not available:
- * - All operations return empty results or no-ops
- * - No errors are thrown
- * - The dev tools can still load (but storage features will be limited)
- */
-
-let AsyncStorage = null;
-let isAvailable = false;
-let checkedAvailability = false;
-let checkError = null;
-
-/**
- * Check if AsyncStorage is available in the host app
- * This handles three cases:
- * 1. Package not installed (module not found)
- * 2. Package installed but native module not linked (native module null)
- * 3. Package installed and working
- */
-function checkAsyncStorageAvailability() {
-  if (checkedAvailability) {
-    return isAvailable;
-  }
-  try {
-    // Attempt to require AsyncStorage
-    // This might throw if:
-    // - Package is not installed (module not found)
-    // - Native module is not linked (RCTAsyncStorage is null)
-    const AsyncStorageModule = require("@react-native-async-storage/async-storage");
-    AsyncStorage = AsyncStorageModule?.default || AsyncStorageModule;
-
-    // Verify it's actually usable (has the methods we need)
-    if (AsyncStorage && typeof AsyncStorage.getItem === "function") {
-      isAvailable = true;
-    } else {
-      isAvailable = false;
-      AsyncStorage = null;
-    }
-  } catch (error) {
-    // Catch ALL errors:
-    // - Module not found (package not installed)
-    // - Native module errors (package installed but native not linked)
-    // - Any other initialization errors
-    checkError = error;
-    isAvailable = false;
-    AsyncStorage = null;
-  }
-  checkedAvailability = true;
-  return isAvailable;
-}
-
-/**
- * Returns true if AsyncStorage is available in the host app
- */
-function isAsyncStorageAvailable() {
-  return checkAsyncStorageAvailability();
-}
-
-/**
- * No-op AsyncStorage implementation for when the package is not installed
- */
-const noOpAsyncStorage = {
-  getItem: async _key => null,
-  setItem: async (_key, _value) => {},
-  removeItem: async _key => {},
-  getAllKeys: async () => [],
-  multiGet: async _keys => [],
-  multiSet: async _keyValuePairs => {},
-  multiRemove: async _keys => {},
-  clear: async () => {},
-  mergeItem: async (_key, _value) => {},
-  multiMerge: async _keyValuePairs => {}
-};
-
-/**
- * Safe AsyncStorage wrapper that provides no-op fallbacks when unavailable.
- *
- * Usage:
- * ```ts
- * import { safeAsyncStorage } from './utils/safeAsyncStorage';
- *
- * // This will work even if AsyncStorage is not installed
- * const value = await safeAsyncStorage.getItem('myKey');
- * ```
- */
-const safeAsyncStorage = exports.safeAsyncStorage = new Proxy(noOpAsyncStorage, {
-  get(_target, prop) {
-    // Avoid triggering check for React internal properties or symbols
-    if (typeof prop === "symbol" || prop.startsWith("_") || prop.startsWith("$$")) {
-      return noOpAsyncStorage[prop];
-    }
-
-    // Only check availability when actually accessing AsyncStorage methods
-    try {
-      checkAsyncStorageAvailability();
-      if (isAvailable && AsyncStorage) {
-        return AsyncStorage[prop];
-      }
-    } catch (error) {
-      // If check throws for any reason, fall back to no-op
-    }
-
-    // Return no-op implementation
-    return noOpAsyncStorage[prop];
-  }
-});
-
-/**
- * Get the actual AsyncStorage instance if available, or null if not.
- * Use this when you need to check if AsyncStorage is available before using it.
- *
- * @example
- * ```ts
- * const storage = getAsyncStorageInstance();
- * if (storage) {
- *   // AsyncStorage is available
- *   await storage.setItem('key', 'value');
- * } else {
- *   // AsyncStorage is not available, handle gracefully
- *   console.warn('AsyncStorage not available');
- * }
- * ```
- */
-function getAsyncStorageInstance() {
-  checkAsyncStorageAvailability();
-  return isAvailable ? AsyncStorage : null;
-}