vue-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 Vue 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 vue-gamified-captcha

Usage

<template>
  <form @submit.prevent="submitForm">
    <!-- ... your form fields ... -->
    
    <GamifiedCaptcha 
      siteKey="YOUR_CONVERSION_BUSINESS_API_KEY" 
      @humanVerified="handleVerify"
    />
    
    <button type="submit">Submit</button>
  </form>
</template>

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

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

const submitForm = () => {
  // Form submission logic
};
</script>

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.