fix(drivers): resolve warehouse SDKs from disk instead of reporting them missing

packages/drivers/src/bigquery.ts

@@ -3,16 +3,11 @@
  */
 
 import type { ConnectionConfig, Connector, ConnectorResult, ExecuteOptions, SchemaColumn } from "./types"
+import { loadOptionalDriver } from "./resolve"
 
 export async function connect(config: ConnectionConfig): Promise<Connector> {
   let BigQueryModule: any
-  try {
-    BigQueryModule = await import("@google-cloud/bigquery")
-  } catch {
-    throw new Error(
-      "BigQuery driver not installed. Run: npm install @google-cloud/bigquery",
-    )
-  }
+  BigQueryModule = await loadOptionalDriver("bigquery", "@google-cloud/bigquery")
 
   const BigQuery = BigQueryModule.BigQuery ?? BigQueryModule.default?.BigQuery
   let client: any

packages/drivers/src/clickhouse.ts

@@ -6,17 +6,14 @@
  */
 
 import type { ConnectionConfig, Connector, ConnectorResult, ExecuteOptions, SchemaColumn } from "./types"
+import { loadOptionalDriver } from "./resolve"
 
 export async function connect(config: ConnectionConfig): Promise<Connector> {
   let createClient: any
-  try {
-    const mod = await import("@clickhouse/client")
-    createClient = mod.createClient ?? mod.default?.createClient
-    if (!createClient) {
-      throw new Error("createClient export not found in @clickhouse/client")
-    }
-  } catch {
-    throw new Error("ClickHouse driver not installed. Run: npm install @clickhouse/client")
+  const clickhouseModule = await loadOptionalDriver("clickhouse", "@clickhouse/client")
+  createClient = clickhouseModule.createClient ?? clickhouseModule.default?.createClient
+  if (!createClient) {
+    throw new Error("createClient export not found in @clickhouse/client — check the installed package version")
   }
 
   let client: any

packages/drivers/src/databricks.ts

@@ -3,17 +3,12 @@
  */
 
 import type { ConnectionConfig, Connector, ConnectorResult, ExecuteOptions, SchemaColumn } from "./types"
+import { loadOptionalDriver } from "./resolve"
 
 export async function connect(config: ConnectionConfig): Promise<Connector> {
   let databricksModule: any
-  try {
-    databricksModule = await import("@databricks/sql")
-    databricksModule = databricksModule.default || databricksModule
-  } catch {
-    throw new Error(
-      "Databricks driver not installed. Run: npm install @databricks/sql",
-    )
-  }
+  databricksModule = await loadOptionalDriver("databricks", "@databricks/sql")
+  databricksModule = databricksModule.default || databricksModule
 
   let client: any
   let session: any

packages/drivers/src/duckdb.ts

@@ -3,15 +3,12 @@
  */
 
 import type { ConnectionConfig, Connector, ConnectorResult, ExecuteOptions, SchemaColumn } from "./types"
+import { loadOptionalDriver } from "./resolve"
 
 export async function connect(config: ConnectionConfig): Promise<Connector> {
   let duckdb: any
-  try {
-    duckdb = await import("duckdb")
-    duckdb = duckdb.default || duckdb
-  } catch {
-    throw new Error("DuckDB driver not installed. Run: npm install duckdb")
-  }
+  duckdb = await loadOptionalDriver("duckdb", "duckdb")
+  duckdb = duckdb.default || duckdb
 
   const dbPath = (config.path as string) ?? ":memory:"
   let db: any

packages/drivers/src/mongodb.ts

@@ -15,6 +15,7 @@
  */
 
 import type { ConnectionConfig, Connector, ConnectorResult, SchemaColumn } from "./types"
+import { loadOptionalDriver } from "./resolve"
 
 /** Supported MQL commands. */
 type MqlCommand =
@@ -130,12 +131,8 @@ function extractFields(docs: Record<string, unknown>[]): Map<string, Set<string>
 
 export async function connect(config: ConnectionConfig): Promise<Connector> {
   let mongoModule: any
-  try {
-    mongoModule = await import("mongodb")
-    mongoModule = mongoModule.default || mongoModule
-  } catch {
-    throw new Error("MongoDB driver not installed. Run: npm install mongodb")
-  }
+  mongoModule = await loadOptionalDriver("mongodb", "mongodb")
+  mongoModule = mongoModule.default || mongoModule
 
   const MongoClient = mongoModule.MongoClient
 

packages/drivers/src/mysql.ts

@@ -3,15 +3,12 @@
  */
 
 import type { ConnectionConfig, Connector, ConnectorResult, ExecuteOptions, SchemaColumn } from "./types"
+import { loadOptionalDriver } from "./resolve"
 
 export async function connect(config: ConnectionConfig): Promise<Connector> {
   let mysql: any
-  try {
-    mysql = await import("mysql2/promise")
-    mysql = mysql.default || mysql
-  } catch {
-    throw new Error("MySQL driver not installed. Run: npm install mysql2")
-  }
+  mysql = await loadOptionalDriver("mysql", "mysql2/promise")
+  mysql = mysql.default || mysql
 
   let pool: any
 

packages/drivers/src/oracle.ts

@@ -3,18 +3,12 @@
  */
 
 import type { ConnectionConfig, Connector, ConnectorResult, ExecuteOptions, SchemaColumn } from "./types"
+import { loadOptionalDriver } from "./resolve"
 
 export async function connect(config: ConnectionConfig): Promise<Connector> {
   let oracledb: any
-  try {
-    // @ts-expect-error — optional dependency, loaded at runtime
-    oracledb = await import("oracledb")
-    oracledb = oracledb.default || oracledb
-  } catch {
-    throw new Error(
-      "Oracle driver not installed. Run: npm install oracledb",
-    )
-  }
+  oracledb = await loadOptionalDriver("oracle", "oracledb")
+  oracledb = oracledb.default || oracledb
 
   // Use thin mode (pure JS, no Oracle client needed)
   oracledb.initOracleClient = undefined

packages/drivers/src/postgres.ts

@@ -3,14 +3,11 @@
  */
 
 import type { ConnectionConfig, Connector, ConnectorResult, ExecuteOptions, SchemaColumn } from "./types"
+import { loadOptionalDriver } from "./resolve"
 
 export async function connect(config: ConnectionConfig): Promise<Connector> {
   let pg: any
-  try {
-    pg = await import("pg")
-  } catch {
-    throw new Error("PostgreSQL driver not installed. Run: npm install pg @types/pg")
-  }
+  pg = await loadOptionalDriver("postgres", "pg")
 
   const Pool = pg.default?.Pool ?? pg.Pool
   let pool: any

packages/drivers/src/redshift.ts

@@ -4,16 +4,11 @@
  */
 
 import type { ConnectionConfig, Connector, ConnectorResult, ExecuteOptions, SchemaColumn } from "./types"
+import { loadOptionalDriver } from "./resolve"
 
 export async function connect(config: ConnectionConfig): Promise<Connector> {
   let pg: any
-  try {
-    pg = await import("pg")
-  } catch {
-    throw new Error(
-      "Redshift driver not installed (uses pg). Run: npm install pg @types/pg",
-    )
-  }
+  pg = await loadOptionalDriver("redshift", "pg")
 
   const Pool = pg.default?.Pool ?? pg.Pool
   let pool: any