solvecaptcha-client 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,15 @@
+ISC License
+
+Copyright (c) 2026 api-kit contributors
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
+ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
+OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

package/README.md

@@ -1,3 +1,93 @@
-# Temporary Holding Version
+# solvecaptcha-client
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+TypeScript and Node.js client for the [SolveCaptcha API](https://solvecaptcha.com/captcha-solver-api).
+
+## Features
+
+- Solves normal image captchas, text questions, Google reCAPTCHA (v2/v3), Cloudflare Turnstile, FunCaptcha, and GeeTest
+- Built-in polling mechanism with configurable timeout and intervals
+- Support for feedback reporting (`reportGood`, `reportBad`) for accuracy tracking
+- Written in TypeScript with complete type declarations and TSDoc
+
+## Installation
+
+```bash
+npm install solvecaptcha-client
+```
+
+## Quick Start
+
+```typescript
+import { SolveCaptchaClient } from 'solvecaptcha-client';
+
+const client = new SolveCaptchaClient({
+  apiKey: process.env.SOLVECAPTCHA_API_KEY!,
+});
+
+async function main() {
+  // Check account balance
+  const balance = await client.getBalance();
+  console.log(`Current balance: $${balance.toFixed(4)}`);
+}
+
+main().catch(console.error);
+```
+
+## Solving Captchas
+
+### Image Captcha
+
+```typescript
+import { SolveCaptchaClient } from 'solvecaptcha-client';
+
+const client = new SolveCaptchaClient({ apiKey: 'YOUR_API_KEY' });
+
+const solution = await client.solveImage({
+  body: 'iVBORw0KGgoAAAANSUhEUgAA...', // Base64-encoded image
+  numeric: 4, // Both numbers and letters
+});
+
+console.log(`Solved text: ${solution}`);
+```
+
+### Google reCAPTCHA V2
+
+```typescript
+const token = await client.solveRecaptchaV2({
+  googlekey: '6Le-wvkSAAAAAPBMRTvw0Q4Muexq9bi0DJwx_mJ-',
+  pageurl: 'https://example.com/login',
+});
+
+console.log(`reCAPTCHA token: ${token}`);
+```
+
+### Cloudflare Turnstile
+
+```typescript
+const token = await client.solveTurnstile({
+  sitekey: '0x4AAAAAAABnEBq1w7gYv_m-',
+  pageurl: 'https://example.com/protected',
+});
+
+console.log(`Turnstile token: ${token}`);
+```
+
+## API Methods
+
+- `getBalance(): Promise<number>` — Returns the current balance in USD.
+- `solveImage(options: ImageCaptchaOptions | string): Promise<string>` — Solves an image captcha.
+- `solveText(text: string, options?: TextCaptchaOptions): Promise<string>` — Solves a text question captcha.
+- `solveRecaptchaV2(options: RecaptchaV2Options): Promise<string>` — Solves Google reCAPTCHA V2.
+- `solveRecaptchaV3(options: RecaptchaV3Options): Promise<string>` — Solves Google reCAPTCHA V3.
+- `solveTurnstile(options: TurnstileOptions): Promise<string>` — Solves Cloudflare Turnstile.
+- `solveFunCaptcha(options: FunCaptchaOptions): Promise<string>` — Solves Arkose Labs FunCaptcha.
+- `solveGeeTest(options: GeeTestOptions): Promise<GeeTestResult>` — Solves GeeTest.
+- `createTask(params): Promise<string>` — Submits a task to `/in.php` and returns task ID.
+- `getTaskResult(taskId): Promise<string | null>` — Checks task resolution status.
+- `waitForResult(taskId, timeoutMs?, intervalMs?): Promise<string>` — Polls until task is solved.
+- `reportGood(taskId): Promise<boolean>` — Submits positive accuracy feedback.
+- `reportBad(taskId): Promise<boolean>` — Submits incorrect solution report.
+
+## License
+
+ISC

package/dist/index.d.ts

@@ -0,0 +1,403 @@
+/**
+ * Default software/affiliate identifier (empty if none assigned).
+ */
+export declare const DEFAULT_SOFT_ID = "";
+/**
+ * Configuration options for the SolveCaptchaClient.
+ */
+export interface SolveCaptchaClientOptions {
+    /**
+     * API key obtained from SolveCaptcha dashboard.
+     */
+    apiKey: string;
+    /**
+     * Base URL for the SolveCaptcha API. Defaults to https://api.solvecaptcha.com.
+     */
+    baseURL?: string;
+    /**
+     * Request timeout in milliseconds. Defaults to 30000 ms.
+     */
+    timeout?: number;
+    /**
+     * Optional partner/software ID.
+     */
+    softId?: string | number;
+    /**
+     * Default polling timeout in milliseconds for captcha resolution. Defaults to 120000 ms.
+     */
+    defaultPollingTimeoutMs?: number;
+    /**
+     * Default polling interval in milliseconds. Defaults to 5000 ms.
+     */
+    defaultPollingIntervalMs?: number;
+}
+/**
+ * Options for solving a normal image captcha.
+ */
+export interface ImageCaptchaOptions {
+    /**
+     * Base64 encoded image string.
+     */
+    body: string;
+    /**
+     * 0 = single word, 1 = two or more words.
+     */
+    phrase?: 0 | 1;
+    /**
+     * 0 = case insensitive, 1 = case sensitive.
+     */
+    regsense?: 0 | 1;
+    /**
+     * 0 = not specified, 1 = only numbers, 2 = only letters, 3 = only numbers OR only letters, 4 = both numbers and letters.
+     */
+    numeric?: 0 | 1 | 2 | 3 | 4;
+    /**
+     * 0 = no math, 1 = requires calculation.
+     */
+    calc?: 0 | 1;
+    /**
+     * Minimum number of characters.
+     */
+    minLen?: number;
+    /**
+     * Maximum number of characters.
+     */
+    maxLen?: number;
+    /**
+     * 0 = not specified, 1 = Cyrillic, 2 = Latin.
+     */
+    language?: 0 | 1 | 2;
+    /**
+     * Optional text instructions for the worker.
+     */
+    textinstructions?: string;
+}
+/**
+ * Options for solving a text question captcha.
+ */
+export interface TextCaptchaOptions {
+    /**
+     * 0 = not specified, 1 = Cyrillic, 2 = Latin.
+     */
+    language?: 0 | 1 | 2;
+}
+/**
+ * Options for solving Google reCAPTCHA V2.
+ */
+export interface RecaptchaV2Options {
+    /**
+     * Sitekey found in target page HTML.
+     */
+    googlekey: string;
+    /**
+     * Full URL of the page containing the reCAPTCHA.
+     */
+    pageurl: string;
+    /**
+     * Whether the reCAPTCHA is invisible.
+     */
+    invisible?: boolean;
+    /**
+     * Optional 'data-s' parameter value for protected endpoints.
+     */
+    dataS?: string;
+}
+/**
+ * Options for solving Google reCAPTCHA V3.
+ */
+export interface RecaptchaV3Options {
+    /**
+     * Sitekey found in target page HTML.
+     */
+    googlekey: string;
+    /**
+     * Full URL of the page containing the reCAPTCHA.
+     */
+    pageurl: string;
+    /**
+     * Action parameter value.
+     */
+    action?: string;
+    /**
+     * Minimum required score (e.g. 0.3, 0.7, 0.9).
+     */
+    minScore?: number;
+}
+/**
+ * Options for solving Cloudflare Turnstile.
+ */
+export interface TurnstileOptions {
+    /**
+     * Turnstile sitekey.
+     */
+    sitekey: string;
+    /**
+     * Full URL of the page with the Turnstile widget.
+     */
+    pageurl: string;
+    /**
+     * Optional action parameter.
+     */
+    action?: string;
+    /**
+     * Optional cData parameter.
+     */
+    data?: string;
+    /**
+     * Optional pagedata parameter.
+     */
+    pagedata?: string;
+}
+/**
+ * Options for solving Arkose Labs FunCaptcha.
+ */
+export interface FunCaptchaOptions {
+    /**
+     * FunCaptcha public key.
+     */
+    publickey: string;
+    /**
+     * Full URL of the page containing FunCaptcha.
+     */
+    pageurl: string;
+    /**
+     * Custom service URL (surl).
+     */
+    surl?: string;
+    /**
+     * Custom data payload.
+     */
+    data?: Record<string, unknown> | string;
+}
+/**
+ * Options for solving GeeTest captcha.
+ */
+export interface GeeTestOptions {
+    /**
+     * GeeTest 'gt' key.
+     */
+    gt: string;
+    /**
+     * GeeTest 'challenge' token.
+     */
+    challenge: string;
+    /**
+     * Full URL of the page containing GeeTest.
+     */
+    pageurl: string;
+    /**
+     * Optional custom api_server domain.
+     */
+    apiServer?: string;
+}
+/**
+ * Result returned for GeeTest captcha solutions.
+ */
+export interface GeeTestResult {
+    challenge: string;
+    validate: string;
+    seccode: string;
+}
+/**
+ * Known error descriptions for SolveCaptcha.
+ */
+export declare const SOLVE_CAPTCHA_ERRORS: Record<string, string>;
+/**
+ * Error thrown by the SolveCaptcha client when API requests or solving tasks fail.
+ */
+export declare class SolveCaptchaError extends Error {
+    /**
+     * Error code returned by SolveCaptcha.
+     */
+    readonly code?: string;
+    /**
+     * Raw server response payload.
+     */
+    readonly responseBody?: unknown;
+    constructor(message: string, code?: string, responseBody?: unknown);
+}
+/**
+ * Client for the SolveCaptcha human and AI captcha solving service.
+ */
+export declare class SolveCaptchaClient {
+    private readonly apiKey;
+    private readonly softId;
+    private readonly pollingTimeoutMs;
+    private readonly pollingIntervalMs;
+    private readonly http;
+    /**
+     * Creates a new SolveCaptchaClient.
+     *
+     * @param options - API key string or configuration object.
+     *
+     * @example
+     * ```typescript
+     * import { SolveCaptchaClient } from 'solvecaptcha-client';
+     *
+     * const client = new SolveCaptchaClient({ apiKey: 'YOUR_API_KEY' });
+     * const balance = await client.getBalance();
+     * console.log(`Balance: $${balance}`);
+     * ```
+     */
+    constructor(options: SolveCaptchaClientOptions | string);
+    /**
+     * Retrieves the current account balance.
+     *
+     * @returns Current balance in USD.
+     *
+     * @example
+     * ```typescript
+     * const balance = await client.getBalance();
+     * console.log(`Current balance: $${balance}`);
+     * ```
+     */
+    getBalance(): Promise<number>;
+    /**
+     * Solves an image-based captcha from base64 data.
+     *
+     * @param options - Image parameters or base64 string.
+     * @returns Solved captcha text solution.
+     *
+     * @example
+     * ```typescript
+     * const text = await client.solveImage({
+     *   body: 'iVBORw0KGgoAAAANSUhEUgAA...',
+     * });
+     * console.log(`Solved text: ${text}`);
+     * ```
+     */
+    solveImage(options: ImageCaptchaOptions | string): Promise<string>;
+    /**
+     * Solves a text question captcha.
+     *
+     * @param text - The question text to answer.
+     * @param options - Additional options.
+     * @returns Answer to the question.
+     *
+     * @example
+     * ```typescript
+     * const answer = await client.solveText('If tomorrow is Saturday, what day is today?');
+     * console.log(`Answer: ${answer}`);
+     * ```
+     */
+    solveText(text: string, options?: TextCaptchaOptions): Promise<string>;
+    /**
+     * Solves Google reCAPTCHA V2.
+     *
+     * @param options - reCAPTCHA V2 options.
+     * @returns Solution token.
+     *
+     * @example
+     * ```typescript
+     * const token = await client.solveRecaptchaV2({
+     *   googlekey: '6Le-wvkSAAAAAPBMRTvw0Q4Muexq9bi0DJwx_mJ-',
+     *   pageurl: 'https://example.com/login',
+     * });
+     * console.log('Token:', token);
+     * ```
+     */
+    solveRecaptchaV2(options: RecaptchaV2Options): Promise<string>;
+    /**
+     * Solves Google reCAPTCHA V3.
+     *
+     * @param options - reCAPTCHA V3 options.
+     * @returns Solution token.
+     *
+     * @example
+     * ```typescript
+     * const token = await client.solveRecaptchaV3({
+     *   googlekey: '6Le-wvkSAAAAAPBMRTvw0Q4Muexq9bi0DJwx_mJ-',
+     *   pageurl: 'https://example.com/login',
+     *   action: 'verify',
+     *   minScore: 0.7,
+     * });
+     * ```
+     */
+    solveRecaptchaV3(options: RecaptchaV3Options): Promise<string>;
+    /**
+     * Solves Cloudflare Turnstile.
+     *
+     * @param options - Turnstile options.
+     * @returns Turnstile token.
+     *
+     * @example
+     * ```typescript
+     * const token = await client.solveTurnstile({
+     *   sitekey: '0x4AAAAAAABnEBq1w7gYv_m-',
+     *   pageurl: 'https://example.com/page',
+     * });
+     * ```
+     */
+    solveTurnstile(options: TurnstileOptions): Promise<string>;
+    /**
+     * Solves Arkose Labs FunCaptcha.
+     *
+     * @param options - FunCaptcha options.
+     * @returns Solution token.
+     *
+     * @example
+     * ```typescript
+     * const token = await client.solveFunCaptcha({
+     *   publickey: '69A21A01-CC43-44CC-A7DC-3E088835E78D',
+     *   pageurl: 'https://example.com/signup',
+     * });
+     * ```
+     */
+    solveFunCaptcha(options: FunCaptchaOptions): Promise<string>;
+    /**
+     * Solves GeeTest captcha.
+     *
+     * @param options - GeeTest options.
+     * @returns GeeTestResult object with challenge, validate, and seccode.
+     *
+     * @example
+     * ```typescript
+     * const res = await client.solveGeeTest({
+     *   gt: '022397c99c9d64352069eab73bc373d7',
+     *   challenge: '3049170ffb08bb6b907572ca35489f07',
+     *   pageurl: 'https://example.com/geetest',
+     * });
+     * console.log(res.validate);
+     * ```
+     */
+    solveGeeTest(options: GeeTestOptions): Promise<GeeTestResult>;
+    /**
+     * Submits a captcha task to /in.php and returns the assigned task ID.
+     *
+     * @param params - Task parameters.
+     * @returns Assigned numeric task ID string.
+     */
+    createTask(params: Record<string, unknown>): Promise<string>;
+    /**
+     * Checks the status and gets the result of a submitted task.
+     *
+     * @param taskId - Task ID returned by createTask.
+     * @returns Solution string, or null if captcha is still being solved.
+     */
+    getTaskResult(taskId: string): Promise<string | null>;
+    /**
+     * Polls until a captcha task is solved or timeout occurs.
+     *
+     * @param taskId - Task ID.
+     * @param timeoutMs - Maximum milliseconds to wait.
+     * @param intervalMs - Polling interval in milliseconds.
+     * @returns Solved captcha string.
+     */
+    waitForResult(taskId: string, timeoutMs?: number, intervalMs?: number): Promise<string>;
+    /**
+     * Reports that a captcha was solved correctly.
+     *
+     * @param taskId - Task ID.
+     * @returns True if report recorded.
+     */
+    reportGood(taskId: string): Promise<boolean>;
+    /**
+     * Reports that a captcha was solved incorrectly to request a refund.
+     *
+     * @param taskId - Task ID.
+     * @returns True if report recorded.
+     */
+    reportBad(taskId: string): Promise<boolean>;
+    private queryResult;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -0,0 +1,477 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SolveCaptchaClient = exports.SolveCaptchaError = exports.SOLVE_CAPTCHA_ERRORS = exports.DEFAULT_SOFT_ID = void 0;
+const axios_1 = __importDefault(require("axios"));
+/**
+ * Default software/affiliate identifier (empty if none assigned).
+ */
+exports.DEFAULT_SOFT_ID = '';
+/**
+ * Known error descriptions for SolveCaptcha.
+ */
+exports.SOLVE_CAPTCHA_ERRORS = {
+    ERROR_WRONG_USER_KEY: 'API key is invalid or formatted incorrectly',
+    ERROR_KEY_DOES_NOT_EXIST: 'API key not found in SolveCaptcha system',
+    ERROR_ZERO_BALANCE: 'Account balance is zero or depleted',
+    ERROR_NO_SLOT_AVAILABLE: 'No idle workers available at the moment',
+    ERROR_ZERO_CAPTCHA_FILESIZE: 'Uploaded image file size is 0 bytes',
+    ERROR_TOO_BIG_CAPTCHA_FILESIZE: 'Uploaded image exceeds maximum size limit (100 KB)',
+    ERROR_WRONG_FILE_EXTENSION: 'File extension is not supported',
+    ERROR_IMAGE_TYPE_NOT_SUPPORTED: 'Image format cannot be loaded or is corrupted',
+    ERROR_IP_NOT_ALLOWED: 'Your IP address is not whitelisted or is blocked',
+    IP_BANNED: 'Your IP address has been temporarily banned due to excessive failed attempts',
+    ERROR_CAPTCHA_UNSOLVABLE: 'Worker could not solve the submitted captcha',
+    ERROR_BAD_DUPLICATES: 'Maximum duplicate requests limit reached',
+    REPORT_NOT_RECORDED: 'Feedback report could not be recorded',
+};
+/**
+ * Error thrown by the SolveCaptcha client when API requests or solving tasks fail.
+ */
+class SolveCaptchaError extends Error {
+    /**
+     * Error code returned by SolveCaptcha.
+     */
+    code;
+    /**
+     * Raw server response payload.
+     */
+    responseBody;
+    constructor(message, code, responseBody) {
+        super(message);
+        this.name = 'SolveCaptchaError';
+        this.code = code;
+        this.responseBody = responseBody;
+        Object.setPrototypeOf(this, SolveCaptchaError.prototype);
+    }
+}
+exports.SolveCaptchaError = SolveCaptchaError;
+/**
+ * Client for the SolveCaptcha human and AI captcha solving service.
+ */
+class SolveCaptchaClient {
+    apiKey;
+    softId;
+    pollingTimeoutMs;
+    pollingIntervalMs;
+    http;
+    /**
+     * Creates a new SolveCaptchaClient.
+     *
+     * @param options - API key string or configuration object.
+     *
+     * @example
+     * ```typescript
+     * import { SolveCaptchaClient } from 'solvecaptcha-client';
+     *
+     * const client = new SolveCaptchaClient({ apiKey: 'YOUR_API_KEY' });
+     * const balance = await client.getBalance();
+     * console.log(`Balance: $${balance}`);
+     * ```
+     */
+    constructor(options) {
+        if (typeof options === 'string') {
+            this.apiKey = options.trim();
+            this.softId = exports.DEFAULT_SOFT_ID;
+            this.pollingTimeoutMs = 120000;
+            this.pollingIntervalMs = 5000;
+            this.http = axios_1.default.create({
+                baseURL: 'https://api.solvecaptcha.com',
+                timeout: 30000,
+            });
+        }
+        else {
+            if (!options || !options.apiKey || !options.apiKey.trim()) {
+                throw new SolveCaptchaError('API key is required to initialize SolveCaptchaClient', 'ERROR_KEY_DOES_NOT_EXIST');
+            }
+            this.apiKey = options.apiKey.trim();
+            this.softId = options.softId ?? exports.DEFAULT_SOFT_ID;
+            this.pollingTimeoutMs = options.defaultPollingTimeoutMs ?? 120000;
+            this.pollingIntervalMs = options.defaultPollingIntervalMs ?? 5000;
+            this.http = axios_1.default.create({
+                baseURL: options.baseURL || 'https://api.solvecaptcha.com',
+                timeout: options.timeout || 30000,
+            });
+        }
+    }
+    /**
+     * Retrieves the current account balance.
+     *
+     * @returns Current balance in USD.
+     *
+     * @example
+     * ```typescript
+     * const balance = await client.getBalance();
+     * console.log(`Current balance: $${balance}`);
+     * ```
+     */
+    async getBalance() {
+        const data = await this.queryResult({
+            action: 'getbalance',
+        });
+        const balance = parseFloat(data);
+        if (Number.isNaN(balance)) {
+            throw new SolveCaptchaError(`Failed to parse balance: ${data}`, 'PARSE_ERROR', data);
+        }
+        return balance;
+    }
+    /**
+     * Solves an image-based captcha from base64 data.
+     *
+     * @param options - Image parameters or base64 string.
+     * @returns Solved captcha text solution.
+     *
+     * @example
+     * ```typescript
+     * const text = await client.solveImage({
+     *   body: 'iVBORw0KGgoAAAANSUhEUgAA...',
+     * });
+     * console.log(`Solved text: ${text}`);
+     * ```
+     */
+    async solveImage(options) {
+        const opt = typeof options === 'string' ? { body: options } : options;
+        const params = {
+            method: 'base64',
+            body: opt.body,
+        };
+        if (opt.phrase !== undefined)
+            params.phrase = opt.phrase;
+        if (opt.regsense !== undefined)
+            params.regsense = opt.regsense;
+        if (opt.numeric !== undefined)
+            params.numeric = opt.numeric;
+        if (opt.calc !== undefined)
+            params.calc = opt.calc;
+        if (opt.minLen !== undefined)
+            params.min_len = opt.minLen;
+        if (opt.maxLen !== undefined)
+            params.max_len = opt.maxLen;
+        if (opt.language !== undefined)
+            params.language = opt.language;
+        if (opt.textinstructions !== undefined)
+            params.textinstructions = opt.textinstructions;
+        const taskId = await this.createTask(params);
+        return this.waitForResult(taskId);
+    }
+    /**
+     * Solves a text question captcha.
+     *
+     * @param text - The question text to answer.
+     * @param options - Additional options.
+     * @returns Answer to the question.
+     *
+     * @example
+     * ```typescript
+     * const answer = await client.solveText('If tomorrow is Saturday, what day is today?');
+     * console.log(`Answer: ${answer}`);
+     * ```
+     */
+    async solveText(text, options) {
+        const params = {
+            textcaptcha: text,
+        };
+        if (options?.language !== undefined)
+            params.language = options.language;
+        const taskId = await this.createTask(params);
+        return this.waitForResult(taskId);
+    }
+    /**
+     * Solves Google reCAPTCHA V2.
+     *
+     * @param options - reCAPTCHA V2 options.
+     * @returns Solution token.
+     *
+     * @example
+     * ```typescript
+     * const token = await client.solveRecaptchaV2({
+     *   googlekey: '6Le-wvkSAAAAAPBMRTvw0Q4Muexq9bi0DJwx_mJ-',
+     *   pageurl: 'https://example.com/login',
+     * });
+     * console.log('Token:', token);
+     * ```
+     */
+    async solveRecaptchaV2(options) {
+        const params = {
+            method: 'userrecaptcha',
+            googlekey: options.googlekey,
+            pageurl: options.pageurl,
+        };
+        if (options.invisible)
+            params.invisible = 1;
+        if (options.dataS)
+            params['data-s'] = options.dataS;
+        const taskId = await this.createTask(params);
+        return this.waitForResult(taskId);
+    }
+    /**
+     * Solves Google reCAPTCHA V3.
+     *
+     * @param options - reCAPTCHA V3 options.
+     * @returns Solution token.
+     *
+     * @example
+     * ```typescript
+     * const token = await client.solveRecaptchaV3({
+     *   googlekey: '6Le-wvkSAAAAAPBMRTvw0Q4Muexq9bi0DJwx_mJ-',
+     *   pageurl: 'https://example.com/login',
+     *   action: 'verify',
+     *   minScore: 0.7,
+     * });
+     * ```
+     */
+    async solveRecaptchaV3(options) {
+        const params = {
+            method: 'userrecaptcha',
+            version: 'v3',
+            googlekey: options.googlekey,
+            pageurl: options.pageurl,
+        };
+        if (options.action)
+            params.action = options.action;
+        if (options.minScore !== undefined)
+            params.min_score = options.minScore;
+        const taskId = await this.createTask(params);
+        return this.waitForResult(taskId);
+    }
+    /**
+     * Solves Cloudflare Turnstile.
+     *
+     * @param options - Turnstile options.
+     * @returns Turnstile token.
+     *
+     * @example
+     * ```typescript
+     * const token = await client.solveTurnstile({
+     *   sitekey: '0x4AAAAAAABnEBq1w7gYv_m-',
+     *   pageurl: 'https://example.com/page',
+     * });
+     * ```
+     */
+    async solveTurnstile(options) {
+        const params = {
+            method: 'turnstile',
+            sitekey: options.sitekey,
+            pageurl: options.pageurl,
+        };
+        if (options.action)
+            params.action = options.action;
+        if (options.data)
+            params.data = options.data;
+        if (options.pagedata)
+            params.pagedata = options.pagedata;
+        const taskId = await this.createTask(params);
+        return this.waitForResult(taskId);
+    }
+    /**
+     * Solves Arkose Labs FunCaptcha.
+     *
+     * @param options - FunCaptcha options.
+     * @returns Solution token.
+     *
+     * @example
+     * ```typescript
+     * const token = await client.solveFunCaptcha({
+     *   publickey: '69A21A01-CC43-44CC-A7DC-3E088835E78D',
+     *   pageurl: 'https://example.com/signup',
+     * });
+     * ```
+     */
+    async solveFunCaptcha(options) {
+        const params = {
+            method: 'funcaptcha',
+            publickey: options.publickey,
+            pageurl: options.pageurl,
+        };
+        if (options.surl)
+            params.surl = options.surl;
+        if (options.data) {
+            params.data = typeof options.data === 'string' ? options.data : JSON.stringify(options.data);
+        }
+        const taskId = await this.createTask(params);
+        return this.waitForResult(taskId);
+    }
+    /**
+     * Solves GeeTest captcha.
+     *
+     * @param options - GeeTest options.
+     * @returns GeeTestResult object with challenge, validate, and seccode.
+     *
+     * @example
+     * ```typescript
+     * const res = await client.solveGeeTest({
+     *   gt: '022397c99c9d64352069eab73bc373d7',
+     *   challenge: '3049170ffb08bb6b907572ca35489f07',
+     *   pageurl: 'https://example.com/geetest',
+     * });
+     * console.log(res.validate);
+     * ```
+     */
+    async solveGeeTest(options) {
+        const params = {
+            method: 'geetest',
+            gt: options.gt,
+            challenge: options.challenge,
+            pageurl: options.pageurl,
+        };
+        if (options.apiServer)
+            params.api_server = options.apiServer;
+        const taskId = await this.createTask(params);
+        const rawResult = await this.waitForResult(taskId);
+        try {
+            return JSON.parse(rawResult);
+        }
+        catch {
+            throw new SolveCaptchaError(`Failed to parse GeeTest solution: ${rawResult}`, 'PARSE_ERROR', rawResult);
+        }
+    }
+    /**
+     * Submits a captcha task to /in.php and returns the assigned task ID.
+     *
+     * @param params - Task parameters.
+     * @returns Assigned numeric task ID string.
+     */
+    async createTask(params) {
+        const payload = {
+            key: this.apiKey,
+            json: 1,
+            ...params,
+        };
+        if (this.softId && payload.soft_id === undefined) {
+            payload.soft_id = this.softId;
+        }
+        try {
+            const response = await this.http.post('/in.php', null, {
+                params: payload,
+            });
+            const data = response.data;
+            if (data && typeof data === 'object') {
+                if (data.status === 1 && data.request) {
+                    return String(data.request);
+                }
+                if (data.status === 0 && data.request) {
+                    const code = String(data.request);
+                    const desc = exports.SOLVE_CAPTCHA_ERRORS[code] || `SolveCaptcha error: ${code}`;
+                    throw new SolveCaptchaError(desc, code, data);
+                }
+            }
+            throw new SolveCaptchaError(`Unexpected /in.php response: ${JSON.stringify(data)}`, 'INVALID_RESPONSE', data);
+        }
+        catch (err) {
+            if (err instanceof SolveCaptchaError) {
+                throw err;
+            }
+            throw new SolveCaptchaError(`createTask request failed: ${err instanceof Error ? err.message : String(err)}`, 'NETWORK_ERROR');
+        }
+    }
+    /**
+     * Checks the status and gets the result of a submitted task.
+     *
+     * @param taskId - Task ID returned by createTask.
+     * @returns Solution string, or null if captcha is still being solved.
+     */
+    async getTaskResult(taskId) {
+        try {
+            return await this.queryResult({
+                action: 'get',
+                id: taskId,
+            });
+        }
+        catch (err) {
+            if (err instanceof SolveCaptchaError && err.code === 'CAPCHA_NOT_READY') {
+                return null;
+            }
+            throw err;
+        }
+    }
+    /**
+     * Polls until a captcha task is solved or timeout occurs.
+     *
+     * @param taskId - Task ID.
+     * @param timeoutMs - Maximum milliseconds to wait.
+     * @param intervalMs - Polling interval in milliseconds.
+     * @returns Solved captcha string.
+     */
+    async waitForResult(taskId, timeoutMs, intervalMs) {
+        const timeout = timeoutMs ?? this.pollingTimeoutMs;
+        const interval = intervalMs ?? this.pollingIntervalMs;
+        const start = Date.now();
+        while (Date.now() - start < timeout) {
+            await new Promise((resolve) => setTimeout(resolve, interval));
+            const res = await this.getTaskResult(taskId);
+            if (res !== null) {
+                return res;
+            }
+        }
+        throw new SolveCaptchaError(`Captcha solving timed out after ${timeout}ms`, 'TIMEOUT');
+    }
+    /**
+     * Reports that a captcha was solved correctly.
+     *
+     * @param taskId - Task ID.
+     * @returns True if report recorded.
+     */
+    async reportGood(taskId) {
+        try {
+            const res = await this.queryResult({
+                action: 'reportgood',
+                id: taskId,
+            });
+            return res === 'OK_REPORT_RECORDED';
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Reports that a captcha was solved incorrectly to request a refund.
+     *
+     * @param taskId - Task ID.
+     * @returns True if report recorded.
+     */
+    async reportBad(taskId) {
+        try {
+            const res = await this.queryResult({
+                action: 'reportbad',
+                id: taskId,
+            });
+            return res === 'OK_REPORT_RECORDED';
+        }
+        catch {
+            return false;
+        }
+    }
+    async queryResult(params) {
+        try {
+            const response = await this.http.get('/res.php', {
+                params: {
+                    key: this.apiKey,
+                    json: 1,
+                    ...params,
+                },
+            });
+            const data = response.data;
+            if (data && typeof data === 'object') {
+                if (data.status === 1 && data.request !== undefined) {
+                    return String(data.request);
+                }
+                if (data.status === 0 && data.request) {
+                    const code = String(data.request);
+                    const desc = exports.SOLVE_CAPTCHA_ERRORS[code] || `SolveCaptcha error: ${code}`;
+                    throw new SolveCaptchaError(desc, code, data);
+                }
+            }
+            throw new SolveCaptchaError(`Unexpected /res.php response: ${JSON.stringify(data)}`, 'INVALID_RESPONSE', data);
+        }
+        catch (err) {
+            if (err instanceof SolveCaptchaError) {
+                throw err;
+            }
+            throw new SolveCaptchaError(`queryResult failed: ${err instanceof Error ? err.message : String(err)}`, 'NETWORK_ERROR');
+        }
+    }
+}
+exports.SolveCaptchaClient = SolveCaptchaClient;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,52 @@
 {
   "name": "solvecaptcha-client",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0",
+  "description": "TypeScript client for the SolveCaptcha human and AI captcha solving API",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "test": "jest",
+    "test:live": "jest --testPathPattern=test/live --testPathIgnorePatterns=/node_modules/",
+    "docs": "typedoc --options typedoc.json"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/TysikGG/api-kit.git",
+    "directory": "solvecaptcha/js"
+  },
+  "keywords": [
+    "solvecaptcha",
+    "captcha-solver",
+    "recaptcha",
+    "hcaptcha",
+    "turnstile",
+    "funcaptcha"
+  ],
+  "license": "ISC",
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "axios": "^1.20.0"
+  },
+  "devDependencies": {
+    "@types/jest": "^29.5.14",
+    "@types/node": "^22.10.2",
+    "axios-mock-adapter": "^2.1.0",
+    "jest": "^29.7.0",
+    "ts-jest": "^29.2.5",
+    "typedoc": "^0.28.1",
+    "typedoc-plugin-markdown": "^4.6.0",
+    "typescript": "^5.7.2"
+  }
+}