From 67158e467bf3354749b1b9869072433d885a0d8d Mon Sep 17 00:00:00 2001
From: Robert Vitonsky <robert@vitonsky.net>
Date: Sat, 24 Jan 2026 00:36:43 +0100
Subject: [PATCH 1/2] docs: add nano-queries in query builders list

---
 docs/docs/orm-support.md | 39 +++++++++++++++++++++++++++++++++++++++
 1 file changed, 39 insertions(+)

diff --git a/docs/docs/orm-support.md b/docs/docs/orm-support.md
index 678bec263..4f488f76c 100644
--- a/docs/docs/orm-support.md
+++ b/docs/docs/orm-support.md
@@ -192,3 +192,42 @@ const pgliteDb = await getPGliteInstance()
 Check [TypeORM documentation](https://typeorm.io/data-source)
 and [typeorm-pglite](https://github.com/muraliprajapati/typeorm-pglite) documentation for
 more details.
+
+## Nano Queries
+
+[Nano Queries](https://nano-queries.js.org/) is a database-agnostic state of the art query builder.
+
+It work everywhere JavaScript can be run, build a safe queries for anything, including PGLite.
+
+Features to highlight:
+- That is not an ORM. It is a 100% natural query builder
+- Simple API to build complex queries
+- Laziness. First-class support for dynamic query building and lateral query extension
+- Nested queries
+- Easy to extend. Build your own modules from primitives
+
+Nano Queries by its design does not require any "drivers"/"adapters"/"compilers" or any other addons to work with PGLite:
+
+```javascript
+import { PGlite } from '@electric-sql/pglite';
+import { ConfigurableSQLBuilder, SQLCompiler } from 'nano-queries';
+
+// SQL builder must be configured once
+const { sql, compile } = new ConfigurableSQLBuilder(
+	new SQLCompiler({
+		getPlaceholder(valueIndex) {
+			return '$' + (valueIndex + 1);
+		},
+	}),
+);
+
+const currentYear = new Date().getFullYear();
+const { sql, bindings } = compile(sql`SELECT title FROM movies WHERE release_year = ${currentYear}`);
+// Returns query with placeholders and array with bindings equal to
+// {
+//   sql: "SELECT title FROM movies WHERE release_year = $1",
+//   bindings: [2026],
+// }
+
+await db.query(sql, bindings);
+```

From 813668350a032b7f9b735d200522eda1bdefbba8 Mon Sep 17 00:00:00 2001
From: Robert Vitonsky <robert@vitonsky.net>
Date: Sat, 24 Jan 2026 16:50:35 +0100
Subject: [PATCH 2/2] docs: update demo & add sandbox link to run

Refactor SQL query building to support dynamic filters based on user input.
---
 docs/docs/orm-support.md | 32 +++++++++++++++++++++++++-------
 1 file changed, 25 insertions(+), 7 deletions(-)

diff --git a/docs/docs/orm-support.md b/docs/docs/orm-support.md
index 4f488f76c..60889c3a1 100644
--- a/docs/docs/orm-support.md
+++ b/docs/docs/orm-support.md
@@ -213,7 +213,7 @@ import { PGlite } from '@electric-sql/pglite';
 import { ConfigurableSQLBuilder, SQLCompiler } from 'nano-queries';
 
 // SQL builder must be configured once
-const { sql, compile } = new ConfigurableSQLBuilder(
+const { sql, compile, where } = new ConfigurableSQLBuilder(
 	new SQLCompiler({
 		getPlaceholder(valueIndex) {
 			return '$' + (valueIndex + 1);
@@ -221,13 +221,31 @@ const { sql, compile } = new ConfigurableSQLBuilder(
 	}),
 );
 
-const currentYear = new Date().getFullYear();
-const { sql, bindings } = compile(sql`SELECT title FROM movies WHERE release_year = ${currentYear}`);
-// Returns query with placeholders and array with bindings equal to
+const userInput = {
+  year: 2007,
+  rating: 4.1,
+};
+
+
+// You may nest one query into another
+const filter = where();
+const query = sql`SELECT title FROM movies ${filter} LIMIT 100`;
+
+// A query segment can be extended any time before compiling
+filter.and(sql`release_year = ${userInput.year}`);
+
+// That's useful to build a complex conditional queries
+if (userInput.rating > 0) {
+  filter.and(sql`rating >= ${userInput.rating}`);
+}
+
+const movies = compile(query);
 // {
-//   sql: "SELECT title FROM movies WHERE release_year = $1",
-//   bindings: [2026],
+//   sql: 'SELECT title FROM movies WHERE release_year = $1 AND rating >= $2 LIMIT 100',
+//   bindings: [2007, 4.1],
 // }
 
-await db.query(sql, bindings);
+await db.query(movies.sql, movies.bindings);
 ```
+
+[Run this demo](https://stackblitz.com/edit/stackblitz-starters-rxhqvgfr?file=pglite.js&view=editor) with movies data in a sandbox & play.