@stratal/seeders

CLI tool and infrastructure for database seeding in Stratal applications. Seeders run within request-scoped DI containers with full access to injected services. Full documentation at stratal.dev/testing/seeders.

Writing a Seeder

import { Seeder } from '@stratal/seeders';
import { inject, Transient, DI_TOKENS } from 'stratal/di';
import type { DatabaseService } from '@stratal/framework/database';

@Transient()
export class UserSeeder extends Seeder {
  constructor(@inject(DI_TOKENS.Database) private db: DatabaseService) {
    super();
  }

  async run() {
    await new UserFactory().count(10).createMany(this.db);
  }
}

Registration

Register seeders in module providers:

@Module({
  providers: [UserSeeder, RolePermissionsSeeder],
})
export class SeederModule {}

Seeders are auto-discovered by walking module providers recursively — any class extending Seeder is found.

Entry File

// src/seed.ts
import { SeederRunner } from '@stratal/seeders';
import { AppModule } from './app.module';

SeederRunner.run(AppModule);

Add to package.json: "seed": "stratal-seed" (uses @swc-node/register for runtime TypeScript support).

CLI Usage

Command	Description
npx stratal-seed run <seeder>	Run a single seeder by name
npx stratal-seed run --all	Run all discovered seeders
npx stratal-seed list	List all available seeders
npx stratal-seed run <seeder> --dry-run	Preview without executing

Naming Convention

Class Name	CLI Name
UserSeeder	user
RolePermissionsSeeder	role-permissions
OrganizationMembersSeeder	organization-members

Pattern: strip Seeder suffix, convert PascalCase to kebab-case.