sa2kit 1.6.31 → 1.6.32

package/dist/chunk-VVWQTO4Y.mjs

@@ -0,0 +1,77 @@
+import { WebStorageAdapter } from './chunk-WEEXCPSE.mjs';
+import { useState, useEffect, useCallback } from 'react';
+
+function useStorage(storage, key, defaultValue) {
+  const [value, setValue] = useState(defaultValue);
+  const [loading, setLoading] = useState(true);
+  useEffect(() => {
+    const loadValue = async () => {
+      try {
+        const stored = await storage.getItem(key);
+        if (stored !== null) {
+          setValue(JSON.parse(stored));
+        }
+      } catch (error) {
+        console.error('Error reading storage key "' + key + '":', error);
+      } finally {
+        setLoading(false);
+      }
+    };
+    void loadValue();
+  }, [storage, key]);
+  const updateValue = useCallback(
+    async (newValue) => {
+      try {
+        setValue(newValue);
+        await storage.setItem(key, JSON.stringify(newValue));
+        if ("dispatchChange" in storage && typeof storage.dispatchChange === "function") {
+          storage.dispatchChange(key, JSON.stringify(newValue));
+        }
+      } catch (error) {
+        console.error('Error setting storage key "' + key + '":', error);
+      }
+    },
+    [storage, key]
+  );
+  const removeValue = useCallback(async () => {
+    try {
+      setValue(defaultValue);
+      await storage.removeItem(key);
+      if ("dispatchChange" in storage && typeof storage.dispatchChange === "function") {
+        storage.dispatchChange(key, null);
+      }
+    } catch (error) {
+      console.error('Error removing storage key "' + key + '":', error);
+    }
+  }, [storage, key, defaultValue]);
+  useEffect(() => {
+    if (!storage.addChangeListener) {
+      return;
+    }
+    const cleanup = storage.addChangeListener((changedKey, newValue) => {
+      if (changedKey === key) {
+        try {
+          if (newValue === null) {
+            setValue(defaultValue);
+          } else {
+            setValue(JSON.parse(newValue));
+          }
+        } catch (error) {
+          console.error("Error parsing storage change event:", error);
+        }
+      }
+    });
+    return cleanup;
+  }, [storage, key, defaultValue]);
+  return [value, updateValue, removeValue, loading];
+}
+
+// src/storage/hooks/useLocalStorage.ts
+var webStorage = new WebStorageAdapter();
+function useLocalStorage(key, defaultValue) {
+  return useStorage(webStorage, key, defaultValue);
+}
+
+export { useLocalStorage, useStorage };
+//# sourceMappingURL=chunk-VVWQTO4Y.mjs.map
+//# sourceMappingURL=chunk-VVWQTO4Y.mjs.map

package/dist/chunk-VVWQTO4Y.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/storage/hooks/useStorage.ts","../src/storage/hooks/useLocalStorage.ts"],"names":[],"mappings":"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","file":"chunk-VVWQTO4Y.mjs","sourcesContent":["/**\n * 通用存储 Hook\n * 支持多平台：Web、React Native、小程序\n *\n * 优点：\n * 1. 异步读取，不阻塞渲染\n * 2. 统一的错误处理\n * 3. 类型安全\n * 4. 跨平台支持\n * 5. 自动同步（支持的平台）\n */\n\nimport { useState, useEffect, useCallback } from 'react';\nimport type { StorageAdapter } from '../types';\n\nexport function useStorage<T>(\n  storage: StorageAdapter,\n  key: string,\n  defaultValue: T\n): [T, (value: T) => void, () => void, boolean] {\n  const [value, setValue] = useState<T>(defaultValue);\n  const [loading, setLoading] = useState(true);\n\n  // 初始化时从存储读取\n  useEffect(() => {\n    const loadValue = async () => {\n      try {\n        const stored = await storage.getItem(key);\n        if (stored !== null) {\n          setValue(JSON.parse(stored));\n        }\n      } catch (error) {\n        console.error('Error reading storage key \"' + (key) + '\":', error);\n      } finally {\n        setLoading(false);\n      }\n    };\n\n    void loadValue();\n  }, [storage, key]);\n\n  // 更新值并同步到存储\n  const updateValue = useCallback(\n    async (newValue: T) => {\n      try {\n        setValue(newValue);\n        await storage.setItem(key, JSON.stringify(newValue));\n\n        // 如果是 Web 适配器，触发自定义事件\n        if ('dispatchChange' in storage && typeof storage.dispatchChange === 'function') {\n          (storage as any).dispatchChange(key, JSON.stringify(newValue));\n        }\n      } catch (error) {\n        console.error('Error setting storage key \"' + (key) + '\":', error);\n      }\n    },\n    [storage, key]\n  );\n\n  // 删除值\n  const removeValue = useCallback(async () => {\n    try {\n      setValue(defaultValue);\n      await storage.removeItem(key);\n\n      // 如果是 Web 适配器，触发自定义事件\n      if ('dispatchChange' in storage && typeof storage.dispatchChange === 'function') {\n        (storage as any).dispatchChange(key, null);\n      }\n    } catch (error) {\n      console.error('Error removing storage key \"' + (key) + '\":', error);\n    }\n  }, [storage, key, defaultValue]);\n\n  // 监听存储变化\n  useEffect(() => {\n    if (!storage.addChangeListener) {\n      return;\n    }\n\n    const cleanup = storage.addChangeListener((changedKey: string, newValue: string | null) => {\n      if (changedKey === key) {\n        try {\n          if (newValue === null) {\n            setValue(defaultValue);\n          } else {\n            setValue(JSON.parse(newValue));\n          }\n        } catch (error) {\n          console.error('Error parsing storage change event:', error);\n        }\n      }\n    });\n\n    return cleanup;\n  }, [storage, key, defaultValue]);\n\n  return [value, updateValue, removeValue, loading];\n}\n\n","/**\n * Web 平台 localStorage Hook\n * 基于通用 useStorage 的便捷封装\n */\n\nimport { useStorage } from './useStorage';\nimport { WebStorageAdapter } from '../adapters/web-adapter';\n\n// 创建单例适配器\nconst webStorage = new WebStorageAdapter();\n\n/**\n * Web 平台的 localStorage Hook\n *\n * @param key - 存储键名\n * @param defaultValue - 默认值\n * @returns [value, setValue, removeValue, isLoading]\n */\nexport function useLocalStorage<T>(\n  key: string,\n  defaultValue: T\n): [T, (value: T) => void, () => void, boolean] {\n  return useStorage(webStorage, key, defaultValue);\n}\n\n"]}