@geekmidas/testkit 10.0.0-alpha.4 → 10.0.0-alpha.41

package/dist/ObjectionFactory-Cf2WI4o_.d.mts

@@ -1,241 +0,0 @@
-import { FakerFactory } from "./faker-B6bmbGCM.mjs";
-import { ExtractSeedAttrs, Factory, FactorySeed } from "./Factory-C15SSK8_.mjs";
-import { Knex } from "knex";
-import { Model } from "objection";
-
-//#region src/ObjectionFactory.d.ts
-
-/**
- * Factory implementation for Objection.js ORM, providing test data creation utilities.
- * Extends the base Factory class with Objection.js-specific database operations.
- *
- * @template Builders - Record of builder functions for creating entities
- * @template Seeds - Record of seed functions for complex test scenarios
- *
- * @example
- * ```typescript
- * // Define your models with Objection.js
- * class User extends Model {
- *   static tableName = 'users';
- * }
- *
- * // Create builders
- * const builders = {
- *   user: ObjectionFactory.createBuilder(User, ({ attrs, faker }) => ({
- *     id: faker.string.uuid(),
- *     name: faker.person.fullName(),
- *     email: faker.internet.email(),
- *     ...attrs
- *   })),
- *   post: ObjectionFactory.createBuilder(Post, ({ attrs }) => ({
- *     title: 'Test Post',
- *     content: 'Test content',
- *     ...attrs
- *   })),
- * };
- *
- * // Create factory instance
- * const factory = new ObjectionFactory(builders, seeds, knex);
- *
- * // Use in tests
- * const user = await factory.insert('user', { name: 'John Doe' });
- * ```
- */
-declare class ObjectionFactory<Builders extends Record<string, any>, Seeds extends Record<string, any>> extends Factory<Builders, Seeds> {
-  private builders;
-  private seeds;
-  private db;
-  /**
-   * Creates a typed seed function with proper type inference.
-   * Inherits from the base Factory class implementation.
-   *
-   * @template Seed - The seed function type
-   * @param seedFn - The seed function to wrap (receives { attrs, factory, db } object)
-   * @returns The same seed function with proper typing
-   *
-   * @example
-   * ```typescript
-   * const seeds = {
-   *   userWithPosts: ObjectionFactory.createSeed(
-   *     async ({ attrs, factory }) => {
-   *       const user = await factory.insert('user', attrs);
-   *       await factory.insertMany(3, 'post', { userId: user.id });
-   *       return user;
-   *     },
-   *   ),
-   * };
-   * ```
-   */
-  static createSeed<Seed extends FactorySeed>(seedFn: Seed): Seed;
-  /**
-   * Creates a typed builder function for Objection.js models.
-   * This is a utility method that helps create builders with proper type inference.
-   *
-   * @template TModel - The Objection.js Model class type
-   * @template Attrs - The attributes type for the builder (defaults to Partial of model)
-   * @template Factory - The factory instance type
-   * @template Result - The result type (defaults to the model instance)
-   *
-   * @param ModelClass - The Objection.js Model class
-   * @param defaults - Optional function to provide default values (receives destructured context)
-   * @param autoInsert - Whether to automatically insert the record (default: true)
-   * @returns A builder function that creates and optionally inserts records
-   *
-   * @example
-   * ```typescript
-   * // Create a simple builder with defaults - destructure only what you need
-   * const userBuilder = ObjectionFactory.createBuilder(User,
-   *   ({ attrs, faker }) => ({
-   *     id: faker.string.uuid(),
-   *     name: faker.person.fullName(),
-   *     email: faker.internet.email(),
-   *     createdAt: new Date(),
-   *     ...attrs
-   *   })
-   * );
-   *
-   * // Only need faker? Just destructure that
-   * const leaveTypeBuilder = ObjectionFactory.createBuilder(LeaveType,
-   *   ({ faker }) => ({
-   *     name: faker.helpers.arrayElement(['Annual', 'Sick', 'Maternity']),
-   *     code: faker.string.alpha({ length: 3, casing: 'upper' }),
-   *   })
-   * );
-   *
-   * // Create a builder that doesn't auto-insert (useful for nested inserts)
-   * const addressBuilder = ObjectionFactory.createBuilder(Address,
-   *   ({ attrs }) => ({
-   *     street: '123 Main St',
-   *     city: 'Anytown',
-   *     ...attrs
-   *   }),
-   *   false // Don't auto-insert
-   * );
-   *
-   * // Use with relations
-   * const postBuilder = ObjectionFactory.createBuilder(Post,
-   *   async ({ attrs, factory, faker }) => ({
-   *     title: faker.lorem.sentence(),
-   *     content: faker.lorem.paragraphs(),
-   *     authorId: attrs.authorId || (await factory.insert('user')).id,
-   *     ...attrs
-   *   })
-   * );
-   * ```
-   */
-  static createBuilder<TModel extends typeof Model, Attrs extends Partial<InstanceType<TModel>> = Partial<InstanceType<TModel>>, Factory = any, Result = InstanceType<TModel>>(ModelClass: TModel, defaults?: (context: {
-    attrs: Attrs;
-    factory: Factory;
-    db: Knex;
-    faker: FakerFactory;
-  }) => Partial<InstanceType<TModel>> | Promise<Partial<InstanceType<TModel>>>, autoInsert?: boolean): (attrs: Attrs, factory: Factory, db: Knex, faker: FakerFactory) => Promise<Result>;
-  /**
-   * Creates a new ObjectionFactory instance.
-   *
-   * @param builders - Record of builder functions for creating individual entities
-   * @param seeds - Record of seed functions for creating complex test scenarios
-   * @param db - Knex database connection instance
-   */
-  constructor(builders: Builders, seeds: Seeds, db: Knex);
-  /**
-   * Inserts a single record into the database using the specified builder.
-   * Uses Objection.js's insertGraph method to handle nested relations.
-   *
-   * @template K - The builder name (must be a key of Builders)
-   * @param builderName - The name of the builder to use
-   * @param attrs - Optional attributes to override builder defaults
-   * @returns A promise resolving to the inserted record with all relations
-   * @throws Error if the specified builder doesn't exist
-   *
-   * @example
-   * ```typescript
-   * // Insert with defaults
-   * const user = await factory.insert('user');
-   *
-   * // Insert with overrides
-   * const adminUser = await factory.insert('user', {
-   *   email: 'admin@example.com',
-   *   role: 'admin'
-   * });
-   *
-   * // Insert with nested relations
-   * const userWithProfile = await factory.insert('user', {
-   *   name: 'John Doe',
-   *   profile: {
-   *     bio: 'Software Developer',
-   *     avatar: 'avatar.jpg'
-   *   }
-   * });
-   * ```
-   */
-  insert<K extends keyof Builders>(builderName: K, attrs?: Parameters<Builders[K]>[0]): Promise<Awaited<ReturnType<Builders[K]>>>;
-  /**
-   * Inserts multiple records into the database using the specified builder.
-   * Supports both static attributes and dynamic attribute generation via a function.
-   *
-   * @param count - The number of records to insert
-   * @param builderName - The name of the builder to use
-   * @param attrs - Static attributes or a function that generates attributes for each record
-   * @returns A promise resolving to an array of inserted records
-   * @throws Error if the specified builder doesn't exist
-   *
-   * @example
-   * ```typescript
-   * // Insert multiple with same attributes
-   * const users = await factory.insertMany(5, 'user', { role: 'member' });
-   *
-   * // Insert multiple with dynamic attributes
-   * const posts = await factory.insertMany(10, 'post', (idx) => ({
-   *   title: `Post ${idx + 1}`,
-   *   content: `Content for post ${idx + 1}`,
-   *   publishedAt: new Date()
-   * }));
-   *
-   * // Create users with sequential emails
-   * const admins = await factory.insertMany(3, 'user', (idx) => ({
-   *   email: `admin${idx + 1}@example.com`,
-   *   role: 'admin'
-   * }));
-   * ```
-   */
-  insertMany<K extends keyof Builders>(count: number, builderName: K, attrs?: Parameters<Builders[K]>[0]): Promise<Awaited<ReturnType<Builders[K]>>[]>;
-  insertMany<K extends keyof Builders>(count: number, builderName: K, attrs: (idx: number, faker: FakerFactory) => Parameters<Builders[K]>[0]): Promise<Awaited<ReturnType<Builders[K]>>[]>;
-  /**
-   * Executes a seed function to create complex test scenarios with multiple related records.
-   * Seeds are useful for setting up complete test environments with realistic data relationships.
-   *
-   * @template K - The seed name (must be a key of Seeds)
-   * @param seedName - The name of the seed to execute
-   * @param attrs - Optional configuration attributes for the seed
-   * @returns The result of the seed function (typically the primary record created)
-   * @throws Error if the specified seed doesn't exist
-   *
-   * @example
-   * ```typescript
-   * // Execute a simple seed
-   * const user = await factory.seed('userWithProfile');
-   *
-   * // Execute a seed with configuration
-   * const author = await factory.seed('authorWithBooks', {
-   *   bookCount: 5,
-   *   includeReviews: true
-   * });
-   *
-   * // Use seed result in tests with Objection.js relations
-   * const company = await factory.seed('companyWithDepartments', {
-   *   departmentCount: 3,
-   *   employeesPerDepartment: 10
-   * });
-   *
-   * // Access eager loaded relations
-   * const companyWithRelations = await Company.query()
-   *   .findById(company.id)
-   *   .withGraphFetched('[departments.employees]');
-   * ```
-   */
-  seed<K extends keyof Seeds>(seedName: K, attrs?: ExtractSeedAttrs<Seeds[K]>): ReturnType<Seeds[K]>;
-}
-//# sourceMappingURL=ObjectionFactory.d.ts.map
-//#endregion
-export { ObjectionFactory };
-//# sourceMappingURL=ObjectionFactory-Cf2WI4o_.d.mts.map

package/dist/ObjectionFactory-Cf2WI4o_.d.mts.map

@@ -1 +0,0 @@
-{"version":3,"file":"ObjectionFactory-Cf2WI4o_.d.mts","names":[],"sources":["../src/ObjectionFactory.ts"],"sourcesContent":[],"mappings":";;;;;;;;;AAyCA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA0Gc,cA1GD,gBA0GC,CAAA,iBAzGI,MAyGJ,CAAA,MAAA,EAAA,GAAA,CAAA,EAAA,cAxGC,MAwGD,CAAA,MAAA,EAAA,GAAA,CAAA,CAAA,SAvGJ,OAuGI,CAvGI,QAuGJ,EAvGc,KAuGd,CAAA,CAAA;EAAM,QAAd,QAAA;EAAO,QAqDO,KAAA;EAAQ,QACX,EAAA;EAAK;;;;;;;;;;;;;;;;;;;;;EA2GX,OACuB,UAAA,CAAA,aAnPO,WAmPP,CAAA,CAAA,MAAA,EAnP4B,IAmP5B,CAAA,EAnPmC,IAmPnC;EAAQ;;;;;;;;;;;;;;;;;;;AAzQzB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;6CAmFO,qBACR,QAAQ,aAAa,WAAW,QAAQ,aAAa,kCAE1D,aAAa,qBAEV;WAEJ;aACE;QACL;WACG;QAEL,QAAQ,aAAa,WACrB,QAAQ,QAAQ,aAAa,0CAGzB,gBACE,aACL,aACG,iBACH,QAAQ;;;;;;;;wBAqDM,iBACH,WACH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;yBAoCgB,uBACf,WACL,WAAW,SAAS,SAC1B,QAAQ,QAAQ,WAAW,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;6BA+DN,sCAEnB,WACL,WAAW,SAAS,SAC1B,QAAQ,QAAQ,WAAW,SAAS;6BACN,sCAEnB,+BACe,iBAAiB,WAAW,SAAS,SAC/D,QAAQ,QAAQ,WAAW,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;uBAgFlB,iBACV,WACF,iBAAiB,MAAM,MAC7B,WAAW,MAAM"}

package/dist/ObjectionFactory-QCJ7u0Ql.mjs

@@ -1,267 +0,0 @@
-import { Factory } from "./Factory-BFVnMMCC.mjs";
-import { faker } from "./faker-BGKYFoCT.mjs";
-
-//#region src/ObjectionFactory.ts
-/**
-* Factory implementation for Objection.js ORM, providing test data creation utilities.
-* Extends the base Factory class with Objection.js-specific database operations.
-*
-* @template Builders - Record of builder functions for creating entities
-* @template Seeds - Record of seed functions for complex test scenarios
-*
-* @example
-* ```typescript
-* // Define your models with Objection.js
-* class User extends Model {
-*   static tableName = 'users';
-* }
-*
-* // Create builders
-* const builders = {
-*   user: ObjectionFactory.createBuilder(User, ({ attrs, faker }) => ({
-*     id: faker.string.uuid(),
-*     name: faker.person.fullName(),
-*     email: faker.internet.email(),
-*     ...attrs
-*   })),
-*   post: ObjectionFactory.createBuilder(Post, ({ attrs }) => ({
-*     title: 'Test Post',
-*     content: 'Test content',
-*     ...attrs
-*   })),
-* };
-*
-* // Create factory instance
-* const factory = new ObjectionFactory(builders, seeds, knex);
-*
-* // Use in tests
-* const user = await factory.insert('user', { name: 'John Doe' });
-* ```
-*/
-var ObjectionFactory = class extends Factory {
-	/**
-	* Creates a typed seed function with proper type inference.
-	* Inherits from the base Factory class implementation.
-	*
-	* @template Seed - The seed function type
-	* @param seedFn - The seed function to wrap (receives { attrs, factory, db } object)
-	* @returns The same seed function with proper typing
-	*
-	* @example
-	* ```typescript
-	* const seeds = {
-	*   userWithPosts: ObjectionFactory.createSeed(
-	*     async ({ attrs, factory }) => {
-	*       const user = await factory.insert('user', attrs);
-	*       await factory.insertMany(3, 'post', { userId: user.id });
-	*       return user;
-	*     },
-	*   ),
-	* };
-	* ```
-	*/
-	static createSeed(seedFn) {
-		return Factory.createSeed(seedFn);
-	}
-	/**
-	* Creates a typed builder function for Objection.js models.
-	* This is a utility method that helps create builders with proper type inference.
-	*
-	* @template TModel - The Objection.js Model class type
-	* @template Attrs - The attributes type for the builder (defaults to Partial of model)
-	* @template Factory - The factory instance type
-	* @template Result - The result type (defaults to the model instance)
-	*
-	* @param ModelClass - The Objection.js Model class
-	* @param defaults - Optional function to provide default values (receives destructured context)
-	* @param autoInsert - Whether to automatically insert the record (default: true)
-	* @returns A builder function that creates and optionally inserts records
-	*
-	* @example
-	* ```typescript
-	* // Create a simple builder with defaults - destructure only what you need
-	* const userBuilder = ObjectionFactory.createBuilder(User,
-	*   ({ attrs, faker }) => ({
-	*     id: faker.string.uuid(),
-	*     name: faker.person.fullName(),
-	*     email: faker.internet.email(),
-	*     createdAt: new Date(),
-	*     ...attrs
-	*   })
-	* );
-	*
-	* // Only need faker? Just destructure that
-	* const leaveTypeBuilder = ObjectionFactory.createBuilder(LeaveType,
-	*   ({ faker }) => ({
-	*     name: faker.helpers.arrayElement(['Annual', 'Sick', 'Maternity']),
-	*     code: faker.string.alpha({ length: 3, casing: 'upper' }),
-	*   })
-	* );
-	*
-	* // Create a builder that doesn't auto-insert (useful for nested inserts)
-	* const addressBuilder = ObjectionFactory.createBuilder(Address,
-	*   ({ attrs }) => ({
-	*     street: '123 Main St',
-	*     city: 'Anytown',
-	*     ...attrs
-	*   }),
-	*   false // Don't auto-insert
-	* );
-	*
-	* // Use with relations
-	* const postBuilder = ObjectionFactory.createBuilder(Post,
-	*   async ({ attrs, factory, faker }) => ({
-	*     title: faker.lorem.sentence(),
-	*     content: faker.lorem.paragraphs(),
-	*     authorId: attrs.authorId || (await factory.insert('user')).id,
-	*     ...attrs
-	*   })
-	* );
-	* ```
-	*/
-	static createBuilder(ModelClass, defaults, autoInsert) {
-		return async (attrs, factory, db, fakerInstance) => {
-			let data = { ...attrs };
-			if (defaults) {
-				const defaultValues = await defaults({
-					attrs,
-					factory,
-					db,
-					faker: fakerInstance
-				});
-				data = {
-					...defaultValues,
-					...data
-				};
-			}
-			const model = ModelClass.fromJson(data);
-			if (autoInsert !== false) {
-				const insertData = Object.entries(model).reduce((acc, [key, value]) => {
-					if (value !== void 0 && key !== "id") acc[key] = value;
-					return acc;
-				}, {});
-				const result = await ModelClass.query(db).insert(insertData);
-				return result;
-			} else return model;
-		};
-	}
-	/**
-	* Creates a new ObjectionFactory instance.
-	*
-	* @param builders - Record of builder functions for creating individual entities
-	* @param seeds - Record of seed functions for creating complex test scenarios
-	* @param db - Knex database connection instance
-	*/
-	constructor(builders, seeds, db) {
-		super();
-		this.builders = builders;
-		this.seeds = seeds;
-		this.db = db;
-	}
-	/**
-	* Inserts a single record into the database using the specified builder.
-	* Uses Objection.js's insertGraph method to handle nested relations.
-	*
-	* @template K - The builder name (must be a key of Builders)
-	* @param builderName - The name of the builder to use
-	* @param attrs - Optional attributes to override builder defaults
-	* @returns A promise resolving to the inserted record with all relations
-	* @throws Error if the specified builder doesn't exist
-	*
-	* @example
-	* ```typescript
-	* // Insert with defaults
-	* const user = await factory.insert('user');
-	*
-	* // Insert with overrides
-	* const adminUser = await factory.insert('user', {
-	*   email: 'admin@example.com',
-	*   role: 'admin'
-	* });
-	*
-	* // Insert with nested relations
-	* const userWithProfile = await factory.insert('user', {
-	*   name: 'John Doe',
-	*   profile: {
-	*     bio: 'Software Developer',
-	*     avatar: 'avatar.jpg'
-	*   }
-	* });
-	* ```
-	*/
-	async insert(builderName, attrs) {
-		if (!(builderName in this.builders)) throw new Error(`Factory "${builderName}" does not exist. Make sure it is correct and registered in src/test/setup.ts`);
-		const result = await this.builders[builderName](attrs || {}, this, this.db, faker);
-		if (result && typeof result.$query === "function") {
-			const insertData = Object.entries(result).reduce((acc, [key, value]) => {
-				if (value !== void 0 && key !== "id") acc[key] = value;
-				return acc;
-			}, {});
-			return await result.constructor.query(this.db).insert(insertData);
-		}
-		return result;
-	}
-	async insertMany(count, builderName, attrs) {
-		if (!(builderName in this.builders)) throw new Error(`Builder "${builderName}" is not registered in this factory. Make sure it is correct and registered in src/test/setup.ts`);
-		const records = [];
-		for (let i = 0; i < count; i++) {
-			const newAttrs = typeof attrs === "function" ? await attrs(i, faker) : attrs;
-			records.push(this.builders[builderName](newAttrs, this, this.db, faker).then((record) => {
-				if (record && typeof record.$query === "function") {
-					const insertData = Object.entries(record).reduce((acc, [key, value]) => {
-						if (value !== void 0 && key !== "id") acc[key] = value;
-						return acc;
-					}, {});
-					return record.constructor.query(this.db).insert(insertData);
-				}
-				return record;
-			}));
-		}
-		return Promise.all(records);
-	}
-	/**
-	* Executes a seed function to create complex test scenarios with multiple related records.
-	* Seeds are useful for setting up complete test environments with realistic data relationships.
-	*
-	* @template K - The seed name (must be a key of Seeds)
-	* @param seedName - The name of the seed to execute
-	* @param attrs - Optional configuration attributes for the seed
-	* @returns The result of the seed function (typically the primary record created)
-	* @throws Error if the specified seed doesn't exist
-	*
-	* @example
-	* ```typescript
-	* // Execute a simple seed
-	* const user = await factory.seed('userWithProfile');
-	*
-	* // Execute a seed with configuration
-	* const author = await factory.seed('authorWithBooks', {
-	*   bookCount: 5,
-	*   includeReviews: true
-	* });
-	*
-	* // Use seed result in tests with Objection.js relations
-	* const company = await factory.seed('companyWithDepartments', {
-	*   departmentCount: 3,
-	*   employeesPerDepartment: 10
-	* });
-	*
-	* // Access eager loaded relations
-	* const companyWithRelations = await Company.query()
-	*   .findById(company.id)
-	*   .withGraphFetched('[departments.employees]');
-	* ```
-	*/
-	seed(seedName, attrs) {
-		if (!(seedName in this.seeds)) throw new Error(`Seed "${seedName}" is not registered in this factory. Make sure it is correct and registered in src/test/setup.ts`);
-		return this.seeds[seedName]({
-			attrs: attrs || {},
-			factory: this,
-			db: this.db
-		});
-	}
-};
-
-//#endregion
-export { ObjectionFactory };
-//# sourceMappingURL=ObjectionFactory-QCJ7u0Ql.mjs.map

package/dist/ObjectionFactory-QCJ7u0Ql.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"ObjectionFactory-QCJ7u0Ql.mjs","names":["seedFn: Seed","ModelClass: TModel","defaults?: (context: {\n\t\t\tattrs: Attrs;\n\t\t\tfactory: Factory;\n\t\t\tdb: Knex;\n\t\t\tfaker: FakerFactory;\n\t\t}) =>\n\t\t\t| Partial<InstanceType<TModel>>\n\t\t\t| Promise<Partial<InstanceType<TModel>>>","autoInsert?: boolean","attrs: Attrs","factory: Factory","db: Knex","fakerInstance: FakerFactory","data: Partial<InstanceType<TModel>>","builders: Builders","seeds: Seeds","builderName: K","attrs?: Parameters<Builders[K]>[0]","count: number","attrs?: any","records: any[]","record: any","seedName: K","attrs?: ExtractSeedAttrs<Seeds[K]>"],"sources":["../src/ObjectionFactory.ts"],"sourcesContent":["import type { Knex } from 'knex';\nimport type { Model } from 'objection';\nimport { type ExtractSeedAttrs, Factory, type FactorySeed } from './Factory';\nimport { type FakerFactory, faker } from './faker';\n\n/**\n * Factory implementation for Objection.js ORM, providing test data creation utilities.\n * Extends the base Factory class with Objection.js-specific database operations.\n *\n * @template Builders - Record of builder functions for creating entities\n * @template Seeds - Record of seed functions for complex test scenarios\n *\n * @example\n * ```typescript\n * // Define your models with Objection.js\n * class User extends Model {\n *   static tableName = 'users';\n * }\n *\n * // Create builders\n * const builders = {\n *   user: ObjectionFactory.createBuilder(User, ({ attrs, faker }) => ({\n *     id: faker.string.uuid(),\n *     name: faker.person.fullName(),\n *     email: faker.internet.email(),\n *     ...attrs\n *   })),\n *   post: ObjectionFactory.createBuilder(Post, ({ attrs }) => ({\n *     title: 'Test Post',\n *     content: 'Test content',\n *     ...attrs\n *   })),\n * };\n *\n * // Create factory instance\n * const factory = new ObjectionFactory(builders, seeds, knex);\n *\n * // Use in tests\n * const user = await factory.insert('user', { name: 'John Doe' });\n * ```\n */\nexport class ObjectionFactory<\n\tBuilders extends Record<string, any>,\n\tSeeds extends Record<string, any>,\n> extends Factory<Builders, Seeds> {\n\t/**\n\t * Creates a typed seed function with proper type inference.\n\t * Inherits from the base Factory class implementation.\n\t *\n\t * @template Seed - The seed function type\n\t * @param seedFn - The seed function to wrap (receives { attrs, factory, db } object)\n\t * @returns The same seed function with proper typing\n\t *\n\t * @example\n\t * ```typescript\n\t * const seeds = {\n\t *   userWithPosts: ObjectionFactory.createSeed(\n\t *     async ({ attrs, factory }) => {\n\t *       const user = await factory.insert('user', attrs);\n\t *       await factory.insertMany(3, 'post', { userId: user.id });\n\t *       return user;\n\t *     },\n\t *   ),\n\t * };\n\t * ```\n\t */\n\tstatic override createSeed<Seed extends FactorySeed>(seedFn: Seed): Seed {\n\t\treturn Factory.createSeed(seedFn);\n\t}\n\n\t/**\n\t * Creates a typed builder function for Objection.js models.\n\t * This is a utility method that helps create builders with proper type inference.\n\t *\n\t * @template TModel - The Objection.js Model class type\n\t * @template Attrs - The attributes type for the builder (defaults to Partial of model)\n\t * @template Factory - The factory instance type\n\t * @template Result - The result type (defaults to the model instance)\n\t *\n\t * @param ModelClass - The Objection.js Model class\n\t * @param defaults - Optional function to provide default values (receives destructured context)\n\t * @param autoInsert - Whether to automatically insert the record (default: true)\n\t * @returns A builder function that creates and optionally inserts records\n\t *\n\t * @example\n\t * ```typescript\n\t * // Create a simple builder with defaults - destructure only what you need\n\t * const userBuilder = ObjectionFactory.createBuilder(User,\n\t *   ({ attrs, faker }) => ({\n\t *     id: faker.string.uuid(),\n\t *     name: faker.person.fullName(),\n\t *     email: faker.internet.email(),\n\t *     createdAt: new Date(),\n\t *     ...attrs\n\t *   })\n\t * );\n\t *\n\t * // Only need faker? Just destructure that\n\t * const leaveTypeBuilder = ObjectionFactory.createBuilder(LeaveType,\n\t *   ({ faker }) => ({\n\t *     name: faker.helpers.arrayElement(['Annual', 'Sick', 'Maternity']),\n\t *     code: faker.string.alpha({ length: 3, casing: 'upper' }),\n\t *   })\n\t * );\n\t *\n\t * // Create a builder that doesn't auto-insert (useful for nested inserts)\n\t * const addressBuilder = ObjectionFactory.createBuilder(Address,\n\t *   ({ attrs }) => ({\n\t *     street: '123 Main St',\n\t *     city: 'Anytown',\n\t *     ...attrs\n\t *   }),\n\t *   false // Don't auto-insert\n\t * );\n\t *\n\t * // Use with relations\n\t * const postBuilder = ObjectionFactory.createBuilder(Post,\n\t *   async ({ attrs, factory, faker }) => ({\n\t *     title: faker.lorem.sentence(),\n\t *     content: faker.lorem.paragraphs(),\n\t *     authorId: attrs.authorId || (await factory.insert('user')).id,\n\t *     ...attrs\n\t *   })\n\t * );\n\t * ```\n\t */\n\tstatic createBuilder<\n\t\tTModel extends typeof Model,\n\t\tAttrs extends Partial<InstanceType<TModel>> = Partial<InstanceType<TModel>>,\n\t\tFactory = any,\n\t\tResult = InstanceType<TModel>,\n\t>(\n\t\tModelClass: TModel,\n\t\tdefaults?: (context: {\n\t\t\tattrs: Attrs;\n\t\t\tfactory: Factory;\n\t\t\tdb: Knex;\n\t\t\tfaker: FakerFactory;\n\t\t}) =>\n\t\t\t| Partial<InstanceType<TModel>>\n\t\t\t| Promise<Partial<InstanceType<TModel>>>,\n\t\tautoInsert?: boolean,\n\t): (\n\t\tattrs: Attrs,\n\t\tfactory: Factory,\n\t\tdb: Knex,\n\t\tfaker: FakerFactory,\n\t) => Promise<Result> {\n\t\treturn async (\n\t\t\tattrs: Attrs,\n\t\t\tfactory: Factory,\n\t\t\tdb: Knex,\n\t\t\tfakerInstance: FakerFactory,\n\t\t) => {\n\t\t\t// Start with attributes\n\t\t\tlet data: Partial<InstanceType<TModel>> = { ...attrs };\n\n\t\t\t// Apply defaults\n\t\t\tif (defaults) {\n\t\t\t\tconst defaultValues = await defaults({\n\t\t\t\t\tattrs,\n\t\t\t\t\tfactory,\n\t\t\t\t\tdb,\n\t\t\t\t\tfaker: fakerInstance,\n\t\t\t\t});\n\t\t\t\tdata = { ...defaultValues, ...data };\n\t\t\t}\n\n\t\t\t// Create model instance\n\t\t\tconst model = ModelClass.fromJson(data) as InstanceType<TModel>;\n\n\t\t\t// Handle insertion based on autoInsert flag\n\t\t\tif (autoInsert !== false) {\n\t\t\t\t// Auto insert is enabled by default\n\t\t\t\t// Extract only defined values for insertion\n\t\t\t\tconst insertData = Object.entries(model).reduce((acc, [key, value]) => {\n\t\t\t\t\tif (value !== undefined && key !== 'id') {\n\t\t\t\t\t\tacc[key] = value;\n\t\t\t\t\t}\n\t\t\t\t\treturn acc;\n\t\t\t\t}, {} as any);\n\n\t\t\t\t// Use static query method to insert data directly\n\t\t\t\tconst result = await ModelClass.query(db).insert(insertData);\n\t\t\t\treturn result as Result;\n\t\t\t} else {\n\t\t\t\t// Return model for factory to handle insertion\n\t\t\t\treturn model as Result;\n\t\t\t}\n\t\t};\n\t}\n\n\t/**\n\t * Creates a new ObjectionFactory instance.\n\t *\n\t * @param builders - Record of builder functions for creating individual entities\n\t * @param seeds - Record of seed functions for creating complex test scenarios\n\t * @param db - Knex database connection instance\n\t */\n\tconstructor(\n\t\tprivate builders: Builders,\n\t\tprivate seeds: Seeds,\n\t\tprivate db: Knex,\n\t) {\n\t\tsuper();\n\t}\n\n\t/**\n\t * Inserts a single record into the database using the specified builder.\n\t * Uses Objection.js's insertGraph method to handle nested relations.\n\t *\n\t * @template K - The builder name (must be a key of Builders)\n\t * @param builderName - The name of the builder to use\n\t * @param attrs - Optional attributes to override builder defaults\n\t * @returns A promise resolving to the inserted record with all relations\n\t * @throws Error if the specified builder doesn't exist\n\t *\n\t * @example\n\t * ```typescript\n\t * // Insert with defaults\n\t * const user = await factory.insert('user');\n\t *\n\t * // Insert with overrides\n\t * const adminUser = await factory.insert('user', {\n\t *   email: 'admin@example.com',\n\t *   role: 'admin'\n\t * });\n\t *\n\t * // Insert with nested relations\n\t * const userWithProfile = await factory.insert('user', {\n\t *   name: 'John Doe',\n\t *   profile: {\n\t *     bio: 'Software Developer',\n\t *     avatar: 'avatar.jpg'\n\t *   }\n\t * });\n\t * ```\n\t */\n\tasync insert<K extends keyof Builders>(\n\t\tbuilderName: K,\n\t\tattrs?: Parameters<Builders[K]>[0],\n\t): Promise<Awaited<ReturnType<Builders[K]>>> {\n\t\tif (!(builderName in this.builders)) {\n\t\t\tthrow new Error(\n\t\t\t\t`Factory \"${\n\t\t\t\t\tbuilderName as string\n\t\t\t\t}\" does not exist. Make sure it is correct and registered in src/test/setup.ts`,\n\t\t\t);\n\t\t}\n\n\t\tconst result = await this.builders[builderName](\n\t\t\tattrs || {},\n\t\t\tthis,\n\t\t\tthis.db,\n\t\t\tfaker,\n\t\t);\n\n\t\t// If the builder returns a model instance, insert it\n\t\tif (result && typeof result.$query === 'function') {\n\t\t\t// Extract data from model, excluding undefined values and id\n\t\t\tconst insertData = Object.entries(result).reduce((acc, [key, value]) => {\n\t\t\t\tif (value !== undefined && key !== 'id') {\n\t\t\t\t\tacc[key] = value;\n\t\t\t\t}\n\t\t\t\treturn acc;\n\t\t\t}, {} as any);\n\n\t\t\t// Use the model's constructor to get the query builder\n\t\t\treturn await result.constructor.query(this.db).insert(insertData);\n\t\t}\n\n\t\t// Otherwise, assume the builder handled insertion itself\n\t\treturn result;\n\t}\n\t/**\n\t * Inserts multiple records into the database using the specified builder.\n\t * Supports both static attributes and dynamic attribute generation via a function.\n\t *\n\t * @param count - The number of records to insert\n\t * @param builderName - The name of the builder to use\n\t * @param attrs - Static attributes or a function that generates attributes for each record\n\t * @returns A promise resolving to an array of inserted records\n\t * @throws Error if the specified builder doesn't exist\n\t *\n\t * @example\n\t * ```typescript\n\t * // Insert multiple with same attributes\n\t * const users = await factory.insertMany(5, 'user', { role: 'member' });\n\t *\n\t * // Insert multiple with dynamic attributes\n\t * const posts = await factory.insertMany(10, 'post', (idx) => ({\n\t *   title: `Post ${idx + 1}`,\n\t *   content: `Content for post ${idx + 1}`,\n\t *   publishedAt: new Date()\n\t * }));\n\t *\n\t * // Create users with sequential emails\n\t * const admins = await factory.insertMany(3, 'user', (idx) => ({\n\t *   email: `admin${idx + 1}@example.com`,\n\t *   role: 'admin'\n\t * }));\n\t * ```\n\t */\n\t// Method overloads for better type inference\n\tasync insertMany<K extends keyof Builders>(\n\t\tcount: number,\n\t\tbuilderName: K,\n\t\tattrs?: Parameters<Builders[K]>[0],\n\t): Promise<Awaited<ReturnType<Builders[K]>>[]>;\n\tasync insertMany<K extends keyof Builders>(\n\t\tcount: number,\n\t\tbuilderName: K,\n\t\tattrs: (idx: number, faker: FakerFactory) => Parameters<Builders[K]>[0],\n\t): Promise<Awaited<ReturnType<Builders[K]>>[]>;\n\tasync insertMany<K extends keyof Builders>(\n\t\tcount: number,\n\t\tbuilderName: K,\n\t\tattrs?: any,\n\t): Promise<Awaited<ReturnType<Builders[K]>>[]> {\n\t\tif (!(builderName in this.builders)) {\n\t\t\tthrow new Error(\n\t\t\t\t`Builder \"${\n\t\t\t\t\tbuilderName as string\n\t\t\t\t}\" is not registered in this factory. Make sure it is correct and registered in src/test/setup.ts`,\n\t\t\t);\n\t\t}\n\n\t\tconst records: any[] = [];\n\t\tfor (let i = 0; i < count; i++) {\n\t\t\tconst newAttrs =\n\t\t\t\ttypeof attrs === 'function' ? await (attrs as any)(i, faker) : attrs;\n\n\t\t\trecords.push(\n\t\t\t\tthis.builders[builderName](newAttrs, this, this.db, faker).then(\n\t\t\t\t\t(record: any) => {\n\t\t\t\t\t\t// If the builder returns a model instance, insert it\n\t\t\t\t\t\tif (record && typeof record.$query === 'function') {\n\t\t\t\t\t\t\t// Extract data from model, excluding undefined values and id\n\t\t\t\t\t\t\tconst insertData = Object.entries(record).reduce(\n\t\t\t\t\t\t\t\t(acc, [key, value]) => {\n\t\t\t\t\t\t\t\t\tif (value !== undefined && key !== 'id') {\n\t\t\t\t\t\t\t\t\t\tacc[key] = value;\n\t\t\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\t\t\treturn acc;\n\t\t\t\t\t\t\t\t},\n\t\t\t\t\t\t\t\t{} as any,\n\t\t\t\t\t\t\t);\n\n\t\t\t\t\t\t\t// Use the model's constructor to get the query builder\n\t\t\t\t\t\t\treturn record.constructor.query(this.db).insert(insertData);\n\t\t\t\t\t\t}\n\t\t\t\t\t\t// Otherwise, assume the builder handled insertion itself\n\t\t\t\t\t\treturn record;\n\t\t\t\t\t},\n\t\t\t\t),\n\t\t\t);\n\t\t}\n\n\t\treturn Promise.all(records);\n\t}\n\t/**\n\t * Executes a seed function to create complex test scenarios with multiple related records.\n\t * Seeds are useful for setting up complete test environments with realistic data relationships.\n\t *\n\t * @template K - The seed name (must be a key of Seeds)\n\t * @param seedName - The name of the seed to execute\n\t * @param attrs - Optional configuration attributes for the seed\n\t * @returns The result of the seed function (typically the primary record created)\n\t * @throws Error if the specified seed doesn't exist\n\t *\n\t * @example\n\t * ```typescript\n\t * // Execute a simple seed\n\t * const user = await factory.seed('userWithProfile');\n\t *\n\t * // Execute a seed with configuration\n\t * const author = await factory.seed('authorWithBooks', {\n\t *   bookCount: 5,\n\t *   includeReviews: true\n\t * });\n\t *\n\t * // Use seed result in tests with Objection.js relations\n\t * const company = await factory.seed('companyWithDepartments', {\n\t *   departmentCount: 3,\n\t *   employeesPerDepartment: 10\n\t * });\n\t *\n\t * // Access eager loaded relations\n\t * const companyWithRelations = await Company.query()\n\t *   .findById(company.id)\n\t *   .withGraphFetched('[departments.employees]');\n\t * ```\n\t */\n\tseed<K extends keyof Seeds>(\n\t\tseedName: K,\n\t\tattrs?: ExtractSeedAttrs<Seeds[K]>,\n\t): ReturnType<Seeds[K]> {\n\t\tif (!(seedName in this.seeds)) {\n\t\t\tthrow new Error(\n\t\t\t\t`Seed \"${\n\t\t\t\t\tseedName as string\n\t\t\t\t}\" is not registered in this factory. Make sure it is correct and registered in src/test/setup.ts`,\n\t\t\t);\n\t\t}\n\n\t\treturn this.seeds[seedName]({\n\t\t\tattrs: attrs || {},\n\t\t\tfactory: this,\n\t\t\tdb: this.db,\n\t\t});\n\t}\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAyCA,IAAa,mBAAb,cAGU,QAAyB;;;;;;;;;;;;;;;;;;;;;;CAsBlC,OAAgB,WAAqCA,QAAoB;AACxE,SAAO,QAAQ,WAAW,OAAO;CACjC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA0DD,OAAO,cAMNC,YACAC,UAQAC,YAMoB;AACpB,SAAO,OACNC,OACAC,SACAC,IACAC,kBACI;GAEJ,IAAIC,OAAsC,EAAE,GAAG,MAAO;AAGtD,OAAI,UAAU;IACb,MAAM,gBAAgB,MAAM,SAAS;KACpC;KACA;KACA;KACA,OAAO;IACP,EAAC;AACF,WAAO;KAAE,GAAG;KAAe,GAAG;IAAM;GACpC;GAGD,MAAM,QAAQ,WAAW,SAAS,KAAK;AAGvC,OAAI,eAAe,OAAO;IAGzB,MAAM,aAAa,OAAO,QAAQ,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,MAAM,KAAK;AACtE,SAAI,oBAAuB,QAAQ,KAClC,KAAI,OAAO;AAEZ,YAAO;IACP,GAAE,CAAE,EAAQ;IAGb,MAAM,SAAS,MAAM,WAAW,MAAM,GAAG,CAAC,OAAO,WAAW;AAC5D,WAAO;GACP,MAEA,QAAO;EAER;CACD;;;;;;;;CASD,YACSC,UACAC,OACAJ,IACP;AACD,SAAO;EAJC;EACA;EACA;CAGR;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiCD,MAAM,OACLK,aACAC,OAC4C;AAC5C,QAAM,eAAe,KAAK,UACzB,OAAM,IAAI,OACR,WACA,YACA;EAIH,MAAM,SAAS,MAAM,KAAK,SAAS,aAClC,SAAS,CAAE,GACX,MACA,KAAK,IACL,MACA;AAGD,MAAI,iBAAiB,OAAO,WAAW,YAAY;GAElD,MAAM,aAAa,OAAO,QAAQ,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,MAAM,KAAK;AACvE,QAAI,oBAAuB,QAAQ,KAClC,KAAI,OAAO;AAEZ,WAAO;GACP,GAAE,CAAE,EAAQ;AAGb,UAAO,MAAM,OAAO,YAAY,MAAM,KAAK,GAAG,CAAC,OAAO,WAAW;EACjE;AAGD,SAAO;CACP;CAyCD,MAAM,WACLC,OACAF,aACAG,OAC8C;AAC9C,QAAM,eAAe,KAAK,UACzB,OAAM,IAAI,OACR,WACA,YACA;EAIH,MAAMC,UAAiB,CAAE;AACzB,OAAK,IAAI,IAAI,GAAG,IAAI,OAAO,KAAK;GAC/B,MAAM,kBACE,UAAU,aAAa,MAAM,AAAC,MAAc,GAAG,MAAM,GAAG;AAEhE,WAAQ,KACP,KAAK,SAAS,aAAa,UAAU,MAAM,KAAK,IAAI,MAAM,CAAC,KAC1D,CAACC,WAAgB;AAEhB,QAAI,iBAAiB,OAAO,WAAW,YAAY;KAElD,MAAM,aAAa,OAAO,QAAQ,OAAO,CAAC,OACzC,CAAC,KAAK,CAAC,KAAK,MAAM,KAAK;AACtB,UAAI,oBAAuB,QAAQ,KAClC,KAAI,OAAO;AAEZ,aAAO;KACP,GACD,CAAE,EACF;AAGD,YAAO,OAAO,YAAY,MAAM,KAAK,GAAG,CAAC,OAAO,WAAW;IAC3D;AAED,WAAO;GACP,EACD,CACD;EACD;AAED,SAAO,QAAQ,IAAI,QAAQ;CAC3B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkCD,KACCC,UACAC,OACuB;AACvB,QAAM,YAAY,KAAK,OACtB,OAAM,IAAI,OACR,QACA,SACA;AAIH,SAAO,KAAK,MAAM,UAAU;GAC3B,OAAO,SAAS,CAAE;GAClB,SAAS;GACT,IAAI,KAAK;EACT,EAAC;CACF;AACD"}

package/dist/PostgresKyselyMigrator-B2M6Gjvv.d.cts

@@ -1,84 +0,0 @@
-import { PostgresMigrator } from "./PostgresMigrator-CeYy-eHF.cjs";
-import { Kysely } from "kysely";
-import { MigrationProvider } from "kysely/migration";
-
-//#region src/PostgresKyselyMigrator.d.ts
-
-/**
- * PostgreSQL migrator implementation for Kysely ORM.
- * Extends PostgresMigrator to provide Kysely-specific migration functionality.
- * Automatically creates test databases and applies migrations for testing environments.
- *
- * @example
- * ```typescript
- * import { FileMigrationProvider } from 'kysely';
- * import { PostgresKyselyMigrator } from '@geekmidas/testkit';
- *
- * // Create migration provider
- * const provider = new FileMigrationProvider({
- *   fs: require('fs'),
- *   path: require('path'),
- *   migrationFolder: path.join(__dirname, 'migrations')
- * });
- *
- * // Create Kysely instance
- * const db = new Kysely<Database>({
- *   dialect: new PostgresDialect({
- *     pool: new Pool({ connectionString: uri })
- *   })
- * });
- *
- * // Create and use migrator
- * const migrator = new PostgresKyselyMigrator({
- *   uri: 'postgresql://localhost:5432/test_db',
- *   db,
- *   provider
- * });
- *
- * const cleanup = await migrator.start();
- * // Run tests...
- * await cleanup();
- *
- * // With afterCreate hook to create per-app users
- * import { runInitScript } from '@geekmidas/testkit/postgres';
- *
- * const migrator = new PostgresKyselyMigrator({
- *   uri: 'postgresql://localhost:5432/test_db',
- *   db,
- *   provider,
- *   afterCreate: async (uri) => {
- *     await runInitScript('docker/postgres/init.sh', uri, env);
- *   },
- * });
- * ```
- */
-declare class PostgresKyselyMigrator extends PostgresMigrator {
-  private options;
-  /**
-   * Creates a new PostgresKyselyMigrator instance.
-   *
-   * @param options - Configuration options
-   * @param options.uri - PostgreSQL connection URI
-   * @param options.db - Kysely database instance
-   * @param options.provider - Migration provider for locating migration files
-   * @param options.afterCreate - Optional hook called after database creation but before migrations
-   */
-  constructor(options: {
-    uri: string;
-    db: Kysely<any>;
-    provider: MigrationProvider;
-    afterCreate?: (uri: string) => Promise<void>;
-  });
-  /**
-   * Executes Kysely migrations to the latest version.
-   * Implements the abstract migrate() method from PostgresMigrator.
-   *
-   * @throws Error if migrations fail to apply
-   * @returns Promise that resolves when all migrations are applied
-   */
-  migrate(): Promise<void>;
-}
-//# sourceMappingURL=PostgresKyselyMigrator.d.ts.map
-//#endregion
-export { PostgresKyselyMigrator };
-//# sourceMappingURL=PostgresKyselyMigrator-B2M6Gjvv.d.cts.map

package/dist/PostgresKyselyMigrator-B2M6Gjvv.d.cts.map

@@ -1 +0,0 @@
-{"version":3,"file":"PostgresKyselyMigrator-B2M6Gjvv.d.cts","names":[],"sources":["../src/PostgresKyselyMigrator.ts"],"sourcesContent":[],"mappings":";;;;;;;;AA2DA;;;;;;;AAA4D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAA/C,sBAAA,SAA+B,gBAAA;;;;;;;;;;;;;QAarC;cACM;mCACqB;;;;;;;;;aAahB"}