eslint-nestjs-apiresponse
TypeScript icon, indicating that this package has built-in type declarations

1.2.0 • Public • Published

eslint-nestjs-apiresponse

A simple ESLint plugin that enforces the use of HttpStatus enum from @nestjs/common in NestJS applications.

Features

  • Enforces the use of HttpStatus enum instead of numeric literals
  • Works with both @ApiResponse decorators and returned response objects
  • Automatically adds HttpStatus import when missing
  • Includes autofix functionality
  • Full TypeScript support out of the box

Installation

npm install eslint-nestjs-apiresponse --save-dev

Usage

For ESLint 9+ (flat config), add to your eslint.config.js or eslint.config.mjs:

import nestjsApiResponse from "eslint-nestjs-apiresponse";

export default [
  {
    plugins: {
      "eslint-nestjs-apiresponse": nestjsApiResponse
    },
    rules: {
      "eslint-nestjs-apiresponse/require-http-status": "error"
    }
  }
];

For ESLint 8 and below (.eslintrc):

{
  "plugins": ["eslint-nestjs-apiresponse"],
  "rules": {
    "eslint-nestjs-apiresponse/require-http-status": "error"
  }
}

Or use the recommended configuration:

{
  "extends": ["plugin:eslint-nestjs-apiresponse/recommended"]
}

Running from CLI

To run the plugin directly from command line:

# Check files
npx eslint --rule 'eslint-nestjs-apiresponse/require-http-status: error' src/

# With auto-fix
npx eslint --rule 'eslint-nestjs-apiresponse/require-http-status: error' --fix src/

Examples

❌ Incorrect:

// In decorators
@ApiResponse({ status: 200, description: 'Success' })

// In response objects
return { status: 200, data: result };

✅ Correct:

import { HttpStatus } from '@nestjs/common';

// In decorators
@ApiResponse({ status: HttpStatus.OK, description: 'Success' })

// In response objects
return { status: HttpStatus.OK, data: result };

TypeScript Support

The plugin includes TypeScript type definitions out of the box. No additional @types packages are required. Just install and use - TypeScript will automatically pick up the type definitions.

Requirements

  • Node.js >=14.0.0
  • ESLint >=9.0.0 (for flat config) or >=7.0.0 (for legacy config)
  • @nestjs/common >=8.0.0
  • @nestjs/swagger >=5.0.0

Authors

  • Cline (Senior TypeScript Developer)
  • 1MaJKeL1 (Project Supervisor)

License

ISC

Package Sidebar

Install

npm i eslint-nestjs-apiresponse

Weekly Downloads

21

Version

1.2.0

License

ISC

Unpacked Size

90.1 kB

Total Files

6

Last publish

Collaborators

  • majkel