@radzor/captcha-verify — LLM & AI Component | Radzor Registry

@radzor/captcha-verify

Server-side CAPTCHA verification supporting Cloudflare Turnstile, Google reCAPTCHA, and hCaptcha. Validates tokens from client-side widgets.

Authenticationv0.1.0typescriptpythonServercaptchaturnstilerecaptchahcaptchasecurityverificationby Radzor

Install

View source on GitHub →

$npx radzor@latest add captcha-verify

⚠ Constraints: Server-side only. Requires secret key from the CAPTCHA provider. Tokens are single-use.

Inputs

Name	Type	Default	Description
provider*	'turnstile' \| 'recaptcha' \| 'hcaptcha'	—	CAPTCHA provider.
secretKey*	string	—	Server-side secret key from the provider.TURNSTILE_SECRET_KEY
scoreThreshold	number	0.5	Minimum score to pass (reCAPTCHA v3 only, 0.0-1.0).

provider*'turnstile' | 'recaptcha' | 'hcaptcha'

CAPTCHA provider.

secretKey*string

Server-side secret key from the provider.

TURNSTILE_SECRET_KEY

Outputs

Name	Type	Description
verificationResult	CaptchaResult	Verification result with success status, score, and error codes. .successboolean .scorenumber(optional) .hostnamestring(optional) .errorCodesstring[] .providerstring

verificationResultCaptchaResult

Verification result with success status, score, and error codes.

.successboolean

.scorenumber(optional)

.hostnamestring(optional)

.errorCodesstring[]

.providerstring

radzor.manifest.json

{
  "llm": {
    "constraints": "Server-side only. Requires secret key from the CAPTCHA provider. Tokens are single-use.",
    "usageExamples": "llm/examples.md",
    "integrationPrompt": "llm/integration.md"
  },
  "name": "@radzor/captcha-verify",
  "tags": [
    "captcha",
    "turnstile",
    "recaptcha",
    "hcaptcha",
    "security",
    "verification"
  ],
  "events": [
    {
      "name": "onVerified",
      "payload": {
        "score": "number",
        "success": "boolean"
      },
      "description": "Fired after verification."
    },
    {
      "name": "onError",
      "payload": {
        "code": "string",
        "message": "string"
      },
      "description": "Fired on verification errors."
    }
  ],
  "inputs": [
    {
      "name": "provider",
      "type": "'turnstile' | 'recaptcha' | 'hcaptcha'",
      "required": true,
      "description": "CAPTCHA provider."
    },
    {
      "name": "secretKey",
      "type": "string",
      "envVar": "TURNSTILE_SECRET_KEY",
      "required": true,
      "description": "Server-side secret key from the provider."
    },
    {
      "name": "scoreThreshold",
      "type": "number",
      "default": 0.5,
      "required": false,
      "description": "Minimum score to pass (reCAPTCHA v3 only, 0.0-1.0)."
    }
  ],
  "radzor": "1.0.0",
  "actions": [
    {
      "name": "verify",
      "params": [
        {
          "name": "token",
          "type": "string",
          "description": "Token from the client-side CAPTCHA widget."
        },
        {
          "name": "remoteIp",
          "type": "string",
          "description": "Optional client IP address for additional validation."
        }
      ],
      "returns": "Promise<CaptchaResult>",
      "description": "Verify a CAPTCHA token."
    }
  ],
  "outputs": [
    {
      "name": "verificationResult",
      "type": "CaptchaResult",
      "fields": [
        {
          "name": "success",
          "type": "boolean"
        },
        {
          "name": "score",
          "type": "number",
          "required": false
        },
        {
          "name": "hostname",
          "type": "string",
          "required": false
        },
        {
          "name": "errorCodes",
          "type": "string[]"
        },
        {
          "name": "provider",
          "type": "string"
        }
      ],
      "description": "Verification result with success status, score, and error codes."
    }
  ],
  "runtime": "server",
  "version": "0.1.0",
  "category": "auth",
  "languages": [
    "typescript",
    "python"
  ],
  "description": "Server-side CAPTCHA verification supporting Cloudflare Turnstile, Google reCAPTCHA, and hCaptcha. Validates tokens from client-side widgets.",
  "dependencies": {
    "radzor": [],
    "packages": {}
  },
  "composability": {
    "connectsTo": [
      {
        "output": "verificationResult",
        "mapField": "success",
        "compatibleWith": [
          "@radzor/log-aggregator.action.info.message",
          "@radzor/event-tracker.action.track.eventName"
        ]
      },
      {
        "event": "onFailed",
        "description": "Track CAPTCHA verification failures",
        "compatibleWith": [
          "@radzor/error-tracker.action.captureMessage.message"
        ]
      }
    ]
  }
}

@radzor/captcha-verify

Install

Inputs

Outputs

Actions

Events

Composability

radzor.manifest.json

Version History