adjust per discord feedback

Author: thomasgauvin

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

@@ -44,7 +44,7 @@ Hyperdrive uses Workers [TCP socket support](/workers/runtime-apis/tcp-sockets/#
 
 | Driver                                                     | Documentation                                                            | Minimum Version Required | Notes                                                                                                                                                                                                                                                                                |
 | ---------------------------------------------------------- | ------------------------------------------------------------------------ | ------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
-| Postgres.js (**recommended**)                              | [Postgres.js documentation](https://github.com/porsager/postgres)        | `[email protected]`         | Supported in both Workers & Pages.                                                                                                                                                                                                                                                   |
+| Postgres.js                                                | [Postgres.js documentation](https://github.com/porsager/postgres)        | `[email protected]`         | Supported in both Workers & Pages.                                                                                                                                                                                                                                                   |
 | node-postgres - `pg`                                       | [node-postgres - `pg` documentation](https://node-postgres.com/)         | `[email protected]`              | `8.11.4` introduced a bug with URL parsing and will not work. `8.11.5` fixes this. Requires `compatibility_flags = ["nodejs_compat"]` and `compatibility_date = "2024-09-23"` - refer to [Node.js compatibility](/workers/runtime-apis/nodejs). Requires wrangler `3.78.7` or later. |
 | Drizzle                                                    | [Drizzle documentation](https://orm.drizzle.team/)                       | `0.26.2`^                |                                                                                                                                                                                                                                                                                      |
 | Kysely                                                     | [Kysely documentation](https://kysely.dev/)                              | `0.26.3`^                |                                                                                                                                                                                                                                                                                      |

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

@@ -29,7 +29,7 @@ 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" product="hyperdrive"/>
+<Render file="hyperdrive-node-compatibility-requirement" product="hyperdrive" />
 
 ## 2. Configure Drizzle
 
@@ -66,7 +66,12 @@ export interface Env {
 export default {
 	async fetch(request, env, ctx): Promise<Response> {
 		// Create a database client with postgres.js driver connected via Hyperdrive
-		const sql = postgres(env.HYPERDRIVE.connectionString);
+		const sql = postgres(env.HYPERDRIVE.connectionString, {
+			// Limit the connections for the Worker request to 5 due to Workers' limits on concurrent external connections
+			max: 5,
+			// If you are not using array types in your Postgres schema, disable `fetch_types` to avoid an additional round-trip (unnecessary latency)
+			fetch_types: false,
+		});
 
 		// Create the Drizzle client with the postgres.js connection
 		const db = drizzle(sql);
@@ -82,6 +87,13 @@ export default {
 } satisfies ExportedHandler<Env>;
 ```
 
+:::note
+
+You may use [node-postgres](https://orm.drizzle.team/docs/get-started-postgresql#node-postgres) or [Postgres.js](https://orm.drizzle.team/docs/get-started-postgresql#postgresjs)
+when using Drizzle ORM. Both are supported and compatible.
+
+:::
+
 ### 2.3 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/postgresql) for additional guidance.
@@ -95,22 +107,22 @@ You can generate and run SQL migrations on your database based on your schema us
 
 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: "postgresql",
-    	dbCredentials: {
-    		url: process.env.DATABASE_URL!,
-    	},
-    });
-    ```
+   ```ts
+   import "dotenv/config";
+   import { defineConfig } from "drizzle-kit";
+   export default defineConfig({
+   	out: "./drizzle",
+   	schema: "./src/db/schema.ts",
+   	dialect: "postgresql",
+   	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
-    ```
+   ```bash
+   npx drizzle-kit generate
+   npx drizzle-kit migrate
+   ```

src/content/partials/hyperdrive/use-node-postgres-to-make-query.mdx

@@ -8,6 +8,8 @@ Install the `node-postgres` driver:
 
 ```sh
 npm install pg
+# If using TypeScript
+npm i --save-dev @types/pg
 ```
 
 Add the required Node.js compatibility flags and Hyperdrive binding to your `wrangler.jsonc` file:
@@ -48,6 +50,8 @@ export default {
 			});
 		} catch (error: any) {
 			console.error("Database error:", error.message);
+
+			return Response.error();
 		}
 	},
 };

src/content/partials/hyperdrive/use-postgres-js-to-make-query.mdx

@@ -48,6 +48,8 @@ export default {
 			return Response.json({ success: true, result: result });
 		} catch (e: any) {
 			console.error("Database error:", e.message);
+
+			return Response.error();
 		}
 	},
 } satisfies ExportedHandler<Env>;