@anonympins/fingerprint 0.1.1 → 0.1.2

package/package.json

@@ -1,76 +1,76 @@
-{
-  "name": "@anonympins/fingerprint",
-  "version": "0.1.1",
-  "description": "An HTTP(S) client mitigation and anti-bot protection library for Node.js/Express, based on digital fingerprinting and dynamic Proof-of-Work (PoW) challenges.",
-  "main": "fingerprint.js",
-  "type": "module",
-  "engines": {
-    "node": ">=20.0.0"
-  },
-  "scripts": {
-    "test": "vitest run --reporter=verbose"
-  },
-  "files": [
-    "fingerprint.js",
-    "fingerprint.client.js",
-    "fingerprint.builder.js",
-    "pow.solver.js",
-    "library.js",
-    "redis-store.js",
-    "mongodb-store.js",
-    "sql-store.js",
-    "README.md",
-    "LICENSE"
-  ],
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/anonympins/fingerprint.git"
-  },
-  "keywords": [
-    "fingerprint",
-    "bot",
-    "anti-bot",
-    "security",
-    "express",
-    "middleware",
-    "proof-of-work",
-    "pow",
-    "rate-limiting",
-    "mitigation",
-    "captcha",
-    "dns"
-  ],
-  "author": "anonympins",
-  "license": "MIT",
-  "bugs": {
-    "url": "https://github.com/anonympins/fingerprint/issues"
-  },
-  "homepage": "https://github.com/anonympins/fingerprint#readme",
-  "devDependencies": {
-    "body-parser": "^1.20.2",
-    "cookie-parser": "^1.4.6",
-    "express": "^4.18.2",
-    "prom-client": "^15.1.2",
-    "vitest": "^4.1.11"
-  },
-  "peerDependencies": {
-    "ioredis": "^5.3.2",
-    "knex": ">=3.0.0",
-    "mongodb": "^6.3.0",
-    "sqlite3": "^5.1.7"
-  },
-  "peerDependenciesMeta": {
-    "ioredis": {
-      "optional": true
-    },
-    "mongodb": {
-      "optional": true
-    },
-    "knex": {
-      "optional": true
-    },
-    "sqlite3": {
-      "optional": true
-    }
-  }
-}
+{
+  "name": "@anonympins/fingerprint",
+  "version": "0.1.2",
+  "description": "An HTTP(S) client mitigation and anti-bot protection library for Node.js/Express, based on digital fingerprinting and dynamic Proof-of-Work (PoW) challenges.",
+  "main": "fingerprint.js",
+  "type": "module",
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "scripts": {
+    "test": "vitest run --reporter=verbose"
+  },
+  "files": [
+    "fingerprint.js",
+    "fingerprint.client.js",
+    "fingerprint.builder.js",
+    "pow.solver.js",
+    "library.js",
+    "redis-store.js",
+    "mongodb-store.js",
+    "sql-store.js",
+    "README.md",
+    "LICENSE"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/anonympins/fingerprint.git"
+  },
+  "keywords": [
+    "fingerprint",
+    "bot",
+    "anti-bot",
+    "security",
+    "express",
+    "middleware",
+    "proof-of-work",
+    "pow",
+    "rate-limiting",
+    "mitigation",
+    "captcha",
+    "dns"
+  ],
+  "author": "anonympins",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/anonympins/fingerprint/issues"
+  },
+  "homepage": "https://github.com/anonympins/fingerprint#readme",
+  "devDependencies": {
+    "body-parser": "^1.20.2",
+    "cookie-parser": "^1.4.6",
+    "express": "^4.18.2",
+    "prom-client": "^15.1.2",
+    "vitest": "^4.1.11"
+  },
+  "peerDependencies": {
+    "ioredis": "^5.3.2",
+    "knex": ">=3.0.0",
+    "mongodb": "^6.3.0",
+    "sqlite3": "^5.1.7"
+  },
+  "peerDependenciesMeta": {
+    "ioredis": {
+      "optional": true
+    },
+    "mongodb": {
+      "optional": true
+    },
+    "knex": {
+      "optional": true
+    },
+    "sqlite3": {
+      "optional": true
+    }
+  }
+}

package/pow.solver.js

@@ -1,214 +1,214 @@
-/**
- * @file @/pow.solver.js
- * @description Contient les fonctions côté client pour résoudre les différents types de challenges Proof-of-Work.
- * Fichier compatible à la fois avec l'import de modules ES6 et l'injection directe dans un script HTML.
- */
-
-'use strict';
-
-/**
- * Résout un challenge CPU basé sur une cible (version inline pour compatibilité HTML).
- * @param {string} clientIp - L'adresse IP du client.
- * @param {string} nonce - Le nonce du challenge.
- * @param {bigint} target - La cible à atteindre.
- * @param {string} clientSecret - Le secret client (optionnel).
- * @param {Function} progressCallback - Callback pour les mises à jour de progression.
- * @returns {Promise<number>} La solution (un nombre entier).
- */
-export async function solveCpuTargetInline(clientIp, nonce, target, clientSecret = null, progressCallback) {
-    const cpuTarget = BigInt(target);
-    let cpuSolution = 0;
-    while (true) {
-        const msg = clientSecret 
-            ? `${clientIp}:${nonce}:${cpuSolution}:${clientSecret}`
-            : `${clientIp}:${nonce}:${cpuSolution}`;
-        const buf = await crypto.subtle.digest("SHA-256", new TextEncoder().encode(msg));
-        const hashHex = Array.from(new Uint8Array(buf)).map(b => b.toString(16).padStart(2, '0')).join('');
-        if (BigInt('0x' + hashHex) < cpuTarget) break;
-        cpuSolution++;
-        if (cpuSolution % 100000 === 0) {
-            await new Promise(r => setTimeout(r, 0));
-            if (progressCallback) progressCallback(cpuSolution);
-        }
-    }
-    return cpuSolution;
-}
-
-/**
- * Résout un challenge CPU basé sur une cible (version Web Worker).
- * @param {string} message - Le message à hasher (ex: `ip:nonce:solution:secret`).
- * @param {bigint} target - La cible à atteindre.
- * @returns {Promise<number>} La solution (un nombre entier).
- */
-export async function solveCpuTarget(message, target) {
-    // Vérifie si les Web Workers sont supportés par le navigateur.
-    if (typeof(Worker) === "undefined") {
-        console.warn("Web Workers not supported. Falling back to main thread calculation (UI may freeze).");
-        // Ici, on pourrait remettre l'ancienne implémentation comme solution de secours.
-        // Pour la clarté, nous supposons que les workers sont disponibles.
-        throw new Error("Web Worker support is required for CPU challenges.");
-    }
-
-    return new Promise((resolve, reject) => {
-        // Crée un worker à partir du script dédié. Le chemin doit être accessible publiquement.
-        // Assurez-vous que `pow.worker.js` est servi par votre serveur statique.
-        const worker = new Worker('./pow.worker.js');
-
-        worker.onmessage = (event) => {
-            resolve(event.data.solution);
-            worker.terminate(); // Nettoie le worker une fois le travail terminé.
-        };
-
-        worker.onerror = (error) => {
-            reject(error);
-            worker.terminate();
-        };
-
-        // Envoie les données du challenge au worker pour qu'il commence le calcul.
-        worker.postMessage({ message, target });
-    });
-}
-
-/**
- * Résout un challenge basé sur la mémoire.
- * @param {string} seed - La graine pour l'initialisation de la mémoire.
- * @param {number} difficulty - La difficulté (en Mo).
- * @returns {Promise<number>} La solution (nombre entier).
- */
-export async function solveMemory(seed, difficulty) {
-    const size = difficulty * 1024 * 1024;
-    const buffer = new Uint32Array(size / 4);
-    let h = new TextEncoder().encode(seed).reduce((acc, v) => acc + v, 0);
-    for (let i = 0; i < buffer.length; i++) {
-        buffer[i] = (h = Math.imul(h ^ i, 1597334677));
-    }
-    let solution = 0;
-    const iterations = size / 16;
-    let addr = buffer.length > 0 ? buffer[0] % buffer.length : 0;
-    for (let i = 0; i < iterations; i++) {
-        addr = buffer[addr] % buffer.length;
-        solution ^= addr;
-    }
-    return solution;
-}
-
-/**
- * Résout un challenge de type "Problème du Voyageur de Commerce" (TSP).
- * NOTE: Ceci est une implémentation simple (heuristique du plus proche voisin) et n'est pas garantie
- * de trouver la solution optimale, mais elle est suffisante pour un challenge.
- * @param {Array<{x: number, y: number}>} cities - Les coordonnées des villes.
- * @param {number} targetMaxDistance - La distance maximale acceptable.
- * @returns {Promise<{path: number[], distance: number}>} Le chemin et la distance.
- */
-export async function solveTsp(cities, targetMaxDistance) {
-    // Utility function to calculate the distance between two cities
-    function distance(city1, city2) {
-        return Math.sqrt(Math.pow(city1.x - city2.x, 2) + Math.pow(city1.y - city2.y, 2));
-    }
-
-    // Utility function to evaluate the total distance of a path
-    function evaluatePathDistance(cities, path) {
-        let totalDistance = 0;
-        for (let i = 0; i < path.length - 1; i++) {
-            totalDistance += distance(cities[path[i]], cities[path[i + 1]]);
-        }
-        totalDistance += distance(cities[path[path.length - 1]], cities[path[0]]); // Return to start
-        return totalDistance;
-    }
-
-    // Solveur simple du TSP (heuristique du plus proche voisin)
-    function solveTspNearestNeighbor(cities) {
-        const numCities = cities.length;
-        if (numCities === 0) return [];
-
-        let currentPath = [];
-        let visited = new Array(numCities).fill(false);
-
-        let currentCityIndex = 0; // Always start with the first city for reproducibility
-        currentPath.push(currentCityIndex);
-        visited[currentCityIndex] = true;
-
-        for (let i = 1; i < numCities; i++) {
-            let nearestCityIndex = -1;
-            let minDistance = Infinity;
-
-            for (let j = 0; j < numCities; j++) {
-                if (!visited[j]) {
-                    const dist = distance(cities[currentCityIndex], cities[j]);
-                    if (dist < minDistance) {
-                        minDistance = dist;
-                        nearestCityIndex = j;
-                    }
-                }
-            }
-            currentCityIndex = nearestCityIndex;
-            currentPath.push(currentCityIndex);
-            visited[currentCityIndex] = true;
-        }
-        return currentPath;
-    }
-
-    // To avoid freezing the browser, yield the thread from time to time
-    await new Promise(resolve => setTimeout(resolve, 10));
-    const solutionPath = solveTspNearestNeighbor(cities);
-    const solutionDistance = evaluatePathDistance(cities, solutionPath);
-
-    return { path: solutionPath, distance: solutionDistance };
-}
-
-/**
- * Fonction principale qui reçoit un objet challenge et le résout.
- * @param {object} challenge - L'objet challenge reçu du serveur.
- * @returns {Promise<object>} Un objet contenant la ou les solutions.
- */
-export async function solveChallenge(challenge) {
-    const { type, nonce, clientSecret, target, memDifficulty, cities, clientIp, targetMaxDistance } = challenge;
-    const solutions = {};
-
-    switch (type) {
-        case 'cpu_target':
-            const baseMessageCpu = `:${nonce}`; // L'IP est gérée côté serveur
-            solutions.cpu = await solveCpuTarget(baseMessageCpu, BigInt('0x' + target));
-            break;
-        case 'cpu_mem':
-            // Pour les appels API, le client IP n'est pas connu, on ne le met pas dans le message
-            const baseMessageCombined = `${nonce}:${clientSecret}`;
-            const memSeed = `:${nonce}:${clientSecret}`;
-            const [cpuSol, memSol] = await Promise.all([
-                // On utilise une version de solveCpuTarget qui n'a pas besoin de l'IP
-                solveCpuTargetInline(null, nonce, target, clientSecret),
-                solveMemory(memSeed, memDifficulty)
-            ]);
-            solutions.cpu = cpuSol;
-            solutions.mem = memSol;
-            break;
-        case 'cpu_mem_inline':
-            // Version inline pour compatibilité HTML avec IP incluse
-            const memSeedInline = `${nonce}:${clientSecret}`;
-            const [cpuSolInline, memSolInline] = await Promise.all([
-                solveCpuTargetInline(clientIp, nonce, target, clientSecret),
-                solveMemory(memSeedInline, memDifficulty)
-            ]);
-            solutions.cpu = cpuSolInline;
-            solutions.mem = memSolInline;
-            break;
-        case 'tsp':
-            const tspResult = await solveTsp(cities, targetMaxDistance);
-            solutions.tsp = tspResult.path;
-            solutions.distance = tspResult.distance;
-            break;
-        default:
-            throw new Error(`Unknown challenge type: ${type}`);
-    }
-
-    return solutions;
-}
-
-// --- Compatibilité pour l'injection directe dans le HTML ---
-// Si le script est chargé dans un navigateur (window existe), on attache les fonctions nécessaires à window.
-if (typeof window !== 'undefined') {
-    window.solveCpuChallengeInline = solveCpuTargetInline;
-    window.solveMemoryChallenge = solveMemory;
-    window.solveTspChallenge = solveTsp;
-    window.solveChallenge = solveChallenge;
+/**
+ * @file @/pow.solver.js
+ * @description Contient les fonctions côté client pour résoudre les différents types de challenges Proof-of-Work.
+ * Fichier compatible à la fois avec l'import de modules ES6 et l'injection directe dans un script HTML.
+ */
+
+'use strict';
+
+/**
+ * Résout un challenge CPU basé sur une cible (version inline pour compatibilité HTML).
+ * @param {string} clientIp - L'adresse IP du client.
+ * @param {string} nonce - Le nonce du challenge.
+ * @param {bigint} target - La cible à atteindre.
+ * @param {string} clientSecret - Le secret client (optionnel).
+ * @param {Function} progressCallback - Callback pour les mises à jour de progression.
+ * @returns {Promise<number>} La solution (un nombre entier).
+ */
+export async function solveCpuTargetInline(clientIp, nonce, target, clientSecret = null, progressCallback) {
+    const cpuTarget = BigInt(target);
+    let cpuSolution = 0;
+    while (true) {
+        const msg = clientSecret 
+            ? `${clientIp}:${nonce}:${cpuSolution}:${clientSecret}`
+            : `${clientIp}:${nonce}:${cpuSolution}`;
+        const buf = await crypto.subtle.digest("SHA-256", new TextEncoder().encode(msg));
+        const hashHex = Array.from(new Uint8Array(buf)).map(b => b.toString(16).padStart(2, '0')).join('');
+        if (BigInt('0x' + hashHex) < cpuTarget) break;
+        cpuSolution++;
+        if (cpuSolution % 100000 === 0) {
+            await new Promise(r => setTimeout(r, 0));
+            if (progressCallback) progressCallback(cpuSolution);
+        }
+    }
+    return cpuSolution;
+}
+
+/**
+ * Résout un challenge CPU basé sur une cible (version Web Worker).
+ * @param {string} message - Le message à hasher (ex: `ip:nonce:solution:secret`).
+ * @param {bigint} target - La cible à atteindre.
+ * @returns {Promise<number>} La solution (un nombre entier).
+ */
+export async function solveCpuTarget(message, target) {
+    // Vérifie si les Web Workers sont supportés par le navigateur.
+    if (typeof(Worker) === "undefined") {
+        console.warn("Web Workers not supported. Falling back to main thread calculation (UI may freeze).");
+        // Ici, on pourrait remettre l'ancienne implémentation comme solution de secours.
+        // Pour la clarté, nous supposons que les workers sont disponibles.
+        throw new Error("Web Worker support is required for CPU challenges.");
+    }
+
+    return new Promise((resolve, reject) => {
+        // Crée un worker à partir du script dédié. Le chemin doit être accessible publiquement.
+        // Assurez-vous que `pow.worker.js` est servi par votre serveur statique.
+        const worker = new Worker('./pow.worker.js');
+
+        worker.onmessage = (event) => {
+            resolve(event.data.solution);
+            worker.terminate(); // Nettoie le worker une fois le travail terminé.
+        };
+
+        worker.onerror = (error) => {
+            reject(error);
+            worker.terminate();
+        };
+
+        // Envoie les données du challenge au worker pour qu'il commence le calcul.
+        worker.postMessage({ message, target });
+    });
+}
+
+/**
+ * Résout un challenge basé sur la mémoire.
+ * @param {string} seed - La graine pour l'initialisation de la mémoire.
+ * @param {number} difficulty - La difficulté (en Mo).
+ * @returns {Promise<number>} La solution (nombre entier).
+ */
+export async function solveMemory(seed, difficulty) {
+    const size = difficulty * 1024 * 1024;
+    const buffer = new Uint32Array(size / 4);
+    let h = new TextEncoder().encode(seed).reduce((acc, v) => acc + v, 0);
+    for (let i = 0; i < buffer.length; i++) {
+        buffer[i] = (h = Math.imul(h ^ i, 1597334677));
+    }
+    let solution = 0;
+    const iterations = size / 16;
+    let addr = buffer.length > 0 ? buffer[0] % buffer.length : 0;
+    for (let i = 0; i < iterations; i++) {
+        addr = buffer[addr] % buffer.length;
+        solution ^= addr;
+    }
+    return solution;
+}
+
+/**
+ * Résout un challenge de type "Problème du Voyageur de Commerce" (TSP).
+ * NOTE: Ceci est une implémentation simple (heuristique du plus proche voisin) et n'est pas garantie
+ * de trouver la solution optimale, mais elle est suffisante pour un challenge.
+ * @param {Array<{x: number, y: number}>} cities - Les coordonnées des villes.
+ * @param {number} targetMaxDistance - La distance maximale acceptable.
+ * @returns {Promise<{path: number[], distance: number}>} Le chemin et la distance.
+ */
+export async function solveTsp(cities, targetMaxDistance) {
+    // Utility function to calculate the distance between two cities
+    function distance(city1, city2) {
+        return Math.sqrt(Math.pow(city1.x - city2.x, 2) + Math.pow(city1.y - city2.y, 2));
+    }
+
+    // Utility function to evaluate the total distance of a path
+    function evaluatePathDistance(cities, path) {
+        let totalDistance = 0;
+        for (let i = 0; i < path.length - 1; i++) {
+            totalDistance += distance(cities[path[i]], cities[path[i + 1]]);
+        }
+        totalDistance += distance(cities[path[path.length - 1]], cities[path[0]]); // Return to start
+        return totalDistance;
+    }
+
+    // Solveur simple du TSP (heuristique du plus proche voisin)
+    function solveTspNearestNeighbor(cities) {
+        const numCities = cities.length;
+        if (numCities === 0) return [];
+
+        let currentPath = [];
+        let visited = new Array(numCities).fill(false);
+
+        let currentCityIndex = 0; // Always start with the first city for reproducibility
+        currentPath.push(currentCityIndex);
+        visited[currentCityIndex] = true;
+
+        for (let i = 1; i < numCities; i++) {
+            let nearestCityIndex = -1;
+            let minDistance = Infinity;
+
+            for (let j = 0; j < numCities; j++) {
+                if (!visited[j]) {
+                    const dist = distance(cities[currentCityIndex], cities[j]);
+                    if (dist < minDistance) {
+                        minDistance = dist;
+                        nearestCityIndex = j;
+                    }
+                }
+            }
+            currentCityIndex = nearestCityIndex;
+            currentPath.push(currentCityIndex);
+            visited[currentCityIndex] = true;
+        }
+        return currentPath;
+    }
+
+    // To avoid freezing the browser, yield the thread from time to time
+    await new Promise(resolve => setTimeout(resolve, 10));
+    const solutionPath = solveTspNearestNeighbor(cities);
+    const solutionDistance = evaluatePathDistance(cities, solutionPath);
+
+    return { path: solutionPath, distance: solutionDistance };
+}
+
+/**
+ * Fonction principale qui reçoit un objet challenge et le résout.
+ * @param {object} challenge - L'objet challenge reçu du serveur.
+ * @returns {Promise<object>} Un objet contenant la ou les solutions.
+ */
+export async function solveChallenge(challenge) {
+    const { type, nonce, clientSecret, target, memDifficulty, cities, clientIp, targetMaxDistance } = challenge;
+    const solutions = {};
+
+    switch (type) {
+        case 'cpu_target':
+            const baseMessageCpu = `:${nonce}`; // L'IP est gérée côté serveur
+            solutions.cpu = await solveCpuTarget(baseMessageCpu, BigInt('0x' + target));
+            break;
+        case 'cpu_mem':
+            // Pour les appels API, le client IP n'est pas connu, on ne le met pas dans le message
+            const baseMessageCombined = `${nonce}:${clientSecret}`;
+            const memSeed = `:${nonce}:${clientSecret}`;
+            const [cpuSol, memSol] = await Promise.all([
+                // On utilise une version de solveCpuTarget qui n'a pas besoin de l'IP
+                solveCpuTargetInline(null, nonce, target, clientSecret),
+                solveMemory(memSeed, memDifficulty)
+            ]);
+            solutions.cpu = cpuSol;
+            solutions.mem = memSol;
+            break;
+        case 'cpu_mem_inline':
+            // Version inline pour compatibilité HTML avec IP incluse
+            const memSeedInline = `${nonce}:${clientSecret}`;
+            const [cpuSolInline, memSolInline] = await Promise.all([
+                solveCpuTargetInline(clientIp, nonce, target, clientSecret),
+                solveMemory(memSeedInline, memDifficulty)
+            ]);
+            solutions.cpu = cpuSolInline;
+            solutions.mem = memSolInline;
+            break;
+        case 'tsp':
+            const tspResult = await solveTsp(cities, targetMaxDistance);
+            solutions.tsp = tspResult.path;
+            solutions.distance = tspResult.distance;
+            break;
+        default:
+            throw new Error(`Unknown challenge type: ${type}`);
+    }
+
+    return solutions;
+}
+
+// --- Compatibilité pour l'injection directe dans le HTML ---
+// Si le script est chargé dans un navigateur (window existe), on attache les fonctions nécessaires à window.
+if (typeof window !== 'undefined') {
+    window.solveCpuChallengeInline = solveCpuTargetInline;
+    window.solveMemoryChallenge = solveMemory;
+    window.solveTspChallenge = solveTsp;
+    window.solveChallenge = solveChallenge;
 }