@ackplus/nest-seeder 1.1.12 → 1.1.15-beta.3

package/README.md

@@ -1,110 +1,84 @@
 # @ackplus/nest-seeder
 
-<p align="center">
-  <a href="http://nestjs.com/" target="blank"><img src="https://nestjs.com/img/logo-small.svg" width="120" alt="Nest Logo" /></a>
-</p>
-
 A powerful and flexible database seeding library for NestJS applications with support for factories, data generation using Faker.js, and CLI commands.
 
-## 📋 Table of Contents
-
-- [Features](#-features)
-- [Installation](#-installation)
-- [Quick Start](#-quick-start)
-- [Configuration](#-configuration)
-  - [Basic Setup](#basic-setup)
-  - [Async Configuration](#async-configuration)
-- [Creating Seeders](#-creating-seeders)
-  - [Basic Seeder](#basic-seeder)
-  - [Using TypeORM](#using-typeorm)
-  - [Using Mongoose](#using-mongoose)
-  - [Using Prisma](#using-prisma)
-- [Data Factories](#-data-factories)
-  - [Basic Factory](#basic-factory)
-  - [Factory with Dependencies](#factory-with-dependencies)
-  - [Custom Generators](#custom-generators)
-- [CLI Usage](#-cli-usage)
-  - [Setup CLI](#setup-cli)
-  - [CLI Commands](#cli-commands)
-  - [Configuration File](#configuration-file)
-- [Programmatic Usage](#-programmatic-usage)
-- [Advanced Examples](#-advanced-examples)
-- [API Reference](#-api-reference)
-- [Publishing](#-publishing)
-
 ## ✨ Features
 
-- 🎯 **Type-safe** - Full TypeScript support
-- 🏭 **Factory Pattern** - Generate fake data easily with decorators
-- 🎲 **Faker.js Integration** - Built-in support for realistic fake data
-- 🔄 **Refresh Mode** - Drop existing data before seeding
+- 🌱 **CLI-Based** - Simple command-line interface, no app code modifications needed
+- 🏭 **Factory Pattern** - Generate realistic test data with Faker.js
+- 🔄 **Multiple ORMs** - Support for TypeORM, Mongoose, and Prisma
+- 📦 **Batch Operations** - Efficient bulk data insertion
 - 🎯 **Selective Seeding** - Run specific seeders by name
-- 📦 **Multiple ORMs** - Works with TypeORM, Mongoose, Prisma, and more
-- 🖥️ **CLI Support** - Run seeders from command line
-- ⚙️ **Flexible Configuration** - Sync and async configuration options
-- 🔗 **Dependency Management** - Handle relationships between seeders
+- 🔥 **Refresh Mode** - Drop existing data before seeding
+- 🧪 **Test-Friendly** - Perfect for testing and development
+- 📝 **TypeScript** - Full TypeScript support with type safety
 
 ## 📦 Installation
 
 ```bash
-# Using npm
 npm install @ackplus/nest-seeder @faker-js/faker
-
-# Using yarn
-yarn add @ackplus/nest-seeder @faker-js/faker
-
-# Using pnpm
+# or
 pnpm add @ackplus/nest-seeder @faker-js/faker
+# or
+yarn add @ackplus/nest-seeder @faker-js/faker
 ```
 
-### Development Dependencies
+**For TypeScript config files**, also install:
 
 ```bash
-# If using TypeScript files for seeders (recommended)
 npm install -D ts-node typescript
-
-# If using CLI
-npm install -D @nestjs/cli
 ```
 
-## 🚀 Quick Start
+## 🚀 Quick Start (5 Steps)
+
+### Step 1: Create Entity
+
+```typescript
+// src/entities/user.entity.ts
+import { Entity, PrimaryGeneratedColumn, Column } from 'typeorm';
+
+@Entity('users')
+export class User {
+  @PrimaryGeneratedColumn()
+  id: number;
 
-### 1. Create a Factory Class
+  @Column()
+  name: string;
 
-Create a factory class with the `@Factory` decorator to define how to generate fake data:
+  @Column({ unique: true })
+  email: string;
+
+  @Column()
+  role: string;
+}
+```
+
+### Step 2: Create Factory
 
 ```typescript
-// src/database/factories/user.factory.ts
+// src/factories/user.factory.ts
 import { Factory } from '@ackplus/nest-seeder';
 
 export class UserFactory {
+  @Factory((faker) => faker.person.fullName())
+  name: string;
+
   @Factory((faker) => faker.internet.email())
   email: string;
 
-  @Factory((faker) => faker.person.firstName())
-  firstName: string;
-
-  @Factory((faker) => faker.person.lastName())
-  lastName: string;
-
-  @Factory((faker) => faker.internet.password())
-  password: string;
-
-  @Factory((faker) => faker.datatype.boolean())
-  isActive: boolean;
+  @Factory((faker) => faker.helpers.arrayElement(['admin', 'user', 'guest']))
+  role: string;
 }
 ```
 
-### 2. Create a Seeder
-
-Create a seeder class that implements the `Seeder` interface:
+### Step 3: Create Seeder
 
 ```typescript
-// src/database/seeders/user.seeder.ts
+// src/seeders/user.seeder.ts
 import { Injectable } from '@nestjs/common';
 import { InjectRepository } from '@nestjs/typeorm';
 import { Repository } from 'typeorm';
-import { Seeder, SeederServiceOptions, DataFactory } from '@ackplus/nest-seeder';
+import { Seeder, DataFactory } from '@ackplus/nest-seeder';
 import { User } from '../entities/user.entity';
 import { UserFactory } from '../factories/user.factory';
 
@@ -115,282 +89,285 @@ export class UserSeeder implements Seeder {
     private readonly userRepository: Repository<User>,
   ) {}
 
-  async seed(options: SeederServiceOptions): Promise<void> {
-    // Generate 10 fake users
+  async seed(): Promise<void> {
+    // Create factory instance
     const factory = DataFactory.createForClass(UserFactory);
+
+    // Generate 10 users
     const users = factory.generate(10);
 
     // Save to database
     await this.userRepository.save(users);
+    
+    console.log('✅ Seeded 10 users');
   }
 
-  async drop(options: SeederServiceOptions): Promise<void> {
-    // Clean up - delete all users
+  async drop(): Promise<void> {
+    // Clear all users
     await this.userRepository.delete({});
+    
+    console.log('🗑️  Dropped all users');
   }
 }
 ```
 
-### 3. Register Seeder Module
+### Step 4: Create Configuration File
+
+Create `seeder.config.ts` in your **project root**:
+
+> **Note:** The seeder configuration is independent and does not require importing your main `AppModule`.
 
 ```typescript
-// src/app.module.ts
-import { Module } from '@nestjs/common';
+// seeder.config.ts
 import { TypeOrmModule } from '@nestjs/typeorm';
-import { SeederModule } from '@ackplus/nest-seeder';
-import { User } from './database/entities/user.entity';
-import { UserSeeder } from './database/seeders/user.seeder';
+import { ConfigModule, ConfigService } from '@nestjs/config';
+import { User } from './src/entities/user.entity';
+import { UserSeeder } from './src/seeders/user.seeder';
+import * as dotenv from 'dotenv';
+
+dotenv.config();
 
-@Module({
+export default {
   imports: [
-    TypeOrmModule.forRoot({
-      type: 'postgres',
-      host: 'localhost',
-      port: 5432,
-      username: 'postgres',
-      password: 'postgres',
-      database: 'mydb',
-      entities: [User],
-      synchronize: true,
+    ConfigModule.forRoot({
+      isGlobal: true,
     }),
-    TypeOrmModule.forFeature([User]),
-    SeederModule.register({
-      seeders: [UserSeeder],
+    TypeOrmModule.forRootAsync({
+      imports: [ConfigModule],
+      inject: [ConfigService],
+      useFactory: (config: ConfigService) => ({
+        type: 'postgres',
+        host: config.get<string>('DB_HOST'),
+        port: config.get<number>('DB_PORT'),
+        username: config.get<string>('DB_USERNAME'),
+        password: config.get<string>('DB_PASSWORD'),
+        database: config.get<string>('DB_DATABASE'),
+        entities: [User],
+        synchronize: true,
+      }),
     }),
+    TypeOrmModule.forFeature([User]),
   ],
-})
-export class AppModule {}
+  seeders: [UserSeeder],
+};
 ```
 
-### 4. Run the Seeder
+### Step 5: Run Seeder
 
-```typescript
-// src/seed.ts
-import { NestFactory } from '@nestjs/core';
-import { SeederService } from '@ackplus/nest-seeder';
-import { AppModule } from './app.module';
-
-async function bootstrap() {
-  const app = await NestFactory.createApplicationContext(AppModule);
-  const seeder = app.get(SeederService);
-  
-  await seeder.run();
-  
-  await app.close();
-}
+Add script to `package.json`:
 
-bootstrap();
+```json
+{
+  "scripts": {
+    "seed": "node -r ts-node/register -r tsconfig-paths/register ./node_modules/@ackplus/nest-seeder/dist/cli.js -c ./seeder.config.ts"
+  }
+}
 ```
 
 Run it:
+
 ```bash
-ts-node src/seed.ts
+npm run seed
 ```
 
-## ⚙️ Configuration
+**That's it!** Your database is now seeded! 🎉
 
-### Basic Setup
+## 🖥️ CLI Commands
 
-Register the `SeederModule` with your seeders:
+Since you are running the seeder via a package script, you can pass arguments using `--`.
 
-```typescript
-import { SeederModule } from '@ackplus/nest-seeder';
+### Basic Usage
 
-@Module({
-  imports: [
-    SeederModule.register({
-      seeders: [UserSeeder, PostSeeder, CommentSeeder],
-      imports: [TypeOrmModule.forFeature([User, Post, Comment])],
-      providers: [/* additional providers */],
-    }),
-  ],
-})
-export class AppModule {}
+```bash
+# Run all seeders
+npm run seed
+
+# Drop and reseed
+npm run seed -- --refresh
+
+# Run specific seeder
+npm run seed -- --name UserSeeder
+
+# Run multiple seeders
+npm run seed -- --name UserSeeder ProductSeeder
 ```
 
-### Async Configuration
+### Available Options
 
-For dynamic configuration (e.g., loading from ConfigService):
+| Option | Alias | Description | Default |
+|--------|-------|-------------|---------|
+| `--config` | `-c` | Path to configuration file | (required) |
+| `--refresh` | `-r` | Drop data before seeding | `false` |
+| `--name` | `-n` | Run specific seeder(s) | (all) |
+| `--dummyData` | `-d` | Include dummy data flag | `false` |
+| `--help` | `-h` | Show help | |
 
-#### Using Factory
+### Package.json Scripts
+
+You can also define specific scripts for convenience:
+
+```json
+{
+  "scripts": {
+    "seed": "node -r ts-node/register -r tsconfig-paths/register ./node_modules/@ackplus/nest-seeder/dist/cli.js -c ./seeder.config.ts",
+    "seed:refresh": "npm run seed -- --refresh",
+    "seed:users": "npm run seed -- --name UserSeeder",
+    "seed:watch": "nodemon --watch src/seeders --ext ts --exec \"npm run seed\""
+  }
+}
+```
+
+## ⚙️ Configuration
+
+### TypeORM Example
 
 ```typescript
-import { SeederModule } from '@ackplus/nest-seeder';
-import { ConfigModule, ConfigService } from '@nestjs/config';
+// seeder.config.ts
+import { TypeOrmModule } from '@nestjs/typeorm';
+import { User, Post, Comment } from './src/entities';
+import { UserSeeder, PostSeeder, CommentSeeder } from './src/seeders';
 
-@Module({
+export default {
   imports: [
-    SeederModule.forRootAsync({
-      imports: [ConfigModule, TypeOrmModule.forFeature([User, Post])],
-      inject: [UserSeeder, PostSeeder],
-      useFactory: async (config: ConfigService) => ({
-        seeders: [UserSeeder, PostSeeder],
-        refresh: config.get('SEED_REFRESH', false),
-        dummyData: config.get('SEED_DUMMY_DATA', false),
-      }),
-      isGlobal: true,
+    TypeOrmModule.forRoot({
+      type: 'postgres',
+      host: process.env.DB_HOST || 'localhost',
+      port: parseInt(process.env.DB_PORT) || 5432,
+      username: process.env.DB_USER || 'postgres',
+      password: process.env.DB_PASSWORD || 'postgres',
+      database: process.env.DB_NAME || 'mydb',
+      entities: [User, Post, Comment],
+      synchronize: true,
     }),
+    TypeOrmModule.forFeature([User, Post, Comment]),
   ],
-})
-export class AppModule {}
+  seeders: [UserSeeder, PostSeeder, CommentSeeder],
+};
 ```
 
-#### Using Class
+### MongoDB/Mongoose Example
 
 ```typescript
-import { Injectable } from '@nestjs/common';
-import { SeederOptionsFactory, SeederModuleOptions } from '@ackplus/nest-seeder';
-import { ConfigService } from '@nestjs/config';
+// seeder.config.ts
+import { MongooseModule } from '@nestjs/mongoose';
+import { User, UserSchema } from './src/schemas/user.schema';
+import { UserSeeder } from './src/seeders/user.seeder';
 
-@Injectable()
-export class SeederConfigService implements SeederOptionsFactory {
-  constructor(private configService: ConfigService) {}
-
-  createSeederOptions(): SeederModuleOptions {
-    return {
-      seeders: [UserSeeder, PostSeeder],
-      refresh: this.configService.get('SEED_REFRESH', false),
-    };
-  }
-}
+export default {
+  imports: [
+    MongooseModule.forRoot('mongodb://localhost/mydb'),
+    MongooseModule.forFeature([
+      { name: User.name, schema: UserSchema }
+    ]),
+  ],
+  seeders: [UserSeeder],
+};
+```
+
+### SQLite Example
+
+```typescript
+// seeder.config.ts
+import { TypeOrmModule } from '@nestjs/typeorm';
+import { User } from './src/entities/user.entity';
+import { UserSeeder } from './src/seeders/user.seeder';
 
-@Module({
+export default {
   imports: [
-    SeederModule.forRootAsync({
-      imports: [ConfigModule],
-      useClass: SeederConfigService,
-      isGlobal: true,
+    TypeOrmModule.forRoot({
+      type: 'sqlite',
+      database: 'database.sqlite',
+      entities: [User],
+      synchronize: true,
     }),
+    TypeOrmModule.forFeature([User]),
   ],
-})
-export class AppModule {}
+  seeders: [UserSeeder],
+};
 ```
 
-## 🌱 Creating Seeders
-
-### Basic Seeder
+## 🏭 Factories
 
-Every seeder must implement the `Seeder` interface with `seed()` and `drop()` methods:
+### Basic Factory
 
 ```typescript
-import { Injectable } from '@nestjs/common';
-import { Seeder, SeederServiceOptions } from '@ackplus/nest-seeder';
+import { Factory } from '@ackplus/nest-seeder';
 
-@Injectable()
-export class BasicSeeder implements Seeder {
-  async seed(options: SeederServiceOptions): Promise<void> {
-    console.log('Seeding data...');
-    // Your seeding logic here
-  }
+export class UserFactory {
+  @Factory((faker) => faker.person.fullName())
+  name: string;
 
-  async drop(options: SeederServiceOptions): Promise<void> {
-    console.log('Dropping data...');
-    // Your cleanup logic here
-  }
+  @Factory((faker) => faker.internet.email())
+  email: string;
+
+  @Factory((faker) => faker.datatype.number({ min: 18, max: 80 }))
+  age: number;
 }
 ```
 
-### Using TypeORM
+### Using Factory
 
 ```typescript
-import { Injectable } from '@nestjs/common';
-import { InjectRepository } from '@nestjs/typeorm';
-import { Repository } from 'typeorm';
-import { Seeder, SeederServiceOptions, DataFactory } from '@ackplus/nest-seeder';
-import { User } from '../entities/user.entity';
-import { UserFactory } from '../factories/user.factory';
-
-@Injectable()
-export class UserSeeder implements Seeder {
-  constructor(
-    @InjectRepository(User)
-    private readonly userRepository: Repository<User>,
-  ) {}
+import { DataFactory } from '@ackplus/nest-seeder';
+import { UserFactory } from './user.factory';
 
-  async seed(options: SeederServiceOptions): Promise<void> {
-    const factory = DataFactory.createForClass(UserFactory);
-    
-    // Generate different amounts based on options
-    const count = options.dummyData ? 100 : 10;
-    const users = factory.generate(count);
+// Create factory
+const factory = DataFactory.createForClass(UserFactory);
 
-    // Insert in batches for better performance
-    const batchSize = 50;
-    for (let i = 0; i < users.length; i += batchSize) {
-      const batch = users.slice(i, i + batchSize);
-      await this.userRepository.save(batch);
-    }
+// Generate one object
+const user = factory.generate(1)[0];
 
-    console.log(`✅ Seeded ${users.length} users`);
-  }
+// Generate multiple objects
+const users = factory.generate(10);
 
-  async drop(options: SeederServiceOptions): Promise<void> {
-    await this.userRepository.delete({});
-    console.log('✅ Dropped all users');
-  }
-}
+// Generate with overrides
+const admin = factory.generate(1, { role: 'admin' })[0];
 ```
 
-### Using Mongoose
+### Factory with Relationships
 
 ```typescript
-import { Injectable } from '@nestjs/common';
-import { InjectModel } from '@nestjs/mongoose';
-import { Model } from 'mongoose';
-import { Seeder, SeederServiceOptions, DataFactory } from '@ackplus/nest-seeder';
-import { User, UserDocument } from '../schemas/user.schema';
-import { UserFactory } from '../factories/user.factory';
-
-@Injectable()
-export class UserSeeder implements Seeder {
-  constructor(
-    @InjectModel(User.name)
-    private userModel: Model<UserDocument>,
-  ) {}
+import { Factory } from '@ackplus/nest-seeder';
 
-  async seed(options: SeederServiceOptions): Promise<void> {
-    const factory = DataFactory.createForClass(UserFactory);
-    const users = factory.generate(10);
+export class PostFactory {
+  @Factory((faker) => faker.lorem.sentence())
+  title: string;
 
-    await this.userModel.insertMany(users);
-    console.log('✅ Seeded 10 users');
-  }
+  @Factory((faker) => faker.lorem.paragraphs(3))
+  content: string;
 
-  async drop(options: SeederServiceOptions): Promise<void> {
-    await this.userModel.deleteMany({});
-    console.log('✅ Dropped all users');
-  }
+  // Will be set manually in seeder
+  authorId: number;
 }
 ```
 
-### Using Prisma
+## 🌱 Seeders
+
+### Basic Seeder
 
 ```typescript
 import { Injectable } from '@nestjs/common';
-import { Seeder, SeederServiceOptions, DataFactory } from '@ackplus/nest-seeder';
-import { PrismaService } from '../prisma.service';
+import { InjectRepository } from '@nestjs/typeorm';
+import { Repository } from 'typeorm';
+import { Seeder, DataFactory } from '@ackplus/nest-seeder';
+import { User } from '../entities/user.entity';
 import { UserFactory } from '../factories/user.factory';
 
 @Injectable()
 export class UserSeeder implements Seeder {
-  constructor(private readonly prisma: PrismaService) {}
+  constructor(
+    @InjectRepository(User)
+    private readonly userRepository: Repository<User>,
+  ) {}
 
-  async seed(options: SeederServiceOptions): Promise<void> {
+  async seed(): Promise<void> {
     const factory = DataFactory.createForClass(UserFactory);
     const users = factory.generate(10);
-
-    // Use createMany for better performance
-    await this.prisma.user.createMany({
-      data: users,
-      skipDuplicates: true,
-    });
-
-    console.log('✅ Seeded 10 users');
+    await this.userRepository.save(users);
   }
 
-  async drop(options: SeederServiceOptions): Promise<void> {
-    await this.prisma.user.deleteMany({});
-    console.log('✅ Dropped all users');
+  async drop(): Promise<void> {
+    await this.userRepository.delete({});
   }
 }
 ```
@@ -401,662 +378,228 @@ export class UserSeeder implements Seeder {
 import { Injectable } from '@nestjs/common';
 import { InjectRepository } from '@nestjs/typeorm';
 import { Repository } from 'typeorm';
-import { Seeder, SeederServiceOptions, DataFactory } from '@ackplus/nest-seeder';
-import { Post } from '../entities/post.entity';
+import { Seeder, DataFactory } from '@ackplus/nest-seeder';
 import { User } from '../entities/user.entity';
+import { Post } from '../entities/post.entity';
+import { UserFactory } from '../factories/user.factory';
 import { PostFactory } from '../factories/post.factory';
 
 @Injectable()
 export class PostSeeder implements Seeder {
   constructor(
-    @InjectRepository(Post)
-    private readonly postRepository: Repository<Post>,
     @InjectRepository(User)
     private readonly userRepository: Repository<User>,
+    @InjectRepository(Post)
+    private readonly postRepository: Repository<Post>,
   ) {}
 
-  async seed(options: SeederServiceOptions): Promise<void> {
+  async seed(): Promise<void> {
     // Get existing users
     const users = await this.userRepository.find();
     
     if (users.length === 0) {
-      console.warn('⚠️  No users found. Please run UserSeeder first.');
+      console.log('⚠️  No users found. Run UserSeeder first.');
       return;
     }
 
-    const factory = DataFactory.createForClass(PostFactory);
+    // Create posts for each user
+    const postFactory = DataFactory.createForClass(PostFactory);
     
-    // Generate 5 posts per user
     for (const user of users) {
-      const posts = factory.generate(5, {
-        authorId: user.id,
-      });
+      // Generate 3 posts per user
+      const posts = postFactory.generate(3).map(post => ({
+        ...post,
+        author: user,
+      }));
+      
       await this.postRepository.save(posts);
     }
-
-    console.log(`✅ Seeded ${users.length * 5} posts`);
+    
+    console.log(`✅ Seeded ${users.length * 3} posts`);
   }
 
-  async drop(options: SeederServiceOptions): Promise<void> {
+  async drop(): Promise<void> {
     await this.postRepository.delete({});
-    console.log('✅ Dropped all posts');
   }
 }
 ```
 
-## 🏭 Data Factories
-
-### Basic Factory
-
-Use the `@Factory` decorator to define how each property should be generated:
-
-```typescript
-import { Factory } from '@ackplus/nest-seeder';
-
-export class UserFactory {
-  @Factory((faker) => faker.internet.email())
-  email: string;
-
-  @Factory((faker) => faker.person.firstName())
-  firstName: string;
-
-  @Factory((faker) => faker.person.lastName())
-  lastName: string;
-
-  @Factory((faker) => faker.internet.password({ length: 10 }))
-  password: string;
-
-  @Factory((faker) => faker.datatype.boolean())
-  isActive: boolean;
-
-  @Factory((faker) => faker.date.past())
-  createdAt: Date;
-}
-```
-
-### Static Values
-
-You can also provide static values instead of generators:
-
-```typescript
-export class AdminFactory {
-  @Factory('admin')
-  role: string;
-
-  @Factory(true)
-  isActive: boolean;
-
-  @Factory((faker) => faker.internet.email())
-  email: string;
-}
-```
-
-### Factory with Dependencies
-
-Use the second parameter to specify dependencies between properties:
+### Conditional Seeding
 
 ```typescript
-export class UserFactory {
-  @Factory((faker) => faker.person.firstName())
-  firstName: string;
-
-  @Factory((faker) => faker.person.lastName())
-  lastName: string;
+import { Injectable } from '@nestjs/common';
+import { Seeder, SeederServiceOptions, DataFactory } from '@ackplus/nest-seeder';
 
-  // This field depends on firstName and lastName
-  @Factory((faker, ctx) => {
-    return `${ctx.firstName}.${ctx.lastName}@example.com`.toLowerCase();
-  }, ['firstName', 'lastName'])
-  email: string;
+@Injectable()
+export class UserSeeder implements Seeder {
+  async seed(options?: SeederServiceOptions): Promise<void> {
+    const factory = DataFactory.createForClass(UserFactory);
+    
+    // Seed more data if dummyData flag is set
+    const count = options?.dummyData ? 100 : 10;
+    const users = factory.generate(count);
+    
+    await this.userRepository.save(users);
+    console.log(`✅ Seeded ${count} users`);
+  }
 
-  // This field depends on firstName and lastName
-  @Factory((faker, ctx) => {
-    return `${ctx.firstName} ${ctx.lastName}`;
-  }, ['firstName', 'lastName'])
-  fullName: string;
+  async drop(): Promise<void> {
+    await this.userRepository.delete({});
+  }
 }
 ```
 
-### Custom Generators
-
-Create complex data with custom generator functions:
-
-```typescript
-export class ProductFactory {
-  @Factory((faker) => faker.commerce.productName())
-  name: string;
-
-  @Factory((faker) => faker.commerce.productDescription())
-  description: string;
-
-  @Factory((faker) => parseFloat(faker.commerce.price()))
-  price: number;
-
-  @Factory((faker) => faker.number.int({ min: 0, max: 1000 }))
-  stock: number;
-
-  @Factory((faker) => faker.helpers.arrayElement(['electronics', 'clothing', 'food', 'books']))
-  category: string;
+Run with dummy data:
 
-  @Factory((faker) => {
-    return {
-      weight: faker.number.float({ min: 0.1, max: 100, precision: 0.1 }),
-      dimensions: {
-        width: faker.number.int({ min: 1, max: 100 }),
-        height: faker.number.int({ min: 1, max: 100 }),
-        depth: faker.number.int({ min: 1, max: 100 }),
-      },
-    };
-  })
-  metadata: object;
-
-  @Factory((faker) => faker.helpers.arrayElements(['red', 'blue', 'green', 'yellow'], { min: 1, max: 3 }))
-  colors: string[];
-}
+```bash
+nest-seed -c seeder.config.ts --dummyData
 ```
 
-### Using Factories
+### MongoDB/Mongoose Seeder
 
 ```typescript
-import { DataFactory } from '@ackplus/nest-seeder';
-import { UserFactory } from './user.factory';
-
-// Create a factory
-const factory = DataFactory.createForClass(UserFactory);
-
-// Generate single object
-const user = factory.generate(1)[0];
-
-// Generate multiple objects
-const users = factory.generate(10);
-
-// Generate with custom values (override factory defaults)
-const admins = factory.generate(5, {
-  role: 'admin',
-  isActive: true,
-});
-
-// Mix of factory-generated and custom values
-const users = factory.generate(3, {
-  isActive: true, // Override this field
-  // Other fields will be generated by factory
-});
-```
-
-## 🖥️ CLI Usage
-
-### Setup CLI
-
-#### 1. Install CLI dependencies
+import { Injectable } from '@nestjs/common';
+import { InjectModel } from '@nestjs/mongoose';
+import { Model } from 'mongoose';
+import { Seeder, DataFactory } from '@ackplus/nest-seeder';
+import { User } from '../schemas/user.schema';
+import { UserFactory } from '../factories/user.factory';
 
-```bash
-npm install -D ts-node typescript
-```
+@Injectable()
+export class UserSeeder implements Seeder {
+  constructor(
+    @InjectModel(User.name)
+    private readonly userModel: Model<User>,
+  ) {}
 
-#### 2. Add CLI script to package.json
+  async seed(): Promise<void> {
+    const factory = DataFactory.createForClass(UserFactory);
+    const users = factory.generate(10);
+    await this.userModel.insertMany(users);
+  }
 
-```json
-{
-  "scripts": {
-    "seed": "nest-seed -c ./src/database/seeder.config.ts",
-    "seed:refresh": "nest-seed -c ./src/database/seeder.config.ts --refresh",
-    "seed:user": "nest-seed -c ./src/database/seeder.config.ts --name UserSeeder"
+  async drop(): Promise<void> {
+    await this.userModel.deleteMany({});
   }
 }
 ```
 
-#### 3. Create a configuration file
-
-```typescript
-// src/database/seeder.config.ts
-import { TypeOrmModule } from '@nestjs/typeorm';
-import { User } from './entities/user.entity';
-import { Post } from './entities/post.entity';
-import { UserSeeder } from './seeders/user.seeder';
-import { PostSeeder } from './seeders/post.seeder';
-
-export default {
-  imports: [
-    TypeOrmModule.forRoot({
-      type: 'postgres',
-      host: 'localhost',
-      port: 5432,
-      username: 'postgres',
-      password: 'postgres',
-      database: 'mydb',
-      entities: [User, Post],
-      synchronize: true,
-    }),
-    TypeOrmModule.forFeature([User, Post]),
-  ],
-  seeders: [UserSeeder, PostSeeder],
-};
-```
-
-### CLI Commands
-
-#### Run all seeders
-
-```bash
-npm run seed
-# or
-nest-seed -c ./src/database/seeder.config.ts
-```
-
-#### Refresh mode (drop and reseed)
-
-```bash
-npm run seed:refresh
-# or
-nest-seed -c ./src/database/seeder.config.ts --refresh
-# or short form
-nest-seed -c ./src/database/seeder.config.ts -r
-```
-
-#### Run specific seeder(s)
-
-```bash
-# Single seeder
-nest-seed -c ./src/database/seeder.config.ts --name UserSeeder
-# or short form
-nest-seed -c ./src/database/seeder.config.ts -n UserSeeder
-
-# Multiple seeders
-nest-seed -c ./src/database/seeder.config.ts -n UserSeeder -n PostSeeder
-```
-
-#### With dummy data flag
-
-```bash
-nest-seed -c ./src/database/seeder.config.ts --dummyData
-# or short form
-nest-seed -c ./src/database/seeder.config.ts -d
-```
-
-#### Combined options
-
-```bash
-# Refresh and run specific seeder with dummy data
-nest-seed -c ./src/database/seeder.config.ts -r -n UserSeeder -d
-```
-
-### CLI Help
-
-```bash
-nest-seed --help
-```
-
-Output:
-```
-Options:
-  --help                Show help                                      [boolean]
-  --version             Show version number                            [boolean]
-  --config, -c          Path to seeder configuration file            [required]
-  --refresh, -r         Drop all data before seeding   [boolean] [default: false]
-  --name, -n            Specific seeder names to run                     [array]
-  --dummyData, -d       Include dummy data             [boolean] [default: false]
-
-Examples:
-  nest-seed -c ./seeder.config.ts                Run all seeders
-  nest-seed -c ./seeder.config.ts --refresh      Drop and reseed all data
-  nest-seed -c ./seeder.config.ts --name UserSeeder  Run specific seeder
-```
-
-### Configuration File
+## 🔥 Advanced Examples
 
-The configuration file should export a default object with the following structure:
+### Custom Providers in Config
 
 ```typescript
 // seeder.config.ts
-import { SeederModuleOptions } from '@ackplus/nest-seeder';
+import { CustomService } from './src/services/custom.service';
 
-const config: SeederModuleOptions = {
-  // Required: Array of seeder providers
-  seeders: [UserSeeder, PostSeeder, CommentSeeder],
-  
-  // Optional: Modules to import (e.g., TypeORM, Mongoose)
+export default {
   imports: [
     TypeOrmModule.forRoot({ /* ... */ }),
-    TypeOrmModule.forFeature([User, Post, Comment]),
+    TypeOrmModule.forFeature([User]),
   ],
-  
-  // Optional: Additional providers
-  providers: [PrismaService, CustomService],
+  seeders: [UserSeeder],
+  providers: [CustomService], // Inject custom services
 };
-
-export default config;
 ```
 
-## 📝 Programmatic Usage
-
-### Using Seeder Function
+### Environment-Based Configuration
 
 ```typescript
-// src/seed.ts
-import { seeder } from '@ackplus/nest-seeder';
-import { TypeOrmModule } from '@nestjs/typeorm';
-import { User } from './entities/user.entity';
-import { UserSeeder } from './seeders/user.seeder';
+// seeder.config.ts
+import * as dotenv from 'dotenv';
+dotenv.config();
+
+const isDev = process.env.NODE_ENV === 'development';
 
-seeder({
+export default {
   imports: [
     TypeOrmModule.forRoot({
       type: 'postgres',
-      host: 'localhost',
-      port: 5432,
-      username: 'postgres',
-      password: 'postgres',
-      database: 'mydb',
-      entities: [User],
-      synchronize: true,
+      host: process.env.DB_HOST,
+      database: isDev ? 'mydb_dev' : 'mydb_prod',
+      synchronize: isDev,
     }),
-    TypeOrmModule.forFeature([User]),
+    TypeOrmModule.forFeature([User, Post]),
   ],
-}).run({
-  seeders: [UserSeeder],
-});
-```
-
-Run with CLI arguments:
-```bash
-ts-node src/seed.ts --refresh
-ts-node src/seed.ts --name UserSeeder
-ts-node src/seed.ts -r -n UserSeeder -d
-```
-
-### Using SeederService Directly
-
-```typescript
-import { NestFactory } from '@nestjs/core';
-import { SeederService } from '@ackplus/nest-seeder';
-import { AppModule } from './app.module';
-
-async function seed() {
-  const app = await NestFactory.createApplicationContext(AppModule);
-  const seeder = app.get(SeederService);
-  
-  // Run all seeders
-  await seeder.run();
-  
-  // Or just seed (without drop)
-  await seeder.seed();
-  
-  // Or just drop
-  await seeder.drop();
-  
-  await app.close();
-}
-
-seed();
+  seeders: isDev 
+    ? [UserSeeder, PostSeeder, TestDataSeeder]
+    : [UserSeeder, PostSeeder],
+};
 ```
 
-## 🔥 Advanced Examples
-
-### Conditional Seeding
+### Batch Insert for Performance
 
 ```typescript
 @Injectable()
 export class UserSeeder implements Seeder {
-  constructor(
-    @InjectRepository(User)
-    private readonly userRepository: Repository<User>,
-  ) {}
-
-  async seed(options: SeederServiceOptions): Promise<void> {
-    // Check if data already exists
-    const count = await this.userRepository.count();
-    if (count > 0 && !options.refresh) {
-      console.log('⏭️  Users already exist, skipping...');
-      return;
-    }
-
+  async seed(): Promise<void> {
     const factory = DataFactory.createForClass(UserFactory);
+    const batchSize = 1000;
+    const totalRecords = 10000;
     
-    // Different amounts based on environment
-    const count = process.env.NODE_ENV === 'production' ? 10 : 100;
-    const users = factory.generate(count);
-
-    await this.userRepository.save(users);
-    console.log(`✅ Seeded ${users.length} users`);
-  }
-
-  async drop(options: SeederServiceOptions): Promise<void> {
-    await this.userRepository.delete({});
-  }
-}
-```
-
-### Seeding with External Data
-
-```typescript
-@Injectable()
-export class CountrySeeder implements Seeder {
-  async seed(options: SeederServiceOptions): Promise<void> {
-    const countries = [
-      { code: 'US', name: 'United States' },
-      { code: 'GB', name: 'United Kingdom' },
-      { code: 'CA', name: 'Canada' },
-      // ... more countries
-    ];
-
-    await this.countryRepository.save(countries);
-    console.log(`✅ Seeded ${countries.length} countries`);
-  }
-
-  async drop(options: SeederServiceOptions): Promise<void> {
-    await this.countryRepository.delete({});
-  }
-}
-```
-
-### Seeding from JSON File
-
-```typescript
-import * as fs from 'fs';
-import * as path from 'path';
-
-@Injectable()
-export class ProductSeeder implements Seeder {
-  async seed(options: SeederServiceOptions): Promise<void> {
-    const filePath = path.join(__dirname, '../data/products.json');
-    const data = JSON.parse(fs.readFileSync(filePath, 'utf8'));
-
-    await this.productRepository.save(data);
-    console.log(`✅ Seeded ${data.length} products from file`);
-  }
-
-  async drop(options: SeederServiceOptions): Promise<void> {
-    await this.productRepository.delete({});
-  }
-}
-```
-
-### Transaction Support
-
-```typescript
-@Injectable()
-export class UserSeeder implements Seeder {
-  constructor(
-    @InjectRepository(User)
-    private readonly userRepository: Repository<User>,
-    private readonly dataSource: DataSource,
-  ) {}
-
-  async seed(options: SeederServiceOptions): Promise<void> {
-    const queryRunner = this.dataSource.createQueryRunner();
-    await queryRunner.connect();
-    await queryRunner.startTransaction();
-
-    try {
-      const factory = DataFactory.createForClass(UserFactory);
-      const users = factory.generate(10);
-
-      await queryRunner.manager.save(users);
-      await queryRunner.commitTransaction();
-      
-      console.log('✅ Seeded 10 users');
-    } catch (error) {
-      await queryRunner.rollbackTransaction();
-      throw error;
-    } finally {
-      await queryRunner.release();
-    }
-  }
-
-  async drop(options: SeederServiceOptions): Promise<void> {
-    await this.userRepository.delete({});
-  }
-}
-```
-
-### Multi-tenant Seeding
-
-```typescript
-@Injectable()
-export class TenantSeeder implements Seeder {
-  constructor(
-    @InjectRepository(Tenant)
-    private readonly tenantRepository: Repository<Tenant>,
-    @InjectRepository(User)
-    private readonly userRepository: Repository<User>,
-  ) {}
-
-  async seed(options: SeederServiceOptions): Promise<void> {
-    const tenantFactory = DataFactory.createForClass(TenantFactory);
-    const tenants = tenantFactory.generate(5);
-    const savedTenants = await this.tenantRepository.save(tenants);
-
-    const userFactory = DataFactory.createForClass(UserFactory);
-    
-    // Create users for each tenant
-    for (const tenant of savedTenants) {
-      const users = userFactory.generate(10, {
-        tenantId: tenant.id,
-      });
+    for (let i = 0; i < totalRecords; i += batchSize) {
+      const users = factory.generate(batchSize);
       await this.userRepository.save(users);
+      console.log(`✅ Seeded ${Math.min(i + batchSize, totalRecords)}/${totalRecords} users`);
     }
-
-    console.log('✅ Seeded 5 tenants with 10 users each');
   }
 
-  async drop(options: SeederServiceOptions): Promise<void> {
+  async drop(): Promise<void> {
     await this.userRepository.delete({});
-    await this.tenantRepository.delete({});
   }
 }
 ```
 
 ## 📚 API Reference
 
-### SeederModule
-
-#### `SeederModule.register(options: SeederModuleOptions)`
-
-Synchronously register the seeder module.
-
-**Options:**
-- `seeders`: Array of seeder providers
-- `imports`: Modules to import
-- `providers`: Additional providers
-
-#### `SeederModule.forRootAsync(options: SeederModuleAsyncOptions)`
-
-Asynchronously register the seeder module.
-
-**Options:**
-- `useFactory`: Factory function for async configuration
-- `useClass`: Configuration class implementing `SeederOptionsFactory`
-- `useExisting`: Existing provider for configuration
-- `imports`: Modules to import
-- `inject`: Dependencies to inject
-- `isGlobal`: Make module global
-
-### Seeder Interface
-
-```typescript
-interface Seeder {
-  seed(options: SeederServiceOptions): Promise<any>;
-  drop(options: SeederServiceOptions): Promise<any>;
-}
-```
-
-### SeederServiceOptions
+### DataFactory
 
 ```typescript
-interface SeederServiceOptions {
-  name?: string | string[];  // Specific seeders to run
-  refresh?: boolean;         // Drop before seeding
-  dummyData?: boolean;       // Flag for conditional logic
+class DataFactory {
+  // Create factory for a class
+  static createForClass<T>(factoryClass: new () => T): DataFactory<T>
+  
+  // Generate instances
+  generate(count: number, override?: Partial<T>): T[]
 }
 ```
 
-### DataFactory
-
-#### `DataFactory.createForClass<T>(target: Type<T>): Factory`
-
-Create a factory for a class with `@Factory` decorators.
-
-**Returns:** Factory object with `generate()` method
+### Seeder Interface
 
 ```typescript
-interface Factory {
-  generate(count: number, values?: Record<string, any>): Array<Record<string, any>>;
+interface Seeder {
+  // Seed data into database
+  seed(options?: SeederServiceOptions): Promise<void>
+  
+  // Drop/clear data from database
+  drop(options?: SeederServiceOptions): Promise<void>
 }
 ```
 
 ### @Factory Decorator
 
 ```typescript
-@Factory(
-  generator: FactoryValueGenerator | FactoryValue,
-  dependsOn?: string[]
-)
-```
-
-**Parameters:**
-- `generator`: Function `(faker, ctx) => value` or static value
-- `dependsOn`: Array of property names this field depends on
+// Simple factory
+@Factory((faker) => faker.person.fullName())
+name: string;
 
-### SeederService
+// With options
+@Factory((faker) => faker.datatype.number({ min: 1, max: 100 }))
+age: number;
 
-#### Methods
-
-- `run()`: Execute seed or drop+seed based on options
-- `seed()`: Run seed method on all seeders
-- `drop()`: Run drop method on all seeders
-- `getSeederToRun()`: Get list of seeders to run based on options
-
-## 📦 Publishing
-
-This package uses automated GitHub Actions for publishing.
-
-### Using CLI Script
-
-```bash
-# Patch version (0.0.1 -> 0.0.2)
-npm run publish:patch
-
-# Minor version (0.0.1 -> 0.1.0)
-npm run publish:minor
-
-# Major version (0.0.1 -> 1.0.0)
-npm run publish:major
+// Array values
+@Factory((faker) => faker.helpers.arrayElement(['admin', 'user']))
+role: string;
 ```
 
-The script will:
-1. Update package version
-2. Create git tag
-3. Ask to push to remote (triggers GitHub Action)
-4. Commit version change
-
-### Manual Publishing
-
-```bash
-# Create and push a tag
-git tag v1.0.0
-git push origin v1.0.0
+### SeederServiceOptions
 
-# GitHub Action will automatically publish to npm
+```typescript
+interface SeederServiceOptions {
+  refresh?: boolean;      // Drop before seeding
+  name?: string[];        // Run specific seeders
+  dummyData?: boolean;    // Custom flag for your logic
+}
 ```
 
 ## 🤝 Contributing
@@ -1075,10 +618,10 @@ This project is licensed under the MIT License.
 
 ## 📮 Support
 
-If you have any questions or need help, please:
-- Open an issue on GitHub
-- Check existing documentation
-- Review examples in the repository
+If you have any questions or need help:
+- Open an issue on [GitHub](https://github.com/ackplus/nest-seeder/issues)
+- Check the [examples](./examples/) directory
+- Review the [Quick Start Guide](./QUICKSTART.md)
 
 ---