chore: bump sdk-spec submodule

Author: Thordata

examples/smoke_proxy_protocols.ts

@@ -0,0 +1,35 @@
+import "dotenv/config";
+import { Thordata } from "../src/thordata.js";
+
+function printProxyEndpoint(proxyUrl: string) {
+  const u = new URL(proxyUrl);
+  console.log("proxy_endpoint:", `${u.protocol}//${u.hostname}:${u.port}`);
+  console.log("proxy_user_prefix:", decodeURIComponent(u.username).slice(0, 50));
+}
+
+async function runOne(protocol: string) {
+  // IMPORTANT: set BOTH global and product-specific protocol to avoid .env overriding
+  process.env.THORDATA_PROXY_PROTOCOL = protocol;
+  process.env.THORDATA_RESIDENTIAL_PROXY_PROTOCOL = protocol;
+
+  const client = new Thordata();
+  const proxy = Thordata.Proxy.residentialFromEnv().country("us");
+
+  const proxyUrl = proxy.toProxyUrl();
+  console.log("====", protocol, "====");
+  printProxyEndpoint(proxyUrl);
+
+  const out = await client.request("https://ipinfo.thordata.com", { proxy });
+  console.log(out);
+}
+
+async function main() {
+  for (const p of ["http", "https", "socks5h"]) {
+    await runOne(p);
+  }
+}
+
+main().catch((e) => {
+  console.error(e);
+  process.exit(1);
+});

package-lock.json

@@ -51,16 +51,17 @@
   "author": "Thordata Developer Team",
   "license": "MIT",
   "dependencies": {
-    "axios": "^1.7.0"
+    "axios": "^1.7.0",
+    "http-proxy-agent": "^7.0.2",
+    "https-proxy-agent": "^7.0.6",
+    "socks-proxy-agent": "^8.0.5"
   },
   "devDependencies": {
     "@eslint/js": "^9.39.2",
     "@types/node": "^22.8.1",
     "@vitest/coverage-v8": "^4.0.16",
     "dotenv": "^16.4.5",
     "eslint": "^9.39.2",
-    "http-proxy-agent": "^7.0.2",
-    "https-proxy-agent": "^7.0.6",
     "nock": "^14.0.10",
     "prettier": "^3.7.4",
     "ts-node": "^10.9.2",

package.json

@@ -2,6 +2,7 @@
 
 import { HttpsProxyAgent } from "https-proxy-agent";
 import { HttpProxyAgent } from "http-proxy-agent";
+import { SocksProxyAgent } from "socks-proxy-agent";
 import axios, { AxiosInstance } from "axios";
 import https from "node:https";
 import { Engine, TaskStatus } from "./enums.js";
@@ -138,7 +139,8 @@ export class ThordataClient {
     // We need "https://openapi.thordata.com/api" for other endpoints
     const apiBase = this.baseUrls.locationsBaseUrl.replace(/\/locations$/, "");
     const whitelistBase = process.env.THORDATA_WHITELIST_BASE_URL || "https://api.thordata.com/api";
-    const proxyApiBase = process.env.THORDATA_PROXY_API_BASE_URL || "https://api.thordata.com/api";
+    const proxyApiBase =
+      process.env.THORDATA_PROXY_API_BASE_URL || "https://openapi.thordata.com/api";
 
     this.usageStatsUrl = `${apiBase}/account/usage-statistics`;
     this.proxyUsersUrl = `${apiBase}/proxy-users`;
@@ -594,12 +596,21 @@ export class ThordataClient {
       // Disable axios proxy logic & env proxy interference; use explicit agents
       axiosConfig.proxy = false;
 
-      // IMPORTANT:
-      // - httpAgent is used for http:// targets
-      // - httpsAgent is used for https:// targets
-      // Both should point to a proxy agent that can CONNECT through the proxy.
-      axiosConfig.httpAgent = new HttpProxyAgent(proxyUrl);
-      axiosConfig.httpsAgent = new HttpsProxyAgent(proxyUrl);
+      const scheme = new URL(proxyUrl).protocol; // "http:" | "https:" | "socks5:" | "socks5h:"
+
+      if (scheme.startsWith("socks")) {
+        const agent = new SocksProxyAgent(proxyUrl);
+        axiosConfig.httpAgent = agent;
+        axiosConfig.httpsAgent = agent;
+      } else if (scheme === "https:") {
+        const agent = new HttpsProxyAgent(proxyUrl);
+        axiosConfig.httpAgent = agent;
+        axiosConfig.httpsAgent = agent;
+      } else {
+        const agent = new HttpProxyAgent(proxyUrl);
+        axiosConfig.httpAgent = agent;
+        axiosConfig.httpsAgent = agent;
+      }
     }
 
     return this.execute(async () => {

sdk-spec

@@ -256,11 +256,25 @@ export class Proxy {
     // Resolve endpoint (allow Dashboard shard host via env)
     const productUpper = this.product.toUpperCase();
 
+    const envNonEmpty = (v?: string) => {
+      const s = (v ?? "").trim();
+      return s ? s : undefined;
+    };
+
     const protocol =
-      process.env[`THORDATA_${productUpper}_PROXY_PROTOCOL`] ??
-      process.env.THORDATA_PROXY_PROTOCOL ??
+      envNonEmpty(process.env[`THORDATA_${productUpper}_PROXY_PROTOCOL`]) ??
+      envNonEmpty(process.env.THORDATA_PROXY_PROTOCOL) ??
       "https";
 
+    const allowed = new Set(["http", "https", "socks5", "socks5h"]);
+    if (!allowed.has(protocol)) {
+      throw new Error(
+        `Invalid THORDATA_*_PROXY_PROTOCOL: ${protocol}. Use http/https/socks5/socks5h`,
+      );
+    }
+
+    const normalizedProtocol = protocol === "socks5" ? "socks5h" : protocol;
+
     const host =
       process.env[`THORDATA_${productUpper}_PROXY_HOST`] ??
       process.env.THORDATA_PROXY_HOST ??
@@ -284,7 +298,7 @@ export class Proxy {
     const username = encodeURIComponent(this.buildUsername());
     const password = encodeURIComponent(this.credentials.password);
 
-    return `${protocol}://${username}:${password}@${host}:${port}`;
+    return `${normalizedProtocol}://${username}:${password}@${host}:${port}`;
   }
 
   /**