recognize 2.0.0 → 3.0.0

package/README.md

@@ -0,0 +1,217 @@
+# Recognize
+
+Lightweight zero-dependency captcha solving client for **RuCaptcha** and **Anti-Captcha** services (API v2).
+
+- **0 runtime dependencies** — uses native `fetch` (Node.js 18+)
+- **TypeScript** — full type safety, autocompletion, exported types
+- **Dual ESM/CJS** — works with `import` and `require`
+- **30+ captcha types** — reCAPTCHA, hCaptcha, Turnstile, FunCaptcha, GeeTest, and more
+- **Auto-polling** — waits for result with configurable interval & timeout
+
+## Install
+
+```bash
+npm install recognize
+```
+
+## Quick Start
+
+```ts
+import { RuCaptcha } from "recognize";
+
+const solver = new RuCaptcha({
+  apiKey: "YOUR_API_KEY",
+  pollingInterval: 5000, // optional, default 5000ms
+  timeout: 180000, // optional, default 180000ms
+});
+
+// Check balance
+const balance = await solver.getBalance();
+console.log("Balance:", balance);
+
+// Solve reCAPTCHA v2
+const { taskId, solution } = await solver.recaptchaV2(
+  "https://example.com",
+  "SITE_KEY",
+);
+console.log(solution.gRecaptchaResponse);
+
+// Report result
+await solver.reportCorrect(taskId);
+```
+
+### Anti-Captcha
+
+```ts
+import { AntiCaptcha } from "recognize";
+
+const solver = new AntiCaptcha({ apiKey: "YOUR_API_KEY" });
+```
+
+### Dynamic service selection
+
+```ts
+import { createSolver } from "recognize";
+
+const solver = createSolver("rucaptcha", { apiKey: "YOUR_API_KEY" });
+// or
+const solver2 = createSolver("anticaptcha", { apiKey: "YOUR_API_KEY" });
+```
+
+## Constructor Options
+
+| Option            | Type     | Default  | Description                  |
+| ----------------- | -------- | -------- | ---------------------------- |
+| `apiKey`          | `string` | —        | **Required.** API key        |
+| `pollingInterval` | `number` | `5000`   | Polling interval in ms       |
+| `timeout`         | `number` | `180000` | Max wait time per task in ms |
+
+## API
+
+All solving methods return `Promise<TaskResult<T>>` where `TaskResult<T> = { taskId: number, solution: T }`.
+
+### Account
+
+| Method                    | Description               |
+| ------------------------- | ------------------------- |
+| `getBalance()`            | Get account balance       |
+| `reportCorrect(taskId)`   | Report correct solution   |
+| `reportIncorrect(taskId)` | Report incorrect solution |
+
+### Image & Text
+
+| Method                         | Params                                            | Task Type         |
+| ------------------------------ | ------------------------------------------------- | ----------------- |
+| `imageCaptcha(body, options?)` | `body` — Buffer or base64 string                  | `ImageToTextTask` |
+| `textCaptcha(text, options?)`  | `text` — question string                          | `TextCaptchaTask` |
+| `audioCaptcha(body, lang?)`    | `body` — Buffer or base64, `lang` — language code | `AudioTask`       |
+
+### reCAPTCHA
+
+| Method                                                   | Params                             |
+| -------------------------------------------------------- | ---------------------------------- |
+| `recaptchaV2(url, siteKey, options?)`                    | Supports proxy via `options.proxy` |
+| `recaptchaV3(url, siteKey, action, minScore?, options?)` | `minScore` default `0.3`           |
+| `recaptchaV2Enterprise(url, siteKey, options?)`          | Enterprise version                 |
+
+### hCaptcha
+
+```ts
+await solver.hcaptcha(url, siteKey, options?)
+```
+
+### Cloudflare Turnstile
+
+```ts
+await solver.turnstile(url, siteKey, options?)
+```
+
+### FunCaptcha (Arkose Labs)
+
+```ts
+await solver.funcaptcha(url, publicKey, options?)
+```
+
+### GeeTest
+
+```ts
+await solver.geetest(url, gt, challenge, options?)
+await solver.geetestV4(url, captchaId, options?)
+```
+
+### Amazon WAF
+
+```ts
+await solver.amazonWaf(url, siteKey, options?)
+```
+
+### Other Captcha Types
+
+| Method                                                   | Task Type                         |
+| -------------------------------------------------------- | --------------------------------- |
+| `keyCaptcha(url, options?)`                              | `KeyCaptchaTaskProxyless`         |
+| `lemin(url, captchaId, apiServer, options?)`             | `LeminTaskProxyless`              |
+| `capyPuzzle(url, siteKey, options?)`                     | `CapyTaskProxyless`               |
+| `dataDome(url, captchaUrl, userAgent, proxyConfig)`      | `DataDomeSliderTask`              |
+| `cyberSiara(url, slideMasterUrlId, userAgent, options?)` | `AntiCyberSiAraTaskProxyless`     |
+| `mtCaptcha(url, siteKey, options?)`                      | `MtCaptchaTaskProxyless`          |
+| `friendlyCaptcha(url, siteKey, options?)`                | `FriendlyCaptchaTaskProxyless`    |
+| `cutcaptcha(url, miseryKey, apiKey, options?)`           | `CutCaptchaTaskProxyless`         |
+| `tencent(url, appId, options?)`                          | `TencentTaskProxyless`            |
+| `atbCaptcha(url, appId, apiServer, options?)`            | `AtbCaptchaTaskProxyless`         |
+| `yandexSmart(url, siteKey, options?)`                    | `YandexSmartCaptchaTaskProxyless` |
+| `vkCaptcha(url, siteKey, options?)`                      | `VKCaptchaTaskProxyless`          |
+| `temuCaptcha(url, options?)`                             | `TemuCaptchaTaskProxyless`        |
+
+### Image-Based Tasks
+
+| Method                               | Task Type         |
+| ------------------------------------ | ----------------- |
+| `rotateCaptcha(body, options?)`      | `RotateTask`      |
+| `coordinatesCaptcha(body, options?)` | `CoordinatesTask` |
+| `gridCaptcha(body, options?)`        | `GridTask`        |
+| `boundingBoxCaptcha(body, options?)` | `BoundingBoxTask` |
+| `drawAroundCaptcha(body, options?)`  | `DrawAroundTask`  |
+
+### Generic / Custom
+
+```ts
+// Send any task type directly
+await solver.solve<{ token: string }>({
+  type: "SomeNewTaskType",
+  websiteURL: "https://example.com",
+});
+```
+
+## Proxy Support
+
+Methods that support proxy accept it via options:
+
+```ts
+await solver.recaptchaV2("https://example.com", "SITE_KEY", {
+  proxyType: "http",
+  proxyAddress: "1.2.3.4",
+  proxyPort: 8080,
+  proxyLogin: "user",
+  proxyPassword: "pass",
+  proxy: true,
+});
+```
+
+## Exported Types
+
+```ts
+import type {
+  SolverOptions,
+  TaskResult,
+  TokenSolution,
+  GRecaptchaSolution,
+  ImageSolution,
+  GeeTestSolution,
+  GeeTestV4Solution,
+  ProxyOptions,
+  RecaptchaV2Options,
+  HCaptchaOptions,
+  TurnstileOptions,
+  // ... and more
+} from "recognize";
+```
+
+## Migration from v2
+
+| v2 (old)                                | v3 (current)                    |
+| --------------------------------------- | ------------------------------- |
+| `new Recognize(SOURCE.RUCAPTCHA, {})`   | `new RuCaptcha({ apiKey })`     |
+| `new Recognize(SOURCE.ANTICAPTCHA, {})` | `new AntiCaptcha({ apiKey })`   |
+| `{ key: "..." }`                        | `{ apiKey: "..." }`             |
+| `balanse()`                             | `getBalance()`                  |
+| `solvingImage(buff)`                    | `imageCaptcha(buff)`            |
+| `solvingRecaptcha2()`                   | `recaptchaV2(url, key)`         |
+| `solvingRecaptcha3()`                   | `recaptchaV3(url, key, action)` |
+| `reportGood(id)`                        | `reportCorrect(taskId)`         |
+| `reportBad(id)`                         | `reportIncorrect(taskId)`       |
+| return `{ id, result }`                 | return `{ taskId, solution }`   |
+
+## License
+
+MIT

package/dist/index.cjs

@@ -0,0 +1,426 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  AntiCaptcha: () => AntiCaptcha,
+  RuCaptcha: () => RuCaptcha,
+  Solver: () => Solver,
+  SolverError: () => SolverError,
+  createSolver: () => createSolver
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/solver.ts
+var import_promises = require("timers/promises");
+
+// src/errors.ts
+var SolverError = class extends Error {
+  errorId;
+  errorCode;
+  errorDescription;
+  constructor(errorId, errorCode, errorDescription) {
+    super(errorCode || `Error ${errorId}: ${errorDescription ?? "unknown"}`);
+    this.name = "SolverError";
+    this.errorId = errorId;
+    this.errorCode = errorCode;
+    this.errorDescription = errorDescription ?? "";
+  }
+};
+
+// src/solver.ts
+var Solver = class {
+  _baseUrl;
+  _clientKey;
+  _softId;
+  _pollingInterval;
+  _timeout;
+  constructor(config, options) {
+    if (!options.apiKey) throw new Error("apiKey is required");
+    this._baseUrl = config.baseUrl;
+    this._clientKey = options.apiKey;
+    this._softId = config.softId;
+    this._pollingInterval = options.pollingInterval ?? 5e3;
+    this._timeout = options.timeout ?? 18e4;
+  }
+  // ── Internal helpers ──────────────────────────────────────────────
+  async _post(method, body) {
+    const res = await fetch(`${this._baseUrl}/${method}`, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify(body)
+    });
+    const data = await res.json();
+    if (data.errorId && data.errorId !== 0) {
+      throw new SolverError(
+        data.errorId,
+        data.errorCode ?? "",
+        data.errorDescription
+      );
+    }
+    return data;
+  }
+  async _createTask(task) {
+    const data = await this._post("createTask", {
+      clientKey: this._clientKey,
+      task,
+      softId: this._softId
+    });
+    return data.taskId;
+  }
+  async _getTaskResult(taskId) {
+    const deadline = Date.now() + this._timeout;
+    while (Date.now() < deadline) {
+      await (0, import_promises.setTimeout)(this._pollingInterval);
+      const data = await this._post("getTaskResult", {
+        clientKey: this._clientKey,
+        taskId
+      });
+      if (data.status === "ready") return data.solution;
+    }
+    throw new Error("Timeout waiting for task result");
+  }
+  async _solve(task) {
+    const taskId = await this._createTask(task);
+    const solution = await this._getTaskResult(taskId);
+    return { taskId, solution };
+  }
+  // ── Account ───────────────────────────────────────────────────────
+  async getBalance() {
+    const data = await this._post("getBalance", { clientKey: this._clientKey });
+    return data.balance;
+  }
+  async reportCorrect(taskId) {
+    await this._post("reportCorrect", { clientKey: this._clientKey, taskId });
+    return true;
+  }
+  async reportIncorrect(taskId) {
+    await this._post("reportIncorrect", { clientKey: this._clientKey, taskId });
+    return true;
+  }
+  // ── Image / Text captchas ────────────────────────────────────────
+  async imageCaptcha(body, options = {}) {
+    return this._solve({
+      type: "ImageToTextTask",
+      body: Buffer.isBuffer(body) ? body.toString("base64") : body,
+      ...options
+    });
+  }
+  async textCaptcha(textcaptcha, options = {}) {
+    return this._solve({
+      type: "TextCaptchaTask",
+      ...options,
+      textcaptcha
+    });
+  }
+  async audioCaptcha(body, lang = "en") {
+    return this._solve({
+      type: "AudioTask",
+      body: Buffer.isBuffer(body) ? body.toString("base64") : body,
+      lang
+    });
+  }
+  // ── reCAPTCHA ─────────────────────────────────────────────────────
+  async recaptchaV2(websiteURL, websiteKey, options = {}) {
+    const { proxy, ...rest } = options;
+    return this._solve({
+      type: proxy ? "RecaptchaV2Task" : "RecaptchaV2TaskProxyless",
+      websiteURL,
+      websiteKey,
+      ...rest
+    });
+  }
+  async recaptchaV3(websiteURL, websiteKey, pageAction, minScore = 0.3, options = {}) {
+    return this._solve({
+      type: "RecaptchaV3TaskProxyless",
+      websiteURL,
+      websiteKey,
+      pageAction,
+      minScore,
+      ...options
+    });
+  }
+  async recaptchaV2Enterprise(websiteURL, websiteKey, options = {}) {
+    const { proxy, ...rest } = options;
+    return this._solve({
+      type: proxy ? "RecaptchaV2EnterpriseTask" : "RecaptchaV2EnterpriseTaskProxyless",
+      websiteURL,
+      websiteKey,
+      ...rest
+    });
+  }
+  // ── hCaptcha ──────────────────────────────────────────────────────
+  async hcaptcha(websiteURL, websiteKey, options = {}) {
+    const { proxy, ...rest } = options;
+    return this._solve({
+      type: proxy ? "HCaptchaTask" : "HCaptchaTaskProxyless",
+      websiteURL,
+      websiteKey,
+      ...rest
+    });
+  }
+  // ── FunCaptcha (Arkose Labs) ──────────────────────────────────────
+  async funcaptcha(websiteURL, websitePublicKey, options = {}) {
+    const { proxy, ...rest } = options;
+    return this._solve({
+      type: proxy ? "FunCaptchaTask" : "FunCaptchaTaskProxyless",
+      websiteURL,
+      websitePublicKey,
+      ...rest
+    });
+  }
+  // ── GeeTest ───────────────────────────────────────────────────────
+  async geetest(websiteURL, gt, challenge, options = {}) {
+    const { proxy, ...rest } = options;
+    return this._solve({
+      type: proxy ? "GeeTestTask" : "GeeTestTaskProxyless",
+      websiteURL,
+      gt,
+      challenge,
+      ...rest
+    });
+  }
+  async geetestV4(websiteURL, captchaId, options = {}) {
+    const { proxy, ...rest } = options;
+    return this._solve({
+      type: proxy ? "GeeTestTask" : "GeeTestTaskProxyless",
+      websiteURL,
+      captchaId,
+      version: 4,
+      ...rest
+    });
+  }
+  // ── Cloudflare Turnstile ──────────────────────────────────────────
+  async turnstile(websiteURL, websiteKey, options = {}) {
+    const { proxy, ...rest } = options;
+    return this._solve({
+      type: proxy ? "TurnstileTask" : "TurnstileTaskProxyless",
+      websiteURL,
+      websiteKey,
+      ...rest
+    });
+  }
+  // ── Amazon WAF ────────────────────────────────────────────────────
+  async amazonWaf(websiteURL, websiteKey, options = {}) {
+    return this._solve({
+      type: "AmazonTaskProxyless",
+      websiteURL,
+      websiteKey,
+      ...options
+    });
+  }
+  // ── KeyCaptcha ────────────────────────────────────────────────────
+  async keyCaptcha(websiteURL, options = {}) {
+    return this._solve({
+      type: "KeyCaptchaTaskProxyless",
+      websiteURL,
+      ...options
+    });
+  }
+  // ── Lemin ─────────────────────────────────────────────────────────
+  async lemin(websiteURL, captchaId, apiServer, options = {}) {
+    return this._solve({
+      type: "LeminTaskProxyless",
+      websiteURL,
+      captchaId,
+      apiServer,
+      ...options
+    });
+  }
+  // ── Capy Puzzle ───────────────────────────────────────────────────
+  async capyPuzzle(websiteURL, websiteKey, options = {}) {
+    return this._solve({
+      type: "CapyTaskProxyless",
+      websiteURL,
+      websiteKey,
+      ...options
+    });
+  }
+  // ── DataDome ──────────────────────────────────────────────────────
+  async dataDome(websiteURL, captchaUrl, userAgent, proxyConfig) {
+    return this._solve({
+      type: "DataDomeSliderTask",
+      websiteURL,
+      captchaUrl,
+      userAgent,
+      ...proxyConfig
+    });
+  }
+  // ── CyberSiARA ───────────────────────────────────────────────────
+  async cyberSiara(websiteURL, slideMasterUrlId, userAgent, options = {}) {
+    return this._solve({
+      type: "AntiCyberSiAraTaskProxyless",
+      websiteURL,
+      SlideMasterUrlId: slideMasterUrlId,
+      userAgent,
+      ...options
+    });
+  }
+  // ── MTCaptcha ─────────────────────────────────────────────────────
+  async mtCaptcha(websiteURL, websiteKey, options = {}) {
+    return this._solve({
+      type: "MtCaptchaTaskProxyless",
+      websiteURL,
+      websiteKey,
+      ...options
+    });
+  }
+  // ── Friendly Captcha ─────────────────────────────────────────────
+  async friendlyCaptcha(websiteURL, websiteKey, options = {}) {
+    return this._solve({
+      type: "FriendlyCaptchaTaskProxyless",
+      websiteURL,
+      websiteKey,
+      ...options
+    });
+  }
+  // ── Cutcaptcha ────────────────────────────────────────────────────
+  async cutcaptcha(websiteURL, miseryKey, apiKey, options = {}) {
+    return this._solve({
+      type: "CutCaptchaTaskProxyless",
+      websiteURL,
+      miseryKey,
+      apiKey,
+      ...options
+    });
+  }
+  // ── Tencent ───────────────────────────────────────────────────────
+  async tencent(websiteURL, appId, options = {}) {
+    return this._solve({
+      type: "TencentTaskProxyless",
+      websiteURL,
+      appId,
+      ...options
+    });
+  }
+  // ── atbCAPTCHA ────────────────────────────────────────────────────
+  async atbCaptcha(websiteURL, appId, apiServer, options = {}) {
+    return this._solve({
+      type: "AtbCaptchaTaskProxyless",
+      websiteURL,
+      appId,
+      apiServer,
+      ...options
+    });
+  }
+  // ── Rotate ────────────────────────────────────────────────────────
+  async rotateCaptcha(body, options = {}) {
+    return this._solve({
+      type: "RotateTask",
+      body: Buffer.isBuffer(body) ? body.toString("base64") : body,
+      ...options
+    });
+  }
+  // ── Coordinates (click) ───────────────────────────────────────────
+  async coordinatesCaptcha(body, options = {}) {
+    return this._solve({
+      type: "CoordinatesTask",
+      body: Buffer.isBuffer(body) ? body.toString("base64") : body,
+      ...options
+    });
+  }
+  // ── Grid ──────────────────────────────────────────────────────────
+  async gridCaptcha(body, options = {}) {
+    return this._solve({
+      type: "GridTask",
+      body: Buffer.isBuffer(body) ? body.toString("base64") : body,
+      ...options
+    });
+  }
+  // ── Bounding Box ──────────────────────────────────────────────────
+  async boundingBoxCaptcha(body, options = {}) {
+    return this._solve({
+      type: "BoundingBoxTask",
+      body: Buffer.isBuffer(body) ? body.toString("base64") : body,
+      ...options
+    });
+  }
+  // ── Draw Around (Canvas) ──────────────────────────────────────────
+  async drawAroundCaptcha(body, options = {}) {
+    return this._solve({
+      type: "DrawAroundTask",
+      body: Buffer.isBuffer(body) ? body.toString("base64") : body,
+      ...options
+    });
+  }
+  // ── Yandex Smart Captcha ─────────────────────────────────────────
+  async yandexSmart(websiteURL, websiteKey, options = {}) {
+    return this._solve({
+      type: "YandexSmartCaptchaTaskProxyless",
+      websiteURL,
+      websiteKey,
+      ...options
+    });
+  }
+  // ── VK Captcha ────────────────────────────────────────────────────
+  async vkCaptcha(websiteURL, websiteKey, options = {}) {
+    return this._solve({
+      type: "VKCaptchaTaskProxyless",
+      websiteURL,
+      websiteKey,
+      ...options
+    });
+  }
+  // ── Temu Captcha ──────────────────────────────────────────────────
+  async temuCaptcha(websiteURL, options = {}) {
+    return this._solve({
+      type: "TemuCaptchaTaskProxyless",
+      websiteURL,
+      ...options
+    });
+  }
+  // ── Generic / Custom task ─────────────────────────────────────────
+  async solve(task) {
+    return this._solve(task);
+  }
+};
+
+// src/rucaptcha.ts
+var RuCaptcha = class extends Solver {
+  constructor(options) {
+    super({ baseUrl: "https://api.rucaptcha.com", softId: 768 }, options);
+  }
+};
+
+// src/anticaptcha.ts
+var AntiCaptcha = class extends Solver {
+  constructor(options) {
+    super({ baseUrl: "https://api.anti-captcha.com", softId: 720 }, options);
+  }
+};
+
+// src/index.ts
+var services = {
+  rucaptcha: RuCaptcha,
+  anticaptcha: AntiCaptcha
+};
+function createSolver(service, options) {
+  const ServiceClass = services[service];
+  return new ServiceClass(options);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  AntiCaptcha,
+  RuCaptcha,
+  Solver,
+  SolverError,
+  createSolver
+});
+//# sourceMappingURL=index.cjs.map