@windrun-huaiin/third-ui 7.1.1 → 7.2.0

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

@@ -0,0 +1,174 @@
+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 { FINGERPRINT_STORAGE_KEY, isValidFingerprintId, FINGERPRINT_COOKIE_NAME } from './fingerprint-shared.mjs';
+
+/**
+ * Fingerprint Client Utilities
+ * 客户端专用的指纹生成和管理逻辑
+ * 只能在浏览器环境中使用
+ */
+// Dynamic import to avoid SSR issues
+let FingerprintJS = null;
+/**
+ * 生成基于真实浏览器特征的fingerprint ID
+ * 使用FingerprintJS收集浏览器特征并生成唯一标识
+ * 只能在客户端使用
+ */
+function generateFingerprintId() {
+    return __awaiter(this, void 0, void 0, function* () {
+        if (typeof window === 'undefined') {
+            throw new Error('generateFingerprintId can only be used in browser environment');
+        }
+        // 首先检查现有ID
+        const existingId = getFingerprintId();
+        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);
+            // 降级方案：生成时间戳+随机数
+            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;
+        }
+    });
+}
+/**
+ * 获取当前的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') {
+        throw new Error('setFingerprintId can only be used in browser environment');
+    }
+    localStorage.setItem(FINGERPRINT_STORAGE_KEY, fingerprintId);
+    setCookie(FINGERPRINT_COOKIE_NAME, fingerprintId, 365);
+}
+/**
+ * 清除fingerprint ID
+ * 只能在客户端使用
+ */
+function clearFingerprintId() {
+    if (typeof window === 'undefined') {
+        throw new Error('clearFingerprintId can only be used in browser environment');
+    }
+    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的fetch headers
+ * 只能在客户端使用
+ */
+function createFingerprintHeaders() {
+    return __awaiter(this, void 0, void 0, function* () {
+        const fingerprintId = yield getOrGenerateFingerprintId();
+        return {
+            'x-fingerprint-id': 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 }));
+    });
+}
+// 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=/`;
+}
+
+export { clearFingerprintId, createFingerprintFetch, createFingerprintHeaders, generateFingerprintId, getFingerprintId, getOrGenerateFingerprintId, setFingerprintId, useFingerprintHeaders };

package/dist/clerk/fingerprint/fingerprint-provider.d.ts

@@ -0,0 +1,25 @@
+import React from 'react';
+import type { FingerprintContextType, FingerprintProviderProps } from './types';
+/**
+ * Fingerprint Provider Component
+ * 为应用提供fingerprint和匿名用户管理功能
+ */
+export declare function FingerprintProvider({ children, config }: FingerprintProviderProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * Hook to use fingerprint context
+ */
+export declare function useFingerprintContext(): FingerprintContextType;
+/**
+ * Safe hook to use fingerprint context - returns null if no provider
+ * 安全版本的fingerprint context hook - 如果没有Provider则返回null
+ */
+export declare function useFingerprintContextSafe(): FingerprintContextType | null;
+/**
+ * HOC for components that need fingerprint functionality
+ * Note: This HOC now requires config to be passed externally
+ */
+export declare function withFingerprint<P extends object>(Component: React.ComponentType<P>, config: FingerprintProviderProps['config']): (props: P) => import("react/jsx-runtime").JSX.Element;
+/**
+ * 组件：显示用户状态和积分信息（用于调试）
+ */
+export declare function FingerprintDebugInfo(): import("react/jsx-runtime").JSX.Element | null;

package/dist/clerk/fingerprint/fingerprint-provider.js

@@ -0,0 +1,71 @@
+"use client";
+'use strict';
+
+var jsxRuntime = require('react/jsx-runtime');
+var React = require('react');
+var useFingerprint = require('./use-fingerprint.js');
+
+const FingerprintContext = React.createContext(undefined);
+/**
+ * Fingerprint Provider Component
+ * 为应用提供fingerprint和匿名用户管理功能
+ */
+function FingerprintProvider({ children, config }) {
+    const fingerprintData = useFingerprint.useFingerprint(config);
+    return (jsxRuntime.jsx(FingerprintContext.Provider, { value: fingerprintData, children: children }));
+}
+/**
+ * Hook to use fingerprint context
+ */
+function useFingerprintContext() {
+    const context = React.useContext(FingerprintContext);
+    if (context === undefined) {
+        throw new Error('useFingerprintContext must be used within a FingerprintProvider');
+    }
+    return context;
+}
+/**
+ * Safe hook to use fingerprint context - returns null if no provider
+ * 安全版本的fingerprint context hook - 如果没有Provider则返回null
+ */
+function useFingerprintContextSafe() {
+    const context = React.useContext(FingerprintContext);
+    return context || null;
+}
+/**
+ * HOC for components that need fingerprint functionality
+ * Note: This HOC now requires config to be passed externally
+ */
+function withFingerprint(Component, config) {
+    return function FingerprintWrappedComponent(props) {
+        return (jsxRuntime.jsx(FingerprintProvider, { config: config, children: jsxRuntime.jsx(Component, Object.assign({}, props)) }));
+    };
+}
+/**
+ * 组件：显示用户状态和积分信息（用于调试）
+ */
+function FingerprintDebugInfo() {
+    const { fingerprintId, anonymousUser, credits, isLoading, isInitialized, error } = useFingerprintContext();
+    if (!process.env.NODE_ENV || process.env.NODE_ENV === 'production') {
+        return null;
+    }
+    return (jsxRuntime.jsxs("div", { style: {
+            position: 'fixed',
+            bottom: '10px',
+            right: '10px',
+            background: '#f0f0f0',
+            padding: '10px',
+            borderRadius: '5px',
+            fontSize: '12px',
+            fontFamily: 'monospace',
+            maxWidth: '300px',
+            zIndex: 9999,
+            border: '1px solid #ccc'
+        }, children: [jsxRuntime.jsx("h4", { style: { margin: '0 0 5px 0' }, children: "Fingerprint Debug" }), jsxRuntime.jsxs("div", { children: [jsxRuntime.jsx("strong", { children: "FP ID:" }), " ", fingerprintId || 'None'] }), jsxRuntime.jsxs("div", { children: [jsxRuntime.jsx("strong", { children: "Loading:" }), " ", isLoading ? 'Yes' : 'No'] }), jsxRuntime.jsxs("div", { children: [jsxRuntime.jsx("strong", { children: "Initialized:" }), " ", isInitialized ? 'Yes' : 'No'] }), error && jsxRuntime.jsxs("div", { style: { color: 'red' }, children: [jsxRuntime.jsx("strong", { children: "Error:" }), " ", error] }), anonymousUser && (jsxRuntime.jsxs("div", { children: [jsxRuntime.jsx("strong", { children: "User ID:" }), " ", anonymousUser.userId.slice(0, 8), "..."] })), credits && (jsxRuntime.jsxs("div", { children: [jsxRuntime.jsx("strong", { children: "Credits:" }), " ", credits.balanceFree, "F + ", credits.balancePaid, "P = ", credits.totalBalance] }))] }));
+}
+
+exports.FingerprintDebugInfo = FingerprintDebugInfo;
+exports.FingerprintProvider = FingerprintProvider;
+exports.useFingerprintContext = useFingerprintContext;
+exports.useFingerprintContextSafe = useFingerprintContextSafe;
+exports.withFingerprint = withFingerprint;

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

@@ -0,0 +1,65 @@
+"use client";
+import { jsx, jsxs } from 'react/jsx-runtime';
+import { createContext, useContext } from 'react';
+import { useFingerprint } from './use-fingerprint.mjs';
+
+const FingerprintContext = createContext(undefined);
+/**
+ * Fingerprint Provider Component
+ * 为应用提供fingerprint和匿名用户管理功能
+ */
+function FingerprintProvider({ children, config }) {
+    const fingerprintData = useFingerprint(config);
+    return (jsx(FingerprintContext.Provider, { value: fingerprintData, children: children }));
+}
+/**
+ * Hook to use fingerprint context
+ */
+function useFingerprintContext() {
+    const context = useContext(FingerprintContext);
+    if (context === undefined) {
+        throw new Error('useFingerprintContext must be used within a FingerprintProvider');
+    }
+    return context;
+}
+/**
+ * Safe hook to use fingerprint context - returns null if no provider
+ * 安全版本的fingerprint context hook - 如果没有Provider则返回null
+ */
+function useFingerprintContextSafe() {
+    const context = useContext(FingerprintContext);
+    return context || null;
+}
+/**
+ * HOC for components that need fingerprint functionality
+ * Note: This HOC now requires config to be passed externally
+ */
+function withFingerprint(Component, config) {
+    return function FingerprintWrappedComponent(props) {
+        return (jsx(FingerprintProvider, { config: config, children: jsx(Component, Object.assign({}, props)) }));
+    };
+}
+/**
+ * 组件：显示用户状态和积分信息（用于调试）
+ */
+function FingerprintDebugInfo() {
+    const { fingerprintId, anonymousUser, credits, isLoading, isInitialized, error } = useFingerprintContext();
+    if (!process.env.NODE_ENV || process.env.NODE_ENV === 'production') {
+        return null;
+    }
+    return (jsxs("div", { style: {
+            position: 'fixed',
+            bottom: '10px',
+            right: '10px',
+            background: '#f0f0f0',
+            padding: '10px',
+            borderRadius: '5px',
+            fontSize: '12px',
+            fontFamily: 'monospace',
+            maxWidth: '300px',
+            zIndex: 9999,
+            border: '1px solid #ccc'
+        }, children: [jsx("h4", { style: { margin: '0 0 5px 0' }, children: "Fingerprint Debug" }), jsxs("div", { children: [jsx("strong", { children: "FP ID:" }), " ", fingerprintId || 'None'] }), jsxs("div", { children: [jsx("strong", { children: "Loading:" }), " ", isLoading ? 'Yes' : 'No'] }), jsxs("div", { children: [jsx("strong", { children: "Initialized:" }), " ", isInitialized ? 'Yes' : 'No'] }), error && jsxs("div", { style: { color: 'red' }, children: [jsx("strong", { children: "Error:" }), " ", error] }), anonymousUser && (jsxs("div", { children: [jsx("strong", { children: "User ID:" }), " ", anonymousUser.userId.slice(0, 8), "..."] })), credits && (jsxs("div", { children: [jsx("strong", { children: "Credits:" }), " ", credits.balanceFree, "F + ", credits.balancePaid, "P = ", credits.totalBalance] }))] }));
+}
+
+export { FingerprintDebugInfo, FingerprintProvider, useFingerprintContext, useFingerprintContextSafe, withFingerprint };

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

@@ -0,0 +1,22 @@
+/**
+ * Fingerprint Server Utilities
+ * 服务端专用的指纹ID提取和验证逻辑
+ * 可以安全地在服务端使用，不依赖浏览器API或FingerprintJS
+ */
+/**
+ * 从请求中提取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;
+/**
+ * 生成服务端降级fingerprint ID
+ * 当客户端无法生成fingerprint时使用
+ * 可以安全地在服务端使用
+ */
+export declare function generateServerFingerprintId(): string;
+/**
+ * 从Next.js Request对象中提取fingerprint ID
+ * 便捷方法，适用于Next.js API路由
+ */
+export declare function extractFingerprintFromNextRequest(request: Request): string | null;

package/dist/clerk/fingerprint/fingerprint-server.js

@@ -0,0 +1,75 @@
+'use strict';
+
+var fingerprintShared = require('./fingerprint-shared.js');
+
+/**
+ * Fingerprint Server Utilities
+ * 服务端专用的指纹ID提取和验证逻辑
+ * 可以安全地在服务端使用，不依赖浏览器API或FingerprintJS
+ */
+/**
+ * 从请求中提取fingerprint ID
+ * 优先级：header > cookie > query参数
+ * 可以安全地在服务端使用
+ */
+function extractFingerprintId(headers, cookies, query) {
+    // 1. 从header中获取
+    const headerValue = headers instanceof Headers
+        ? headers.get(fingerprintShared.FINGERPRINT_HEADER_NAME)
+        : headers[fingerprintShared.FINGERPRINT_HEADER_NAME];
+    if (headerValue && fingerprintShared.isValidFingerprintId(headerValue)) {
+        return headerValue;
+    }
+    // 2. 从cookie中获取
+    if (cookies) {
+        const cookieValue = cookies[fingerprintShared.FINGERPRINT_COOKIE_NAME];
+        if (cookieValue && fingerprintShared.isValidFingerprintId(cookieValue)) {
+            return cookieValue;
+        }
+    }
+    // 3. 从query参数中获取
+    if (query) {
+        const queryValue = query.fingerprint_id || query.fp_id;
+        if (queryValue && fingerprintShared.isValidFingerprintId(queryValue)) {
+            return queryValue;
+        }
+    }
+    return null;
+}
+/**
+ * 生成服务端降级fingerprint ID
+ * 当客户端无法生成fingerprint时使用
+ * 可以安全地在服务端使用
+ */
+function generateServerFingerprintId() {
+    return `fp_server_${Date.now()}_${Math.random().toString(36).slice(2, 11)}`;
+}
+/**
+ * 从Next.js Request对象中提取fingerprint ID
+ * 便捷方法，适用于Next.js API路由
+ */
+function extractFingerprintFromNextRequest(request) {
+    const headers = request.headers;
+    // 尝试从cookies获取（需要解析cookie header）
+    const cookieHeader = headers.get('cookie');
+    const cookies = {};
+    if (cookieHeader) {
+        cookieHeader.split(';').forEach(cookie => {
+            const [name, value] = cookie.trim().split('=');
+            if (name && value) {
+                cookies[name] = value;
+            }
+        });
+    }
+    // 尝试从URL query参数获取
+    const url = new URL(request.url);
+    const query = {};
+    url.searchParams.forEach((value, key) => {
+        query[key] = value;
+    });
+    return extractFingerprintId(headers, cookies, query);
+}
+
+exports.extractFingerprintFromNextRequest = extractFingerprintFromNextRequest;
+exports.extractFingerprintId = extractFingerprintId;
+exports.generateServerFingerprintId = generateServerFingerprintId;

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

@@ -0,0 +1,71 @@
+import { FINGERPRINT_HEADER_NAME, isValidFingerprintId, FINGERPRINT_COOKIE_NAME } from './fingerprint-shared.mjs';
+
+/**
+ * Fingerprint Server Utilities
+ * 服务端专用的指纹ID提取和验证逻辑
+ * 可以安全地在服务端使用，不依赖浏览器API或FingerprintJS
+ */
+/**
+ * 从请求中提取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;
+}
+/**
+ * 生成服务端降级fingerprint ID
+ * 当客户端无法生成fingerprint时使用
+ * 可以安全地在服务端使用
+ */
+function generateServerFingerprintId() {
+    return `fp_server_${Date.now()}_${Math.random().toString(36).slice(2, 11)}`;
+}
+/**
+ * 从Next.js Request对象中提取fingerprint ID
+ * 便捷方法，适用于Next.js API路由
+ */
+function extractFingerprintFromNextRequest(request) {
+    const headers = request.headers;
+    // 尝试从cookies获取（需要解析cookie header）
+    const cookieHeader = headers.get('cookie');
+    const cookies = {};
+    if (cookieHeader) {
+        cookieHeader.split(';').forEach(cookie => {
+            const [name, value] = cookie.trim().split('=');
+            if (name && value) {
+                cookies[name] = value;
+            }
+        });
+    }
+    // 尝试从URL query参数获取
+    const url = new URL(request.url);
+    const query = {};
+    url.searchParams.forEach((value, key) => {
+        query[key] = value;
+    });
+    return extractFingerprintId(headers, cookies, query);
+}
+
+export { extractFingerprintFromNextRequest, extractFingerprintId, generateServerFingerprintId };

package/dist/clerk/fingerprint/fingerprint-shared.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Fingerprint Shared Utilities
+ * 客户端和服务端共享的常量、类型和验证逻辑
+ */
+export declare const FINGERPRINT_STORAGE_KEY = "diaomao_fingerprint_id";
+export declare const FINGERPRINT_HEADER_NAME = "x-fingerprint-id";
+export declare const FINGERPRINT_COOKIE_NAME = "fingerprint_id";
+/**
+ * 验证fingerprint ID格式
+ * 可以在客户端和服务端使用
+ */
+export declare function isValidFingerprintId(fingerprintId: string): boolean;
+export declare const FINGERPRINT_CONSTANTS: {
+    readonly STORAGE_KEY: "diaomao_fingerprint_id";
+    readonly HEADER_NAME: "x-fingerprint-id";
+    readonly COOKIE_NAME: "fingerprint_id";
+};

package/dist/clerk/fingerprint/fingerprint-shared.js

@@ -0,0 +1,35 @@
+'use strict';
+
+/**
+ * Fingerprint Shared Utilities
+ * 客户端和服务端共享的常量、类型和验证逻辑
+ */
+// Fingerprint ID的存储键和header名
+const FINGERPRINT_STORAGE_KEY = 'diaomao_fingerprint_id';
+const FINGERPRINT_HEADER_NAME = 'x-fingerprint-id';
+const FINGERPRINT_COOKIE_NAME = 'fingerprint_id';
+/**
+ * 验证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);
+}
+// 常量导出
+const FINGERPRINT_CONSTANTS = {
+    STORAGE_KEY: FINGERPRINT_STORAGE_KEY,
+    HEADER_NAME: FINGERPRINT_HEADER_NAME,
+    COOKIE_NAME: FINGERPRINT_COOKIE_NAME,
+};
+
+exports.FINGERPRINT_CONSTANTS = FINGERPRINT_CONSTANTS;
+exports.FINGERPRINT_COOKIE_NAME = FINGERPRINT_COOKIE_NAME;
+exports.FINGERPRINT_HEADER_NAME = FINGERPRINT_HEADER_NAME;
+exports.FINGERPRINT_STORAGE_KEY = FINGERPRINT_STORAGE_KEY;
+exports.isValidFingerprintId = isValidFingerprintId;

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

@@ -0,0 +1,29 @@
+/**
+ * Fingerprint Shared Utilities
+ * 客户端和服务端共享的常量、类型和验证逻辑
+ */
+// Fingerprint ID的存储键和header名
+const FINGERPRINT_STORAGE_KEY = 'diaomao_fingerprint_id';
+const FINGERPRINT_HEADER_NAME = 'x-fingerprint-id';
+const FINGERPRINT_COOKIE_NAME = 'fingerprint_id';
+/**
+ * 验证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);
+}
+// 常量导出
+const FINGERPRINT_CONSTANTS = {
+    STORAGE_KEY: FINGERPRINT_STORAGE_KEY,
+    HEADER_NAME: FINGERPRINT_HEADER_NAME,
+    COOKIE_NAME: FINGERPRINT_COOKIE_NAME,
+};
+
+export { FINGERPRINT_CONSTANTS, FINGERPRINT_COOKIE_NAME, FINGERPRINT_HEADER_NAME, FINGERPRINT_STORAGE_KEY, isValidFingerprintId };

package/dist/clerk/fingerprint/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";
+};

package/dist/clerk/fingerprint/fingerprint.js

@@ -0,0 +1,17 @@
+'use strict';
+
+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
+ */
+// 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) => {
+        module.default;
+    });
+}