@windrun-huaiin/third-ui 14.4.2 → 14.5.0

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

@@ -1,2 +1,5 @@
 export declare function getDebugFingerprintOverride(): string | null;
 export declare function setDebugFingerprintOverride(fingerprintId: string): void;
+export declare function buildDebugFingerprintId(): string;
+export declare function getOrCreateDebugFingerprintOverride(): string;
+export declare function regenerateDebugFingerprintOverride(): string;

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

@@ -27,17 +27,39 @@ function setLocalStorageValue(key, value) {
 }
 function getDebugFingerprintOverride() {
     const value = getLocalStorageValue(fingerprintShared.FINGERPRINT_DEBUG_OVERRIDE_STORAGE_KEY);
-    if (!value || !fingerprintShared.isValidFingerprintId(value)) {
+    if (!value || !fingerprintShared.isValidFingerprintId(value) || !fingerprintShared.isDebugFingerprintId(value)) {
         return null;
     }
     return value;
 }
 function setDebugFingerprintOverride(fingerprintId) {
-    if (!fingerprintShared.isValidFingerprintId(fingerprintId)) {
+    if (!fingerprintShared.isValidFingerprintId(fingerprintId) || !fingerprintShared.isDebugFingerprintId(fingerprintId)) {
         throw new Error('Invalid fingerprint ID');
     }
     setLocalStorageValue(fingerprintShared.FINGERPRINT_DEBUG_OVERRIDE_STORAGE_KEY, fingerprintId);
 }
+function buildDebugFingerprintId() {
+    const timestamp = new Date().toISOString().replace(/[-:TZ.]/g, '').slice(0, 14);
+    const randomSuffix = Math.random().toString(36).slice(2, 8);
+    return `${fingerprintShared.FINGERPRINT_DEBUG_PREFIX}${timestamp}_${randomSuffix}`;
+}
+function getOrCreateDebugFingerprintOverride() {
+    const existing = getDebugFingerprintOverride();
+    if (existing) {
+        return existing;
+    }
+    const nextFingerprintId = buildDebugFingerprintId();
+    setDebugFingerprintOverride(nextFingerprintId);
+    return nextFingerprintId;
+}
+function regenerateDebugFingerprintOverride() {
+    const nextFingerprintId = buildDebugFingerprintId();
+    setDebugFingerprintOverride(nextFingerprintId);
+    return nextFingerprintId;
+}
 
+exports.buildDebugFingerprintId = buildDebugFingerprintId;
 exports.getDebugFingerprintOverride = getDebugFingerprintOverride;
+exports.getOrCreateDebugFingerprintOverride = getOrCreateDebugFingerprintOverride;
+exports.regenerateDebugFingerprintOverride = regenerateDebugFingerprintOverride;
 exports.setDebugFingerprintOverride = setDebugFingerprintOverride;

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

@@ -1,5 +1,5 @@
 "use client";
-import { isValidFingerprintId, FINGERPRINT_DEBUG_OVERRIDE_STORAGE_KEY } from './fingerprint-shared.mjs';
+import { isValidFingerprintId, isDebugFingerprintId, FINGERPRINT_DEBUG_PREFIX, FINGERPRINT_DEBUG_OVERRIDE_STORAGE_KEY } from './fingerprint-shared.mjs';
 
 function getLocalStorageValue(key) {
     if (typeof window === 'undefined') {
@@ -25,16 +25,35 @@ function setLocalStorageValue(key, value) {
 }
 function getDebugFingerprintOverride() {
     const value = getLocalStorageValue(FINGERPRINT_DEBUG_OVERRIDE_STORAGE_KEY);
-    if (!value || !isValidFingerprintId(value)) {
+    if (!value || !isValidFingerprintId(value) || !isDebugFingerprintId(value)) {
         return null;
     }
     return value;
 }
 function setDebugFingerprintOverride(fingerprintId) {
-    if (!isValidFingerprintId(fingerprintId)) {
+    if (!isValidFingerprintId(fingerprintId) || !isDebugFingerprintId(fingerprintId)) {
         throw new Error('Invalid fingerprint ID');
     }
     setLocalStorageValue(FINGERPRINT_DEBUG_OVERRIDE_STORAGE_KEY, fingerprintId);
 }
+function buildDebugFingerprintId() {
+    const timestamp = new Date().toISOString().replace(/[-:TZ.]/g, '').slice(0, 14);
+    const randomSuffix = Math.random().toString(36).slice(2, 8);
+    return `${FINGERPRINT_DEBUG_PREFIX}${timestamp}_${randomSuffix}`;
+}
+function getOrCreateDebugFingerprintOverride() {
+    const existing = getDebugFingerprintOverride();
+    if (existing) {
+        return existing;
+    }
+    const nextFingerprintId = buildDebugFingerprintId();
+    setDebugFingerprintOverride(nextFingerprintId);
+    return nextFingerprintId;
+}
+function regenerateDebugFingerprintOverride() {
+    const nextFingerprintId = buildDebugFingerprintId();
+    setDebugFingerprintOverride(nextFingerprintId);
+    return nextFingerprintId;
+}
 
-export { getDebugFingerprintOverride, setDebugFingerprintOverride };
+export { buildDebugFingerprintId, getDebugFingerprintOverride, getOrCreateDebugFingerprintOverride, regenerateDebugFingerprintOverride, setDebugFingerprintOverride };

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

@@ -81,15 +81,11 @@ function FingerprintStatus() {
         }
     }, [xUser]);
     React.useEffect(() => {
-        const debugFingerprintOverride = fingerprintDebug.getDebugFingerprintOverride();
-        if (debugFingerprintOverride) {
-            setActiveDebugFingerprintId(debugFingerprintOverride);
+        if (panelMode !== 'test') {
             return;
         }
-        const nextFingerprintId = buildDebugFingerprintId();
-        fingerprintDebug.setDebugFingerprintOverride(nextFingerprintId);
-        setActiveDebugFingerprintId(nextFingerprintId);
-    }, []);
+        setActiveDebugFingerprintId((current) => current !== null && current !== void 0 ? current : fingerprintDebug.getOrCreateDebugFingerprintOverride());
+    }, [panelMode]);
     const creditBuckets = React.useMemo(() => {
         if (!xCredit)
             return [];
@@ -147,11 +143,12 @@ function FingerprintStatus() {
     const subStatus = subscriptionStatus.status;
     const themedGhostButtonClass = utils.cn('border-slate-200 bg-white/90 hover:bg-slate-50 dark:border-white/10 dark:bg-slate-950/80 dark:hover:bg-slate-900', 'hover:border-current', lib.themeIconColor);
     const runContextParallelInitTest = () => tslib_es6.__awaiter(this, void 0, void 0, function* () {
-        const debugFingerprintId = activeDebugFingerprintId;
+        const debugFingerprintId = activeDebugFingerprintId !== null && activeDebugFingerprintId !== void 0 ? activeDebugFingerprintId : fingerprintDebug.getOrCreateDebugFingerprintOverride();
         if (!debugFingerprintId) {
             setTestResult('Test fingerprint override is not ready yet.');
             return;
         }
+        setActiveDebugFingerprintId(debugFingerprintId);
         setIsRunningTest(true);
         setTestResult(`Running Frontend Prevention Test with fingerprint: ${debugFingerprintId}`);
         try {
@@ -192,11 +189,12 @@ function FingerprintStatus() {
         }
     });
     const runRawParallelPostTest = () => tslib_es6.__awaiter(this, void 0, void 0, function* () {
-        const normalizedFingerprintId = activeDebugFingerprintId;
+        const normalizedFingerprintId = activeDebugFingerprintId !== null && activeDebugFingerprintId !== void 0 ? activeDebugFingerprintId : fingerprintDebug.getOrCreateDebugFingerprintOverride();
         if (!normalizedFingerprintId) {
             setTestResult('Test fingerprint override is not ready yet.');
             return;
         }
+        setActiveDebugFingerprintId(normalizedFingerprintId);
         setIsRunningTest(true);
         setTestResult(`Running Backend Idempotency Test with fingerprint: ${normalizedFingerprintId}`);
         try {
@@ -245,8 +243,7 @@ function FingerprintStatus() {
         }
     });
     const regenerateTestFingerprint = () => {
-        const nextFingerprintId = buildDebugFingerprintId();
-        fingerprintDebug.setDebugFingerprintOverride(nextFingerprintId);
+        const nextFingerprintId = fingerprintDebug.regenerateDebugFingerprintOverride();
         setActiveDebugFingerprintId(nextFingerprintId);
         setTestResult(`Generated test fingerprint override: ${nextFingerprintId}`);
     };
@@ -338,11 +335,6 @@ function StatusTag({ value }) {
     const badgeClass = colorMap[normalized] || defaultColor;
     return (jsxRuntime.jsx("span", { className: utils.cn('inline-block rounded-full px-2 py-0.5 text-xs capitalize font-medium', badgeClass), children: value }));
 }
-function buildDebugFingerprintId() {
-    const timestamp = new Date().toISOString().replace(/[-:TZ.]/g, '').slice(0, 14);
-    const randomSuffix = Math.random().toString(36).slice(2, 8);
-    return `fp_test_dbg_${timestamp}_${randomSuffix}`;
-}
 function formatErrorMessage(error) {
     if (error instanceof Error) {
         return error.message;

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

@@ -8,7 +8,7 @@ import { createContext, useContext, useState, useRef, useEffect, useMemo } from
 import { useFingerprint } from './use-fingerprint.mjs';
 import { CopyableText } from '@windrun-huaiin/base-ui/ui';
 import { createFingerprintHeaders } from './fingerprint-client.mjs';
-import { getDebugFingerprintOverride, setDebugFingerprintOverride } from './fingerprint-debug.mjs';
+import { getOrCreateDebugFingerprintOverride, regenerateDebugFingerprintOverride } from './fingerprint-debug.mjs';
 import { FINGERPRINT_SOURCE_REFER } from './fingerprint-shared.mjs';
 
 const FingerprintContext = createContext(undefined);
@@ -79,15 +79,11 @@ function FingerprintStatus() {
         }
     }, [xUser]);
     useEffect(() => {
-        const debugFingerprintOverride = getDebugFingerprintOverride();
-        if (debugFingerprintOverride) {
-            setActiveDebugFingerprintId(debugFingerprintOverride);
+        if (panelMode !== 'test') {
             return;
         }
-        const nextFingerprintId = buildDebugFingerprintId();
-        setDebugFingerprintOverride(nextFingerprintId);
-        setActiveDebugFingerprintId(nextFingerprintId);
-    }, []);
+        setActiveDebugFingerprintId((current) => current !== null && current !== void 0 ? current : getOrCreateDebugFingerprintOverride());
+    }, [panelMode]);
     const creditBuckets = useMemo(() => {
         if (!xCredit)
             return [];
@@ -145,11 +141,12 @@ function FingerprintStatus() {
     const subStatus = subscriptionStatus.status;
     const themedGhostButtonClass = cn('border-slate-200 bg-white/90 hover:bg-slate-50 dark:border-white/10 dark:bg-slate-950/80 dark:hover:bg-slate-900', 'hover:border-current', themeIconColor);
     const runContextParallelInitTest = () => __awaiter(this, void 0, void 0, function* () {
-        const debugFingerprintId = activeDebugFingerprintId;
+        const debugFingerprintId = activeDebugFingerprintId !== null && activeDebugFingerprintId !== void 0 ? activeDebugFingerprintId : getOrCreateDebugFingerprintOverride();
         if (!debugFingerprintId) {
             setTestResult('Test fingerprint override is not ready yet.');
             return;
         }
+        setActiveDebugFingerprintId(debugFingerprintId);
         setIsRunningTest(true);
         setTestResult(`Running Frontend Prevention Test with fingerprint: ${debugFingerprintId}`);
         try {
@@ -190,11 +187,12 @@ function FingerprintStatus() {
         }
     });
     const runRawParallelPostTest = () => __awaiter(this, void 0, void 0, function* () {
-        const normalizedFingerprintId = activeDebugFingerprintId;
+        const normalizedFingerprintId = activeDebugFingerprintId !== null && activeDebugFingerprintId !== void 0 ? activeDebugFingerprintId : getOrCreateDebugFingerprintOverride();
         if (!normalizedFingerprintId) {
             setTestResult('Test fingerprint override is not ready yet.');
             return;
         }
+        setActiveDebugFingerprintId(normalizedFingerprintId);
         setIsRunningTest(true);
         setTestResult(`Running Backend Idempotency Test with fingerprint: ${normalizedFingerprintId}`);
         try {
@@ -243,8 +241,7 @@ function FingerprintStatus() {
         }
     });
     const regenerateTestFingerprint = () => {
-        const nextFingerprintId = buildDebugFingerprintId();
-        setDebugFingerprintOverride(nextFingerprintId);
+        const nextFingerprintId = regenerateDebugFingerprintOverride();
         setActiveDebugFingerprintId(nextFingerprintId);
         setTestResult(`Generated test fingerprint override: ${nextFingerprintId}`);
     };
@@ -336,11 +333,6 @@ function StatusTag({ value }) {
     const badgeClass = colorMap[normalized] || defaultColor;
     return (jsx("span", { className: cn('inline-block rounded-full px-2 py-0.5 text-xs capitalize font-medium', badgeClass), children: value }));
 }
-function buildDebugFingerprintId() {
-    const timestamp = new Date().toISOString().replace(/[-:TZ.]/g, '').slice(0, 14);
-    const randomSuffix = Math.random().toString(36).slice(2, 8);
-    return `fp_test_dbg_${timestamp}_${randomSuffix}`;
-}
 function formatErrorMessage(error) {
     if (error instanceof Error) {
         return error.message;

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

@@ -10,11 +10,13 @@ export declare const FINGERPRINT_SOURCE_REFER = "x-source-ref";
 export declare const FINGERPRINT_FIRST_TOUCH_STORAGE_KEY = "__x_first_touch";
 export declare const FINGERPRINT_FIRST_TOUCH_COOKIE_NAME = "__x_first_touch";
 export declare const FINGERPRINT_FIRST_TOUCH_HEADER = "x-first-touch";
+export declare const FINGERPRINT_DEBUG_PREFIX = "fp_test_dbg_";
 /**
  * 验证fingerprint ID格式
  * 可以在客户端和服务端使用
  */
 export declare function isValidFingerprintId(fingerprintId: string): boolean;
+export declare function isDebugFingerprintId(fingerprintId: string | null | undefined): boolean;
 export declare const FINGERPRINT_CONSTANTS: {
     readonly STORAGE_KEY: "__x_fingerprint_id";
     readonly DEBUG_OVERRIDE_STORAGE_KEY: "__x_fingerprint_debug_override";
@@ -23,4 +25,5 @@ export declare const FINGERPRINT_CONSTANTS: {
     readonly FIRST_TOUCH_STORAGE_KEY: "__x_first_touch";
     readonly FIRST_TOUCH_COOKIE_NAME: "__x_first_touch";
     readonly FIRST_TOUCH_HEADER: "x-first-touch";
+    readonly DEBUG_PREFIX: "fp_test_dbg_";
 };

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

@@ -13,6 +13,7 @@ const FINGERPRINT_SOURCE_REFER = 'x-source-ref';
 const FINGERPRINT_FIRST_TOUCH_STORAGE_KEY = '__x_first_touch';
 const FINGERPRINT_FIRST_TOUCH_COOKIE_NAME = '__x_first_touch';
 const FINGERPRINT_FIRST_TOUCH_HEADER = 'x-first-touch';
+const FINGERPRINT_DEBUG_PREFIX = 'fp_test_dbg_';
 /**
  * 验证fingerprint ID格式
  * 可以在客户端和服务端使用
@@ -24,7 +25,14 @@ function isValidFingerprintId(fingerprintId) {
     // - fp_ + FingerprintJS visitorId (变长字符串)
     // - fp_fallback_ + 时间戳_随机字符串 (客户端降级方案)
     // - fp_server_ + 时间戳_随机字符串 (服务端降级)
-    return /^fp(_fallback|_server)?_[a-zA-Z0-9_]+$/.test(fingerprintId);
+    // - fp_test_dbg_ + 时间戳_随机字符串 (调试并发测试)
+    return /^fp(_fallback|_server|_test_dbg)?_[a-zA-Z0-9_]+$/.test(fingerprintId);
+}
+function isDebugFingerprintId(fingerprintId) {
+    if (!fingerprintId) {
+        return false;
+    }
+    return fingerprintId.startsWith(FINGERPRINT_DEBUG_PREFIX);
 }
 // 常量导出
 const FINGERPRINT_CONSTANTS = {
@@ -35,15 +43,18 @@ const FINGERPRINT_CONSTANTS = {
     FIRST_TOUCH_STORAGE_KEY: FINGERPRINT_FIRST_TOUCH_STORAGE_KEY,
     FIRST_TOUCH_COOKIE_NAME: FINGERPRINT_FIRST_TOUCH_COOKIE_NAME,
     FIRST_TOUCH_HEADER: FINGERPRINT_FIRST_TOUCH_HEADER,
+    DEBUG_PREFIX: FINGERPRINT_DEBUG_PREFIX,
 };
 
 exports.FINGERPRINT_CONSTANTS = FINGERPRINT_CONSTANTS;
 exports.FINGERPRINT_COOKIE_NAME = FINGERPRINT_COOKIE_NAME;
 exports.FINGERPRINT_DEBUG_OVERRIDE_STORAGE_KEY = FINGERPRINT_DEBUG_OVERRIDE_STORAGE_KEY;
+exports.FINGERPRINT_DEBUG_PREFIX = FINGERPRINT_DEBUG_PREFIX;
 exports.FINGERPRINT_FIRST_TOUCH_COOKIE_NAME = FINGERPRINT_FIRST_TOUCH_COOKIE_NAME;
 exports.FINGERPRINT_FIRST_TOUCH_HEADER = FINGERPRINT_FIRST_TOUCH_HEADER;
 exports.FINGERPRINT_FIRST_TOUCH_STORAGE_KEY = FINGERPRINT_FIRST_TOUCH_STORAGE_KEY;
 exports.FINGERPRINT_HEADER_NAME = FINGERPRINT_HEADER_NAME;
 exports.FINGERPRINT_SOURCE_REFER = FINGERPRINT_SOURCE_REFER;
 exports.FINGERPRINT_STORAGE_KEY = FINGERPRINT_STORAGE_KEY;
+exports.isDebugFingerprintId = isDebugFingerprintId;
 exports.isValidFingerprintId = isValidFingerprintId;

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

@@ -11,6 +11,7 @@ const FINGERPRINT_SOURCE_REFER = 'x-source-ref';
 const FINGERPRINT_FIRST_TOUCH_STORAGE_KEY = '__x_first_touch';
 const FINGERPRINT_FIRST_TOUCH_COOKIE_NAME = '__x_first_touch';
 const FINGERPRINT_FIRST_TOUCH_HEADER = 'x-first-touch';
+const FINGERPRINT_DEBUG_PREFIX = 'fp_test_dbg_';
 /**
  * 验证fingerprint ID格式
  * 可以在客户端和服务端使用
@@ -22,7 +23,14 @@ function isValidFingerprintId(fingerprintId) {
     // - fp_ + FingerprintJS visitorId (变长字符串)
     // - fp_fallback_ + 时间戳_随机字符串 (客户端降级方案)
     // - fp_server_ + 时间戳_随机字符串 (服务端降级)
-    return /^fp(_fallback|_server)?_[a-zA-Z0-9_]+$/.test(fingerprintId);
+    // - fp_test_dbg_ + 时间戳_随机字符串 (调试并发测试)
+    return /^fp(_fallback|_server|_test_dbg)?_[a-zA-Z0-9_]+$/.test(fingerprintId);
+}
+function isDebugFingerprintId(fingerprintId) {
+    if (!fingerprintId) {
+        return false;
+    }
+    return fingerprintId.startsWith(FINGERPRINT_DEBUG_PREFIX);
 }
 // 常量导出
 const FINGERPRINT_CONSTANTS = {
@@ -33,6 +41,7 @@ const FINGERPRINT_CONSTANTS = {
     FIRST_TOUCH_STORAGE_KEY: FINGERPRINT_FIRST_TOUCH_STORAGE_KEY,
     FIRST_TOUCH_COOKIE_NAME: FINGERPRINT_FIRST_TOUCH_COOKIE_NAME,
     FIRST_TOUCH_HEADER: FINGERPRINT_FIRST_TOUCH_HEADER,
+    DEBUG_PREFIX: FINGERPRINT_DEBUG_PREFIX,
 };
 
-export { FINGERPRINT_CONSTANTS, FINGERPRINT_COOKIE_NAME, FINGERPRINT_DEBUG_OVERRIDE_STORAGE_KEY, FINGERPRINT_FIRST_TOUCH_COOKIE_NAME, FINGERPRINT_FIRST_TOUCH_HEADER, FINGERPRINT_FIRST_TOUCH_STORAGE_KEY, FINGERPRINT_HEADER_NAME, FINGERPRINT_SOURCE_REFER, FINGERPRINT_STORAGE_KEY, isValidFingerprintId };
+export { FINGERPRINT_CONSTANTS, FINGERPRINT_COOKIE_NAME, FINGERPRINT_DEBUG_OVERRIDE_STORAGE_KEY, FINGERPRINT_DEBUG_PREFIX, FINGERPRINT_FIRST_TOUCH_COOKIE_NAME, FINGERPRINT_FIRST_TOUCH_HEADER, FINGERPRINT_FIRST_TOUCH_STORAGE_KEY, FINGERPRINT_HEADER_NAME, FINGERPRINT_SOURCE_REFER, FINGERPRINT_STORAGE_KEY, isDebugFingerprintId, isValidFingerprintId };

package/dist/clerk/fingerprint/index.js

@@ -11,12 +11,14 @@ var fingerprintProvider = require('./fingerprint-provider.js');
 exports.FINGERPRINT_CONSTANTS = fingerprintShared.FINGERPRINT_CONSTANTS;
 exports.FINGERPRINT_COOKIE_NAME = fingerprintShared.FINGERPRINT_COOKIE_NAME;
 exports.FINGERPRINT_DEBUG_OVERRIDE_STORAGE_KEY = fingerprintShared.FINGERPRINT_DEBUG_OVERRIDE_STORAGE_KEY;
+exports.FINGERPRINT_DEBUG_PREFIX = fingerprintShared.FINGERPRINT_DEBUG_PREFIX;
 exports.FINGERPRINT_FIRST_TOUCH_COOKIE_NAME = fingerprintShared.FINGERPRINT_FIRST_TOUCH_COOKIE_NAME;
 exports.FINGERPRINT_FIRST_TOUCH_HEADER = fingerprintShared.FINGERPRINT_FIRST_TOUCH_HEADER;
 exports.FINGERPRINT_FIRST_TOUCH_STORAGE_KEY = fingerprintShared.FINGERPRINT_FIRST_TOUCH_STORAGE_KEY;
 exports.FINGERPRINT_HEADER_NAME = fingerprintShared.FINGERPRINT_HEADER_NAME;
 exports.FINGERPRINT_SOURCE_REFER = fingerprintShared.FINGERPRINT_SOURCE_REFER;
 exports.FINGERPRINT_STORAGE_KEY = fingerprintShared.FINGERPRINT_STORAGE_KEY;
+exports.isDebugFingerprintId = fingerprintShared.isDebugFingerprintId;
 exports.isValidFingerprintId = fingerprintShared.isValidFingerprintId;
 exports.clearFingerprintId = fingerprintClient.clearFingerprintId;
 exports.createFingerprintFetch = fingerprintClient.createFingerprintFetch;

package/dist/clerk/fingerprint/index.mjs

@@ -1,5 +1,5 @@
 "use client";
-export { FINGERPRINT_CONSTANTS, FINGERPRINT_COOKIE_NAME, FINGERPRINT_DEBUG_OVERRIDE_STORAGE_KEY, FINGERPRINT_FIRST_TOUCH_COOKIE_NAME, FINGERPRINT_FIRST_TOUCH_HEADER, FINGERPRINT_FIRST_TOUCH_STORAGE_KEY, FINGERPRINT_HEADER_NAME, FINGERPRINT_SOURCE_REFER, FINGERPRINT_STORAGE_KEY, isValidFingerprintId } from './fingerprint-shared.mjs';
+export { FINGERPRINT_CONSTANTS, FINGERPRINT_COOKIE_NAME, FINGERPRINT_DEBUG_OVERRIDE_STORAGE_KEY, FINGERPRINT_DEBUG_PREFIX, FINGERPRINT_FIRST_TOUCH_COOKIE_NAME, FINGERPRINT_FIRST_TOUCH_HEADER, FINGERPRINT_FIRST_TOUCH_STORAGE_KEY, FINGERPRINT_HEADER_NAME, FINGERPRINT_SOURCE_REFER, FINGERPRINT_STORAGE_KEY, isDebugFingerprintId, isValidFingerprintId } from './fingerprint-shared.mjs';
 export { clearFingerprintId, createFingerprintFetch, createFingerprintHeaders, generateFingerprintId, getFingerprintId, getOrCreateFirstTouchData, getOrGenerateFingerprintId, setFingerprintId, useFingerprintHeaders } from './fingerprint-client.mjs';
 export { useFingerprint } from './use-fingerprint.mjs';
 export { FingerprintProvider, FingerprintStatus, useFingerprintContext, useFingerprintContextSafe, withFingerprint } from './fingerprint-provider.mjs';

package/dist/clerk/fingerprint/server.js

@@ -8,12 +8,14 @@ var fingerprintServer = require('./fingerprint-server.js');
 exports.FINGERPRINT_CONSTANTS = fingerprintShared.FINGERPRINT_CONSTANTS;
 exports.FINGERPRINT_COOKIE_NAME = fingerprintShared.FINGERPRINT_COOKIE_NAME;
 exports.FINGERPRINT_DEBUG_OVERRIDE_STORAGE_KEY = fingerprintShared.FINGERPRINT_DEBUG_OVERRIDE_STORAGE_KEY;
+exports.FINGERPRINT_DEBUG_PREFIX = fingerprintShared.FINGERPRINT_DEBUG_PREFIX;
 exports.FINGERPRINT_FIRST_TOUCH_COOKIE_NAME = fingerprintShared.FINGERPRINT_FIRST_TOUCH_COOKIE_NAME;
 exports.FINGERPRINT_FIRST_TOUCH_HEADER = fingerprintShared.FINGERPRINT_FIRST_TOUCH_HEADER;
 exports.FINGERPRINT_FIRST_TOUCH_STORAGE_KEY = fingerprintShared.FINGERPRINT_FIRST_TOUCH_STORAGE_KEY;
 exports.FINGERPRINT_HEADER_NAME = fingerprintShared.FINGERPRINT_HEADER_NAME;
 exports.FINGERPRINT_SOURCE_REFER = fingerprintShared.FINGERPRINT_SOURCE_REFER;
 exports.FINGERPRINT_STORAGE_KEY = fingerprintShared.FINGERPRINT_STORAGE_KEY;
+exports.isDebugFingerprintId = fingerprintShared.isDebugFingerprintId;
 exports.isValidFingerprintId = fingerprintShared.isValidFingerprintId;
 exports.extractFingerprintFromNextRequest = fingerprintServer.extractFingerprintFromNextRequest;
 exports.extractFingerprintFromNextStores = fingerprintServer.extractFingerprintFromNextStores;

package/dist/clerk/fingerprint/server.mjs

@@ -1,2 +1,2 @@
-export { FINGERPRINT_CONSTANTS, FINGERPRINT_COOKIE_NAME, FINGERPRINT_DEBUG_OVERRIDE_STORAGE_KEY, FINGERPRINT_FIRST_TOUCH_COOKIE_NAME, FINGERPRINT_FIRST_TOUCH_HEADER, FINGERPRINT_FIRST_TOUCH_STORAGE_KEY, FINGERPRINT_HEADER_NAME, FINGERPRINT_SOURCE_REFER, FINGERPRINT_STORAGE_KEY, isValidFingerprintId } from './fingerprint-shared.mjs';
+export { FINGERPRINT_CONSTANTS, FINGERPRINT_COOKIE_NAME, FINGERPRINT_DEBUG_OVERRIDE_STORAGE_KEY, FINGERPRINT_DEBUG_PREFIX, FINGERPRINT_FIRST_TOUCH_COOKIE_NAME, FINGERPRINT_FIRST_TOUCH_HEADER, FINGERPRINT_FIRST_TOUCH_STORAGE_KEY, FINGERPRINT_HEADER_NAME, FINGERPRINT_SOURCE_REFER, FINGERPRINT_STORAGE_KEY, isDebugFingerprintId, isValidFingerprintId } from './fingerprint-shared.mjs';
 export { extractFingerprintFromNextRequest, extractFingerprintFromNextStores, extractFingerprintId, generateServerFingerprintId } from './fingerprint-server.mjs';

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

@@ -99,8 +99,13 @@ function useFingerprint(config) {
                 setXCredit(data.xCredit || null);
                 setXSubscription(data.xSubscription || null);
                 setIsInitialized(true);
-                if (((_a = data.xUser) === null || _a === void 0 ? void 0 : _a.fingerprintId) && data.xUser.fingerprintId !== fingerprintId) {
-                    setFingerprintIdState(data.xUser.fingerprintId);
+                const canonicalFingerprintId = (_a = data.xUser) === null || _a === void 0 ? void 0 : _a.fingerprintId;
+                if (canonicalFingerprintId &&
+                    fingerprintShared.isValidFingerprintId(canonicalFingerprintId) &&
+                    !fingerprintShared.isDebugFingerprintId(canonicalFingerprintId) &&
+                    canonicalFingerprintId !== fingerprintId) {
+                    setFingerprintIdState(canonicalFingerprintId);
+                    fingerprintClient.setFingerprintId(canonicalFingerprintId);
                 }
             }
             else {

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

@@ -1,8 +1,8 @@
 "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.3/node_modules/tslib/tslib.es6.mjs';
 import { useState, useRef, useCallback, useEffect } from 'react';
-import { getOrCreateFirstTouchData, getOrGenerateFingerprintId, createFingerprintHeaders } from './fingerprint-client.mjs';
-import { FINGERPRINT_SOURCE_REFER } from './fingerprint-shared.mjs';
+import { getOrCreateFirstTouchData, getOrGenerateFingerprintId, createFingerprintHeaders, setFingerprintId } from './fingerprint-client.mjs';
+import { FINGERPRINT_SOURCE_REFER, isValidFingerprintId, isDebugFingerprintId } from './fingerprint-shared.mjs';
 
 /**
  * Hook for managing fingerprint ID and anonymous user data
@@ -97,8 +97,13 @@ function useFingerprint(config) {
                 setXCredit(data.xCredit || null);
                 setXSubscription(data.xSubscription || null);
                 setIsInitialized(true);
-                if (((_a = data.xUser) === null || _a === void 0 ? void 0 : _a.fingerprintId) && data.xUser.fingerprintId !== fingerprintId) {
-                    setFingerprintIdState(data.xUser.fingerprintId);
+                const canonicalFingerprintId = (_a = data.xUser) === null || _a === void 0 ? void 0 : _a.fingerprintId;
+                if (canonicalFingerprintId &&
+                    isValidFingerprintId(canonicalFingerprintId) &&
+                    !isDebugFingerprintId(canonicalFingerprintId) &&
+                    canonicalFingerprintId !== fingerprintId) {
+                    setFingerprintIdState(canonicalFingerprintId);
+                    setFingerprintId(canonicalFingerprintId);
                 }
             }
             else {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@windrun-huaiin/third-ui",
-  "version": "14.4.2",
+  "version": "14.5.0",
   "description": "Third-party integrated UI components for windrun-huaiin projects",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
@@ -16,11 +16,6 @@
       "import": "./dist/clerk/server.mjs",
       "require": "./dist/clerk/server.js"
     },
-    "./clerk/patch/optional-auth": {
-      "types": "./dist/clerk/patch/optional-auth.d.ts",
-      "import": "./dist/clerk/patch/optional-auth.mjs",
-      "require": "./dist/clerk/patch/optional-auth.js"
-    },
     "./fingerprint": {
       "types": "./dist/clerk/fingerprint/index.d.ts",
       "import": "./dist/clerk/fingerprint/index.mjs",

package/src/clerk/fingerprint/fingerprint-debug.ts

@@ -1,7 +1,9 @@
 'use client';
 
 import {
+  FINGERPRINT_DEBUG_PREFIX,
   FINGERPRINT_DEBUG_OVERRIDE_STORAGE_KEY,
+  isDebugFingerprintId,
   isValidFingerprintId,
 } from './fingerprint-shared';
 
@@ -31,7 +33,7 @@ function setLocalStorageValue(key: string, value: string): void {
 
 export function getDebugFingerprintOverride(): string | null {
   const value = getLocalStorageValue(FINGERPRINT_DEBUG_OVERRIDE_STORAGE_KEY);
-  if (!value || !isValidFingerprintId(value)) {
+  if (!value || !isValidFingerprintId(value) || !isDebugFingerprintId(value)) {
     return null;
   }
 
@@ -39,9 +41,32 @@ export function getDebugFingerprintOverride(): string | null {
 }
 
 export function setDebugFingerprintOverride(fingerprintId: string): void {
-  if (!isValidFingerprintId(fingerprintId)) {
+  if (!isValidFingerprintId(fingerprintId) || !isDebugFingerprintId(fingerprintId)) {
     throw new Error('Invalid fingerprint ID');
   }
 
   setLocalStorageValue(FINGERPRINT_DEBUG_OVERRIDE_STORAGE_KEY, fingerprintId);
 }
+
+export function buildDebugFingerprintId(): string {
+  const timestamp = new Date().toISOString().replace(/[-:TZ.]/g, '').slice(0, 14);
+  const randomSuffix = Math.random().toString(36).slice(2, 8);
+  return `${FINGERPRINT_DEBUG_PREFIX}${timestamp}_${randomSuffix}`;
+}
+
+export function getOrCreateDebugFingerprintOverride(): string {
+  const existing = getDebugFingerprintOverride();
+  if (existing) {
+    return existing;
+  }
+
+  const nextFingerprintId = buildDebugFingerprintId();
+  setDebugFingerprintOverride(nextFingerprintId);
+  return nextFingerprintId;
+}
+
+export function regenerateDebugFingerprintOverride(): string {
+  const nextFingerprintId = buildDebugFingerprintId();
+  setDebugFingerprintOverride(nextFingerprintId);
+  return nextFingerprintId;
+}

package/src/clerk/fingerprint/fingerprint-provider.tsx

@@ -9,8 +9,8 @@ import { useFingerprint } from './use-fingerprint';
 import { CopyableText } from '@windrun-huaiin/base-ui/ui';
 import { createFingerprintHeaders } from './fingerprint-client';
 import {
-  getDebugFingerprintOverride,
-  setDebugFingerprintOverride,
+  getOrCreateDebugFingerprintOverride,
+  regenerateDebugFingerprintOverride,
 } from './fingerprint-debug';
 import { FINGERPRINT_SOURCE_REFER } from './fingerprint-shared';
 
@@ -112,16 +112,12 @@ export function FingerprintStatus() {
   }, [xUser]);
 
   useEffect(() => {
-    const debugFingerprintOverride = getDebugFingerprintOverride();
-    if (debugFingerprintOverride) {
-      setActiveDebugFingerprintId(debugFingerprintOverride);
+    if (panelMode !== 'test') {
       return;
     }
 
-    const nextFingerprintId = buildDebugFingerprintId();
-    setDebugFingerprintOverride(nextFingerprintId);
-    setActiveDebugFingerprintId(nextFingerprintId);
-  }, []);
+    setActiveDebugFingerprintId((current) => current ?? getOrCreateDebugFingerprintOverride());
+  }, [panelMode]);
 
   const creditBuckets = useMemo(() => {
     if (!xCredit) return [];
@@ -185,12 +181,13 @@ export function FingerprintStatus() {
   );
 
   const runContextParallelInitTest = async () => {
-    const debugFingerprintId = activeDebugFingerprintId;
+    const debugFingerprintId = activeDebugFingerprintId ?? getOrCreateDebugFingerprintOverride();
     if (!debugFingerprintId) {
       setTestResult('Test fingerprint override is not ready yet.');
       return;
     }
 
+    setActiveDebugFingerprintId(debugFingerprintId);
     setIsRunningTest(true);
     setTestResult(`Running Frontend Prevention Test with fingerprint: ${debugFingerprintId}`);
 
@@ -240,12 +237,13 @@ export function FingerprintStatus() {
   };
 
   const runRawParallelPostTest = async () => {
-    const normalizedFingerprintId = activeDebugFingerprintId;
+    const normalizedFingerprintId = activeDebugFingerprintId ?? getOrCreateDebugFingerprintOverride();
     if (!normalizedFingerprintId) {
       setTestResult('Test fingerprint override is not ready yet.');
       return;
     }
 
+    setActiveDebugFingerprintId(normalizedFingerprintId);
     setIsRunningTest(true);
     setTestResult(`Running Backend Idempotency Test with fingerprint: ${normalizedFingerprintId}`);
 
@@ -303,8 +301,7 @@ export function FingerprintStatus() {
   };
 
   const regenerateTestFingerprint = () => {
-    const nextFingerprintId = buildDebugFingerprintId();
-    setDebugFingerprintOverride(nextFingerprintId);
+    const nextFingerprintId = regenerateDebugFingerprintOverride();
     setActiveDebugFingerprintId(nextFingerprintId);
     setTestResult(`Generated test fingerprint override: ${nextFingerprintId}`);
   };
@@ -680,12 +677,6 @@ function StatusTag({ value }: { value: string | undefined | null }) {
   );
 }
 
-function buildDebugFingerprintId() {
-  const timestamp = new Date().toISOString().replace(/[-:TZ.]/g, '').slice(0, 14);
-  const randomSuffix = Math.random().toString(36).slice(2, 8);
-  return `fp_test_dbg_${timestamp}_${randomSuffix}`;
-}
-
 function formatErrorMessage(error: unknown) {
   if (error instanceof Error) {
     return error.message;

package/src/clerk/fingerprint/fingerprint-shared.ts

@@ -12,6 +12,7 @@ export const FINGERPRINT_SOURCE_REFER = 'x-source-ref';
 export const FINGERPRINT_FIRST_TOUCH_STORAGE_KEY = '__x_first_touch';
 export const FINGERPRINT_FIRST_TOUCH_COOKIE_NAME = '__x_first_touch';
 export const FINGERPRINT_FIRST_TOUCH_HEADER = 'x-first-touch';
+export const FINGERPRINT_DEBUG_PREFIX = 'fp_test_dbg_';
 
 /**
  * 验证fingerprint ID格式
@@ -23,7 +24,16 @@ export function isValidFingerprintId(fingerprintId: string): boolean {
   // - fp_ + FingerprintJS visitorId (变长字符串)
   // - fp_fallback_ + 时间戳_随机字符串 (客户端降级方案)
   // - fp_server_ + 时间戳_随机字符串 (服务端降级)
-  return /^fp(_fallback|_server)?_[a-zA-Z0-9_]+$/.test(fingerprintId);
+  // - fp_test_dbg_ + 时间戳_随机字符串 (调试并发测试)
+  return /^fp(_fallback|_server|_test_dbg)?_[a-zA-Z0-9_]+$/.test(fingerprintId);
+}
+
+export function isDebugFingerprintId(fingerprintId: string | null | undefined): boolean {
+  if (!fingerprintId) {
+    return false;
+  }
+
+  return fingerprintId.startsWith(FINGERPRINT_DEBUG_PREFIX);
 }
 
 // 常量导出
@@ -35,4 +45,5 @@ export const FINGERPRINT_CONSTANTS = {
   FIRST_TOUCH_STORAGE_KEY: FINGERPRINT_FIRST_TOUCH_STORAGE_KEY,
   FIRST_TOUCH_COOKIE_NAME: FINGERPRINT_FIRST_TOUCH_COOKIE_NAME,
   FIRST_TOUCH_HEADER: FINGERPRINT_FIRST_TOUCH_HEADER,
+  DEBUG_PREFIX: FINGERPRINT_DEBUG_PREFIX,
 } as const;

package/src/clerk/fingerprint/use-fingerprint.ts

@@ -4,7 +4,8 @@ import { useCallback, useEffect, useRef, useState } from 'react';
 import {
   createFingerprintHeaders,
   getOrCreateFirstTouchData,
-  getOrGenerateFingerprintId
+  getOrGenerateFingerprintId,
+  setFingerprintId,
 } from './fingerprint-client';
 import type {
   FingerprintConfig,
@@ -13,7 +14,7 @@ import type {
   XSubscription,
   XUser
 } from './types';
-import { FINGERPRINT_SOURCE_REFER } from './fingerprint-shared'
+import { FINGERPRINT_SOURCE_REFER, isDebugFingerprintId, isValidFingerprintId } from './fingerprint-shared'
 
 /**
  * Hook for managing fingerprint ID and anonymous user data
@@ -121,8 +122,15 @@ export function useFingerprint(config: FingerprintConfig): UseFingerprintResult
         setXSubscription(data.xSubscription || null);
         setIsInitialized(true);
 
-        if (data.xUser?.fingerprintId && data.xUser.fingerprintId !== fingerprintId) {
-          setFingerprintIdState(data.xUser.fingerprintId);
+        const canonicalFingerprintId = data.xUser?.fingerprintId;
+        if (
+          canonicalFingerprintId &&
+          isValidFingerprintId(canonicalFingerprintId) &&
+          !isDebugFingerprintId(canonicalFingerprintId) &&
+          canonicalFingerprintId !== fingerprintId
+        ) {
+          setFingerprintIdState(canonicalFingerprintId);
+          setFingerprintId(canonicalFingerprintId);
         }
       } else {
         throw new Error(data.error || 'Unknown error occurred');

package/src/clerk/patch/optional-auth.ts

@@ -1,24 +0,0 @@
-import { auth } from '@clerk/nextjs/server';
-
-export type OptionalAuthResult = {
-  userId: string | null;
-  sessionId: string | null;
-  raw: Awaited<ReturnType<typeof auth>> | null;
-};
-
-/**
- * 可选鉴权：在缺少 Clerk 标记或未登录时返回 null，避免 auth() 抛错。
- * 仅供服务端使用，请从 @third-ui/clerk/patch/optional-auth 导入。
- */
-export async function getOptionalAuth(): Promise<OptionalAuthResult> {
-  try {
-    const res = await auth();
-    return {
-      userId: res.userId ?? null,
-      sessionId: res.sessionId ?? null,
-      raw: res,
-    };
-  } catch {
-    return { userId: null, sessionId: null, raw: null };
-  }
-}