gatsbie 1.0.0

package/dist/index.js

@@ -0,0 +1,395 @@
+"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, {
+  APIError: () => APIError,
+  Client: () => Client,
+  ErrorCode: () => ErrorCode,
+  GatsbieError: () => GatsbieError,
+  RequestError: () => RequestError
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/errors.ts
+var ErrorCode = {
+  AUTH_FAILED: "AUTH_FAILED",
+  INSUFFICIENT_CREDITS: "INSUFFICIENT_CREDITS",
+  INVALID_REQUEST: "INVALID_REQUEST",
+  UPSTREAM_ERROR: "UPSTREAM_ERROR",
+  SOLVE_FAILED: "SOLVE_FAILED",
+  INTERNAL_ERROR: "INTERNAL_ERROR"
+};
+var GatsbieError = class _GatsbieError extends Error {
+  constructor(message) {
+    super(message);
+    this.name = "GatsbieError";
+    Object.setPrototypeOf(this, _GatsbieError.prototype);
+  }
+};
+var APIError = class _APIError extends GatsbieError {
+  code;
+  details;
+  timestamp;
+  httpStatus;
+  constructor(options) {
+    const msg = options.details ? `gatsbie: ${options.code}: ${options.message} (${options.details})` : `gatsbie: ${options.code}: ${options.message}`;
+    super(msg);
+    this.name = "APIError";
+    this.code = options.code;
+    this.details = options.details;
+    this.timestamp = options.timestamp;
+    this.httpStatus = options.httpStatus;
+    Object.setPrototypeOf(this, _APIError.prototype);
+  }
+  /** Check if this is an authentication error. */
+  isAuthError() {
+    return this.code === ErrorCode.AUTH_FAILED;
+  }
+  /** Check if this error is due to insufficient credits. */
+  isInsufficientCredits() {
+    return this.code === ErrorCode.INSUFFICIENT_CREDITS;
+  }
+  /** Check if this error is due to an invalid request. */
+  isInvalidRequest() {
+    return this.code === ErrorCode.INVALID_REQUEST;
+  }
+  /** Check if this error is from an upstream service. */
+  isUpstreamError() {
+    return this.code === ErrorCode.UPSTREAM_ERROR;
+  }
+  /** Check if the captcha solving failed. */
+  isSolveFailed() {
+    return this.code === ErrorCode.SOLVE_FAILED;
+  }
+  /** Check if this is an internal server error. */
+  isInternalError() {
+    return this.code === ErrorCode.INTERNAL_ERROR;
+  }
+};
+var RequestError = class _RequestError extends GatsbieError {
+  constructor(message, cause) {
+    super(message);
+    this.cause = cause;
+    this.name = "RequestError";
+    Object.setPrototypeOf(this, _RequestError.prototype);
+  }
+};
+
+// src/client.ts
+var DEFAULT_BASE_URL = "https://api2.gatsbie.io";
+var DEFAULT_TIMEOUT = 12e4;
+var Client = class {
+  apiKey;
+  baseUrl;
+  timeout;
+  /**
+   * Create a new Gatsbie API client.
+   *
+   * @param apiKey - Your Gatsbie API key (should start with 'gats_').
+   * @param options - Optional client configuration.
+   */
+  constructor(apiKey, options = {}) {
+    this.apiKey = apiKey;
+    this.baseUrl = (options.baseUrl ?? DEFAULT_BASE_URL).replace(/\/$/, "");
+    this.timeout = options.timeout ?? DEFAULT_TIMEOUT;
+  }
+  async request(method, path, body) {
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort(), this.timeout);
+    try {
+      const response = await fetch(`${this.baseUrl}${path}`, {
+        method,
+        headers: {
+          "Content-Type": "application/json",
+          Authorization: `Bearer ${this.apiKey}`
+        },
+        body: body ? JSON.stringify(body) : void 0,
+        signal: controller.signal
+      });
+      const data = await response.json();
+      if (!response.ok) {
+        const error = data.error || {};
+        throw new APIError({
+          code: error.code || "UNKNOWN",
+          message: error.message || "Unknown error",
+          details: error.details,
+          timestamp: error.timestamp,
+          httpStatus: response.status
+        });
+      }
+      return data;
+    } catch (err) {
+      if (err instanceof APIError) {
+        throw err;
+      }
+      if (err instanceof Error) {
+        if (err.name === "AbortError") {
+          throw new RequestError("Request timed out", err);
+        }
+        throw new RequestError(`Request failed: ${err.message}`, err);
+      }
+      throw new RequestError("Request failed");
+    } finally {
+      clearTimeout(timeoutId);
+    }
+  }
+  // ========================================================================
+  // API Methods
+  // ========================================================================
+  /**
+   * Check the API server health status.
+   */
+  async health() {
+    return this.request("GET", "/health");
+  }
+  /**
+   * Solve a Datadome device check challenge.
+   */
+  async solveDatadome(request) {
+    const body = {
+      task_type: "datadome-device-check",
+      proxy: request.proxy,
+      target_url: request.targetUrl,
+      target_method: request.targetMethod ?? "GET"
+    };
+    const data = await this.request("POST", "/v1/solve/datadome-device-check", body);
+    return {
+      success: data.success,
+      taskId: data.taskId,
+      service: data.service,
+      solution: {
+        datadome: data.solution.datadome,
+        userAgent: data.solution.ua
+      },
+      cost: data.cost,
+      solveTime: data.solveTime
+    };
+  }
+  /**
+   * Solve a reCAPTCHA v3 challenge.
+   */
+  async solveRecaptchaV3(request) {
+    const body = {
+      task_type: "recaptchav3",
+      proxy: request.proxy,
+      target_url: request.targetUrl,
+      site_key: request.siteKey
+    };
+    if (request.action) body.action = request.action;
+    if (request.title) body.title = request.title;
+    if (request.enterprise) body.enterprise = request.enterprise;
+    const data = await this.request("POST", "/v1/solve/recaptchav3", body);
+    return {
+      success: data.success,
+      taskId: data.taskId,
+      service: data.service,
+      solution: {
+        token: data.solution.token,
+        userAgent: data.solution.ua
+      },
+      cost: data.cost,
+      solveTime: data.solveTime
+    };
+  }
+  /**
+   * Solve an Akamai bot management challenge.
+   */
+  async solveAkamai(request) {
+    const body = {
+      task_type: "akamai",
+      proxy: request.proxy,
+      target_url: request.targetUrl,
+      akamai_js_url: request.akamaiJsUrl
+    };
+    if (request.pageFp) body.page_fp = request.pageFp;
+    const data = await this.request("POST", "/v1/solve/akamai", body);
+    return {
+      success: data.success,
+      taskId: data.taskId,
+      service: data.service,
+      solution: {
+        abck: data.solution._abck,
+        bmSz: data.solution.bm_sz,
+        userAgent: data.solution.ua,
+        country: data.solution.Country,
+        usrLocale: data.solution.UsrLocale
+      },
+      cost: data.cost,
+      solveTime: data.solveTime
+    };
+  }
+  /**
+   * Solve a Vercel bot protection challenge.
+   */
+  async solveVercel(request) {
+    const body = {
+      task_type: "vercel",
+      proxy: request.proxy,
+      target_url: request.targetUrl
+    };
+    const data = await this.request("POST", "/v1/solve/vercel", body);
+    return {
+      success: data.success,
+      taskId: data.taskId,
+      service: data.service,
+      solution: {
+        vcrcs: data.solution._vcrcs,
+        userAgent: data.solution.ua
+      },
+      cost: data.cost,
+      solveTime: data.solveTime
+    };
+  }
+  /**
+   * Solve a Shape antibot challenge.
+   */
+  async solveShape(request) {
+    const body = {
+      task_type: "shape",
+      proxy: request.proxy,
+      target_url: request.targetUrl,
+      target_api: request.targetApi,
+      shape_js_url: request.shapeJsUrl,
+      title: request.title,
+      method: request.method
+    };
+    const data = await this.request("POST", "/v1/solve/shape", body);
+    const { ua, ...headers } = data.solution;
+    return {
+      success: data.success,
+      taskId: data.taskId,
+      service: data.service,
+      solution: {
+        headers,
+        userAgent: ua
+      },
+      cost: data.cost,
+      solveTime: data.solveTime
+    };
+  }
+  /**
+   * Solve a Cloudflare Turnstile challenge.
+   */
+  async solveTurnstile(request) {
+    const body = {
+      task_type: "turnstile",
+      proxy: request.proxy,
+      target_url: request.targetUrl,
+      site_key: request.siteKey
+    };
+    const data = await this.request("POST", "/v1/solve/turnstile", body);
+    return {
+      success: data.success,
+      taskId: data.taskId,
+      service: data.service,
+      solution: {
+        token: data.solution.token,
+        userAgent: data.solution.ua
+      },
+      cost: data.cost,
+      solveTime: data.solveTime
+    };
+  }
+  /**
+   * Solve a PerimeterX Invisible challenge.
+   */
+  async solvePerimeterX(request) {
+    const body = {
+      task_type: "perimeterx_invisible",
+      proxy: request.proxy,
+      target_url: request.targetUrl,
+      perimeterx_js_url: request.perimeterxJsUrl,
+      pxAppId: request.pxAppId
+    };
+    const data = await this.request("POST", "/v1/solve/perimeterx-invisible", body);
+    return {
+      success: data.success,
+      taskId: data.taskId,
+      service: data.service,
+      solution: {
+        cookies: {
+          px3: data.solution.perimeterx_cookies._px3,
+          pxde: data.solution.perimeterx_cookies._pxde,
+          pxvid: data.solution.perimeterx_cookies._pxvid,
+          pxcts: data.solution.perimeterx_cookies.pxcts
+        },
+        userAgent: data.solution.ua
+      },
+      cost: data.cost,
+      solveTime: data.solveTime
+    };
+  }
+  /**
+   * Solve a Cloudflare WAF challenge.
+   */
+  async solveCloudflareWAF(request) {
+    const body = {
+      task_type: "cloudflare_waf",
+      proxy: request.proxy,
+      target_url: request.targetUrl,
+      target_method: request.targetMethod ?? "GET"
+    };
+    const data = await this.request("POST", "/v1/solve/cloudflare-waf", body);
+    return {
+      success: data.success,
+      taskId: data.taskId,
+      service: data.service,
+      solution: {
+        cfClearance: data.solution.cf_clearance,
+        userAgent: data.solution.ua
+      },
+      cost: data.cost,
+      solveTime: data.solveTime
+    };
+  }
+  /**
+   * Solve a Datadome Slider CAPTCHA challenge.
+   */
+  async solveDatadomeSlider(request) {
+    const body = {
+      task_type: "datadome-slider",
+      proxy: request.proxy,
+      target_url: request.targetUrl,
+      target_method: request.targetMethod ?? "GET"
+    };
+    const data = await this.request("POST", "/v1/solve/datadome-slider", body);
+    return {
+      success: data.success,
+      taskId: data.taskId,
+      service: data.service,
+      solution: {
+        datadome: data.solution.datadome,
+        userAgent: data.solution.ua
+      },
+      cost: data.cost,
+      solveTime: data.solveTime
+    };
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  APIError,
+  Client,
+  ErrorCode,
+  GatsbieError,
+  RequestError
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/errors.ts","../src/client.ts"],"sourcesContent":["/**\n * Gatsbie SDK - Official Node.js SDK for the Gatsbie Captcha API.\n *\n * @example\n * ```typescript\n * import { Client } from \"gatsbie\";\n *\n * const client = new Client(\"gats_your_api_key\");\n *\n * const response = await client.solveTurnstile({\n *   proxy: \"http://user:pass@proxy:8080\",\n *   targetUrl: \"https://example.com\",\n *   siteKey: \"0x4AAAAAAABS7TtLxsNa7Z2e\",\n * });\n *\n * console.log(response.solution.token);\n * ```\n */\n\nexport { Client } from \"./client\";\nexport {\n  APIError,\n  ErrorCode,\n  GatsbieError,\n  RequestError,\n} from \"./errors\";\nexport type {\n  // Response types\n  HealthResponse,\n  SolveResponse,\n  // Solution types\n  AkamaiSolution,\n  CloudflareWAFSolution,\n  DatadomeSliderSolution,\n  DatadomeSolution,\n  PerimeterXCookies,\n  PerimeterXSolution,\n  RecaptchaV3Solution,\n  ShapeSolution,\n  TurnstileSolution,\n  VercelSolution,\n  // Request types\n  AkamaiRequest,\n  CloudflareWAFRequest,\n  DatadomeRequest,\n  DatadomeSliderRequest,\n  PerimeterXRequest,\n  RecaptchaV3Request,\n  ShapeRequest,\n  TurnstileRequest,\n  VercelRequest,\n  // Options\n  ClientOptions,\n} from \"./types\";\n","/**\n * Error codes returned by the Gatsbie API.\n */\nexport const ErrorCode = {\n  AUTH_FAILED: \"AUTH_FAILED\",\n  INSUFFICIENT_CREDITS: \"INSUFFICIENT_CREDITS\",\n  INVALID_REQUEST: \"INVALID_REQUEST\",\n  UPSTREAM_ERROR: \"UPSTREAM_ERROR\",\n  SOLVE_FAILED: \"SOLVE_FAILED\",\n  INTERNAL_ERROR: \"INTERNAL_ERROR\",\n} as const;\n\nexport type ErrorCode = (typeof ErrorCode)[keyof typeof ErrorCode];\n\n/**\n * Base error class for Gatsbie SDK errors.\n */\nexport class GatsbieError extends Error {\n  constructor(message: string) {\n    super(message);\n    this.name = \"GatsbieError\";\n    Object.setPrototypeOf(this, GatsbieError.prototype);\n  }\n}\n\n/**\n * Error thrown when the Gatsbie API returns an error response.\n */\nexport class APIError extends GatsbieError {\n  readonly code: string;\n  readonly details?: string;\n  readonly timestamp?: number;\n  readonly httpStatus?: number;\n\n  constructor(options: {\n    code: string;\n    message: string;\n    details?: string;\n    timestamp?: number;\n    httpStatus?: number;\n  }) {\n    const msg = options.details\n      ? `gatsbie: ${options.code}: ${options.message} (${options.details})`\n      : `gatsbie: ${options.code}: ${options.message}`;\n    super(msg);\n    this.name = \"APIError\";\n    this.code = options.code;\n    this.details = options.details;\n    this.timestamp = options.timestamp;\n    this.httpStatus = options.httpStatus;\n    Object.setPrototypeOf(this, APIError.prototype);\n  }\n\n  /** Check if this is an authentication error. */\n  isAuthError(): boolean {\n    return this.code === ErrorCode.AUTH_FAILED;\n  }\n\n  /** Check if this error is due to insufficient credits. */\n  isInsufficientCredits(): boolean {\n    return this.code === ErrorCode.INSUFFICIENT_CREDITS;\n  }\n\n  /** Check if this error is due to an invalid request. */\n  isInvalidRequest(): boolean {\n    return this.code === ErrorCode.INVALID_REQUEST;\n  }\n\n  /** Check if this error is from an upstream service. */\n  isUpstreamError(): boolean {\n    return this.code === ErrorCode.UPSTREAM_ERROR;\n  }\n\n  /** Check if the captcha solving failed. */\n  isSolveFailed(): boolean {\n    return this.code === ErrorCode.SOLVE_FAILED;\n  }\n\n  /** Check if this is an internal server error. */\n  isInternalError(): boolean {\n    return this.code === ErrorCode.INTERNAL_ERROR;\n  }\n}\n\n/**\n * Error thrown when a request fails (network error, timeout, etc.).\n */\nexport class RequestError extends GatsbieError {\n  constructor(message: string, public readonly cause?: Error) {\n    super(message);\n    this.name = \"RequestError\";\n    Object.setPrototypeOf(this, RequestError.prototype);\n  }\n}\n","import { APIError, RequestError } from \"./errors\";\nimport type {\n  AkamaiRequest,\n  AkamaiSolution,\n  ClientOptions,\n  CloudflareWAFRequest,\n  CloudflareWAFSolution,\n  DatadomeRequest,\n  DatadomeSliderRequest,\n  DatadomeSliderSolution,\n  DatadomeSolution,\n  HealthResponse,\n  PerimeterXRequest,\n  PerimeterXSolution,\n  RecaptchaV3Request,\n  RecaptchaV3Solution,\n  ShapeRequest,\n  ShapeSolution,\n  SolveResponse,\n  TurnstileRequest,\n  TurnstileSolution,\n  VercelRequest,\n  VercelSolution,\n} from \"./types\";\n\nconst DEFAULT_BASE_URL = \"https://api2.gatsbie.io\";\nconst DEFAULT_TIMEOUT = 120000;\n\n/**\n * Gatsbie API client.\n *\n * @example\n * ```typescript\n * const client = new Client(\"gats_your_api_key\");\n *\n * const response = await client.solveTurnstile({\n *   proxy: \"http://user:pass@proxy:8080\",\n *   targetUrl: \"https://example.com\",\n *   siteKey: \"0x4AAAAAAABS7TtLxsNa7Z2e\",\n * });\n *\n * console.log(response.solution.token);\n * ```\n */\nexport class Client {\n  private readonly apiKey: string;\n  private readonly baseUrl: string;\n  private readonly timeout: number;\n\n  /**\n   * Create a new Gatsbie API client.\n   *\n   * @param apiKey - Your Gatsbie API key (should start with 'gats_').\n   * @param options - Optional client configuration.\n   */\n  constructor(apiKey: string, options: ClientOptions = {}) {\n    this.apiKey = apiKey;\n    this.baseUrl = (options.baseUrl ?? DEFAULT_BASE_URL).replace(/\\/$/, \"\");\n    this.timeout = options.timeout ?? DEFAULT_TIMEOUT;\n  }\n\n  private async request<T>(\n    method: string,\n    path: string,\n    body?: Record<string, unknown>\n  ): Promise<T> {\n    const controller = new AbortController();\n    const timeoutId = setTimeout(() => controller.abort(), this.timeout);\n\n    try {\n      const response = await fetch(`${this.baseUrl}${path}`, {\n        method,\n        headers: {\n          \"Content-Type\": \"application/json\",\n          Authorization: `Bearer ${this.apiKey}`,\n        },\n        body: body ? JSON.stringify(body) : undefined,\n        signal: controller.signal,\n      });\n\n      const data = (await response.json()) as Record<string, unknown>;\n\n      if (!response.ok) {\n        const error = (data.error as Record<string, unknown>) || {};\n        throw new APIError({\n          code: (error.code as string) || \"UNKNOWN\",\n          message: (error.message as string) || \"Unknown error\",\n          details: error.details as string | undefined,\n          timestamp: error.timestamp as number | undefined,\n          httpStatus: response.status,\n        });\n      }\n\n      return data as T;\n    } catch (err) {\n      if (err instanceof APIError) {\n        throw err;\n      }\n      if (err instanceof Error) {\n        if (err.name === \"AbortError\") {\n          throw new RequestError(\"Request timed out\", err);\n        }\n        throw new RequestError(`Request failed: ${err.message}`, err);\n      }\n      throw new RequestError(\"Request failed\");\n    } finally {\n      clearTimeout(timeoutId);\n    }\n  }\n\n  // ========================================================================\n  // API Methods\n  // ========================================================================\n\n  /**\n   * Check the API server health status.\n   */\n  async health(): Promise<HealthResponse> {\n    return this.request<HealthResponse>(\"GET\", \"/health\");\n  }\n\n  /**\n   * Solve a Datadome device check challenge.\n   */\n  async solveDatadome(\n    request: DatadomeRequest\n  ): Promise<SolveResponse<DatadomeSolution>> {\n    const body = {\n      task_type: \"datadome-device-check\",\n      proxy: request.proxy,\n      target_url: request.targetUrl,\n      target_method: request.targetMethod ?? \"GET\",\n    };\n\n    const data = await this.request<{\n      success: boolean;\n      taskId: string;\n      service: string;\n      solution: { datadome: string; ua: string };\n      cost: number;\n      solveTime: number;\n    }>(\"POST\", \"/v1/solve/datadome-device-check\", body);\n\n    return {\n      success: data.success,\n      taskId: data.taskId,\n      service: data.service,\n      solution: {\n        datadome: data.solution.datadome,\n        userAgent: data.solution.ua,\n      },\n      cost: data.cost,\n      solveTime: data.solveTime,\n    };\n  }\n\n  /**\n   * Solve a reCAPTCHA v3 challenge.\n   */\n  async solveRecaptchaV3(\n    request: RecaptchaV3Request\n  ): Promise<SolveResponse<RecaptchaV3Solution>> {\n    const body: Record<string, unknown> = {\n      task_type: \"recaptchav3\",\n      proxy: request.proxy,\n      target_url: request.targetUrl,\n      site_key: request.siteKey,\n    };\n    if (request.action) body.action = request.action;\n    if (request.title) body.title = request.title;\n    if (request.enterprise) body.enterprise = request.enterprise;\n\n    const data = await this.request<{\n      success: boolean;\n      taskId: string;\n      service: string;\n      solution: { token: string; ua: string };\n      cost: number;\n      solveTime: number;\n    }>(\"POST\", \"/v1/solve/recaptchav3\", body);\n\n    return {\n      success: data.success,\n      taskId: data.taskId,\n      service: data.service,\n      solution: {\n        token: data.solution.token,\n        userAgent: data.solution.ua,\n      },\n      cost: data.cost,\n      solveTime: data.solveTime,\n    };\n  }\n\n  /**\n   * Solve an Akamai bot management challenge.\n   */\n  async solveAkamai(\n    request: AkamaiRequest\n  ): Promise<SolveResponse<AkamaiSolution>> {\n    const body: Record<string, unknown> = {\n      task_type: \"akamai\",\n      proxy: request.proxy,\n      target_url: request.targetUrl,\n      akamai_js_url: request.akamaiJsUrl,\n    };\n    if (request.pageFp) body.page_fp = request.pageFp;\n\n    const data = await this.request<{\n      success: boolean;\n      taskId: string;\n      service: string;\n      solution: {\n        _abck: string;\n        bm_sz: string;\n        ua: string;\n        Country?: string;\n        UsrLocale?: string;\n      };\n      cost: number;\n      solveTime: number;\n    }>(\"POST\", \"/v1/solve/akamai\", body);\n\n    return {\n      success: data.success,\n      taskId: data.taskId,\n      service: data.service,\n      solution: {\n        abck: data.solution._abck,\n        bmSz: data.solution.bm_sz,\n        userAgent: data.solution.ua,\n        country: data.solution.Country,\n        usrLocale: data.solution.UsrLocale,\n      },\n      cost: data.cost,\n      solveTime: data.solveTime,\n    };\n  }\n\n  /**\n   * Solve a Vercel bot protection challenge.\n   */\n  async solveVercel(\n    request: VercelRequest\n  ): Promise<SolveResponse<VercelSolution>> {\n    const body = {\n      task_type: \"vercel\",\n      proxy: request.proxy,\n      target_url: request.targetUrl,\n    };\n\n    const data = await this.request<{\n      success: boolean;\n      taskId: string;\n      service: string;\n      solution: { _vcrcs: string; ua: string };\n      cost: number;\n      solveTime: number;\n    }>(\"POST\", \"/v1/solve/vercel\", body);\n\n    return {\n      success: data.success,\n      taskId: data.taskId,\n      service: data.service,\n      solution: {\n        vcrcs: data.solution._vcrcs,\n        userAgent: data.solution.ua,\n      },\n      cost: data.cost,\n      solveTime: data.solveTime,\n    };\n  }\n\n  /**\n   * Solve a Shape antibot challenge.\n   */\n  async solveShape(\n    request: ShapeRequest\n  ): Promise<SolveResponse<ShapeSolution>> {\n    const body = {\n      task_type: \"shape\",\n      proxy: request.proxy,\n      target_url: request.targetUrl,\n      target_api: request.targetApi,\n      shape_js_url: request.shapeJsUrl,\n      title: request.title,\n      method: request.method,\n    };\n\n    const data = await this.request<{\n      success: boolean;\n      taskId: string;\n      service: string;\n      solution: Record<string, string>;\n      cost: number;\n      solveTime: number;\n    }>(\"POST\", \"/v1/solve/shape\", body);\n\n    // Shape returns dynamic headers, extract ua separately\n    const { ua, ...headers } = data.solution;\n\n    return {\n      success: data.success,\n      taskId: data.taskId,\n      service: data.service,\n      solution: {\n        headers,\n        userAgent: ua,\n      },\n      cost: data.cost,\n      solveTime: data.solveTime,\n    };\n  }\n\n  /**\n   * Solve a Cloudflare Turnstile challenge.\n   */\n  async solveTurnstile(\n    request: TurnstileRequest\n  ): Promise<SolveResponse<TurnstileSolution>> {\n    const body = {\n      task_type: \"turnstile\",\n      proxy: request.proxy,\n      target_url: request.targetUrl,\n      site_key: request.siteKey,\n    };\n\n    const data = await this.request<{\n      success: boolean;\n      taskId: string;\n      service: string;\n      solution: { token: string; ua: string };\n      cost: number;\n      solveTime: number;\n    }>(\"POST\", \"/v1/solve/turnstile\", body);\n\n    return {\n      success: data.success,\n      taskId: data.taskId,\n      service: data.service,\n      solution: {\n        token: data.solution.token,\n        userAgent: data.solution.ua,\n      },\n      cost: data.cost,\n      solveTime: data.solveTime,\n    };\n  }\n\n  /**\n   * Solve a PerimeterX Invisible challenge.\n   */\n  async solvePerimeterX(\n    request: PerimeterXRequest\n  ): Promise<SolveResponse<PerimeterXSolution>> {\n    const body = {\n      task_type: \"perimeterx_invisible\",\n      proxy: request.proxy,\n      target_url: request.targetUrl,\n      perimeterx_js_url: request.perimeterxJsUrl,\n      pxAppId: request.pxAppId,\n    };\n\n    const data = await this.request<{\n      success: boolean;\n      taskId: string;\n      service: string;\n      solution: {\n        perimeterx_cookies: {\n          _px3: string;\n          _pxde: string;\n          _pxvid: string;\n          pxcts: string;\n        };\n        ua: string;\n      };\n      cost: number;\n      solveTime: number;\n    }>(\"POST\", \"/v1/solve/perimeterx-invisible\", body);\n\n    return {\n      success: data.success,\n      taskId: data.taskId,\n      service: data.service,\n      solution: {\n        cookies: {\n          px3: data.solution.perimeterx_cookies._px3,\n          pxde: data.solution.perimeterx_cookies._pxde,\n          pxvid: data.solution.perimeterx_cookies._pxvid,\n          pxcts: data.solution.perimeterx_cookies.pxcts,\n        },\n        userAgent: data.solution.ua,\n      },\n      cost: data.cost,\n      solveTime: data.solveTime,\n    };\n  }\n\n  /**\n   * Solve a Cloudflare WAF challenge.\n   */\n  async solveCloudflareWAF(\n    request: CloudflareWAFRequest\n  ): Promise<SolveResponse<CloudflareWAFSolution>> {\n    const body = {\n      task_type: \"cloudflare_waf\",\n      proxy: request.proxy,\n      target_url: request.targetUrl,\n      target_method: request.targetMethod ?? \"GET\",\n    };\n\n    const data = await this.request<{\n      success: boolean;\n      taskId: string;\n      service: string;\n      solution: { cf_clearance: string; ua: string };\n      cost: number;\n      solveTime: number;\n    }>(\"POST\", \"/v1/solve/cloudflare-waf\", body);\n\n    return {\n      success: data.success,\n      taskId: data.taskId,\n      service: data.service,\n      solution: {\n        cfClearance: data.solution.cf_clearance,\n        userAgent: data.solution.ua,\n      },\n      cost: data.cost,\n      solveTime: data.solveTime,\n    };\n  }\n\n  /**\n   * Solve a Datadome Slider CAPTCHA challenge.\n   */\n  async solveDatadomeSlider(\n    request: DatadomeSliderRequest\n  ): Promise<SolveResponse<DatadomeSliderSolution>> {\n    const body = {\n      task_type: \"datadome-slider\",\n      proxy: request.proxy,\n      target_url: request.targetUrl,\n      target_method: request.targetMethod ?? \"GET\",\n    };\n\n    const data = await this.request<{\n      success: boolean;\n      taskId: string;\n      service: string;\n      solution: { datadome: string; ua: string };\n      cost: number;\n      solveTime: number;\n    }>(\"POST\", \"/v1/solve/datadome-slider\", body);\n\n    return {\n      success: data.success,\n      taskId: data.taskId,\n      service: data.service,\n      solution: {\n        datadome: data.solution.datadome,\n        userAgent: data.solution.ua,\n      },\n      cost: data.cost,\n      solveTime: data.solveTime,\n    };\n  }\n}\n"],"mappings":"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","names":[]}