[Hyperdrive] add drivers and orms docs

src/content/docs/hyperdrive/configuration/connect-to-private-database.mdx

@@ -199,7 +199,7 @@ Validate that you can connect to your database from Workers and make queries.
 
 Use Postgres.js to send a test query to validate that the connection has been successful.
 
-<Render file="use-postgresjs-to-make-query" product="hyperdrive" />
+<Render file="use-postgres-js-to-make-query" product="hyperdrive" />
 
 Now, deploy your Worker:
 

src/content/docs/hyperdrive/examples/connect-to-mysql/index.mdx

@@ -32,19 +32,7 @@ npx wrangler hyperdrive create my-first-hyperdrive --connection-string="mysql://
 
 The command above will output the ID of your Hyperdrive, which you will need to set in the [Wrangler configuration file](/workers/wrangler/configuration/) for your Workers project:
 
-<WranglerConfig>
-
-```toml
-# required for database drivers to function
-compatibility_flags = ["nodejs_compat"]
-compatibility_date = "2024-09-23"
-
-[[hyperdrive]]
-binding = "HYPERDRIVE"
-id = "<your-hyperdrive-id-here>"
-```
-
-</WranglerConfig>
+<Render file="hyperdrive-node-compatibility-requirement" product="hyperdrive" />
 
 This will allow Hyperdrive to generate a dynamic connection string within your Worker that you can pass to your existing database driver. Refer to [Driver examples](#driver-examples) to learn how to set up a database driver with Hyperdrive.
 
@@ -105,57 +93,9 @@ The following Workers code shows you how to use [mysql2](https://github.com/sido
 
 ### `mysql`
 
-Install the `mysql` driver:
+The following Workers code shows you how to use [mysql](https://github.com/mysqljs/mysql) with Hyperdrive.
 
-```sh
-npm install mysql
-```
-
-**Ensure you have `compatibility_flags` and `compatibility_date` set in your [Wrangler configuration file](/workers/wrangler/configuration/)** as shown below:
-
-<Render file="nodejs-compat-wrangler-toml" product="workers" />
-
-Create a new connection and pass the Hyperdrive parameters:
-
-```ts
-import { createConnection } from "mysql";
-
-export interface Env {
-	HYPERDRIVE: Hyperdrive;
-}
-
-export default {
-	async fetch(request, env, ctx): Promise<Response> {
-		const result = await new Promise<any>((resolve) => {
-			const connection = createConnection({
-				host: env.HYPERDRIVE.host,
-				user: env.HYPERDRIVE.user,
-				password: env.HYPERDRIVE.password,
-				database: env.HYPERDRIVE.database,
-				port: env.HYPERDRIVE.port,
-			});
-
-			connection.connect((error: { message: string }) => {
-				if (error) {
-					throw new Error(error.message);
-				}
-
-				connection.query("SHOW tables;", [], (error, rows, fields) => {
-					connection.end();
-
-					resolve({ fields, rows });
-				});
-			});
-		});
-
-		return new Response(JSON.stringify(result), {
-			headers: {
-				"Content-Type": "application/json",
-			},
-		});
-	},
-} satisfies ExportedHandler<Env>;
-```
+<Render file="use-mysql-to-make-query" product="hyperdrive" />
 
 ## Identify connections from Hyperdrive
 

src/content/docs/hyperdrive/examples/connect-to-mysql/aws-rds-aurora.mdx → src/content/docs/hyperdrive/examples/connect-to-mysql/mysql-database-providers/aws-rds-aurora.mdx

@@ -97,3 +97,4 @@ With a database user, password, database endpoint (hostname and port), and datab
 ## 3. Create a database configuration
 
 <Render file="create-hyperdrive-config-mysql" />
+<Render file="create-hyperdrive-config-mysql-next-steps" />

src/content/docs/hyperdrive/examples/connect-to-mysql/azure.mdx → src/content/docs/hyperdrive/examples/connect-to-mysql/mysql-database-providers/azure.mdx

@@ -38,3 +38,4 @@ To connect to a private Azure Database for MySQL instance, refer to [Connect to
 ## 2. Create a database configuration
 
 <Render file="create-hyperdrive-config-mysql" />
+<Render file="create-hyperdrive-config-mysql-next-steps" />

src/content/docs/hyperdrive/examples/connect-to-mysql/google-cloud-sql.mdx → src/content/docs/hyperdrive/examples/connect-to-mysql/mysql-database-providers/google-cloud-sql.mdx

@@ -41,3 +41,4 @@ With the username, password, public IP address and (optional) database name (def
 ## 2. Create a database configuration
 
 <Render file="create-hyperdrive-config-mysql" />
+<Render file="create-hyperdrive-config-mysql-next-steps" />

src/content/docs/hyperdrive/examples/connect-to-mysql/mysql-database-providers/index.mdx

@@ -0,0 +1,14 @@
+---
+type: overview
+pcx_content_type: navigation
+title: Database Providers
+hideChildren: false
+sidebar:
+  order: 5
+  group:
+    hideIndex: true
+---
+
+import { DirectoryListing } from "~/components";
+
+<DirectoryListing />

src/content/docs/hyperdrive/examples/connect-to-mysql/planetscale.mdx → src/content/docs/hyperdrive/examples/connect-to-mysql/mysql-database-providers/planetscale.mdx

@@ -27,3 +27,13 @@ With the host, database name, username and password, you can now create a Hyperd
 ## 2. Create a database configuration
 
 <Render file="create-hyperdrive-config-mysql" />
+
+:::note
+
+When connection to a Planetscale database with Hyperdrive, you should use a driver like [node-postgres (pg)](/hyperdrive/examples/connect-to-postgres/postgres-drivers-and-libraries/node-postgres/) or [Postgres.js](/hyperdrive/examples/connect-to-postgres/postgres-drivers-and-libraries/postgres-js/)
+to connect directly to the underlying database instead of the [Planetscale serverless driver](https://planetscale.com/docs/tutorials/planetscale-serverless-driver). Hyperdrive is optimized for database access for Workers and
+will perform global connection pooling and fast query routing by connecting directly to your database.
+
+:::
+
+<Render file="create-hyperdrive-config-mysql-next-steps" />

src/content/docs/hyperdrive/examples/connect-to-mysql/mysql-drivers-and-libraries/drizzle-orm.mdx

@@ -0,0 +1,122 @@
+---
+pcx_content_type: example
+title: Drizzle ORM
+sidebar:
+  order: 3
+meta:
+  title: Using Drizzle ORM with Hyperdrive for MySQL
+---
+
+import { Render } from "~/components";
+
+[Drizzle ORM](https://orm.drizzle.team/) is a lightweight TypeScript ORM with a focus on type safety. This example demonstrates how to use Drizzle ORM with MySQL via Cloudflare Hyperdrive in a Workers application.
+
+## Prerequisites
+
+- A Cloudflare account with Workers access
+- A MySQL database
+- A [Hyperdrive configuration to your MySQL database](/hyperdrive/get-started/#3-connect-hyperdrive-to-a-database)
+
+## Installation
+
+Install the Drizzle ORM and its dependencies such as the [mysql2](https://github.com/sidorares/node-mysql2) driver:
+
+```sh
+# mysql2 v3.13.0 or later is required
+npm i drizzle-orm mysql2 dotenv
+npm i -D drizzle-kit tsx @types/node
+```
+
+Add the required Node.js compatibility flags and Hyperdrive binding to your `wrangler.jsonc` file:
+
+<Render file="hyperdrive-node-compatibility-requirement" />
+
+## Configure Drizzle
+
+### Define a schema
+
+With Drizzle ORM, we define the schema in TypeScript rather than writing raw SQL. Here's how to define a users table:
+
+```ts
+// src/schema.ts
+import { mysqlTable, int, varchar, timestamp } from "drizzle-orm/mysql-core";
+
+export const users = mysqlTable("users", {
+	id: int("id").primaryKey().autoincrement(),
+	name: varchar("name", { length: 255 }).notNull(),
+	email: varchar("email", { length: 255 }).notNull().unique(),
+	createdAt: timestamp("created_at").defaultNow(),
+});
+```
+
+### Connect Drizzle ORM to the database with Hyperdrive
+
+Use your the credentials of your Hyperdrive configuration for your database when using the
+Drizzle ORM within your Worker project as such:
+
+```ts
+// src/db/schema.ts
+
+import { drizzle } from "drizzle-orm/mysql2";
+import { createConnection } from "mysql2";
+import { users } from "./db/schema";
+
+export default {
+	async fetch(request, env, ctx): Promise<Response> {
+		// Create a connection using the mysql2 driver with the Hyperdrive credentials (only accessible from your Worker).
+		const connection = await createConnection({
+			host: env.HYPERDRIVE.host,
+			user: env.HYPERDRIVE.user,
+			password: env.HYPERDRIVE.password,
+			database: env.HYPERDRIVE.database,
+			port: env.HYPERDRIVE.port,
+
+			// Required to enable mysql2 compatibility for Workers
+			disableEval: true,
+		});
+
+		// Create the Drizzle client with the mysql2 driver connection
+		const db = drizzle(connection);
+
+		// Sample query to get all users
+		const allUsers = await db.select().from(users);
+
+		return Response.json(allUsers);
+	},
+} satisfies ExportedHandler<Env>;
+```
+
+### Configure Drizzle-Kit for migrations (optional)
+
+You can generate and run SQL migrations on your database based on your schema
+using Drizzle Kit CLI. Refer to [Drizzle ORM docs](https://orm.drizzle.team/docs/get-started/mysql-new) for additional guidance.
+
+1.  Create a `.env` file and add your database connection string. The Drizzle Kit CLI will use
+    this connection string to create and apply the migrations.
+
+    ```toml
+    # Replace with your direct database connection string
+    	DATABASE_URL='mysql://user:[email protected]/database-name'
+    ```
+
+2.  Create a `drizzle.config.ts` file in the root of your project to configure Drizzle Kit
+    and add the following content:
+
+        	```ts
+        	import 'dotenv/config';
+        	import { defineConfig } from 'drizzle-kit';
+        	export default defineConfig({
+        		out: './drizzle',
+        		schema: './src/db/schema.ts',
+        		dialect: 'mysql',
+        		dbCredentials: {
+        			url: process.env.DATABASE_URL!,
+        		},
+        	});
+        	```
+
+3.  Generate the migration file for your database according to your schema files and apply the migrations to your database.
+    `bash
+npx drizzle-kit generate
+npx drizzle-kit migrate
+`

src/content/docs/hyperdrive/examples/connect-to-mysql/mysql-drivers-and-libraries/index.mdx

@@ -0,0 +1,12 @@
+---
+pcx_content_type: navigation
+title: Libraries and Drivers
+sidebar:
+  order: 8
+  group:
+    hideIndex: true
+---
+
+import { DirectoryListing } from "~/components";
+
+<DirectoryListing />

src/content/docs/hyperdrive/examples/connect-to-mysql/mysql-drivers-and-libraries/mysql.mdx

@@ -0,0 +1,15 @@
+---
+pcx_content_type: example
+title: mysql
+sidebar:
+  order: 2
+meta:
+  title: Using mysql driver with Hyperdrive
+---
+
+import { Render } from "~/components";
+
+The [mysql](https://github.com/mysqljs/mysql) package is a MySQL driver for Node.js.
+This example demonstrates how to use it with Cloudflare Workers and Hyperdrive.
+
+<Render file="use-mysql-to-make-query" product="hyperdrive" />

src/content/docs/hyperdrive/examples/connect-to-mysql/mysql-drivers-and-libraries/mysql2.mdx

@@ -0,0 +1,13 @@
+---
+pcx_content_type: example
+title: mysql2
+sidebar:
+  order: 1
+---
+
+import { Render } from "~/components";
+
+The [mysql2](https://github.com/sidorares/node-mysql2) package is a modern MySQL driver for Node.js with better performance and built-in Promise support.
+This example demonstrates how to use it with Cloudflare Workers and Hyperdrive.
+
+<Render file="use-mysql2-to-make-query" product="hyperdrive" />

src/content/docs/hyperdrive/examples/connect-to-postgres/index.mdx

@@ -32,19 +32,7 @@ npx wrangler hyperdrive create my-first-hyperdrive --connection-string="postgres
 
 The command above will output the ID of your Hyperdrive, which you will need to set in the [Wrangler configuration file](/workers/wrangler/configuration/) for your Workers project:
 
-<WranglerConfig>
-
-```toml
-# required for database drivers to function
-compatibility_flags = ["nodejs_compat"]
-compatibility_date = "2024-09-23"
-
-[[hyperdrive]]
-binding = "HYPERDRIVE"
-id = "<your-hyperdrive-id-here>"
-```
-
-</WranglerConfig>
+<Render file="hyperdrive-node-compatibility-requirement" product="hyperdrive" />
 
 This will allow Hyperdrive to generate a dynamic connection string within your Worker that you can pass to your existing database driver. Refer to [Driver examples](#driver-examples) to learn how to set up a database driver with Hyperdrive.
 
@@ -84,57 +72,13 @@ The following examples show you how to:
 
 The following Workers code shows you how to use [Postgres.js](https://github.com/porsager/postgres) with Hyperdrive.
 
-<Render file="use-postgresjs-to-make-query" product="hyperdrive" />
+<Render file="use-postgres-js-to-make-query" product="hyperdrive" />
 
 ### node-postgres / pg
 
 Install the `node-postgres` driver:
 
-```sh
-npm install pg
-```
-
-**Ensure you have `compatibility_flags` and `compatibility_date` set in your [Wrangler configuration file](/workers/wrangler/configuration/)** as shown below:
-
-<Render file="nodejs-compat-wrangler-toml" product="workers" />
-
-Create a new `Client` instance and pass the Hyperdrive parameters:
-
-```ts
-import { Client } from "pg";
-
-export interface Env {
-	// If you set another name in the Wrangler configuration file as the value for 'binding',
-	// replace "HYPERDRIVE" with the variable name you defined.
-	HYPERDRIVE: Hyperdrive;
-}
-
-export default {
-	async fetch(request, env, ctx): Promise<Response> {
-		const client = new Client({
-			connectionString: env.HYPERDRIVE.connectionString,
-		});
-
-		try {
-			// Connect to your database
-			await client.connect();
-
-			// A very simple test query
-			const result = await client.query({ text: "SELECT * FROM pg_tables" });
-
-			// Clean up the client, ensuring we don't kill the worker before that is
-			// completed.
-			ctx.waitUntil(client.end());
-
-			// Return result rows as JSON
-			return Response.json({ result: result });
-		} catch (e) {
-			console.log(e);
-			return Response.json({ error: e.message }, { status: 500 });
-		}
-	},
-} satisfies ExportedHandler<Env>;
-```
+<Render file="use-node-postgres-to-make-query" product="hyperdrive" />
 
 ## Identify connections from Hyperdrive
 

src/content/docs/hyperdrive/examples/connect-to-postgres/aws-rds-aurora.mdx → src/content/docs/hyperdrive/examples/connect-to-postgres/postgres-database-providers/aws-rds-aurora.mdx

@@ -91,3 +91,4 @@ With a database user, password, database endpoint (hostname and port) and databa
 ## 3. Create a database configuration
 
 <Render file="create-hyperdrive-config" />
+<Render file="create-hyperdrive-config-next-steps" />

src/content/docs/hyperdrive/examples/connect-to-postgres/azure.mdx → src/content/docs/hyperdrive/examples/connect-to-postgres/postgres-database-providers/azure.mdx

@@ -38,3 +38,4 @@ To connect to a private Azure Database for PostgreSQL instance, refer to [Connec
 ## 2. Create a database configuration
 
 <Render file="create-hyperdrive-config" />
+<Render file="create-hyperdrive-config-next-steps" />

src/content/docs/hyperdrive/examples/connect-to-postgres/cockroachdb.mdx → src/content/docs/hyperdrive/examples/connect-to-postgres/postgres-database-providers/cockroachdb.mdx

@@ -41,3 +41,4 @@ By default, the CockroachDB cloud enables connections from the public Internet (
 ## 2. Create a database configuration
 
 <Render file="create-hyperdrive-config" />
+<Render file="create-hyperdrive-config-next-steps" />