@windrun-huaiin/third-ui 7.1.1 → 7.2.0

package/dist/clerk/fingerprint.js

@@ -0,0 +1,237 @@
+'use strict';
+
+var tslib_es6 = require('../node_modules/.pnpm/@rollup_plugin-typescript@12.1.4_rollup@4.46.2_tslib@2.8.1_typescript@5.9.2/node_modules/tslib/tslib.es6.js');
+
+/**
+ * Fingerprint Core Utilities
+ * 基于浏览器特征生成唯一的设备指纹ID，用于匿名用户识别
+ * Core fingerprint generation logic - completely generic
+ *
+ * NOTE: This module should only be used on the client-side
+ */
+// Dynamic import to avoid SSR issues
+let FingerprintJS = null;
+// Only import in browser environment
+if (typeof window !== 'undefined') {
+    Promise.resolve().then(function () { return require('../node_modules/.pnpm/@fingerprintjs_fingerprintjs@4.6.2/node_modules/@fingerprintjs/fingerprintjs/dist/fp.esm.js'); }).then((module) => {
+        FingerprintJS = module.default;
+    });
+}
+// Fingerprint ID的存储键
+const FINGERPRINT_STORAGE_KEY = 'diaomao_fingerprint_id';
+const FINGERPRINT_HEADER_NAME = 'x-fingerprint-id';
+const FINGERPRINT_COOKIE_NAME = 'fingerprint_id';
+/**
+ * 生成基于真实浏览器特征的fingerprint ID
+ * 使用FingerprintJS收集浏览器特征并生成唯一标识
+ */
+function generateFingerprintId() {
+    return tslib_es6.__awaiter(this, void 0, void 0, function* () {
+        // 如果在浏览器环境中，尝试使用现有的fingerprint ID
+        if (typeof window !== 'undefined') {
+            // 首先检查localStorage
+            const existingId = localStorage.getItem(FINGERPRINT_STORAGE_KEY);
+            if (existingId && isValidFingerprintId(existingId)) {
+                return existingId;
+            }
+            // 检查cookie
+            const cookieId = getCookieValue(FINGERPRINT_COOKIE_NAME);
+            if (cookieId && isValidFingerprintId(cookieId)) {
+                // 同步到localStorage
+                localStorage.setItem(FINGERPRINT_STORAGE_KEY, cookieId);
+                return cookieId;
+            }
+            try {
+                // 等待FingerprintJS加载完成
+                if (!FingerprintJS) {
+                    const module = yield Promise.resolve().then(function () { return require('../node_modules/.pnpm/@fingerprintjs_fingerprintjs@4.6.2/node_modules/@fingerprintjs/fingerprintjs/dist/fp.esm.js'); });
+                    FingerprintJS = module.default;
+                }
+                // 使用FingerprintJS生成基于浏览器特征的指纹
+                const fp = yield FingerprintJS.load();
+                const result = yield fp.get();
+                const fingerprintId = `fp_${result.visitorId}`;
+                // 存储到localStorage和cookie
+                localStorage.setItem(FINGERPRINT_STORAGE_KEY, fingerprintId);
+                setCookie(FINGERPRINT_COOKIE_NAME, fingerprintId, 365); // 365天过期
+                return fingerprintId;
+            }
+            catch (error) {
+                console.warn('Failed to generate fingerprint with FingerprintJS:', error);
+                // 降级方案：生成时间戳+随机数，但只在没有任何现有ID时使用
+                const fallbackId = `fp_fallback_${Date.now()}_${Math.random().toString(36).slice(2, 11)}`;
+                localStorage.setItem(FINGERPRINT_STORAGE_KEY, fallbackId);
+                setCookie(FINGERPRINT_COOKIE_NAME, fallbackId, 365);
+                return fallbackId;
+            }
+        }
+        // 服务端环境降级方案
+        return `fp_server_${Date.now()}_${Math.random().toString(36).slice(2, 11)}`;
+    });
+}
+/**
+ * 获取当前的fingerprint ID
+ */
+function getFingerprintId() {
+    if (typeof window === 'undefined') {
+        return null;
+    }
+    // 首先检查localStorage
+    const localStorageId = localStorage.getItem(FINGERPRINT_STORAGE_KEY);
+    if (localStorageId) {
+        return localStorageId;
+    }
+    // 检查cookie
+    const cookieId = getCookieValue(FINGERPRINT_COOKIE_NAME);
+    if (cookieId) {
+        // 同步到localStorage
+        localStorage.setItem(FINGERPRINT_STORAGE_KEY, cookieId);
+        return cookieId;
+    }
+    return null;
+}
+/**
+ * 设置fingerprint ID到存储
+ */
+function setFingerprintId(fingerprintId) {
+    if (typeof window === 'undefined') {
+        return;
+    }
+    localStorage.setItem(FINGERPRINT_STORAGE_KEY, fingerprintId);
+    setCookie(FINGERPRINT_COOKIE_NAME, fingerprintId, 365);
+}
+/**
+ * 清除fingerprint ID
+ */
+function clearFingerprintId() {
+    if (typeof window === 'undefined') {
+        return;
+    }
+    localStorage.removeItem(FINGERPRINT_STORAGE_KEY);
+    deleteCookie(FINGERPRINT_COOKIE_NAME);
+}
+/**
+ * 获取或生成fingerprint ID
+ * 如果不存在则自动生成新的
+ */
+function getOrGenerateFingerprintId() {
+    return tslib_es6.__awaiter(this, void 0, void 0, function* () {
+        const existingId = getFingerprintId();
+        if (existingId) {
+            return existingId;
+        }
+        return yield generateFingerprintId();
+    });
+}
+/**
+ * 验证fingerprint ID格式
+ */
+function isValidFingerprintId(fingerprintId) {
+    if (!fingerprintId)
+        return false;
+    // 支持多种格式：
+    // - fp_ + FingerprintJS visitorId (变长字符串)
+    // - fp_fallback_ + 时间戳_随机字符串 (客户端降级方案)
+    // - fp_server_ + 时间戳_随机字符串 (服务端降级)
+    return /^fp(_fallback|_server)?_[a-zA-Z0-9_]+$/.test(fingerprintId);
+}
+/**
+ * 创建包含fingerprint ID的fetch headers
+ */
+function createFingerprintHeaders() {
+    return tslib_es6.__awaiter(this, void 0, void 0, function* () {
+        const fingerprintId = yield getOrGenerateFingerprintId();
+        return {
+            [FINGERPRINT_HEADER_NAME]: fingerprintId,
+        };
+    });
+}
+/**
+ * Hook for generating fingerprint headers
+ */
+function useFingerprintHeaders() {
+    return createFingerprintHeaders;
+}
+/**
+ * Create a fetch wrapper that automatically includes fingerprint headers
+ */
+function createFingerprintFetch() {
+    return (url, init) => tslib_es6.__awaiter(this, void 0, void 0, function* () {
+        const fingerprintHeaders = yield createFingerprintHeaders();
+        const headers = Object.assign(Object.assign({}, fingerprintHeaders), ((init === null || init === void 0 ? void 0 : init.headers) || {}));
+        return fetch(url, Object.assign(Object.assign({}, init), { headers }));
+    });
+}
+/**
+ * 从请求中提取fingerprint ID
+ * 优先级：header > cookie > query参数
+ */
+function extractFingerprintId(headers, cookies, query) {
+    // 1. 从header中获取
+    const headerValue = headers instanceof Headers
+        ? headers.get(FINGERPRINT_HEADER_NAME)
+        : headers[FINGERPRINT_HEADER_NAME];
+    if (headerValue && isValidFingerprintId(headerValue)) {
+        return headerValue;
+    }
+    // 2. 从cookie中获取
+    if (cookies) {
+        const cookieValue = cookies[FINGERPRINT_COOKIE_NAME];
+        if (cookieValue && isValidFingerprintId(cookieValue)) {
+            return cookieValue;
+        }
+    }
+    // 3. 从query参数中获取
+    if (query) {
+        const queryValue = query.fingerprint_id || query.fp_id;
+        if (queryValue && isValidFingerprintId(queryValue)) {
+            return queryValue;
+        }
+    }
+    return null;
+}
+// Cookie 辅助函数
+function getCookieValue(name) {
+    var _a;
+    if (typeof document === 'undefined') {
+        return null;
+    }
+    const value = `; ${document.cookie}`;
+    const parts = value.split(`; ${name}=`);
+    if (parts.length === 2) {
+        return ((_a = parts.pop()) === null || _a === void 0 ? void 0 : _a.split(';').shift()) || null;
+    }
+    return null;
+}
+function setCookie(name, value, days) {
+    if (typeof document === 'undefined') {
+        return;
+    }
+    const expires = new Date();
+    expires.setTime(expires.getTime() + days * 24 * 60 * 60 * 1000);
+    document.cookie = `${name}=${value};expires=${expires.toUTCString()};path=/;SameSite=Lax`;
+}
+function deleteCookie(name) {
+    if (typeof document === 'undefined') {
+        return;
+    }
+    document.cookie = `${name}=;expires=Thu, 01 Jan 1970 00:00:00 GMT;path=/`;
+}
+// 常量导出
+const FINGERPRINT_CONSTANTS = {
+    STORAGE_KEY: FINGERPRINT_STORAGE_KEY,
+    HEADER_NAME: FINGERPRINT_HEADER_NAME,
+    COOKIE_NAME: FINGERPRINT_COOKIE_NAME,
+};
+
+exports.FINGERPRINT_CONSTANTS = FINGERPRINT_CONSTANTS;
+exports.clearFingerprintId = clearFingerprintId;
+exports.createFingerprintFetch = createFingerprintFetch;
+exports.createFingerprintHeaders = createFingerprintHeaders;
+exports.extractFingerprintId = extractFingerprintId;
+exports.generateFingerprintId = generateFingerprintId;
+exports.getFingerprintId = getFingerprintId;
+exports.getOrGenerateFingerprintId = getOrGenerateFingerprintId;
+exports.isValidFingerprintId = isValidFingerprintId;
+exports.setFingerprintId = setFingerprintId;
+exports.useFingerprintHeaders = useFingerprintHeaders;

package/dist/clerk/fingerprint.mjs

@@ -0,0 +1,225 @@
+import { __awaiter } from '../node_modules/.pnpm/@rollup_plugin-typescript@12.1.4_rollup@4.46.2_tslib@2.8.1_typescript@5.9.2/node_modules/tslib/tslib.es6.mjs';
+
+/**
+ * Fingerprint Core Utilities
+ * 基于浏览器特征生成唯一的设备指纹ID，用于匿名用户识别
+ * Core fingerprint generation logic - completely generic
+ *
+ * NOTE: This module should only be used on the client-side
+ */
+// Dynamic import to avoid SSR issues
+let FingerprintJS = null;
+// Only import in browser environment
+if (typeof window !== 'undefined') {
+    import('../node_modules/.pnpm/@fingerprintjs_fingerprintjs@4.6.2/node_modules/@fingerprintjs/fingerprintjs/dist/fp.esm.mjs').then((module) => {
+        FingerprintJS = module.default;
+    });
+}
+// Fingerprint ID的存储键
+const FINGERPRINT_STORAGE_KEY = 'diaomao_fingerprint_id';
+const FINGERPRINT_HEADER_NAME = 'x-fingerprint-id';
+const FINGERPRINT_COOKIE_NAME = 'fingerprint_id';
+/**
+ * 生成基于真实浏览器特征的fingerprint ID
+ * 使用FingerprintJS收集浏览器特征并生成唯一标识
+ */
+function generateFingerprintId() {
+    return __awaiter(this, void 0, void 0, function* () {
+        // 如果在浏览器环境中，尝试使用现有的fingerprint ID
+        if (typeof window !== 'undefined') {
+            // 首先检查localStorage
+            const existingId = localStorage.getItem(FINGERPRINT_STORAGE_KEY);
+            if (existingId && isValidFingerprintId(existingId)) {
+                return existingId;
+            }
+            // 检查cookie
+            const cookieId = getCookieValue(FINGERPRINT_COOKIE_NAME);
+            if (cookieId && isValidFingerprintId(cookieId)) {
+                // 同步到localStorage
+                localStorage.setItem(FINGERPRINT_STORAGE_KEY, cookieId);
+                return cookieId;
+            }
+            try {
+                // 等待FingerprintJS加载完成
+                if (!FingerprintJS) {
+                    const module = yield import('../node_modules/.pnpm/@fingerprintjs_fingerprintjs@4.6.2/node_modules/@fingerprintjs/fingerprintjs/dist/fp.esm.mjs');
+                    FingerprintJS = module.default;
+                }
+                // 使用FingerprintJS生成基于浏览器特征的指纹
+                const fp = yield FingerprintJS.load();
+                const result = yield fp.get();
+                const fingerprintId = `fp_${result.visitorId}`;
+                // 存储到localStorage和cookie
+                localStorage.setItem(FINGERPRINT_STORAGE_KEY, fingerprintId);
+                setCookie(FINGERPRINT_COOKIE_NAME, fingerprintId, 365); // 365天过期
+                return fingerprintId;
+            }
+            catch (error) {
+                console.warn('Failed to generate fingerprint with FingerprintJS:', error);
+                // 降级方案：生成时间戳+随机数，但只在没有任何现有ID时使用
+                const fallbackId = `fp_fallback_${Date.now()}_${Math.random().toString(36).slice(2, 11)}`;
+                localStorage.setItem(FINGERPRINT_STORAGE_KEY, fallbackId);
+                setCookie(FINGERPRINT_COOKIE_NAME, fallbackId, 365);
+                return fallbackId;
+            }
+        }
+        // 服务端环境降级方案
+        return `fp_server_${Date.now()}_${Math.random().toString(36).slice(2, 11)}`;
+    });
+}
+/**
+ * 获取当前的fingerprint ID
+ */
+function getFingerprintId() {
+    if (typeof window === 'undefined') {
+        return null;
+    }
+    // 首先检查localStorage
+    const localStorageId = localStorage.getItem(FINGERPRINT_STORAGE_KEY);
+    if (localStorageId) {
+        return localStorageId;
+    }
+    // 检查cookie
+    const cookieId = getCookieValue(FINGERPRINT_COOKIE_NAME);
+    if (cookieId) {
+        // 同步到localStorage
+        localStorage.setItem(FINGERPRINT_STORAGE_KEY, cookieId);
+        return cookieId;
+    }
+    return null;
+}
+/**
+ * 设置fingerprint ID到存储
+ */
+function setFingerprintId(fingerprintId) {
+    if (typeof window === 'undefined') {
+        return;
+    }
+    localStorage.setItem(FINGERPRINT_STORAGE_KEY, fingerprintId);
+    setCookie(FINGERPRINT_COOKIE_NAME, fingerprintId, 365);
+}
+/**
+ * 清除fingerprint ID
+ */
+function clearFingerprintId() {
+    if (typeof window === 'undefined') {
+        return;
+    }
+    localStorage.removeItem(FINGERPRINT_STORAGE_KEY);
+    deleteCookie(FINGERPRINT_COOKIE_NAME);
+}
+/**
+ * 获取或生成fingerprint ID
+ * 如果不存在则自动生成新的
+ */
+function getOrGenerateFingerprintId() {
+    return __awaiter(this, void 0, void 0, function* () {
+        const existingId = getFingerprintId();
+        if (existingId) {
+            return existingId;
+        }
+        return yield generateFingerprintId();
+    });
+}
+/**
+ * 验证fingerprint ID格式
+ */
+function isValidFingerprintId(fingerprintId) {
+    if (!fingerprintId)
+        return false;
+    // 支持多种格式：
+    // - fp_ + FingerprintJS visitorId (变长字符串)
+    // - fp_fallback_ + 时间戳_随机字符串 (客户端降级方案)
+    // - fp_server_ + 时间戳_随机字符串 (服务端降级)
+    return /^fp(_fallback|_server)?_[a-zA-Z0-9_]+$/.test(fingerprintId);
+}
+/**
+ * 创建包含fingerprint ID的fetch headers
+ */
+function createFingerprintHeaders() {
+    return __awaiter(this, void 0, void 0, function* () {
+        const fingerprintId = yield getOrGenerateFingerprintId();
+        return {
+            [FINGERPRINT_HEADER_NAME]: fingerprintId,
+        };
+    });
+}
+/**
+ * Hook for generating fingerprint headers
+ */
+function useFingerprintHeaders() {
+    return createFingerprintHeaders;
+}
+/**
+ * Create a fetch wrapper that automatically includes fingerprint headers
+ */
+function createFingerprintFetch() {
+    return (url, init) => __awaiter(this, void 0, void 0, function* () {
+        const fingerprintHeaders = yield createFingerprintHeaders();
+        const headers = Object.assign(Object.assign({}, fingerprintHeaders), ((init === null || init === void 0 ? void 0 : init.headers) || {}));
+        return fetch(url, Object.assign(Object.assign({}, init), { headers }));
+    });
+}
+/**
+ * 从请求中提取fingerprint ID
+ * 优先级：header > cookie > query参数
+ */
+function extractFingerprintId(headers, cookies, query) {
+    // 1. 从header中获取
+    const headerValue = headers instanceof Headers
+        ? headers.get(FINGERPRINT_HEADER_NAME)
+        : headers[FINGERPRINT_HEADER_NAME];
+    if (headerValue && isValidFingerprintId(headerValue)) {
+        return headerValue;
+    }
+    // 2. 从cookie中获取
+    if (cookies) {
+        const cookieValue = cookies[FINGERPRINT_COOKIE_NAME];
+        if (cookieValue && isValidFingerprintId(cookieValue)) {
+            return cookieValue;
+        }
+    }
+    // 3. 从query参数中获取
+    if (query) {
+        const queryValue = query.fingerprint_id || query.fp_id;
+        if (queryValue && isValidFingerprintId(queryValue)) {
+            return queryValue;
+        }
+    }
+    return null;
+}
+// Cookie 辅助函数
+function getCookieValue(name) {
+    var _a;
+    if (typeof document === 'undefined') {
+        return null;
+    }
+    const value = `; ${document.cookie}`;
+    const parts = value.split(`; ${name}=`);
+    if (parts.length === 2) {
+        return ((_a = parts.pop()) === null || _a === void 0 ? void 0 : _a.split(';').shift()) || null;
+    }
+    return null;
+}
+function setCookie(name, value, days) {
+    if (typeof document === 'undefined') {
+        return;
+    }
+    const expires = new Date();
+    expires.setTime(expires.getTime() + days * 24 * 60 * 60 * 1000);
+    document.cookie = `${name}=${value};expires=${expires.toUTCString()};path=/;SameSite=Lax`;
+}
+function deleteCookie(name) {
+    if (typeof document === 'undefined') {
+        return;
+    }
+    document.cookie = `${name}=;expires=Thu, 01 Jan 1970 00:00:00 GMT;path=/`;
+}
+// 常量导出
+const FINGERPRINT_CONSTANTS = {
+    STORAGE_KEY: FINGERPRINT_STORAGE_KEY,
+    HEADER_NAME: FINGERPRINT_HEADER_NAME,
+    COOKIE_NAME: FINGERPRINT_COOKIE_NAME,
+};
+
+export { FINGERPRINT_CONSTANTS, clearFingerprintId, createFingerprintFetch, createFingerprintHeaders, extractFingerprintId, generateFingerprintId, getFingerprintId, getOrGenerateFingerprintId, isValidFingerprintId, setFingerprintId, useFingerprintHeaders };

package/dist/clerk/hooks/useFingerprint.d.ts

@@ -0,0 +1,6 @@
+import type { UseFingerprintResult, FingerprintConfig } from '../types';
+/**
+ * Hook for managing fingerprint ID and anonymous user data
+ * Accepts configuration to customize API endpoint and behavior
+ */
+export declare function useFingerprint(config: FingerprintConfig): UseFingerprintResult;

package/dist/clerk/hooks/useFingerprint.js

@@ -0,0 +1,182 @@
+"use client";
+'use strict';
+
+var tslib_es6 = require('../../node_modules/.pnpm/@rollup_plugin-typescript@12.1.4_rollup@4.46.2_tslib@2.8.1_typescript@5.9.2/node_modules/tslib/tslib.es6.js');
+var React = require('react');
+var fingerprint = require('../fingerprint.js');
+
+/**
+ * Hook for managing fingerprint ID and anonymous user data
+ * Accepts configuration to customize API endpoint and behavior
+ */
+function useFingerprint(config) {
+    const [fingerprintId, setFingerprintIdState] = React.useState(null);
+    const [anonymousUser, setAnonymousUser] = React.useState(null);
+    const [credits, setCredits] = React.useState(null);
+    const [isLoading, setIsLoading] = React.useState(true);
+    const [isInitialized, setIsInitialized] = React.useState(false);
+    const [error, setError] = React.useState(null);
+    /**
+     * 第一阶段：初始化fingerprint ID
+     */
+    const initializeFingerprintId = React.useCallback(() => tslib_es6.__awaiter(this, void 0, void 0, function* () {
+        if (typeof window === 'undefined')
+            return null;
+        try {
+            // 优先检查现有ID
+            const existingId = fingerprint.getFingerprintId();
+            if (existingId) {
+                setFingerprintIdState(existingId);
+                return existingId;
+            }
+            // 生成新的fingerprint ID
+            const currentFingerprintId = yield fingerprint.getOrGenerateFingerprintId();
+            setFingerprintIdState(currentFingerprintId);
+            return currentFingerprintId;
+        }
+        catch (error) {
+            console.error('Failed to initialize fingerprint ID:', error);
+            setError('Failed to generate fingerprint ID');
+            return null;
+        }
+    }), []);
+    /**
+     * 第二阶段：初始化匿名用户
+     */
+    const initializeAnonymousUser = React.useCallback(() => tslib_es6.__awaiter(this, void 0, void 0, function* () {
+        if (!fingerprintId) {
+            console.warn('Cannot initialize user without fingerprint ID');
+            return;
+        }
+        try {
+            setIsLoading(true);
+            setError(null);
+            const fingerprintHeaders = yield fingerprint.createFingerprintHeaders();
+            const response = yield fetch(config.apiEndpoint, {
+                method: 'POST',
+                headers: Object.assign({ 'Content-Type': 'application/json' }, fingerprintHeaders),
+                body: JSON.stringify({
+                    fingerprintId: fingerprintId,
+                }),
+            });
+            if (!response.ok) {
+                const errorData = yield response.json().catch(() => ({}));
+                throw new Error(errorData.error || 'Failed to initialize anonymous user');
+            }
+            const data = yield response.json();
+            if (data.success) {
+                setAnonymousUser(data.user);
+                setCredits(data.credits);
+                setIsInitialized(true);
+                // 确保fingerprint ID同步
+                if (data.user.fingerprintId !== fingerprintId) {
+                    fingerprint.setFingerprintId(data.user.fingerprintId);
+                    setFingerprintIdState(data.user.fingerprintId);
+                }
+            }
+            else {
+                throw new Error(data.error || 'Unknown error occurred');
+            }
+        }
+        catch (err) {
+            console.error('Failed to initialize anonymous user:', err);
+            setError(err instanceof Error ? err.message : 'Unknown error');
+        }
+        finally {
+            setIsLoading(false);
+        }
+    }), [fingerprintId]);
+    /**
+     * 刷新用户数据
+     */
+    const refreshUserData = React.useCallback(() => tslib_es6.__awaiter(this, void 0, void 0, function* () {
+        if (!fingerprintId)
+            return;
+        try {
+            setError(null);
+            const fingerprintHeaders = yield fingerprint.createFingerprintHeaders();
+            const response = yield fetch(`${config.apiEndpoint}?fingerprintId=${fingerprintId}`, {
+                method: 'GET',
+                headers: fingerprintHeaders,
+            });
+            if (!response.ok) {
+                if (response.status === 404) {
+                    // 用户不存在，需要重新初始化
+                    yield initializeAnonymousUser();
+                    return;
+                }
+                throw new Error('Failed to fetch user data');
+            }
+            const data = yield response.json();
+            if (data.success) {
+                setAnonymousUser(data.user);
+                setCredits(data.credits);
+            }
+        }
+        catch (err) {
+            console.error('Failed to refresh user data:', err);
+            setError(err instanceof Error ? err.message : 'Unknown error');
+        }
+    }), [fingerprintId, initializeAnonymousUser, config.apiEndpoint]);
+    /**
+     * 检查现有用户数据（仅在有fingerprint ID时执行）
+     */
+    const checkExistingUser = React.useCallback(() => tslib_es6.__awaiter(this, void 0, void 0, function* () {
+        if (!fingerprintId)
+            return;
+        try {
+            const fingerprintHeaders = yield fingerprint.createFingerprintHeaders();
+            const response = yield fetch(`${config.apiEndpoint}?fingerprintId=${fingerprintId}`, {
+                method: 'GET',
+                headers: fingerprintHeaders,
+            });
+            if (response.ok) {
+                const data = yield response.json();
+                if (data.success) {
+                    setAnonymousUser(data.user);
+                    setCredits(data.credits);
+                    setIsInitialized(true);
+                }
+            }
+        }
+        catch (err) {
+            console.error('Failed to check existing user:', err);
+        }
+    }), [fingerprintId, config.apiEndpoint]);
+    // 第一阶段：页面加载完成后生成指纹ID
+    React.useEffect(() => {
+        if (typeof window === 'undefined')
+            return;
+        const initFingerprint = () => tslib_es6.__awaiter(this, void 0, void 0, function* () {
+            yield initializeFingerprintId();
+            setIsLoading(false); // 第一阶段完成，结束加载状态
+        });
+        initFingerprint();
+    }, [initializeFingerprintId]);
+    // 第二阶段：有指纹ID后检查现有用户
+    React.useEffect(() => {
+        if (!fingerprintId || isInitialized)
+            return;
+        checkExistingUser();
+    }, [fingerprintId, isInitialized, checkExistingUser]);
+    // 第三阶段：如果没有现有用户且自动初始化开启，则创建新用户
+    React.useEffect(() => {
+        if (!fingerprintId || isInitialized || isLoading || error)
+            return;
+        if (config.autoInitialize === false)
+            return;
+        initializeAnonymousUser();
+    }, [fingerprintId, isInitialized, isLoading, error, initializeAnonymousUser, config.autoInitialize]);
+    return {
+        fingerprintId,
+        anonymousUser,
+        credits,
+        isLoading,
+        isInitialized,
+        error,
+        initializeAnonymousUser,
+        refreshUserData,
+    };
+}
+
+exports.useFingerprint = useFingerprint;