feat: enable Turso/libSQL driver for pnpm dev via TURSO_DATABASE_URL env var

Co-authored-by: hotlong <50353452+hotlong@users.noreply.github.com>

Author: Copilot

.env.example

@@ -0,0 +1,17 @@
+# ─── Auth ──────────────────────────────────────────────────────────────────
+AUTH_SECRET=objectql-dev-secret-change-me-in-production
+
+# ─── Turso / libSQL Driver ────────────────────────────────────────────────
+# Uncomment and set these to use Turso driver instead of MemoryDriver.
+#
+# Connection modes:
+#   Remote (Cloud):          TURSO_DATABASE_URL=libsql://my-db-orgname.turso.io
+#   Local (Embedded file):   TURSO_DATABASE_URL=file:./data/local.db
+#   In-memory:               TURSO_DATABASE_URL=:memory:
+#
+# TURSO_DATABASE_URL=file:./data/local.db
+# TURSO_AUTH_TOKEN=
+#
+# Embedded Replica (Hybrid) — sync a local file with a remote primary:
+# TURSO_SYNC_URL=libsql://my-db-orgname.turso.io
+# TURSO_SYNC_INTERVAL=60

ROADMAP.md

@@ -89,6 +89,7 @@ ObjectQL is the **Standard Protocol for AI Software Generation** — a universal
 - ✅ `@objectql/driver-turso` — Turso/libSQL driver (Phase A: Core Driver) with 125 tests, 3 connection modes (remote, local, embedded replica)
 - ✅ `@objectql/driver-turso` — Phase B: Multi-Tenant Router, Schema Diff Engine, Platform API Client, Driver Plugin (52 new tests, 177 total)
 - ✅ Fix test quality: replaced all `expect(true).toBe(true)` placeholder assertions with meaningful state checks across `plugin-optimizations`, `protocol-odata-v4`, `protocol-json-rpc`, and `protocol-graphql` (7 files, 10 assertions fixed)
+- ✅ `pnpm dev` supports Turso/libSQL driver via `TURSO_DATABASE_URL` env var (local embedded, remote cloud, or embedded replica modes)
 
 ---
 

objectstack.config.ts

@@ -31,6 +31,7 @@ import { ValidatorPlugin } from '@objectql/plugin-validator';
 import { FormulaPlugin } from '@objectql/plugin-formula';
 import { createApiRegistryPlugin } from '@objectstack/core';
 import { MemoryDriver } from '@objectql/driver-memory';
+import { createTursoDriver } from '@objectql/driver-turso';
 import * as fs from 'fs';
 import * as yaml from 'js-yaml';
 
@@ -58,9 +59,32 @@ function loadObjects(dir: string) {
 
 const projectTrackerDir = path.join(__dirname, 'examples/showcase/project-tracker/src');
 
+// Choose driver based on environment — Turso when TURSO_DATABASE_URL is set,
+// MemoryDriver otherwise (zero-config fallback for quick starts).
+function createDefaultDriver() {
+    const tursoUrl = process.env.TURSO_DATABASE_URL;
+    if (tursoUrl) {
+        console.log(`🗄️  Driver: Turso (${tursoUrl})`);
+        const syncUrl = process.env.TURSO_SYNC_URL;
+        return createTursoDriver({
+            url: tursoUrl,
+            authToken: process.env.TURSO_AUTH_TOKEN,
+            syncUrl,
+            sync: syncUrl
+                ? {
+                    intervalSeconds: Number(process.env.TURSO_SYNC_INTERVAL) || 60,
+                    onConnect: true,
+                }
+                : undefined,
+        });
+    }
+    console.log('🗄️  Driver: Memory (in-memory, non-persistent)');
+    return new MemoryDriver();
+}
+
 // Shared driver instance — registered as 'driver.default' service for
 // upstream ObjectQLPlugin discovery and passed to QueryPlugin for query execution.
-const defaultDriver = new MemoryDriver();
+const defaultDriver = createDefaultDriver();
 
 export default {
     metadata: {
@@ -73,14 +97,19 @@ export default {
         createApiRegistryPlugin(),
         new HonoServerPlugin({}),
         new ConsolePlugin(),
-        // Register MemoryDriver as 'driver.default' service so upstream
+        // Register the active driver as 'driver.default' service so upstream
         // ObjectQLPlugin can discover it during start() phase.
         {
-            name: 'driver-memory',
+            name: 'driver-default',
             init: async (ctx: any) => {
                 ctx.registerService('driver.default', defaultDriver);
             },
-            start: async () => {},
+            start: async () => {
+                // Connect Turso driver if applicable (MemoryDriver has no connect method)
+                if ('connect' in defaultDriver && typeof (defaultDriver as { connect: () => Promise<void> }).connect === 'function') {
+                    await (defaultDriver as { connect: () => Promise<void> }).connect();
+                }
+            },
         },
         // Upstream ObjectQLPlugin from @objectstack/objectql:
         // - Registers objectql, metadata, data, protocol services

package.json

@@ -28,6 +28,7 @@
     "@objectql/cli": "workspace:*",
     "@objectql/core": "workspace:*",
     "@objectql/driver-memory": "^4.2.2",
+    "@objectql/driver-turso": "workspace:*",
     "@objectql/example-enterprise-erp": "workspace:*",
     "@objectql/example-project-tracker": "workspace:*",
     "@objectql/plugin-security": "workspace:*",