Merge pull request #1132 from objectstack-ai/claude/fix-driver-turso-requirement

fix(driver-turso): make better-sqlite3 optional peer dependency for Vercel compatibility

Author: xuyushun441-sys

packages/plugins/driver-turso/README.md

@@ -38,6 +38,29 @@ TursoDriver extends SqlDriver (dual transport)
 pnpm add @objectstack/driver-turso
 ```
 
+### Dependencies by Mode
+
+The `driver-turso` package has different dependency requirements based on the connection mode:
+
+| Mode | Required Dependencies | Notes |
+|:---|:---|:---|
+| **Remote** | `@libsql/client` only | ✅ Vercel/Edge compatible — no native dependencies |
+| **Local** | `@libsql/client` + `better-sqlite3` | Requires `better-sqlite3` for local SQLite access |
+| **Replica** | `@libsql/client` + `better-sqlite3` | Requires `better-sqlite3` for local SQLite + sync |
+
+**For Vercel/Edge deployments (remote mode only):**
+```bash
+pnpm add @objectstack/driver-turso
+# better-sqlite3 is NOT required
+```
+
+**For local/replica modes:**
+```bash
+pnpm add @objectstack/driver-turso better-sqlite3
+```
+
+The `better-sqlite3` package is an **optional peer dependency**. If you're only using remote mode (e.g., on Vercel), you don't need to install it. npm/pnpm will show a warning that can be safely ignored.
+
 ## Connection Modes
 
 ### Local File (Embedded SQLite)

packages/plugins/driver-turso/package.json

@@ -33,11 +33,19 @@
     "@objectstack/core": "workspace:*",
     "@objectstack/driver-sql": "workspace:*",
     "@objectstack/spec": "workspace:*",
-    "better-sqlite3": "^12.9.0",
     "nanoid": "^5.1.7"
   },
+  "peerDependencies": {
+    "better-sqlite3": "^12.9.0"
+  },
+  "peerDependenciesMeta": {
+    "better-sqlite3": {
+      "optional": true
+    }
+  },
   "devDependencies": {
     "@types/node": "^25.6.0",
+    "better-sqlite3": "^12.9.0",
     "typescript": "^6.0.2",
     "vitest": "^4.1.4"
   }