drizzle-orm 0.17.0 → 0.17.1-4673c8e

package/README.md

@@ -25,9 +25,9 @@ Drizzle ORM is being battle-tested on production projects by multiple teams 🚀
 - Auto-inferring of TS types for DB models for selections and insertions separately
 - Zero dependencies
 
-## Database support status
+## Supported databases
 
-| Database    | Support | |
+| Database    | Status | |
 |:------------|:-------:|:---|
 | PostgreSQL  | ✅ | [Docs](./drizzle-orm/src/pg-core/README.md)|
 | MySQL       | ✅      |[Docs](./drizzle-orm/src/mysql-core/README.md)|
@@ -43,4 +43,94 @@ npm install drizzle-orm
 npm install -D drizzle-kit
 ```
 
-See [dialect-specific docs](#database-support-status) for more details.
+## Feature showcase (PostgreSQL)
+
+> **Note**: don't forget to install `pg` and `@types/pg` packages for this example to work.
+
+```typescript
+import { eq } from 'drizzle-orm/expressions';
+import { drizzle } from 'drizzle-orm/node-postgres';
+import { InferModel, integer, pgTable, serial, text, timestamp, varchar } from 'drizzle-orm/pg-core';
+import { sql } from 'drizzle-orm/sql';
+import { Pool } from 'pg';
+
+export const users = pgTable('users', {
+  id: serial('id').primaryKey(),
+  fullName: text('full_name').notNull(),
+  phone: varchar('phone', { length: 20 }).notNull(),
+  role: text<'user' | 'admin'>('role').default('user').notNull(),
+  cityId: integer('city_id').references(() => cities.id),
+  createdAt: timestamp('created_at').defaultNow().notNull(),
+  updatedAt: timestamp('updated_at').defaultNow().notNull(),
+});
+
+export type User = InferModel<typeof users>;
+export type NewUser = InferModel<typeof users, 'insert'>;
+
+export const cities = pgTable('cities', {
+  id: serial('id').primaryKey(),
+  name: text('name').notNull(),
+});
+
+export type City = InferModel<typeof cities>;
+export type NewCity = InferModel<typeof cities, 'insert'>;
+
+const pool = new Pool({
+  connectionString: 'postgres://user:password@host:port/db',
+});
+
+const db = drizzle(pool);
+
+// Insert
+const newUser: NewUser = {
+  fullName: 'John Doe',
+  phone: '+123456789',
+};
+const insertedUsers /* : User */ = await db.insert(users).values(newUser).returning();
+const insertedUser = insertedUsers[0]!;
+
+const newCity: NewCity = {
+  name: 'New York',
+};
+const insertedCities /* : City */ = await db.insert(cities).values(newCity).returning();
+const insertedCity = insertedCities[0]!;
+
+// Update
+const updateResult /* : { updated: Date }[] */ = await db.update(users)
+  .set({ cityId: insertedCity.id, updatedAt: new Date() })
+  .where(eq(users.id, insertedUser.id))
+  .returning({ updated: users.updatedAt });
+
+// Select
+const allUsers /* : User[] */ = await db.select(users);
+
+// Select custom fields
+const upperCaseNames /* : { id: number; name: string }[] */ = await db.select(users)
+  .fields({
+    id: users.id,
+    name: sql`upper(${users.fullName})`.as<string>(),
+  });
+
+// Joins
+// You wouldn't BELIEVE how SMART the result type is! 😱
+const allUsersWithCities = await db.select(users)
+  .fields({
+    user: {
+      id: users.id,
+      name: users.fullName,
+    },
+    cityId: cities.id,
+    cityName: cities.name,
+  })
+  .leftJoin(cities, eq(users.cityId, cities.id));
+
+// Delete
+const deletedNames /* : { name: string }[] */ = await db.delete(users)
+  .where(eq(users.id, insertedUser.id))
+  .returning({ name: users.fullName });
+```
+
+**See full docs for further reference:**
+- [PostgreSQL](./drizzle-orm/src/pg-core/README.md)
+- [MySQL](./drizzle-orm/src/mysql-core/README.md)
+- [SQLite](./drizzle-orm/src/sqlite-core/README.md)

package/package.json

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