@capbypass/sdk 1.0.0 → 1.0.4

package/README.md

@@ -230,13 +230,37 @@ TaskType.RECAPTCHA_V3_ENTERPRISE         // ReCaptchaV3EnterpriseTask
 TaskType.RECAPTCHA_V3_ENTERPRISE_PROXYLESS  // ReCaptchaV3EnterpriseTaskProxyLess
 ```
 
+## Documentation
+
+### 📚 Core Documentation
+- [Quick Start Guide](https://github.com/CapBypass-Development/capbypass-sdks/blob/main/docs/quickstart/typescript.md)
+- [Complete API Reference](https://github.com/CapBypass-Development/capbypass-sdks/blob/main/docs/api-reference/typescript-sdk.md)
+- [Full SDK Documentation](https://capbypass.dev/docs/sdks/typescript)
+
+### 🔧 Advanced Guides
+- [Proxy Configuration](https://github.com/CapBypass-Development/capbypass-sdks/blob/main/docs/guides/proxy-configuration.md) — HTTP, HTTPS, SOCKS5 proxy support with rotation strategies
+- [Error Handling](https://github.com/CapBypass-Development/capbypass-sdks/blob/main/docs/guides/error-handling.md) — Retry strategies, circuit breakers, production alerting
+- [Performance Optimization](https://github.com/CapBypass-Development/capbypass-sdks/blob/main/docs/guides/performance-optimization.md) — Concurrent solving, connection pooling, token caching
+- [Production Deployment](https://github.com/CapBypass-Development/capbypass-sdks/blob/main/docs/guides/production-deployment.md) — Kubernetes, AWS Lambda, monitoring, security
+
+### 🔄 Migration
+- [Migrating from Capsolver](https://github.com/CapBypass-Development/capbypass-sdks/blob/main/docs/migration/from-capsolver.md) — 100% API compatible, drop-in replacement
+
 ## Examples
 
-See the [examples](examples/) directory for complete examples:
+### Basic Examples
+See the [examples](examples/) directory for complete runnable examples:
 - [recaptcha-v2.ts](examples/recaptcha-v2.ts) - reCAPTCHA v2 solving
 - [recaptcha-v3.ts](examples/recaptcha-v3.ts) - reCAPTCHA v3 solving
 - [aws-waf.ts](examples/aws-waf.ts) - AWS WAF challenge solving
 
+### Advanced Examples
+Full integration examples in the [documentation](https://github.com/CapBypass-Development/capbypass-sdks/tree/main/docs/examples):
+- E-commerce checkout automation
+- Social media automation
+- Web scraping with CAPTCHA handling
+- Microservice integration patterns
+
 ## Testing
 
 ```bash

package/dist/index.d.mts

@@ -39,12 +39,21 @@ interface TaskResult {
     status?: 'processing' | 'ready' | 'failed';
     solution?: Record<string, any>;
 }
+/**
+ * Pricing item from GET /pricing
+ */
+interface PricingItem {
+    task_type: string;
+    user_cost: number;
+    status: 'active' | 'inactive' | 'soon';
+}
 /**
  * Client configuration options
  */
 interface ClientOptions {
     apiKey?: string;
     baseURL?: string;
+    developerKey?: string;
 }
 
 /**
@@ -52,6 +61,7 @@ interface ClientOptions {
  */
 declare class CapBypassClient {
     private apiKey;
+    private developerKey?;
     private httpClient;
     /**
      * Create a new CapBypass client
@@ -78,6 +88,12 @@ declare class CapBypassClient {
      * @returns Task result
      */
     getTaskResult(taskId: string): Promise<TaskResult>;
+    /**
+     * Get pricing for all task types.
+     * This is a public endpoint and does not require authentication.
+     * @returns Array of pricing items with task_type and user_cost
+     */
+    getPricing(): Promise<PricingItem[]>;
     /**
      * Get account balance
      * @returns Account balance
@@ -184,4 +200,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 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, ServerError, SolverError, TaskNotFoundError, type TaskResult, TaskType, type TaskTypeValue, TimeoutError, ValidationError };

package/dist/index.d.ts

@@ -39,12 +39,21 @@ interface TaskResult {
     status?: 'processing' | 'ready' | 'failed';
     solution?: Record<string, any>;
 }
+/**
+ * Pricing item from GET /pricing
+ */
+interface PricingItem {
+    task_type: string;
+    user_cost: number;
+    status: 'active' | 'inactive' | 'soon';
+}
 /**
  * Client configuration options
  */
 interface ClientOptions {
     apiKey?: string;
     baseURL?: string;
+    developerKey?: string;
 }
 
 /**
@@ -52,6 +61,7 @@ interface ClientOptions {
  */
 declare class CapBypassClient {
     private apiKey;
+    private developerKey?;
     private httpClient;
     /**
      * Create a new CapBypass client
@@ -78,6 +88,12 @@ declare class CapBypassClient {
      * @returns Task result
      */
     getTaskResult(taskId: string): Promise<TaskResult>;
+    /**
+     * Get pricing for all task types.
+     * This is a public endpoint and does not require authentication.
+     * @returns Array of pricing items with task_type and user_cost
+     */
+    getPricing(): Promise<PricingItem[]>;
     /**
      * Get account balance
      * @returns Account balance
@@ -184,4 +200,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 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, ServerError, SolverError, TaskNotFoundError, type TaskResult, TaskType, type TaskTypeValue, TimeoutError, ValidationError };

package/dist/index.js

@@ -147,6 +147,9 @@ function parseError(errorCode, errorDescription) {
     case "ERROR_INVALID_TASK_DATA":
     case "ERROR_TASK_ABSENT":
     case "ERROR_TASK_NOT_SUPPORTED":
+    case "TASK_TYPE_COMING_SOON":
+    case "TASK_TYPE_INACTIVE":
+    case "ERROR_INVALID_DEVELOPER_KEY":
       throw new ValidationError(errorCode, errorDescription);
     case "ERROR_TASK_NOT_FOUND":
       throw new TaskNotFoundError(errorCode, errorDescription);
@@ -156,7 +159,7 @@ function parseError(errorCode, errorDescription) {
 }
 
 // src/client.ts
-var DEFAULT_BASE_URL = "https://gateway.strayder.io";
+var DEFAULT_BASE_URL = "https://api.capbypass.pro";
 var SDK_VERSION = "1.0.0";
 var USER_AGENT = `capbypass-sdk-typescript/${SDK_VERSION}`;
 var CapBypassClient = class {
@@ -166,6 +169,7 @@ var CapBypassClient = class {
    */
   constructor(options = {}) {
     this.apiKey = options.apiKey || process.env.CAPBYPASS_API_KEY || "";
+    this.developerKey = options.developerKey || process.env.CAPBYPASS_DEVELOPER_KEY || void 0;
     if (!this.apiKey) {
       throw new Error(
         "API key is required. Provide via constructor or CAPBYPASS_API_KEY environment variable."
@@ -247,7 +251,8 @@ var CapBypassClient = class {
   async createTask(task) {
     const request = {
       clientKey: this.apiKey,
-      task
+      task,
+      ...this.developerKey && { developerKey: this.developerKey }
     };
     const response = await this.makeRequest(
       "/createTask",
@@ -277,6 +282,44 @@ var CapBypassClient = class {
     }
     return response;
   }
+  /**
+   * Get pricing for all task types.
+   * This is a public endpoint and does not require authentication.
+   * @returns Array of pricing items with task_type and user_cost
+   */
+  async getPricing() {
+    let lastError;
+    for (let attempt = 0; attempt <= 3; attempt++) {
+      try {
+        const response = await this.httpClient.get("/pricing");
+        return response.data.pricing;
+      } catch (error) {
+        const axiosError = error;
+        if (axiosError.response && [502, 503, 504].includes(axiosError.response.status)) {
+          if (attempt < 3) {
+            const backoff = Math.min(10, Math.pow(2, attempt)) + Math.random();
+            await this.sleep(backoff * 1e3);
+            continue;
+          }
+          throw new GatewayError(
+            axiosError.response.status,
+            axiosError.response.data
+          );
+        }
+        if (axiosError.code === "ECONNREFUSED" || axiosError.code === "ETIMEDOUT") {
+          if (attempt < 3) {
+            const backoff = Math.min(10, Math.pow(2, attempt)) + Math.random();
+            await this.sleep(backoff * 1e3);
+            lastError = new NetworkError("Connection failed", axiosError);
+            continue;
+          }
+          throw new NetworkError("Connection failed", axiosError);
+        }
+        throw new NetworkError(axiosError.message, axiosError);
+      }
+    }
+    throw lastError;
+  }
   /**
    * Get account balance
    * @returns Account balance

package/dist/index.mjs

@@ -97,6 +97,9 @@ function parseError(errorCode, errorDescription) {
     case "ERROR_INVALID_TASK_DATA":
     case "ERROR_TASK_ABSENT":
     case "ERROR_TASK_NOT_SUPPORTED":
+    case "TASK_TYPE_COMING_SOON":
+    case "TASK_TYPE_INACTIVE":
+    case "ERROR_INVALID_DEVELOPER_KEY":
       throw new ValidationError(errorCode, errorDescription);
     case "ERROR_TASK_NOT_FOUND":
       throw new TaskNotFoundError(errorCode, errorDescription);
@@ -106,7 +109,7 @@ function parseError(errorCode, errorDescription) {
 }
 
 // src/client.ts
-var DEFAULT_BASE_URL = "https://gateway.strayder.io";
+var DEFAULT_BASE_URL = "https://api.capbypass.pro";
 var SDK_VERSION = "1.0.0";
 var USER_AGENT = `capbypass-sdk-typescript/${SDK_VERSION}`;
 var CapBypassClient = class {
@@ -116,6 +119,7 @@ var CapBypassClient = class {
    */
   constructor(options = {}) {
     this.apiKey = options.apiKey || process.env.CAPBYPASS_API_KEY || "";
+    this.developerKey = options.developerKey || process.env.CAPBYPASS_DEVELOPER_KEY || void 0;
     if (!this.apiKey) {
       throw new Error(
         "API key is required. Provide via constructor or CAPBYPASS_API_KEY environment variable."
@@ -197,7 +201,8 @@ var CapBypassClient = class {
   async createTask(task) {
     const request = {
       clientKey: this.apiKey,
-      task
+      task,
+      ...this.developerKey && { developerKey: this.developerKey }
     };
     const response = await this.makeRequest(
       "/createTask",
@@ -227,6 +232,44 @@ var CapBypassClient = class {
     }
     return response;
   }
+  /**
+   * Get pricing for all task types.
+   * This is a public endpoint and does not require authentication.
+   * @returns Array of pricing items with task_type and user_cost
+   */
+  async getPricing() {
+    let lastError;
+    for (let attempt = 0; attempt <= 3; attempt++) {
+      try {
+        const response = await this.httpClient.get("/pricing");
+        return response.data.pricing;
+      } catch (error) {
+        const axiosError = error;
+        if (axiosError.response && [502, 503, 504].includes(axiosError.response.status)) {
+          if (attempt < 3) {
+            const backoff = Math.min(10, Math.pow(2, attempt)) + Math.random();
+            await this.sleep(backoff * 1e3);
+            continue;
+          }
+          throw new GatewayError(
+            axiosError.response.status,
+            axiosError.response.data
+          );
+        }
+        if (axiosError.code === "ECONNREFUSED" || axiosError.code === "ETIMEDOUT") {
+          if (attempt < 3) {
+            const backoff = Math.min(10, Math.pow(2, attempt)) + Math.random();
+            await this.sleep(backoff * 1e3);
+            lastError = new NetworkError("Connection failed", axiosError);
+            continue;
+          }
+          throw new NetworkError("Connection failed", axiosError);
+        }
+        throw new NetworkError(axiosError.message, axiosError);
+      }
+    }
+    throw lastError;
+  }
   /**
    * Get account balance
    * @returns Account balance

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@capbypass/sdk",
-  "version": "1.0.0",
+  "version": "1.0.4",
   "description": "Official TypeScript/JavaScript SDK for CapBypass CAPTCHA solving service",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
@@ -63,6 +63,6 @@
     "typescript": "^5.3.3"
   },
   "engines": {
-    "node": ">=16"
+    "node": ">=18.12.0"
   }
 }