feat: add SDK tests and CI workflow

30 tests covering all scrapegraphai.ts functions — mocked fetch, polling,
HTTP error mapping, validation, timeouts. GitHub Actions runs tests + lint
on PRs to main.

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

Author: FrancescoSaverioZuppichini

.github/workflows/ci.yml

@@ -0,0 +1,26 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  test:
+    name: Test
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: oven-sh/setup-bun@v2
+      - run: bun install
+      - run: bun test
+
+  lint:
+    name: Lint & Typecheck
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: oven-sh/setup-bun@v2
+      - run: bun install
+      - run: bun run check

README.md

@@ -17,6 +17,7 @@ Command-line interface for [ScrapeGraph AI](https://scrapegraphai.com) — AI-po
 | Validation | **zod** v4 |
 | Env | **dotenv** |
 | Lint / Format | **Biome** |
+| Testing | **Bun test** (built-in) |
 | Target | **Node.js 22+**, ESM-only |
 
 ## Setup
@@ -193,6 +194,16 @@ scrapegraphai credits
 scrapegraphai validate
 ```
 
+## Testing
+
+Tests use Bun's built-in test runner with `spyOn(globalThis, "fetch")` to mock all API calls — no network requests, no API key needed.
+
+```bash
+bun test
+```
+
+Covers all SDK functions: success paths, polling, HTTP error mapping (401/402/422/429/500), Zod validation, timeouts, and network failures.
+
 ## Project Structure
 
 ```
@@ -220,6 +231,8 @@ scrapegraph-cli/
 │   │   └── validate.ts
 │   └── utils/
 │       └── banner.ts               # ASCII banner + version from package.json
+├── tests/
+│   └── scrapegraphai.test.ts      # SDK layer tests (mocked fetch)
 ├── dist/                            # Build output (git-ignored)
 │   └── cli.mjs                     # Bundled ESM with shebang
 ├── package.json

biome.json

@@ -14,6 +14,18 @@
 			"recommended": true
 		}
 	},
+	"overrides": [
+		{
+			"include": ["tests/**"],
+			"linter": {
+				"rules": {
+					"suspicious": {
+						"noExplicitAny": "off"
+					}
+				}
+			}
+		}
+	],
 	"files": {
 		"ignore": ["node_modules", "dist", "bun.lock"]
 	}

package.json

@@ -32,6 +32,7 @@
 	},
 	"devDependencies": {
 		"@biomejs/biome": "^1.9.4",
+		"@types/bun": "^1.3.9",
 		"@types/node": "^22.13.1",
 		"tsup": "^8.3.6",
 		"typescript": "^5.8.2"