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

package/QUICKSTART.md

@@ -1,45 +1,62 @@
-# Quick Start Guide - @ackplus/nest-seeder
+# ⚡ Quick Start - 5 Minutes to Seeding!
 
-Get started with nest-seeder in 5 minutes!
+Get started with `@ackplus/nest-seeder` in just 5 simple steps.
 
-## 📦 Step 1: Installation
+## 📦 Installation
 
 ```bash
 npm install @ackplus/nest-seeder @faker-js/faker
 npm install -D ts-node typescript
 ```
 
-## 🏭 Step 2: Create a Factory
+## Step 1: Create an Entity
 
-Create a file `src/database/factories/user.factory.ts`:
+```typescript
+// src/entities/user.entity.ts
+import { Entity, PrimaryGeneratedColumn, Column } from 'typeorm';
+
+@Entity('users')
+export class User {
+  @PrimaryGeneratedColumn()
+  id: number;
+
+  @Column()
+  name: string;
+
+  @Column({ unique: true })
+  email: string;
+
+  @Column({ default: 'user' })
+  role: string;
+}
+```
+
+## Step 2: Create a Factory
 
 ```typescript
+// 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.helpers.arrayElement(['admin', 'user', 'guest']))
+  role: string;
 }
 ```
 
-## 🌱 Step 3: Create a Seeder
-
-Create a file `src/database/seeders/user.seeder.ts`:
+## Step 3: Create a Seeder
 
 ```typescript
+// 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';
 
@@ -50,71 +67,53 @@ export class UserSeeder implements Seeder {
     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);
     await this.userRepository.save(users);
     console.log('✅ Seeded 10 users');
   }
 
-  async drop(options: SeederServiceOptions): Promise<void> {
+  async drop(): Promise<void> {
     await this.userRepository.delete({});
   }
 }
 ```
 
-## ⚙️ Step 4: Register in Module
-
-Update your `app.module.ts`:
-
-```typescript
-import { Module } from '@nestjs/common';
-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';
+## Step 4: Create Seeder Configuration
 
-@Module({
-  imports: [
-    TypeOrmModule.forRoot({
-      type: 'postgres',
-      host: 'localhost',
-      port: 5432,
-      username: 'postgres',
-      password: 'postgres',
-      database: 'mydb',
-      entities: [User],
-      synchronize: true,
-    }),
-    TypeOrmModule.forFeature([User]),
-    SeederModule.register({
-      seeders: [UserSeeder],
-    }),
-  ],
-})
-export class AppModule {}
-```
+Create `seeder.config.ts` in your **project root**:
 
-## 🖥️ Step 5A: Option 1 - Using CLI (Recommended)
-
-### Create config file `src/database/seeder.config.ts`:
+> **Note:** The seeder configuration is independent and does not require importing your main `AppModule`.
 
 ```typescript
+// seeder.config.ts (in project root)
 import { TypeOrmModule } from '@nestjs/typeorm';
-import { User } from './entities/user.entity';
-import { UserSeeder } from './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();
 
 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.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]),
   ],
@@ -122,92 +121,103 @@ export default {
 };
 ```
 
-### Add script to `package.json`:
+## Step 5: Add Script & Run
+
+Add to `package.json`:
 
 ```json
 {
   "scripts": {
-    "seed": "nest-seed -c ./src/database/seeder.config.ts",
-    "seed:refresh": "nest-seed -c ./src/database/seeder.config.ts --refresh"
+    "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"
   }
 }
 ```
 
-### Run it:
+Run it:
 
 ```bash
 npm run seed
 ```
 
-## 🖥️ Step 5B: Option 2 - Using Script
+**Output:**
+```
+🌱 Starting NestJS Seeder...
+📁 Loading configuration from: seeder.config.ts
+[Nest] Starting Nest application...
+[Nest] TypeOrmModule dependencies initialized
+✅ Seeded 10 users
+```
 
-### Create `src/seed.ts`:
+## 🎉 Success!
 
-```typescript
-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();
-}
+You've successfully seeded your database! 
+
+## 📚 Next Steps
+
+### Run with options:
 
-bootstrap();
+```bash
+# Drop and reseed
+npm run seed:refresh
+
+# Run specific seeder
+npm run seed -- --name UserSeeder
+
+# With dummy data flag
+npm run seed -- --dummyData
+```
+
+### Add More Seeders
+
+1. Create more factories and seeders
+2. Add them to `seeder.config.ts`:
+
+```typescript
+export default {
+  imports: [/* ... */],
+  seeders: [
+    UserSeeder,
+    PostSeeder,
+    CommentSeeder,
+  ],
+};
 ```
 
-### Add script to `package.json`:
+### Watch Mode for Development
+
+Add to `package.json`:
 
 ```json
 {
   "scripts": {
-    "seed": "ts-node src/seed.ts",
-    "seed:refresh": "ts-node src/seed.ts --refresh"
+    "seed:watch": "nodemon --watch src/seeders --watch src/factories --ext ts --exec \"npm run seed\""
   }
 }
 ```
 
-### Run it:
+Run:
 
 ```bash
-npm run seed
+npm run seed:watch
 ```
 
-## 🎉 That's it!
-
-You've successfully set up nest-seeder!
-
-## 📚 Next Steps
-
-### Run specific seeders:
-```bash
-npm run seed -- --name UserSeeder
-```
-
-### Refresh data (drop and reseed):
-```bash
-npm run seed:refresh
-```
+Now your database will auto-reseed when you modify seeders or factories!
 
-### Add more seeders:
-1. Create more factory classes
-2. Create more seeder classes
-3. Add them to your config/module
-4. Run!
+## 💡 Tips
 
-### Advanced features:
-- Check out the full README.md for advanced examples
-- Learn about factory dependencies
-- Explore relationship handling
-- See transaction examples
+- **Start small**: Begin with one entity, then add more
+- **Use factories**: They make generating data super easy
+- **Order matters**: List seeders in dependency order
+- **Drop method**: Always implement drop() to clear data
+- **Environment variables**: Use them for database config
 
-## 🆘 Need Help?
+## 🔗 Resources
 
-- Read the full [README.md](./README.md)
-- Check the [examples](./examples) folder
-- Open an issue on GitHub
+- [Full Documentation](./README.md)
+- [Examples Directory](./examples/)
+- [GitHub Repository](https://github.com/ackplus/nest-seeder)
 
-Happy Seeding! 🌱
+---
 
+Ready to seed! 🌱