https://github.com/constructive-io/drizzle-test-suite
A friendly playground for building, testing and validating Drizzle ORM Row‑Level Security (RLS)
https://github.com/constructive-io/drizzle-test-suite
Last synced: 5 months ago
JSON representation
A friendly playground for building, testing and validating Drizzle ORM Row‑Level Security (RLS)
- Host: GitHub
- URL: https://github.com/constructive-io/drizzle-test-suite
- Owner: constructive-io
- License: mit
- Created: 2025-11-22T06:25:13.000Z (7 months ago)
- Default Branch: main
- Last Pushed: 2025-12-16T09:34:52.000Z (6 months ago)
- Last Synced: 2025-12-19T20:44:35.324Z (6 months ago)
- Language: TypeScript
- Homepage:
- Size: 358 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# drizzle-orm-test test suite
drizzle-orm-test demo
This demo shows how to use `drizzle-orm-test` for fast, isolated PostgreSQL testing with [Drizzle ORM](https://orm.drizzle.team/). The package is powered by [drizzle-orm-test](https://www.npmjs.com/package/drizzle-orm-test).
## What is drizzle-orm-test?
`drizzle-orm-test` provides a testing utility for Drizzle ORM with isolated PostgreSQL databases and transaction-based cleanup between tests.
## Usage
Here's how to use it:
```typescript
import { drizzle } from 'drizzle-orm/node-postgres';
import { getConnections, PgTestClient } from 'drizzle-orm-test';
let db: PgTestClient;
let pg: PgTestClient;
let teardown: () => Promise;
beforeAll(async () => {
({ pg, db, teardown } = await getConnections());
});
afterAll(async () => { await teardown(); });
beforeEach(async () => { await db.beforeEach(); });
afterEach(async () => { await db.afterEach(); });
describe('your tests', () => {
it('should work with standard Drizzle pattern', async () => {
const drizzleDb = drizzle(db.client);
const result = await drizzleDb.execute('select 1 as num');
expect(result.rows[0].num).toBe(1);
});
});
```
## RLS Testing
Test Row Level Security with context management:
```typescript
it('user should only see their own rows', async () => {
db.setContext({
role: 'authenticated',
'jwt.claims.user_id': '1'
});
const drizzleDb = drizzle(db.client);
const rows = await drizzleDb.select().from(users);
expect(rows.every(r => r.userId === '1')).toBe(true);
});
```
Check out the [package source](./packages/drizzle) and [test examples](./packages/drizzle/__tests__) to see how it works!
## Developing
```sh
docker-compose up
pnpm install
cd packages/drizzle
pnpm test:watch
```
## Education and Tutorials
1. 🚀 [Quickstart: Getting Up and Running](https://constructive.io/learn/quickstart)
Get started with modular databases in minutes. Install prerequisites and deploy your first module.
2. 📦 [Modular PostgreSQL Development with Database Packages](https://constructive.io/learn/modular-postgres)
Learn to organize PostgreSQL projects with pgpm workspaces and reusable database modules.
3. ✏️ [Authoring Database Changes](https://constructive.io/learn/authoring-database-changes)
Master the workflow for adding, organizing, and managing database changes with pgpm.
4. 🧪 [End-to-End PostgreSQL Testing with TypeScript](https://constructive.io/learn/e2e-postgres-testing)
Master end-to-end PostgreSQL testing with ephemeral databases, RLS testing, and CI/CD automation.
5. ⚡ [Supabase Testing](https://constructive.io/learn/supabase)
Use TypeScript-first tools to test Supabase projects with realistic RLS, policies, and auth contexts.
6. 💧 [Drizzle ORM Testing](https://constructive.io/learn/drizzle-testing)
Run full-stack tests with Drizzle ORM, including database setup, teardown, and RLS enforcement.
7. 🔧 [Troubleshooting](https://constructive.io/learn/troubleshooting)
Common issues and solutions for pgpm, PostgreSQL, and testing.
## Credits
**🛠 Built by the [Constructive](https://constructive.io) team — creators of modular Postgres tooling for secure, composable backends. If you like our work, contribute on [GitHub](https://github.com/constructive-io).**
## Disclaimer
AS DESCRIBED IN THE LICENSES, THE SOFTWARE IS PROVIDED “AS IS”, AT YOUR OWN RISK, AND WITHOUT WARRANTIES OF ANY KIND.
No developer or entity involved in creating this software will be liable for any claims or damages whatsoever associated with your use, inability to use, or your interaction with other users of the code, including any direct, indirect, incidental, special, exemplary, punitive or consequential damages, or loss of profits, cryptocurrencies, tokens, or anything else of value.