test: add end-to-end tests against a local Supabase stack

.github/workflows/e2e.yml

@@ -0,0 +1,44 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+
+jobs:
+  # Fast, Docker-free checks.
+  unit:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: pnpm/action-setup@v4
+        with:
+          version: 9
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 22
+          cache: pnpm
+      - run: pnpm install --frozen-lockfile
+      - run: pnpm check
+      - run: pnpm typecheck
+      - run: pnpm test
+
+  # End-to-end tests against a real, local Supabase stack.
+  #
+  # The vendored `supabase` CLI (a dev dependency) is installed by `pnpm install`,
+  # and the e2e global setup boots only the containers the adapter needs
+  # (db, kong, rest, realtime; see supabase/config.toml) and stops them afterwards.
+  # Ubuntu runners ship with Docker, so no extra setup is required.
+  e2e:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: pnpm/action-setup@v4
+        with:
+          version: 9
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 22
+          cache: pnpm
+      - run: pnpm install --frozen-lockfile
+      - run: pnpm test:e2e

package.json

@@ -26,7 +26,10 @@
   "scripts": {
     "build": "tsdown",
     "dev": "tsdown --watch",
-    "test": "vitest",
+    "test": "vitest run --project unit",
+    "test:watch": "vitest --project unit",
+    "test:e2e": "vitest run --project e2e",
+    "test:all": "vitest run",
     "typecheck": "tsc --noEmit",
     "prepublishOnly": "pnpm run build",
     "check": "ultracite check",
@@ -44,6 +47,7 @@
     "@biomejs/biome": "2.4.7",
     "@types/node": "^25.0.3",
     "bumpp": "^10.3.2",
+    "supabase": "^2.116.0",
     "tsdown": "^0.18.1",
     "typescript": "^5.9.3",
     "ultracite": "7.3.2",

supabase/.gitignore

@@ -0,0 +1,8 @@
+# Supabase
+.branches
+.temp
+
+# dotenvx
+.env.keys
+.env.local
+.env.*.local