# solvercaptcha/solvecaptcha-javascript architecture

> Architecture diagram of the GitHub repository solvercaptcha/solvecaptcha-javascript, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/solvercaptcha/solvecaptcha-javascript
- Repository: https://github.com/solvercaptcha/solvecaptcha-javascript

## Overview

This is a Node.js client for the SolveCaptcha service. A caller configures a Solver and submits one of the documented captcha types; the client formats requests to the service and handles results, with parameter normalization and validation supporting the solve methods. The README also documents balance and reporting operations. A separate HTTP callback server is present but marked work in progress. The main client excerpt is partial, so details of individual solve and polling paths are not fully visible.

Main entry points: [`src/structs/solvecaptcha.ts`](https://github.com/solvercaptcha/solvecaptcha-javascript/blob/master/src/structs/solvecaptcha.ts) (Solver operations), [`src/index.ts`](https://github.com/solvercaptcha/solvecaptcha-javascript/blob/master/src/index.ts) (Package exports), [`src/structs/solvecaptchaServer.ts`](https://github.com/solvercaptcha/solvecaptcha-javascript/blob/master/src/structs/solvecaptchaServer.ts) (HTTP callback server), [`src/structs/providers/providers.ts`](https://github.com/solvercaptcha/solvecaptcha-javascript/blob/master/src/structs/providers/providers.ts) (Provider selection)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Client API"]
  node_exports["Package exports<br/>[index.ts]"]
  node_solver["Solver operations<br/>[solvecaptcha.ts]"]
  node_captcha["Captcha solve methods<br/>[solvecaptcha.ts]"]
  node_account["Balance and reports<br/>[solvecaptcha.ts]"]
end

subgraph group_internals["Request internals"]
  node_validation["Parameter validation"]
  node_renaming["Parameter mapping<br/>[renameParams.ts]"]
  node_formatting["Payload formatting<br/>[generic.ts]"]
  node_provider["Provider selection<br/>[providers.ts]"]
  node_endpoints["Provider endpoints<br/>[constants.ts]"]
  node_errors["API errors"]
end

subgraph group_callback["Callback server"]
  node_callbackserver["HTTP callback server"]
end

node_caller(("Node.js caller"))
node_api{{"SolveCaptcha API"}}
node_http{{"HTTP clients"}}

node_caller -->|"imports"| node_exports
node_exports -->|"exports"| node_solver
node_caller -->|"configures"| node_solver
node_solver -->|"provides"| node_captcha
node_solver -->|"provides"| node_account
node_captcha -->|"normalizes params"| node_renaming
node_captcha -->|"checks params"| node_validation
node_solver -->|"formats payloads"| node_formatting
node_solver -->|"selects provider"| node_provider
node_provider -->|"reads endpoint config"| node_endpoints
node_solver -->|"submits and polls"| node_api
node_solver -->|"sends requests"| node_http
node_solver -->|"uses errors"| node_errors
node_exports -->|"exports"| node_errors
node_callbackserver -->|"creates server"| node_http
node_callbackserver -->|"uses captcha types"| node_solver

click node_exports "https://github.com/solvercaptcha/solvecaptcha-javascript/blob/master/src/index.ts"
click node_solver "https://github.com/solvercaptcha/solvecaptcha-javascript/blob/master/src/structs/solvecaptcha.ts"
click node_captcha "https://github.com/solvercaptcha/solvecaptcha-javascript/blob/master/src/structs/solvecaptcha.ts"
click node_account "https://github.com/solvercaptcha/solvecaptcha-javascript/blob/master/src/structs/solvecaptcha.ts"
click node_validation "https://github.com/solvercaptcha/solvecaptcha-javascript/blob/master/src/utils/checkCaptchaParams.ts"
click node_renaming "https://github.com/solvercaptcha/solvecaptcha-javascript/blob/master/src/utils/renameParams.ts"
click node_formatting "https://github.com/solvercaptcha/solvecaptcha-javascript/blob/master/src/utils/generic.ts"
click node_provider "https://github.com/solvercaptcha/solvecaptcha-javascript/blob/master/src/structs/providers/providers.ts"
click node_endpoints "https://github.com/solvercaptcha/solvecaptcha-javascript/blob/master/src/structs/constants/constants.ts"
click node_errors "https://github.com/solvercaptcha/solvecaptcha-javascript/blob/master/src/structs/solvecaptchaError.ts"
click node_callbackserver "https://github.com/solvercaptcha/solvecaptcha-javascript/blob/master/src/structs/solvecaptchaServer.ts"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_exports,node_solver,node_captcha,node_account,node_http toneBlue
class node_validation,node_renaming,node_formatting,node_provider,node_endpoints,node_errors toneAmber
class node_callbackserver,node_api toneMint
class node_caller toneIndigo
```

## Components

### Client API

- [Package exports](https://github.com/solvercaptcha/solvecaptcha-javascript/blob/master/src/index.ts): `src/index.ts`
- [Solver operations](https://github.com/solvercaptcha/solvecaptcha-javascript/blob/master/src/structs/solvecaptcha.ts): `src/structs/solvecaptcha.ts`
- [Captcha solve methods](https://github.com/solvercaptcha/solvecaptcha-javascript/blob/master/src/structs/solvecaptcha.ts): `src/structs/solvecaptcha.ts`
- [Balance and reports](https://github.com/solvercaptcha/solvecaptcha-javascript/blob/master/src/structs/solvecaptcha.ts): `src/structs/solvecaptcha.ts`

### Request internals

- [Parameter validation](https://github.com/solvercaptcha/solvecaptcha-javascript/blob/master/src/utils/checkCaptchaParams.ts): `src/utils/checkCaptchaParams.ts`
- [Parameter mapping](https://github.com/solvercaptcha/solvecaptcha-javascript/blob/master/src/utils/renameParams.ts): `src/utils/renameParams.ts`
- [Payload formatting](https://github.com/solvercaptcha/solvecaptcha-javascript/blob/master/src/utils/generic.ts): `src/utils/generic.ts`
- [Provider selection](https://github.com/solvercaptcha/solvecaptcha-javascript/blob/master/src/structs/providers/providers.ts): `src/structs/providers/providers.ts`
- [Provider endpoints](https://github.com/solvercaptcha/solvecaptcha-javascript/blob/master/src/structs/constants/constants.ts): `src/structs/constants/constants.ts`
- [API errors](https://github.com/solvercaptcha/solvecaptcha-javascript/blob/master/src/structs/solvecaptchaError.ts): `src/structs/solvecaptchaError.ts`

### Callback server

- [HTTP callback server](https://github.com/solvercaptcha/solvecaptcha-javascript/blob/master/src/structs/solvecaptchaServer.ts): `src/structs/solvecaptchaServer.ts`

### Other components

- **Node.js caller**
- **SolveCaptcha API**
- **HTTP clients**

## Connections

- Node.js caller → Package exports: imports (evidence: `src/index.ts`)
- Package exports → Solver operations: exports (evidence: `src/index.ts`)
- Node.js caller → Solver operations: configures (evidence: `README.md`)
- Solver operations → Captcha solve methods: provides (evidence: `README.md`)
- Solver operations → Balance and reports: provides (evidence: `README.md`)
- Captcha solve methods → Parameter mapping: normalizes params (evidence: `src/structs/solvecaptcha.ts`)
- Captcha solve methods → Parameter validation: checks params (evidence: `src/structs/solvecaptcha.ts`)
- Solver operations → Payload formatting: formats payloads (evidence: `src/structs/solvecaptcha.ts`)
- Solver operations → Provider selection: selects provider (evidence: `src/structs/solvecaptcha.ts`)
- Provider selection → Provider endpoints: reads endpoint config (evidence: `src/structs/providers/providers.ts`)
- Solver operations → SolveCaptcha API: submits and polls (evidence: `README.md`)
- Solver operations → HTTP clients: sends requests (evidence: `src/structs/solvecaptcha.ts`)
- Solver operations → API errors: uses errors (evidence: `src/structs/solvecaptcha.ts`)
- Package exports → API errors: exports (evidence: `src/index.ts`)
- HTTP callback server → HTTP clients: creates server (evidence: `src/structs/solvecaptchaServer.ts`)
- HTTP callback server → Solver operations: uses captcha types (evidence: `src/structs/solvecaptchaServer.ts`)
