Near-zero runtime ORM for Node.js and TypeScript
Aurora ORM support PostgreSQL.
Aurora ORM is an ORM that can run in NodeJS and can be used with TypeScript and JavaScript environment. Its goal is to always use only native JavaScript features and provide additional features like Data migration tool that help you to develop applications that uses databases.
Aurora ORM supports only Data Mapper pattern. And don't use unstable features like decorators and reflect-metadata that give you the ability to use modern JavaScript/TypeScript transpilers like SWC or ESbuild to speed up development.
- Models and type safe columns mapping
- Database-specific column types
- Transactions
- Relations
- Indexes
- Logging
- Migrations
- Connection pooling
- TypeScript and JavaScript support
- Support functional programming composition pattern
- Produced code is performant, flexible, clean and maintainable
- Support modern transpilers like SWC or ESbuild
- Install the npm package:
pnpm add aurora-orm
- Install a database driver:
pnpm add [pg|postgres]
import {connect, Drivers} from 'aurora-orm'
await connect({
config: {
// optional, default value 'Drivers.PG'
driver: Drivers.PG,
connectionString: 'postgres://test:test@localhost:5432/test',
// or
host: 'localhost',
port: 5432,
username: 'test',
password: 'test',
database: 'test',
},
})
Create migrator script:
import {runMigrationsAndExit, Drivers} from 'aurora-orm'
// Some code to load connectionString
const connectionString = 'postgres://test:test@localhost:5432/test'
const direction = process.argv[2] as 'down' | 'up'
await runMigrationsAndExit({
config: {driver: Drivers.PG, connectionString},
direction,
})
And add to package.json
scripts:
{
"scripts": {
"migrator:down": "tsx ./src/migrator.ts down",
"migrator:up": "tsx ./src/migrator.ts up",
"migrator:create": "aurora-orm create"
},
}
import {createModel} from 'aurora-orm'
export interface User {
id: number
name: string
age: number | null
password: string
addictions: number[]
}
export const UserModel = createModel<User>({
table: 'users',
mapping: {
// Type Safe columns mapping
id: 'id',
name: 'name',
age: 'age',
password: {
name: 'password',
hidden: true,
},
addictions: 'addictions',
},
})
const user = await UserModel.create({
name: 'John',
age: 26,
password: 'iLoveCats',
addictions: [4],
})
const allUsers = await UserModel.findAll()
const firstUser = await UserModel.findOne(1) // find by id
const john = await UserModel.findOne({
name: 'John',
age: 26,
}) // find by name and age
await UserModel.delete(john)