feat: migrate SDK to v2 API

[FrancescoSaverioZuppichini]

Summary

• Complete SDK rewrite for v2 API endpoints
• Add ScrapeGraphAI({ apiKey? }) client factory (reads SGAI_API_KEY from env)
• Add crawl namespace (start, get, stop, resume, delete)
• Add monitor namespace (create, list, get, update, delete, pause, resume)
• Add comprehensive Zod schemas matching API exactly
• Remove generateSchema (no longer in API)
• Rename: getCredits → credits, checkHealth → healthy

Usage

import { ScrapeGraphAI } from "scrapegraph-js";

// reads SGAI_API_KEY from env, or pass explicitly: ScrapeGraphAI({ apiKey: "..." })
const sgai = ScrapeGraphAI();

// scrape - minimal (defaults to markdown)
const { data } = await sgai.scrape({ url: "https://example.com" });

// scrape - multiple formats
const { data } = await sgai.scrape({ 
  url: "https://example.com", 
  formats: [
    { type: "markdown", mode: "reader" },
    { type: "screenshot", fullPage: true },
    { type: "json", prompt: "Extract product info" },
  ],
  fetchConfig: { mode: "js", stealth: true },
});

// extract
const { data } = await sgai.extract({ url: "https://example.com", prompt: "Extract prices" });

// search
const { data } = await sgai.search({ query: "best tools 2024", numResults: 5 });

// crawl
const { data: crawl } = await sgai.crawl.start({ url: "https://example.com", maxPages: 10 });
await sgai.crawl.get(crawl.id);
await sgai.crawl.stop(id);

// monitor
const { data: mon } = await sgai.monitor.create({ url: "...", interval: "0 * * * *", formats: [...] });
await sgai.monitor.pause(mon.cronId);

// utilities
await sgai.credits();
await sgai.healthy();
await sgai.history.list({ service: "scrape", limit: 10 });

Breaking Changes

• All function signatures changed to match v2 API
• Old v1 functions removed (smartScraper, markdownify, searchScraper, sitemap, etc.)
• generateSchema removed
• getCredits → credits, checkHealth → healthy

Test plan

• bun run format - no fixes needed
• bun run lint - passes
• bunx tsc --noEmit - passes
• bun run build - passes
• bun test - 52 unit tests pass
• bun run test:integration - 10 integration tests pass (includes format variations)

🤖 Generated with Claude Code