@windrun-huaiin/third-ui 7.1.2 → 7.2.1

package/dist/clerk/fingerprint/index.d.ts

@@ -0,0 +1,5 @@
+export * from './fingerprint-shared';
+export * from './types';
+export * from './fingerprint-client';
+export * from './use-fingerprint';
+export * from './fingerprint-provider';

package/dist/clerk/fingerprint/index.js

@@ -0,0 +1,29 @@
+"use client";
+'use strict';
+
+var fingerprintShared = require('./fingerprint-shared.js');
+var fingerprintClient = require('./fingerprint-client.js');
+var useFingerprint = require('./use-fingerprint.js');
+var fingerprintProvider = require('./fingerprint-provider.js');
+
+
+
+exports.FINGERPRINT_CONSTANTS = fingerprintShared.FINGERPRINT_CONSTANTS;
+exports.FINGERPRINT_COOKIE_NAME = fingerprintShared.FINGERPRINT_COOKIE_NAME;
+exports.FINGERPRINT_HEADER_NAME = fingerprintShared.FINGERPRINT_HEADER_NAME;
+exports.FINGERPRINT_STORAGE_KEY = fingerprintShared.FINGERPRINT_STORAGE_KEY;
+exports.isValidFingerprintId = fingerprintShared.isValidFingerprintId;
+exports.clearFingerprintId = fingerprintClient.clearFingerprintId;
+exports.createFingerprintFetch = fingerprintClient.createFingerprintFetch;
+exports.createFingerprintHeaders = fingerprintClient.createFingerprintHeaders;
+exports.generateFingerprintId = fingerprintClient.generateFingerprintId;
+exports.getFingerprintId = fingerprintClient.getFingerprintId;
+exports.getOrGenerateFingerprintId = fingerprintClient.getOrGenerateFingerprintId;
+exports.setFingerprintId = fingerprintClient.setFingerprintId;
+exports.useFingerprintHeaders = fingerprintClient.useFingerprintHeaders;
+exports.useFingerprint = useFingerprint.useFingerprint;
+exports.FingerprintDebugInfo = fingerprintProvider.FingerprintDebugInfo;
+exports.FingerprintProvider = fingerprintProvider.FingerprintProvider;
+exports.useFingerprintContext = fingerprintProvider.useFingerprintContext;
+exports.useFingerprintContextSafe = fingerprintProvider.useFingerprintContextSafe;
+exports.withFingerprint = fingerprintProvider.withFingerprint;

package/dist/clerk/fingerprint/index.mjs

@@ -0,0 +1,5 @@
+"use client";
+export { FINGERPRINT_CONSTANTS, FINGERPRINT_COOKIE_NAME, FINGERPRINT_HEADER_NAME, FINGERPRINT_STORAGE_KEY, isValidFingerprintId } from './fingerprint-shared.mjs';
+export { clearFingerprintId, createFingerprintFetch, createFingerprintHeaders, generateFingerprintId, getFingerprintId, getOrGenerateFingerprintId, setFingerprintId, useFingerprintHeaders } from './fingerprint-client.mjs';
+export { useFingerprint } from './use-fingerprint.mjs';
+export { FingerprintDebugInfo, FingerprintProvider, useFingerprintContext, useFingerprintContextSafe, withFingerprint } from './fingerprint-provider.mjs';

package/dist/clerk/fingerprint/server.d.ts

@@ -0,0 +1,3 @@
+export * from './fingerprint-shared';
+export * from './types';
+export * from './fingerprint-server';

package/dist/clerk/fingerprint/server.js

@@ -0,0 +1,15 @@
+'use strict';
+
+var fingerprintShared = require('./fingerprint-shared.js');
+var fingerprintServer = require('./fingerprint-server.js');
+
+
+
+exports.FINGERPRINT_CONSTANTS = fingerprintShared.FINGERPRINT_CONSTANTS;
+exports.FINGERPRINT_COOKIE_NAME = fingerprintShared.FINGERPRINT_COOKIE_NAME;
+exports.FINGERPRINT_HEADER_NAME = fingerprintShared.FINGERPRINT_HEADER_NAME;
+exports.FINGERPRINT_STORAGE_KEY = fingerprintShared.FINGERPRINT_STORAGE_KEY;
+exports.isValidFingerprintId = fingerprintShared.isValidFingerprintId;
+exports.extractFingerprintFromNextRequest = fingerprintServer.extractFingerprintFromNextRequest;
+exports.extractFingerprintId = fingerprintServer.extractFingerprintId;
+exports.generateServerFingerprintId = fingerprintServer.generateServerFingerprintId;

package/dist/clerk/fingerprint/server.mjs

@@ -0,0 +1,2 @@
+export { FINGERPRINT_CONSTANTS, FINGERPRINT_COOKIE_NAME, FINGERPRINT_HEADER_NAME, FINGERPRINT_STORAGE_KEY, isValidFingerprintId } from './fingerprint-shared.mjs';
+export { extractFingerprintFromNextRequest, extractFingerprintId, generateServerFingerprintId } from './fingerprint-server.mjs';

package/dist/clerk/fingerprint/types.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Fingerprint System Types
+ * 指纹识别系统的类型定义
+ */
+export interface AnonymousUser {
+    userId: string;
+    fingerprintId: string;
+    clerkUserId: string;
+    email: string;
+    status: string;
+    createdAt: string;
+}
+export interface Credits {
+    balanceFree: number;
+    balancePaid: number;
+    totalBalance: number;
+}
+export interface FingerprintConfig {
+    /** API endpoint for anonymous user initialization */
+    apiEndpoint: string;
+    /** Whether to automatically initialize the user on load */
+    autoInitialize?: boolean;
+    /** Initial credits for new users */
+    initialCredits?: number;
+}
+export interface UseFingerprintResult {
+    fingerprintId: string | null;
+    anonymousUser: AnonymousUser | null;
+    credits: Credits | null;
+    isLoading: boolean;
+    isInitialized: boolean;
+    error: string | null;
+    initializeAnonymousUser: () => Promise<void>;
+    refreshUserData: () => Promise<void>;
+}
+export interface FingerprintContextType extends UseFingerprintResult {
+}
+export interface FingerprintProviderProps {
+    children: React.ReactNode;
+    config: FingerprintConfig;
+}
+export interface FingerprintFetch {
+    (url: string | URL | Request, init?: RequestInit): Promise<Response>;
+}

package/dist/clerk/fingerprint/use-fingerprint.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/fingerprint/use-fingerprint.js

@@ -0,0 +1,176 @@
+"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 fingerprintClient = require('./fingerprint-client.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, 没有就生成新的fingerprint ID
+            const currentFingerprintId = yield fingerprintClient.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 fingerprintClient.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) {
+                    fingerprintClient.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 fingerprintClient.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 fingerprintClient.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;

package/dist/clerk/fingerprint/use-fingerprint.mjs

@@ -0,0 +1,174 @@
+"use client";
+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';
+import { useState, useCallback, useEffect } from 'react';
+import { createFingerprintHeaders, setFingerprintId, getOrGenerateFingerprintId } from './fingerprint-client.mjs';
+
+/**
+ * Hook for managing fingerprint ID and anonymous user data
+ * Accepts configuration to customize API endpoint and behavior
+ */
+function useFingerprint(config) {
+    const [fingerprintId, setFingerprintIdState] = useState(null);
+    const [anonymousUser, setAnonymousUser] = useState(null);
+    const [credits, setCredits] = useState(null);
+    const [isLoading, setIsLoading] = useState(true);
+    const [isInitialized, setIsInitialized] = useState(false);
+    const [error, setError] = useState(null);
+    /**
+     * 第一阶段：初始化fingerprint ID
+     */
+    const initializeFingerprintId = useCallback(() => __awaiter(this, void 0, void 0, function* () {
+        if (typeof window === 'undefined')
+            return null;
+        try {
+            // 优先检查现有ID, 没有就生成新的fingerprint ID
+            const currentFingerprintId = yield 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 = useCallback(() => __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 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) {
+                    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 = useCallback(() => __awaiter(this, void 0, void 0, function* () {
+        if (!fingerprintId)
+            return;
+        try {
+            setError(null);
+            const fingerprintHeaders = yield 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 = useCallback(() => __awaiter(this, void 0, void 0, function* () {
+        if (!fingerprintId)
+            return;
+        try {
+            const fingerprintHeaders = yield 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
+    useEffect(() => {
+        if (typeof window === 'undefined')
+            return;
+        const initFingerprint = () => __awaiter(this, void 0, void 0, function* () {
+            yield initializeFingerprintId();
+            setIsLoading(false); // 第一阶段完成，结束加载状态
+        });
+        initFingerprint();
+    }, [initializeFingerprintId]);
+    // 第二阶段：有指纹ID后检查现有用户
+    useEffect(() => {
+        if (!fingerprintId || isInitialized)
+            return;
+        checkExistingUser();
+    }, [fingerprintId, isInitialized, checkExistingUser]);
+    // 第三阶段：如果没有现有用户且自动初始化开启，则创建新用户
+    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,
+    };
+}
+
+export { useFingerprint };

package/dist/clerk/fingerprint.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Fingerprint Core Utilities
+ * 基于浏览器特征生成唯一的设备指纹ID，用于匿名用户识别
+ * Core fingerprint generation logic - completely generic
+ *
+ * NOTE: This module should only be used on the client-side
+ */
+/**
+ * 生成基于真实浏览器特征的fingerprint ID
+ * 使用FingerprintJS收集浏览器特征并生成唯一标识
+ */
+export declare function generateFingerprintId(): Promise<string>;
+/**
+ * 获取当前的fingerprint ID
+ */
+export declare function getFingerprintId(): string | null;
+/**
+ * 设置fingerprint ID到存储
+ */
+export declare function setFingerprintId(fingerprintId: string): void;
+/**
+ * 清除fingerprint ID
+ */
+export declare function clearFingerprintId(): void;
+/**
+ * 获取或生成fingerprint ID
+ * 如果不存在则自动生成新的
+ */
+export declare function getOrGenerateFingerprintId(): Promise<string>;
+/**
+ * 验证fingerprint ID格式
+ */
+export declare function isValidFingerprintId(fingerprintId: string): boolean;
+/**
+ * 创建包含fingerprint ID的fetch headers
+ */
+export declare function createFingerprintHeaders(): Promise<Record<string, string>>;
+/**
+ * Hook for generating fingerprint headers
+ */
+export declare function useFingerprintHeaders(): () => Promise<Record<string, string>>;
+/**
+ * Create a fetch wrapper that automatically includes fingerprint headers
+ */
+export declare function createFingerprintFetch(): (url: string | URL | Request, init?: RequestInit) => Promise<Response>;
+/**
+ * 从请求中提取fingerprint ID
+ * 优先级：header > cookie > query参数
+ */
+export declare function extractFingerprintId(headers: Headers | Record<string, string>, cookies?: Record<string, string>, query?: Record<string, string | undefined>): string | null;
+export declare const FINGERPRINT_CONSTANTS: {
+    readonly STORAGE_KEY: "diaomao_fingerprint_id";
+    readonly HEADER_NAME: "x-fingerprint-id";
+    readonly COOKIE_NAME: "fingerprint_id";
+};