zcw-shared 1.2.0

package/dist/hooks/useCache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCache.js","sourceRoot":"","sources":["../../src/hooks/useCache.ts"],"names":[],"mappings":"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"}

package/dist/hooks/useFetch.d.ts

@@ -0,0 +1,3 @@
+import type { BrowserEnvironment } from '../../references/browser';
+import type { FetchOptions, UseFetchReturn } from '../../types/network';
+export default function useFetch(environment: BrowserEnvironment, defaultOptions?: Partial<FetchOptions>): UseFetchReturn;

package/dist/hooks/useFetch.js

@@ -0,0 +1,154 @@
+export default function useFetch(environment, defaultOptions = {}) {
+    if (!environment.fetch) {
+        throw new Error('fetch is not available in the provided environment');
+    }
+    const loading = { value: false };
+    const error = { value: null };
+    const requestInterceptors = [];
+    const responseInterceptors = [];
+    const buildURL = (url, baseURL) => {
+        if (url.startsWith('http://') || url.startsWith('https://')) {
+            return url;
+        }
+        if (baseURL) {
+            return baseURL.replace(/\/$/, '') + '/' + url.replace(/^\//, '');
+        }
+        return url;
+    };
+    const processConfig = async (config) => {
+        let processedConfig = { ...defaultOptions, ...config };
+        for (const interceptor of requestInterceptors) {
+            processedConfig = await interceptor(processedConfig);
+        }
+        return processedConfig;
+    };
+    const processResponse = async (response) => {
+        let processedResponse = response;
+        for (const interceptor of responseInterceptors) {
+            processedResponse = await interceptor(processedResponse);
+        }
+        return processedResponse;
+    };
+    const request = async (url, options = {}) => {
+        try {
+            loading.value = true;
+            error.value = null;
+            const config = await processConfig(options);
+            const fullURL = buildURL(url, config.baseURL);
+            const requestInit = {
+                method: config.method || 'GET',
+                headers: config.headers,
+                body: config.body,
+                signal: config.signal,
+                credentials: config.credentials,
+                cache: config.cache,
+                redirect: config.redirect,
+                referrer: config.referrer,
+                referrerPolicy: config.referrerPolicy,
+                integrity: config.integrity,
+                keepalive: config.keepalive,
+                mode: config.mode
+            };
+            if (config.data && typeof config.data !== 'string') {
+                requestInit.body = JSON.stringify(config.data);
+                requestInit.headers = {
+                    'Content-Type': 'application/json',
+                    ...requestInit.headers
+                };
+            }
+            else if (config.data) {
+                requestInit.body = config.data;
+            }
+            const response = await environment.fetch(fullURL, requestInit);
+            const processedResponse = await processResponse(response);
+            if (!processedResponse.ok) {
+                throw new Error(`HTTP ${processedResponse.status}: ${processedResponse.statusText}`);
+            }
+            let data;
+            const contentType = processedResponse.headers.get('content-type');
+            if (contentType && contentType.includes('application/json')) {
+                data = await processedResponse.json();
+            }
+            else if (contentType && contentType.includes('text/')) {
+                data = await processedResponse.text();
+            }
+            else {
+                data = await processedResponse.blob();
+            }
+            loading.value = false;
+            return {
+                success: true,
+                data,
+                response: processedResponse,
+                error: null
+            };
+        }
+        catch (err) {
+            const errorObj = err instanceof Error ? err : new Error(String(err));
+            error.value = errorObj;
+            loading.value = false;
+            return {
+                success: false,
+                data: null,
+                response: null,
+                error: errorObj
+            };
+        }
+    };
+    const get = (url, options = {}) => {
+        return request(url, { ...options, method: 'GET' });
+    };
+    const post = (url, data, options = {}) => {
+        return request(url, { ...options, method: 'POST', data });
+    };
+    const put = (url, data, options = {}) => {
+        return request(url, { ...options, method: 'PUT', data });
+    };
+    const del = (url, options = {}) => {
+        return request(url, { ...options, method: 'DELETE' });
+    };
+    const patch = (url, data, options = {}) => {
+        return request(url, { ...options, method: 'PATCH', data });
+    };
+    const head = (url, options = {}) => {
+        return request(url, { ...options, method: 'HEAD' });
+    };
+    const options = (url, requestOptions = {}) => {
+        return request(url, { ...requestOptions, method: 'OPTIONS' });
+    };
+    const addRequestInterceptor = (interceptor) => {
+        requestInterceptors.push(interceptor);
+    };
+    const addResponseInterceptor = (interceptor) => {
+        responseInterceptors.push(interceptor);
+    };
+    const removeRequestInterceptor = (interceptor) => {
+        const index = requestInterceptors.indexOf(interceptor);
+        if (index > -1) {
+            requestInterceptors.splice(index, 1);
+        }
+    };
+    const removeResponseInterceptor = (interceptor) => {
+        const index = responseInterceptors.indexOf(interceptor);
+        if (index > -1) {
+            responseInterceptors.splice(index, 1);
+        }
+    };
+    return {
+        loading,
+        error,
+        request,
+        get,
+        post,
+        put,
+        delete: del,
+        patch,
+        head,
+        options,
+        addRequestInterceptor,
+        addResponseInterceptor,
+        removeRequestInterceptor,
+        removeResponseInterceptor
+    };
+}
+//# sourceMappingURL=useFetch.js.map

package/dist/hooks/useFetch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFetch.js","sourceRoot":"","sources":["../../src/hooks/useFetch.ts"],"names":[],"mappings":"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"}

package/dist/hooks/useLocalStorage.d.ts

@@ -0,0 +1,4 @@
+import type { StorageOptions, UseStorageReturn } from '../../types/storage.d';
+import type { StorageInterface } from '../../references/storage.d';
+import type { ConsoleInterface } from '../../references/console.d';
+export default function useLocalStorage<T>(key: string, localStorage: StorageInterface, console: ConsoleInterface, options?: StorageOptions): UseStorageReturn<T>;

package/dist/hooks/useLocalStorage.js

@@ -0,0 +1,67 @@
+export default function useLocalStorage(key, localStorage, console, options = {}) {
+    const { prefix = '', serializer } = options;
+    const fullKey = prefix + key;
+    const defaultSerializer = {
+        serialize: (value) => JSON.stringify(value),
+        deserialize: (value) => {
+            try {
+                return JSON.parse(value);
+            }
+            catch {
+                return value;
+            }
+        }
+    };
+    const currentSerializer = serializer || defaultSerializer;
+    const getCurrentValue = () => {
+        try {
+            const item = localStorage.getItem(fullKey);
+            if (item === null)
+                return null;
+            return currentSerializer.deserialize(item);
+        }
+        catch (error) {
+            console.error(`获取 localStorage 值失败: ${error}`);
+            return null;
+        }
+    };
+    const setValue = async (value) => {
+        try {
+            if (value === null) {
+                localStorage.removeItem(fullKey);
+            }
+            else {
+                const serializedValue = currentSerializer.serialize(value);
+                localStorage.setItem(fullKey, serializedValue);
+            }
+        }
+        catch (error) {
+            throw new Error(`设置 localStorage 值失败: ${error}`);
+        }
+    };
+    const removeValue = async () => {
+        try {
+            localStorage.removeItem(fullKey);
+        }
+        catch (error) {
+            throw new Error(`移除 localStorage 值失败: ${error}`);
+        }
+    };
+    const clear = async () => {
+        try {
+            localStorage.clear();
+        }
+        catch (error) {
+            throw new Error(`清空 localStorage 失败: ${error}`);
+        }
+    };
+    return {
+        get value() {
+            return getCurrentValue();
+        },
+        setValue,
+        removeValue,
+        clear
+    };
+}
+//# sourceMappingURL=useLocalStorage.js.map

package/dist/hooks/useLocalStorage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useLocalStorage.js","sourceRoot":"","sources":["../../src/hooks/useLocalStorage.ts"],"names":[],"mappings":"AAeA,MAAM,CAAC,OAAO,UAAU,eAAe,CACrC,GAAW,EACX,YAA8B,EAC9B,OAAyB,EACzB,UAA0B,EAAE;IAE5B,MAAM,EAAE,MAAM,GAAG,EAAE,EAAE,UAAU,EAAE,GAAG,OAAO,CAAA;IAC3C,MAAM,OAAO,GAAG,MAAM,GAAG,GAAG,CAAA;IAG5B,MAAM,iBAAiB,GAAG;QACxB,SAAS,EAAE,CAAC,KAAQ,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC;QAC9C,WAAW,EAAE,CAAC,KAAa,EAAE,EAAE;YAC7B,IAAI,CAAC;gBACH,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAA;YAC1B,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,KAAK,CAAA;YACd,CAAC;QACH,CAAC;KACF,CAAA;IAED,MAAM,iBAAiB,GAAG,UAAU,IAAI,iBAAiB,CAAA;IAGzD,MAAM,eAAe,GAAG,GAAa,EAAE;QACrC,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,YAAY,CAAC,OAAO,CAAC,OAAO,CAAC,CAAA;YAC1C,IAAI,IAAI,KAAK,IAAI;gBAAE,OAAO,IAAI,CAAA;YAC9B,OAAO,iBAAiB,CAAC,WAAW,CAAC,IAAI,CAAC,CAAA;QAC5C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,wBAAwB,KAAK,EAAE,CAAC,CAAA;YAC9C,OAAO,IAAI,CAAA;QACb,CAAC;IACH,CAAC,CAAA;IAGD,MAAM,QAAQ,GAAG,KAAK,EAAE,KAAe,EAAiB,EAAE;QACxD,IAAI,CAAC;YACH,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;gBACnB,YAAY,CAAC,UAAU,CAAC,OAAO,CAAC,CAAA;YAClC,CAAC;iBAAM,CAAC;gBACN,MAAM,eAAe,GAAG,iBAAiB,CAAC,SAAS,CAAC,KAAK,CAAC,CAAA;gBAC1D,YAAY,CAAC,OAAO,CAAC,OAAO,EAAE,eAAe,CAAC,CAAA;YAChD,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,wBAAwB,KAAK,EAAE,CAAC,CAAA;QAClD,CAAC;IACH,CAAC,CAAA;IAGD,MAAM,WAAW,GAAG,KAAK,IAAmB,EAAE;QAC5C,IAAI,CAAC;YACH,YAAY,CAAC,UAAU,CAAC,OAAO,CAAC,CAAA;QAClC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,wBAAwB,KAAK,EAAE,CAAC,CAAA;QAClD,CAAC;IACH,CAAC,CAAA;IAGD,MAAM,KAAK,GAAG,KAAK,IAAmB,EAAE;QACtC,IAAI,CAAC;YACH,YAAY,CAAC,KAAK,EAAE,CAAA;QACtB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,uBAAuB,KAAK,EAAE,CAAC,CAAA;QACjD,CAAC;IACH,CAAC,CAAA;IAED,OAAO;QACL,IAAI,KAAK;YACP,OAAO,eAAe,EAAE,CAAA;QAC1B,CAAC;QACD,QAAQ;QACR,WAAW;QACX,KAAK;KACN,CAAA;AACH,CAAC"}

package/dist/hooks/usePluginSystem.d.ts

@@ -0,0 +1,11 @@
+export type SyncPluginFunction<State, Context> = (state: State, context: Context) => State;
+interface PluginSystemBase<State, Context> {
+    state: State;
+    addPlugin: (plugin: SyncPluginFunction<State, Context>) => void;
+    execute: (context: Context) => State;
+    clear: () => void;
+    getPlugins: () => SyncPluginFunction<State, Context>[];
+    getPluginCount: () => number;
+}
+declare function createSyncPluginSystem<State, Context>(initialState: State): PluginSystemBase<State, Context>;
+export default createSyncPluginSystem;

package/dist/hooks/usePluginSystem.js

@@ -0,0 +1,34 @@
+function createSyncPluginSystem(initialState) {
+    let state = initialState;
+    const plugins = [];
+    const addPlugin = (plugin) => {
+        plugins.push(plugin);
+    };
+    const execute = (context) => {
+        let currentState = state;
+        for (const plugin of plugins) {
+            currentState = plugin(currentState, context);
+        }
+        state = currentState;
+        return currentState;
+    };
+    const clear = () => {
+        plugins.length = 0;
+    };
+    const getPlugins = () => {
+        return [...plugins];
+    };
+    const getPluginCount = () => {
+        return plugins.length;
+    };
+    return {
+        state,
+        addPlugin,
+        execute,
+        clear,
+        getPlugins,
+        getPluginCount
+    };
+}
+export default createSyncPluginSystem;
+//# sourceMappingURL=usePluginSystem.js.map

package/dist/hooks/usePluginSystem.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePluginSystem.js","sourceRoot":"","sources":["../../src/hooks/usePluginSystem.ts"],"names":[],"mappings":"AAyBA,SAAS,sBAAsB,CAC7B,YAAmB;IAEnB,IAAI,KAAK,GAAG,YAAY,CAAA;IACxB,MAAM,OAAO,GAAyC,EAAE,CAAA;IAExD,MAAM,SAAS,GAAG,CAAC,MAA0C,EAAE,EAAE;QAC/D,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;IACtB,CAAC,CAAA;IAED,MAAM,OAAO,GAAG,CAAC,OAAgB,EAAE,EAAE;QACnC,IAAI,YAAY,GAAG,KAAK,CAAA;QACxB,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;YAC7B,YAAY,GAAG,MAAM,CAAC,YAAY,EAAE,OAAO,CAAC,CAAA;QAC9C,CAAC;QACD,KAAK,GAAG,YAAY,CAAA;QACpB,OAAO,YAAY,CAAA;IACrB,CAAC,CAAA;IAED,MAAM,KAAK,GAAG,GAAG,EAAE;QACjB,OAAO,CAAC,MAAM,GAAG,CAAC,CAAA;IACpB,CAAC,CAAA;IAED,MAAM,UAAU,GAAG,GAAG,EAAE;QACtB,OAAO,CAAC,GAAG,OAAO,CAAC,CAAA;IACrB,CAAC,CAAA;IAED,MAAM,cAAc,GAAG,GAAG,EAAE;QAC1B,OAAO,OAAO,CAAC,MAAM,CAAA;IACvB,CAAC,CAAA;IAED,OAAO;QACL,KAAK;QACL,SAAS;QACT,OAAO;QACP,KAAK;QACL,UAAU;QACV,cAAc;KACf,CAAA;AACH,CAAC;AAGD,eAAe,sBAAsB,CAAA"}

package/dist/hooks/useRequest.d.ts

@@ -0,0 +1,3 @@
+import type { RequestOptions, UseRequestReturn } from '../../types/network';
+import type { RequestInit } from '../../references/fetch.d';
+export default function useRequest<T>(fetchFunction: (url: string, options?: RequestInit) => Promise<T>, defaultOptions?: Partial<RequestOptions>): UseRequestReturn<T>;

package/dist/hooks/useRequest.js

@@ -0,0 +1,139 @@
+import { setTimeout, clearTimeout } from '../../references/timer.d';
+import { AbortController } from '../../references/fetch.d';
+export default function useRequest(fetchFunction, defaultOptions = {}) {
+    const loading = { value: false };
+    const error = { value: null };
+    const data = { value: null };
+    const cache = new Map();
+    let currentController = null;
+    const getCacheKey = (url, options) => {
+        const key = `${url}_${JSON.stringify(options || {})}`;
+        return key;
+    };
+    const isCacheValid = (cacheItem) => {
+        return Date.now() - cacheItem.timestamp < cacheItem.ttl;
+    };
+    const execute = async (url, options = {}) => {
+        const mergedOptions = { ...defaultOptions, ...options };
+        const { cache: useCache = false, cacheTTL = 5 * 60 * 1000, retry = 0, retryDelay = 1000, timeout = 10000, ...requestInit } = mergedOptions;
+        if (useCache) {
+            const cacheKey = getCacheKey(url, requestInit);
+            const cached = cache.get(cacheKey);
+            if (cached && isCacheValid(cached)) {
+                data.value = cached.data;
+                return {
+                    success: true,
+                    data: cached.data,
+                    error: null,
+                    fromCache: true
+                };
+            }
+        }
+        if (currentController) {
+            currentController.abort();
+        }
+        currentController = new AbortController();
+        const signal = currentController.signal;
+        loading.value = true;
+        error.value = null;
+        let lastError = null;
+        for (let attempt = 0; attempt <= retry; attempt++) {
+            try {
+                const timeoutId = setTimeout(() => {
+                    currentController?.abort();
+                }, timeout);
+                const response = await fetchFunction(url, {
+                    ...requestInit,
+                    signal
+                });
+                clearTimeout(timeoutId);
+                data.value = response;
+                loading.value = false;
+                if (useCache) {
+                    const cacheKey = getCacheKey(url, requestInit);
+                    cache.set(cacheKey, {
+                        data: response,
+                        timestamp: Date.now(),
+                        ttl: cacheTTL
+                    });
+                }
+                return {
+                    success: true,
+                    data: response,
+                    error: null,
+                    fromCache: false
+                };
+            }
+            catch (err) {
+                lastError = err instanceof Error ? err : new Error(String(err));
+                if (signal.aborted) {
+                    loading.value = false;
+                    return {
+                        success: false,
+                        data: null,
+                        error: new Error('Request cancelled'),
+                        fromCache: false
+                    };
+                }
+                if (attempt < retry) {
+                    await new Promise(resolve => setTimeout(resolve, retryDelay * (attempt + 1)));
+                }
+            }
+        }
+        error.value = lastError;
+        loading.value = false;
+        return {
+            success: false,
+            data: null,
+            error: lastError,
+            fromCache: false
+        };
+    };
+    const cancel = () => {
+        if (currentController) {
+            currentController.abort();
+            currentController = null;
+            loading.value = false;
+        }
+    };
+    const clearCache = (url) => {
+        if (url) {
+            for (const [key] of cache) {
+                if (key.startsWith(url)) {
+                    cache.delete(key);
+                }
+            }
+        }
+        else {
+            cache.clear();
+        }
+    };
+    const getCacheStats = () => {
+        const now = Date.now();
+        let validCount = 0;
+        let expiredCount = 0;
+        for (const [, item] of cache) {
+            if (isCacheValid(item)) {
+                validCount++;
+            }
+            else {
+                expiredCount++;
+            }
+        }
+        return {
+            total: cache.size,
+            valid: validCount,
+            expired: expiredCount
+        };
+    };
+    return {
+        loading,
+        error,
+        data,
+        execute,
+        cancel,
+        clearCache,
+        getCacheStats
+    };
+}
+//# sourceMappingURL=useRequest.js.map

package/dist/hooks/useRequest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useRequest.js","sourceRoot":"","sources":["../../src/hooks/useRequest.ts"],"names":[],"mappings":"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"}

package/dist/hooks/useSessionStorage.d.ts

@@ -0,0 +1,4 @@
+import type { StorageOptions, UseStorageReturn } from '../../types/storage.d';
+import type { StorageInterface } from '../../references/storage.d';
+import type { ConsoleInterface } from '../../references/console.d';
+export default function useSessionStorage<T>(key: string, sessionStorage: StorageInterface, console: ConsoleInterface, options?: StorageOptions): UseStorageReturn<T>;

package/dist/hooks/useSessionStorage.js

@@ -0,0 +1,67 @@
+export default function useSessionStorage(key, sessionStorage, console, options = {}) {
+    const { prefix = '', serializer } = options;
+    const fullKey = prefix + key;
+    const defaultSerializer = {
+        serialize: (value) => JSON.stringify(value),
+        deserialize: (value) => {
+            try {
+                return JSON.parse(value);
+            }
+            catch {
+                return value;
+            }
+        }
+    };
+    const currentSerializer = serializer || defaultSerializer;
+    const getCurrentValue = () => {
+        try {
+            const item = sessionStorage.getItem(fullKey);
+            if (item === null)
+                return null;
+            return currentSerializer.deserialize(item);
+        }
+        catch (error) {
+            console.error(`获取 sessionStorage 值失败: ${error}`);
+            return null;
+        }
+    };
+    const setValue = async (value) => {
+        try {
+            if (value === null) {
+                sessionStorage.removeItem(fullKey);
+            }
+            else {
+                const serializedValue = currentSerializer.serialize(value);
+                sessionStorage.setItem(fullKey, serializedValue);
+            }
+        }
+        catch (error) {
+            throw new Error(`设置 sessionStorage 值失败: ${error}`);
+        }
+    };
+    const removeValue = async () => {
+        try {
+            sessionStorage.removeItem(fullKey);
+        }
+        catch (error) {
+            throw new Error(`移除 sessionStorage 值失败: ${error}`);
+        }
+    };
+    const clear = async () => {
+        try {
+            sessionStorage.clear();
+        }
+        catch (error) {
+            throw new Error(`清空 sessionStorage 失败: ${error}`);
+        }
+    };
+    return {
+        get value() {
+            return getCurrentValue();
+        },
+        setValue,
+        removeValue,
+        clear
+    };
+}
+//# sourceMappingURL=useSessionStorage.js.map

package/dist/hooks/useSessionStorage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSessionStorage.js","sourceRoot":"","sources":["../../src/hooks/useSessionStorage.ts"],"names":[],"mappings":"AAeA,MAAM,CAAC,OAAO,UAAU,iBAAiB,CACvC,GAAW,EACX,cAAgC,EAChC,OAAyB,EACzB,UAA0B,EAAE;IAE5B,MAAM,EAAE,MAAM,GAAG,EAAE,EAAE,UAAU,EAAE,GAAG,OAAO,CAAA;IAC3C,MAAM,OAAO,GAAG,MAAM,GAAG,GAAG,CAAA;IAG5B,MAAM,iBAAiB,GAAG;QACxB,SAAS,EAAE,CAAC,KAAQ,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC;QAC9C,WAAW,EAAE,CAAC,KAAa,EAAE,EAAE;YAC7B,IAAI,CAAC;gBACH,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAA;YAC1B,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,KAAK,CAAA;YACd,CAAC;QACH,CAAC;KACF,CAAA;IAED,MAAM,iBAAiB,GAAG,UAAU,IAAI,iBAAiB,CAAA;IAGzD,MAAM,eAAe,GAAG,GAAa,EAAE;QACrC,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,cAAc,CAAC,OAAO,CAAC,OAAO,CAAC,CAAA;YAC5C,IAAI,IAAI,KAAK,IAAI;gBAAE,OAAO,IAAI,CAAA;YAC9B,OAAO,iBAAiB,CAAC,WAAW,CAAC,IAAI,CAAC,CAAA;QAC5C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,0BAA0B,KAAK,EAAE,CAAC,CAAA;YAChD,OAAO,IAAI,CAAA;QACb,CAAC;IACH,CAAC,CAAA;IAGD,MAAM,QAAQ,GAAG,KAAK,EAAE,KAAe,EAAiB,EAAE;QACxD,IAAI,CAAC;YACH,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;gBACnB,cAAc,CAAC,UAAU,CAAC,OAAO,CAAC,CAAA;YACpC,CAAC;iBAAM,CAAC;gBACN,MAAM,eAAe,GAAG,iBAAiB,CAAC,SAAS,CAAC,KAAK,CAAC,CAAA;gBAC1D,cAAc,CAAC,OAAO,CAAC,OAAO,EAAE,eAAe,CAAC,CAAA;YAClD,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,0BAA0B,KAAK,EAAE,CAAC,CAAA;QACpD,CAAC;IACH,CAAC,CAAA;IAGD,MAAM,WAAW,GAAG,KAAK,IAAmB,EAAE;QAC5C,IAAI,CAAC;YACH,cAAc,CAAC,UAAU,CAAC,OAAO,CAAC,CAAA;QACpC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,0BAA0B,KAAK,EAAE,CAAC,CAAA;QACpD,CAAC;IACH,CAAC,CAAA;IAGD,MAAM,KAAK,GAAG,KAAK,IAAmB,EAAE;QACtC,IAAI,CAAC;YACH,cAAc,CAAC,KAAK,EAAE,CAAA;QACxB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,yBAAyB,KAAK,EAAE,CAAC,CAAA;QACnD,CAAC;IACH,CAAC,CAAA;IAED,OAAO;QACL,IAAI,KAAK;YACP,OAAO,eAAe,EAAE,CAAA;QAC1B,CAAC;QACD,QAAQ;QACR,WAAW;QACX,KAAK;KACN,CAAA;AACH,CAAC"}

package/dist/hooks/useStorage.d.ts

@@ -0,0 +1,3 @@
+import type { StorageAdapter, UseStorageReturn } from '../../types/storage.d';
+import type { ConsoleInterface } from '../../references/console.d';
+export default function useStorage<T>(key: string, adapter: StorageAdapter<T>, console: ConsoleInterface): UseStorageReturn<T>;

package/dist/hooks/useStorage.js

@@ -0,0 +1,64 @@
+export default function useStorage(key, adapter, console) {
+    let cachedValue = null;
+    let isInitialized = false;
+    const initializeValue = async () => {
+        if (!isInitialized) {
+            try {
+                cachedValue = await adapter.get(key);
+                isInitialized = true;
+            }
+            catch (error) {
+                console.error(`初始化存储值失败: ${error}`);
+                cachedValue = null;
+                isInitialized = true;
+            }
+        }
+    };
+    const getCurrentValue = () => {
+        if (!isInitialized) {
+            initializeValue();
+        }
+        return cachedValue;
+    };
+    const setValue = async (value) => {
+        try {
+            if (value === null) {
+                await adapter.remove(key);
+            }
+            else {
+                await adapter.set(key, value);
+            }
+            cachedValue = value;
+        }
+        catch (error) {
+            throw new Error(`设置存储值失败: ${error}`);
+        }
+    };
+    const removeValue = async () => {
+        try {
+            await adapter.remove(key);
+            cachedValue = null;
+        }
+        catch (error) {
+            throw new Error(`移除存储值失败: ${error}`);
+        }
+    };
+    const clear = async () => {
+        try {
+            await adapter.clear();
+            cachedValue = null;
+        }
+        catch (error) {
+            throw new Error(`清空存储失败: ${error}`);
+        }
+    };
+    return {
+        get value() {
+            return getCurrentValue();
+        },
+        setValue,
+        removeValue,
+        clear
+    };
+}
+//# sourceMappingURL=useStorage.js.map

package/dist/hooks/useStorage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useStorage.js","sourceRoot":"","sources":["../../src/hooks/useStorage.ts"],"names":[],"mappings":"AAcA,MAAM,CAAC,OAAO,UAAU,UAAU,CAChC,GAAW,EACX,OAA0B,EAC1B,OAAyB;IAEzB,IAAI,WAAW,GAAa,IAAI,CAAA;IAChC,IAAI,aAAa,GAAG,KAAK,CAAA;IAGzB,MAAM,eAAe,GAAG,KAAK,IAAmB,EAAE;QAChD,IAAI,CAAC,aAAa,EAAE,CAAC;YACnB,IAAI,CAAC;gBACH,WAAW,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;gBACpC,aAAa,GAAG,IAAI,CAAA;YACtB,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO,CAAC,KAAK,CAAC,aAAa,KAAK,EAAE,CAAC,CAAA;gBACnC,WAAW,GAAG,IAAI,CAAA;gBAClB,aAAa,GAAG,IAAI,CAAA;YACtB,CAAC;QACH,CAAC;IACH,CAAC,CAAA;IAGD,MAAM,eAAe,GAAG,GAAa,EAAE;QACrC,IAAI,CAAC,aAAa,EAAE,CAAC;YAEnB,eAAe,EAAE,CAAA;QACnB,CAAC;QACD,OAAO,WAAW,CAAA;IACpB,CAAC,CAAA;IAGD,MAAM,QAAQ,GAAG,KAAK,EAAE,KAAe,EAAiB,EAAE;QACxD,IAAI,CAAC;YACH,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;gBACnB,MAAM,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;YAC3B,CAAC;iBAAM,CAAC;gBACN,MAAM,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAA;YAC/B,CAAC;YACD,WAAW,GAAG,KAAK,CAAA;QACrB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,YAAY,KAAK,EAAE,CAAC,CAAA;QACtC,CAAC;IACH,CAAC,CAAA;IAGD,MAAM,WAAW,GAAG,KAAK,IAAmB,EAAE;QAC5C,IAAI,CAAC;YACH,MAAM,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;YACzB,WAAW,GAAG,IAAI,CAAA;QACpB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,YAAY,KAAK,EAAE,CAAC,CAAA;QACtC,CAAC;IACH,CAAC,CAAA;IAGD,MAAM,KAAK,GAAG,KAAK,IAAmB,EAAE;QACtC,IAAI,CAAC;YACH,MAAM,OAAO,CAAC,KAAK,EAAE,CAAA;YACrB,WAAW,GAAG,IAAI,CAAA;QACpB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,WAAW,KAAK,EAAE,CAAC,CAAA;QACrC,CAAC;IACH,CAAC,CAAA;IAED,OAAO;QACL,IAAI,KAAK;YACP,OAAO,eAAe,EAAE,CAAA;QAC1B,CAAC;QACD,QAAQ;QACR,WAAW;QACX,KAAK;KACN,CAAA;AACH,CAAC"}

package/dist/hooks/useStorageWithIndexedDB.d.ts

@@ -0,0 +1,4 @@
+import type { IDBFactory } from '../../references/browser.d';
+import type { IndexedDBStorageOptions, UseStorageReturn } from '../../types/storage.d';
+import type { ConsoleInterface } from '../../references/console.d';
+export default function useStorageWithIndexedDB<T>(key: string, indexedDB: IDBFactory, options: IndexedDBStorageOptions, console: ConsoleInterface): UseStorageReturn<T>;