Rattus ORM – Core

Contents

1. Base of Rattus ORM: Database, Repositories, Model, Query, all typings;
2. ObjectDataProvider – data provider for simple in-memory storage (JS Object).

Installation

Use your favorite package manager. For example, yarn:

1yarn add @rattus-orm/core

Important notes

If you are using Vite with TypeScript, make sure you have these settings in tsconfig.json:

1{
2  "compilerOptions": {
3    // ...
4    "useDefineForClassFields": true,
5    "experimentalDecorators": true
6  }
7}

Also you should use this syntax for defining models:

1class User extends Model {
2  public static entity = 'users'
3
4  @Str('')
5  // public id: string - will not work, 
6  // all fields of your models will be "null"
7  declare id: string

Basic usage

1import { Model, Uid, Str } from '@rattus-orm/core'
2import { ObjectDataProvider } from '@rattus-orm/core/object-data-provider'
3import { createDatabase } from '@rattus-orm/core/src'
4
5class User extends Model {
6  public static entity = 'user'
7
8  @Uid()
9  public id: string
10
11  @Str()
12  public email: string
13}
14
15const database = createDatabase({
16  dataProvider: new ObjectDataProvider(),
17  connection: 'entities'
18}).start()
19
20const userRepo = database.getRepository(User)
21userRepo.save([{ id: '1', email: 'test@test.com' }, { id: '2', email: 'test2@test.com' }])
22
23const found = userRepo.find('2')

Documentation

For detailed docs please read documentation website.

Contributing

Contributions are welcome! Please read our Contributing Guide for details on our code of conduct, and the process for submitting pull requests.