refactor(api): split fetch mode into mode + stealth toggle

Align JS SDK with sgai-stack PR #294: remove compound fetch modes
(direct+stealth, js+stealth) and add separate stealth boolean field
to fetchConfig. Modes are now auto|fast|js with stealth as an
independent toggle.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: VinciGit00

src/schemas.ts

@@ -26,7 +26,7 @@ export const apiFetchContentTypeSchema = z.enum([
 	"text/plain",
 	"application/x-latex",
 ]);
-export const apiFetchModeSchema = z.enum(["auto", "fast", "js", "direct+stealth", "js+stealth"]);
+export const apiFetchModeSchema = z.enum(["auto", "fast", "js"]);
 export const apiUserPromptSchema = z.string().min(1).max(10_000);
 
 export const apiUrlSchema = z.url().check(
@@ -52,13 +52,15 @@ export const apiUuidParamSchema = z.object({
 
 export const FETCH_CONFIG_DEFAULTS = {
 	mode: "auto",
+	stealth: false,
 	timeout: 30000,
 	wait: 0,
 	scrolls: 0,
 } as const;
 
 export const apiFetchConfigSchema = z.object({
 	mode: apiFetchModeSchema.default(FETCH_CONFIG_DEFAULTS.mode),
+	stealth: z.boolean().default(FETCH_CONFIG_DEFAULTS.stealth),
 	timeout: z.number().int().min(1000).max(60000).default(FETCH_CONFIG_DEFAULTS.timeout),
 	wait: z.number().int().min(0).max(30000).default(FETCH_CONFIG_DEFAULTS.wait),
 	headers: z.record(z.string(), z.string()).optional(),

tests/client.test.ts

@@ -83,6 +83,25 @@ describe("scrapegraphai", () => {
 		api.stop();
 	});
 
+	test("scrape sends stealth and mode in fetchConfig", async () => {
+		let body: any;
+		const api = mockApi({
+			"/api/v2/scrape": async (req) => {
+				body = await req.json();
+				return Response.json(
+					{ results: { markdown: "# Hello" }, metadata: { url: "https://example.com" } },
+					{ headers: { "x-request-id": "req-stealth" } },
+				);
+			},
+		});
+		const sgai = scrapegraphai({ apiKey: "test", baseUrl: api.url });
+		await sgai.scrape("https://example.com", {
+			fetchConfig: { mode: "fast", stealth: true, country: "us" },
+		});
+		expect(body.fetchConfig).toEqual({ mode: "fast", stealth: true, country: "us" });
+		api.stop();
+	});
+
 	test("extract sends prompt, schema, and fetchConfig", async () => {
 		let body: any;
 		const api = mockApi({