@empowered-humanity/detectionlab-collector

Invisible bot detection — 22 behavioral signals, zero user friction. No CAPTCHAs.

Quick Start

Script tag (CDN)

<script src="https://unpkg.com/@empowered-humanity/detectionlab-collector"></script>
<script>
  DetectionLab.init({ apiKey: "detlab_your_key" });

  // Score when ready (e.g., on form submit)
  document.querySelector("form").addEventListener("submit", async (e) => {
    e.preventDefault();
    const result = await DetectionLab.score();
    if (result.verdict === "FAIL") return alert("Bot detected");
    e.target.submit();
  });
</script>

npm

npm install @empowered-humanity/detectionlab-collector

import DetectionLab from "@empowered-humanity/detectionlab-collector";

DetectionLab.init({ apiKey: "detlab_your_key" });

// After user interaction...
const result = await DetectionLab.score();
console.log(result.verdict);       // "PASS" | "MARGINAL" | "FAIL"
console.log(result.overall_score); // 0-100
console.log(result.intent);       // { primary: "human", confidence: 1.0, ... }

API

DetectionLab.init(options)

| Option | Type | Default | Description | |--------|------|---------|-------------| | apiKey | string | — | Your API key (detlab_...). Get one free at detectionlab.app | | endpoint | string | https://www.detectionlab.app/api/score | Custom endpoint for self-hosted | | debug | boolean | false | Log collection events to console |

DetectionLab.score() → Promise<ScoreResult>

Posts all collected events to the API and returns the full score report.

DetectionLab.eventCount() → number

Returns the number of events collected so far.

DetectionLab.reset()

Clears all collected events. Use after scoring or on SPA route changes.

22 Signals Scored

Mouse curvature, speed variability, click precision, hover-before-click, keystroke timing, scroll behavior, dwell time, action pacing, overshoot, fingerprint, scroll jump, timing fit, direction changes, path uniqueness, velocity asymmetry, CSS fingerprint, stealth artifacts, event trust, spatial efficiency, vocabulary richness, typing burst, content naturalness.

Get an API Key

1. Go to detectionlab.app
2. Sign up for a free Sandbox key (100 evaluations/month)
3. Upgrade to Pro ($29/mo, 10K evals) or Scale ($99/mo, 100K evals)

License

MIT