NestJS Quick Start

npm i -g @nestjs/cli

nest new project-name

​

Installing Required Packages

To begin, install the necessary packages in your NestJS project directory. You can choose one of the following package managers:

npm i @trigger.dev/sdk @trigger.dev/nestjs @nestjs/config

​

Obtaining the Development API Key

To locate your development API key, login to the Trigger.dev dashboard and select the Project you want to connect to. Then click on the Environments & API Keys tab in the left menu. You can copy your development API Key from the field at the top of this page. (Your development key will start with tr_dev_).

​

Adding Environment Variables

Create a .env file at the root of your project and include your Trigger API key and URL like this:

TRIGGER_API_KEY=ENTER_YOUR_DEVELOPMENT_API_KEY_HERE
TRIGGER_API_URL=https://api.trigger.dev # this line is only necessary if you are self-hosting Trigger

Replace ENTER_YOUR_DEVELOPMENT_API_KEY_HERE with the actual API key obtained from the previous step.

​

Adding TriggerDev Module

Open your app.module.ts, and add the following inside your imports:

import { TriggerDevModule } from "@trigger.dev/nestjs";
import { Module } from "@nestjs/common";

//you need to load the environment variables from .env, this is one way to do it
import "dotenv/config";

@Module({
  imports: [
    TriggerDevModule.register({
      id: "my-app",
      apiKey: process.env.TRIGGER_API_KEY,
      apiUrl: process.env.TRIGGER_API_URL,
    }),
    // if you use NestJS Config, you can do like this:
    // TriggerDevModule.registerAsync({
    //   useFactory: (configService: ConfigService) => ({
    //     id: 'my-app',
    //     apiKey: configService.get<string>("TRIGGER_API_KEY"),
    //     apiUrl: configService.get<string>("TRIGGER_API_URL"),
    //   }),
    //   inject: [ConfigService],
    // }),
  ],
})
export class AppModule {
  //...
}

Replace "my-app" with an appropriate identifier for your project. The apiKey and apiUrl are obtained from the environment variables you set earlier.

By following these steps, you'll configure the Trigger Client to work with your project.

​

Creating the Example Job

When you add TriggerDevModule to your project, you will can have access to the TriggerClient instance by using the @InjectTriggerDevClient() decorator in the constructor.

Now, let's create an example job to test the integration.

1. Create a controller named job.controller.ts alongside your app.module.ts
2. Inside that controller, add the following code:

import { Controller, Get } from "@nestjs/common";
import { InjectTriggerDevClient } from "@trigger.dev/nestjs";
import { eventTrigger, TriggerClient } from "@trigger.dev/sdk";

@Controller()
export class JobController {
  constructor(@InjectTriggerDevClient() private readonly client: TriggerClient) {
    this.client.defineJob({
      id: "test-job",
      name: "Test Job One",
      version: "0.0.1",
      trigger: eventTrigger({
        name: "test.event",
      }),
      run: async (payload, io, ctx) => {
        await io.logger.info("Hello world!", { payload });

        return {
          message: "Hello world!",
        };
      },
    });
  }

  @Get()
  getHello(): string {
    return `Running Trigger.dev with client-id ${this.client.id}`;
  }
}

​

Adding Configuration to package.json

Inside the package.json file, add the following configuration under the root object:

"trigger.dev": {
  "endpointId": "my-app"
}

Your package.json file might look something like this:

{
  "name": "my-app",
  "version": "1.0.0",
  "dependencies": {
    // ... other dependencies
  },
  "trigger.dev": {
    "endpointId": "my-app"
  }
}

Replace "my-app" with the appropriate identifier you used during the step for creating the Trigger Client.

​

Running

​

Run your NestJS app

Run your NestJS app locally, like you normally would. For example:

npm run start

​

Run the CLI 'dev' command

In a separate terminal window or tab run:

npx @trigger.dev/cli@latest dev