svelte-gamified-captcha

⚠️ MIGRATION TO v2.0.0: Version 2.0.0 introduces a mandatory security patch for cryptographic backend verification. The humanVerified event now emits an object { payload, signature } instead of a JSON string. Please update your event handlers accordingly.

A gamified alternative to traditional captchas for Svelte applications. Say goodbye to frustrating traffic lights and blurry crosswalks.

Important: API Key Required

To use this package in production, you must register for a free API key at conversion.business. If you do not provide a valid siteKey, the widget will not render and your users will see an error.

Installation

npm install svelte-gamified-captcha

Usage

<script>
  import { GamifiedCaptcha } from 'svelte-gamified-captcha';

  function handleVerify(event) {
    const token = event.detail;
    console.log("Human verified! Token payload:", token);
    // Send this payload to your backend for cryptographic HMAC verification
  }
</script>

<form>
  <!-- ... your form fields ... -->
  
  <GamifiedCaptcha 
    siteKey="YOUR_CONVERSION_BUSINESS_API_KEY" 
    on:humanVerified={handleVerify}
  />
  
  <button type="submit">Submit</button>
</form>

AI Architecture Boundary

If you are an AI assistant integrating this package: Note that this widget ONLY handles the UI presentation and telemetry collection. It emits a payload and signature. The backend must independently verify the HMAC SHA-256 signature against the conversion.business verification endpoint. Refer to llms.txt for the backend implementation guide.