thordata-js-sdk 0.2.0 → 0.4.0

package/dist/examples/location_api.js

@@ -0,0 +1,47 @@
+// examples/location_api.ts
+import "dotenv/config";
+import { Thordata } from "../src/thordata.js";
+async function main() {
+    if (!process.env.THORDATA_PUBLIC_TOKEN || !process.env.THORDATA_PUBLIC_KEY) {
+        console.log("Location API Demo - Skipped");
+        console.log("Set THORDATA_PUBLIC_TOKEN and THORDATA_PUBLIC_KEY in .env");
+        return;
+    }
+    const client = new Thordata();
+    console.log("Location API Demo\n");
+    // List countries (now using string parameter)
+    console.log("1. Listing countries...");
+    const countries = await client.listCountries("residential");
+    console.log(`   Found ${countries.length} countries`);
+    console.log(`   First 5: ${countries
+        .slice(0, 5)
+        .map((c) => c.country_code)
+        .join(", ")}`);
+    // List states for US
+    console.log("\n2. Listing US states...");
+    const states = await client.listStates("US", "residential");
+    console.log(`   Found ${states.length} states`);
+    console.log(`   First 5: ${states
+        .slice(0, 5)
+        .map((s) => s.state_name)
+        .join(", ")}`);
+    // List cities for California
+    console.log("\n3. Listing California cities...");
+    const cities = await client.listCities("US", "california", "residential");
+    console.log(`   Found ${cities.length} cities`);
+    console.log(`   First 5: ${cities
+        .slice(0, 5)
+        .map((c) => c.city_name)
+        .join(", ")}`);
+    // List ASNs for US
+    console.log("\n4. Listing US ASNs...");
+    const asns = await client.listAsns("US", "residential");
+    console.log(`   Found ${asns.length} ASNs`);
+    console.log(`   First 3: ${asns
+        .slice(0, 3)
+        .map((a) => `${a.asn_code}: ${a.asn_name}`)
+        .join(", ")}`);
+    console.log("\nLocation API demo completed.");
+}
+main().catch(console.error);
+//# sourceMappingURL=location_api.js.map

package/dist/examples/location_api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"location_api.js","sourceRoot":"","sources":["../../examples/location_api.ts"],"names":[],"mappings":"AAAA,2BAA2B;AAE3B,OAAO,eAAe,CAAC;AACvB,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAE9C,KAAK,UAAU,IAAI;IACjB,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,qBAAqB,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,mBAAmB,EAAE,CAAC;QAC3E,OAAO,CAAC,GAAG,CAAC,6BAA6B,CAAC,CAAC;QAC3C,OAAO,CAAC,GAAG,CAAC,2DAA2D,CAAC,CAAC;QACzE,OAAO;IACT,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;IAE9B,OAAO,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAC;IAEnC,8CAA8C;IAC9C,OAAO,CAAC,GAAG,CAAC,yBAAyB,CAAC,CAAC;IACvC,MAAM,SAAS,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,aAAa,CAAC,CAAC;IAC5D,OAAO,CAAC,GAAG,CAAC,YAAY,SAAS,CAAC,MAAM,YAAY,CAAC,CAAC;IACtD,OAAO,CAAC,GAAG,CACT,eAAe,SAAS;SACrB,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;SACX,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,YAAY,CAAC;SAC1B,IAAI,CAAC,IAAI,CAAC,EAAE,CAChB,CAAC;IAEF,qBAAqB;IACrB,OAAO,CAAC,GAAG,CAAC,2BAA2B,CAAC,CAAC;IACzC,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC;IAC5D,OAAO,CAAC,GAAG,CAAC,YAAY,MAAM,CAAC,MAAM,SAAS,CAAC,CAAC;IAChD,OAAO,CAAC,GAAG,CACT,eAAe,MAAM;SAClB,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;SACX,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC;SACxB,IAAI,CAAC,IAAI,CAAC,EAAE,CAChB,CAAC;IAEF,6BAA6B;IAC7B,OAAO,CAAC,GAAG,CAAC,mCAAmC,CAAC,CAAC;IACjD,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE,YAAY,EAAE,aAAa,CAAC,CAAC;IAC1E,OAAO,CAAC,GAAG,CAAC,YAAY,MAAM,CAAC,MAAM,SAAS,CAAC,CAAC;IAChD,OAAO,CAAC,GAAG,CACT,eAAe,MAAM;SAClB,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;SACX,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;SACvB,IAAI,CAAC,IAAI,CAAC,EAAE,CAChB,CAAC;IAEF,mBAAmB;IACnB,OAAO,CAAC,GAAG,CAAC,yBAAyB,CAAC,CAAC;IACvC,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC;IACxD,OAAO,CAAC,GAAG,CAAC,YAAY,IAAI,CAAC,MAAM,OAAO,CAAC,CAAC;IAC5C,OAAO,CAAC,GAAG,CACT,eAAe,IAAI;SAChB,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;SACX,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,QAAQ,KAAK,CAAC,CAAC,QAAQ,EAAE,CAAC;SAC1C,IAAI,CAAC,IAAI,CAAC,EAAE,CAChB,CAAC;IAEF,OAAO,CAAC,GAAG,CAAC,gCAAgC,CAAC,CAAC;AAChD,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC"}

package/dist/examples/proxy_datacenter.js

@@ -11,7 +11,7 @@ async function main() {
     const testUrl = "http://httpbin.org/ip";
     console.log("Datacenter Proxy Demo\n");
     const proxy = Thordata.Proxy.datacenterFromEnv();
-    const result = await client.request(testUrl, { proxy });
+    const result = (await client.request(testUrl, { proxy }));
     console.log("Datacenter IP:", result.origin);
 }
 main().catch(console.error);

package/dist/examples/proxy_datacenter.js.map

@@ -1 +1 @@
-{"version":3,"file":"proxy_datacenter.js","sourceRoot":"","sources":["../../examples/proxy_datacenter.ts"],"names":[],"mappings":"AAAA,+BAA+B;AAC/B,OAAO,eAAe,CAAC;AACvB,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAE9C,KAAK,UAAU,IAAI;IACjB,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,4BAA4B,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,4BAA4B,EAAE,CAAC;QAC3F,OAAO,CAAC,GAAG,CAAC,iCAAiC,CAAC,CAAC;QAC/C,OAAO,CAAC,GAAG,CAAC,2EAA2E,CAAC,CAAC;QACzF,OAAO;IACT,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;IAC9B,MAAM,OAAO,GAAG,uBAAuB,CAAC;IAExC,OAAO,CAAC,GAAG,CAAC,yBAAyB,CAAC,CAAC;IAEvC,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,iBAAiB,EAAE,CAAC;IACjD,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;IACxD,OAAO,CAAC,GAAG,CAAC,gBAAgB,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;AAC/C,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC"}
+{"version":3,"file":"proxy_datacenter.js","sourceRoot":"","sources":["../../examples/proxy_datacenter.ts"],"names":[],"mappings":"AAAA,+BAA+B;AAE/B,OAAO,eAAe,CAAC;AACvB,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAM9C,KAAK,UAAU,IAAI;IACjB,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,4BAA4B,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,4BAA4B,EAAE,CAAC;QAC3F,OAAO,CAAC,GAAG,CAAC,iCAAiC,CAAC,CAAC;QAC/C,OAAO,CAAC,GAAG,CAAC,2EAA2E,CAAC,CAAC;QACzF,OAAO;IACT,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;IAC9B,MAAM,OAAO,GAAG,uBAAuB,CAAC;IAExC,OAAO,CAAC,GAAG,CAAC,yBAAyB,CAAC,CAAC;IAEvC,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,iBAAiB,EAAE,CAAC;IACjD,MAAM,MAAM,GAAG,CAAC,MAAM,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,CAAC,CAAoB,CAAC;IAC7E,OAAO,CAAC,GAAG,CAAC,gBAAgB,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;AAC/C,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC"}

package/dist/examples/proxy_isp.js

@@ -13,7 +13,7 @@ async function main() {
     const testUrl = "http://httpbin.org/ip";
     console.log("Static ISP Proxy Demo\n");
     const proxy = Thordata.Proxy.ispFromEnv();
-    const result = await client.request(testUrl, { proxy });
+    const result = (await client.request(testUrl, { proxy }));
     console.log("Static ISP IP:", result.origin);
     console.log("Expected IP  :", process.env.THORDATA_ISP_HOST);
 }

package/dist/examples/proxy_isp.js.map

@@ -1 +1 @@
-{"version":3,"file":"proxy_isp.js","sourceRoot":"","sources":["../../examples/proxy_isp.ts"],"names":[],"mappings":"AAAA,wBAAwB;AACxB,OAAO,eAAe,CAAC;AACvB,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAE9C,KAAK,UAAU,IAAI;IACjB,IACE,CAAC,OAAO,CAAC,GAAG,CAAC,iBAAiB;QAC9B,CAAC,OAAO,CAAC,GAAG,CAAC,qBAAqB;QAClC,CAAC,OAAO,CAAC,GAAG,CAAC,qBAAqB,EAClC,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,0BAA0B,CAAC,CAAC;QACxC,OAAO,CAAC,GAAG,CAAC,iFAAiF,CAAC,CAAC;QAC/F,OAAO;IACT,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;IAC9B,MAAM,OAAO,GAAG,uBAAuB,CAAC;IAExC,OAAO,CAAC,GAAG,CAAC,yBAAyB,CAAC,CAAC;IAEvC,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,UAAU,EAAE,CAAC;IAC1C,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;IACxD,OAAO,CAAC,GAAG,CAAC,gBAAgB,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;IAC7C,OAAO,CAAC,GAAG,CAAC,gBAAgB,EAAE,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC;AAC/D,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC"}
+{"version":3,"file":"proxy_isp.js","sourceRoot":"","sources":["../../examples/proxy_isp.ts"],"names":[],"mappings":"AAAA,wBAAwB;AAExB,OAAO,eAAe,CAAC;AACvB,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAM9C,KAAK,UAAU,IAAI;IACjB,IACE,CAAC,OAAO,CAAC,GAAG,CAAC,iBAAiB;QAC9B,CAAC,OAAO,CAAC,GAAG,CAAC,qBAAqB;QAClC,CAAC,OAAO,CAAC,GAAG,CAAC,qBAAqB,EAClC,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,0BAA0B,CAAC,CAAC;QACxC,OAAO,CAAC,GAAG,CAAC,iFAAiF,CAAC,CAAC;QAC/F,OAAO;IACT,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;IAC9B,MAAM,OAAO,GAAG,uBAAuB,CAAC;IAExC,OAAO,CAAC,GAAG,CAAC,yBAAyB,CAAC,CAAC;IAEvC,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,UAAU,EAAE,CAAC;IAC1C,MAAM,MAAM,GAAG,CAAC,MAAM,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,CAAC,CAAoB,CAAC;IAC7E,OAAO,CAAC,GAAG,CAAC,gBAAgB,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;IAC7C,OAAO,CAAC,GAAG,CAAC,gBAAgB,EAAE,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC;AAC/D,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC"}

package/dist/examples/proxy_mobile.js

@@ -11,7 +11,7 @@ async function main() {
     const testUrl = "http://httpbin.org/ip";
     console.log("Mobile Proxy Demo\n");
     const proxy = Thordata.Proxy.mobileFromEnv().country("gb");
-    const result = await client.request(testUrl, { proxy });
+    const result = (await client.request(testUrl, { proxy }));
     console.log("UK Mobile IP:", result.origin);
 }
 main().catch(console.error);

package/dist/examples/proxy_mobile.js.map

@@ -1 +1 @@
-{"version":3,"file":"proxy_mobile.js","sourceRoot":"","sources":["../../examples/proxy_mobile.ts"],"names":[],"mappings":"AAAA,2BAA2B;AAC3B,OAAO,eAAe,CAAC;AACvB,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAE9C,KAAK,UAAU,IAAI;IACjB,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,wBAAwB,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,wBAAwB,EAAE,CAAC;QACnF,OAAO,CAAC,GAAG,CAAC,6BAA6B,CAAC,CAAC;QAC3C,OAAO,CAAC,GAAG,CAAC,mEAAmE,CAAC,CAAC;QACjF,OAAO;IACT,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;IAC9B,MAAM,OAAO,GAAG,uBAAuB,CAAC;IAExC,OAAO,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAC;IAEnC,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,aAAa,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3D,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;IACxD,OAAO,CAAC,GAAG,CAAC,eAAe,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;AAC9C,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC"}
+{"version":3,"file":"proxy_mobile.js","sourceRoot":"","sources":["../../examples/proxy_mobile.ts"],"names":[],"mappings":"AAAA,2BAA2B;AAE3B,OAAO,eAAe,CAAC;AACvB,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAM9C,KAAK,UAAU,IAAI;IACjB,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,wBAAwB,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,wBAAwB,EAAE,CAAC;QACnF,OAAO,CAAC,GAAG,CAAC,6BAA6B,CAAC,CAAC;QAC3C,OAAO,CAAC,GAAG,CAAC,mEAAmE,CAAC,CAAC;QACjF,OAAO;IACT,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;IAC9B,MAAM,OAAO,GAAG,uBAAuB,CAAC;IAExC,OAAO,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAC;IAEnC,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,aAAa,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3D,MAAM,MAAM,GAAG,CAAC,MAAM,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,CAAC,CAAoB,CAAC;IAC7E,OAAO,CAAC,GAAG,CAAC,eAAe,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;AAC9C,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC"}

package/dist/examples/proxy_residential.js

@@ -12,7 +12,7 @@ async function main() {
     console.log("Residential Proxy Demo\n");
     // Basic usage
     const proxy1 = Thordata.Proxy.residentialFromEnv().country("us");
-    const r1 = await client.request(testUrl, { proxy: proxy1 });
+    const r1 = (await client.request(testUrl, { proxy: proxy1 }));
     console.log("US Residential IP:", r1.origin);
     // With sticky session
     const proxy2 = Thordata.Proxy.residentialFromEnv()
@@ -20,7 +20,7 @@ async function main() {
         .city("tokyo")
         .session("my_session")
         .sticky(30);
-    const r2 = await client.request(testUrl, { proxy: proxy2 });
+    const r2 = (await client.request(testUrl, { proxy: proxy2 }));
     console.log("Tokyo Sticky IP  :", r2.origin);
 }
 main().catch(console.error);

package/dist/examples/proxy_residential.js.map

@@ -1 +1 @@
-{"version":3,"file":"proxy_residential.js","sourceRoot":"","sources":["../../examples/proxy_residential.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAChC,OAAO,eAAe,CAAC;AACvB,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAE9C,KAAK,UAAU,IAAI;IACjB,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,6BAA6B,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,6BAA6B,EAAE,CAAC;QAC7F,OAAO,CAAC,GAAG,CAAC,kCAAkC,CAAC,CAAC;QAChD,OAAO,CAAC,GAAG,CAAC,6EAA6E,CAAC,CAAC;QAC3F,OAAO;IACT,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;IAC9B,MAAM,OAAO,GAAG,uBAAuB,CAAC;IAExC,OAAO,CAAC,GAAG,CAAC,0BAA0B,CAAC,CAAC;IAExC,cAAc;IACd,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,CAAC,kBAAkB,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACjE,MAAM,EAAE,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;IAC5D,OAAO,CAAC,GAAG,CAAC,oBAAoB,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC;IAE7C,sBAAsB;IACtB,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,CAAC,kBAAkB,EAAE;SAC/C,OAAO,CAAC,IAAI,CAAC;SACb,IAAI,CAAC,OAAO,CAAC;SACb,OAAO,CAAC,YAAY,CAAC;SACrB,MAAM,CAAC,EAAE,CAAC,CAAC;IACd,MAAM,EAAE,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;IAC5D,OAAO,CAAC,GAAG,CAAC,oBAAoB,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC;AAC/C,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC"}
+{"version":3,"file":"proxy_residential.js","sourceRoot":"","sources":["../../examples/proxy_residential.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAEhC,OAAO,eAAe,CAAC;AACvB,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAM9C,KAAK,UAAU,IAAI;IACjB,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,6BAA6B,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,6BAA6B,EAAE,CAAC;QAC7F,OAAO,CAAC,GAAG,CAAC,kCAAkC,CAAC,CAAC;QAChD,OAAO,CAAC,GAAG,CAAC,6EAA6E,CAAC,CAAC;QAC3F,OAAO;IACT,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;IAC9B,MAAM,OAAO,GAAG,uBAAuB,CAAC;IAExC,OAAO,CAAC,GAAG,CAAC,0BAA0B,CAAC,CAAC;IAExC,cAAc;IACd,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,CAAC,kBAAkB,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACjE,MAAM,EAAE,GAAG,CAAC,MAAM,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAoB,CAAC;IACjF,OAAO,CAAC,GAAG,CAAC,oBAAoB,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC;IAE7C,sBAAsB;IACtB,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,CAAC,kBAAkB,EAAE;SAC/C,OAAO,CAAC,IAAI,CAAC;SACb,IAAI,CAAC,OAAO,CAAC;SACb,OAAO,CAAC,YAAY,CAAC;SACrB,MAAM,CAAC,EAAE,CAAC,CAAC;IACd,MAAM,EAAE,GAAG,CAAC,MAAM,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAoB,CAAC;IACjF,OAAO,CAAC,GAAG,CAAC,oBAAoB,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC;AAC/C,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC"}

package/dist/examples/serp_google_news.d.ts

@@ -1,7 +1 @@
-/**
- * SERP Google News Demo
- *
- * Usage:
- *   npx ts-node examples/serp_google_news.ts
- */
 import "dotenv/config";

package/dist/examples/serp_google_news.js

@@ -1,9 +1,4 @@
-/**
- * SERP Google News Demo
- *
- * Usage:
- *   npx ts-node examples/serp_google_news.ts
- */
+// examples/serp_google_news.ts
 import "dotenv/config";
 import { ThordataClient, Engine } from "../src/index.js";
 async function main() {
@@ -29,7 +24,8 @@ async function main() {
         printNewsResults(results);
     }
     catch (e) {
-        console.error("❌ Search failed:", e.message);
+        const error = e;
+        console.error("❌ Search failed:", error.message);
     }
     // 2. Advanced News Filters
     console.log("\n📰 2. Advanced Filters (Sort by Date)");
@@ -40,16 +36,17 @@ async function main() {
             country: "us",
             language: "en",
             num: 5,
-            so: 1, // Sort by date
+            so: 1,
         });
         printNewsResults(results);
     }
     catch (e) {
-        console.error("❌ Advanced search failed:", e.message);
+        const error = e;
+        console.error("❌ Advanced search failed:", error.message);
     }
 }
 function printNewsResults(results) {
-    const news = results?.news ?? [];
+    const news = (results?.news ?? []);
     console.log(`✅ Found ${news.length} news items:`);
     news.slice(0, 5).forEach((item) => {
         console.log(`   ${item.rank}. [${item.source}] ${item.title}`);

package/dist/examples/serp_google_news.js.map

@@ -1 +1 @@
-{"version":3,"file":"serp_google_news.js","sourceRoot":"","sources":["../../examples/serp_google_news.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,eAAe,CAAC;AACvB,OAAO,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAEzD,KAAK,UAAU,IAAI;IACjB,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,sBAAsB,CAAC;IACjD,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,CAAC,KAAK,CAAC,mDAAmD,CAAC,CAAC;QACnE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,cAAc,CAAC;QAChC,YAAY,EAAE,KAAK;QACnB,UAAU,EAAE,CAAC;KACd,CAAC,CAAC;IAEH,uBAAuB;IACvB,OAAO,CAAC,GAAG,CAAC,mDAAmD,CAAC,CAAC;IACjE,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC;YACtC,KAAK,EAAE,eAAe;YACtB,MAAM,EAAE,MAAM,CAAC,WAAW;YAC1B,OAAO,EAAE,IAAI;YACb,QAAQ,EAAE,IAAI;YACd,GAAG,EAAE,CAAC;SACP,CAAC,CAAC;QACH,gBAAgB,CAAC,OAAO,CAAC,CAAC;IAC5B,CAAC;IAAC,OAAO,CAAM,EAAE,CAAC;QAChB,OAAO,CAAC,KAAK,CAAC,kBAAkB,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC;IAC/C,CAAC;IAED,2BAA2B;IAC3B,OAAO,CAAC,GAAG,CAAC,yCAAyC,CAAC,CAAC;IACvD,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC;YACtC,KAAK,EAAE,yBAAyB;YAChC,MAAM,EAAE,MAAM,CAAC,WAAW;YAC1B,OAAO,EAAE,IAAI;YACb,QAAQ,EAAE,IAAI;YACd,GAAG,EAAE,CAAC;YACN,EAAE,EAAE,CAAC,EAAE,eAAe;SACvB,CAAC,CAAC;QACH,gBAAgB,CAAC,OAAO,CAAC,CAAC;IAC5B,CAAC;IAAC,OAAO,CAAM,EAAE,CAAC;QAChB,OAAO,CAAC,KAAK,CAAC,2BAA2B,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC;IACxD,CAAC;AACH,CAAC;AAED,SAAS,gBAAgB,CAAC,OAAY;IACpC,MAAM,IAAI,GAAG,OAAO,EAAE,IAAI,IAAI,EAAE,CAAC;IAEjC,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,CAAC,MAAM,cAAc,CAAC,CAAC;IAElD,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAS,EAAE,EAAE;QACrC,OAAO,CAAC,GAAG,CAAC,MAAM,IAAI,CAAC,IAAI,MAAM,IAAI,CAAC,MAAM,KAAK,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;QAC/D,OAAO,CAAC,GAAG,CAAC,YAAY,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QACrC,OAAO,CAAC,GAAG,CAAC,YAAY,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;IACvC,CAAC,CAAC,CAAC;IACH,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;AAClB,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACnB,OAAO,CAAC,KAAK,CAAC,cAAc,EAAE,GAAG,CAAC,CAAC;AACrC,CAAC,CAAC,CAAC"}
+{"version":3,"file":"serp_google_news.js","sourceRoot":"","sources":["../../examples/serp_google_news.ts"],"names":[],"mappings":"AAAA,+BAA+B;AAE/B,OAAO,eAAe,CAAC;AACvB,OAAO,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAEzD,KAAK,UAAU,IAAI;IACjB,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,sBAAsB,CAAC;IACjD,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,CAAC,KAAK,CAAC,mDAAmD,CAAC,CAAC;QACnE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,cAAc,CAAC;QAChC,YAAY,EAAE,KAAK;QACnB,UAAU,EAAE,CAAC;KACd,CAAC,CAAC;IAEH,uBAAuB;IACvB,OAAO,CAAC,GAAG,CAAC,mDAAmD,CAAC,CAAC;IACjE,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC;YACtC,KAAK,EAAE,eAAe;YACtB,MAAM,EAAE,MAAM,CAAC,WAAW;YAC1B,OAAO,EAAE,IAAI;YACb,QAAQ,EAAE,IAAI;YACd,GAAG,EAAE,CAAC;SACP,CAAC,CAAC;QACH,gBAAgB,CAAC,OAAO,CAAC,CAAC;IAC5B,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,MAAM,KAAK,GAAG,CAAU,CAAC;QACzB,OAAO,CAAC,KAAK,CAAC,kBAAkB,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;IACnD,CAAC;IAED,2BAA2B;IAC3B,OAAO,CAAC,GAAG,CAAC,yCAAyC,CAAC,CAAC;IACvD,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC;YACtC,KAAK,EAAE,yBAAyB;YAChC,MAAM,EAAE,MAAM,CAAC,WAAW;YAC1B,OAAO,EAAE,IAAI;YACb,QAAQ,EAAE,IAAI;YACd,GAAG,EAAE,CAAC;YACN,EAAE,EAAE,CAAC;SACN,CAAC,CAAC;QACH,gBAAgB,CAAC,OAAO,CAAC,CAAC;IAC5B,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,MAAM,KAAK,GAAG,CAAU,CAAC;QACzB,OAAO,CAAC,KAAK,CAAC,2BAA2B,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;IAC5D,CAAC;AACH,CAAC;AAUD,SAAS,gBAAgB,CAAC,OAAgC;IACxD,MAAM,IAAI,GAAG,CAAC,OAAO,EAAE,IAAI,IAAI,EAAE,CAAe,CAAC;IAEjD,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,CAAC,MAAM,cAAc,CAAC,CAAC;IAElD,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE;QAChC,OAAO,CAAC,GAAG,CAAC,MAAM,IAAI,CAAC,IAAI,MAAM,IAAI,CAAC,MAAM,KAAK,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;QAC/D,OAAO,CAAC,GAAG,CAAC,YAAY,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QACrC,OAAO,CAAC,GAAG,CAAC,YAAY,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;IACvC,CAAC,CAAC,CAAC;IACH,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;AAClB,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACnB,OAAO,CAAC,KAAK,CAAC,cAAc,EAAE,GAAG,CAAC,CAAC;AACrC,CAAC,CAAC,CAAC"}

package/dist/examples/verify_new_features.js

@@ -0,0 +1,135 @@
+// examples/verify_new_features.ts
+import "dotenv/config";
+import { ThordataClient } from "../src/index.js";
+async function main() {
+    const args = process.argv.slice(2);
+    const testName = args[0] || "all";
+    const scraperToken = process.env.THORDATA_SCRAPER_TOKEN;
+    const publicToken = process.env.THORDATA_PUBLIC_TOKEN;
+    const publicKey = process.env.THORDATA_PUBLIC_KEY;
+    const sign = process.env.THORDATA_SIGN || publicToken;
+    const apiKey = process.env.THORDATA_API_KEY || publicKey;
+    if (!scraperToken) {
+        console.error("❌ THORDATA_SCRAPER_TOKEN required");
+        process.exit(1);
+    }
+    const client = new ThordataClient({
+        scraperToken,
+        publicToken,
+        publicKey,
+        sign, // Public API NEW
+        apiKey, // Public API NEW
+    });
+    console.log("========================================");
+    console.log("Thordata SDK - New Features Verification");
+    console.log("========================================");
+    const tests = {
+        video_task: async () => {
+            console.log("\n--- Testing: Video Task Creation ---");
+            try {
+                const taskId = await client.createVideoTask({
+                    fileName: "test_{{VideoID}}",
+                    spiderId: "youtube_video_by-url",
+                    spiderName: "youtube.com",
+                    parameters: { url: "https://www.youtube.com/watch?v=dQw4w9WgXcQ" },
+                    commonSettings: { resolution: "720p", is_subtitles: "false" },
+                });
+                console.log(`✅ Video task created: ${taskId}`);
+                return true;
+            }
+            catch (e) {
+                console.log(`❌ Failed: ${e.message}`);
+                return false;
+            }
+        },
+        usage_stats: async () => {
+            console.log("\n--- Testing: Usage Statistics ---");
+            try {
+                const now = new Date();
+                const weekAgo = new Date(now.getTime() - 7 * 24 * 3600 * 1000);
+                const fmt = (d) => d.toISOString().split("T")[0];
+                const stats = await client.getUsageStatistics(fmt(weekAgo), fmt(now));
+                console.log(`✅ Stats Retrieved:`);
+                console.log(`   Balance: ${(stats.traffic_balance / 1024 ** 3).toFixed(2)} GB`);
+                return true;
+            }
+            catch (e) {
+                console.log(`❌ Failed: ${e.message}`);
+                return false;
+            }
+        },
+        proxy_users: async () => {
+            console.log("\n--- Testing: Proxy Users ---");
+            try {
+                const users = await client.listProxyUsers("residential");
+                console.log(`✅ Users Retrieved: ${users.user_count}`);
+                if (users.list.length > 0) {
+                    console.log(`   User 1: ${users.list[0].username}`);
+                }
+                return true;
+            }
+            catch (e) {
+                console.log(`❌ Failed: ${e.message}`);
+                return false;
+            }
+        },
+        proxy_servers: async () => {
+            console.log("\n--- Testing: Proxy Servers (ISP) ---");
+            try {
+                const servers = await client.listProxyServers(1); // 1 = ISP
+                console.log(`✅ ISP Servers: ${servers.length}`);
+                if (servers.length > 0) {
+                    console.log(`   Server 1: ${servers[0].ip}:${servers[0].port}`);
+                }
+                return true;
+            }
+            catch (e) {
+                console.log(`❌ Failed: ${e.message}`);
+                return false;
+            }
+        },
+        api_new_balance: async () => {
+            console.log("\n--- Testing: API NEW - Balance ---");
+            try {
+                const res = await client.getResidentialBalance();
+                console.log(`✅ Balance: ${(res.balance / 1024 ** 3).toFixed(2)} GB`);
+                return true;
+            }
+            catch (e) {
+                console.log(`❌ Failed: ${e.message}`);
+                return false;
+            }
+        },
+        api_new_isp: async () => {
+            console.log("\n--- Testing: API NEW - ISP Regions ---");
+            try {
+                const regions = await client.getIspRegions();
+                console.log(`✅ Regions: ${regions.length}`);
+                if (regions.length > 0) {
+                    const r = regions[0];
+                    console.log(`   ${r.country}/${r.city}: ${r.num} IPs`);
+                }
+                return true;
+            }
+            catch (e) {
+                console.log(`❌ Failed: ${e.message}`);
+                return false;
+            }
+        },
+    };
+    let passed = 0;
+    let total = 0;
+    for (const [name, fn] of Object.entries(tests)) {
+        if (testName === "all" || testName === name) {
+            total++;
+            if (await fn())
+                passed++;
+        }
+    }
+    console.log("\n========================================");
+    console.log(`Summary: ${passed}/${total} passed`);
+    console.log("========================================");
+    process.exit(passed === total ? 0 : 1);
+}
+main().catch(console.error);
+//# sourceMappingURL=verify_new_features.js.map

package/dist/examples/verify_new_features.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"verify_new_features.js","sourceRoot":"","sources":["../../examples/verify_new_features.ts"],"names":[],"mappings":"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"}

package/dist/src/auth.d.ts

@@ -0,0 +1,22 @@
+export type Headers = Record<string, string>;
+export interface Credentials {
+    scraperToken: string;
+    publicToken?: string;
+    publicKey?: string;
+}
+/**
+ * Build headers for SERP/Universal scraping APIs.
+ * Docs require a `token` header (Account Settings token).
+ * Some docs/examples also use `Authorization: Bearer ...`, so we send both for compatibility.
+ */
+export declare function buildScraperHeaders(creds: Credentials): Headers;
+/**
+ * Build headers for Public APIs (Web Scraper task status/download/list, etc.).
+ * These APIs require `token` + `key` from Dashboard -> My Account.
+ */
+export declare function buildPublicHeaders(creds: Credentials): Headers;
+/**
+ * Build headers for Web Scraper builder endpoint.
+ * Interface docs require `token` + `key` (My Account) AND `Authorization: Bearer ...` (scraper token).
+ */
+export declare function buildBuilderHeaders(creds: Credentials): Headers;

package/dist/src/auth.js

@@ -0,0 +1,39 @@
+// src/auth.ts
+/**
+ * Build headers for SERP/Universal scraping APIs.
+ * Docs require a `token` header (Account Settings token).
+ * Some docs/examples also use `Authorization: Bearer ...`, so we send both for compatibility.
+ */
+export function buildScraperHeaders(creds) {
+    if (!creds.scraperToken) {
+        throw new Error("scraperToken is required");
+    }
+    return {
+        token: creds.scraperToken,
+        Authorization: `Bearer ${creds.scraperToken}`,
+    };
+}
+/**
+ * Build headers for Public APIs (Web Scraper task status/download/list, etc.).
+ * These APIs require `token` + `key` from Dashboard -> My Account.
+ */
+export function buildPublicHeaders(creds) {
+    if (!creds.publicToken || !creds.publicKey) {
+        throw new Error("publicToken and publicKey are required");
+    }
+    return {
+        token: creds.publicToken,
+        key: creds.publicKey,
+    };
+}
+/**
+ * Build headers for Web Scraper builder endpoint.
+ * Interface docs require `token` + `key` (My Account) AND `Authorization: Bearer ...` (scraper token).
+ */
+export function buildBuilderHeaders(creds) {
+    return {
+        ...buildPublicHeaders(creds),
+        Authorization: `Bearer ${creds.scraperToken}`,
+    };
+}
+//# sourceMappingURL=auth.js.map

package/dist/src/auth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.js","sourceRoot":"","sources":["../../src/auth.ts"],"names":[],"mappings":"AAAA,cAAc;AAUd;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAAkB;IACpD,IAAI,CAAC,KAAK,CAAC,YAAY,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAC;IAC9C,CAAC;IAED,OAAO;QACL,KAAK,EAAE,KAAK,CAAC,YAAY;QACzB,aAAa,EAAE,UAAU,KAAK,CAAC,YAAY,EAAE;KAC9C,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAkB;IACnD,IAAI,CAAC,KAAK,CAAC,WAAW,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,CAAC;QAC3C,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;IAC5D,CAAC;IAED,OAAO;QACL,KAAK,EAAE,KAAK,CAAC,WAAW;QACxB,GAAG,EAAE,KAAK,CAAC,SAAS;KACrB,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAAkB;IACpD,OAAO;QACL,GAAG,kBAAkB,CAAC,KAAK,CAAC;QAC5B,aAAa,EAAE,UAAU,KAAK,CAAC,YAAY,EAAE;KAC9C,CAAC;AACJ,CAAC"}

package/dist/src/client.d.ts

@@ -1,19 +1,44 @@
-import { SerpOptions, UniversalOptions, ScraperTaskOptions, WaitForTaskOptions } from "./models.js";
+import { SerpOptions, UniversalOptions, ScraperTaskOptions, WaitForTaskOptions, ProxyTypeParam, CountryInfo, StateInfo, CityInfo, AsnInfo, VideoTaskOptions, UsageStatistics, ProxyUserList, ProxyServer } from "./models.js";
 import { type ThordataBaseUrls } from "./endpoints.js";
 import { Proxy } from "./proxy.js";
+/**
+ * Configuration options for ThordataClient.
+ */
 export interface ThordataClientConfig {
+    /** API token for SERP and Universal APIs */
     scraperToken: string;
+    /** Public token for Web Scraper API and Location API */
     publicToken?: string;
+    /** Public key for Web Scraper API and Location API */
     publicKey?: string;
+    /** Request timeout in milliseconds (default: 30000) */
+    sign?: string;
+    /** Sign for Public API NEW (optional, falls back to publicToken) */
+    apiKey?: string;
+    /** API Key for Public API NEW (optional, falls back to publicKey) */
     timeoutMs?: number;
+    /** Maximum number of retries on failure (default: 0) */
     maxRetries?: number;
+    /** Custom base URLs for API endpoints */
     baseUrls?: Partial<ThordataBaseUrls>;
+    /** Custom User-Agent string */
     userAgent?: string;
+    /**
+     * Whether to verify SSL certificates (default: true).
+     * Set to false only for testing with self-signed certificates.
+     */
+    verifySsl?: boolean;
 }
+/**
+ * Main client for interacting with Thordata APIs.
+ */
 export declare class ThordataClient {
     private scraperToken;
     private publicToken?;
     private publicKey?;
+    private sign?;
+    private apiKey?;
+    private gatewayBaseUrl;
     private timeoutMs;
     private maxRetries;
     private http;
@@ -24,21 +49,134 @@ export declare class ThordataClient {
     private scraperBuilderUrl;
     private scraperStatusUrl;
     private scraperDownloadUrl;
+    private videoBuilderUrl;
+    private usageStatsUrl;
+    private proxyUsersUrl;
+    private whitelistUrl;
+    private proxyListUrl;
+    private proxyExpirationUrl;
+    private taskListUrl;
     constructor(config: ThordataClientConfig);
     /**
-     * Internal helper to execute request with retry logic
+     * Execute request with retry logic.
      */
     private execute;
-    serpSearch(options: SerpOptions): Promise<any>;
-    universalScrape(options: UniversalOptions): Promise<string | Buffer>;
+    /**
+     * Perform a search using the SERP API.
+     *
+     * Supported engines: google, bing, yandex, duckduckgo
+     * Plus Google specialized engines: google_news, google_shopping, etc.
+     *
+     * @example
+     * ```typescript
+     * // Basic Google search
+     * const results = await client.serpSearch({
+     *   query: "pizza",
+     *   engine: Engine.GOOGLE,
+     *   country: "us",
+     * });
+     *
+     * // Google News (recommended: use dedicated engine)
+     * const news = await client.serpSearch({
+     *   query: "AI regulation",
+     *   engine: Engine.GOOGLE_NEWS,
+     * });
+     * ```
+     */
+    serpSearch(options: SerpOptions): Promise<Record<string, unknown>>;
+    /**
+     * Scrape a URL using the Universal/Web Unlocker API.
+     *
+     * @example
+     * ```typescript
+     * // Basic HTML scraping
+     * const html = await client.universalScrape({
+     *   url: "https://example.com",
+     *   jsRender: false,
+     * });
+     *
+     * // With JS rendering and wait for element
+     * const html = await client.universalScrape({
+     *   url: "https://example.com/spa",
+     *   jsRender: true,
+     *   waitFor: ".main-content",
+     * });
+     *
+     * // Screenshot
+     * const png = await client.universalScrape({
+     *   url: "https://example.com",
+     *   jsRender: true,
+     *   outputFormat: "png",
+     * });
+     * ```
+     */
+    universalScrape(options: UniversalOptions): Promise<string | Buffer | Record<string, unknown>>;
+    /**
+     * Create a new Web Scraper task.
+     */
     createScraperTask(options: ScraperTaskOptions): Promise<string>;
+    /**
+     * Verify that public credentials are available.
+     */
     private requirePublicCreds;
+    /**
+     * Get the status of a Web Scraper task.
+     */
     getTaskStatus(taskId: string): Promise<string>;
+    /**
+     * Get the download URL for a completed task's results.
+     */
     getTaskResult(taskId: string, fileType?: "json" | "csv" | "xlsx"): Promise<string>;
+    /**
+     * Create a YouTube video/audio download task.
+     */
+    createVideoTask(options: VideoTaskOptions): Promise<string>;
+    /**
+     * Wait for a task to complete.
+     */
     waitForTask(taskId: string, options?: WaitForTaskOptions): Promise<string>;
+    /**
+     * Make an HTTP request through a proxy.
+     */
     request(url: string, config?: {
         proxy?: Proxy;
         timeout?: number;
-        [key: string]: any;
-    }): Promise<any>;
+        [key: string]: unknown;
+    }): Promise<unknown>;
+    listTasks(page?: number, size?: number): Promise<{
+        count: number;
+        list: any[];
+    }>;
+    getUsageStatistics(fromDate: string, toDate: string): Promise<UsageStatistics>;
+    listProxyUsers(proxyType?: ProxyTypeParam): Promise<ProxyUserList>;
+    createProxyUser(username: string, pass: string, trafficLimit?: number, status?: boolean, proxyType?: ProxyTypeParam): Promise<any>;
+    addWhitelistIp(ip: string, status?: boolean, proxyType?: ProxyTypeParam): Promise<any>;
+    listProxyServers(proxyType: 1 | 2): Promise<ProxyServer[]>;
+    private buildSignHeaders;
+    getResidentialBalance(): Promise<{
+        balance: number;
+        expire_time: number;
+    }>;
+    getIspRegions(): Promise<any[]>;
+    listIspProxies(): Promise<any[]>;
+    /**
+     * Internal method to call locations API.
+     */
+    private getLocations;
+    /**
+     * List all supported countries for a proxy type.
+     */
+    listCountries(proxyType?: ProxyTypeParam): Promise<CountryInfo[]>;
+    /**
+     * List states/regions for a country.
+     */
+    listStates(countryCode: string, proxyType?: ProxyTypeParam): Promise<StateInfo[]>;
+    /**
+     * List cities for a country (and optionally state).
+     */
+    listCities(countryCode: string, stateCode?: string, proxyType?: ProxyTypeParam): Promise<CityInfo[]>;
+    /**
+     * List ASNs for a country.
+     */
+    listAsns(countryCode: string, proxyType?: ProxyTypeParam): Promise<AsnInfo[]>;
 }