@007captcha/client

@007captcha/client

Browser widget for 007captcha. Renders challenges, captures user input, and communicates with the server for verification.

---

Installation

pnpm add @007captcha/client

Or via script tag (UMD):

<script src="https://unpkg.com/@007captcha/client/dist/umd/index.global.js"></script>

Usage

ES Module

import { render } from '@007captcha/client';

const widget = render({
  siteKey: 'your-secret-key',
  container: '#captcha',
  method: 'ball',
  serverUrl: window.location.origin,
  onSuccess: (token) => {
    fetch('/verify', {
      method: 'POST',
      headers: { 'Content-Type': 'application/json' },
      body: JSON.stringify({ token }),
    });
  },
});

Script Tag

<div id="captcha"></div>
<script src="https://unpkg.com/@007captcha/client/dist/umd/index.global.js"></script>
<script>
  OOSevenCaptcha.render({
    siteKey: 'your-secret-key',
    container: '#captcha',
    method: 'ball',
    serverUrl: window.location.origin,
    onSuccess(token) {
      console.log('Verified:', token);
    },
  });
</script>

Form Integration

The widget creates a hidden <input name="captcha-token"> in the DOM. For standard form submissions, you can also retrieve the token programmatically:

const token = widget.getToken();

Challenge Methods

All methods require a serverUrl. The server handles session creation, analysis, and token signing — the client is a rendering and input-capture layer.

Configuration

render(config): CaptchaWidget

CaptchaWidget

widget.getToken()   // Returns the current signed token (string)
widget.reset()      // Reset and show a new challenge
widget.destroy()    // Remove the widget from the DOM entirely

Theming

The widget supports 'light', 'dark', and 'auto' themes. In 'auto' mode, it follows the user's system preference via prefers-color-scheme.

render({ theme: 'dark', /* ... */ });

Requirements

• A running @007captcha/server instance with the appropriate endpoints. See the server package or the Express example for setup.
• The siteKey must match between client and server.

License

MIT