thordata-js-sdk 0.2.0 → 0.3.0

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/src/client.d.ts

@@ -1,15 +1,33 @@
-import { SerpOptions, UniversalOptions, ScraperTaskOptions, WaitForTaskOptions } from "./models.js";
+import { SerpOptions, UniversalOptions, ScraperTaskOptions, WaitForTaskOptions, ProxyTypeParam, CountryInfo, StateInfo, CityInfo, AsnInfo } 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) */
     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?;
@@ -26,19 +44,105 @@ export declare class ThordataClient {
     private scraperDownloadUrl;
     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>;
+    /**
+     * 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>;
+    /**
+     * 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[]>;
 }

package/dist/src/client.js

@@ -2,11 +2,22 @@
 import axios from "axios";
 import https from "node:https";
 import { Engine, TaskStatus } from "./enums.js";
-import { ThordataError, ThordataTimeoutError } from "./errors.js";
-import { buildAuthHeaders, buildPublicHeaders, handleAxiosError, toFormBody, raiseForCode, safeParseJson, withRetry, } from "./utils.js";
+import { ThordataError, ThordataTimeoutError, ThordataConfigError } from "./errors.js";
+import { buildAuthHeaders, buildPublicHeaders, handleAxiosError, toFormBody, raiseForCode, safeParseJson, withRetry, buildUserAgent, } from "./utils.js";
 import { resolveBaseUrls } from "./endpoints.js";
-import { buildUserAgent } from "./utils.js";
 import { Proxy } from "./proxy.js";
+/**
+ * Normalize proxy type parameter to numeric value.
+ */
+function normalizeProxyType(proxyType) {
+    if (typeof proxyType === "number") {
+        return proxyType;
+    }
+    return proxyType === "residential" ? 1 : 2;
+}
+/**
+ * Main client for interacting with Thordata APIs.
+ */
 export class ThordataClient {
     scraperToken;
     publicToken;
@@ -23,15 +34,17 @@ export class ThordataClient {
     scraperDownloadUrl;
     constructor(config) {
         if (!config.scraperToken) {
-            throw new ThordataError("scraperToken is required");
+            throw new ThordataConfigError("scraperToken is required");
         }
         this.scraperToken = config.scraperToken;
         this.publicToken = config.publicToken;
         this.publicKey = config.publicKey;
         this.timeoutMs = config.timeoutMs ?? 30000;
-        this.maxRetries = config.maxRetries ?? 0; // Default: no retry
+        this.maxRetries = config.maxRetries ?? 0;
+        const verifySsl = config.verifySsl ?? true;
         this.http = axios.create({
             timeout: this.timeoutMs,
+            httpsAgent: new https.Agent({ rejectUnauthorized: verifySsl }),
         });
         this.baseUrls = resolveBaseUrls(process.env, config.baseUrls);
         this.serpUrl = `${this.baseUrls.scraperapiBaseUrl}/request`;
@@ -39,16 +52,12 @@ export class ThordataClient {
         this.universalUrl = `${this.baseUrls.universalapiBaseUrl}/request`;
         this.scraperStatusUrl = `${this.baseUrls.webScraperApiBaseUrl}/tasks-status`;
         this.scraperDownloadUrl = `${this.baseUrls.webScraperApiBaseUrl}/tasks-download`;
-        this.userAgent =
-            config.userAgent ??
-                buildUserAgent(
-                // fallback: avoid relying on npm_package_version in runtime
-                process.env.npm_package_version || "0.0.0");
-        // Set default headers for all requests
+        const pkgVersion = process.env.npm_package_version || "0.0.0";
+        this.userAgent = config.userAgent ?? buildUserAgent(pkgVersion);
         this.http.defaults.headers.common["User-Agent"] = this.userAgent;
     }
     /**
-     * Internal helper to execute request with retry logic
+     * Execute request with retry logic.
      */
     async execute(requestFn) {
         return withRetry(async () => {
@@ -63,16 +72,39 @@ export class ThordataClient {
     // --------------------------
     // 1) SERP API
     // --------------------------
+    /**
+     * 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,
+     * });
+     * ```
+     */
     async serpSearch(options) {
         const { query, engine = Engine.GOOGLE, num, start, country, language, searchType, device, renderJs, noCache, outputFormat = "json", ...extra } = options;
         if (!query) {
-            throw new ThordataError("query is required for serpSearch");
+            throw new ThordataConfigError("query is required for serpSearch");
         }
         const engineStr = String(engine).toLowerCase();
         const payload = {
             engine: engineStr,
             json: outputFormat.toLowerCase() === "html" ? "0" : "1",
         };
+        // Yandex uses 'text' instead of 'q'
         if (engineStr === "yandex") {
             payload.text = query;
         }
@@ -87,15 +119,9 @@ export class ThordataClient {
             payload.gl = country.toLowerCase();
         if (language)
             payload.hl = language.toLowerCase();
+        // tbm parameter (only for specific Google engines)
         if (searchType) {
-            const st = searchType.toLowerCase();
-            const tbmMap = {
-                images: "isch",
-                shopping: "shop",
-                news: "nws",
-                videos: "vid",
-            };
-            payload.tbm = tbmMap[st] ?? st;
+            payload.tbm = searchType.toLowerCase();
         }
         if (device)
             payload.device = device.toLowerCase();
@@ -126,15 +152,46 @@ export class ThordataClient {
     // --------------------------
     // 2) Universal / Web Unlocker
     // --------------------------
+    /**
+     * 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",
+     * });
+     * ```
+     */
     async universalScrape(options) {
         const { url, jsRender = false, outputFormat = "html", country, blockResources, cleanContent, wait, waitFor, headers: customHeaders, cookies, ...extra } = options;
         if (!url) {
-            throw new ThordataError("url is required for universalScrape");
+            throw new ThordataConfigError("url is required for universalScrape");
+        }
+        const format = String(outputFormat).toLowerCase();
+        // Validate output format
+        if (format !== "html" && format !== "png") {
+            throw new ThordataConfigError(`Invalid outputFormat: "${outputFormat}". Supported values: "html", "png"`);
         }
         const payload = {
             url,
             js_render: jsRender ? "True" : "False",
-            type: outputFormat.toLowerCase(),
+            type: format,
         };
         if (country)
             payload.country = country.toLowerCase();
@@ -146,27 +203,30 @@ export class ThordataClient {
             payload.wait = String(wait);
         if (waitFor)
             payload.wait_for = waitFor;
-        if (customHeaders && customHeaders.length > 0)
+        if (customHeaders && customHeaders.length > 0) {
             payload.headers = JSON.stringify(customHeaders);
-        if (cookies && cookies.length > 0)
+        }
+        if (cookies && cookies.length > 0) {
             payload.cookies = JSON.stringify(cookies);
+        }
         Object.assign(payload, extra);
         const headers = buildAuthHeaders(this.scraperToken);
         return this.execute(async () => {
             const res = await this.http.post(this.universalUrl, toFormBody(payload), {
                 headers,
-                responseType: outputFormat.toLowerCase() === "png" ? "arraybuffer" : "json",
+                responseType: format === "png" ? "arraybuffer" : "json",
             });
-            if (outputFormat.toLowerCase() === "png") {
+            if (format === "png") {
                 return Buffer.from(res.data);
             }
             const data = safeParseJson(res.data);
-            if (data && typeof data === "object" && "code" in data && data.code !== 200) {
-                raiseForCode("Universal API error", data, res.status);
-            }
-            if (outputFormat.toLowerCase() === "json") {
-                return data;
+            if (data && typeof data === "object" && "code" in data) {
+                const dataObj = data;
+                if (dataObj.code !== 200) {
+                    raiseForCode("Universal API error", dataObj, res.status);
+                }
             }
+            // Return HTML string
             if (data && typeof data === "object" && "html" in data) {
                 return data.html;
             }
@@ -176,6 +236,9 @@ export class ThordataClient {
     // --------------------------
     // 3) Web Scraper API
     // --------------------------
+    /**
+     * Create a new Web Scraper task.
+     */
     async createScraperTask(options) {
         const { fileName, spiderId, spiderName, parameters, universalParams, includeErrors = true, } = options;
         const payload = {
@@ -205,11 +268,17 @@ export class ThordataClient {
             return String(taskId);
         });
     }
+    /**
+     * Verify that public credentials are available.
+     */
     requirePublicCreds() {
         if (!this.publicToken || !this.publicKey) {
-            throw new ThordataError("publicToken and publicKey are required for Web Scraper public API calls");
+            throw new ThordataConfigError("publicToken and publicKey are required for Web Scraper public API calls");
         }
     }
+    /**
+     * Get the status of a Web Scraper task.
+     */
     async getTaskStatus(taskId) {
         this.requirePublicCreds();
         const headers = buildPublicHeaders(this.publicToken, this.publicKey);
@@ -227,6 +296,9 @@ export class ThordataClient {
             return TaskStatus.UNKNOWN;
         });
     }
+    /**
+     * Get the download URL for a completed task's results.
+     */
     async getTaskResult(taskId, fileType = "json") {
         this.requirePublicCreds();
         const headers = buildPublicHeaders(this.publicToken, this.publicKey);
@@ -234,13 +306,16 @@ export class ThordataClient {
         return this.execute(async () => {
             const res = await this.http.post(this.scraperDownloadUrl, toFormBody(payload), { headers });
             const data = safeParseJson(res.data);
-            if (data?.code === 200 && data?.data?.download) {
-                return data.data.download;
+            const dataObj = data?.data;
+            if (data?.code === 200 && dataObj?.download) {
+                return dataObj.download;
             }
             raiseForCode("Get task result failed", data, res.status);
-            return ""; // unreachable
         });
     }
+    /**
+     * Wait for a task to complete.
+     */
     async waitForTask(taskId, options = {}) {
         const pollIntervalMs = options.pollIntervalMs ?? 5000;
         const maxWaitMs = options.maxWaitMs ?? 10 * 60 * 1000;
@@ -265,22 +340,90 @@ export class ThordataClient {
     // --------------------------
     // 4) Proxy Network
     // --------------------------
+    /**
+     * Make an HTTP request through a proxy.
+     */
     async request(url, config = {}) {
         if (!url) {
-            throw new ThordataError("url is required for request");
+            throw new ThordataConfigError("url is required for request");
         }
+        const { proxy, timeout, ...rest } = config;
         const axiosConfig = {
-            ...config,
-            timeout: config.timeout ?? this.timeoutMs,
-            httpsAgent: new https.Agent({ rejectUnauthorized: false }),
+            ...rest,
+            timeout: timeout ?? this.timeoutMs,
         };
-        if (config.proxy instanceof Proxy) {
-            axiosConfig.proxy = config.proxy.toAxiosConfig();
+        if (proxy instanceof Proxy) {
+            axiosConfig.proxy = proxy.toAxiosConfig();
         }
         return this.execute(async () => {
             const res = await this.http.get(url, axiosConfig);
             return res.data;
         });
     }
+    // --------------------------
+    // 5) Location API
+    // --------------------------
+    /**
+     * Internal method to call locations API.
+     */
+    async getLocations(endpoint, params = {}) {
+        this.requirePublicCreds();
+        const queryParams = new URLSearchParams({
+            token: this.publicToken,
+            key: this.publicKey,
+            ...Object.fromEntries(Object.entries(params).map(([k, v]) => [k, String(v)])),
+        });
+        const url = `${this.baseUrls.locationsBaseUrl}/${endpoint}?${queryParams.toString()}`;
+        return this.execute(async () => {
+            const res = await this.http.get(url);
+            const data = safeParseJson(res.data);
+            if (data?.code === 200 && Array.isArray(data.data)) {
+                return data.data;
+            }
+            if (Array.isArray(data)) {
+                return data;
+            }
+            raiseForCode(`Location API (${endpoint}) failed`, data, res.status);
+        });
+    }
+    /**
+     * List all supported countries for a proxy type.
+     */
+    async listCountries(proxyType = "residential") {
+        return this.getLocations("countries", {
+            proxy_type: normalizeProxyType(proxyType),
+        });
+    }
+    /**
+     * List states/regions for a country.
+     */
+    async listStates(countryCode, proxyType = "residential") {
+        return this.getLocations("states", {
+            proxy_type: normalizeProxyType(proxyType),
+            country_code: countryCode.toUpperCase(),
+        });
+    }
+    /**
+     * List cities for a country (and optionally state).
+     */
+    async listCities(countryCode, stateCode, proxyType = "residential") {
+        const params = {
+            proxy_type: normalizeProxyType(proxyType),
+            country_code: countryCode.toUpperCase(),
+        };
+        if (stateCode) {
+            params.state_code = stateCode.toLowerCase();
+        }
+        return this.getLocations("cities", params);
+    }
+    /**
+     * List ASNs for a country.
+     */
+    async listAsns(countryCode, proxyType = "residential") {
+        return this.getLocations("asn", {
+            proxy_type: normalizeProxyType(proxyType),
+            country_code: countryCode.toUpperCase(),
+        });
+    }
 }
 //# sourceMappingURL=client.js.map