Add changelog, bump ORM version to 0.19.0

changelogs/drizzle-orm/0.19.0.md

@@ -0,0 +1,17 @@
+- Implemented selecting and joining a subquery. Example usage:
+
+  ```ts
+  const sq = db
+    .select({
+      categoryId: courseCategoriesTable.id,
+      category: courseCategoriesTable.name,
+      total: sql`count(${courseCategoriesTable.id})`.as<number>(),
+    })
+    .from(courseCategoriesTable)
+    .groupBy(courseCategoriesTable.id, courseCategoriesTable.name)
+    .subquery('sq');
+  ```
+
+  After that, just use the subquery instead of a table as usual.
+
+- ❗ Replaced `db.select(table).fields({ ... })` syntax with `db.select({ ... }).from(table)` to look more like its SQL counterpart.

drizzle-orm/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "drizzle-orm",
-	"version": "0.18.0",
+	"version": "0.19.0",
 	"description": "Drizzle ORM package for SQL databases",
 	"scripts": {
 		"build": "tsc && resolve-tspaths && cp ../README.md package.json dist/",

drizzle-orm/src/mysql-core/README.md

@@ -373,8 +373,24 @@ await db.select().from(users).orderBy(users.name);
 await db.select().from(users).orderBy(desc(users.name));
 // you can pass multiple order args
 await db.select().from(users).orderBy(asc(users.name), desc(users.name));
+```
+
+#### Select from subquery
+
+```typescript
+const sq = db.select().from(users).where(eq(users.id, 42)).subquery('sq');
+await db.select().from(sq);
+```
+
+Subqueries in joins are supported, too:
 
-// list of all filter operators
+```typescript
+await db.select().from(users).leftJoin(sq, eq(users.id, sq.id));
+```
+
+#### List of all filter operators
+
+```typescript
 eq(column, value)
 eq(column1, column2)
 ne(column, value)
@@ -416,6 +432,7 @@ not(sqlExpression)
 
 and(expressions: SQL[])
 or(expressions: SQL[])
+
 ```
 
 ### Insert

drizzle-orm/src/pg-core/README.md

@@ -378,8 +378,24 @@ await db.select().from(users).orderBy(users.name);
 await db.select().from(users).orderBy(desc(users.name));
 // you can pass multiple order args
 await db.select().from(users).orderBy(asc(users.name), desc(users.name));
+```
+
+#### Select from subquery
+
+```typescript
+const sq = db.select().from(users).where(eq(users.id, 42)).subquery('sq');
+await db.select().from(sq);
+```
+
+Subqueries in joins are supported, too:
 
-// list of all filter operators
+```typescript
+await db.select().from(users).leftJoin(sq, eq(users.id, sq.id));
+```
+
+#### List of all filter operators
+
+```typescript
 eq(column, value)
 eq(column1, column2)
 ne(column, value)

drizzle-orm/src/sqlite-core/README.md

@@ -271,8 +271,24 @@ db.select().from(users).orderBy(users.name).all();
 db.select().from(users).orderBy(desc(users.name)).all();
 // you can pass multiple order args
 db.select().from(users).orderBy(asc(users.name), desc(users.name)).all();
+```
+
+#### Select from subquery
+
+```typescript
+const sq = db.select().from(users).where(eq(users.id, 42)).subquery('sq');
+db.select().from(sq).all();
+```
+
+Subqueries in joins are supported, too:
 
-// list of all filter operators
+```typescript
+db.select().from(users).leftJoin(sq, eq(users.id, sq.id)).all();
+```
+
+#### List of all filter operators
+
+```typescript
 eq(column, value)
 eq(column1, column2)
 ne(column, value)