@capbypass/sdk 1.0.7 → 1.0.9

package/README.md

@@ -11,7 +11,7 @@ Works in both Node.js and browser environments.
 ## Features
 
 - ✅ **Simple API**: One-line `solve()` method or advanced `createTask()`/`getTaskResult()` control
-- 🔄 **Automatic Polling**: Built-in adaptive polling with exponential backoff
+- 🔄 **Automatic Polling**: Built-in adaptive polling (first poll after 1 s, then every 1-3 s)
 - 🛡️ **Robust Error Handling**: Typed errors for all API and network failures
 - 🔁 **Smart Retry Logic**: Automatic retry on network/gateway errors
 - 🎯 **Full TypeScript Support**: Complete type definitions for excellent IDE support
@@ -105,6 +105,8 @@ const solution = await client.solve(task, timeout);
 - `timeout`: Maximum wait time in seconds (default: 120)
 - Returns: Promise<Solution>
 
+`solve()` waits 1 s after creating the task before its first `getTaskResult` request, then waits 1, 1, 2 and 2 s between the next requests, and 3 s between requests from then on. These are waits between requests: the time a request itself takes comes on top. `timeout` is counted from the end of `createTask` and is not changed by the waiting schedule.
+
 ### Advanced API
 
 For full control over task lifecycle:
@@ -113,8 +115,26 @@ For full control over task lifecycle:
 // Create task
 const taskId = await client.createTask(task);
 
-// Poll for result
-const result = await client.getTaskResult(taskId);
+// Poll for result. getTaskResult does not wait by itself: wait 1 s after
+// createTask, then 1 to 3 s between calls (not faster), until the task is
+// ready or failed, and give up after your own deadline.
+const sleep = (ms: number) => new Promise((r) => setTimeout(r, ms));
+const deadline = Date.now() + 120_000;
+await sleep(1000);
+while (true) {
+  const result = await client.getTaskResult(taskId);
+  if (result.status === 'ready') {
+    console.log(result.solution);
+    break;
+  }
+  if (result.status === 'failed') {
+    throw new Error(result.errorDescription || 'Task failed');
+  }
+  if (Date.now() > deadline) {
+    throw new Error('Task not ready in time');
+  }
+  await sleep(2000);
+}
 
 // Check balance
 const balance = await client.getBalance();

package/dist/index.d.mts

@@ -62,6 +62,7 @@ interface ClientOptions {
     developerKey?: string;
 }
 
+declare const SDK_VERSION: string;
 /**
  * CapBypass API Client
  */
@@ -106,7 +107,10 @@ declare class CapBypassClient {
      */
     getBalance(): Promise<number>;
     /**
-     * Create a task and poll until solved or timeout
+     * Create a task and poll until solved or timeout.
+     *
+     * The first poll happens 1 s after the task is created, then every 1 s for
+     * the first three polls, growing to 3 s (waits: 1, 1, 1, 2, 2, 3, 3, ...).
      * @param task - Task configuration
      * @param timeout - Maximum wait time in seconds (default: 120)
      * @returns Solution object
@@ -206,4 +210,4 @@ declare class ParseError extends Error {
     constructor(message: string, cause?: Error | undefined);
 }
 
-export { AuthenticationError, type BaseTask, CapBypassClient, CapBypassError, type ClientOptions, GatewayError, InsufficientBalanceError, InternalError, NetworkError, ParseError, type PricingItem, type ProxyConfig, RateLimitError, ServerError, SolverError, TaskNotFoundError, type TaskResult, TaskType, type TaskTypeValue, TimeoutError, ValidationError };
+export { AuthenticationError, type BaseTask, CapBypassClient, CapBypassError, type ClientOptions, GatewayError, InsufficientBalanceError, InternalError, NetworkError, ParseError, type PricingItem, type ProxyConfig, RateLimitError, SDK_VERSION, ServerError, SolverError, TaskNotFoundError, type TaskResult, TaskType, type TaskTypeValue, TimeoutError, ValidationError };

package/dist/index.d.ts

@@ -62,6 +62,7 @@ interface ClientOptions {
     developerKey?: string;
 }
 
+declare const SDK_VERSION: string;
 /**
  * CapBypass API Client
  */
@@ -106,7 +107,10 @@ declare class CapBypassClient {
      */
     getBalance(): Promise<number>;
     /**
-     * Create a task and poll until solved or timeout
+     * Create a task and poll until solved or timeout.
+     *
+     * The first poll happens 1 s after the task is created, then every 1 s for
+     * the first three polls, growing to 3 s (waits: 1, 1, 1, 2, 2, 3, 3, ...).
      * @param task - Task configuration
      * @param timeout - Maximum wait time in seconds (default: 120)
      * @returns Solution object
@@ -206,4 +210,4 @@ declare class ParseError extends Error {
     constructor(message: string, cause?: Error | undefined);
 }
 
-export { AuthenticationError, type BaseTask, CapBypassClient, CapBypassError, type ClientOptions, GatewayError, InsufficientBalanceError, InternalError, NetworkError, ParseError, type PricingItem, type ProxyConfig, RateLimitError, ServerError, SolverError, TaskNotFoundError, type TaskResult, TaskType, type TaskTypeValue, TimeoutError, ValidationError };
+export { AuthenticationError, type BaseTask, CapBypassClient, CapBypassError, type ClientOptions, GatewayError, InsufficientBalanceError, InternalError, NetworkError, ParseError, type PricingItem, type ProxyConfig, RateLimitError, SDK_VERSION, ServerError, SolverError, TaskNotFoundError, type TaskResult, TaskType, type TaskTypeValue, TimeoutError, ValidationError };

package/dist/index.js

@@ -39,6 +39,7 @@ __export(index_exports, {
   NetworkError: () => NetworkError,
   ParseError: () => ParseError,
   RateLimitError: () => RateLimitError,
+  SDK_VERSION: () => SDK_VERSION,
   ServerError: () => ServerError,
   SolverError: () => SolverError,
   TaskNotFoundError: () => TaskNotFoundError,
@@ -166,8 +167,13 @@ function parseError(errorCode, errorDescription) {
 
 // src/client.ts
 var DEFAULT_BASE_URL = "https://api.capbypass.pro";
-var SDK_VERSION = "1.0.0";
+var SDK_VERSION = true ? "1.0.9" : "unknown";
 var USER_AGENT = `capbypass-sdk-typescript/${SDK_VERSION}`;
+var POLL_DELAYS_SECONDS = [1, 1, 1, 2, 2];
+var MAX_POLL_DELAY_SECONDS = 3;
+function pollDelaySeconds(poll) {
+  return POLL_DELAYS_SECONDS[poll - 1] ?? MAX_POLL_DELAY_SECONDS;
+}
 var CapBypassClient = class {
   /**
    * Create a new CapBypass client
@@ -344,7 +350,10 @@ var CapBypassClient = class {
     return response.balance;
   }
   /**
-   * Create a task and poll until solved or timeout
+   * Create a task and poll until solved or timeout.
+   *
+   * The first poll happens 1 s after the task is created, then every 1 s for
+   * the first three polls, growing to 3 s (waits: 1, 1, 1, 2, 2, 3, 3, ...).
    * @param task - Task configuration
    * @param timeout - Maximum wait time in seconds (default: 120)
    * @returns Solution object
@@ -352,8 +361,10 @@ var CapBypassClient = class {
   async solve(task, timeout = 120) {
     const taskId = await this.createTask(task);
     const startTime = Date.now();
-    let attempt = 0;
+    let poll = 0;
     while (true) {
+      poll++;
+      await this.sleep(pollDelaySeconds(poll) * 1e3);
       const elapsed = (Date.now() - startTime) / 1e3;
       if (elapsed > timeout) {
         throw new TimeoutError();
@@ -367,9 +378,6 @@ var CapBypassClient = class {
           result.errorDescription || "Task failed"
         );
       }
-      attempt++;
-      const pollInterval = Math.min(5, Math.ceil(attempt / 2));
-      await this.sleep(pollInterval * 1e3);
     }
   }
 };
@@ -409,6 +417,7 @@ var TaskType = {
   NetworkError,
   ParseError,
   RateLimitError,
+  SDK_VERSION,
   ServerError,
   SolverError,
   TaskNotFoundError,

package/dist/index.mjs

@@ -116,8 +116,13 @@ function parseError(errorCode, errorDescription) {
 
 // src/client.ts
 var DEFAULT_BASE_URL = "https://api.capbypass.pro";
-var SDK_VERSION = "1.0.0";
+var SDK_VERSION = true ? "1.0.9" : "unknown";
 var USER_AGENT = `capbypass-sdk-typescript/${SDK_VERSION}`;
+var POLL_DELAYS_SECONDS = [1, 1, 1, 2, 2];
+var MAX_POLL_DELAY_SECONDS = 3;
+function pollDelaySeconds(poll) {
+  return POLL_DELAYS_SECONDS[poll - 1] ?? MAX_POLL_DELAY_SECONDS;
+}
 var CapBypassClient = class {
   /**
    * Create a new CapBypass client
@@ -294,7 +299,10 @@ var CapBypassClient = class {
     return response.balance;
   }
   /**
-   * Create a task and poll until solved or timeout
+   * Create a task and poll until solved or timeout.
+   *
+   * The first poll happens 1 s after the task is created, then every 1 s for
+   * the first three polls, growing to 3 s (waits: 1, 1, 1, 2, 2, 3, 3, ...).
    * @param task - Task configuration
    * @param timeout - Maximum wait time in seconds (default: 120)
    * @returns Solution object
@@ -302,8 +310,10 @@ var CapBypassClient = class {
   async solve(task, timeout = 120) {
     const taskId = await this.createTask(task);
     const startTime = Date.now();
-    let attempt = 0;
+    let poll = 0;
     while (true) {
+      poll++;
+      await this.sleep(pollDelaySeconds(poll) * 1e3);
       const elapsed = (Date.now() - startTime) / 1e3;
       if (elapsed > timeout) {
         throw new TimeoutError();
@@ -317,9 +327,6 @@ var CapBypassClient = class {
           result.errorDescription || "Task failed"
         );
       }
-      attempt++;
-      const pollInterval = Math.min(5, Math.ceil(attempt / 2));
-      await this.sleep(pollInterval * 1e3);
     }
   }
 };
@@ -358,6 +365,7 @@ export {
   NetworkError,
   ParseError,
   RateLimitError,
+  SDK_VERSION,
   ServerError,
   SolverError,
   TaskNotFoundError,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@capbypass/sdk",
-  "version": "1.0.7",
+  "version": "1.0.9",
   "description": "Official TypeScript/JavaScript SDK for CapBypass CAPTCHA solving service",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
@@ -16,7 +16,7 @@
     "dist"
   ],
   "scripts": {
-    "build": "tsup src/index.ts --format cjs,esm --dts --clean",
+    "build": "tsup",
     "test": "jest",
     "test:watch": "jest --watch",
     "test:coverage": "jest --coverage",