Common module

🧾 Description

This package contains some ready-made templates

👨🏻‍💻 Installation

$ npm install @discord-nestjs/common

Or via yarn

$ yarn add @discord-nestjs/common

📑 Overview

ℹ️ Pipes template

SlashCommandPipe fills in the fields DTO from CommandInteraction.

For prefix command use PrefixCommandPipe.

💡 Example

/* registration-email.dto.ts */

import {City} from '../definitions/city';
import {Param, ParamType, Choice} from '@discord-nestjs/core';

export class RegistrationEmailDto {
  @Param({
    name: 'email',
    description: 'Base user email',
    required: true,
  })
  email: string;

  @Param({description: 'User nickname', required: true})
  name: string;

  @Param({description: 'User age', required: true, type: ParamType.INTEGER})
  age: number;

  @Choice(City)
  @Param({description: 'City of residence', type: ParamType.INTEGER})
  city: City;
}

/* play.command.ts */

import { RegistrationDto } from './registration.dto';
import { Command, IA } from '@discord-nestjs/core';
import { SlashCommandPipe } from '@discord-nestjs/common';
import { CommandInteraction } from 'discord.js';

@Command({
  name: 'reg',
  description: 'User registration',
})
export class BaseInfoCommand
{
  handler(@IA(SlashCommandPipe) dto: RegistrationEmailDto): string {
    // dto instance must have the following fields: email, name, age, city
  }
}

ValidationPipe validate the resulting DTO based on class-validator. If the DTO is invalid then an exception will be thrown, which can be caught by the filter from the package @discord-nestjs/core.

Also, suitable for prefix commands.

for validation, you need to install package class-validator

💡 Example

/* registration-email.dto.ts */

import {Param, ParamType} from '@discord-nestjs/core';
import {IsEmail, Length, Max, Min} from 'class-validator';

export class RegistrationEmailDto {
  @IsEmail()
  @Param({
    name: 'email',
    description: 'Base user email',
    required: true,
  })
  email: string;

  @Param({description: 'User nickname', required: true})
  @Length(3, 100)
  name: string;

  @Param({description: 'User age', required: true, type: ParamType.INTEGER})
  @Max(150)
  @Min(18)
  age: number;
}

/* play.command.ts */

import {RegistrationDto} from './registration.dto';
import {Command, IA} from '@discord-nestjs/core';
import {SlashCommandPipe, ValidationPipe, UsePipes} from '@discord-nestjs/common';
import {CommandInteraction} from 'discord.js';

@Command({
  name: 'reg',
  description: 'User registration',
})
@UsePipes(SlashCommandPipe, ValidationPipe)
export class BaseInfoCommand {
  handler(@IA() dto: RegistrationEmailDto): string {
    // dto instance must be valid
  }
}

ℹ️ Mapped types

Intersection type allows you to infer a new type

💡 Example

import { Param } from '@discord-nestjs/core';

class FullName {
  @Param({
    description: 'Your full name'
  })
  name: string;
}

import { Param } from '@discord-nestjs/core';

class ResidencePlace {
  @Param({
    description: 'City of residence'
  })
  city: string;

  @Param({
    description: 'The street where your house is located'
  })
  street: string;
}

import { DiscordIntersectionType } from '@discord-nestjs/common';

// Must have properties name, city and street
class Profile extends DiscordIntersectionType(FullName, ResidencePlace) {
}