CaptchaHub ReCaptcha

CaptchaHub ReCaptcha is a TypeScript library that provides integration with the Google ReCaptcha service, allowing for seamless captcha implementation within your applications. This package extends the core functionality of CaptchaHub to support ReCaptcha as a captcha provider.

Installation

Install the package using pnpm:

pnpm add @captchahub/core
pnpm add @captchahub/recaptcha

Features

• Widely Used: ReCaptcha is a widely adopted captcha solution by Google.
• Customizable: Easily customize the appearance and behavior of the captcha.
• Requires Core Package: This package requires the @captchahub/core package for functionality.

Usage

Getting the Captcha Script

The getCaptchaScript function can be used as follows:

import { getCaptchaScript } from '@captchahub/core';
// Import the provider package to trigger self-registration
import '@captchahub/recaptcha';

const config = {
    CAPTCHA_PROVIDER: 'recaptcha',
    RECAPTCHA_SITE_KEY: process.env.RECAPTCHA_SITE_KEY, // Your ReCaptcha site key
};

const CaptchaComponent = () => {
    const CaptchaScript = getCaptchaScript(config);

    return (
        <div>
            <CaptchaScript />
            {/* Additional form elements */}
        </div>
    );
};

Getting the Captcha Form Element

The getCaptchaFormElement function can be used as follows:

import { getCaptchaFormElement } from '@captchahub/core';
// Import the provider package to trigger self-registration
import '@captchahub/recaptcha';

const config = {
    CAPTCHA_PROVIDER: 'recaptcha',
    RECAPTCHA_SITE_KEY: process.env.RECAPTCHA_SITE_KEY, // Your ReCaptcha site key
};

const CaptchaFormComponent = async () => {
    const CaptchaFormElement = getCaptchaFormElement(config);

    return (
        <div>
            <CaptchaFormElement />
            {/* Additional form elements */}
        </div>
    );
};

Verifying the Captcha

The verifyCaptcha function can be used as follows:

import { verifyCaptcha } from '@captchahub/core';
// Import the provider package to trigger self-registration
import '@captchahub/recaptcha';

const config = {
    CAPTCHA_PROVIDER: 'recaptcha',
    RECAPTCHA_SECRET_KEY: process.env.RECAPTCHA_SECRET_KEY, // Your ReCaptcha secret key
};

const formFieldValues = {
    // Your form field values that need to be verified
};

const isValid = await verifyCaptcha(formFieldValues, config);
if (isValid) {
    console.log('Captcha verified successfully!');
} else {
    console.error('Captcha verification failed.');
}

Configuration

Configuration for the ReCaptcha provider can be defined in a configuration object passed to the factory when creating the captcha instance. The configuration object must include the CAPTCHA_PROVIDER property to specify which captcha provider to use. Additionally, you will need to provide the RECAPTCHA_SITE_KEY and RECAPTCHA_SECRET_KEY for proper functionality.

Extensibility

The @captchahub/recaptcha package is designed to be extensible. You can create new captcha providers by implementing the CaptchaInterface. This allows you to add support for additional captcha services in the future.

Rationale

The @captchahub/recaptcha package is designed to provide integration with the Google ReCaptcha service for managing captcha workflows in TypeScript applications. By using the core package, developers can easily integrate ReCaptcha capabilities into their web applications.

Contributing

Contributions are welcome! Feel free to fork this project and submit pull requests. Before submitting, please ensure your code passes all linting and unit tests.

You can format code using:

pnpm format

You can run unit tests using:

pnpm test