@joakimbugge/nest-typeorm-seeder 0.2.0 → 0.3.0

package/README.md

@@ -1,10 +1,20 @@
 # @joakimbugge/nest-typeorm-seeder
 
-NestJS module for [@joakimbugge/typeorm-seeder](../typeorm-seeder). Runs your `@Seeder` classes automatically on application bootstrap — once per seeder by default, tracked in a database table so watch-mode restarts do not re-seed.
+NestJS module for [@joakimbugge/typeorm-seeder](../typeorm-seeder). Runs your `@Seeder` classes automatically on application bootstrap — once per seeder by default, tracked in a database table so watch-mode restarts do not re-seed. For simple cases, a `run` callback lets you seed without any class boilerplate.
 
 > [!TIP]
 > This package handles the NestJS integration. The seeding itself — `@Seed()`, `@Seeder`, `seed()`, entity factories — is all defined in [@joakimbugge/typeorm-seeder](../typeorm-seeder/README.md). Familiarity with that package will make this one much easier to use.
 
+Coded by AI. Reviewed by humans.
+
+---
+
+- [Installation](#installation)
+- [Basic usage](#basic-usage)
+- [Running once](#running-once)
+- [Seed scripts](#seed-scripts)
+- [API reference](#api-reference)
+
 ---
 
 ## Installation
@@ -88,6 +98,20 @@ When TypeORM's `dropSchema: true` is set, the entire schema — including the `s
 
 `dropSchema: true` is typical in development when you want a clean slate on every restart — seeding every run is exactly what you want in that scenario. `runOnce: true` with a persistent schema is the right default for staging and production, where duplicate data is the concern.
 
+### Evolving seed data
+
+Treat seeders the way you treat migrations: once a seeder has run in a persistent environment, consider it immutable. If you need more data or different data, create a new seeder class rather than editing the existing one:
+
+```ts
+@Seeder()
+class UserSeeder implements SeederInterface { ... }      // already ran, leave it alone
+
+@Seeder({ dependencies: [UserSeeder] })
+class UserSeederV2 implements SeederInterface { ... }   // adds more users on next boot
+```
+
+This keeps the history table accurate and avoids the question of what re-running a seeder would mean for data that already exists. This applies to environments where `dropSchema: false` and `runOnce: true` — in development with `dropSchema: true`, the schema is wiped on every restart anyway.
+
 ### Re-seeding
 
 To force a seeder to run again, delete its row from the `seeders` table:
@@ -107,6 +131,41 @@ DELETE FROM "seeders";
 
 ---
 
+## Seed scripts
+
+For simple cases where named, tracked seeders are more structure than you need, provide a `run` callback instead. It receives the resolved `DataSource` and executes on every boot — no run-once tracking applies:
+
+```ts
+SeederModule.forRoot({
+  async run({ dataSource }) {
+    await seed(User).saveMany(10, { dataSource })
+  },
+})
+```
+
+`run` is the escape hatch for seeding that should always happen. If you need run-once semantics, the named `@Seeder` pattern is the right tool.
+
+> [!NOTE]
+> Because `run` always executes, `runOnce` is not accepted when `seeders` is omitted — TypeScript will reject it at compile time.
+
+### Using both together
+
+`seeders` and `run` can coexist. Seeders run first (sorted, tracked per their `runOnce` setting), then `run` is called. This means the callback can safely assume seeder data is already in place:
+
+```ts
+SeederModule.forRoot({
+  seeders: [UserSeeder],
+  async run({ dataSource }) {
+    // UserSeeder has already run
+    await seed(AdminUser).save({ dataSource })
+  },
+})
+```
+
+`runOnce` applies only to `seeders` — `run` always executes regardless.
+
+---
+
 ## API reference
 
 ### `SeederModule.forRoot(options)`
@@ -129,15 +188,36 @@ Registers the module with options resolved from the DI container.
 
 ### `SeederModuleOptions`
 
+`SeederModuleOptions` is a discriminated union with two shapes depending on which properties are provided.
+
+**Shared properties** (available in both shapes)
+
 | Property | Type | Default | Description |
 |---|---|---|---|
-| `seeders` | `SeederCtor[]` | — | Seeder classes to run. Transitive dependencies are resolved automatically. |
 | `dataSource` | `DataSource?` | — | Explicit DataSource. When omitted, the module resolves the DataSource registered by `TypeOrmModule`. |
 | `relations` | `boolean?` | `true` | Passed through to `runSeeders`. Set to `false` to skip relation seeding. |
 | `enabled` | `boolean?` | `true` | When `false`, seeding is skipped entirely. Useful for gating on an environment variable. |
+| `onBefore` | `(seeder) => void \| Promise<void>` | — | Called before each seeder runs. |
+| `onAfter` | `(seeder, durationMs) => void \| Promise<void>` | — | Called after each seeder completes successfully. |
+| `onError` | `(seeder, error) => void \| Promise<void>` | — | Called when a seeder throws. The error is still re-thrown after this returns. |
+
+The hooks behave identically to the hooks in [`runSeeders`](../typeorm-seeder/README.md#hooks) and are passed through to it directly.
+
+**With `seeders`** — `run` is optional; `runOnce` and `historyTableName` apply
+
+| Property | Type | Default | Description |
+|---|---|---|---|
+| `seeders` | `SeederCtor[]` | — | Seeder classes to run. Transitive dependencies are resolved automatically. |
+| `run` | `RunCallback?` | — | Inline callback executed after all seeders. Always runs — `runOnce` does not apply to it. |
 | `runOnce` | `boolean?` | `true` | Track executed seeders in the database and skip them on subsequent boots. |
 | `historyTableName` | `string?` | `'seeders'` | Name of the table used to track which seeders have run. |
 
+**With `run` only** — no `seeders`, no `runOnce`
+
+| Property | Type | Description |
+|---|---|---|
+| `run` | `RunCallback` | Inline callback executed on every boot. No run-once tracking is applied. |
+
 ---
 
 ## License

package/dist/index.cjs

@@ -36,29 +36,39 @@ let SeederRunnerService = _SeederRunnerService = class SeederRunnerService {
 	async onApplicationBootstrap() {
 		if (this.options.enabled === false) return;
 		const dataSource = await this.resolveDataSource();
-		const runOnce = this.options.runOnce ?? true;
-		const tableName = this.options.historyTableName ?? DEFAULT_HISTORY_TABLE;
-		let executedSeeders = /* @__PURE__ */ new Set();
-		if (runOnce) {
-			await this.ensureHistoryTable(dataSource, tableName);
-			executedSeeders = await this.getExecutedSeeders(dataSource, tableName);
+		if (this.options.seeders) {
+			const runOnce = this.options.runOnce ?? true;
+			const tableName = this.options.historyTableName ?? DEFAULT_HISTORY_TABLE;
+			let executedSeeders = /* @__PURE__ */ new Set();
+			if (runOnce) {
+				await this.ensureHistoryTable(dataSource, tableName);
+				executedSeeders = await this.getExecutedSeeders(dataSource, tableName);
+			}
+			await (0, _joakimbugge_typeorm_seeder.runSeeders)(this.options.seeders, {
+				dataSource,
+				relations: this.options.relations,
+				logging: false,
+				skip: (seeder) => {
+					const shouldSkip = executedSeeders.has(seeder.name);
+					if (shouldSkip) this.logger.log(`[${seeder.name}] Skipping (already run)`);
+					return shouldSkip;
+				},
+				onBefore: async (seeder) => {
+					this.logger.log(`[${seeder.name}] Starting...`);
+					await this.options.onBefore?.(seeder);
+				},
+				onAfter: async (seeder, durationMs) => {
+					if (runOnce) await this.recordRun(dataSource, tableName, seeder.name);
+					this.logger.log(`[${seeder.name}] Done in ${durationMs}ms`);
+					await this.options.onAfter?.(seeder, durationMs);
+				},
+				onError: async (seeder, error) => {
+					this.logger.error(`[${seeder.name}] Failed`, error instanceof Error ? error.stack : String(error));
+					await this.options.onError?.(seeder, error);
+				}
+			});
 		}
-		await (0, _joakimbugge_typeorm_seeder.runSeeders)(this.options.seeders, {
-			dataSource,
-			relations: this.options.relations,
-			logging: false,
-			skip: (seeder) => {
-				const shouldSkip = executedSeeders.has(seeder.name);
-				if (shouldSkip) this.logger.log(`[${seeder.name}] Skipping (already run)`);
-				return shouldSkip;
-			},
-			onBefore: (seeder) => this.logger.log(`[${seeder.name}] Starting...`),
-			onAfter: async (seeder, durationMs) => {
-				if (runOnce) await this.recordRun(dataSource, tableName, seeder.name);
-				this.logger.log(`[${seeder.name}] Done in ${durationMs}ms`);
-			},
-			onError: (seeder, error) => this.logger.error(`[${seeder.name}] Failed`, error instanceof Error ? error.stack : String(error))
-		});
+		if (this.options.run) await this.options.run({ dataSource });
 	}
 	async ensureHistoryTable(dataSource, tableName) {
 		await dataSource.query(`CREATE TABLE IF NOT EXISTS "${tableName}" (name VARCHAR(255) PRIMARY KEY NOT NULL, executed_at VARCHAR(32) NOT NULL)`);

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","names":["Logger","DataSource"],"sources":["../src/SeederRunnerService.ts","../src/SeederModule.ts"],"sourcesContent":["import { Inject, Injectable, Logger, type OnApplicationBootstrap } from '@nestjs/common';\nimport { ModuleRef } from '@nestjs/core';\nimport { runSeeders } from '@joakimbugge/typeorm-seeder';\nimport { DataSource } from 'typeorm';\nimport type { SeederModuleOptions } from './SeederModule.js';\n\nexport const SEEDER_MODULE_OPTIONS = Symbol('SEEDER_MODULE_OPTIONS');\n\nconst DEFAULT_HISTORY_TABLE = 'seeders';\n\n@Injectable()\nexport class SeederRunnerService implements OnApplicationBootstrap {\n  private readonly logger = new Logger(SeederRunnerService.name);\n\n  constructor(\n    @Inject(SEEDER_MODULE_OPTIONS) private readonly options: SeederModuleOptions,\n    private readonly moduleRef: ModuleRef,\n  ) {}\n\n  async onApplicationBootstrap(): Promise<void> {\n    if (this.options.enabled === false) {\n      return;\n    }\n\n    const dataSource = await this.resolveDataSource();\n    const runOnce = this.options.runOnce ?? true;\n    const tableName = this.options.historyTableName ?? DEFAULT_HISTORY_TABLE;\n\n    let executedSeeders = new Set<string>();\n\n    if (runOnce) {\n      await this.ensureHistoryTable(dataSource, tableName);\n      executedSeeders = await this.getExecutedSeeders(dataSource, tableName);\n    }\n\n    await runSeeders(this.options.seeders, {\n      dataSource,\n      relations: this.options.relations,\n      logging: false,\n      skip: (seeder) => {\n        const shouldSkip = executedSeeders.has(seeder.name);\n\n        if (shouldSkip) {\n          this.logger.log(`[${seeder.name}] Skipping (already run)`);\n        }\n\n        return shouldSkip;\n      },\n      onBefore: (seeder) => this.logger.log(`[${seeder.name}] Starting...`),\n      onAfter: async (seeder, durationMs) => {\n        if (runOnce) {\n          await this.recordRun(dataSource, tableName, seeder.name);\n        }\n\n        this.logger.log(`[${seeder.name}] Done in ${durationMs}ms`);\n      },\n      onError: (seeder, error) =>\n        this.logger.error(\n          `[${seeder.name}] Failed`,\n          error instanceof Error ? error.stack : String(error),\n        ),\n    });\n  }\n\n  private async ensureHistoryTable(dataSource: DataSource, tableName: string): Promise<void> {\n    await dataSource.query(\n      `CREATE TABLE IF NOT EXISTS \"${tableName}\" (name VARCHAR(255) PRIMARY KEY NOT NULL, executed_at VARCHAR(32) NOT NULL)`,\n    );\n  }\n\n  private async getExecutedSeeders(\n    dataSource: DataSource,\n    tableName: string,\n  ): Promise<Set<string>> {\n    const rows: { name: string }[] = await dataSource.query(`SELECT name FROM \"${tableName}\"`);\n\n    return new Set(rows.map((r) => r.name));\n  }\n\n  private async recordRun(dataSource: DataSource, tableName: string, name: string): Promise<void> {\n    const executedAt = new Date().toISOString();\n\n    await dataSource.query(\n      `INSERT INTO \"${tableName}\" (name, executed_at) VALUES ('${name}', '${executedAt}')`,\n    );\n  }\n\n  private async resolveDataSource(): Promise<DataSource> {\n    if (this.options.dataSource) {\n      return this.options.dataSource;\n    }\n\n    try {\n      return this.moduleRef.get(DataSource, { strict: false });\n    } catch {\n      throw new Error(\n        'SeederModule could not resolve a DataSource. Either import TypeOrmModule or provide a dataSource in SeederModule options.',\n      );\n    }\n  }\n}\n","import { type DynamicModule, Module } from '@nestjs/common';\nimport type { SeederInterface } from '@joakimbugge/typeorm-seeder';\nimport type { DataSource } from 'typeorm';\nimport { SeederRunnerService, SEEDER_MODULE_OPTIONS } from './SeederRunnerService.js';\n\nexport type SeederCtor = new () => SeederInterface;\n\nexport interface SeederModuleOptions {\n  seeders: SeederCtor[];\n  dataSource?: DataSource;\n  relations?: boolean;\n  /**\n   * When `false`, seeding is skipped entirely. Useful for gating on an env var.\n   *\n   * @default true\n   */\n  enabled?: boolean;\n  /**\n   * Track executed seeders in a database table and skip them on subsequent boots.\n   * Set to `false` to always run every seeder regardless.\n   *\n   * When TypeORM's `dropSchema` is `true`, the history table is dropped with the\n   * rest of the schema on every start, so all seeders run regardless of this setting.\n   *\n   * @default true\n   */\n  runOnce?: boolean;\n  /**\n   * Name of the table used to track which seeders have run.\n   *\n   * @default 'seeders'\n   */\n  historyTableName?: string;\n}\n\nexport interface SeederModuleAsyncOptions {\n  imports?: any[];\n  inject?: any[];\n  useFactory: (...args: any[]) => SeederModuleOptions | Promise<SeederModuleOptions>;\n}\n\n@Module({})\nexport class SeederModule {\n  static forRoot(options: SeederModuleOptions): DynamicModule {\n    return {\n      module: SeederModule,\n      providers: [{ provide: SEEDER_MODULE_OPTIONS, useValue: options }, SeederRunnerService],\n    };\n  }\n\n  static forRootAsync(options: SeederModuleAsyncOptions): DynamicModule {\n    return {\n      module: SeederModule,\n      imports: options.imports ?? [],\n      providers: [\n        {\n          provide: SEEDER_MODULE_OPTIONS,\n          inject: options.inject ?? [],\n          useFactory: options.useFactory,\n        },\n        SeederRunnerService,\n      ],\n    };\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;AAMA,MAAa,wBAAwB,OAAO,wBAAwB;AAEpE,MAAM,wBAAwB;AAGvB,IAAA,sBAAA,uBAAA,MAAM,oBAAsD;CAGjE,YACE,SACA,WACA;AAFgD,OAAA,UAAA;AAC/B,OAAA,YAAA;gBAJO,IAAIA,eAAAA,OAAAA,qBAA2B,KAAK;;CAO9D,MAAM,yBAAwC;AAC5C,MAAI,KAAK,QAAQ,YAAY,MAC3B;EAGF,MAAM,aAAa,MAAM,KAAK,mBAAmB;EACjD,MAAM,UAAU,KAAK,QAAQ,WAAW;EACxC,MAAM,YAAY,KAAK,QAAQ,oBAAoB;EAEnD,IAAI,kCAAkB,IAAI,KAAa;AAEvC,MAAI,SAAS;AACX,SAAM,KAAK,mBAAmB,YAAY,UAAU;AACpD,qBAAkB,MAAM,KAAK,mBAAmB,YAAY,UAAU;;AAGxE,SAAA,GAAA,4BAAA,YAAiB,KAAK,QAAQ,SAAS;GACrC;GACA,WAAW,KAAK,QAAQ;GACxB,SAAS;GACT,OAAO,WAAW;IAChB,MAAM,aAAa,gBAAgB,IAAI,OAAO,KAAK;AAEnD,QAAI,WACF,MAAK,OAAO,IAAI,IAAI,OAAO,KAAK,0BAA0B;AAG5D,WAAO;;GAET,WAAW,WAAW,KAAK,OAAO,IAAI,IAAI,OAAO,KAAK,eAAe;GACrE,SAAS,OAAO,QAAQ,eAAe;AACrC,QAAI,QACF,OAAM,KAAK,UAAU,YAAY,WAAW,OAAO,KAAK;AAG1D,SAAK,OAAO,IAAI,IAAI,OAAO,KAAK,YAAY,WAAW,IAAI;;GAE7D,UAAU,QAAQ,UAChB,KAAK,OAAO,MACV,IAAI,OAAO,KAAK,WAChB,iBAAiB,QAAQ,MAAM,QAAQ,OAAO,MAAM,CACrD;GACJ,CAAC;;CAGJ,MAAc,mBAAmB,YAAwB,WAAkC;AACzF,QAAM,WAAW,MACf,+BAA+B,UAAU,8EAC1C;;CAGH,MAAc,mBACZ,YACA,WACsB;EACtB,MAAM,OAA2B,MAAM,WAAW,MAAM,qBAAqB,UAAU,GAAG;AAE1F,SAAO,IAAI,IAAI,KAAK,KAAK,MAAM,EAAE,KAAK,CAAC;;CAGzC,MAAc,UAAU,YAAwB,WAAmB,MAA6B;EAC9F,MAAM,8BAAa,IAAI,MAAM,EAAC,aAAa;AAE3C,QAAM,WAAW,MACf,gBAAgB,UAAU,iCAAiC,KAAK,MAAM,WAAW,IAClF;;CAGH,MAAc,oBAAyC;AACrD,MAAI,KAAK,QAAQ,WACf,QAAO,KAAK,QAAQ;AAGtB,MAAI;AACF,UAAO,KAAK,UAAU,IAAIC,QAAAA,YAAY,EAAE,QAAQ,OAAO,CAAC;UAClD;AACN,SAAM,IAAI,MACR,4HACD;;;;;iCAvFM;+CAKD,sBAAsB,CAAA;;;;;;AC2B3B,IAAA,eAAA,gBAAA,MAAM,aAAa;CACxB,OAAO,QAAQ,SAA6C;AAC1D,SAAO;GACL,QAAA;GACA,WAAW,CAAC;IAAE,SAAS;IAAuB,UAAU;IAAS,EAAE,oBAAoB;GACxF;;CAGH,OAAO,aAAa,SAAkD;AACpE,SAAO;GACL,QAAA;GACA,SAAS,QAAQ,WAAW,EAAE;GAC9B,WAAW,CACT;IACE,SAAS;IACT,QAAQ,QAAQ,UAAU,EAAE;IAC5B,YAAY,QAAQ;IACrB,EACD,oBACD;GACF;;;sEArBG,EAAE,CAAC,CAAA,EAAA,aAAA"}
+{"version":3,"file":"index.cjs","names":["Logger","DataSource"],"sources":["../src/SeederRunnerService.ts","../src/SeederModule.ts"],"sourcesContent":["import { Inject, Injectable, Logger, type OnApplicationBootstrap } from '@nestjs/common';\nimport { ModuleRef } from '@nestjs/core';\nimport { runSeeders } from '@joakimbugge/typeorm-seeder';\nimport { DataSource } from 'typeorm';\nimport type { SeederModuleOptions } from './SeederModule.js';\n\nexport const SEEDER_MODULE_OPTIONS = Symbol('SEEDER_MODULE_OPTIONS');\n\nconst DEFAULT_HISTORY_TABLE = 'seeders';\n\n@Injectable()\nexport class SeederRunnerService implements OnApplicationBootstrap {\n  private readonly logger = new Logger(SeederRunnerService.name);\n\n  constructor(\n    @Inject(SEEDER_MODULE_OPTIONS) private readonly options: SeederModuleOptions,\n    private readonly moduleRef: ModuleRef,\n  ) {}\n\n  async onApplicationBootstrap(): Promise<void> {\n    if (this.options.enabled === false) {\n      return;\n    }\n\n    const dataSource = await this.resolveDataSource();\n\n    if (this.options.seeders) {\n      const runOnce = this.options.runOnce ?? true;\n      const tableName = this.options.historyTableName ?? DEFAULT_HISTORY_TABLE;\n\n      let executedSeeders = new Set<string>();\n\n      if (runOnce) {\n        await this.ensureHistoryTable(dataSource, tableName);\n        executedSeeders = await this.getExecutedSeeders(dataSource, tableName);\n      }\n\n      await runSeeders(this.options.seeders, {\n        dataSource,\n        relations: this.options.relations,\n        logging: false,\n        skip: (seeder) => {\n          const shouldSkip = executedSeeders.has(seeder.name);\n\n          if (shouldSkip) {\n            this.logger.log(`[${seeder.name}] Skipping (already run)`);\n          }\n\n          return shouldSkip;\n        },\n        onBefore: async (seeder) => {\n          this.logger.log(`[${seeder.name}] Starting...`);\n          await this.options.onBefore?.(seeder);\n        },\n        onAfter: async (seeder, durationMs) => {\n          if (runOnce) {\n            await this.recordRun(dataSource, tableName, seeder.name);\n          }\n\n          this.logger.log(`[${seeder.name}] Done in ${durationMs}ms`);\n          await this.options.onAfter?.(seeder, durationMs);\n        },\n        onError: async (seeder, error) => {\n          this.logger.error(\n            `[${seeder.name}] Failed`,\n            error instanceof Error ? error.stack : String(error),\n          );\n          await this.options.onError?.(seeder, error);\n        },\n      });\n    }\n\n    if (this.options.run) {\n      await this.options.run({ dataSource });\n    }\n  }\n\n  private async ensureHistoryTable(dataSource: DataSource, tableName: string): Promise<void> {\n    await dataSource.query(\n      `CREATE TABLE IF NOT EXISTS \"${tableName}\" (name VARCHAR(255) PRIMARY KEY NOT NULL, executed_at VARCHAR(32) NOT NULL)`,\n    );\n  }\n\n  private async getExecutedSeeders(\n    dataSource: DataSource,\n    tableName: string,\n  ): Promise<Set<string>> {\n    const rows: { name: string }[] = await dataSource.query(`SELECT name FROM \"${tableName}\"`);\n\n    return new Set(rows.map((r) => r.name));\n  }\n\n  private async recordRun(dataSource: DataSource, tableName: string, name: string): Promise<void> {\n    const executedAt = new Date().toISOString();\n\n    await dataSource.query(\n      `INSERT INTO \"${tableName}\" (name, executed_at) VALUES ('${name}', '${executedAt}')`,\n    );\n  }\n\n  private async resolveDataSource(): Promise<DataSource> {\n    if (this.options.dataSource) {\n      return this.options.dataSource;\n    }\n\n    try {\n      return this.moduleRef.get(DataSource, { strict: false });\n    } catch {\n      throw new Error(\n        'SeederModule could not resolve a DataSource. Either import TypeOrmModule or provide a dataSource in SeederModule options.',\n      );\n    }\n  }\n}\n","import { type DynamicModule, Module } from '@nestjs/common';\nimport type { RunSeedersOptions, SeederInterface } from '@joakimbugge/typeorm-seeder';\nimport type { DataSource } from 'typeorm';\nimport { SeederRunnerService, SEEDER_MODULE_OPTIONS } from './SeederRunnerService.js';\n\nexport type SeederCtor = new () => SeederInterface;\n\nexport type RunCallback = (ctx: { dataSource: DataSource }) => void | Promise<void>;\n\ninterface SeederModuleBaseOptions extends Pick<\n  RunSeedersOptions,\n  'onBefore' | 'onAfter' | 'onError'\n> {\n  /**\n   * Explicit DataSource. When omitted, the module resolves the DataSource\n   * registered by `TypeOrmModule`.\n   */\n  dataSource?: DataSource;\n  /** Passed through to `runSeeders`. Set to `false` to skip relation seeding. */\n  relations?: boolean;\n  /**\n   * When `false`, seeding is skipped entirely. Useful for gating on an env var.\n   *\n   * @default true\n   */\n  enabled?: boolean;\n}\n\ninterface SeederModuleSeedersOptions extends SeederModuleBaseOptions {\n  /** Seeder classes to run. Transitive dependencies are resolved automatically. */\n  seeders: SeederCtor[];\n  /**\n   * Inline callback executed after all seeders have run. Always executes on\n   * every boot — `runOnce` does not apply to it.\n   */\n  run?: RunCallback;\n  /**\n   * Track executed seeders in a database table and skip them on subsequent boots.\n   * Set to `false` to always run every seeder regardless.\n   *\n   * When TypeORM's `dropSchema` is `true`, the history table is dropped with the\n   * rest of the schema on every start, so all seeders run regardless of this setting.\n   *\n   * @default true\n   */\n  runOnce?: boolean;\n  /**\n   * Name of the table used to track which seeders have run.\n   *\n   * @default 'seeders'\n   */\n  historyTableName?: string;\n}\n\ninterface SeederModuleRunOptions extends SeederModuleBaseOptions {\n  seeders?: never;\n  /**\n   * Inline callback executed on every boot. runOnce is false.\n   */\n  run: RunCallback;\n  runOnce?: false;\n  historyTableName?: never;\n}\n\nexport type SeederModuleOptions = SeederModuleSeedersOptions | SeederModuleRunOptions;\n\nexport interface SeederModuleAsyncOptions {\n  imports?: any[];\n  inject?: any[];\n  useFactory: (...args: any[]) => SeederModuleOptions | Promise<SeederModuleOptions>;\n}\n\n@Module({})\nexport class SeederModule {\n  static forRoot(options: SeederModuleOptions): DynamicModule {\n    return {\n      module: SeederModule,\n      providers: [{ provide: SEEDER_MODULE_OPTIONS, useValue: options }, SeederRunnerService],\n    };\n  }\n\n  static forRootAsync(options: SeederModuleAsyncOptions): DynamicModule {\n    return {\n      module: SeederModule,\n      imports: options.imports ?? [],\n      providers: [\n        {\n          provide: SEEDER_MODULE_OPTIONS,\n          inject: options.inject ?? [],\n          useFactory: options.useFactory,\n        },\n        SeederRunnerService,\n      ],\n    };\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;AAMA,MAAa,wBAAwB,OAAO,wBAAwB;AAEpE,MAAM,wBAAwB;AAGvB,IAAA,sBAAA,uBAAA,MAAM,oBAAsD;CAGjE,YACE,SACA,WACA;AAFgD,OAAA,UAAA;AAC/B,OAAA,YAAA;gBAJO,IAAIA,eAAAA,OAAAA,qBAA2B,KAAK;;CAO9D,MAAM,yBAAwC;AAC5C,MAAI,KAAK,QAAQ,YAAY,MAC3B;EAGF,MAAM,aAAa,MAAM,KAAK,mBAAmB;AAEjD,MAAI,KAAK,QAAQ,SAAS;GACxB,MAAM,UAAU,KAAK,QAAQ,WAAW;GACxC,MAAM,YAAY,KAAK,QAAQ,oBAAoB;GAEnD,IAAI,kCAAkB,IAAI,KAAa;AAEvC,OAAI,SAAS;AACX,UAAM,KAAK,mBAAmB,YAAY,UAAU;AACpD,sBAAkB,MAAM,KAAK,mBAAmB,YAAY,UAAU;;AAGxE,UAAA,GAAA,4BAAA,YAAiB,KAAK,QAAQ,SAAS;IACrC;IACA,WAAW,KAAK,QAAQ;IACxB,SAAS;IACT,OAAO,WAAW;KAChB,MAAM,aAAa,gBAAgB,IAAI,OAAO,KAAK;AAEnD,SAAI,WACF,MAAK,OAAO,IAAI,IAAI,OAAO,KAAK,0BAA0B;AAG5D,YAAO;;IAET,UAAU,OAAO,WAAW;AAC1B,UAAK,OAAO,IAAI,IAAI,OAAO,KAAK,eAAe;AAC/C,WAAM,KAAK,QAAQ,WAAW,OAAO;;IAEvC,SAAS,OAAO,QAAQ,eAAe;AACrC,SAAI,QACF,OAAM,KAAK,UAAU,YAAY,WAAW,OAAO,KAAK;AAG1D,UAAK,OAAO,IAAI,IAAI,OAAO,KAAK,YAAY,WAAW,IAAI;AAC3D,WAAM,KAAK,QAAQ,UAAU,QAAQ,WAAW;;IAElD,SAAS,OAAO,QAAQ,UAAU;AAChC,UAAK,OAAO,MACV,IAAI,OAAO,KAAK,WAChB,iBAAiB,QAAQ,MAAM,QAAQ,OAAO,MAAM,CACrD;AACD,WAAM,KAAK,QAAQ,UAAU,QAAQ,MAAM;;IAE9C,CAAC;;AAGJ,MAAI,KAAK,QAAQ,IACf,OAAM,KAAK,QAAQ,IAAI,EAAE,YAAY,CAAC;;CAI1C,MAAc,mBAAmB,YAAwB,WAAkC;AACzF,QAAM,WAAW,MACf,+BAA+B,UAAU,8EAC1C;;CAGH,MAAc,mBACZ,YACA,WACsB;EACtB,MAAM,OAA2B,MAAM,WAAW,MAAM,qBAAqB,UAAU,GAAG;AAE1F,SAAO,IAAI,IAAI,KAAK,KAAK,MAAM,EAAE,KAAK,CAAC;;CAGzC,MAAc,UAAU,YAAwB,WAAmB,MAA6B;EAC9F,MAAM,8BAAa,IAAI,MAAM,EAAC,aAAa;AAE3C,QAAM,WAAW,MACf,gBAAgB,UAAU,iCAAiC,KAAK,MAAM,WAAW,IAClF;;CAGH,MAAc,oBAAyC;AACrD,MAAI,KAAK,QAAQ,WACf,QAAO,KAAK,QAAQ;AAGtB,MAAI;AACF,UAAO,KAAK,UAAU,IAAIC,QAAAA,YAAY,EAAE,QAAQ,OAAO,CAAC;UAClD;AACN,SAAM,IAAI,MACR,4HACD;;;;;iCApGM;+CAKD,sBAAsB,CAAA;;;;;;AC0D3B,IAAA,eAAA,gBAAA,MAAM,aAAa;CACxB,OAAO,QAAQ,SAA6C;AAC1D,SAAO;GACL,QAAA;GACA,WAAW,CAAC;IAAE,SAAS;IAAuB,UAAU;IAAS,EAAE,oBAAoB;GACxF;;CAGH,OAAO,aAAa,SAAkD;AACpE,SAAO;GACL,QAAA;GACA,SAAS,QAAQ,WAAW,EAAE;GAC9B,WAAW,CACT;IACE,SAAS;IACT,QAAQ,QAAQ,UAAU,EAAE;IAC5B,YAAY,QAAQ;IACrB,EACD,oBACD;GACF;;;sEArBG,EAAE,CAAC,CAAA,EAAA,aAAA"}

package/dist/index.d.cts

@@ -1,12 +1,19 @@
 import { DynamicModule } from "@nestjs/common";
-import { SeederInterface } from "@joakimbugge/typeorm-seeder";
+import { RunSeedersOptions, SeederInterface } from "@joakimbugge/typeorm-seeder";
 import { DataSource } from "typeorm";
 
 //#region src/SeederModule.d.ts
 type SeederCtor = new () => SeederInterface;
-interface SeederModuleOptions {
-  seeders: SeederCtor[];
+type RunCallback = (ctx: {
+  dataSource: DataSource;
+}) => void | Promise<void>;
+interface SeederModuleBaseOptions extends Pick<RunSeedersOptions, 'onBefore' | 'onAfter' | 'onError'> {
+  /**
+   * Explicit DataSource. When omitted, the module resolves the DataSource
+   * registered by `TypeOrmModule`.
+   */
   dataSource?: DataSource;
+  /** Passed through to `runSeeders`. Set to `false` to skip relation seeding. */
   relations?: boolean;
   /**
    * When `false`, seeding is skipped entirely. Useful for gating on an env var.
@@ -14,6 +21,15 @@ interface SeederModuleOptions {
    * @default true
    */
   enabled?: boolean;
+}
+interface SeederModuleSeedersOptions extends SeederModuleBaseOptions {
+  /** Seeder classes to run. Transitive dependencies are resolved automatically. */
+  seeders: SeederCtor[];
+  /**
+   * Inline callback executed after all seeders have run. Always executes on
+   * every boot — `runOnce` does not apply to it.
+   */
+  run?: RunCallback;
   /**
    * Track executed seeders in a database table and skip them on subsequent boots.
    * Set to `false` to always run every seeder regardless.
@@ -31,6 +47,16 @@ interface SeederModuleOptions {
    */
   historyTableName?: string;
 }
+interface SeederModuleRunOptions extends SeederModuleBaseOptions {
+  seeders?: never;
+  /**
+   * Inline callback executed on every boot. runOnce is false.
+   */
+  run: RunCallback;
+  runOnce?: false;
+  historyTableName?: never;
+}
+type SeederModuleOptions = SeederModuleSeedersOptions | SeederModuleRunOptions;
 interface SeederModuleAsyncOptions {
   imports?: any[];
   inject?: any[];
@@ -41,5 +67,5 @@ declare class SeederModule {
   static forRootAsync(options: SeederModuleAsyncOptions): DynamicModule;
 }
 //#endregion
-export { type SeederCtor, SeederModule, type SeederModuleAsyncOptions, type SeederModuleOptions };
+export { type RunCallback, type SeederCtor, SeederModule, type SeederModuleAsyncOptions, type SeederModuleOptions };
 //# sourceMappingURL=index.d.cts.map

package/dist/index.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.cts","names":[],"sources":["../src/SeederModule.ts"],"mappings":";;;;;KAKY,UAAA,aAAuB,eAAA;AAAA,UAElB,mBAAA;EACf,OAAA,EAAS,UAAA;EACT,UAAA,GAAa,UAAA;EACb,SAAA;EALiC;;AAEnC;;;EASE,OAAA;EARA;;;;;;;;;EAkBA,OAAA;EASe;;;;;EAHf,gBAAA;AAAA;AAAA,UAGe,wBAAA;EACf,OAAA;EACA,MAAA;EACA,UAAA,MAAgB,IAAA,YAAgB,mBAAA,GAAsB,OAAA,CAAQ,mBAAA;AAAA;AAAA,cAInD,YAAA;EAAA,OACJ,OAAA,CAAQ,OAAA,EAAS,mBAAA,GAAsB,aAAA;EAAA,OAOvC,YAAA,CAAa,OAAA,EAAS,wBAAA,GAA2B,aAAA;AAAA"}
+{"version":3,"file":"index.d.cts","names":[],"sources":["../src/SeederModule.ts"],"mappings":";;;;;KAKY,UAAA,aAAuB,eAAA;AAAA,KAEvB,WAAA,IAAe,GAAA;EAAO,UAAA,EAAY,UAAA;AAAA,aAAwB,OAAA;AAAA,UAE5D,uBAAA,SAAgC,IAAA,CACxC,iBAAA;EALiC;;AAEnC;;EAUE,UAAA,GAAa,UAAA;EAV8D;EAY3E,SAAA;EAZ4C;;;;;EAkB5C,OAAA;AAAA;AAAA,UAGQ,0BAAA,SAAmC,uBAAA;EAlB3C;EAoBA,OAAA,EAAS,UAAA;EArB+B;;;;EA0BxC,GAAA,GAAM,WAAA;EAlBN;;;;;;AAQO;;;EAoBP,OAAA;EAVM;;;;;EAgBN,gBAAA;AAAA;AAAA,UAGQ,sBAAA,SAA+B,uBAAA;EACvC,OAAA;EAVA;;;EAcA,GAAA,EAAK,WAAA;EACL,OAAA;EACA,gBAAA;AAAA;AAAA,KAGU,mBAAA,GAAsB,0BAAA,GAA6B,sBAAA;AAAA,UAE9C,wBAAA;EACf,OAAA;EACA,MAAA;EACA,UAAA,MAAgB,IAAA,YAAgB,mBAAA,GAAsB,OAAA,CAAQ,mBAAA;AAAA;AAAA,cAInD,YAAA;EAAA,OACJ,OAAA,CAAQ,OAAA,EAAS,mBAAA,GAAsB,aAAA;EAAA,OAOvC,YAAA,CAAa,OAAA,EAAS,wBAAA,GAA2B,aAAA;AAAA"}

package/dist/index.d.mts

@@ -1,12 +1,19 @@
 import { DynamicModule } from "@nestjs/common";
-import { SeederInterface } from "@joakimbugge/typeorm-seeder";
+import { RunSeedersOptions, SeederInterface } from "@joakimbugge/typeorm-seeder";
 import { DataSource } from "typeorm";
 
 //#region src/SeederModule.d.ts
 type SeederCtor = new () => SeederInterface;
-interface SeederModuleOptions {
-  seeders: SeederCtor[];
+type RunCallback = (ctx: {
+  dataSource: DataSource;
+}) => void | Promise<void>;
+interface SeederModuleBaseOptions extends Pick<RunSeedersOptions, 'onBefore' | 'onAfter' | 'onError'> {
+  /**
+   * Explicit DataSource. When omitted, the module resolves the DataSource
+   * registered by `TypeOrmModule`.
+   */
   dataSource?: DataSource;
+  /** Passed through to `runSeeders`. Set to `false` to skip relation seeding. */
   relations?: boolean;
   /**
    * When `false`, seeding is skipped entirely. Useful for gating on an env var.
@@ -14,6 +21,15 @@ interface SeederModuleOptions {
    * @default true
    */
   enabled?: boolean;
+}
+interface SeederModuleSeedersOptions extends SeederModuleBaseOptions {
+  /** Seeder classes to run. Transitive dependencies are resolved automatically. */
+  seeders: SeederCtor[];
+  /**
+   * Inline callback executed after all seeders have run. Always executes on
+   * every boot — `runOnce` does not apply to it.
+   */
+  run?: RunCallback;
   /**
    * Track executed seeders in a database table and skip them on subsequent boots.
    * Set to `false` to always run every seeder regardless.
@@ -31,6 +47,16 @@ interface SeederModuleOptions {
    */
   historyTableName?: string;
 }
+interface SeederModuleRunOptions extends SeederModuleBaseOptions {
+  seeders?: never;
+  /**
+   * Inline callback executed on every boot. runOnce is false.
+   */
+  run: RunCallback;
+  runOnce?: false;
+  historyTableName?: never;
+}
+type SeederModuleOptions = SeederModuleSeedersOptions | SeederModuleRunOptions;
 interface SeederModuleAsyncOptions {
   imports?: any[];
   inject?: any[];
@@ -41,5 +67,5 @@ declare class SeederModule {
   static forRootAsync(options: SeederModuleAsyncOptions): DynamicModule;
 }
 //#endregion
-export { type SeederCtor, SeederModule, type SeederModuleAsyncOptions, type SeederModuleOptions };
+export { type RunCallback, type SeederCtor, SeederModule, type SeederModuleAsyncOptions, type SeederModuleOptions };
 //# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../src/SeederModule.ts"],"mappings":";;;;;KAKY,UAAA,aAAuB,eAAA;AAAA,UAElB,mBAAA;EACf,OAAA,EAAS,UAAA;EACT,UAAA,GAAa,UAAA;EACb,SAAA;EALiC;;AAEnC;;;EASE,OAAA;EARA;;;;;;;;;EAkBA,OAAA;EASe;;;;;EAHf,gBAAA;AAAA;AAAA,UAGe,wBAAA;EACf,OAAA;EACA,MAAA;EACA,UAAA,MAAgB,IAAA,YAAgB,mBAAA,GAAsB,OAAA,CAAQ,mBAAA;AAAA;AAAA,cAInD,YAAA;EAAA,OACJ,OAAA,CAAQ,OAAA,EAAS,mBAAA,GAAsB,aAAA;EAAA,OAOvC,YAAA,CAAa,OAAA,EAAS,wBAAA,GAA2B,aAAA;AAAA"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/SeederModule.ts"],"mappings":";;;;;KAKY,UAAA,aAAuB,eAAA;AAAA,KAEvB,WAAA,IAAe,GAAA;EAAO,UAAA,EAAY,UAAA;AAAA,aAAwB,OAAA;AAAA,UAE5D,uBAAA,SAAgC,IAAA,CACxC,iBAAA;EALiC;;AAEnC;;EAUE,UAAA,GAAa,UAAA;EAV8D;EAY3E,SAAA;EAZ4C;;;;;EAkB5C,OAAA;AAAA;AAAA,UAGQ,0BAAA,SAAmC,uBAAA;EAlB3C;EAoBA,OAAA,EAAS,UAAA;EArB+B;;;;EA0BxC,GAAA,GAAM,WAAA;EAlBN;;;;;;AAQO;;;EAoBP,OAAA;EAVM;;;;;EAgBN,gBAAA;AAAA;AAAA,UAGQ,sBAAA,SAA+B,uBAAA;EACvC,OAAA;EAVA;;;EAcA,GAAA,EAAK,WAAA;EACL,OAAA;EACA,gBAAA;AAAA;AAAA,KAGU,mBAAA,GAAsB,0BAAA,GAA6B,sBAAA;AAAA,UAE9C,wBAAA;EACf,OAAA;EACA,MAAA;EACA,UAAA,MAAgB,IAAA,YAAgB,mBAAA,GAAsB,OAAA,CAAQ,mBAAA;AAAA;AAAA,cAInD,YAAA;EAAA,OACJ,OAAA,CAAQ,OAAA,EAAS,mBAAA,GAAsB,aAAA;EAAA,OAOvC,YAAA,CAAa,OAAA,EAAS,wBAAA,GAA2B,aAAA;AAAA"}

package/dist/index.mjs

@@ -35,29 +35,39 @@ let SeederRunnerService = _SeederRunnerService = class SeederRunnerService {
 	async onApplicationBootstrap() {
 		if (this.options.enabled === false) return;
 		const dataSource = await this.resolveDataSource();
-		const runOnce = this.options.runOnce ?? true;
-		const tableName = this.options.historyTableName ?? DEFAULT_HISTORY_TABLE;
-		let executedSeeders = /* @__PURE__ */ new Set();
-		if (runOnce) {
-			await this.ensureHistoryTable(dataSource, tableName);
-			executedSeeders = await this.getExecutedSeeders(dataSource, tableName);
+		if (this.options.seeders) {
+			const runOnce = this.options.runOnce ?? true;
+			const tableName = this.options.historyTableName ?? DEFAULT_HISTORY_TABLE;
+			let executedSeeders = /* @__PURE__ */ new Set();
+			if (runOnce) {
+				await this.ensureHistoryTable(dataSource, tableName);
+				executedSeeders = await this.getExecutedSeeders(dataSource, tableName);
+			}
+			await runSeeders(this.options.seeders, {
+				dataSource,
+				relations: this.options.relations,
+				logging: false,
+				skip: (seeder) => {
+					const shouldSkip = executedSeeders.has(seeder.name);
+					if (shouldSkip) this.logger.log(`[${seeder.name}] Skipping (already run)`);
+					return shouldSkip;
+				},
+				onBefore: async (seeder) => {
+					this.logger.log(`[${seeder.name}] Starting...`);
+					await this.options.onBefore?.(seeder);
+				},
+				onAfter: async (seeder, durationMs) => {
+					if (runOnce) await this.recordRun(dataSource, tableName, seeder.name);
+					this.logger.log(`[${seeder.name}] Done in ${durationMs}ms`);
+					await this.options.onAfter?.(seeder, durationMs);
+				},
+				onError: async (seeder, error) => {
+					this.logger.error(`[${seeder.name}] Failed`, error instanceof Error ? error.stack : String(error));
+					await this.options.onError?.(seeder, error);
+				}
+			});
 		}
-		await runSeeders(this.options.seeders, {
-			dataSource,
-			relations: this.options.relations,
-			logging: false,
-			skip: (seeder) => {
-				const shouldSkip = executedSeeders.has(seeder.name);
-				if (shouldSkip) this.logger.log(`[${seeder.name}] Skipping (already run)`);
-				return shouldSkip;
-			},
-			onBefore: (seeder) => this.logger.log(`[${seeder.name}] Starting...`),
-			onAfter: async (seeder, durationMs) => {
-				if (runOnce) await this.recordRun(dataSource, tableName, seeder.name);
-				this.logger.log(`[${seeder.name}] Done in ${durationMs}ms`);
-			},
-			onError: (seeder, error) => this.logger.error(`[${seeder.name}] Failed`, error instanceof Error ? error.stack : String(error))
-		});
+		if (this.options.run) await this.options.run({ dataSource });
 	}
 	async ensureHistoryTable(dataSource, tableName) {
 		await dataSource.query(`CREATE TABLE IF NOT EXISTS "${tableName}" (name VARCHAR(255) PRIMARY KEY NOT NULL, executed_at VARCHAR(32) NOT NULL)`);

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":[],"sources":["../src/SeederRunnerService.ts","../src/SeederModule.ts"],"sourcesContent":["import { Inject, Injectable, Logger, type OnApplicationBootstrap } from '@nestjs/common';\nimport { ModuleRef } from '@nestjs/core';\nimport { runSeeders } from '@joakimbugge/typeorm-seeder';\nimport { DataSource } from 'typeorm';\nimport type { SeederModuleOptions } from './SeederModule.js';\n\nexport const SEEDER_MODULE_OPTIONS = Symbol('SEEDER_MODULE_OPTIONS');\n\nconst DEFAULT_HISTORY_TABLE = 'seeders';\n\n@Injectable()\nexport class SeederRunnerService implements OnApplicationBootstrap {\n  private readonly logger = new Logger(SeederRunnerService.name);\n\n  constructor(\n    @Inject(SEEDER_MODULE_OPTIONS) private readonly options: SeederModuleOptions,\n    private readonly moduleRef: ModuleRef,\n  ) {}\n\n  async onApplicationBootstrap(): Promise<void> {\n    if (this.options.enabled === false) {\n      return;\n    }\n\n    const dataSource = await this.resolveDataSource();\n    const runOnce = this.options.runOnce ?? true;\n    const tableName = this.options.historyTableName ?? DEFAULT_HISTORY_TABLE;\n\n    let executedSeeders = new Set<string>();\n\n    if (runOnce) {\n      await this.ensureHistoryTable(dataSource, tableName);\n      executedSeeders = await this.getExecutedSeeders(dataSource, tableName);\n    }\n\n    await runSeeders(this.options.seeders, {\n      dataSource,\n      relations: this.options.relations,\n      logging: false,\n      skip: (seeder) => {\n        const shouldSkip = executedSeeders.has(seeder.name);\n\n        if (shouldSkip) {\n          this.logger.log(`[${seeder.name}] Skipping (already run)`);\n        }\n\n        return shouldSkip;\n      },\n      onBefore: (seeder) => this.logger.log(`[${seeder.name}] Starting...`),\n      onAfter: async (seeder, durationMs) => {\n        if (runOnce) {\n          await this.recordRun(dataSource, tableName, seeder.name);\n        }\n\n        this.logger.log(`[${seeder.name}] Done in ${durationMs}ms`);\n      },\n      onError: (seeder, error) =>\n        this.logger.error(\n          `[${seeder.name}] Failed`,\n          error instanceof Error ? error.stack : String(error),\n        ),\n    });\n  }\n\n  private async ensureHistoryTable(dataSource: DataSource, tableName: string): Promise<void> {\n    await dataSource.query(\n      `CREATE TABLE IF NOT EXISTS \"${tableName}\" (name VARCHAR(255) PRIMARY KEY NOT NULL, executed_at VARCHAR(32) NOT NULL)`,\n    );\n  }\n\n  private async getExecutedSeeders(\n    dataSource: DataSource,\n    tableName: string,\n  ): Promise<Set<string>> {\n    const rows: { name: string }[] = await dataSource.query(`SELECT name FROM \"${tableName}\"`);\n\n    return new Set(rows.map((r) => r.name));\n  }\n\n  private async recordRun(dataSource: DataSource, tableName: string, name: string): Promise<void> {\n    const executedAt = new Date().toISOString();\n\n    await dataSource.query(\n      `INSERT INTO \"${tableName}\" (name, executed_at) VALUES ('${name}', '${executedAt}')`,\n    );\n  }\n\n  private async resolveDataSource(): Promise<DataSource> {\n    if (this.options.dataSource) {\n      return this.options.dataSource;\n    }\n\n    try {\n      return this.moduleRef.get(DataSource, { strict: false });\n    } catch {\n      throw new Error(\n        'SeederModule could not resolve a DataSource. Either import TypeOrmModule or provide a dataSource in SeederModule options.',\n      );\n    }\n  }\n}\n","import { type DynamicModule, Module } from '@nestjs/common';\nimport type { SeederInterface } from '@joakimbugge/typeorm-seeder';\nimport type { DataSource } from 'typeorm';\nimport { SeederRunnerService, SEEDER_MODULE_OPTIONS } from './SeederRunnerService.js';\n\nexport type SeederCtor = new () => SeederInterface;\n\nexport interface SeederModuleOptions {\n  seeders: SeederCtor[];\n  dataSource?: DataSource;\n  relations?: boolean;\n  /**\n   * When `false`, seeding is skipped entirely. Useful for gating on an env var.\n   *\n   * @default true\n   */\n  enabled?: boolean;\n  /**\n   * Track executed seeders in a database table and skip them on subsequent boots.\n   * Set to `false` to always run every seeder regardless.\n   *\n   * When TypeORM's `dropSchema` is `true`, the history table is dropped with the\n   * rest of the schema on every start, so all seeders run regardless of this setting.\n   *\n   * @default true\n   */\n  runOnce?: boolean;\n  /**\n   * Name of the table used to track which seeders have run.\n   *\n   * @default 'seeders'\n   */\n  historyTableName?: string;\n}\n\nexport interface SeederModuleAsyncOptions {\n  imports?: any[];\n  inject?: any[];\n  useFactory: (...args: any[]) => SeederModuleOptions | Promise<SeederModuleOptions>;\n}\n\n@Module({})\nexport class SeederModule {\n  static forRoot(options: SeederModuleOptions): DynamicModule {\n    return {\n      module: SeederModule,\n      providers: [{ provide: SEEDER_MODULE_OPTIONS, useValue: options }, SeederRunnerService],\n    };\n  }\n\n  static forRootAsync(options: SeederModuleAsyncOptions): DynamicModule {\n    return {\n      module: SeederModule,\n      imports: options.imports ?? [],\n      providers: [\n        {\n          provide: SEEDER_MODULE_OPTIONS,\n          inject: options.inject ?? [],\n          useFactory: options.useFactory,\n        },\n        SeederRunnerService,\n      ],\n    };\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AAMA,MAAa,wBAAwB,OAAO,wBAAwB;AAEpE,MAAM,wBAAwB;AAGvB,IAAA,sBAAA,uBAAA,MAAM,oBAAsD;CAGjE,YACE,SACA,WACA;AAFgD,OAAA,UAAA;AAC/B,OAAA,YAAA;gBAJO,IAAI,OAAA,qBAA2B,KAAK;;CAO9D,MAAM,yBAAwC;AAC5C,MAAI,KAAK,QAAQ,YAAY,MAC3B;EAGF,MAAM,aAAa,MAAM,KAAK,mBAAmB;EACjD,MAAM,UAAU,KAAK,QAAQ,WAAW;EACxC,MAAM,YAAY,KAAK,QAAQ,oBAAoB;EAEnD,IAAI,kCAAkB,IAAI,KAAa;AAEvC,MAAI,SAAS;AACX,SAAM,KAAK,mBAAmB,YAAY,UAAU;AACpD,qBAAkB,MAAM,KAAK,mBAAmB,YAAY,UAAU;;AAGxE,QAAM,WAAW,KAAK,QAAQ,SAAS;GACrC;GACA,WAAW,KAAK,QAAQ;GACxB,SAAS;GACT,OAAO,WAAW;IAChB,MAAM,aAAa,gBAAgB,IAAI,OAAO,KAAK;AAEnD,QAAI,WACF,MAAK,OAAO,IAAI,IAAI,OAAO,KAAK,0BAA0B;AAG5D,WAAO;;GAET,WAAW,WAAW,KAAK,OAAO,IAAI,IAAI,OAAO,KAAK,eAAe;GACrE,SAAS,OAAO,QAAQ,eAAe;AACrC,QAAI,QACF,OAAM,KAAK,UAAU,YAAY,WAAW,OAAO,KAAK;AAG1D,SAAK,OAAO,IAAI,IAAI,OAAO,KAAK,YAAY,WAAW,IAAI;;GAE7D,UAAU,QAAQ,UAChB,KAAK,OAAO,MACV,IAAI,OAAO,KAAK,WAChB,iBAAiB,QAAQ,MAAM,QAAQ,OAAO,MAAM,CACrD;GACJ,CAAC;;CAGJ,MAAc,mBAAmB,YAAwB,WAAkC;AACzF,QAAM,WAAW,MACf,+BAA+B,UAAU,8EAC1C;;CAGH,MAAc,mBACZ,YACA,WACsB;EACtB,MAAM,OAA2B,MAAM,WAAW,MAAM,qBAAqB,UAAU,GAAG;AAE1F,SAAO,IAAI,IAAI,KAAK,KAAK,MAAM,EAAE,KAAK,CAAC;;CAGzC,MAAc,UAAU,YAAwB,WAAmB,MAA6B;EAC9F,MAAM,8BAAa,IAAI,MAAM,EAAC,aAAa;AAE3C,QAAM,WAAW,MACf,gBAAgB,UAAU,iCAAiC,KAAK,MAAM,WAAW,IAClF;;CAGH,MAAc,oBAAyC;AACrD,MAAI,KAAK,QAAQ,WACf,QAAO,KAAK,QAAQ;AAGtB,MAAI;AACF,UAAO,KAAK,UAAU,IAAI,YAAY,EAAE,QAAQ,OAAO,CAAC;UAClD;AACN,SAAM,IAAI,MACR,4HACD;;;;;CAvFN,YAAY;oBAKR,OAAO,sBAAsB,CAAA;;;;;;AC2B3B,IAAA,eAAA,gBAAA,MAAM,aAAa;CACxB,OAAO,QAAQ,SAA6C;AAC1D,SAAO;GACL,QAAA;GACA,WAAW,CAAC;IAAE,SAAS;IAAuB,UAAU;IAAS,EAAE,oBAAoB;GACxF;;CAGH,OAAO,aAAa,SAAkD;AACpE,SAAO;GACL,QAAA;GACA,SAAS,QAAQ,WAAW,EAAE;GAC9B,WAAW,CACT;IACE,SAAS;IACT,QAAQ,QAAQ,UAAU,EAAE;IAC5B,YAAY,QAAQ;IACrB,EACD,oBACD;GACF;;;2CArBJ,OAAO,EAAE,CAAC,CAAA,EAAA,aAAA"}
+{"version":3,"file":"index.mjs","names":[],"sources":["../src/SeederRunnerService.ts","../src/SeederModule.ts"],"sourcesContent":["import { Inject, Injectable, Logger, type OnApplicationBootstrap } from '@nestjs/common';\nimport { ModuleRef } from '@nestjs/core';\nimport { runSeeders } from '@joakimbugge/typeorm-seeder';\nimport { DataSource } from 'typeorm';\nimport type { SeederModuleOptions } from './SeederModule.js';\n\nexport const SEEDER_MODULE_OPTIONS = Symbol('SEEDER_MODULE_OPTIONS');\n\nconst DEFAULT_HISTORY_TABLE = 'seeders';\n\n@Injectable()\nexport class SeederRunnerService implements OnApplicationBootstrap {\n  private readonly logger = new Logger(SeederRunnerService.name);\n\n  constructor(\n    @Inject(SEEDER_MODULE_OPTIONS) private readonly options: SeederModuleOptions,\n    private readonly moduleRef: ModuleRef,\n  ) {}\n\n  async onApplicationBootstrap(): Promise<void> {\n    if (this.options.enabled === false) {\n      return;\n    }\n\n    const dataSource = await this.resolveDataSource();\n\n    if (this.options.seeders) {\n      const runOnce = this.options.runOnce ?? true;\n      const tableName = this.options.historyTableName ?? DEFAULT_HISTORY_TABLE;\n\n      let executedSeeders = new Set<string>();\n\n      if (runOnce) {\n        await this.ensureHistoryTable(dataSource, tableName);\n        executedSeeders = await this.getExecutedSeeders(dataSource, tableName);\n      }\n\n      await runSeeders(this.options.seeders, {\n        dataSource,\n        relations: this.options.relations,\n        logging: false,\n        skip: (seeder) => {\n          const shouldSkip = executedSeeders.has(seeder.name);\n\n          if (shouldSkip) {\n            this.logger.log(`[${seeder.name}] Skipping (already run)`);\n          }\n\n          return shouldSkip;\n        },\n        onBefore: async (seeder) => {\n          this.logger.log(`[${seeder.name}] Starting...`);\n          await this.options.onBefore?.(seeder);\n        },\n        onAfter: async (seeder, durationMs) => {\n          if (runOnce) {\n            await this.recordRun(dataSource, tableName, seeder.name);\n          }\n\n          this.logger.log(`[${seeder.name}] Done in ${durationMs}ms`);\n          await this.options.onAfter?.(seeder, durationMs);\n        },\n        onError: async (seeder, error) => {\n          this.logger.error(\n            `[${seeder.name}] Failed`,\n            error instanceof Error ? error.stack : String(error),\n          );\n          await this.options.onError?.(seeder, error);\n        },\n      });\n    }\n\n    if (this.options.run) {\n      await this.options.run({ dataSource });\n    }\n  }\n\n  private async ensureHistoryTable(dataSource: DataSource, tableName: string): Promise<void> {\n    await dataSource.query(\n      `CREATE TABLE IF NOT EXISTS \"${tableName}\" (name VARCHAR(255) PRIMARY KEY NOT NULL, executed_at VARCHAR(32) NOT NULL)`,\n    );\n  }\n\n  private async getExecutedSeeders(\n    dataSource: DataSource,\n    tableName: string,\n  ): Promise<Set<string>> {\n    const rows: { name: string }[] = await dataSource.query(`SELECT name FROM \"${tableName}\"`);\n\n    return new Set(rows.map((r) => r.name));\n  }\n\n  private async recordRun(dataSource: DataSource, tableName: string, name: string): Promise<void> {\n    const executedAt = new Date().toISOString();\n\n    await dataSource.query(\n      `INSERT INTO \"${tableName}\" (name, executed_at) VALUES ('${name}', '${executedAt}')`,\n    );\n  }\n\n  private async resolveDataSource(): Promise<DataSource> {\n    if (this.options.dataSource) {\n      return this.options.dataSource;\n    }\n\n    try {\n      return this.moduleRef.get(DataSource, { strict: false });\n    } catch {\n      throw new Error(\n        'SeederModule could not resolve a DataSource. Either import TypeOrmModule or provide a dataSource in SeederModule options.',\n      );\n    }\n  }\n}\n","import { type DynamicModule, Module } from '@nestjs/common';\nimport type { RunSeedersOptions, SeederInterface } from '@joakimbugge/typeorm-seeder';\nimport type { DataSource } from 'typeorm';\nimport { SeederRunnerService, SEEDER_MODULE_OPTIONS } from './SeederRunnerService.js';\n\nexport type SeederCtor = new () => SeederInterface;\n\nexport type RunCallback = (ctx: { dataSource: DataSource }) => void | Promise<void>;\n\ninterface SeederModuleBaseOptions extends Pick<\n  RunSeedersOptions,\n  'onBefore' | 'onAfter' | 'onError'\n> {\n  /**\n   * Explicit DataSource. When omitted, the module resolves the DataSource\n   * registered by `TypeOrmModule`.\n   */\n  dataSource?: DataSource;\n  /** Passed through to `runSeeders`. Set to `false` to skip relation seeding. */\n  relations?: boolean;\n  /**\n   * When `false`, seeding is skipped entirely. Useful for gating on an env var.\n   *\n   * @default true\n   */\n  enabled?: boolean;\n}\n\ninterface SeederModuleSeedersOptions extends SeederModuleBaseOptions {\n  /** Seeder classes to run. Transitive dependencies are resolved automatically. */\n  seeders: SeederCtor[];\n  /**\n   * Inline callback executed after all seeders have run. Always executes on\n   * every boot — `runOnce` does not apply to it.\n   */\n  run?: RunCallback;\n  /**\n   * Track executed seeders in a database table and skip them on subsequent boots.\n   * Set to `false` to always run every seeder regardless.\n   *\n   * When TypeORM's `dropSchema` is `true`, the history table is dropped with the\n   * rest of the schema on every start, so all seeders run regardless of this setting.\n   *\n   * @default true\n   */\n  runOnce?: boolean;\n  /**\n   * Name of the table used to track which seeders have run.\n   *\n   * @default 'seeders'\n   */\n  historyTableName?: string;\n}\n\ninterface SeederModuleRunOptions extends SeederModuleBaseOptions {\n  seeders?: never;\n  /**\n   * Inline callback executed on every boot. runOnce is false.\n   */\n  run: RunCallback;\n  runOnce?: false;\n  historyTableName?: never;\n}\n\nexport type SeederModuleOptions = SeederModuleSeedersOptions | SeederModuleRunOptions;\n\nexport interface SeederModuleAsyncOptions {\n  imports?: any[];\n  inject?: any[];\n  useFactory: (...args: any[]) => SeederModuleOptions | Promise<SeederModuleOptions>;\n}\n\n@Module({})\nexport class SeederModule {\n  static forRoot(options: SeederModuleOptions): DynamicModule {\n    return {\n      module: SeederModule,\n      providers: [{ provide: SEEDER_MODULE_OPTIONS, useValue: options }, SeederRunnerService],\n    };\n  }\n\n  static forRootAsync(options: SeederModuleAsyncOptions): DynamicModule {\n    return {\n      module: SeederModule,\n      imports: options.imports ?? [],\n      providers: [\n        {\n          provide: SEEDER_MODULE_OPTIONS,\n          inject: options.inject ?? [],\n          useFactory: options.useFactory,\n        },\n        SeederRunnerService,\n      ],\n    };\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AAMA,MAAa,wBAAwB,OAAO,wBAAwB;AAEpE,MAAM,wBAAwB;AAGvB,IAAA,sBAAA,uBAAA,MAAM,oBAAsD;CAGjE,YACE,SACA,WACA;AAFgD,OAAA,UAAA;AAC/B,OAAA,YAAA;gBAJO,IAAI,OAAA,qBAA2B,KAAK;;CAO9D,MAAM,yBAAwC;AAC5C,MAAI,KAAK,QAAQ,YAAY,MAC3B;EAGF,MAAM,aAAa,MAAM,KAAK,mBAAmB;AAEjD,MAAI,KAAK,QAAQ,SAAS;GACxB,MAAM,UAAU,KAAK,QAAQ,WAAW;GACxC,MAAM,YAAY,KAAK,QAAQ,oBAAoB;GAEnD,IAAI,kCAAkB,IAAI,KAAa;AAEvC,OAAI,SAAS;AACX,UAAM,KAAK,mBAAmB,YAAY,UAAU;AACpD,sBAAkB,MAAM,KAAK,mBAAmB,YAAY,UAAU;;AAGxE,SAAM,WAAW,KAAK,QAAQ,SAAS;IACrC;IACA,WAAW,KAAK,QAAQ;IACxB,SAAS;IACT,OAAO,WAAW;KAChB,MAAM,aAAa,gBAAgB,IAAI,OAAO,KAAK;AAEnD,SAAI,WACF,MAAK,OAAO,IAAI,IAAI,OAAO,KAAK,0BAA0B;AAG5D,YAAO;;IAET,UAAU,OAAO,WAAW;AAC1B,UAAK,OAAO,IAAI,IAAI,OAAO,KAAK,eAAe;AAC/C,WAAM,KAAK,QAAQ,WAAW,OAAO;;IAEvC,SAAS,OAAO,QAAQ,eAAe;AACrC,SAAI,QACF,OAAM,KAAK,UAAU,YAAY,WAAW,OAAO,KAAK;AAG1D,UAAK,OAAO,IAAI,IAAI,OAAO,KAAK,YAAY,WAAW,IAAI;AAC3D,WAAM,KAAK,QAAQ,UAAU,QAAQ,WAAW;;IAElD,SAAS,OAAO,QAAQ,UAAU;AAChC,UAAK,OAAO,MACV,IAAI,OAAO,KAAK,WAChB,iBAAiB,QAAQ,MAAM,QAAQ,OAAO,MAAM,CACrD;AACD,WAAM,KAAK,QAAQ,UAAU,QAAQ,MAAM;;IAE9C,CAAC;;AAGJ,MAAI,KAAK,QAAQ,IACf,OAAM,KAAK,QAAQ,IAAI,EAAE,YAAY,CAAC;;CAI1C,MAAc,mBAAmB,YAAwB,WAAkC;AACzF,QAAM,WAAW,MACf,+BAA+B,UAAU,8EAC1C;;CAGH,MAAc,mBACZ,YACA,WACsB;EACtB,MAAM,OAA2B,MAAM,WAAW,MAAM,qBAAqB,UAAU,GAAG;AAE1F,SAAO,IAAI,IAAI,KAAK,KAAK,MAAM,EAAE,KAAK,CAAC;;CAGzC,MAAc,UAAU,YAAwB,WAAmB,MAA6B;EAC9F,MAAM,8BAAa,IAAI,MAAM,EAAC,aAAa;AAE3C,QAAM,WAAW,MACf,gBAAgB,UAAU,iCAAiC,KAAK,MAAM,WAAW,IAClF;;CAGH,MAAc,oBAAyC;AACrD,MAAI,KAAK,QAAQ,WACf,QAAO,KAAK,QAAQ;AAGtB,MAAI;AACF,UAAO,KAAK,UAAU,IAAI,YAAY,EAAE,QAAQ,OAAO,CAAC;UAClD;AACN,SAAM,IAAI,MACR,4HACD;;;;;CApGN,YAAY;oBAKR,OAAO,sBAAsB,CAAA;;;;;;AC0D3B,IAAA,eAAA,gBAAA,MAAM,aAAa;CACxB,OAAO,QAAQ,SAA6C;AAC1D,SAAO;GACL,QAAA;GACA,WAAW,CAAC;IAAE,SAAS;IAAuB,UAAU;IAAS,EAAE,oBAAoB;GACxF;;CAGH,OAAO,aAAa,SAAkD;AACpE,SAAO;GACL,QAAA;GACA,SAAS,QAAQ,WAAW,EAAE;GAC9B,WAAW,CACT;IACE,SAAS;IACT,QAAQ,QAAQ,UAAU,EAAE;IAC5B,YAAY,QAAQ;IACrB,EACD,oBACD;GACF;;;2CArBJ,OAAO,EAAE,CAAC,CAAA,EAAA,aAAA"}

package/package.json

@@ -1,73 +1,72 @@
-{
-  "name": "@joakimbugge/nest-typeorm-seeder",
-  "version": "0.2.0",
-  "description": "NestJS module for @joakimbugge/typeorm-seeder",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/joakimbugge/to-seeder.git"
-  },
-  "homepage": "https://github.com/joakimbugge/to-seeder#readme",
-  "bugs": "https://github.com/joakimbugge/to-seeder/issues",
-  "type": "module",
-  "main": "./dist/index.cjs",
-  "module": "./dist/index.mjs",
-  "types": "./dist/index.d.mts",
-  "exports": {
-    ".": {
-      "import": {
-        "types": "./dist/index.d.mts",
-        "default": "./dist/index.mjs"
-      },
-      "require": {
-        "types": "./dist/index.d.cts",
-        "default": "./dist/index.cjs"
-      }
-    }
-  },
-  "files": [
-    "dist"
-  ],
-  "scripts": {
-    "build": "tsdown",
-    "prepublishOnly": "pnpm run build",
-    "dev": "tsdown --watch",
-    "typecheck": "tsc --noEmit",
-    "test": "vitest",
-    "test:run": "vitest run",
-    "lint": "oxlint src tests",
-    "lint:fix": "oxlint --fix src tests",
-    "fmt": "oxfmt src tests",
-    "fmt:check": "oxfmt --check src tests"
-  },
-  "keywords": [
-    "typeorm",
-    "seeder",
-    "decorator",
-    "database",
-    "seed",
-    "nestjs"
-  ],
-  "license": "MIT",
-  "engines": {
-    "node": ">=16.13.0"
-  },
-  "peerDependencies": {
-    "@nestjs/common": ">=10.0.0",
-    "@nestjs/core": ">=10.0.0",
-    "reflect-metadata": ">=0.1.0",
-    "typeorm": ">=0.3.0"
-  },
-  "devDependencies": {
-    "@faker-js/faker": "^10.4.0",
-    "@nestjs/common": "^11.0.0",
-    "@nestjs/core": "^11.0.0",
-    "@nestjs/testing": "^11.0.0",
-    "@types/better-sqlite3": "^7.6.13",
-    "better-sqlite3": "^12.8.0",
-    "reflect-metadata": "^0.2.2",
-    "typeorm": "1.0.0-beta.1"
-  },
-  "dependencies": {
-    "@joakimbugge/typeorm-seeder": "workspace:*"
-  }
-}
+{
+  "name": "@joakimbugge/nest-typeorm-seeder",
+  "version": "0.3.0",
+  "description": "NestJS module for @joakimbugge/typeorm-seeder",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/joakimbugge/to-seeder.git"
+  },
+  "homepage": "https://github.com/joakimbugge/to-seeder#readme",
+  "bugs": "https://github.com/joakimbugge/to-seeder/issues",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.mts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.mts",
+        "default": "./dist/index.mjs"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsdown",
+    "prepublishOnly": "pnpm run build",
+    "dev": "tsdown --watch",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest",
+    "test:run": "vitest run",
+    "lint": "oxlint src tests",
+    "lint:fix": "oxlint --fix src tests",
+    "fmt": "oxfmt src tests",
+    "fmt:check": "oxfmt --check src tests"
+  },
+  "keywords": [
+    "typeorm",
+    "seeder",
+    "decorator",
+    "database",
+    "seed",
+    "nestjs"
+  ],
+  "license": "MIT",
+  "engines": {
+    "node": ">=16.13.0"
+  },
+  "peerDependencies": {
+    "@joakimbugge/typeorm-seeder": ">=0.4.0",
+    "@nestjs/common": ">=10.0.0",
+    "@nestjs/core": ">=10.0.0",
+    "reflect-metadata": ">=0.1.0",
+    "typeorm": ">=0.3.0"
+  },
+  "devDependencies": {
+    "@joakimbugge/typeorm-seeder": "workspace:^",
+    "@faker-js/faker": "^10.4.0",
+    "@nestjs/common": "^11.0.0",
+    "@nestjs/core": "^11.0.0",
+    "@nestjs/testing": "^11.0.0",
+    "@types/better-sqlite3": "^7.6.13",
+    "better-sqlite3": "^12.8.0",
+    "reflect-metadata": "^0.2.2",
+    "typeorm": "1.0.0-beta.1"
+  }
+}