@joakimbugge/typeorm-seeder 0.4.1 → 0.6.0

package/dist/index.d.cts

@@ -27,8 +27,23 @@ interface SeedContext {
    */
   relations?: boolean;
 }
-/** Factory callback passed to @Seed. Receives the seeder context, which may include a DataSource. */
-type SeedFactory<T = unknown> = (context: SeedContext) => T | Promise<T>;
+/**
+ * Factory callback passed to `@Seed`. Receives the seed context and the partially built entity.
+ *
+ * Properties are seeded sequentially in declaration order, so any property declared above the
+ * current one is already set on `self` and can be read to derive the current value.
+ *
+ * Annotate `self` with the entity class to get full type inference — TypeScript infers
+ * `TEntity` from the annotation, so no cast is needed:
+ *
+ * @example
+ * @Seed(() => faker.date.past())
+ * beginDate!: Date
+ *
+ * @Seed((_, self: MyEntity) => faker.date.future({ refDate: self.beginDate }))
+ * endDate!: Date
+ */
+type SeedFactory<T = unknown, TEntity = any> = (context: SeedContext, self: TEntity) => T | Promise<T>;
 /** Options for the `@Seed` decorator. */
 interface SeedOptions {
   /**
@@ -86,51 +101,103 @@ declare function Seed(options: SeedOptions): PropertyDecorator;
  * @Seed(async ({ dataSource }) => dataSource.getRepository(Role).findOneByOrFail({ name: 'admin' }))
  * role!: Role
  */
-declare function Seed(factory: SeedFactory): PropertyDecorator;
+declare function Seed<TEntity = any>(factory: SeedFactory<unknown, TEntity>): PropertyDecorator;
 /** Marks a property with a factory callback and additional options. */
-declare function Seed(factory: SeedFactory, options: SeedOptions): PropertyDecorator;
+declare function Seed<TEntity = any>(factory: SeedFactory<unknown, TEntity>, options: SeedOptions): PropertyDecorator;
+//#endregion
+//#region src/seed/creator.d.ts
+/**
+ * Options for {@link create} and {@link createMany} on the single-class form.
+ * Extends {@link SeedContext} with a typed `values` override map.
+ */
+interface CreateOptions<T extends EntityInstance> extends SeedContext {
+  /**
+   * Property values to apply after all `@Seed` factories have run.
+   * Wins unconditionally — factories still execute but their output is overwritten.
+   * Also works for properties that have no `@Seed` decorator.
+   *
+   * @example
+   * const user = await dataSource.getRepository(User).findOneByOrFail({ name: 'Alice' })
+   * const post = await seed(Post).create({ values: { author: user } })
+   */
+  values?: Partial<T>;
+}
+/** Options for {@link createMany}. Extends {@link SeedContext} with a required instance count. */
+interface CreateManyOptions<T extends EntityInstance = EntityInstance> extends SeedContext {
+  count: number;
+  values?: Partial<T>;
+}
+/**
+ * Creates one entity instance in memory without persisting it.
+ *
+ * When passed an array of classes, relation seeding is disabled by default
+ * (pass `relations: true` in the context to override). Returns a tuple of
+ * instances in the same order as the input array.
+ */
+declare function create<T extends EntityInstance>(EntityClass: EntityConstructor<T>, options?: CreateOptions<T>): Promise<T>;
+declare function create<T extends readonly EntityConstructor[]>(EntityClasses: [...T], context?: SeedContext): Promise<MapToInstances<T>>;
+/**
+ * Creates multiple entity instances in memory without persisting them.
+ *
+ * When passed an array of classes, returns a tuple of arrays — one per class — each
+ * containing `count` instances. Relation seeding is disabled by default for the
+ * array variant; pass `relations: true` in the options to override.
+ */
+declare function createMany<T extends EntityInstance>(EntityClass: EntityConstructor<T>, options: CreateManyOptions<T>): Promise<T[]>;
+declare function createMany<T extends readonly EntityConstructor[]>(EntityClasses: [...T], options: CreateManyOptions): Promise<MapToInstanceArrays<T>>;
 //#endregion
 //#region src/seed/persist.d.ts
-/** Options for {@link saveSeed}. Extends {@link SeedContext} with a required DataSource. */
-interface SaveSeedOptions extends SeedContext {
+/** Options for {@link save}. Extends {@link SeedContext} with a required DataSource. */
+interface SaveOptions<T extends EntityInstance = EntityInstance> extends SeedContext {
   dataSource: DataSource;
+  /**
+   * Property values to apply to each entity after seeding and before persisting.
+   * Wins unconditionally over `@Seed` factory output — the factory still runs,
+   * but its result is overwritten. Also works for properties that have no `@Seed`
+   * decorator at all.
+   *
+   * @example
+   * const users = await dataSource.getRepository(User).find()
+   * const user = faker.helpers.arrayElement(users)
+   * await seed(Booking).saveMany(10, { dataSource, values: { user } })
+   */
+  values?: Partial<T>;
 }
-/** Options for {@link saveManySeed}. Extends {@link SaveSeedOptions} with a required instance count. */
-interface SaveManySeedOptions extends SaveSeedOptions {
+/** Options for {@link saveMany}. Extends {@link SaveOptions} with a required instance count. */
+interface SaveManyOptions<T extends EntityInstance = EntityInstance> extends SaveOptions<T> {
   count: number;
 }
 /**
  * Creates and persists a seed entity and all its seeded relations.
- * Delegates to {@link saveManySeed} with `count: 1` and unwraps the result.
  */
-declare function saveSeed<T extends EntityInstance>(EntityClass: EntityConstructor<T>, options: SaveSeedOptions): Promise<T>;
+declare function save<T extends EntityInstance>(EntityClass: EntityConstructor<T>, options: SaveOptions<T>): Promise<T>;
 /**
  * Creates and persists one instance of each entity class in the array.
  * Relation seeding is disabled by default; pass `relations: true` to override.
  */
-declare function saveSeed<T extends readonly EntityConstructor[]>(EntityClasses: [...T], options: SaveSeedOptions): Promise<MapToInstances<T>>;
+declare function save<T extends readonly EntityConstructor[]>(EntityClasses: [...T], options: SaveOptions): Promise<MapToInstances<T>>;
 /**
  * Creates and persists multiple seed entities of the same class.
- * Applies the same logic as {@link saveSeed} for each entity.
+ * Applies the same logic as {@link save} for each entity.
  */
-declare function saveManySeed<T extends EntityInstance>(EntityClass: EntityConstructor<T>, options: SaveManySeedOptions): Promise<T[]>;
+declare function saveMany<T extends EntityInstance>(EntityClass: EntityConstructor<T>, options: SaveManyOptions<T>): Promise<T[]>;
 /**
  * Creates and persists multiple instances of each entity class in the array.
  * Relation seeding is disabled by default; pass `relations: true` to override.
  */
-declare function saveManySeed<T extends readonly EntityConstructor[]>(EntityClasses: [...T], options: SaveManySeedOptions): Promise<MapToInstanceArrays<T>>;
+declare function saveMany<T extends readonly EntityConstructor[]>(EntityClasses: [...T], options: SaveManyOptions): Promise<MapToInstanceArrays<T>>;
 //#endregion
 //#region src/seed/builder.d.ts
 /** Seed builder for a single entity class. Returned by {@link seed} when passed one class. */
 interface SingleSeed<T extends EntityInstance> {
   /** Creates a single instance in memory without persisting. */
-  create(context?: SeedContext): Promise<T>;
+  create(context?: CreateOptions<T>): Promise<T>;
   /** Creates and persists a single instance. */
-  save(options: SaveSeedOptions): Promise<T>;
+  save(options: SaveOptions<T>): Promise<T>;
   /** Creates multiple instances in memory without persisting. */
-  createMany(count: number, context?: SeedContext): Promise<T[]>;
+  createMany(count: number, context?: CreateOptions<T>): Promise<T[]>;
   /** Creates and persists multiple instances. */
-  saveMany(count: number, options: SaveSeedOptions): Promise<T[]>;
+  saveMany(count: number, options: SaveOptions<T>): Promise<T[]>;
 }
 /**
  * Seed builder for multiple entity classes. Returned by {@link seed} when passed an array.
@@ -141,11 +208,11 @@ interface MultiSeed<T extends readonly EntityConstructor[]> {
   /** Creates one instance of each class in memory without persisting. */
   create(context?: SeedContext): Promise<MapToInstances<T>>;
   /** Creates and persists one instance of each class. */
-  save(options: SaveSeedOptions): Promise<MapToInstances<T>>;
+  save(options: SaveOptions): Promise<MapToInstances<T>>;
   /** Creates `count` instances of each class in memory without persisting. */
   createMany(count: number, context?: SeedContext): Promise<MapToInstanceArrays<T>>;
   /** Creates and persists `count` instances of each class. */
-  saveMany(count: number, options: SaveSeedOptions): Promise<MapToInstanceArrays<T>>;
+  saveMany(count: number, options: SaveOptions): Promise<MapToInstanceArrays<T>>;
 }
 /**
  * Entry point for creating and persisting seed data.
@@ -172,30 +239,6 @@ interface MultiSeed<T extends readonly EntityConstructor[]> {
 declare function seed<T extends EntityInstance>(EntityClass: EntityConstructor<T>): SingleSeed<T>;
 declare function seed<T extends readonly EntityConstructor[]>(EntityClasses: [...T]): MultiSeed<T>;
 //#endregion
-//#region src/seed/creator.d.ts
-/** Options for {@link createManySeed}. Extends {@link SeedContext} with a required instance count. */
-interface CreateManySeedOptions extends SeedContext {
-  count: number;
-}
-/**
- * Creates one entity instance in memory without persisting it.
- *
- * When passed an array of classes, relation seeding is disabled by default
- * (pass `relations: true` in the context to override). Returns a tuple of
- * instances in the same order as the input array.
- */
-declare function createSeed<T extends EntityInstance>(EntityClass: EntityConstructor<T>, context?: SeedContext): Promise<T>;
-declare function createSeed<T extends readonly EntityConstructor[]>(EntityClasses: [...T], context?: SeedContext): Promise<MapToInstances<T>>;
-/**
- * Creates multiple entity instances in memory without persisting them.
- *
- * When passed an array of classes, returns a tuple of arrays — one per class — each
- * containing `count` instances. Relation seeding is disabled by default for the
- * array variant; pass `relations: true` in the options to override.
- */
-declare function createManySeed<T extends EntityInstance>(EntityClass: EntityConstructor<T>, options: CreateManySeedOptions): Promise<T[]>;
-declare function createManySeed<T extends readonly EntityConstructor[]>(EntityClasses: [...T], options: CreateManySeedOptions): Promise<MapToInstanceArrays<T>>;
-//#endregion
 //#region src/seeder/decorator.d.ts
 /**
  * Interface that seeder classes must implement.
@@ -273,5 +316,5 @@ interface RunSeedersOptions extends SeedContext {
  */
 declare function runSeeders(seeders: SeederCtor[], options?: RunSeedersOptions): Promise<void>;
 //#endregion
-export { type CreateManySeedOptions, type EntityConstructor, type EntityInstance, type RunSeedersOptions, type SaveManySeedOptions, type SaveSeedOptions, Seed, type SeedContext, type SeedEntry, type SeedFactory, type SeedOptions, Seeder, type SeederCtor, type SeederInterface, type SeederOptions, createManySeed, createSeed, runSeeders, saveManySeed, saveSeed, seed };
+export { type CreateManyOptions, type CreateOptions, type EntityConstructor, type EntityInstance, type RunSeedersOptions, type SaveManyOptions, type SaveOptions, Seed, type SeedContext, type SeedEntry, type SeedFactory, type SeedOptions, Seeder, type SeederCtor, type SeederInterface, type SeederOptions, create, createMany, runSeeders, save, saveMany, seed };
 //# sourceMappingURL=index.d.cts.map

package/dist/index.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.cts","names":[],"sources":["../src/seed/registry.ts","../src/seed/decorator.ts","../src/seed/persist.ts","../src/seed/builder.ts","../src/seed/creator.ts","../src/seeder/decorator.ts","../src/seeder/runner.ts"],"mappings":"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"}
+{"version":3,"file":"index.d.cts","names":[],"sources":["../src/seed/registry.ts","../src/seed/decorator.ts","../src/seed/creator.ts","../src/seed/persist.ts","../src/seed/builder.ts","../src/seeder/decorator.ts","../src/seeder/runner.ts"],"mappings":"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"}

package/dist/index.d.mts

@@ -27,8 +27,23 @@ interface SeedContext {
    */
   relations?: boolean;
 }
-/** Factory callback passed to @Seed. Receives the seeder context, which may include a DataSource. */
-type SeedFactory<T = unknown> = (context: SeedContext) => T | Promise<T>;
+/**
+ * Factory callback passed to `@Seed`. Receives the seed context and the partially built entity.
+ *
+ * Properties are seeded sequentially in declaration order, so any property declared above the
+ * current one is already set on `self` and can be read to derive the current value.
+ *
+ * Annotate `self` with the entity class to get full type inference — TypeScript infers
+ * `TEntity` from the annotation, so no cast is needed:
+ *
+ * @example
+ * @Seed(() => faker.date.past())
+ * beginDate!: Date
+ *
+ * @Seed((_, self: MyEntity) => faker.date.future({ refDate: self.beginDate }))
+ * endDate!: Date
+ */
+type SeedFactory<T = unknown, TEntity = any> = (context: SeedContext, self: TEntity) => T | Promise<T>;
 /** Options for the `@Seed` decorator. */
 interface SeedOptions {
   /**
@@ -86,51 +101,103 @@ declare function Seed(options: SeedOptions): PropertyDecorator;
  * @Seed(async ({ dataSource }) => dataSource.getRepository(Role).findOneByOrFail({ name: 'admin' }))
  * role!: Role
  */
-declare function Seed(factory: SeedFactory): PropertyDecorator;
+declare function Seed<TEntity = any>(factory: SeedFactory<unknown, TEntity>): PropertyDecorator;
 /** Marks a property with a factory callback and additional options. */
-declare function Seed(factory: SeedFactory, options: SeedOptions): PropertyDecorator;
+declare function Seed<TEntity = any>(factory: SeedFactory<unknown, TEntity>, options: SeedOptions): PropertyDecorator;
+//#endregion
+//#region src/seed/creator.d.ts
+/**
+ * Options for {@link create} and {@link createMany} on the single-class form.
+ * Extends {@link SeedContext} with a typed `values` override map.
+ */
+interface CreateOptions<T extends EntityInstance> extends SeedContext {
+  /**
+   * Property values to apply after all `@Seed` factories have run.
+   * Wins unconditionally — factories still execute but their output is overwritten.
+   * Also works for properties that have no `@Seed` decorator.
+   *
+   * @example
+   * const user = await dataSource.getRepository(User).findOneByOrFail({ name: 'Alice' })
+   * const post = await seed(Post).create({ values: { author: user } })
+   */
+  values?: Partial<T>;
+}
+/** Options for {@link createMany}. Extends {@link SeedContext} with a required instance count. */
+interface CreateManyOptions<T extends EntityInstance = EntityInstance> extends SeedContext {
+  count: number;
+  values?: Partial<T>;
+}
+/**
+ * Creates one entity instance in memory without persisting it.
+ *
+ * When passed an array of classes, relation seeding is disabled by default
+ * (pass `relations: true` in the context to override). Returns a tuple of
+ * instances in the same order as the input array.
+ */
+declare function create<T extends EntityInstance>(EntityClass: EntityConstructor<T>, options?: CreateOptions<T>): Promise<T>;
+declare function create<T extends readonly EntityConstructor[]>(EntityClasses: [...T], context?: SeedContext): Promise<MapToInstances<T>>;
+/**
+ * Creates multiple entity instances in memory without persisting them.
+ *
+ * When passed an array of classes, returns a tuple of arrays — one per class — each
+ * containing `count` instances. Relation seeding is disabled by default for the
+ * array variant; pass `relations: true` in the options to override.
+ */
+declare function createMany<T extends EntityInstance>(EntityClass: EntityConstructor<T>, options: CreateManyOptions<T>): Promise<T[]>;
+declare function createMany<T extends readonly EntityConstructor[]>(EntityClasses: [...T], options: CreateManyOptions): Promise<MapToInstanceArrays<T>>;
 //#endregion
 //#region src/seed/persist.d.ts
-/** Options for {@link saveSeed}. Extends {@link SeedContext} with a required DataSource. */
-interface SaveSeedOptions extends SeedContext {
+/** Options for {@link save}. Extends {@link SeedContext} with a required DataSource. */
+interface SaveOptions<T extends EntityInstance = EntityInstance> extends SeedContext {
   dataSource: DataSource;
+  /**
+   * Property values to apply to each entity after seeding and before persisting.
+   * Wins unconditionally over `@Seed` factory output — the factory still runs,
+   * but its result is overwritten. Also works for properties that have no `@Seed`
+   * decorator at all.
+   *
+   * @example
+   * const users = await dataSource.getRepository(User).find()
+   * const user = faker.helpers.arrayElement(users)
+   * await seed(Booking).saveMany(10, { dataSource, values: { user } })
+   */
+  values?: Partial<T>;
 }
-/** Options for {@link saveManySeed}. Extends {@link SaveSeedOptions} with a required instance count. */
-interface SaveManySeedOptions extends SaveSeedOptions {
+/** Options for {@link saveMany}. Extends {@link SaveOptions} with a required instance count. */
+interface SaveManyOptions<T extends EntityInstance = EntityInstance> extends SaveOptions<T> {
   count: number;
 }
 /**
  * Creates and persists a seed entity and all its seeded relations.
- * Delegates to {@link saveManySeed} with `count: 1` and unwraps the result.
  */
-declare function saveSeed<T extends EntityInstance>(EntityClass: EntityConstructor<T>, options: SaveSeedOptions): Promise<T>;
+declare function save<T extends EntityInstance>(EntityClass: EntityConstructor<T>, options: SaveOptions<T>): Promise<T>;
 /**
  * Creates and persists one instance of each entity class in the array.
  * Relation seeding is disabled by default; pass `relations: true` to override.
  */
-declare function saveSeed<T extends readonly EntityConstructor[]>(EntityClasses: [...T], options: SaveSeedOptions): Promise<MapToInstances<T>>;
+declare function save<T extends readonly EntityConstructor[]>(EntityClasses: [...T], options: SaveOptions): Promise<MapToInstances<T>>;
 /**
  * Creates and persists multiple seed entities of the same class.
- * Applies the same logic as {@link saveSeed} for each entity.
+ * Applies the same logic as {@link save} for each entity.
  */
-declare function saveManySeed<T extends EntityInstance>(EntityClass: EntityConstructor<T>, options: SaveManySeedOptions): Promise<T[]>;
+declare function saveMany<T extends EntityInstance>(EntityClass: EntityConstructor<T>, options: SaveManyOptions<T>): Promise<T[]>;
 /**
  * Creates and persists multiple instances of each entity class in the array.
  * Relation seeding is disabled by default; pass `relations: true` to override.
  */
-declare function saveManySeed<T extends readonly EntityConstructor[]>(EntityClasses: [...T], options: SaveManySeedOptions): Promise<MapToInstanceArrays<T>>;
+declare function saveMany<T extends readonly EntityConstructor[]>(EntityClasses: [...T], options: SaveManyOptions): Promise<MapToInstanceArrays<T>>;
 //#endregion
 //#region src/seed/builder.d.ts
 /** Seed builder for a single entity class. Returned by {@link seed} when passed one class. */
 interface SingleSeed<T extends EntityInstance> {
   /** Creates a single instance in memory without persisting. */
-  create(context?: SeedContext): Promise<T>;
+  create(context?: CreateOptions<T>): Promise<T>;
   /** Creates and persists a single instance. */
-  save(options: SaveSeedOptions): Promise<T>;
+  save(options: SaveOptions<T>): Promise<T>;
   /** Creates multiple instances in memory without persisting. */
-  createMany(count: number, context?: SeedContext): Promise<T[]>;
+  createMany(count: number, context?: CreateOptions<T>): Promise<T[]>;
   /** Creates and persists multiple instances. */
-  saveMany(count: number, options: SaveSeedOptions): Promise<T[]>;
+  saveMany(count: number, options: SaveOptions<T>): Promise<T[]>;
 }
 /**
  * Seed builder for multiple entity classes. Returned by {@link seed} when passed an array.
@@ -141,11 +208,11 @@ interface MultiSeed<T extends readonly EntityConstructor[]> {
   /** Creates one instance of each class in memory without persisting. */
   create(context?: SeedContext): Promise<MapToInstances<T>>;
   /** Creates and persists one instance of each class. */
-  save(options: SaveSeedOptions): Promise<MapToInstances<T>>;
+  save(options: SaveOptions): Promise<MapToInstances<T>>;
   /** Creates `count` instances of each class in memory without persisting. */
   createMany(count: number, context?: SeedContext): Promise<MapToInstanceArrays<T>>;
   /** Creates and persists `count` instances of each class. */
-  saveMany(count: number, options: SaveSeedOptions): Promise<MapToInstanceArrays<T>>;
+  saveMany(count: number, options: SaveOptions): Promise<MapToInstanceArrays<T>>;
 }
 /**
  * Entry point for creating and persisting seed data.
@@ -172,30 +239,6 @@ interface MultiSeed<T extends readonly EntityConstructor[]> {
 declare function seed<T extends EntityInstance>(EntityClass: EntityConstructor<T>): SingleSeed<T>;
 declare function seed<T extends readonly EntityConstructor[]>(EntityClasses: [...T]): MultiSeed<T>;
 //#endregion
-//#region src/seed/creator.d.ts
-/** Options for {@link createManySeed}. Extends {@link SeedContext} with a required instance count. */
-interface CreateManySeedOptions extends SeedContext {
-  count: number;
-}
-/**
- * Creates one entity instance in memory without persisting it.
- *
- * When passed an array of classes, relation seeding is disabled by default
- * (pass `relations: true` in the context to override). Returns a tuple of
- * instances in the same order as the input array.
- */
-declare function createSeed<T extends EntityInstance>(EntityClass: EntityConstructor<T>, context?: SeedContext): Promise<T>;
-declare function createSeed<T extends readonly EntityConstructor[]>(EntityClasses: [...T], context?: SeedContext): Promise<MapToInstances<T>>;
-/**
- * Creates multiple entity instances in memory without persisting them.
- *
- * When passed an array of classes, returns a tuple of arrays — one per class — each
- * containing `count` instances. Relation seeding is disabled by default for the
- * array variant; pass `relations: true` in the options to override.
- */
-declare function createManySeed<T extends EntityInstance>(EntityClass: EntityConstructor<T>, options: CreateManySeedOptions): Promise<T[]>;
-declare function createManySeed<T extends readonly EntityConstructor[]>(EntityClasses: [...T], options: CreateManySeedOptions): Promise<MapToInstanceArrays<T>>;
-//#endregion
 //#region src/seeder/decorator.d.ts
 /**
  * Interface that seeder classes must implement.
@@ -273,5 +316,5 @@ interface RunSeedersOptions extends SeedContext {
  */
 declare function runSeeders(seeders: SeederCtor[], options?: RunSeedersOptions): Promise<void>;
 //#endregion
-export { type CreateManySeedOptions, type EntityConstructor, type EntityInstance, type RunSeedersOptions, type SaveManySeedOptions, type SaveSeedOptions, Seed, type SeedContext, type SeedEntry, type SeedFactory, type SeedOptions, Seeder, type SeederCtor, type SeederInterface, type SeederOptions, createManySeed, createSeed, runSeeders, saveManySeed, saveSeed, seed };
+export { type CreateManyOptions, type CreateOptions, type EntityConstructor, type EntityInstance, type RunSeedersOptions, type SaveManyOptions, type SaveOptions, Seed, type SeedContext, type SeedEntry, type SeedFactory, type SeedOptions, Seeder, type SeederCtor, type SeederInterface, type SeederOptions, create, createMany, runSeeders, save, saveMany, seed };
 //# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../src/seed/registry.ts","../src/seed/decorator.ts","../src/seed/persist.ts","../src/seed/builder.ts","../src/seed/creator.ts","../src/seeder/decorator.ts","../src/seeder/runner.ts"],"mappings":"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"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/seed/registry.ts","../src/seed/decorator.ts","../src/seed/creator.ts","../src/seed/persist.ts","../src/seed/builder.ts","../src/seeder/decorator.ts","../src/seeder/runner.ts"],"mappings":"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"}

package/dist/index.mjs

@@ -68,7 +68,7 @@ function getClassHierarchy(target) {
 * 3. Bare relation decorators (`@Seed()` without a factory) — skipped when `relations` is `false`,
 *    and also skipped for any related class already present in the ancestor chain (circular guard).
 */
-async function createOneSeed(EntityClass, context) {
+async function createOne(EntityClass, context) {
 	const instance = new EntityClass();
 	const ancestors = getAncestors(context);
 	const childContext = withAncestor(context, EntityClass);
@@ -78,14 +78,14 @@ async function createOneSeed(EntityClass, context) {
 	const record = instance;
 	for (const { propertyKey, factory } of getSeeds(EntityClass)) {
 		if (!factory) continue;
-		record[propertyKey] = await factory(context);
+		record[propertyKey] = await factory(context, instance);
 		seededProperties.add(propertyKey);
 	}
 	for (const embedded of storage.filterEmbeddeds(EntityClass)) {
 		if (seededProperties.has(embedded.propertyName)) continue;
 		const EmbeddedClass = embedded.type();
 		if (getSeeds(EmbeddedClass).length > 0) {
-			record[embedded.propertyName] = await createOneSeed(EmbeddedClass, context);
+			record[embedded.propertyName] = await createOne(EmbeddedClass, context);
 			seededProperties.add(embedded.propertyName);
 		}
 	}
@@ -96,38 +96,39 @@ async function createOneSeed(EntityClass, context) {
 		if (!relation || typeof relation.type !== "function") continue;
 		const RelatedClass = relation.type();
 		if (ancestors.has(RelatedClass)) continue;
-		if (relation.relationType === "one-to-many" || relation.relationType === "many-to-many") record[propertyKey] = await createManySeed(RelatedClass, {
+		if (relation.relationType === "one-to-many" || relation.relationType === "many-to-many") record[propertyKey] = await createMany(RelatedClass, {
 			count: options.count ?? 1,
 			...childContext
 		});
-		else record[propertyKey] = await createOneSeed(RelatedClass, childContext);
+		else record[propertyKey] = await createOne(RelatedClass, childContext);
 		seededProperties.add(propertyKey);
 	}
 	return instance;
 }
-async function createSeed(classOrClasses, context = {}) {
+async function create(classOrClasses, options = {}) {
 	if (Array.isArray(classOrClasses)) {
 		const effectiveContext = {
 			relations: false,
-			...context
+			...options
 		};
-		return await Promise.all(classOrClasses.map((cls) => createOneSeed(cls, effectiveContext)));
+		return await Promise.all(classOrClasses.map((cls) => createOne(cls, effectiveContext)));
 	}
-	const [entity] = await createManySeed(classOrClasses, {
-		count: 1,
-		...context
-	});
-	return entity;
+	const { values, ...context } = options;
+	const instance = await createOne(classOrClasses, context);
+	if (values) Object.assign(instance, values);
+	return instance;
 }
-async function createManySeed(classOrClasses, { count, ...context }) {
+async function createMany(classOrClasses, { count, values, ...context }) {
 	if (Array.isArray(classOrClasses)) {
 		const effectiveContext = {
 			relations: false,
 			...context
 		};
-		return await Promise.all(classOrClasses.map((cls) => Promise.all(Array.from({ length: count }, () => createOneSeed(cls, effectiveContext)))));
+		return await Promise.all(classOrClasses.map((cls) => Promise.all(Array.from({ length: count }, () => createOne(cls, effectiveContext)))));
 	}
-	return await Promise.all(Array.from({ length: count }, () => createOneSeed(classOrClasses, context)));
+	const instances = await Promise.all(Array.from({ length: count }, () => createOne(classOrClasses, context)));
+	if (values) instances.forEach((e) => Object.assign(e, values));
+	return instances;
 }
 //#endregion
 //#region src/seed/persist.ts
@@ -177,40 +178,43 @@ function enableCascadeInsert(EntityClass, dataSource) {
 function restoreCascade(states) {
 	for (const { relation, original } of states) relation.isCascadeInsert = original;
 }
-async function saveSeed(classOrClasses, options) {
+async function save(classOrClasses, options) {
 	if (Array.isArray(classOrClasses)) {
 		const effectiveOptions = {
 			relations: false,
 			...options,
 			count: 1
 		};
-		return await Promise.all(classOrClasses.map((cls) => saveManySeed(cls, effectiveOptions).then(([entity]) => entity)));
+		return await Promise.all(classOrClasses.map((cls) => saveBatch(cls, effectiveOptions).then(([entity]) => entity)));
 	}
-	const [entity] = await saveManySeed(classOrClasses, {
+	const [entity] = await saveBatch(classOrClasses, {
 		...options,
 		count: 1
 	});
 	return entity;
 }
-async function saveManySeed(classOrClasses, options) {
+async function saveMany(classOrClasses, options) {
 	if (Array.isArray(classOrClasses)) {
 		const effectiveOptions = {
 			relations: false,
 			...options
 		};
-		return await Promise.all(classOrClasses.map((cls) => saveManySeedOne(cls, effectiveOptions)));
+		return await Promise.all(classOrClasses.map((cls) => saveBatch(cls, effectiveOptions)));
 	}
-	return await saveManySeedOne(classOrClasses, options);
+	return await saveBatch(classOrClasses, options);
 }
 /**
-* Creates and persists `count` instances of a single entity class.
+* Creates and persists `count` instances of a single entity class in one batched
+* `repository.save()` call. Batching is intentional — it is more efficient than
+* saving each instance individually, as TypeORM can consolidate the inserts.
+*
 * Enables cascade inserts on every entity class in the object graph before saving,
 * then restores the original flags — regardless of whether the save succeeds or fails.
 */
-async function saveManySeedOne(EntityClass, options) {
+async function saveBatch(EntityClass, options) {
 	const { count, dataSource } = options;
 	if (count === 0) return [];
-	const entities = await createManySeed(EntityClass, options);
+	const entities = await createMany(EntityClass, options);
 	const visited = /* @__PURE__ */ new Set();
 	const states = entities.flatMap((entity) => collectEntityClasses(entity, visited)).flatMap((cls) => enableCascadeInsert(cls, dataSource));
 	try {
@@ -225,13 +229,13 @@ function seed(classOrClasses) {
 	if (Array.isArray(classOrClasses)) {
 		const classes = classOrClasses;
 		return {
-			create: (context) => createSeed(classes, context),
-			save: (options) => saveSeed(classes, options),
-			createMany: (count, context) => createManySeed(classes, {
+			create: (context) => create(classes, context),
+			save: (options) => save(classes, options),
+			createMany: (count, context) => createMany(classes, {
 				count,
 				...context
 			}),
-			saveMany: (count, options) => saveManySeed(classes, {
+			saveMany: (count, options) => saveMany(classes, {
 				count,
 				...options
 			})
@@ -239,13 +243,13 @@ function seed(classOrClasses) {
 	}
 	const EntityClass = classOrClasses;
 	return {
-		create: (context) => createSeed(EntityClass, context),
-		save: (options) => saveSeed(EntityClass, options),
-		createMany: (count, context) => createManySeed(EntityClass, {
+		create: (options) => create(EntityClass, options),
+		save: (options) => save(EntityClass, options),
+		createMany: (count, options) => createMany(EntityClass, {
 			count,
-			...context
+			...options
 		}),
-		saveMany: (count, options) => saveManySeed(EntityClass, {
+		saveMany: (count, options) => saveMany(EntityClass, {
 			count,
 			...options
 		})
@@ -354,6 +358,6 @@ async function runSeeders(seeders, options = {}) {
 	}
 }
 //#endregion
-export { Seed, Seeder, createManySeed, createSeed, runSeeders, saveManySeed, saveSeed, seed };
+export { Seed, Seeder, create, createMany, runSeeders, save, saveMany, seed };
 
 //# sourceMappingURL=index.mjs.map