feat: add typed API responses and fix sync/async endpoint classification

Replace ApiResult<unknown> with proper response types for all endpoints.
Only crawl uses polling now — all other endpoints are direct POST calls.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: FrancescoSaverioZuppichini

README.md

@@ -11,16 +11,26 @@ Command-line interface for [ScrapeGraph AI](https://scrapegraphai.com) — AI-po
 
 ```
 just-scrape/
+├── docs/                            # API response docs per endpoint
+│   ├── smartscraper.md
+│   ├── searchscraper.md
+│   ├── markdownify.md
+│   ├── crawl.md
+│   ├── scrape.md
+│   ├── agenticscraper.md
+│   ├── generate-schema.md
+│   ├── sitemap.md
+│   └── credits.md
 ├── src/
 │   ├── cli.ts                       # Entry point, citty main command + subcommands
 │   ├── lib/
 │   │   ├── env.ts                   # Zod-parsed env config (API key, debug, timeout)
 │   │   ├── folders.ts               # API key resolution + interactive prompt
-│   │   ├── scrapegraphai.ts         # SDK layer — all API functions
+│   │   ├── scrapegraphai.ts         # SDK layer — all API functions (typed responses)
 │   │   ├── schemas.ts               # Zod validation schemas
 │   │   └── log.ts                   # Logger factory + syntax-highlighted JSON output
 │   ├── types/
-│   │   └── index.ts                 # Zod-derived types + ApiResult
+│   │   └── index.ts                 # Zod-derived types + ApiResult + response types
 │   ├── commands/
 │   │   ├── smart-scraper.ts
 │   │   ├── search-scraper.ts

src/commands/agentic-scraper.ts

@@ -43,7 +43,7 @@ export default defineCommand({
 		if (args["use-session"]) params.use_session = true;
 
 		out.start("Running browser automation");
-		const result = await scrapegraphai.agenticScraper(key, params, out.poll);
+		const result = await scrapegraphai.agenticScraper(key, params);
 		out.stop(result.elapsedMs);
 
 		if (result.data) out.result(result.data);

src/commands/generate-schema.ts

@@ -28,7 +28,7 @@ export default defineCommand({
 		if (args["existing-schema"]) params.existing_schema = JSON.parse(args["existing-schema"]);
 
 		out.start("Generating schema");
-		const result = await scrapegraphai.generateSchema(key, params, out.poll);
+		const result = await scrapegraphai.generateSchema(key, params);
 		out.stop(result.elapsedMs);
 
 		if (result.data) out.result(result.data);

src/commands/markdownify.ts

@@ -31,7 +31,7 @@ export default defineCommand({
 		if (args.headers) params.headers = JSON.parse(args.headers);
 
 		out.start("Converting to markdown");
-		const result = await scrapegraphai.markdownify(key, params, out.poll);
+		const result = await scrapegraphai.markdownify(key, params);
 		out.stop(result.elapsedMs);
 
 		if (result.data) out.result(result.data);

src/commands/scrape.ts

@@ -31,7 +31,7 @@ export default defineCommand({
 		if (args["country-code"]) params.country_code = args["country-code"];
 
 		out.start("Scraping");
-		const result = await scrapegraphai.scrape(key, params, out.poll);
+		const result = await scrapegraphai.scrape(key, params);
 		out.stop(result.elapsedMs);
 
 		if (result.data) out.result(result.data);

src/commands/search-scraper.ts

@@ -43,7 +43,7 @@ export default defineCommand({
 		if (args.headers) params.headers = JSON.parse(args.headers);
 
 		out.start("Searching");
-		const result = await scrapegraphai.searchScraper(key, params, out.poll);
+		const result = await scrapegraphai.searchScraper(key, params);
 		out.stop(result.elapsedMs);
 
 		if (result.data) out.result(result.data);

src/commands/smart-scraper.ts

@@ -48,7 +48,7 @@ export default defineCommand({
 		if (args["plain-text"]) params.plain_text = true;
 
 		out.start("Scraping");
-		const result = await scrapegraphai.smartScraper(key, params, out.poll);
+		const result = await scrapegraphai.smartScraper(key, params);
 		out.stop(result.elapsedMs);
 
 		if (result.data) out.result(result.data);