एक module भनेको @Module() decorator सहितको एक class हो जसले सम्बन्धित components — controllers, providers/services — लाई एक coherent unit मा समूहबद्ध गर्छ। Modules हरु कसरी NestJS ले एक application लाई features मा organize गर्छ, र प्रत्येक Nest app को कम्तीमा एक root AppModule हुन्छ।
import { Module } from "@nestjs/common";
@Module({
controllers: [UsersController], // controllers belonging to this module
providers: [UsersService], // providers (services) this module creates
imports: [DatabaseModule], // OTHER modules whose exports this module needs
exports: [UsersService], // what this module makes available to importers
})
export class UsersModule {}
controllers → the controllers (request handlers) in this module
providers → the providers/services defined and instantiated here (for DI)
imports → other modules whose EXPORTED providers this module can use
exports → the subset of THIS module's providers shared with importing modules
Modules एक DI scope बनाउँछन्: एक provider यसको module भित्र उपलब्ध हुन्छ, र अन्य modules लाई केवल exported हले (र अन्य module ले यसलाई import गरे)।
@Module({
imports: [UsersModule, AuthModule, DatabaseModule], // compose feature modules
})
export class AppModule {} // the root — bootstrapped to start the app
प्रत्येक app को एक root AppModule हुन्छ जो feature modules लाई import गर्छ, पूरै application लाई compose गर्दै।
src/
app.module.ts (root — imports feature modules)
users/
users.module.ts (groups users controller + service)
users.controller.ts
users.service.ts
auth/
auth.module.ts
database/
database.module.ts (shared infrastructure)
कन्भेन्सन भनेको एक module प्रति feature/domain (users, auth, products), सम्बन्धित code लाई सँगै राख्दै र dependencies स्पष्ट राख्दै।
// UsersModule exports UsersService...
@Module({ providers: [UsersService], exports: [UsersService] })
export class UsersModule {}
// ...so AuthModule can use it by importing UsersModule
@Module({ imports: [UsersModule] }) // now AuthModule can inject UsersService
export class AuthModule {}
अर्को module बाट एक provider प्रयोग गर्न, providing module ले यसलाई export गर्नुपर्छ र consuming module ले providing module लाई import गर्नुपर्छ — dependencies लाई स्पष्ट बनाउँदै।
Modules हरु प्रत्येक NestJS application को संगठनात्मक मेरुदण्ड हुन् — तिनीहरु controllers र providers लाई cohesive feature units मा समूहबद्ध गर्छन् र dependency-injection boundaries परिभाषित गर्छन्।
चार properties (controllers, providers, imports, exports) बुझ्नु र विशेष गरी modules मा providers साझा गर्नको लागि import/export mechanism बुझ्नु आवश्यक छ: यो कसरी NestJS ले modular, loosely-coupled architecture हासिल गर्छ जहाँ प्रत्येक feature आत्म-समावेशी छ र dependencies स्पष्ट छन्।
Feature-based module structure (एक module प्रति domain) Nest apps लाई scalability र maintainability को लागि organize गर्नको मानक तरिका हो।
Modules, controllers र providers सँगै, NestJS को core architecture बनाउँछन्, तिनीहरुलाई मौलिक ज्ञान बनाउँदै — कसरी एक app लाई modules मा structure गर्ने र import/exports मार्फत providers लाई wire गर्ने बुझ्नु कुनै पनि non-trivial NestJS application बनाउन आवश्यक छ र यो confusion को एक बारम्बार बिन्दु हो जसलाई राम्रोसँग बुझ्नु महत्त्वपूर्ण छ।