@capbypass/sdk 1.0.7 → 1.0.8

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

@@ -106,7 +106,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

package/dist/index.d.ts

@@ -106,7 +106,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

package/dist/index.js

@@ -168,6 +168,11 @@ function parseError(errorCode, errorDescription) {
 var DEFAULT_BASE_URL = "https://api.capbypass.pro";
 var SDK_VERSION = "1.0.0";
 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 +349,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 +360,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 +377,6 @@ var CapBypassClient = class {
           result.errorDescription || "Task failed"
         );
       }
-      attempt++;
-      const pollInterval = Math.min(5, Math.ceil(attempt / 2));
-      await this.sleep(pollInterval * 1e3);
     }
   }
 };

package/dist/index.mjs

@@ -118,6 +118,11 @@ function parseError(errorCode, errorDescription) {
 var DEFAULT_BASE_URL = "https://api.capbypass.pro";
 var SDK_VERSION = "1.0.0";
 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);
     }
   }
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@capbypass/sdk",
-  "version": "1.0.7",
+  "version": "1.0.8",
   "description": "Official TypeScript/JavaScript SDK for CapBypass CAPTCHA solving service",
   "main": "dist/index.js",
   "module": "dist/index.mjs",