nestjs-typegoose


!npm
!npm bundle size

Description

NOTE: this is a fork of nestjs-typegoose. We and another dependency we use needed this package to be up-to-date and since the original maintainer hadn't kept up with the updating for over a year, we've decided to take over the package. We are very grateful for the work put into the original package and give kpfromer full credit for the work.

What does this package do? It injects typegoose models for nest components (mainly services). This module is very similar to @nestjs/mongoose. however, Typegoose goes much further in terms of TypeScript support for Mongoose.

Using Typegoose removes the need for having a Model interface and more.

Installation

``bash
npm install --save @m8a/nestjs-typegoose
`

or

`
yarn add @m8a/nestjs-typegoose
`

Documentation

Here is the full documentation describing all basic and advanced features.

Basic usage

You can checkout the example project for more details.

app.module.ts

`typescript
import { Module } from "@nestjs/common";
import { TypegooseModule } from "@m8a/nestjs-typegoose";
import { CatsModule } from "./cat.module.ts";

@Module({
imports: [
TypegooseModule.forRoot("mongodb://localhost:27017/nest"),
CatsModule,
],
})
export class ApplicationModule {}
`

Create class that describes your schema

cat.model.ts

`typescript
import { prop } from "@typegoose/typegoose";
import { IsString } from "class-validator";

export class Cat {
@IsString()
@prop({ required: true })
name: string;
}
`

Inject Cat for CatsModule

cat.module.ts

`typescript
import { Module } from "@nestjs/common";
import { TypegooseModule } from "@m8a/nestjs-typegoose";
import { Cat } from "./cat.model";
import { CatsController } from "./cats.controller";
import { CatsService } from "./cats.service";

@Module({
imports: [TypegooseModule.forFeature([Cat])],
controllers: [CatsController],
providers: [CatsService],
})
export class CatsModule {}
`

Get the cat model in a service

cats.service.ts

`typescript
import { Injectable } from "@nestjs/common";
import { InjectModel } from "@m8a/nestjs-typegoose";
import { Cat } from "./cat.model";
import { ReturnModelType } from "@typegoose/typegoose";

@Injectable()
export class CatsService {
constructor(
@InjectModel(Cat) private readonly catModel: ReturnModelType
) {}

async create(createCatDto: { name: string }): Promise {
const createdCat = new this.catModel(createCatDto);
return await createdCat.save();
}

async findAll(): Promise {
return await this.catModel.find().exec();
}
}
`

Finally, use the service in a controller!

cats.controller.ts

`typescript
import { Controller, Get, Post, Body } from "@nestjs/common";
import { CatsService } from "./cats.service";
import { Cat } from "./cats.model.ts";

@Controller("cats")
export class CatsController {
constructor(private readonly catsService: CatsService) {}

@Get()
async getCats(): Promise {
return await this.catsService.findAll();
}

@Post()
async create(@Body() cat: Cat): Promise {
return await this.catsService.create(cat);
}
}
`

$3

You can now inject a connection inside of your services, when needed.

`typescript
import { Injectable } from '@nestjs/common';
import { InjectConnection } from '@m8a/nestjs-typegoose';
import { Connection } from 'mongoose';

@Injectable()
export class CatsService {
constructor(@InjectConnection() private connection: Connection) {}
}

``

Requirements

1. @typegoose/typegoose +12
2. @nestjs/common +10
3. @nestjs/core +10
4. mongoose +8.0.1
5. typscript +5.2

License

@m8a/nestjs-typegoose is MIT licensed.