fix(db): default explicit libsql driver to local SQLite in dev (#948)

Author: atinux

src/db/lib/client.ts

@@ -31,7 +31,8 @@ async function createD1HttpClient(accountId: string, databaseId: string, apiToke
  * Creates a Drizzle client for the given configuration
  */
 export async function createDrizzleClient(config: ResolvedDatabaseConfig, hubDir: string) {
-  const { driver, connection, casing } = config
+  const { driver, casing } = config
+  let { connection } = config
   let pkg = ''
   if (driver === 'd1' || driver === 'd1-http') {
     // Get credentials from config or env vars
@@ -55,6 +56,13 @@ export async function createDrizzleClient(config: ResolvedDatabaseConfig, hubDir
     return drizzle(sql, { casing })
   } else if (driver === 'libsql') {
     pkg = 'drizzle-orm/libsql'
+    // Resolve from env like the runtime `hub:db` template when no URL is set (Docker/K8s)
+    if (!connection?.url) {
+      connection = {
+        url: process.env.TURSO_DATABASE_URL || process.env.LIBSQL_URL || process.env.DATABASE_URL,
+        authToken: process.env.TURSO_AUTH_TOKEN || process.env.LIBSQL_AUTH_TOKEN
+      }
+    }
   } else if (driver === 'mysql2') {
     pkg = 'drizzle-orm/mysql2'
   } else if (driver === 'pglite') {

src/db/setup.ts

@@ -86,7 +86,9 @@ export async function resolveDatabaseConfig(nuxt: Nuxt, hub: HubConfig): Promise
         break
       }
       // User explicitly set libsql (e.g. Turso with inline config)
-      if (userExplicitLibsql) {
+      // Without a URL, resolve it from env at runtime (Docker/K8s), except in dev/prepare where we fall back to local SQLite
+      const libsqlEnvUrl = process.env.TURSO_DATABASE_URL || process.env.LIBSQL_URL || process.env.DATABASE_URL
+      if (userExplicitLibsql && (config.connection?.url || libsqlEnvUrl || (!nuxt.options.dev && !nuxt.options._prepare))) {
         config.connection = defu(config.connection, { url: '' })
         break
       }

test/database.config.test.ts

@@ -171,6 +171,40 @@ describe('resolveDatabaseConfig', () => {
         applyMigrationsDuringBuild: false
       })
     })
+
+    it('should default explicit libsql to local SQLite in dev and prepare without env vars', async () => {
+      delete process.env.TURSO_DATABASE_URL
+      delete process.env.LIBSQL_URL
+      delete process.env.DATABASE_URL
+
+      for (const option of ['dev', '_prepare']) {
+        const nuxt = createMockNuxt()
+        nuxt.options[option] = true
+        const hub = createBaseHubConfig({ dialect: 'sqlite', driver: 'libsql' })
+
+        const result = await resolveDatabaseConfig(nuxt, hub)
+
+        expect(result).toMatchObject({
+          driver: 'libsql',
+          connection: { url: 'file:/tmp/test-hub/db/sqlite.db' }
+        })
+      }
+    })
+
+    it('should keep lazy resolution for explicit libsql in dev when env URL is set', async () => {
+      process.env.LIBSQL_URL = 'libsql://my-db.example.com'
+
+      const nuxt = createMockNuxt()
+      nuxt.options.dev = true
+      const hub = createBaseHubConfig({ dialect: 'sqlite', driver: 'libsql' })
+
+      const result = await resolveDatabaseConfig(nuxt, hub)
+
+      expect(result).toMatchObject({
+        driver: 'libsql',
+        connection: { url: '' }
+      })
+    })
   })
 
   describe('PostgreSQL dialect', () => {