postgres connect update

Author: AlexBlokh

src/content/documentation/docs/connect-neon.mdx

@@ -37,26 +37,26 @@ drizzle-orm @neondatabase/serverless
 #### Step 2 - Initialize the driver and make a query
 <CodeTabs items={["Neon HTTP", "Neon Websockets", "node-postgres", "postgres.js"]}>
 ```typescript
-import { drizzle } from 'drizzle-orm/connect';
+import { drizzle } from 'drizzle-orm/neon-http';
 
-const db = await drizzle("neon-http", process.env.DATABASE_URL);
+const db = drizzle(process.env.DATABASE_URL);
 
 const result = await db.execute('select 1');
 ```
 <Section> 
 ```typescript 
-import { drizzle } from 'drizzle-orm/connect';
+import { drizzle } from 'drizzle-orm/neon-serverless';
 
-const db = await drizzle("neon-websockets", process.env.DATABASE_URL);
+const db = drizzle(process.env.DATABASE_URL);
 
 const result = await db.execute('select 1');
 ```
 ```typescript
 // For Node.js - make sure to install the 'ws' and 'bufferutil' packages
-import { drizzle } from 'drizzle-orm/connect';
+import { drizzle } from 'drizzle-orm/neon-serverless';
 import ws from 'ws';
 
-const db = await drizzle("neon-websockets", {
+const db = drizzle({
   connection: process.env.DATABASE_URL,
   ws: ws,
 });
@@ -70,32 +70,31 @@ Add the `ws` and `bufferutil` packages to your project's dependencies, and set `
 </Section> 
 ```typescript 
 // Make sure to install the 'pg' package 
-import { drizzle } from 'drizzle-orm/connect';
+import { drizzle } from 'drizzle-orm/node-postgres';
 
-const db = await drizzle("node-postgres", process.env.DATABASE_URL);
+const db = drizzle(process.env.DATABASE_URL);
 
 const result = await db.execute('select 1');
 ```
 ```typescript
 // Make sure to install the 'postgres' package
-import { drizzle } from 'drizzle-orm/connect';
+import { drizzle } from 'drizzle-orm/postgres-js';
 
-const db = await drizzle("postgres-js", process.env.DATABASE_URL);
+const db = drizzle(process.env.DATABASE_URL);
 
 const result = await db.execute('select 1');
 ```
 </CodeTabs>
 
-If you need a synchronous connection, you can use our additional connection API, 
-where you specify a driver connection and pass it to the Drizzle instance.
+If you need to provide your existing drivers:
 
 <CodeTabs items={["Neon HTTP", "Neon Websockets", "node-postgres", "postgres.js"]}>
 ```typescript
 import { neon } from '@neondatabase/serverless';
 import { drizzle } from 'drizzle-orm/neon-http';
 
 const sql = neon(process.env.DATABASE_URL!);
-const db = drizzle(sql);
+const db = drizzle({ client: sql });
 
 const result = await db.execute('select 1');
 ```
@@ -105,7 +104,7 @@ import { Pool } from '@neondatabase/serverless';
 import { drizzle } from 'drizzle-orm/neon-serverless';
 
 const pool = new Pool({ connectionString: process.env.DATABASE_URL });
-const db = drizzle(pool)
+const db = drizzle({ client: pool })
 
 const result = await db.execute('select 1');
 ```
@@ -117,7 +116,7 @@ import { drizzle } from 'drizzle-orm/neon-serverless';
 neonConfig.webSocketConstructor = ws;
 
 const pool = new Pool({ connectionString: process.env.DATABASE_URL });
-const db = drizzle(pool)
+const db = drizzle({ client: pool })
 
 const result = await db.execute('select 1');
 ```
@@ -135,7 +134,7 @@ import { Pool } from "pg";
 const pool = new Pool({
   connectionString: process.env.DATABASE_URL,
 });
-const db = drizzle(pool);
+const db = drizzle({ client: pool });
 
 const result = await db.execute('select 1');
 ```
@@ -145,7 +144,7 @@ import { drizzle } from 'drizzle-orm/postgres-js';
 import postgres from 'postgres';
 
 const queryClient = postgres(process.env.DATABASE_URL);
-const db = drizzle(queryClient);
+const db = drizzle({ client: queryClient });
 
 const result = await db.execute('select 1');
 ```

src/content/documentation/docs/connect-pglite.mdx

@@ -32,39 +32,38 @@ drizzle-orm @electric-sql/pglite
 #### Step 2 - Initialize the driver and make a query
 <CodeTabs items={["In-Memory", "In directory", "With extra config options"]}>
 ```typescript copy"
-import { drizzle } from 'drizzle-orm/connect';
+import { drizzle } from 'drizzle-orm/pglite';
 
-const db = drizzle('pglite');
+const db = drizzle();
 
 await db.select().from(...);
 ```
 ```typescript copy"
-import { drizzle } from 'drizzle-orm/connect';
+import { drizzle } from 'drizzle-orm/pglite';
 
-const db = drizzle('pglite', 'path-to-dir');
+const db = drizzle('path-to-dir');
 
 await db.select().from(...);
 ```
 ```typescript copy"
-import { drizzle } from 'drizzle-orm/connect';
+import { drizzle } from 'drizzle-orm/pglite';
 
 // connection is a native PGLite configuration
-const db = drizzle('pglite', { connection: { dataDir: 'path-to-dir' }});
+const db = drizzle({ connection: { dataDir: 'path-to-dir' }});
 
 await db.select().from(...);
 ```
 </CodeTabs>
 
-If you need a synchronous connection, you can use our additional connection API, 
-where you specify a driver connection and pass it to the Drizzle instance.
+If you need to provide your existing driver:
 
 ```typescript copy"
 import { PGlite } from '@electric-sql/pglite';
 import { drizzle } from 'drizzle-orm/pglite';
 
 // In-memory Postgres
 const client = new PGlite();
-const db = drizzle(client);
+const db = drizzle({ client });
 
 await db.select().from(users);
 ```

src/content/documentation/docs/connect-supabase.mdx

@@ -28,21 +28,20 @@ drizzle-orm postgres
 #### Step 2 - Initialize the driver and make a query
 
 ```typescript copy filename="index.ts"
-import { drizzle } from 'drizzle-orm'
+import { drizzle } from 'drizzle-orm/postgres-js'
 
-const db = drizzle('postgres-js', process.env.DATABASE_URL);
+const db = drizzle(process.env.DATABASE_URL);
 
 const allUsers = await db.select().from(...);
 ```
-If you need a synchronous connection, you can use our additional connection API, 
-where you specify a driver connection and pass it to the Drizzle instance.
 
+If you need to provide your existing driver:
 ```typescript copy filename="index.ts"
 import { drizzle } from 'drizzle-orm/postgres-js'
 import postgres from 'postgres'
 
 const client = postgres(process.env.DATABASE_URL)
-const db = drizzle(client);
+const db = drizzle({ client });
 
 const allUsers = await db.select().from(...);
 ```
@@ -55,7 +54,7 @@ import postgres from 'postgres'
 
 // Disable prefetch as it is not supported for "Transaction" pool mode 
 const client = postgres(process.env.DATABASE_URL, { prepare: false })
-const db = drizzle(client);
+const db = drizzle({ client });
 
 const allUsers = await db.select().from(...);
 ```

src/content/documentation/docs/connect-tidb.mdx

@@ -35,7 +35,7 @@ drizzle-orm @tidbcloud/serverless
 ```typescript copy filename="index.ts"
 import { drizzle } from 'drizzle-orm/tidb-serverless';
 
-const db = await drizzle({ connection: { url: process.env.TIDB_URL }});
+const db = drizzle({ connection: { url: process.env.TIDB_URL }});
 
 const response = await db.select().from(...)
 ```

src/content/documentation/docs/connect-vercel-postgres.mdx

@@ -39,15 +39,14 @@ Setup a project according to the **[official docs.](https://vercel.com/docs/stor
 #### Step 3 - Initialize the driver and make a query
 
 ```typescript copy
-import { drizzle } from 'drizzle-orm/connect';
+import { drizzle } from 'drizzle-orm/vercel-postgres';
 
-const db = await drizzle("vercel-postgres");
+const db = drizzle();
 
 const result = await db.execute('select 1');
 ```
 
-If you need a synchronous connection, you can use our additional connection API, 
-where you specify a driver connection and pass it to the Drizzle instance.
+If you need to provide your existing driver:
 
 ```typescript copy
 import { sql } from '@vercel/postgres';

src/content/documentation/docs/get-started-postgresql.mdx

@@ -35,18 +35,18 @@ drizzle-orm pg
 <CodeTabs items={["node-postgres", "node-postgres with config"]}>
 ```typescript copy
 // Make sure to install the 'pg' package 
-import { drizzle } from 'drizzle-orm/connect';
+import { drizzle } from 'drizzle-orm/node-postgres';
 
-const db = await drizzle("node-postgres", process.env.DATABASE_URL);
+const db = drizzle(process.env.DATABASE_URL);
 
 const result = await db.execute('select 1');
 ```
 ```typescript copy
 // Make sure to install the 'pg' package 
-import { drizzle } from 'drizzle-orm/connect';
+import { drizzle } from 'drizzle-orm/node-postgres';
 
 // You can specify any property from the node-postgres connection options
-const db = await drizzle("node-postgres", { 
+const db = drizzle({ 
   connection: { 
     connectionString: process.env.DATABASE_URL,
     ssl: true
@@ -57,8 +57,7 @@ const result = await db.execute('select 1');
 ```
 </CodeTabs>
 
-If you need a synchronous connection, you can use our additional connection API, 
-where you specify a driver connection and pass it to the Drizzle instance.
+If you need to provide your existing driver:
 
 ```typescript copy
 // Make sure to install the 'pg' package 
@@ -69,7 +68,7 @@ import { Pool } from "pg";
 const pool = new Pool({
   connectionString: process.env.DATABASE_URL,
 });
-const db = drizzle(pool);
+const db = drizzle({ client: pool });
 
 const result = await db.execute('select 1');
 ```
@@ -84,17 +83,17 @@ drizzle-orm postgres
 #### Step 2 - Initialize the driver and make a query
 <CodeTabs items={["postgres.js", "postgres.js with config"]}>
 ```typescript copy
-import { drizzle } from 'drizzle-orm/connect';
+import { drizzle } from 'drizzle-orm/postgres-js';
 
-const db = await drizzle("postgres-js", process.env.DATABASE_URL);
+const db = drizzle(process.env.DATABASE_URL);
 
 const result = await db.execute('select 1');
 ```
 ```typescript copy
-import { drizzle } from 'drizzle-orm/connect';
+import { drizzle } from 'drizzle-orm/postgres-js';
 
 // You can specify any property from the postgres-js connection options
-const db = await drizzle("postgres-js", { 
+const db = drizzle({ 
   connection: { 
     url: process.env.DATABASE_URL, 
     ssl: true 
@@ -105,16 +104,15 @@ const result = await db.execute('select 1');
 ```
 </CodeTabs>
 
-If you need a synchronous connection, you can use our additional connection API, 
-where you specify a driver connection and pass it to the Drizzle instance.
+If you need to provide your existing driver:
 
 ```typescript copy
 // Make sure to install the 'postgres' package
 import { drizzle } from 'drizzle-orm/postgres-js';
 import postgres from 'postgres';
 
 const queryClient = postgres(process.env.DATABASE_URL);
-const db = drizzle(queryClient);
+const db = drizzle({ client: queryClient });
 
 const result = await db.execute('select 1');
 ```