RTSC is a library that allows you to define classes that can be stored and retrieved from a data storage in a relational way. It is designed to mimic the behavior of a relational database ORM, but it is not an ORM. Neither is it supposed to be used with remote database. It pulls entire table from storage and then performs operations to bind relational data and store it back. So, it is not suitable for remote databases. But it can be helpful for local storages, like LocalStorage, IndexedDB, sql.js, SessionStorage, etc.
npm install @nightmaregaurav/rtsc
Usage (Watch video)
// Person.ts
import {Address} from "./Address";
export class Person {
id: string;
name: string;
age: number;
address: Address[];
}
// Address.ts
import {Person} from "./Person";
export class Address {
id: string;
street: string;
city: string;
personId: string;
person: Person;
}
// PersonSpecification.ts
import {RelationalClassSpecificationBuilder} from "@nightmaregaurav/rtsc/RelationalClassSpecificationBuilder";
import {Person} from "./Person";
import {Address} from "./Address";
export const PersonSpecification = new RelationalClassSpecificationBuilder(Person)
.withTableName("person") // Optional: By default it uses class name
.hasIdentifier("id")
.hasMany("address", Address, "personId")
.build();
// AddressSpecification.ts
import {RelationalClassSpecificationBuilder} from "@nightmaregaurav/rtsc/RelationalClassSpecificationBuilder";
import {Person} from "./Person";
import {Address} from "./Address";
export const AddressSpecification = new RelationalClassSpecificationBuilder(Address)
.withTableName("address") // Optional: By default it uses class name
.hasIdentifier("id")
.hasOne("person", Person, "personId")
.build();
// DataRegistry.ts (Somewhere in your entry point you must import this file/or place the register calls in a method and call it.)
import {RelationalClassSpecificationRegistry} from "@nightmaregaurav/rtsc/RelationalClassSpecificationRegistry";
import {PersonSpecification} from "./PersonSpecification";
import {AddressSpecification} from "./AddressSpecification";
RelationalClassSpecificationRegistry.register(AddressSpecification);
RelationalClassSpecificationRegistry.register(PersonSpecification);
// DataStorage.ts (Somewhere in your entry point you must import this file/or place the register calls in a method and call it.)
import {RelationalClassStorageDriver} from "@nightmaregaurav/rtsc/RelationalClassStorageDriver";
// You can use any storage here, like LocalStorage, IndexedDB, sql.js, SessionStorage, etc.
// skipping this step will use LocalStorage
const DataStorage = new Map<string, any[]>();
if (!RelationalClassStorageDriver.isConfigured()) {
RelationalClassStorageDriver.configure(
async table => await (async () => DataStorage.get(table) || [])(),
async (table, data) => await (async () => { DataStorage.set(table, data); })()
);
}
// DataHandlers.ts
import {RelationalClassDataHandler} from "@nightmaregaurav/rtsc/RelationalClassDataHandler";
import {Person} from "./Person";
import {Address} from "./Address";
export const PersonDataHandler = new RelationalClassDataHandler(Person);
export const AddressDataHandler = new RelationalClassDataHandler(Address, 1); // 1 is the depth of relational data
const person = new Person();
person.id = "1";
person.name = "John";
person.age = 30;
const address1 = new Address();
address1.id = "1";
address1.street = "123 Main St";
address1.city = "Springfield";
address1.personId = "1";
const address2 = new Address();
address2.id = "2";
address2.street = "456 Elm St";
address2.city = "Springfield";
address2.personId = "1";
(async () => {
await PersonDataHandler.createIfNotExists(person);
await AddressDataHandler.createIfNotExists(address1);
await AddressDataHandler.createIfNotExists(address2);
console.log(await PersonDataHandler.withDepth(2).retrieve("1"));
console.log(await AddressDataHandler.retrieve("1"));
})();
// Output:
// Person {
// id: '1',
// name: 'John',
// age: 30,
// address: [
// Address {
// id: '1',
// street: '123 Main St',
// city: 'Springfield',
// personId: '1',
// person: [Circular *1]
// },
// Address {
// id: '2',
// street: '456 Elm St',
// city: 'Springfield',
// personId: '1',
// person: [Circular *1]
// }
// ]
// }
// Backup.ts
import {RelationalClassDataHandler} from "@nightmaregaurav/rtsc/RelationalClassDataHandler";
const dump = await RelationalClassDataHandler.dumpAllData(); // dump is a Map<string, any[]> where string is the table name and any[] is the data
... // Save the dump to a file or send it to a server
// Restore.ts
import {RelationalClassDataHandler} from "@nightmaregaurav/rtsc/RelationalClassDataHandler";
await RelationalClassDataHandler.loadAllData(dump); // dump is a Map<string, any[]> where string is the table name and any[] is the data
- Fork the repository
- Clone the forked repository
- Make changes
- Commit and push the changes
- Create a pull request
- Wait for the pull request to be merged
- Celebrate
- Repeat
If you are new to open source, you can read this to learn how to contribute to open source projects.
If you are new to GitHub, you can read this to learn how to use GitHub.
If you are new to Git, you can read this to learn how to use Git.
If you are new to TypeScript, you can read this to learn how to use TypeScript.
RTSC is released under the MIT License. You can find the full license details in the LICENSE file.
Made with ❤️ by NightmareGaurav.