chore: make turso driver optional, add graceful error handling

Author: os-zhuang

packages/cli/package.json

@@ -48,7 +48,6 @@
     "@objectstack/driver-mongodb": "workspace:^",
     "@objectstack/driver-sql": "workspace:^",
     "@objectstack/driver-sqlite-wasm": "workspace:^",
-    "@objectstack/driver-turso": "workspace:^",
     "@objectstack/objectql": "workspace:^",
     "@objectstack/observability": "workspace:^",
     "@objectstack/plugin-approvals": "workspace:*",
@@ -89,6 +88,9 @@
   "peerDependencies": {
     "@objectstack/core": "workspace:^"
   },
+  "optionalDependencies": {
+    "@objectstack/driver-turso": "workspace:^"
+  },
   "devDependencies": {
     "@oclif/plugin-help": "^6.2.49",
     "@oclif/plugin-plugins": "^5.4.69",

packages/cli/src/commands/serve.ts

@@ -575,7 +575,16 @@ export default class Serve extends Command {
              resolvedDriverLabel = 'SqlDriver(mysql2)';
              resolvedDatabaseUrl = databaseUrl;
            } else if (driverType === 'turso' || driverType === 'libsql') {
-             const { TursoDriver } = await import('@objectstack/driver-turso');
+             let TursoDriver: any;
+             try {
+               ({ TursoDriver } = await import('@objectstack/driver-turso'));
+             } catch (err: any) {
+               throw new Error(
+                 `libsql/turso driver selected but @objectstack/driver-turso is not installed. ` +
+                 `Install it with: npm install @objectstack/driver-turso  (or use a file: URL to default to better-sqlite3). ` +
+                 `(${err?.message ?? err})`
+               );
+             }
              await kernel.use(new DriverPlugin(new TursoDriver({
                url: databaseUrl ?? 'file:./local.db',
                authToken: process.env.OS_DATABASE_AUTH_TOKEN,

packages/runtime/package.json

@@ -23,7 +23,6 @@
     "@objectstack/driver-memory": "workspace:*",
     "@objectstack/driver-sql": "workspace:*",
     "@objectstack/driver-sqlite-wasm": "workspace:*",
-    "@objectstack/driver-turso": "workspace:*",
     "@objectstack/formula": "workspace:*",
     "@objectstack/metadata": "workspace:*",
     "@objectstack/objectql": "workspace:*",
@@ -39,7 +38,8 @@
     "zod": "^4.4.3"
   },
   "optionalDependencies": {
-    "@objectstack/driver-mongodb": "workspace:*"
+    "@objectstack/driver-mongodb": "workspace:*",
+    "@objectstack/driver-turso": "workspace:*"
   },
   "devDependencies": {
     "typescript": "^6.0.3",

packages/runtime/src/cloud/artifact-environment-registry.ts

@@ -242,7 +242,15 @@ async function createDriver(driverType: string, databaseUrl: string, authToken:
         }
         case 'libsql':
         case 'turso': {
-            const { TursoDriver } = await import('@objectstack/driver-turso');
+            let TursoDriver: any;
+            try {
+                ({ TursoDriver } = await import('@objectstack/driver-turso'));
+            } catch (err: any) {
+                throw new Error(
+                    `[ArtifactEnvironmentRegistry] libsql/turso driver requested but @objectstack/driver-turso is not installed. ` +
+                    `Install it with: npm install @objectstack/driver-turso. (${err?.message ?? err})`
+                );
+            }
             return new TursoDriver({ url: databaseUrl, authToken }) as unknown as IDataDriver;
         }
         case 'postgres':

packages/runtime/src/standalone-stack.ts

@@ -127,7 +127,16 @@ export async function createStandaloneStack(config?: StandaloneStackConfig): Pro
         const { InMemoryDriver } = await import('@objectstack/driver-memory');
         driverPlugin = new DriverPlugin(new InMemoryDriver());
     } else if (dbDriver === 'turso') {
-        const { TursoDriver } = await import('@objectstack/driver-turso');
+        let TursoDriver: any;
+        try {
+            ({ TursoDriver } = await import('@objectstack/driver-turso'));
+        } catch (err: any) {
+            throw new Error(
+                `[StandaloneStack] libsql/turso URL detected ("${dbUrl}") but @objectstack/driver-turso is not installed. ` +
+                `Install it with: npm install @objectstack/driver-turso  (or use a file: URL to default to better-sqlite3). ` +
+                `(${err?.message ?? err})`
+            );
+        }
         driverPlugin = new DriverPlugin(
             new TursoDriver({ url: dbUrl, authToken: dbAuthToken }) as any,
         );