barrel-export-manager

Barrel Export Manager

Auto-creates and maintains index.ts barrel export files in NestJS modules for clean, maintainable imports.

Activation Triggers

This skill activates when:

• Creating new entity, DTO, service, controller, guard, decorator
• Adding files to module directories
• Organizing NestJS module structure
• Mentioning "NestJS", "module", "create"
• Importing from module directories

Required Pattern (MANDATORY)

Every NestJS module folder MUST have index.ts barrel exports:

users/
├── entities/
│   ├── user.entity.ts
│   ├── profile.entity.ts
│   └── index.ts          # ✅ Barrel export
├── dto/
│   ├── create-user.dto.ts
│   ├── update-user.dto.ts
│   └── index.ts          # ✅ Barrel export
├── services/
│   ├── users.service.ts
│   └── index.ts          # ✅ Barrel export
└── controllers/
    ├── users.controller.ts
    └── index.ts          # ✅ Barrel export

Auto-Management Process

Step 1: Detect New File

When user creates:

// users/entities/user.entity.ts
@Entity('users')
export class User {
  @PrimaryGeneratedColumn('uuid')
  id: string
  // ...
}

Step 2: Auto-Create/Update index.ts

Automatically create or update users/entities/index.ts:

// users/entities/index.ts
export * from './user.entity'
export * from './profile.entity'

Step 3: Verify Imports Use Barrel

Ensure other files import from barrel:

// ✅ CORRECT - Import from barrel
import { User, Profile } from 'src/users/entities'

// ❌ WRONG - Import from specific file
import { User } from 'src/users/entities/user.entity'

Step 4: Update on File Changes

When files are added/removed/renamed, automatically update the barrel export:

// User adds: organization.entity.ts
// Automatically update index.ts:
export * from './user.entity'
export * from './profile.entity'
export * from './organization.entity'  // ✅ Added automatically

Barrel Export Patterns

Entities Directory

// users/entities/index.ts
export * from './user.entity'
export * from './profile.entity'
export * from './organization.entity'

// Usage
import { User, Profile, Organization } from 'src/users/entities'