feat(server): Configure Vercel deployment with dual-driver setup (Turso + InMemory)

- Add InMemoryDriver alongside TursoDriver for example apps
- Configure datasource mapping: example apps (crm/todo/bi) → memory, system → turso
- Mark @libsql/client as external in bundle-api.mjs for native binaries
- Add .npmrc with node-linker=hoisted for Vercel compatibility
- Update build-vercel.sh to copy @libsql/client and better-sqlite3 native modules
- Update vercel.json to include native modules in function deployment package
- Make Turso credentials optional (fallback to file-based SQLite for local dev)

Agent-Logs-Url: https://github.com/objectstack-ai/framework/sessions/a39e186a-367a-4f31-b27e-0dcf46dfcb96

Co-authored-by: xuyushun441-sys <255036401+xuyushun441-sys@users.noreply.github.com>

Author: Claude

apps/server/.npmrc

@@ -0,0 +1,3 @@
+# pnpm configuration for Vercel deployment
+# Use hoisted node_modules instead of symlinks to avoid Vercel packaging issues
+node-linker=hoisted

apps/server/scripts/build-vercel.sh

@@ -12,7 +12,8 @@ set -euo pipefail
 # Steps:
 #   1. Build the project with turbo (includes studio)
 #   2. Bundle the API serverless function (→ api/_handler.js)
-#   3. Copy studio dist files to public/ for UI serving
+#   3. Copy native/external modules into local node_modules for Vercel packaging
+#   4. Copy studio dist files to public/ for UI serving
 
 echo "[build-vercel] Starting server build..."
 
@@ -25,7 +26,43 @@ cd apps/server
 # 2. Bundle API serverless function
 node scripts/bundle-api.mjs
 
-# 3. Copy studio dist files to public/ for UI serving
+# 3. Copy native/external modules into local node_modules for Vercel packaging.
+#
+#    This monorepo uses pnpm's default strict node_modules structure. External
+#    dependencies marked in bundle-api.mjs (@libsql/client, better-sqlite3) only
+#    exist in the monorepo root's node_modules/.pnpm/ virtual store.
+#
+#    The vercel.json includeFiles pattern references node_modules/ relative to
+#    apps/server/, so we must copy the actual module files here for Vercel to
+#    include them in the serverless function's deployment package.
+echo "[build-vercel] Copying external native modules to local node_modules..."
+for mod in "@libsql/client" better-sqlite3; do
+  src="../../node_modules/$mod"
+  if [ -e "$src" ]; then
+    dest="node_modules/$mod"
+    mkdir -p "$(dirname "$dest")"
+    cp -rL "$src" "$dest"
+    echo "[build-vercel]   ✓ Copied $mod"
+  else
+    echo "[build-vercel]   ⚠ $mod not found at $src (skipped)"
+  fi
+done
+
+# Copy native binary subdirectories for @libsql/client
+if [ -d "../../node_modules/@libsql" ]; then
+  mkdir -p "node_modules/@libsql"
+  for pkg in ../../node_modules/@libsql/*/; do
+    pkgname="$(basename "$pkg")"
+    if [ "$pkgname" != "client" ]; then  # client already copied above
+      cp -rL "$pkg" "node_modules/@libsql/$pkgname"
+      echo "[build-vercel]   ✓ Copied @libsql/$pkgname"
+    fi
+  done
+else
+  echo "[build-vercel]   ⚠ @libsql not found (skipped)"
+fi
+
+# 4. Copy studio dist files to public/ for UI serving
 echo "[build-vercel] Copying studio dist to public/..."
 rm -rf public
 mkdir -p public

apps/server/scripts/bundle-api.mjs

@@ -14,15 +14,18 @@
 
 import { build } from 'esbuild';
 
-// Packages that cannot be bundled (native bindings / optional drivers)
+// Packages that cannot be bundled (native bindings / platform-specific modules)
 const EXTERNAL = [
+  // @libsql/client has platform-specific native binaries that must be external
+  '@libsql/client',
   // Optional knex database drivers — never used at runtime, but knex requires() them
   'pg',
   'pg-native',
   'pg-query-stream',
   'mysql',
   'mysql2',
   'sqlite3',
+  'better-sqlite3',
   'oracledb',
   'tedious',
   // macOS-only native file watcher

apps/server/server/index.ts

@@ -13,6 +13,7 @@
 import { ObjectKernel, DriverPlugin, AppPlugin } from '@objectstack/runtime';
 import { ObjectQLPlugin } from '@objectstack/objectql';
 import { TursoDriver } from '@objectstack/driver-turso';
+import { InMemoryDriver } from '@objectstack/driver-memory';
 import { createHonoApp } from '@objectstack/hono';
 import { AuthPlugin } from '@objectstack/plugin-auth';
 import { SecurityPlugin } from '@objectstack/plugin-security';
@@ -62,21 +63,40 @@ async function ensureKernel(): Promise<ObjectKernel> {
             // Register ObjectQL engine
             await kernel.use(new ObjectQLPlugin());
 
-            // Database driver - Turso (remote mode for Vercel)
+            // Register Memory Driver for example apps (volatile, fast)
+            await kernel.use(new DriverPlugin(new InMemoryDriver(), { name: 'memory' }));
+
+            // Register Turso Driver for system objects (persistent, production)
             const tursoUrl = process.env.TURSO_DATABASE_URL;
             const tursoToken = process.env.TURSO_AUTH_TOKEN;
 
             if (!tursoUrl || !tursoToken) {
-                throw new Error('Missing required environment variables: TURSO_DATABASE_URL and TURSO_AUTH_TOKEN');
+                console.warn('[Vercel] Turso credentials not found, falling back to file-based SQLite');
             }
 
             const tursoDriver = new TursoDriver({
-                url: tursoUrl,
+                url: tursoUrl ?? 'file:./data/server.db',
                 authToken: tursoToken,
                 // Remote mode - no local sync needed for Vercel
             });
 
-            await kernel.use(new DriverPlugin(tursoDriver));
+            await kernel.use(new DriverPlugin(tursoDriver, { name: 'turso' }));
+
+            // Configure datasource mapping
+            // This must be done before loading apps, so ObjectQL can route objects correctly
+            const ql = kernel.getService('ObjectQL');
+            if (ql && typeof ql.setDatasourceMapping === 'function') {
+                ql.setDatasourceMapping([
+                    // Example apps use in-memory driver for fast, ephemeral data
+                    { namespace: 'crm', datasource: 'memory' },
+                    { namespace: 'todo', datasource: 'memory' },
+                    { namespace: 'bi', datasource: 'memory' },
+                    // System objects use Turso for persistent, production-grade storage
+                    { namespace: 'sys', datasource: 'turso' },
+                    // Default fallback to memory driver
+                    { default: true, datasource: 'memory' },
+                ]);
+            }
 
             // Load app manifests (BEFORE plugins that need object schemas)
             await kernel.use(new AppPlugin(CrmApp));

apps/server/vercel.json

@@ -12,7 +12,11 @@
   "functions": {
     "api/**/*.js": {
       "memory": 1024,
-      "maxDuration": 60
+      "maxDuration": 60,
+      "includeFiles": [
+        "node_modules/@libsql/**",
+        "node_modules/better-sqlite3/**"
+      ]
     }
   },
   "headers": [