@anonympins/fingerprint 0.5.2 → 0.5.4

package/src/js/fingerprint.client.js

@@ -1,1192 +1,1272 @@
-import {cyrb53 as jsCyrb53, FingerprintBuilder} from './fingerprint.builder.js';
-import {solveChallenge} from './pow.solver.js';
-
-// Variable pour stocker la fonction de hachage active.
-// Par défaut, c'est l'implémentation JavaScript.
-let activeCyrb53 = jsCyrb53;
-
-const DB_NAME = 'wasm-cache-db';
-const DB_VERSION = 1;
-const STORE_NAME = 'wasm-modules';
-
-function getCachedWasm(url) {
-    return new Promise((resolve) => {
-        if (typeof indexedDB === 'undefined') return resolve(null);
-        const request = indexedDB.open(DB_NAME, DB_VERSION);
-        request.onupgradeneeded = (e) => {
-            const db = e.target.result;
-            if (!db.objectStoreNames.contains(STORE_NAME)) {
-                db.createObjectStore(STORE_NAME);
-            }
-        };
-        request.onsuccess = (e) => {
-            const db = e.target.result;
-            try {
-                const transaction = db.transaction(STORE_NAME, 'readonly');
-                const store = transaction.objectStore(STORE_NAME);
-                const getReq = store.get(url);
-                getReq.onsuccess = () => resolve(getReq.result);
-                getReq.onerror = () => resolve(null);
-            } catch (err) {
-                resolve(null);
-            }
-        };
-        request.onerror = () => resolve(null);
-    });
-}
-
-function cacheWasm(url, data) {
-    return new Promise((resolve) => {
-        if (typeof indexedDB === 'undefined') return resolve(false);
-        const request = indexedDB.open(DB_NAME, DB_VERSION);
-        request.onupgradeneeded = (e) => {
-            const db = e.target.result;
-            if (!db.objectStoreNames.contains(STORE_NAME)) {
-                db.createObjectStore(STORE_NAME);
-            }
-        };
-        request.onsuccess = (e) => {
-            const db = e.target.result;
-            try {
-                const transaction = db.transaction(STORE_NAME, 'readwrite');
-                const store = transaction.objectStore(STORE_NAME);
-                store.put(data, url);
-                transaction.oncomplete = () => resolve(true);
-                transaction.onerror = () => resolve(false);
-            } catch (err) {
-                resolve(false);
-            }
-        };
-        request.onerror = () => resolve(false);
-    });
-}
-
-const ClientLibrary = {
-    // Cache pour éviter de recalculer les constantes (Hardware, etc.)
-    _cachedBuilder: null,
-    /**
-     * @private
-     * Dispatches a custom event from the window object.
-     * @param {string} eventName - The name of the event.
-     * @param {object} [detail={}] - The data to include in the event's detail property.
-     */
-    _dispatchEvent(eventName, detail = {}) {
-        if (typeof window === 'undefined' || typeof CustomEvent === 'undefined') return;
-        const event = new CustomEvent(`fingerprint:${eventName}`, { detail });
-        window.dispatchEvent(event);
-    },
-
-    /**
-     * Wrapper interne pour la fonction de hachage.
-     * @private
-     */
-    _hasher: (str, seed) => activeCyrb53(str, seed),
-
-    /**
-     * Génère une preuve de connaissance à divulgation nulle (ZKP) de Schnorr pour l'empreinte de l'appareil.
-     * Rend le tout stable et compatible avec les vérifications JS, PHP et Python.
-     * @param {string} fingerprint - L'empreinte de l'appareil.
-     * @returns {Promise<string>} La preuve sous format "y:t:s" en hexadécimal.
-     */
-    async generateZkpProof(fingerprint) {
-        const ZKP_P = 115792089237316195423570985008687907853269984665640564039457584007908834671663n;
-        const ZKP_G = 2n;
-        const cryptoObj = window.crypto || window.msCrypto;
-
-        const sha256Hex = async (str) => {
-            const encoder = new TextEncoder();
-            const data = encoder.encode(str);
-            const hashBuffer = await cryptoObj.subtle.digest('SHA-256', data);
-            const hashArray = Array.from(new Uint8Array(hashBuffer));
-            return hashArray.map(b => b.toString(16).padStart(2, '0')).join('');
-        };
-
-        const modPow = (base, exponent, modulus) => {
-            if (modulus === 1n) return 0n;
-            let result = 1n;
-            base = base % modulus;
-            while (exponent > 0n) {
-                if (exponent % 2n === 1n) {
-                    result = (result * base) % modulus;
-                }
-                exponent = exponent >> 1n;
-                base = (base * base) % modulus;
-            }
-            return result;
-        };
-
-        const xHex = await sha256Hex(fingerprint);
-        const x = BigInt('0x' + xHex) % ZKP_P;
-        const y = modPow(ZKP_G, x, ZKP_P);
-        const randomBytes = new Uint8Array(32);
-        cryptoObj.getRandomValues(randomBytes);
-        let vHex = Array.from(randomBytes).map(b => b.toString(16).padStart(2, '0')).join('');
-        let v = BigInt('0x' + vHex) % (ZKP_P - 1n);
-        if (v === 0n) v = 1n;
-        const t = modPow(ZKP_G, v, ZKP_P);
-        const cStr = ZKP_G.toString() + y.toString() + t.toString();
-        const cHex = await sha256Hex(cStr);
-        const c = BigInt('0x' + cHex) % ZKP_P;
-        const s = (v + c * x) % (ZKP_P - 1n);
-
-        return `${y.toString(16)}:${t.toString(16)}:${s.toString(16)}`;
-    },
-
-    /**
-     * Génère l'empreinte de l'appareil actuel.
-     */
-    getDeviceFingerprint() {
-        if (typeof window === "undefined") {
-            console.error("getDeviceFingerprint can only be called on the client-side.");
-            return "";
-        }
-        
-        if (!this._cachedBuilder) {
-            const nav = window.navigator;
-            const screen = window.screen;
-
-            this._cachedBuilder = new FingerprintBuilder();
-
-            // 1. Hardware (Très stable) : Cœurs, RAM, GPU (si dispo via canvas), Touch
-            this._cachedBuilder.add(
-                "hw", // Utilise maintenant le hasher actif
-                `${nav.hardwareConcurrency}_${nav.deviceMemory}_${nav.maxTouchPoints}`,
-            );
-
-            // 2. Geo/Locale (Stable sauf voyage/VPN) : Timezone, Langue
-            this._cachedBuilder.add(
-                "geo",
-                `${Intl.DateTimeFormat().resolvedOptions().timeZone}_${nav.language}_${new Date().getTimezoneOffset()}`,
-            );
-
-            // 3. Screen (Stable sauf changement moniteur/zoom) : Dimensions, ColorDepth
-            this._cachedBuilder.add(
-                "scr",
-                `${screen.width}x${screen.height}_${screen.colorDepth}`,
-            );
-
-            // 4. Platform (Stable) : OS, Engine
-            this._cachedBuilder.add("os", nav.platform);
-
-            // 5. Graphics (WebGL Vendor/Renderer) - Invariant matériel fort
-            try {
-                const canvas = document.createElement("canvas");
-                const gl =
-                    canvas.getContext("webgl2") ||
-                    canvas.getContext("webgl") ||
-                    canvas.getContext("experimental-webgl");
-                if (gl) {
-                    const debugInfo = gl.getExtension("WEBGL_debug_renderer_info");
-                    if (debugInfo) {
-                        const vendor = gl.getParameter(debugInfo.UNMASKED_VENDOR_WEBGL);
-                        const renderer = gl.getParameter(debugInfo.UNMASKED_RENDERER_WEBGL);
-                        this._cachedBuilder.add("gpu", `${vendor}_${renderer}`);
-                    }
-                }
-            } catch (e) {
-            }
-
-            // 6. Canvas Fingerprinting (Rendering quirks)
-            try {
-                const canvas = document.createElement("canvas");
-                const ctx = canvas.getContext("2d");
-                if (ctx) {
-                    canvas.width = 200;
-                    canvas.height = 50;
-                    ctx.textBaseline = "alphabetic";
-                    ctx.font = "14px 'Arial'";
-                    ctx.fillStyle = "#f60";
-                    ctx.fillRect(125, 1, 62, 20);
-                    ctx.fillStyle = "#069";
-                    ctx.fillText("fingerprint", 2, 15);
-                    ctx.fillStyle = "rgba(102, 204, 0, 0.7)";
-                    ctx.fillText("fingerprint", 4, 17);
-                    this._cachedBuilder.add("cvs", canvas.toDataURL());
-                }
-            } catch (e) {
-            }
-
-            // 7. Détection des artefacts du Chrome DevTools Protocol (CDP)
-            // Ces variables sont souvent injectées par les outils d'automatisation.
-            const cdpFootprints = [
-                'cdc_adoQpoasnfa76pfcZLmcfl_Array',
-                'cdc_adoQpoasnfa76pfcZLmcfl_Promise',
-                'cdc_adoQpoasnfa76pfcZLmcfl_Symbol',
-                '$cdc_asdjflasutopfhvcZLmcfl_',
-                '_selenium',
-                '_driver'
-            ];
-            if (cdpFootprints.some(fp => window[fp])) {
-                this._cachedBuilder.add("cdp", "true");
-            }
-
-            // 7. Bot Detection (Indication cachée)
-            if (nav.webdriver) this._cachedBuilder.add("bot", "true");
-        }
-
-        return this._cachedBuilder.toString();
-    },
-
-    /**
-     * Génère une signature de requête incluant le contexte.
-     * @param {object} payload
-     */
-    /**
-     * Génère une signature de requête incluant le contexte.
-     * @param {object} payload
-     */
-    generateRequestSignature(payload = {}) {
-        const deviceFp = this.getDeviceFingerprint();
-        const sortedPayload = Object.keys(payload)
-            .sort()
-            .map((k) => `${k}=${payload[k]}`)
-            .join("&");
-        const payloadHash = this._hasher(sortedPayload);
-        return `${deviceFp}|req:${payloadHash}`;
-    },
-
-    /**
-     * Génère une signature HMAC-SHA256 en utilisant l'API Web Crypto.
-     * @param {object} payload - Les données à signer.
-     * @param {string} secret - La clé secrète partagée.
-     * @returns {Promise<string>} La signature hexadécimale.
-     */
-    async generateClientSideSignature(payload, secret) {
-        const sortedPayload = Object.keys(payload).sort().map((k) => `${k}=${payload[k]}`).join("&");
-        const encoder = new TextEncoder();
-        const key = await window.crypto.subtle.importKey("raw", encoder.encode(secret), {
-            name: "HMAC",
-            hash: "SHA-256"
-        }, false, ["sign"]);
-        const signatureBuffer = await window.crypto.subtle.sign("HMAC", key, encoder.encode(sortedPayload));
-        const hashArray = Array.from(new Uint8Array(signatureBuffer));
-        return hashArray.map((b) => b.toString(16).padStart(2, "0")).join("");
-    },
-
-    /**
-     * @internal
-     * Resets the cached fingerprint builder. Used for testing purposes.
-     */
-    _resetCache() {
-        // Réinitialise le hasher à l'implémentation JS par défaut.
-        activeCyrb53 = jsCyrb53;
-        this._cachedBuilder = null;
-    },
-
-    /**
-     * Injecte des éléments interactifs fantômes invisibles pour piéger les bots (focus/hover).
-     */
-    injectPhantomTraps() {
-        if (typeof document === 'undefined') return;
-
-        // Création d'un élément interactif fantôme
-        const phantom = document.createElement('a');
-        phantom.href = '#';
-        // Nom trompeur pour attirer les analyseurs automatiques de liens / formulaires
-        phantom.id = 'sys-session-recovery';
-        phantom.tabIndex = 0; // Dans le flux naturel de tabulation
-        phantom.setAttribute('aria-hidden', 'true'); // Masqué pour les screen readers légitimes
-
-        // Style invisible mais interactif (1px x 1px, presque transparent)
-        phantom.style.position = 'fixed';
-        phantom.style.top = '1px';
-        phantom.style.left = '1px';
-        phantom.style.width = '1px';
-        phantom.style.height = '1px';
-        phantom.style.opacity = '0.001';
-        phantom.style.zIndex = '99999';
-        phantom.style.overflow = 'hidden';
-        phantom.style.pointerEvents = 'auto';
-
-        const triggerTrap = () => {
-            this.onHoneypotTrigger();
-        };
-
-        phantom.addEventListener('focus', triggerTrap, { passive: true });
-        phantom.addEventListener('mouseover', triggerTrap, { passive: true });
-
-        document.body.appendChild(phantom);
-    },
-
-    /**
-     * Démarre le suivi des événements tactiles sur mobile/tablette.
-     */
-    startTouchEventTracker() {
-        if (this._touchTrackerAttached) return;
-        this._touchTrackerAttached = true;
-
-        const handleTouch = (e) => {
-            if (touchMovementsHistory.length >= TOUCH_HISTORY_MAX) {
-                touchMovementsHistory.shift();
-            }
-            const touch = e.touches[0] || e.changedTouches[0];
-            if (!touch) return;
-
-            const radiusX = touch.radiusX || 0;
-            const radiusY = touch.radiusY || 0;
-            const radius = (radiusX + radiusY) / 2;
-            const force = touch.force || touch.webkitForce || 0;
-
-            touchMovementsHistory.push({
-                x: touch.clientX,
-                y: touch.clientY,
-                t: performance.now(),
-                p: force,
-                r: radius,
-                num: e.touches.length
-            });
-        };
-
-        document.addEventListener('touchstart', handleTouch, { passive: true });
-        document.addEventListener('touchmove', handleTouch, { passive: true });
-        document.addEventListener('touchend', handleTouch, { passive: true });
-    },
-
-    /**
-     * Démarre le suivi de la régularité d'affichage (V-Sync/rAF) pour détecter les framebuffers logiciels sans V-Sync.
-     */
-    startRenderingTracker() {
-        if (this._renderingTrackerAttached) return;
-        this._renderingTrackerAttached = true;
-
-        if (typeof window === 'undefined' || !window.requestAnimationFrame) return;
-
-        const rAfTimestamps = [];
-        let lastTime = performance.now();
-        const maxSamples = 15;
-
-        const checkOffscreenAnom = () => {
-            try {
-                if ('OffscreenCanvas' in window && HTMLCanvasElement.prototype.transferControlToOffscreen) {
-                    const nativeToString = Function.prototype.toString.call(HTMLCanvasElement.prototype.transferControlToOffscreen);
-                    return !nativeToString.includes('[native code]');
-                }
-            } catch (e) {}
-            return false;
-        };
-
-        const loop = (time) => {
-            const delta = time - lastTime;
-            lastTime = time;
-            if (rAfTimestamps.length < maxSamples) {
-                if (rAfTimestamps.length > 0) { // Skip first delta
-                    rAfTimestamps.push(delta);
-                }
-                window.requestAnimationFrame(loop);
-            } else {
-                const avg = rAfTimestamps.reduce((a, b) => a + b, 0) / rAfTimestamps.length;
-                const sqDiffs = rAfTimestamps.map(v => Math.pow(v - avg, 2));
-                const avgSqDiff = sqDiffs.reduce((a, b) => a + b, 0) / sqDiffs.length;
-                
-                metrics.rendering = {
-                    fps: Math.round((1000 / avg) * 100) / 100,
-                    jitter: Math.round(Math.sqrt(avgSqDiff) * 100) / 100,
-                    offscreenAnom: checkOffscreenAnom()
-                };
-            }
-        };
-        window.requestAnimationFrame(loop);
-    },
-
-    /**
-     * Initialise l'espace Proof-of-Space persistant dans l'IndexedDB locale.
-     */
-    async initializeSpace(seed, sizeMb) {
-        return new Promise((resolve, reject) => {
-            const request = indexedDB.open('pospace-db', 1);
-            request.onupgradeneeded = (e) => {
-                const db = e.target.result;
-                if (!db.objectStoreNames.contains('blocks')) {
-                    db.createObjectStore('blocks');
-                }
-            };
-            request.onsuccess = async (e) => {
-                const db = e.target.result;
-                const tx = db.transaction('blocks', 'readwrite');
-                const store = tx.objectStore('blocks');
-                
-                const maxBlocks = sizeMb * 1024;
-                const countReq = store.count();
-                countReq.onsuccess = async () => {
-                    if (countReq.result < maxBlocks) {
-                        for (let i = 0; i < maxBlocks; i++) {
-                            const block = new Uint8Array(1024);
-                            let h = 5381;
-                            for (let j = 0; j < seed.length; j++) {
-                                h = (h << 5) + h + seed.charCodeAt(j);
-                            }
-                            h = (h << 5) + h + i;
-                            for (let k = 0; k < 1024; k++) {
-                                h = Math.imul(h ^ k, 1597334677);
-                                block[k] = h & 0xff;
-                            }
-                            store.put(block, i);
-                        }
-                    }
-                    resolve();
-                };
-            };
-            request.onerror = () => reject(new Error("Failed to open pospace database"));
-        });
-    },
-
-    /**
-     * Lit un bloc spécifique de l'IndexedDB locale sous format hexadécimal.
-     */
-    async readSpaceBlock(blockIdx) {
-        return new Promise((resolve, reject) => {
-            const request = indexedDB.open('pospace-db', 1);
-            request.onsuccess = (e) => {
-                const db = e.target.result;
-                const tx = db.transaction('blocks', 'readonly');
-                const store = tx.objectStore('blocks');
-                const getReq = store.get(blockIdx);
-                getReq.onsuccess = () => {
-                    const block = getReq.result;
-                    if (block) {
-                        const hex = Array.from(block).map(b => b.toString(16).padStart(2, '0')).join('');
-                        resolve(hex);
-                    } else {
-                        reject(new Error("Block not found"));
-                    }
-                };
-                getReq.onerror = () => reject(getReq.error);
-            };
-            request.onerror = () => reject(new Error("Failed to open pospace database"));
-        });
-    },
-
-    /**
-     * Résout le Proof-of-Space en combinant optionnellement le bloc du pair.
-     */
-    async solveSpaceChallenge(seed, queries, nonce, clientSecret, peerBlock = '') {
-        const blocks = [];
-        for (const idx of queries) {
-            const blockHex = await this.readSpaceBlock(idx);
-            blocks.push(blockHex);
-        }
-        let finalPayload = blocks.join('') + peerBlock + nonce + ":" + clientSecret;
-        const encoder = new TextEncoder();
-        const data = encoder.encode(finalPayload);
-        const hashBuffer = await window.crypto.subtle.digest('SHA-256', data);
-        const hashArray = Array.from(new Uint8Array(hashBuffer));
-        return hashArray.map(b => b.toString(16).padStart(2, '0')).join('');
-    },
-
-    /**
-     * Démarre le suivi des mouvements de la souris pour calculer l'entropie.
-     * À appeler une fois sur la page.
-     */
-    startMouseEntropyTracker() {
-        // Utiliser un drapeau pour éviter d'attacher l'écouteur plusieurs fois
-        if (this._mouseTrackerAttached) return;
-        this._mouseTrackerAttached = true;
- 
-        document.addEventListener('mousemove', (e) => {
-            // NOUVEAU: Capturer une série de points {x, y, t}
-            if (mouseMovementsHistory.length >= MOUSE_HISTORY_MAX) {
-                // Garder la taille de l'historique constante pour éviter une consommation mémoire excessive.
-                mouseMovementsHistory.shift();
-            }
-            mouseMovementsHistory.push({
-                x: e.clientX,
-                y: e.clientY,
-                t: performance.now()
-            });
-        }, {passive: true});
-    },
-
-    /**
-     * Démarre le suivi de la dynamique de frappe pour calculer le dwell time et le flight time (digraphie/trigraphie).
-     * À appeler une fois sur la page.
-     */
-    startKeystrokeDynamicsTracker() {
-        // S'assurer de ne pas attacher l'écouteur plusieurs fois
-        if (this._keystrokeTrackerAttached) return;
-        this._keystrokeTrackerAttached = true;
-
-        const activeKeys = new Map();
-        let lastKeyDownTime = 0;
-        let lastKeyName = '';
-
-        document.addEventListener('keydown', (e) => {
-            const now = performance.now();
-            const key = e.key;
-            const code = e.code;
-            if (!key && !code) return;
-
-            const keyIdentifier = code || key;
-
-            // Prevent key repeat triggering multiple events
-            if (activeKeys.has(keyIdentifier)) return;
-            activeKeys.set(keyIdentifier, now);
-
-            if (keystrokeTimestamps.length > 0) {
-                const lastTimestamp = keystrokeTimestamps[keystrokeTimestamps.length - 1];
-                const latency = now - lastTimestamp;
-                if (latency > 10 && latency < 2000) {
-                    if (keystrokeLatencies.length >= KEYSTROKE_HISTORY_MAX) {
-                        keystrokeLatencies.shift();
-                    }
-                    keystrokeLatencies.push(latency);
-                }
-            }
-            keystrokeTimestamps.push(now);
-
-            // Flight Time (KeyDown to KeyDown)
-            if (lastKeyDownTime > 0) {
-                const flightTime = now - lastKeyDownTime;
-                if (flightTime > 10 && flightTime < 2000) {
-                    if (keystrokeFlightTimes.length >= KEYSTROKE_HISTORY_MAX) {
-                        keystrokeFlightTimes.shift();
-                    }
-                    const digraph = lastKeyName ? this._hasher(lastKeyName + "_" + keyIdentifier).toString() : "unknown";
-                    keystrokeFlightTimes.push({ digraph, time: flightTime });
-                }
-            }
-            lastKeyDownTime = now;
-            lastKeyName = keyIdentifier;
-        }, {passive: true});
-
-        document.addEventListener('keyup', (e) => {
-            const now = performance.now();
-            const key = e.key;
-            const code = e.code;
-            if (!key && !code) return;
-
-            const keyIdentifier = code || key;
-
-            if (activeKeys.has(keyIdentifier)) {
-                const pressTime = activeKeys.get(keyIdentifier);
-                const dwellTime = now - pressTime;
-                activeKeys.delete(keyIdentifier);
-
-                if (dwellTime > 5 && dwellTime < 1000) {
-                    if (keystrokeDwellTimes.length >= KEYSTROKE_HISTORY_MAX) {
-                        keystrokeDwellTimes.shift();
-                    }
-                    keystrokeDwellTimes.push(dwellTime);
-                }
-            }
-        }, {passive: true});
-    },
-
-    /**
-     * Starts tracking click events to analyze position variance.
-     * @private
-     */
-    startClickTracker() {
-        if (this._clickTrackerAttached) return;
-        this._clickTrackerAttached = true;
-
-        document.addEventListener('click', (e) => {
-            if (clicksHistory.length >= CLICKS_HISTORY_MAX) {
-                clicksHistory.shift();
-            }
-            // Generate a simple identifier for the target element
-            const target = e.target;
-            const targetId = target.id || target.name || target.tagName;
-
-            clicksHistory.push({
-                x: e.clientX,
-                y: e.clientY,
-                t: performance.now(),
-                targetId: this._hasher(targetId) // Hash the ID to keep it short and consistent
-            });
-        }, { passive: true });
-    },
-    /**
-     * Initialise ou réinitialise les honeypots côté client pour une détection immédiate.
-     * Les anciens écouteurs sont supprimés avant d'en ajouter de nouveaux.
-     * @param {string[]} honeypotFieldNames - Noms des champs de formulaire cachés.
-     */
-    initializeHoneypots(honeypotFieldNames) {
-        // 1. Nettoyer les anciens écouteurs
-        activeHoneypotListeners.forEach((listener, field) => {
-            field.removeEventListener('input', listener);
-        });
-        activeHoneypotListeners.clear();
-
-        // 2. Ajouter les nouveaux écouteurs sur le DOM classique
-        honeypotFieldNames.forEach(fieldName => {
-            const field = document.querySelector(`[name="${fieldName}"]`);
-            if (field) {
-                const listener = () => {
-                    this.onHoneypotTrigger();
-                    field.removeEventListener('input', listener);
-                };
-                field.addEventListener('input', listener);
-                activeHoneypotListeners.set(field, listener); // On stocke la référence
-            }
-        });
-
-        // 3. Générer des champs d'input pièges masqués dans un Shadow DOM fermé
-        if (typeof document !== 'undefined' && honeypotFieldNames.length > 0) {
-            const host = document.createElement('div');
-            host.setAttribute('aria-hidden', 'true');
-            host.style.position = 'absolute';
-            host.style.width = '0';
-            host.style.height = '0';
-            host.style.overflow = 'hidden';
-
-            const shadow = host.attachShadow({ mode: 'closed' });
-
-            const style = document.createElement('style');
-            style.textContent = `
-              :host {
-                --trap-pos-state: absolute;
-                --trap-off-val: -9999px;
-                --trap-vis-state: hidden;
-                --trap-scale-val: 0;
-              }
-              .shadow-form-wrapper {
-                position: var(--trap-pos-state);
-                left: var(--trap-off-val);
-                top: var(--trap-off-val);
-                visibility: var(--trap-vis-state);
-                transform: scale(var(--trap-scale-val));
-              }
-            `;
-            shadow.appendChild(style);
-
-            const wrapper = document.createElement('div');
-            wrapper.className = 'shadow-form-wrapper';
-
-            honeypotFieldNames.forEach(fieldName => {
-                const label = document.createElement('label');
-                label.textContent = fieldName;
-                const input = document.createElement('input');
-                input.type = 'text';
-                input.name = fieldName;
-                input.tabIndex = -1;
-                input.autocomplete = 'off';
-
-                const trigger = () => {
-                    this.onHoneypotTrigger();
-                };
-
-                input.addEventListener('input', trigger, { passive: true });
-                input.addEventListener('change', trigger, { passive: true });
-                input.addEventListener('focus', trigger, { passive: true });
-
-                wrapper.appendChild(label);
-                wrapper.appendChild(input);
-            });
-
-            shadow.appendChild(wrapper);
-            document.body.appendChild(host);
-        }
-    },
-
-    /**
-     * Récupère les métriques comportementales collectées.
-     * À appeler avant d'envoyer une requête sensible.
-     * @returns {ClientBehaviorMetrics}
-     */
-    getClientBehaviorMetrics() {
-        // Add history length as a behavioral signal.
-        metrics.historyLength = window.history.length;
-
-        // Ajoute un timestamp au moment de la collecte pour la détection de rejeu.
-        metrics.clicksHistory = clicksHistory;
-        metrics.clientTimestamp = Date.now();
-
-        metrics.touchMovementsHistory = touchMovementsHistory;
-        // NOUVEAU: Inclure l'historique des mouvements de la souris pour une analyse côté serveur.
-        metrics.mouseMovementsHistory = mouseMovementsHistory;
-
-        // NOUVEAU: Keystroke dynamics metrics (dwell and flight times)
-        metrics.keystrokeDwellTimes = keystrokeDwellTimes;
-        metrics.keystrokeFlightTimes = keystrokeFlightTimes;
-
-        // Calcule la latence moyenne des frappes
-        if (keystrokeLatencies.length > 0) {
-            const sum = keystrokeLatencies.reduce((a, b) => a + b, 0);
-            metrics.keystrokeLatency = sum / keystrokeLatencies.length;
-        } else {
-            metrics.keystrokeLatency = 0;
-        }
-        return metrics;
-    },
-
-    /**
-     * Enrichit une requête fetch avec les en-têtes de fingerprinting et de comportement.
-     * @param {RequestInfo} resource
-     * @param {RequestInit} [options]
-     * @returns {Promise<Response>}
-     */
-    async protectedFetch(resource, options = {}) {
-        const fp = this.getDeviceFingerprint();
-        const behavior = this.getClientBehaviorMetrics();
-
-        const headers = new Headers(options.headers || {});
-        headers.set('X-Device-Fingerprint', fp);
-        headers.set('X-Behavior-Metrics', JSON.stringify(behavior));
-
-        options.headers = headers;
-        return fetch(resource, options);
-    },
-
-// --- Système d'interception de Fetch robuste et anti-conflit ---
-
-    _isFetchPatched: false,
-    _interceptorChain: [],
-    // On stocke la fonction fetch originale et on la lie à son contexte (window)
-    // pour éviter les erreurs "Illegal invocation" si une autre lib la modifie.
-    _originalFetch: (typeof window !== 'undefined') ? window.fetch.bind(window) : null,
-
-/**
- * Adds an interceptor function to the `fetch` chain.
- * Chaque intercepteur reçoit `resource`, `options`, et une fonction `next`.
- * Il DOIT appeler `next(resource, options)` pour continuer la chaîne.
- * @param {function(RequestInfo, RequestInit, function): Promise<Response>} interceptor
- */
-  addFetchInterceptor(interceptor) {
-    if (!this._isFetchPatched) {
-        this.patchGlobalFetch();
-    }
-    this._interceptorChain.push(interceptor);
-  },
-
-  patchGlobalFetch() {
-    if (this._isFetchPatched || !this._originalFetch) return;
-
-    this._isFetchPatched = true;
-    window.fetch = (resource, options) => {
-        // Le "dispatcher" qui exécute la chaîne.
-        const dispatch = (index, res, opts) => {
-            if (index >= this._interceptorChain.length) {
-                // Fin de la chaîne, on appelle le fetch original.
-                return this._originalFetch(res, opts);
-            }
-            const nextInterceptor = this._interceptorChain[index];
-            // Appelle l'intercepteur actuel en lui passant la fonction pour appeler le suivant.
-            return nextInterceptor(res, opts, (nextRes, nextOpts) => dispatch(index + 1, nextRes, nextOpts));
-        };
-        return dispatch(0, resource, options || {});
-    };
-  },
-
-    /**
-     * La fonction qui est appelée lorsqu'un honeypot est déclenché.
-     * @private
-     */
-    onHoneypotTrigger() {
-        metrics.honeypotInteraction = true;
-        // Émettre un événement pour que l'application puisse réagir.
-        this._dispatchEvent('honeypotTriggered');
-    },
-
-  /**
-   * Initialise l'intercepteur de fingerprinting.
-   * Il s'ajoute à la chaîne d'interception sans écraser les autres.
-   * @param {string[]} [targetDomains] - Optionnel. Liste de domaines à protéger.
-   * Si non fourni, protège les requêtes de même origine.
-   */
-  initializeFetch(targetDomains = []) {
-    const fingerprintInterceptor = (resource, options, next) => {        
-        const requestUrl = (resource instanceof Request) ? resource.url : String(resource);        
-        let shouldProtect = false;
-
-        try {
-            const url = new URL(requestUrl, window.location.origin);
-            // Protéger si la liste de domaines est vide ET que la requête est de même origine,
-            // OU si le domaine de la requête est dans la liste fournie.
-            shouldProtect = (targetDomains.length === 0 && url.origin === window.location.origin) || 
-                            (targetDomains.length > 0 && targetDomains.includes(url.hostname));
-        } catch (e) {
-            // Si l'URL est relative (ex: '/api/data'), new URL() ne lèvera pas d'erreur.
-            // Ce bloc est une sécurité pour les cas où l'URL serait malformée.
-            // On protège par défaut si aucune liste de domaines n'est spécifiée.
-            shouldProtect = targetDomains.length === 0;
-        }
-
-        if (shouldProtect) {
-            const fp = this.getDeviceFingerprint();
-            const behavior = this.getClientBehaviorMetrics();
-            const headers = new Headers(options.headers || {});
-            headers.set('X-Device-Fingerprint', fp);
-            headers.set('X-Behavior-Metrics', JSON.stringify(behavior));
-            options.headers = headers;
-        }
-
-        // Passe la main à l'intercepteur suivant dans la chaîne.
-        return next(resource, options);
-    };
-
-    this.addFetchInterceptor(fingerprintInterceptor);
-  }, // <-- VIRGULE AJOUTÉE ICI
-  
-  /**
-   * Injects visually hidden "honeypot" links into the DOM to trap bots.
-   * @param {string[]} urls - An array of trap URLs to inject.
-   * @private
-   */
-  injectTrapLinks(urls) {
-    if (!urls || urls.length === 0 || typeof document === 'undefined') {
-      return;
-    }
-
-    const host = document.createElement('div');
-    host.setAttribute('aria-hidden', 'true');
-    host.style.position = 'absolute';
-    host.style.width = '0';
-    host.style.height = '0';
-    host.style.overflow = 'hidden';
-
-    const shadow = host.attachShadow({ mode: 'closed' });
-
-    const style = document.createElement('style');
-    style.textContent = `
-      :host {
-        --trap-layout-pos: absolute;
-        --trap-offset-val: -9999px;
-        --trap-visibility-state: hidden;
-        --trap-scale-factor: 0;
-        --trap-ptr-events: none;
-      }
-      .shadow-trap-wrapper {
-        position: var(--trap-layout-pos);
-        left: var(--trap-offset-val);
-        top: var(--trap-offset-val);
-        visibility: var(--trap-visibility-state);
-        transform: scale(var(--trap-scale-factor));
-        pointer-events: var(--trap-ptr-events);
-      }
-      a {
-        color: transparent;
-        text-decoration: none;
-      }
-    `;
-    shadow.appendChild(style);
-
-    const wrapper = document.createElement('div');
-    wrapper.className = 'shadow-trap-wrapper';
-
-    urls.forEach((url, i) => {
-      const link = document.createElement('a');
-      link.href = url;
-      link.rel = 'nofollow';
-      link.tabIndex = -1;
-      link.innerHTML = `<span>&gt; ${i + 1}</span>`;
-
-      const trigger = () => {
-        this.onHoneypotTrigger();
-      };
-      link.addEventListener('click', trigger, { passive: true });
-      link.addEventListener('focus', trigger, { passive: true });
-      link.addEventListener('mouseover', trigger, { passive: true });
-
-      wrapper.appendChild(link);
-    });
-
-    shadow.appendChild(wrapper);
-    document.body.appendChild(host);
-  },
-  /**
-   * Intercepte une réponse de challenge JSON, le résout, et réessaie la requête.
-   * @param {Response} response - La réponse initiale (potentiellement 429).
-   * @param {RequestInfo} resource - La ressource de la requête originale.
-   * @param {RequestInit} options - Les options de la requête originale.
-   * @returns {Promise<Response>} - La réponse de la requête réessayée.
-   * @private
-   */
-  async solveChallengeAndRetry(response, resource, options) {
-    if (response.status !== 404 || !response.headers.get('content-type')?.includes('application/json') || response.bodyUsed) {
-      return response;
-    }
-    
-    try {
-      const challengeData = await response.json();
-      if (!challengeData.challenge || !challengeData.challenge.type) {
-        return response; // Pas un challenge JSON valide
-      }
-
-      console.log(`[Fingerprint] Received a '${challengeData.challenge.type}' challenge. Solving...`);
-      this._dispatchEvent('challengeReceived', { challenge: challengeData.challenge });
-
-      // L'empreinte de l'appareil qui résout le challenge est cruciale.
-      const solverFp = this.getDeviceFingerprint();
-      const solutionWrapper = await solveChallenge(challengeData.challenge, solverFp);
-      console.log('[Fingerprint] Challenge solved. Retrying original request.');
-
-      this._dispatchEvent('challengeSolved', { solution: solutionWrapper.rawSolution });
-      // Ajouter la solution aux paramètres de la requête pour le nouvel essai
-      const url = new URL((resource instanceof Request) ? resource.url : String(resource), window.location.origin);
-      // La logique de formatage est maintenant cachée dans la classe ChallengeSolution.
-      solutionWrapper.applyToUrl(url);
-
-      // On ajoute l'empreinte du solveur à la requête de réessai.
-      url.searchParams.set('pow_fp', solverFp);
-
-      // On utilise la chaîne d'intercepteurs pour la requête réessayée,
-      // ce qui garantit que le fetch original est appelé avec le bon contexte.
-      // Cela évite de réintroduire l'erreur "Illegal invocation".
-      return window.fetch(url.toString(), options);
-    } catch (e) {
-      console.error('[Fingerprint] Failed to solve or retry challenge:', e);
-      return response; // Retourne la réponse 429 originale en cas d'échec
-    }
-  }, // <-- VIRGULE AJOUTÉE ICI
-
-/**
- * Initialise toutes les protections côté client en une seule fois.
- * Tente également de charger le module WASM si `wasmPath` est fourni.
- * C'est la méthode d'initialisation recommandée.
- * @param {ClientConfig} [config={}] - L'objet de configuration.
- */
-  initializeClient(config = {}) {
-    const {
-        mouse = true,
-        keystrokes = true,
-        clicks = true, // Add new option
-        touches = true, // Nouveau paramètre tactiles
-            rendering = true,
-            phantomTraps = true, // NOUVEAU
-        honeypots = [],
-        trapUrls = [], // Nouveau paramètre pour les URL pièges
-        wasmPath, // Nouveau paramètre
-        fetch: fetchConfig = {}
-    } = config;
-
-    // Tentative de chargement du WASM si le chemin est fourni
-    if (wasmPath) {
-        this.initializeWasm(wasmPath);
-    }
-
-    if (mouse) {
-        this.startMouseEntropyTracker();
-    }
-    if (keystrokes) {
-        this.startKeystrokeDynamicsTracker();
-    }
-    if (clicks) {
-        this.startClickTracker();
-    }
-    if (touches) {
-        this.startTouchEventTracker();
-    }
-        if (rendering) {
-            this.startRenderingTracker();
-        }
-        if (phantomTraps) {
-            this.injectPhantomTraps();
-        }
-    if (honeypots.length > 0) {
-        this.initializeHoneypots(honeypots);
-    }
-
-    // Injection dynamique des liens pièges au démarrage
-    if (trapUrls.length > 0) {
-        this.injectTrapLinks(trapUrls);
-    }
-    // On active l'interception si `fetch` est configuré, même avec un objet vide.
-    if (config.fetch) {
-        this.initializeFetch(fetchConfig.targetDomains);
-
-        // Ajoute l'intercepteur pour la résolution de challenge
-        if (fetchConfig.handleChallenges !== false) {
-            this.addFetchInterceptor(async (resource, options, next) => {
-                const originalResponse = await next(resource, options);
-                // On clone la réponse pour que la lecture du corps par solveChallengeAndRetry ne la consomme pas pour l'appelant original.
-                return this.solveChallengeAndRetry(originalResponse.clone(), resource, options);
-            });
-        }
-    }
-  },
-
-    /**
-     * Tente de charger et d'initialiser le module WebAssembly pour un hachage plus rapide.
-     * Si le chargement échoue, il se rabat silencieusement sur l'implémentation JS.
-     * @param {string} wasmPath - Le chemin vers le script de chargement du module WASM (ex: '/fp.js').
-     */
-    async initializeWasm(wasmPath) {
-        try {
-            // Direct standalone polymorphic WebAssembly loading
-            if (wasmPath.endsWith('.wasm')) {
-                const response = await fetch(wasmPath);
-                const arrayBuffer = await response.arrayBuffer();
-                const module = await WebAssembly.compile(arrayBuffer);
-                const instance = await WebAssembly.instantiate(module, {});
-                const exports = instance.exports;
-                const memory = exports.memory;
-                activeCyrb53 = (str) => {
-                    const encoder = new TextEncoder();
-                    const bytes = encoder.encode(str);
-                    const view = new Uint8Array(memory.buffer, 0, bytes.length);
-                    view.set(bytes);
-                    return exports.hash(0, bytes.length);
-                };
-                console.log('[Fingerprint] Standalone polymorphic WASM loaded successfully. Using fast dynamic hashing.');
-                if (this._cachedBuilder) {
-                    this._cachedBuilder.addRaw('wasm', 'true');
-                }
-                return;
-            }
-            // 1. Injecter le script qui charge le module WASM
-            const script = document.createElement('script');
-            script.src = wasmPath;
-            await new Promise((resolve, reject) => {
-                script.onload = resolve;
-                script.onerror = reject;
-                document.head.appendChild(script);
-            });
-
-            // 2. Attendre que la fonction globale `createFingerprintModule` soit disponible
-            if (typeof window.createFingerprintModule !== 'function') {
-                throw new Error('WASM loader script did not expose createFingerprintModule.');
-            }
-
-            // 3. Initialiser le module
-            const wasmUrl = wasmPath.replace(/\.js$/, '.wasm');
-            const wasmModule = await window.createFingerprintModule({
-                instantiateWasm: (imports, successCallback) => {
-                    (async () => {
-                        try {
-                            const cached = await getCachedWasm(wasmUrl);
-                            if (cached) {
-                                let instance;
-                                if (cached instanceof WebAssembly.Module) {
-                                    instance = await WebAssembly.instantiate(cached, imports);
-                                } else {
-                                    const result = await WebAssembly.instantiate(cached, imports);
-                                    instance = result.instance;
-                                }
-                                successCallback(instance, cached);
-                                return;
-                            }
-
-                            const response = await fetch(wasmUrl);
-                            const arrayBuffer = await response.arrayBuffer();
-
-                            let cachedData = arrayBuffer;
-                            let isModuleCached = false;
-                            try {
-                                const compiledModule = await WebAssembly.compile(arrayBuffer);
-                                const success = await cacheWasm(wasmUrl, compiledModule);
-                                if (success) {
-                                    cachedData = compiledModule;
-                                    isModuleCached = true;
-                                }
-                            } catch (e) {
-                                // Fallback if browser doesn't allow structured cloning of Compiled Modules
-                            }
-
-                            if (!isModuleCached) {
-                                await cacheWasm(wasmUrl, arrayBuffer);
-                            }
-
-                            let instance;
-                            if (cachedData instanceof WebAssembly.Module) {
-                                instance = await WebAssembly.instantiate(cachedData, imports);
-                            } else {
-                                const result = await WebAssembly.instantiate(arrayBuffer, imports);
-                                instance = result.instance;
-                            }
-                            successCallback(instance, cachedData);
-                        } catch (err) {
-                            console.warn('[Fingerprint] Custom WASM instantiation failed, falling back to default Emscripten loader:', err);
-                            successCallback(null);
-                        }
-                    })();
-                    return {}; // Async instantiation indicator for Emscripten
-                }
-            });
-            if (typeof wasmModule._hash_string !== 'function') {
-                throw new Error('WASM module did not export _hash_string.');
-            }
-        window.wasmModule = wasmModule;
-        ClientLibrary.wasmModule = wasmModule;
-
-            // 4. Remplacer la fonction de hachage par la version WASM
-            activeCyrb53 = (str) => {
-                // La fonction C++ attend un pointeur, Emscripten gère la conversion
-                return wasmModule._hash_string(str);
-            };
-
-            console.log('[Fingerprint] WASM module loaded successfully. Using fast hashing.');
-            // NOUVEAU: Ajoute un indicateur à l'empreinte pour que le serveur sache que le WASM est actif.
-            if (this._cachedBuilder) {
-                this._cachedBuilder.addRaw('wasm', 'true');
-            }
-        } catch (error) {
-            console.warn('[Fingerprint] WASM module failed to load. Falling back to JS implementation. Error:', error);
-        }
-    }
-};
-
-/**
- * @typedef {object} ClientBehaviorMetrics
- * @property {number} mouseEntropy - Entropie des mouvements de la souris.
- * @property {Array<{x: number, y: number, t: number}>} mouseMovementsHistory - Historique des points de la souris.
- * @property {number} keystrokeLatency - Latence moyenne entre les frappes.
- * @property {boolean} honeypotInteraction - Vrai si un honeypot a été touché.
- * @property {Array<{x: number, y: number, t: number, targetId: string}>} clicksHistory - Historique des clics.
- * @property {Array<{x: number, y: number, t: number, p: number, r: number, num: number}>} touchMovementsHistory - Historique des glissements tactiles.
- * @property {number} historyLength - La longueur de l'historique de session du navigateur (`window.history.length`).
- * @property {number} clientTimestamp - Timestamp (Date.now()) de la collecte des métriques.
- * @property {string[]} [trapUrls] - URLs pièges à injecter dynamiquement.
- */
-/** @type {ClientBehaviorMetrics} */
-const metrics = {
-    mouseEntropy: 0, // Conservé pour la compatibilité, mais l'analyse se fait maintenant sur l'historique
-    mouseMovementsHistory: [],
-    touchMovementsHistory: [],
-    clicksHistory: [],
-    keystrokeLatency: 0,
-    honeypotInteraction: false,
-    historyLength: 0,
-    clientTimestamp: 0,
-    rendering: { fps: 0, jitter: 0, offscreenAnom: false },
-};
-
-let lastMousePos = { x: 0, y: 0 };
-let mouseMovementsHistory = []; // NOUVEAU: Historique des points de la souris
-let touchMovementsHistory = []; // NOUVEAU: Historique des gestes tactiles
-const TOUCH_HISTORY_MAX = 100;
-const MOUSE_HISTORY_MAX = 100; // Limite le nombre de points stockés
-let clicksHistory = [];
-const CLICKS_HISTORY_MAX = 50;
-let activeHoneypotListeners = new Map(); // Garde une trace des écouteurs actifs
-let keystrokeTimestamps = [];
-let keystrokeLatencies = []; // NOUVEAU: Tableau dédié pour les latences
-let keystrokeDwellTimes = [];
-let keystrokeFlightTimes = [];
-const KEYSTROKE_HISTORY_MAX = 20; // On garde l'historique des 20 dernières frappes
-
-
-
-// Exporter les fonctions individuellement pour la compatibilité ascendante
-export const getDeviceFingerprint = ClientLibrary.getDeviceFingerprint.bind(ClientLibrary);
-export const generateRequestSignature = ClientLibrary.generateRequestSignature.bind(ClientLibrary);
-export const generateClientSideSignature = ClientLibrary.generateClientSideSignature.bind(ClientLibrary);
-export const _resetCache = ClientLibrary._resetCache.bind(ClientLibrary);
-export const startMouseEntropyTracker = ClientLibrary.startMouseEntropyTracker.bind(ClientLibrary);
-export const startKeystrokeDynamicsTracker = ClientLibrary.startKeystrokeDynamicsTracker.bind(ClientLibrary);
-export const startClickTracker = ClientLibrary.startClickTracker.bind(ClientLibrary);
-export const startTouchEventTracker = ClientLibrary.startTouchEventTracker.bind(ClientLibrary);
-export const startRenderingTracker = ClientLibrary.startRenderingTracker.bind(ClientLibrary);
-export const initializeHoneypots = ClientLibrary.initializeHoneypots.bind(ClientLibrary);
-export const getClientBehaviorMetrics = ClientLibrary.getClientBehaviorMetrics.bind(ClientLibrary);
-export const protectedFetch = ClientLibrary.protectedFetch.bind(ClientLibrary);
-export const addFetchInterceptor = ClientLibrary.addFetchInterceptor.bind(ClientLibrary);
-export const patchGlobalFetch = ClientLibrary.patchGlobalFetch.bind(ClientLibrary);
-export const initializeFetch = ClientLibrary.initializeFetch.bind(ClientLibrary);
-export const initializeClient = ClientLibrary.initializeClient.bind(ClientLibrary);
-export const initializeWasm = ClientLibrary.initializeWasm.bind(ClientLibrary);
-export const injectTrapLinks = ClientLibrary.injectTrapLinks.bind(ClientLibrary);
-export const injectPhantomTraps = ClientLibrary.injectPhantomTraps.bind(ClientLibrary);
-export const solveChallengeAndRetry = ClientLibrary.solveChallengeAndRetry.bind(ClientLibrary);
-export const generateZkpProof = ClientLibrary.generateZkpProof.bind(ClientLibrary);
-export const initializeSpace = ClientLibrary.initializeSpace.bind(ClientLibrary);
-export const readSpaceBlock = ClientLibrary.readSpaceBlock.bind(ClientLibrary);
-export const solveSpaceChallenge = ClientLibrary.solveSpaceChallenge.bind(ClientLibrary);
-
-// Export the internal object for testing purposes
-export default ClientLibrary;
-
-// --- Global Export for Browser ---
-// Attach the library to the window object to make it accessible from inline scripts.
-if (typeof window !== 'undefined') {
-    window.ClientLibrary = ClientLibrary;
+import {cyrb53 as jsCyrb53, FingerprintBuilder} from './fingerprint.builder.js';
+import {solveChallenge} from './pow.solver.js';
+
+// Variable pour stocker la fonction de hachage active.
+// Par défaut, c'est l'implémentation JavaScript.
+let activeCyrb53 = jsCyrb53;
+
+const DB_NAME = 'wasm-cache-db';
+const DB_VERSION = 1;
+const STORE_NAME = 'wasm-modules';
+
+const genRandStr = (len = 8) => {
+    return Array.from({ length: len }, () => String.fromCharCode(97 + Math.floor(Math.random() * 26))).join('');
+};
+
+function getCachedWasm(url) {
+    return new Promise((resolve) => {
+        if (typeof indexedDB === 'undefined') return resolve(null);
+        const request = indexedDB.open(DB_NAME, DB_VERSION);
+        request.onupgradeneeded = (e) => {
+            const db = e.target.result;
+            if (!db.objectStoreNames.contains(STORE_NAME)) {
+                db.createObjectStore(STORE_NAME);
+            }
+        };
+        request.onsuccess = (e) => {
+            const db = e.target.result;
+            try {
+                const transaction = db.transaction(STORE_NAME, 'readonly');
+                const store = transaction.objectStore(STORE_NAME);
+                const getReq = store.get(url);
+                getReq.onsuccess = () => resolve(getReq.result);
+                getReq.onerror = () => resolve(null);
+            } catch (err) {
+                resolve(null);
+            }
+        };
+        request.onerror = () => resolve(null);
+    });
+}
+
+function cacheWasm(url, data) {
+    return new Promise((resolve) => {
+        if (typeof indexedDB === 'undefined') return resolve(false);
+        const request = indexedDB.open(DB_NAME, DB_VERSION);
+        request.onupgradeneeded = (e) => {
+            const db = e.target.result;
+            if (!db.objectStoreNames.contains(STORE_NAME)) {
+                db.createObjectStore(STORE_NAME);
+            }
+        };
+        request.onsuccess = (e) => {
+            const db = e.target.result;
+            try {
+                const transaction = db.transaction(STORE_NAME, 'readwrite');
+                const store = transaction.objectStore(STORE_NAME);
+                store.put(data, url);
+                transaction.oncomplete = () => resolve(true);
+                transaction.onerror = () => resolve(false);
+            } catch (err) {
+                resolve(false);
+            }
+        };
+        request.onerror = () => resolve(false);
+    });
+}
+
+const ClientLibrary = {
+    // Cache pour éviter de recalculer les constantes (Hardware, etc.)
+    _cachedBuilder: null,
+    /**
+     * @private
+     * Dispatches a custom event from the window object.
+     * @param {string} eventName - The name of the event.
+     * @param {object} [detail={}] - The data to include in the event's detail property.
+     */
+    _dispatchEvent(eventName, detail = {}) {
+        if (typeof window === 'undefined' || typeof CustomEvent === 'undefined') return;
+        const event = new CustomEvent(`fingerprint:${eventName}`, { detail });
+        window.dispatchEvent(event);
+    },
+
+    /**
+     * Wrapper interne pour la fonction de hachage.
+     * @private
+     */
+    _hasher: (str, seed) => activeCyrb53(str, seed),
+
+    /**
+     * Génère une preuve de connaissance à divulgation nulle (ZKP) de Schnorr pour l'empreinte de l'appareil.
+     * Rend le tout stable et compatible avec les vérifications JS, PHP et Python.
+     * @param {string} fingerprint - L'empreinte de l'appareil.
+     * @returns {Promise<string>} La preuve sous format "y:t:s" en hexadécimal.
+     */
+    async generateZkpProof(fingerprint) {
+        const ZKP_P = 115792089237316195423570985008687907853269984665640564039457584007908834671663n;
+        const ZKP_G = 2n;
+        const cryptoObj = window.crypto || window.msCrypto;
+
+        const sha256Hex = async (str) => {
+            const encoder = new TextEncoder();
+            const data = encoder.encode(str);
+            const hashBuffer = await cryptoObj.subtle.digest('SHA-256', data);
+            const hashArray = Array.from(new Uint8Array(hashBuffer));
+            return hashArray.map(b => b.toString(16).padStart(2, '0')).join('');
+        };
+
+        const modPow = (base, exponent, modulus) => {
+            if (modulus === 1n) return 0n;
+            let result = 1n;
+            base = base % modulus;
+            while (exponent > 0n) {
+                if (exponent % 2n === 1n) {
+                    result = (result * base) % modulus;
+                }
+                exponent = exponent >> 1n;
+                base = (base * base) % modulus;
+            }
+            return result;
+        };
+
+        const xHex = await sha256Hex(fingerprint);
+        const x = BigInt('0x' + xHex) % ZKP_P;
+        const y = modPow(ZKP_G, x, ZKP_P);
+        const randomBytes = new Uint8Array(32);
+        cryptoObj.getRandomValues(randomBytes);
+        let vHex = Array.from(randomBytes).map(b => b.toString(16).padStart(2, '0')).join('');
+        let v = BigInt('0x' + vHex) % (ZKP_P - 1n);
+        if (v === 0n) v = 1n;
+        const t = modPow(ZKP_G, v, ZKP_P);
+        const cStr = ZKP_G.toString() + y.toString() + t.toString();
+        const cHex = await sha256Hex(cStr);
+        const c = BigInt('0x' + cHex) % ZKP_P;
+        const s = (v + c * x) % (ZKP_P - 1n);
+
+        return `${y.toString(16)}:${t.toString(16)}:${s.toString(16)}`;
+    },
+
+    /**
+     * Génère l'empreinte de l'appareil actuel.
+     */
+    getDeviceFingerprint() {
+        if (typeof window === "undefined") {
+            console.error("getDeviceFingerprint can only be called on the client-side.");
+            return "";
+        }
+        
+        if (!this._cachedBuilder) {
+            const nav = window.navigator;
+            const screen = window.screen;
+
+            this._cachedBuilder = new FingerprintBuilder();
+
+            // 1. Hardware (Très stable) : Cœurs, RAM, GPU (si dispo via canvas), Touch
+            this._cachedBuilder.add(
+                "hw", // Utilise maintenant le hasher actif
+                `${nav.hardwareConcurrency}_${nav.deviceMemory}_${nav.maxTouchPoints}`,
+            );
+
+            // 2. Geo/Locale (Stable sauf voyage/VPN) : Timezone, Langue
+            this._cachedBuilder.add(
+                "geo",
+                `${Intl.DateTimeFormat().resolvedOptions().timeZone}_${nav.language}_${new Date().getTimezoneOffset()}`,
+            );
+
+            // 3. Screen (Stable sauf changement moniteur/zoom) : Dimensions, ColorDepth
+            this._cachedBuilder.add(
+                "scr",
+                `${screen.width}x${screen.height}_${screen.colorDepth}`,
+            );
+
+            // 4. Platform (Stable) : OS, Engine
+            this._cachedBuilder.add("os", nav.platform);
+
+            // 5. Graphics (WebGL Vendor/Renderer) - Invariant matériel fort
+            try {
+                const canvas = document.createElement("canvas");
+                const gl =
+                    canvas.getContext("webgl2") ||
+                    canvas.getContext("webgl") ||
+                    canvas.getContext("experimental-webgl");
+                if (gl) {
+                    const debugInfo = gl.getExtension("WEBGL_debug_renderer_info");
+                    if (debugInfo) {
+                        const vendor = gl.getParameter(debugInfo.UNMASKED_VENDOR_WEBGL);
+                        const renderer = gl.getParameter(debugInfo.UNMASKED_RENDERER_WEBGL);
+                        this._cachedBuilder.add("gpu", `${vendor}_${renderer}`);
+                    }
+                }
+            } catch (e) {
+            }
+
+            // 6. Canvas Fingerprinting (Rendering quirks)
+            try {
+                const canvas = document.createElement("canvas");
+                const ctx = canvas.getContext("2d");
+                if (ctx) {
+                    canvas.width = 200;
+                    canvas.height = 50;
+                    ctx.textBaseline = "alphabetic";
+                    ctx.font = "14px 'Arial'";
+                    ctx.fillStyle = "#f60";
+                    ctx.fillRect(125, 1, 62, 20);
+                    ctx.fillStyle = "#069";
+                    ctx.fillText("fingerprint", 2, 15);
+                    ctx.fillStyle = "rgba(102, 204, 0, 0.7)";
+                    ctx.fillText("fingerprint", 4, 17);
+                    this._cachedBuilder.add("cvs", canvas.toDataURL());
+                }
+            } catch (e) {
+            }
+
+            // 7. Détection des artefacts du Chrome DevTools Protocol (CDP)
+            // Ces variables sont souvent injectées par les outils d'automatisation.
+            const cdpFootprints = [
+                'cdc_adoQpoasnfa76pfcZLmcfl_Array',
+                'cdc_adoQpoasnfa76pfcZLmcfl_Promise',
+                'cdc_adoQpoasnfa76pfcZLmcfl_Symbol',
+                '$cdc_asdjflasutopfhvcZLmcfl_',
+                '_selenium',
+                '_driver'
+            ];
+            if (cdpFootprints.some(fp => window[fp])) {
+                this._cachedBuilder.add("cdp", "true");
+            }
+
+            // 7. Bot Detection (Indication cachée)
+            if (nav.webdriver) this._cachedBuilder.add("bot", "true");
+        }
+
+        return this._cachedBuilder.toString();
+    },
+
+    /**
+     * Génère une signature de requête incluant le contexte.
+     * @param {object} payload
+     */
+    /**
+     * Génère une signature de requête incluant le contexte.
+     * @param {object} payload
+     */
+    generateRequestSignature(payload = {}) {
+        const deviceFp = this.getDeviceFingerprint();
+        const sortedPayload = Object.keys(payload)
+            .sort()
+            .map((k) => `${k}=${payload[k]}`)
+            .join("&");
+        const payloadHash = this._hasher(sortedPayload);
+        return `${deviceFp}|req:${payloadHash}`;
+    },
+
+    /**
+     * Génère une signature HMAC-SHA256 en utilisant l'API Web Crypto.
+     * @param {object} payload - Les données à signer.
+     * @param {string} secret - La clé secrète partagée.
+     * @returns {Promise<string>} La signature hexadécimale.
+     */
+    async generateClientSideSignature(payload, secret) {
+        const sortedPayload = Object.keys(payload).sort().map((k) => `${k}=${payload[k]}`).join("&");
+        const encoder = new TextEncoder();
+        const key = await window.crypto.subtle.importKey("raw", encoder.encode(secret), {
+            name: "HMAC",
+            hash: "SHA-256"
+        }, false, ["sign"]);
+        const signatureBuffer = await window.crypto.subtle.sign("HMAC", key, encoder.encode(sortedPayload));
+        const hashArray = Array.from(new Uint8Array(signatureBuffer));
+        return hashArray.map((b) => b.toString(16).padStart(2, "0")).join("");
+    },
+
+    /**
+     * @internal
+     * Resets the cached fingerprint builder. Used for testing purposes.
+     */
+    _resetCache() {
+        // Réinitialise le hasher à l'implémentation JS par défaut.
+        activeCyrb53 = jsCyrb53;
+        this._cachedBuilder = null;
+    },
+
+    /**
+     * Injecte des éléments interactifs fantômes invisibles pour piéger les bots (focus/hover).
+     */
+    injectPhantomTraps() {
+        if (typeof document === 'undefined') return;
+
+        // Création d'un élément interactif fantôme
+        const phantom = document.createElement('a');
+        phantom.href = '#';
+        // Nom trompeur aléatoire pour attirer les analyseurs automatiques de liens / formulaires
+        const phantomNames = ['sys-session-recovery', 'auth-token-refresh', 'debug-console-login', 'admin-portal-access', 'security-bypass-bypass', 'recovery-key-session', 'api-key-test', 'client-secrets-access'];
+        phantom.id = phantomNames[Math.floor(Math.random() * phantomNames.length)] + '-' + genRandStr(6);
+        phantom.className = genRandStr(8);
+        phantom.tabIndex = 0; // Dans le flux naturel de tabulation
+        phantom.setAttribute('aria-hidden', 'true'); // Masqué pour les screen readers légitimes
+
+        // Style invisible mais interactif (1px x 1px, presque transparent)
+        phantom.style.position = 'fixed';
+        phantom.style.top = '1px';
+        phantom.style.left = '1px';
+        phantom.style.width = '1px';
+        phantom.style.height = '1px';
+        phantom.style.opacity = '0.001';
+        phantom.style.zIndex = '99999';
+        phantom.style.overflow = 'hidden';
+        phantom.style.pointerEvents = 'auto';
+
+        const triggerTrap = () => {
+            this.onHoneypotTrigger();
+        };
+
+        phantom.addEventListener('focus', triggerTrap, { passive: true });
+        phantom.addEventListener('mouseover', triggerTrap, { passive: true });
+
+        // Imbrication polymorphique du piège fantôme dans le corps du document
+        const nestingOptions = [
+            () => document.body.appendChild(phantom),
+            () => {
+                const wrapper = document.createElement(Math.random() > 0.5 ? 'span' : 'div');
+                wrapper.className = genRandStr(8);
+                wrapper.style.position = 'absolute';
+                wrapper.style.width = '0';
+                wrapper.style.height = '0';
+                wrapper.style.overflow = 'hidden';
+                wrapper.appendChild(phantom);
+                document.body.appendChild(wrapper);
+            }
+        ];
+        nestingOptions[Math.floor(Math.random() * nestingOptions.length)]();
+    },
+
+    /**
+     * Démarre le suivi des événements tactiles sur mobile/tablette.
+     */
+    startTouchEventTracker() {
+        if (this._touchTrackerAttached) return;
+        this._touchTrackerAttached = true;
+
+        const handleTouch = (e) => {
+            if (touchMovementsHistory.length >= TOUCH_HISTORY_MAX) {
+                touchMovementsHistory.shift();
+            }
+            const touch = e.touches[0] || e.changedTouches[0];
+            if (!touch) return;
+
+            const radiusX = touch.radiusX || 0;
+            const radiusY = touch.radiusY || 0;
+            const radius = (radiusX + radiusY) / 2;
+            const force = touch.force || touch.webkitForce || 0;
+
+            touchMovementsHistory.push({
+                x: touch.clientX,
+                y: touch.clientY,
+                t: performance.now(),
+                p: force,
+                r: radius,
+                num: e.touches.length
+            });
+        };
+
+        document.addEventListener('touchstart', handleTouch, { passive: true });
+        document.addEventListener('touchmove', handleTouch, { passive: true });
+        document.addEventListener('touchend', handleTouch, { passive: true });
+    },
+
+    /**
+     * Démarre le suivi de la régularité d'affichage (V-Sync/rAF) pour détecter les framebuffers logiciels sans V-Sync.
+     */
+    startRenderingTracker() {
+        if (this._renderingTrackerAttached) return;
+        this._renderingTrackerAttached = true;
+
+        if (typeof window === 'undefined' || !window.requestAnimationFrame) return;
+
+        const rAfTimestamps = [];
+        let lastTime = performance.now();
+        const maxSamples = 15;
+
+        const checkOffscreenAnom = () => {
+            try {
+                if ('OffscreenCanvas' in window && HTMLCanvasElement.prototype.transferControlToOffscreen) {
+                    const nativeToString = Function.prototype.toString.call(HTMLCanvasElement.prototype.transferControlToOffscreen);
+                    return !nativeToString.includes('[native code]');
+                }
+            } catch (e) {}
+            return false;
+        };
+
+        const loop = (time) => {
+            const delta = time - lastTime;
+            lastTime = time;
+            if (rAfTimestamps.length < maxSamples) {
+                if (rAfTimestamps.length > 0) { // Skip first delta
+                    rAfTimestamps.push(delta);
+                }
+                window.requestAnimationFrame(loop);
+            } else {
+                const avg = rAfTimestamps.reduce((a, b) => a + b, 0) / rAfTimestamps.length;
+                const sqDiffs = rAfTimestamps.map(v => Math.pow(v - avg, 2));
+                const avgSqDiff = sqDiffs.reduce((a, b) => a + b, 0) / sqDiffs.length;
+                
+                metrics.rendering = {
+                    fps: Math.round((1000 / avg) * 100) / 100,
+                    jitter: Math.round(Math.sqrt(avgSqDiff) * 100) / 100,
+                    offscreenAnom: checkOffscreenAnom()
+                };
+            }
+        };
+        window.requestAnimationFrame(loop);
+    },
+
+    /**
+     * Initialise l'espace Proof-of-Space persistant dans l'IndexedDB locale.
+     */
+    async initializeSpace(seed, sizeMb) {
+        return new Promise((resolve, reject) => {
+            const request = indexedDB.open('pospace-db', 1);
+            request.onupgradeneeded = (e) => {
+                const db = e.target.result;
+                if (!db.objectStoreNames.contains('blocks')) {
+                    db.createObjectStore('blocks');
+                }
+            };
+            request.onsuccess = async (e) => {
+                const db = e.target.result;
+                const tx = db.transaction('blocks', 'readwrite');
+                const store = tx.objectStore('blocks');
+                
+                const maxBlocks = sizeMb * 1024;
+                const countReq = store.count();
+                countReq.onsuccess = async () => {
+                    if (countReq.result < maxBlocks) {
+                        for (let i = 0; i < maxBlocks; i++) {
+                            const block = new Uint8Array(1024);
+                            let h = 5381;
+                            for (let j = 0; j < seed.length; j++) {
+                                h = (h << 5) + h + seed.charCodeAt(j);
+                            }
+                            h = (h << 5) + h + i;
+                            for (let k = 0; k < 1024; k++) {
+                                h = Math.imul(h ^ k, 1597334677);
+                                block[k] = h & 0xff;
+                            }
+                            store.put(block, i);
+                        }
+                    }
+                    resolve();
+                };
+            };
+            request.onerror = () => reject(new Error("Failed to open pospace database"));
+        });
+    },
+
+    /**
+     * Lit un bloc spécifique de l'IndexedDB locale sous format hexadécimal.
+     */
+    async readSpaceBlock(blockIdx) {
+        return new Promise((resolve, reject) => {
+            const request = indexedDB.open('pospace-db', 1);
+            request.onsuccess = (e) => {
+                const db = e.target.result;
+                const tx = db.transaction('blocks', 'readonly');
+                const store = tx.objectStore('blocks');
+                const getReq = store.get(blockIdx);
+                getReq.onsuccess = () => {
+                    const block = getReq.result;
+                    if (block) {
+                        const hex = Array.from(block).map(b => b.toString(16).padStart(2, '0')).join('');
+                        resolve(hex);
+                    } else {
+                        reject(new Error("Block not found"));
+                    }
+                };
+                getReq.onerror = () => reject(getReq.error);
+            };
+            request.onerror = () => reject(new Error("Failed to open pospace database"));
+        });
+    },
+
+    /**
+     * Résout le Proof-of-Space en combinant optionnellement le bloc du pair.
+     */
+    async solveSpaceChallenge(seed, queries, nonce, clientSecret, peerBlock = '') {
+        const blocks = [];
+        for (const idx of queries) {
+            const blockHex = await this.readSpaceBlock(idx);
+            blocks.push(blockHex);
+        }
+        let finalPayload = blocks.join('') + peerBlock + nonce + ":" + clientSecret;
+        const encoder = new TextEncoder();
+        const data = encoder.encode(finalPayload);
+        const hashBuffer = await window.crypto.subtle.digest('SHA-256', data);
+        const hashArray = Array.from(new Uint8Array(hashBuffer));
+        return hashArray.map(b => b.toString(16).padStart(2, '0')).join('');
+    },
+
+    /**
+     * Démarre le suivi des mouvements de la souris pour calculer l'entropie.
+     * À appeler une fois sur la page.
+     */
+    startMouseEntropyTracker() {
+        // Utiliser un drapeau pour éviter d'attacher l'écouteur plusieurs fois
+        if (this._mouseTrackerAttached) return;
+        this._mouseTrackerAttached = true;
+ 
+        document.addEventListener('mousemove', (e) => {
+            // NOUVEAU: Capturer une série de points {x, y, t}
+            if (mouseMovementsHistory.length >= MOUSE_HISTORY_MAX) {
+                // Garder la taille de l'historique constante pour éviter une consommation mémoire excessive.
+                mouseMovementsHistory.shift();
+            }
+            mouseMovementsHistory.push({
+                x: e.clientX,
+                y: e.clientY,
+                t: performance.now()
+            });
+        }, {passive: true});
+    },
+
+    /**
+     * Démarre le suivi de la dynamique de frappe pour calculer le dwell time et le flight time (digraphie/trigraphie).
+     * À appeler une fois sur la page.
+     */
+    startKeystrokeDynamicsTracker() {
+        // S'assurer de ne pas attacher l'écouteur plusieurs fois
+        if (this._keystrokeTrackerAttached) return;
+        this._keystrokeTrackerAttached = true;
+
+        const activeKeys = new Map();
+        let lastKeyDownTime = 0;
+        let lastKeyName = '';
+
+        document.addEventListener('keydown', (e) => {
+            const now = performance.now();
+            const key = e.key;
+            const code = e.code;
+            if (!key && !code) return;
+
+            const keyIdentifier = code || key;
+
+            // Prevent key repeat triggering multiple events
+            if (activeKeys.has(keyIdentifier)) return;
+            activeKeys.set(keyIdentifier, now);
+
+            if (keystrokeTimestamps.length > 0) {
+                const lastTimestamp = keystrokeTimestamps[keystrokeTimestamps.length - 1];
+                const latency = now - lastTimestamp;
+                if (latency > 10 && latency < 2000) {
+                    if (keystrokeLatencies.length >= KEYSTROKE_HISTORY_MAX) {
+                        keystrokeLatencies.shift();
+                    }
+                    keystrokeLatencies.push(latency);
+                }
+            }
+            keystrokeTimestamps.push(now);
+
+            // Flight Time (KeyDown to KeyDown)
+            if (lastKeyDownTime > 0) {
+                const flightTime = now - lastKeyDownTime;
+                if (flightTime > 10 && flightTime < 2000) {
+                    if (keystrokeFlightTimes.length >= KEYSTROKE_HISTORY_MAX) {
+                        keystrokeFlightTimes.shift();
+                    }
+                    const digraph = lastKeyName ? this._hasher(lastKeyName + "_" + keyIdentifier).toString() : "unknown";
+                    keystrokeFlightTimes.push({ digraph, time: flightTime });
+                }
+            }
+            lastKeyDownTime = now;
+            lastKeyName = keyIdentifier;
+        }, {passive: true});
+
+        document.addEventListener('keyup', (e) => {
+            const now = performance.now();
+            const key = e.key;
+            const code = e.code;
+            if (!key && !code) return;
+
+            const keyIdentifier = code || key;
+
+            if (activeKeys.has(keyIdentifier)) {
+                const pressTime = activeKeys.get(keyIdentifier);
+                const dwellTime = now - pressTime;
+                activeKeys.delete(keyIdentifier);
+
+                if (dwellTime > 5 && dwellTime < 1000) {
+                    if (keystrokeDwellTimes.length >= KEYSTROKE_HISTORY_MAX) {
+                        keystrokeDwellTimes.shift();
+                    }
+                    keystrokeDwellTimes.push(dwellTime);
+                }
+            }
+        }, {passive: true});
+    },
+
+    /**
+     * Starts tracking click events to analyze position variance.
+     * @private
+     */
+    startClickTracker() {
+        if (this._clickTrackerAttached) return;
+        this._clickTrackerAttached = true;
+
+        document.addEventListener('click', (e) => {
+            if (clicksHistory.length >= CLICKS_HISTORY_MAX) {
+                clicksHistory.shift();
+            }
+            // Generate a simple identifier for the target element
+            const target = e.target;
+            const targetId = target.id || target.name || target.tagName;
+
+            clicksHistory.push({
+                x: e.clientX,
+                y: e.clientY,
+                t: performance.now(),
+                targetId: this._hasher(targetId) // Hash the ID to keep it short and consistent
+            });
+        }, { passive: true });
+    },
+    /**
+     * Initialise ou réinitialise les honeypots côté client pour une détection immédiate.
+     * Les anciens écouteurs sont supprimés avant d'en ajouter de nouveaux.
+     * @param {string[]} honeypotFieldNames - Noms des champs de formulaire cachés.
+     */
+    initializeHoneypots(honeypotFieldNames) {
+        // 1. Nettoyer les anciens écouteurs
+        activeHoneypotListeners.forEach((listener, field) => {
+            field.removeEventListener('input', listener);
+        });
+        activeHoneypotListeners.clear();
+
+        // 2. Ajouter les nouveaux écouteurs sur le DOM classique
+        honeypotFieldNames.forEach(fieldName => {
+            const field = document.querySelector(`[name="${fieldName}"]`);
+            if (field) {
+                const listener = () => {
+                    this.onHoneypotTrigger();
+                    field.removeEventListener('input', listener);
+                };
+                field.addEventListener('input', listener);
+                activeHoneypotListeners.set(field, listener); // On stocke la référence
+            }
+        });
+
+        // 3. Générer des champs d'input pièges masqués dans un Shadow DOM fermé
+        if (typeof document !== 'undefined' && honeypotFieldNames.length > 0) {
+            const host = document.createElement('div');
+            host.setAttribute('aria-hidden', 'true');
+            host.style.position = 'absolute';
+            host.style.width = '0';
+            host.style.height = '0';
+            host.style.overflow = 'hidden';
+
+            const shadow = host.attachShadow({ mode: 'closed' });
+
+            // Aléatisation des classes, variables CSS et balises de structure
+            const wrapperClass = genRandStr(10);
+            const posStateVar = `--${genRandStr(8)}`;
+            const offValVar = `--${genRandStr(8)}`;
+            const visStateVar = `--${genRandStr(8)}`;
+            const scaleValVar = `--${genRandStr(8)}`;
+
+            const style = document.createElement('style');
+            style.textContent = `
+              :host {
+                ${posStateVar}: absolute;
+                ${offValVar}: -9999px;
+                ${visStateVar}: hidden;
+                ${scaleValVar}: 0;
+              }
+              .${wrapperClass} {
+                position: var(${posStateVar});
+                left: var(${offValVar});
+                top: var(${offValVar});
+                visibility: var(${visStateVar});
+                transform: scale(var(${scaleValVar}));
+              }
+            `;
+            shadow.appendChild(style);
+
+            const wrapperTags = ['div', 'section', 'p', 'span', 'form', 'main'];
+            const selectedWrapperTag = wrapperTags[Math.floor(Math.random() * wrapperTags.length)];
+            const wrapper = document.createElement(selectedWrapperTag);
+            wrapper.className = wrapperClass;
+
+            honeypotFieldNames.forEach(fieldName => {
+                const label = document.createElement('label');
+                label.textContent = fieldName;
+                const input = document.createElement('input');
+                input.type = 'text';
+                input.name = fieldName;
+                input.tabIndex = -1;
+                input.className = genRandStr(6);
+                input.id = genRandStr(8);
+                input.autocomplete = 'off';
+
+                const trigger = () => {
+                    this.onHoneypotTrigger();
+                };
+
+                input.addEventListener('input', trigger, { passive: true });
+                input.addEventListener('change', trigger, { passive: true });
+                input.addEventListener('focus', trigger, { passive: true });
+
+                // Imbrication polymorphique du label et de l'input
+                const nestingType = Math.floor(Math.random() * 3);
+                if (nestingType === 1) {
+                    label.appendChild(input);
+                    wrapper.appendChild(label);
+                } else if (nestingType === 2) {
+                    const innerContainer = document.createElement(Math.random() > 0.5 ? 'span' : 'div');
+                    innerContainer.className = genRandStr(5);
+                    innerContainer.appendChild(label);
+                    innerContainer.appendChild(input);
+                    wrapper.appendChild(innerContainer);
+                } else {
+                    wrapper.appendChild(label);
+                    wrapper.appendChild(input);
+                }
+            });
+
+            shadow.appendChild(wrapper);
+            document.body.appendChild(host);
+        }
+    },
+
+    /**
+     * Récupère les métriques comportementales collectées.
+     * À appeler avant d'envoyer une requête sensible.
+     * @returns {ClientBehaviorMetrics}
+     */
+    getClientBehaviorMetrics() {
+        // Add history length as a behavioral signal.
+        metrics.historyLength = window.history.length;
+
+        // Ajoute un timestamp au moment de la collecte pour la détection de rejeu.
+        metrics.clicksHistory = clicksHistory;
+        metrics.clientTimestamp = Date.now();
+
+        metrics.touchMovementsHistory = touchMovementsHistory;
+        // NOUVEAU: Inclure l'historique des mouvements de la souris pour une analyse côté serveur.
+        metrics.mouseMovementsHistory = mouseMovementsHistory;
+
+        // NOUVEAU: Keystroke dynamics metrics (dwell and flight times)
+        metrics.keystrokeDwellTimes = keystrokeDwellTimes;
+        metrics.keystrokeFlightTimes = keystrokeFlightTimes;
+
+        // Calcule la latence moyenne des frappes
+        if (keystrokeLatencies.length > 0) {
+            const sum = keystrokeLatencies.reduce((a, b) => a + b, 0);
+            metrics.keystrokeLatency = sum / keystrokeLatencies.length;
+        } else {
+            metrics.keystrokeLatency = 0;
+        }
+        return metrics;
+    },
+
+    /**
+     * Enrichit une requête fetch avec les en-têtes de fingerprinting et de comportement.
+     * @param {RequestInfo} resource
+     * @param {RequestInit} [options]
+     * @returns {Promise<Response>}
+     */
+    async protectedFetch(resource, options = {}) {
+        const fp = this.getDeviceFingerprint();
+        const behavior = this.getClientBehaviorMetrics();
+
+        const headers = new Headers(options.headers || {});
+        headers.set('X-Device-Fingerprint', fp);
+        headers.set('X-Behavior-Metrics', JSON.stringify(behavior));
+
+        options.headers = headers;
+        return fetch(resource, options);
+    },
+
+// --- Système d'interception de Fetch robuste et anti-conflit ---
+
+    _isFetchPatched: false,
+    _interceptorChain: [],
+    // On stocke la fonction fetch originale et on la lie à son contexte (window)
+    // pour éviter les erreurs "Illegal invocation" si une autre lib la modifie.
+    _originalFetch: (typeof window !== 'undefined') ? window.fetch.bind(window) : null,
+
+/**
+ * Adds an interceptor function to the `fetch` chain.
+ * Chaque intercepteur reçoit `resource`, `options`, et une fonction `next`.
+ * Il DOIT appeler `next(resource, options)` pour continuer la chaîne.
+ * @param {function(RequestInfo, RequestInit, function): Promise<Response>} interceptor
+ */
+  addFetchInterceptor(interceptor) {
+    if (!this._isFetchPatched) {
+        this.patchGlobalFetch();
+    }
+    this._interceptorChain.push(interceptor);
+  },
+
+  patchGlobalFetch() {
+    if (this._isFetchPatched || !this._originalFetch) return;
+
+    this._isFetchPatched = true;
+    window.fetch = (resource, options) => {
+        // Le "dispatcher" qui exécute la chaîne.
+        const dispatch = (index, res, opts) => {
+            if (index >= this._interceptorChain.length) {
+                // Fin de la chaîne, on appelle le fetch original.
+                return this._originalFetch(res, opts);
+            }
+            const nextInterceptor = this._interceptorChain[index];
+            // Appelle l'intercepteur actuel en lui passant la fonction pour appeler le suivant.
+            return nextInterceptor(res, opts, (nextRes, nextOpts) => dispatch(index + 1, nextRes, nextOpts));
+        };
+        return dispatch(0, resource, options || {});
+    };
+  },
+
+    /**
+     * La fonction qui est appelée lorsqu'un honeypot est déclenché.
+     * @private
+     */
+    onHoneypotTrigger() {
+        metrics.honeypotInteraction = true;
+        // Émettre un événement pour que l'application puisse réagir.
+        this._dispatchEvent('honeypotTriggered');
+    },
+
+  /**
+   * Initialise l'intercepteur de fingerprinting.
+   * Il s'ajoute à la chaîne d'interception sans écraser les autres.
+   * @param {string[]} [targetDomains] - Optionnel. Liste de domaines à protéger.
+   * Si non fourni, protège les requêtes de même origine.
+   */
+  initializeFetch(targetDomains = []) {
+    const fingerprintInterceptor = (resource, options, next) => {        
+        const requestUrl = (resource instanceof Request) ? resource.url : String(resource);        
+        let shouldProtect = false;
+
+        try {
+            const url = new URL(requestUrl, window.location.origin);
+            // Protéger si la liste de domaines est vide ET que la requête est de même origine,
+            // OU si le domaine de la requête est dans la liste fournie.
+            shouldProtect = (targetDomains.length === 0 && url.origin === window.location.origin) || 
+                            (targetDomains.length > 0 && targetDomains.includes(url.hostname));
+        } catch (e) {
+            // Si l'URL est relative (ex: '/api/data'), new URL() ne lèvera pas d'erreur.
+            // Ce bloc est une sécurité pour les cas où l'URL serait malformée.
+            // On protège par défaut si aucune liste de domaines n'est spécifiée.
+            shouldProtect = targetDomains.length === 0;
+        }
+
+        if (shouldProtect) {
+            const fp = this.getDeviceFingerprint();
+            const behavior = this.getClientBehaviorMetrics();
+            const headers = new Headers(options.headers || {});
+            headers.set('X-Device-Fingerprint', fp);
+            headers.set('X-Behavior-Metrics', JSON.stringify(behavior));
+            options.headers = headers;
+        }
+
+        // Passe la main à l'intercepteur suivant dans la chaîne.
+        return next(resource, options);
+    };
+
+    this.addFetchInterceptor(fingerprintInterceptor);
+  }, // <-- VIRGULE AJOUTÉE ICI
+  
+  /**
+   * Injects visually hidden "honeypot" links into the DOM to trap bots.
+   * @param {string[]} urls - An array of trap URLs to inject.
+   * @private
+   */
+  injectTrapLinks(urls) {
+    if (!urls || urls.length === 0 || typeof document === 'undefined') {
+      return;
+    }
+
+    const host = document.createElement('div');
+    host.setAttribute('aria-hidden', 'true');
+    host.style.position = 'absolute';
+    host.style.width = '0';
+    host.style.height = '0';
+    host.style.overflow = 'hidden';
+
+    const shadow = host.attachShadow({ mode: 'closed' });
+
+        // Aléatisation des classes, variables CSS et balises de structure
+        const wrapperClass = genRandStr(10);
+        const layoutPosVar = `--${genRandStr(8)}`;
+        const offsetValVar = `--${genRandStr(8)}`;
+        const visibilityStateVar = `--${genRandStr(8)}`;
+        const scaleFactorVar = `--${genRandStr(8)}`;
+        const ptrEventsVar = `--${genRandStr(8)}`;
+        const linkColorClass = genRandStr(6);
+
+    const style = document.createElement('style');
+    style.textContent = `
+      :host {
+            ${layoutPosVar}: absolute;
+            ${offsetValVar}: -9999px;
+            ${visibilityStateVar}: hidden;
+            ${scaleFactorVar}: 0;
+            ${ptrEventsVar}: none;
+      }
+          .${wrapperClass} {
+            position: var(${layoutPosVar});
+            left: var(${offsetValVar});
+            top: var(${offsetValVar});
+            visibility: var(${visibilityStateVar});
+            transform: scale(var(${scaleFactorVar}));
+            pointer-events: var(${ptrEventsVar});
+      }
+          .${linkColorClass} {
+        color: transparent;
+        text-decoration: none;
+      }
+    `;
+    shadow.appendChild(style);
+
+        const wrapperTags = ['div', 'section', 'p', 'span', 'nav', 'aside'];
+        const selectedWrapperTag = wrapperTags[Math.floor(Math.random() * wrapperTags.length)];
+        const wrapper = document.createElement(selectedWrapperTag);
+        wrapper.className = wrapperClass;
+
+    urls.forEach((url, i) => {
+      const link = document.createElement('a');
+      link.href = url;
+      link.rel = 'nofollow';
+      link.tabIndex = -1;
+          link.className = linkColorClass;
+          link.id = genRandStr(8);
+
+          // Structure interne polymorphique du lien
+          const contentNestingType = Math.floor(Math.random() * 3);
+          if (contentNestingType === 1) {
+              const span = document.createElement('span');
+              span.className = genRandStr(5);
+              span.innerHTML = `&gt; ${i + 1}`;
+              link.appendChild(span);
+          } else if (contentNestingType === 2) {
+              const b = document.createElement('b');
+              b.className = genRandStr(5);
+              b.innerHTML = `&gt; ${i + 1}`;
+              link.appendChild(b);
+          } else {
+              link.innerHTML = `<span>&gt; ${i + 1}</span>`;
+          }
+
+      const trigger = () => {
+        this.onHoneypotTrigger();
+      };
+      link.addEventListener('click', trigger, { passive: true });
+      link.addEventListener('focus', trigger, { passive: true });
+      link.addEventListener('mouseover', trigger, { passive: true });
+
+          // Imbrication du lien de manière polymorphique
+          if (Math.random() > 0.5) {
+              const itemContainer = document.createElement('span');
+              itemContainer.className = genRandStr(5);
+              itemContainer.appendChild(link);
+              wrapper.appendChild(itemContainer);
+          } else {
+              wrapper.appendChild(link);
+          }
+    });
+
+    shadow.appendChild(wrapper);
+    document.body.appendChild(host);
+  },
+  /**
+   * Intercepte une réponse de challenge JSON, le résout, et réessaie la requête.
+   * @param {Response} response - La réponse initiale (potentiellement 429).
+   * @param {RequestInfo} resource - La ressource de la requête originale.
+   * @param {RequestInit} options - Les options de la requête originale.
+   * @returns {Promise<Response>} - La réponse de la requête réessayée.
+   * @private
+   */
+  async solveChallengeAndRetry(response, resource, options) {
+    if (response.status !== 404 || !response.headers.get('content-type')?.includes('application/json') || response.bodyUsed) {
+      return response;
+    }
+    
+    try {
+      const challengeData = await response.json();
+      if (!challengeData.challenge || !challengeData.challenge.type) {
+        return response; // Pas un challenge JSON valide
+      }
+
+      console.log(`[Fingerprint] Received a '${challengeData.challenge.type}' challenge. Solving...`);
+      this._dispatchEvent('challengeReceived', { challenge: challengeData.challenge });
+
+      // L'empreinte de l'appareil qui résout le challenge est cruciale.
+      const solverFp = this.getDeviceFingerprint();
+      const solutionWrapper = await solveChallenge(challengeData.challenge, solverFp);
+      console.log('[Fingerprint] Challenge solved. Retrying original request.');
+
+      this._dispatchEvent('challengeSolved', { solution: solutionWrapper.rawSolution });
+      // Ajouter la solution aux paramètres de la requête pour le nouvel essai
+      const url = new URL((resource instanceof Request) ? resource.url : String(resource), window.location.origin);
+      // La logique de formatage est maintenant cachée dans la classe ChallengeSolution.
+      solutionWrapper.applyToUrl(url);
+
+      // On ajoute l'empreinte du solveur à la requête de réessai.
+      url.searchParams.set('pow_fp', solverFp);
+
+      // On utilise la chaîne d'intercepteurs pour la requête réessayée,
+      // ce qui garantit que le fetch original est appelé avec le bon contexte.
+      // Cela évite de réintroduire l'erreur "Illegal invocation".
+      return window.fetch(url.toString(), options);
+    } catch (e) {
+      console.error('[Fingerprint] Failed to solve or retry challenge:', e);
+      return response; // Retourne la réponse 429 originale en cas d'échec
+    }
+  }, // <-- VIRGULE AJOUTÉE ICI
+
+/**
+ * Initialise toutes les protections côté client en une seule fois.
+ * Tente également de charger le module WASM si `wasmPath` est fourni.
+ * C'est la méthode d'initialisation recommandée.
+ * @param {ClientConfig} [config={}] - L'objet de configuration.
+ */
+  initializeClient(config = {}) {
+    const {
+        mouse = true,
+        keystrokes = true,
+        clicks = true, // Add new option
+        touches = true, // Nouveau paramètre tactiles
+            rendering = true,
+            phantomTraps = true, // NOUVEAU
+        honeypots = [],
+        trapUrls = [], // Nouveau paramètre pour les URL pièges
+        wasmPath, // Nouveau paramètre
+        fetch: fetchConfig = {}
+    } = config;
+
+    // Tentative de chargement du WASM si le chemin est fourni
+    if (wasmPath) {
+        this.initializeWasm(wasmPath);
+    }
+
+    if (mouse) {
+        this.startMouseEntropyTracker();
+    }
+    if (keystrokes) {
+        this.startKeystrokeDynamicsTracker();
+    }
+    if (clicks) {
+        this.startClickTracker();
+    }
+    if (touches) {
+        this.startTouchEventTracker();
+    }
+        if (rendering) {
+            this.startRenderingTracker();
+        }
+        if (phantomTraps) {
+            this.injectPhantomTraps();
+        }
+    if (honeypots.length > 0) {
+        this.initializeHoneypots(honeypots);
+    }
+
+    // Injection dynamique des liens pièges au démarrage
+    if (trapUrls.length > 0) {
+        this.injectTrapLinks(trapUrls);
+    }
+    // On active l'interception si `fetch` est configuré, même avec un objet vide.
+    if (config.fetch) {
+        this.initializeFetch(fetchConfig.targetDomains);
+
+        // Ajoute l'intercepteur pour la résolution de challenge
+        if (fetchConfig.handleChallenges !== false) {
+            this.addFetchInterceptor(async (resource, options, next) => {
+                const originalResponse = await next(resource, options);
+                // On clone la réponse pour que la lecture du corps par solveChallengeAndRetry ne la consomme pas pour l'appelant original.
+                return this.solveChallengeAndRetry(originalResponse.clone(), resource, options);
+            });
+        }
+    }
+  },
+
+    /**
+     * Tente de charger et d'initialiser le module WebAssembly pour un hachage plus rapide.
+     * Si le chargement échoue, il se rabat silencieusement sur l'implémentation JS.
+     * @param {string} wasmPath - Le chemin vers le script de chargement du module WASM (ex: '/fp.js').
+     */
+    async initializeWasm(wasmPath) {
+        try {
+            // Direct standalone polymorphic WebAssembly loading
+            if (wasmPath.endsWith('.wasm')) {
+                const response = await fetch(wasmPath);
+                const arrayBuffer = await response.arrayBuffer();
+                const module = await WebAssembly.compile(arrayBuffer);
+                const instance = await WebAssembly.instantiate(module, {});
+                const exports = instance.exports;
+                const memory = exports.memory;
+                activeCyrb53 = (str) => {
+                    const encoder = new TextEncoder();
+                    const bytes = encoder.encode(str);
+                    const view = new Uint8Array(memory.buffer, 0, bytes.length);
+                    view.set(bytes);
+                    return exports.hash(0, bytes.length);
+                };
+                console.log('[Fingerprint] Standalone polymorphic WASM loaded successfully. Using fast dynamic hashing.');
+                if (this._cachedBuilder) {
+                    this._cachedBuilder.addRaw('wasm', 'true');
+                }
+                return;
+            }
+            // 1. Injecter le script qui charge le module WASM
+            const script = document.createElement('script');
+            script.src = wasmPath;
+            await new Promise((resolve, reject) => {
+                script.onload = resolve;
+                script.onerror = reject;
+                document.head.appendChild(script);
+            });
+
+            // 2. Attendre que la fonction globale `createFingerprintModule` soit disponible
+            if (typeof window.createFingerprintModule !== 'function') {
+                throw new Error('WASM loader script did not expose createFingerprintModule.');
+            }
+
+            // 3. Initialiser le module
+            const wasmUrl = wasmPath.replace(/\.js$/, '.wasm');
+            const wasmModule = await window.createFingerprintModule({
+                instantiateWasm: (imports, successCallback) => {
+                    (async () => {
+                        try {
+                            const cached = await getCachedWasm(wasmUrl);
+                            if (cached) {
+                                let instance;
+                                if (cached instanceof WebAssembly.Module) {
+                                    instance = await WebAssembly.instantiate(cached, imports);
+                                } else {
+                                    const result = await WebAssembly.instantiate(cached, imports);
+                                    instance = result.instance;
+                                }
+                                successCallback(instance, cached);
+                                return;
+                            }
+
+                            const response = await fetch(wasmUrl);
+                            const arrayBuffer = await response.arrayBuffer();
+
+                            let cachedData = arrayBuffer;
+                            let isModuleCached = false;
+                            try {
+                                const compiledModule = await WebAssembly.compile(arrayBuffer);
+                                const success = await cacheWasm(wasmUrl, compiledModule);
+                                if (success) {
+                                    cachedData = compiledModule;
+                                    isModuleCached = true;
+                                }
+                            } catch (e) {
+                                // Fallback if browser doesn't allow structured cloning of Compiled Modules
+                            }
+
+                            if (!isModuleCached) {
+                                await cacheWasm(wasmUrl, arrayBuffer);
+                            }
+
+                            let instance;
+                            if (cachedData instanceof WebAssembly.Module) {
+                                instance = await WebAssembly.instantiate(cachedData, imports);
+                            } else {
+                                const result = await WebAssembly.instantiate(arrayBuffer, imports);
+                                instance = result.instance;
+                            }
+                            successCallback(instance, cachedData);
+                        } catch (err) {
+                            console.warn('[Fingerprint] Custom WASM instantiation failed, falling back to default Emscripten loader:', err);
+                            successCallback(null);
+                        }
+                    })();
+                    return {}; // Async instantiation indicator for Emscripten
+                }
+            });
+            if (typeof wasmModule._hash_string !== 'function') {
+                throw new Error('WASM module did not export _hash_string.');
+            }
+        window.wasmModule = wasmModule;
+        ClientLibrary.wasmModule = wasmModule;
+
+            // 4. Remplacer la fonction de hachage par la version WASM
+            activeCyrb53 = (str) => {
+                // La fonction C++ attend un pointeur, Emscripten gère la conversion
+                return wasmModule._hash_string(str);
+            };
+
+            console.log('[Fingerprint] WASM module loaded successfully. Using fast hashing.');
+            // NOUVEAU: Ajoute un indicateur à l'empreinte pour que le serveur sache que le WASM est actif.
+            if (this._cachedBuilder) {
+                this._cachedBuilder.addRaw('wasm', 'true');
+            }
+        } catch (error) {
+            console.warn('[Fingerprint] WASM module failed to load. Falling back to JS implementation. Error:', error);
+        }
+    }
+};
+
+/**
+ * @typedef {object} ClientBehaviorMetrics
+ * @property {number} mouseEntropy - Entropie des mouvements de la souris.
+ * @property {Array<{x: number, y: number, t: number}>} mouseMovementsHistory - Historique des points de la souris.
+ * @property {number} keystrokeLatency - Latence moyenne entre les frappes.
+ * @property {boolean} honeypotInteraction - Vrai si un honeypot a été touché.
+ * @property {Array<{x: number, y: number, t: number, targetId: string}>} clicksHistory - Historique des clics.
+ * @property {Array<{x: number, y: number, t: number, p: number, r: number, num: number}>} touchMovementsHistory - Historique des glissements tactiles.
+ * @property {number} historyLength - La longueur de l'historique de session du navigateur (`window.history.length`).
+ * @property {number} clientTimestamp - Timestamp (Date.now()) de la collecte des métriques.
+ * @property {string[]} [trapUrls] - URLs pièges à injecter dynamiquement.
+ */
+/** @type {ClientBehaviorMetrics} */
+const metrics = {
+    mouseEntropy: 0, // Conservé pour la compatibilité, mais l'analyse se fait maintenant sur l'historique
+    mouseMovementsHistory: [],
+    touchMovementsHistory: [],
+    clicksHistory: [],
+    keystrokeLatency: 0,
+    honeypotInteraction: false,
+    historyLength: 0,
+    clientTimestamp: 0,
+    rendering: { fps: 0, jitter: 0, offscreenAnom: false },
+};
+
+let lastMousePos = { x: 0, y: 0 };
+let mouseMovementsHistory = []; // NOUVEAU: Historique des points de la souris
+let touchMovementsHistory = []; // NOUVEAU: Historique des gestes tactiles
+const TOUCH_HISTORY_MAX = 100;
+const MOUSE_HISTORY_MAX = 100; // Limite le nombre de points stockés
+let clicksHistory = [];
+const CLICKS_HISTORY_MAX = 50;
+let activeHoneypotListeners = new Map(); // Garde une trace des écouteurs actifs
+let keystrokeTimestamps = [];
+let keystrokeLatencies = []; // NOUVEAU: Tableau dédié pour les latences
+let keystrokeDwellTimes = [];
+let keystrokeFlightTimes = [];
+const KEYSTROKE_HISTORY_MAX = 20; // On garde l'historique des 20 dernières frappes
+
+
+
+// Exporter les fonctions individuellement pour la compatibilité ascendante
+export const getDeviceFingerprint = ClientLibrary.getDeviceFingerprint.bind(ClientLibrary);
+export const generateRequestSignature = ClientLibrary.generateRequestSignature.bind(ClientLibrary);
+export const generateClientSideSignature = ClientLibrary.generateClientSideSignature.bind(ClientLibrary);
+export const _resetCache = ClientLibrary._resetCache.bind(ClientLibrary);
+export const startMouseEntropyTracker = ClientLibrary.startMouseEntropyTracker.bind(ClientLibrary);
+export const startKeystrokeDynamicsTracker = ClientLibrary.startKeystrokeDynamicsTracker.bind(ClientLibrary);
+export const startClickTracker = ClientLibrary.startClickTracker.bind(ClientLibrary);
+export const startTouchEventTracker = ClientLibrary.startTouchEventTracker.bind(ClientLibrary);
+export const startRenderingTracker = ClientLibrary.startRenderingTracker.bind(ClientLibrary);
+export const initializeHoneypots = ClientLibrary.initializeHoneypots.bind(ClientLibrary);
+export const getClientBehaviorMetrics = ClientLibrary.getClientBehaviorMetrics.bind(ClientLibrary);
+export const protectedFetch = ClientLibrary.protectedFetch.bind(ClientLibrary);
+export const addFetchInterceptor = ClientLibrary.addFetchInterceptor.bind(ClientLibrary);
+export const patchGlobalFetch = ClientLibrary.patchGlobalFetch.bind(ClientLibrary);
+export const initializeFetch = ClientLibrary.initializeFetch.bind(ClientLibrary);
+export const initializeClient = ClientLibrary.initializeClient.bind(ClientLibrary);
+export const initializeWasm = ClientLibrary.initializeWasm.bind(ClientLibrary);
+export const injectTrapLinks = ClientLibrary.injectTrapLinks.bind(ClientLibrary);
+export const injectPhantomTraps = ClientLibrary.injectPhantomTraps.bind(ClientLibrary);
+export const solveChallengeAndRetry = ClientLibrary.solveChallengeAndRetry.bind(ClientLibrary);
+export const generateZkpProof = ClientLibrary.generateZkpProof.bind(ClientLibrary);
+export const initializeSpace = ClientLibrary.initializeSpace.bind(ClientLibrary);
+export const readSpaceBlock = ClientLibrary.readSpaceBlock.bind(ClientLibrary);
+export const solveSpaceChallenge = ClientLibrary.solveSpaceChallenge.bind(ClientLibrary);
+
+// Export the internal object for testing purposes
+export default ClientLibrary;
+
+// --- Global Export for Browser ---
+// Attach the library to the window object to make it accessible from inline scripts.
+if (typeof window !== 'undefined') {
+    window.ClientLibrary = ClientLibrary;
 }