\n\n\n## 📚 Table of Contents\n- [Description](#-description)\n- [Features](#-features)\n- [Installation](#-installation)\n- [Usage](#-usage)\n- [Roadmap](#-roadmap)\n- [FAQ](#-faq)\n- [License](#-license)\n\n\n## 📖 Description\nESLint-Plugin-NestJS-Typed is a specialized ESLint plugin designed to enhance the development experience in NestJS applications by providing strict type checking and enforcing best practices. It helps catch common mistakes, ensures consistent API documentation, and maintains code quality across your NestJS projects. The plugin is particularly useful for teams working on large-scale NestJS applications where type safety and consistent patterns are crucial.\n\n## 🚀 Features\n- ✨ **Comprehensive set of NestJS-specific ESLint rules**\n- ✨ **Strict type checking for Controllers and Injectable services**\n- ✨ **Automated validation of Swagger/OpenAPI documentation**\n- ✨ **Detection of missing injectable dependencies**\n- ✨ **Enforcement of consistent API documentation patterns**\n- ✨ **Validation of proper decorator usage**\n- ✨ **Array type checking and validation**\n- ✨ **Enum handling best practices**\n- ✨ **Guard implementation verification**\n- ✨ **Custom validation rules support**\n\n## 🛠 Installation\n```bash\n# Using npm\nnpm install --save-dev eslint-plugin-nestjs-typed\n\n# Using yarn\nyarn add -D eslint-plugin-nestjs-typed\n\n# Using pnpm\npnpm add -D eslint-plugin-nestjs-typed\n```\n\n## 💡 Usage\n## Basic Configuration\n\nAdd the plugin to your `.eslintrc.js`:\n\n```javascript\nmodule.exports = {\n plugins: ['@elsikora/nestjs-typed'],\n extends: [\n 'plugin:@elsikora/nestjs-typed/recommended'\n ]\n}\n```\n\n## Usage with TypeScript\n\nEnsure your `tsconfig.json` has the following options:\n\n```json\n{\n \"compilerOptions\": {\n \"experimentalDecorators\": true,\n \"emitDecoratorMetadata\": true\n }\n}\n```\n\n## Individual Rule Configuration\n\n```javascript\nmodule.exports = {\n rules: {\n '@elsikora/nestjs-typed/injectable-should-be-provided': ['error', {\n src: ['src/**/*.ts'],\n filterFromPaths: ['node_modules', '.test.', '.spec.']\n }],\n '@elsikora/nestjs-typed/api-method-should-specify-api-response': 'error',\n '@elsikora/nestjs-typed/controllers-should-supply-api-tags': 'error'\n }\n}\n```\n\n## Working with Swagger/OpenAPI\n\nExample of proper documentation:\n\n```typescript\n@ApiTags('Users')\n@Controller('users')\nexport class UsersController {\n @Get()\n @ApiOperation({ summary: 'Get all users' })\n @ApiOkResponse({ type: [UserDto] })\n async getUsers(): Promise {\n return this.usersService.findAll();\n }\n}\n```\n\n## Custom Validation Rules\n\n```typescript\nclass CreateUserDto {\n @ApiProperty()\n @IsString()\n @IsDefined()\n name: string;\n\n @ApiPropertyOptional()\n @IsOptional()\n @IsEmail()\n email?: string;\n}\n```\n\n## Advanced Guard Usage\n\n```typescript\n@Controller('protected')\n@UseGuards(AuthGuard())\nexport class ProtectedController {\n @Get()\n @ApiOperation({ summary: 'Protected endpoint' })\n @ApiOkResponse({ type: String })\n getProtectedData(): string {\n return 'Protected data';\n }\n}\n```\n\n## 🛣 Roadmap\n| Task / Feature | Status |\n|---------------|--------|\n| Future development plans include: | 🚧 In Progress |\n| - Support for custom decorators validation | 🚧 In Progress |\n| - Integration with more NestJS features | 🚧 In Progress |\n| - Additional rules for microservices architecture | 🚧 In Progress |\n| - Performance optimization for large codebases | 🚧 In Progress |\n| - Extended OpenAPI/Swagger validation rules | 🚧 In Progress |\n| - Custom rule creation helpers | 🚧 In Progress |\n| **Completed tasks from CHANGELOG:** | |\n| 989a57e: chore(ci): streamline release workflow | ✅ Done |\n| e9c5d16: chore(package): update publishConfig for provenance | ✅ Done |\n| 3c669e8: chore(project-setup): remove obsolete configuration and setup files | ✅ Done |\n\n## ❓ FAQ\n## Frequently Asked Questions\n\n**Q: Does this plugin work with NestJS v8 and v9?**\nA: Yes, the plugin is compatible with both NestJS v8 and v9.\n\n**Q: Can I use this with other ESLint plugins?**\nA: Yes, this plugin works well alongside other ESLint plugins and configurations.\n\n**Q: How does it handle custom decorators?**\nA: The plugin provides options to configure custom decorator validation through rule configuration.\n\n**Q: Will this plugin affect build performance?**\nA: The plugin is designed to be performant, but complex rules may add minimal overhead to the linting process.\n\n## 🔒 License\nThis project is licensed under **MIT License - Copyright (c) 2024 ElsiKora**.\n\n## 📋 Changelog\nSee [CHANGELOG.md](CHANGELOG.md) for details.\n","readmeFilename":"README.md"}
![\"project-logo\"](\"https://6jft62zmy9nx2oea.public.blob.vercel-storage.com/Untitled-1-aJXyIFQkIShtr42QWRvkpSx6b2YOJl.png\")
\n![\"ElsiKora\"](\"https://img.shields.io/badge/MADE%20BY%20ElsiKora-333333.svg?style=for-the-badge\"){kind=icon}
\n ![\"version\"](\"https://img.shields.io/badge/version-blue.svg?style=for-the-badge&logo=npm&logoColor=white\"){kind=icon}
![\"typescript\"](\"https://img.shields.io/badge/typescript-blue.svg?style=for-the-badge&logo=typescript&logoColor=white\"){kind=icon}
![\"eslint\"](\"https://img.shields.io/badge/eslint-purple.svg?style=for-the-badge&logo=eslint&logoColor=white\"){kind=icon}
![\"nestjs\"](\"https://img.shields.io/badge/nestjs-red.svg?style=for-the-badge&logo=nestjs&logoColor=white\"){kind=icon}
![\"license\"](\"https://img.shields.io/badge/license-green.svg?style=for-the-badge&logo=license&logoColor=white\"){kind=icon}
\n