README.md

fastify-multipart for Nest.js

This library adds decorators for Nest.js to support @fastify/multipart. The API is very similar to the official Nest.js Express file decorators.

Installation

NPM

$ npm install @blazity/nest-file-fastify @fastify/multipart

Yarn

$ yarn add @blazity/nest-file-fastify @fastify/multipart

and register multpart plugin in your Nest.js application

import fastyfyMultipart from '@fastify/multipart';

...

app.register(fastyfyMultipart);

Docs

Single file

import { FileInterceptor, UploadedFile, MemoryStorageFile } from '@blazity/nest-file-fastify';

@Post('upload')
@UseInterceptors(FileInterceptor('file'))
uploadFile(@UploadedFile() file: MemoryStorageFile) {
  console.log(file);
}

FileInterceptor arguments:

• fieldname: string - name of the field that holds a file

• options: optional object of type UploadOptions

Array of files

import { FilesInterceptor, UploadedFiles, MemoryStorageFile } from '@blazity/nest-file-fastify';

@Post('upload')
@UseInterceptors(FilesInterceptor('files'))
uploadFile(@UploadedFiles() files: MemoryStorageFile[]) {
  console.log(files);
}

FilesInterceptor arguments:

• fieldname: string - name of the field that holds files

• maxCount: optional number - maximum number of files to accept

• options: optional object of type UploadOptions

Multiple files

import { FileFieldsInterceptor, UploadedFiles, MemoryStorageFile } from '@blazity/nest-file-fastify';

@Post('upload')
@UseInterceptors(FileFieldsInterceptor([
  { name: 'avatar', maxCount: 1 },
  { name: 'background', maxCount: 1 },
]))
uploadFile(@UploadedFiles() files: { avatar?: MemoryStorageFile[], background?: MemoryStorageFile[] }) {
  console.log(files);
}

FileFieldsInterceptor arguments:

• uploadFields: object of type UploadField

• options: optional object of type UploadOptions

Any files

import { AnyFilesInterceptor, UploadedFiles, MemoryStorageFile } from '@blazity/nest-file-fastify';

@Post('upload')
@UseInterceptors(AnyFilesInterceptor()
uploadFile(@UploadedFiles() files: MemoryStorageFile[]) {
  console.log(files);
}

AnyFilesInterceptor arguments:

• options: optional object of type UploadOptions