chore(js): improve live examples (tsx scripts, better outputs) and keep CI stable

Author: Thordata

.gitignore

@@ -39,3 +39,4 @@ coverage/
 
 # Lock files (optional, some prefer to commit)
 # package-lock.json
+universal_output.html

.llm_cache/meta.json

@@ -6,9 +6,7 @@
   "max_single_file_bytes": 3000000,
   "ignore_lock_files": true,
   "bundle_count": 1,
-  "bundle_files": [
-    "bundle_0001.txt"
-  ],
+  "bundle_files": ["bundle_0001.txt"],
   "files_included": 65,
   "build_seconds": 0.037
-}
+}

examples/basic_scraper_task.ts

@@ -31,7 +31,19 @@ async function main() {
 
   let parameters: any;
   try {
-    parameters = JSON.parse(parametersJson);
+    const raw = JSON.parse(parametersJson);
+
+    // Dashboard curl uses spider_parameters as an ARRAY string: [{...}]
+    // Accept both "{...}" and "[{...}]". SDK createScraperTask expects ONE parameter object.
+    if (Array.isArray(raw)) {
+      if (raw.length === 0) {
+        console.error("THORDATA_TASK_PARAMETERS_JSON must not be an empty array");
+        process.exit(1);
+      }
+      parameters = raw[0];
+    } else {
+      parameters = raw;
+    }
   } catch {
     console.error("THORDATA_TASK_PARAMETERS_JSON must be valid JSON");
     process.exit(1);

examples/internal/example.ts

@@ -25,4 +25,4 @@ export function printJSON(v: unknown) {
 export function truncate(s: string, n: number) {
   if (n <= 0) return "";
   return s.length <= n ? s : s.slice(0, n) + "...";
-}
+}

examples/locations_basic.ts

@@ -20,4 +20,4 @@ async function main() {
 main().catch((e) => {
   console.error(e);
   process.exit(1);
-});
+});

examples/serp_basic.ts

@@ -25,4 +25,4 @@ async function main() {
 main().catch((e) => {
   console.error(e);
   process.exit(1);
-});
+});

examples/universal_basic.ts

@@ -2,6 +2,7 @@
 
 import { loadEnv, skipIfMissing, truncate } from "./internal/example.js";
 import { ThordataClient } from "../src/index.js";
+import fs from "node:fs";
 
 async function main() {
   loadEnv();
@@ -19,8 +20,11 @@ async function main() {
     js_render: false,
   });
 
-  const s = typeof out === "string" ? out : JSON.stringify(out);
-  console.log("preview:", truncate(s, 300));
+  const html = typeof out === "string" ? out : JSON.stringify(out, null, 2);
+  fs.writeFileSync("universal_output.html", html, "utf8");
+  console.log("saved: universal_output.html");
+  console.log("length:", html.length);
+  console.log("preview:", truncate(html, 300));
 }
 
 main().catch((e) => {

package.json

@@ -25,7 +25,14 @@
     "format:check": "prettier -c .",
     "prepack": "npm run build",
     "prepublishOnly": "npm run format:check && npm run lint && npm test",
-    "example:verify": "npm run build && node dist/examples/verify_new_features.js"
+    "example:verify": "npm run build && node dist/examples/verify_new_features.js",
+    "example:serp": "tsx examples/serp_basic.ts",
+    "example:universal": "tsx examples/universal_basic.ts",
+    "example:task": "tsx examples/basic_scraper_task.ts",
+    "example:proxy:residential": "tsx examples/proxy_residential.ts",
+    "example:proxy:mobile": "tsx examples/proxy_mobile.ts",
+    "example:proxy:datacenter": "tsx examples/proxy_datacenter.ts",
+    "example:proxy:isp": "tsx examples/proxy_isp.ts"
   },
   "keywords": [
     "thordata",