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

package/dist/Factory-C15SSK8_.d.mts

@@ -1,147 +0,0 @@
-import { FakerFactory } from "./faker-B6bmbGCM.mjs";
-
-//#region src/Factory.d.ts
-
-/**
- * Abstract base class for database factories used in testing.
- * Provides a standardized interface for creating test data using builder and seed patterns.
- *
- * @template Builders - Record of builder functions for creating individual entities
- * @template Seeds - Record of seed functions for creating complex test scenarios
- *
- * @example
- * ```typescript
- * // Define builders for creating individual records
- * const builders = {
- *   user: (attrs) => ({ name: 'Test User', email: 'test@example.com', ...attrs }),
- *   post: (attrs) => ({ title: 'Test Post', content: 'Content', ...attrs })
- * };
- *
- * // Define seeds for complex scenarios
- * const seeds = {
- *   userWithPosts: async (attrs, factory) => {
- *     const user = await factory.insert('user', attrs);
- *     await factory.insertMany(3, 'post', { userId: user.id });
- *     return user;
- *   }
- * };
- * ```
- */
-declare abstract class Factory<Builders extends Record<string, any>, Seeds extends Record<string, any>> {
-  /**
-   * Creates a typed seed function with proper type inference.
-   * This is a utility method to help with TypeScript type checking when defining seeds.
-   *
-   * @template Seed - The seed function type
-   * @param seedFn - The seed function to wrap
-   * @returns The same seed function with proper typing
-   *
-   * @example
-   * ```typescript
-   * const userWithPostsSeed = Factory.createSeed(async ({ attrs, factory, db }) => {
-   *   const user = await factory.insert('user', attrs);
-   *   return user;
-   * });
-   * ```
-   */
-  static createSeed<Seed extends FactorySeed>(seedFn: Seed): Seed;
-  /**
-   * Inserts an object into the database using a builder function.
-   *
-   * @param builderName - The name of the builder to use
-   * @param attrs - The attributes to insert
-   */
-  abstract insert<K extends keyof Builders>(builderName: K, attrs?: Parameters<Builders[K]>[0]): Promise<Awaited<ReturnType<Builders[K]>>>;
-  /**
-   * Inserts multiple objects into the database
-   *
-   * @param count -  Number of objects to insert
-   * @param builderName - The name of the builder to use
-   * @param attrs - The attributes to insert
-   */
-  abstract insertMany<K extends keyof Builders>(count: number, builderName: K, attrs?: Parameters<Builders[K]>[0] | ((idx: number, faker: FakerFactory) => Promise<Parameters<Builders[K]>[0]>)): Promise<Awaited<ReturnType<Builders[K]>>[]>;
-  /**
-   * Seeds the database using a seed function.
-   *
-   * @param seedName - The name of the seed to use
-   * @returns The result of the seed function
-   * @param attrs - The attributes to pass to the seed function
-   */
-  abstract seed<K extends keyof Seeds>(seedName: K, attrs?: ExtractSeedAttrs<Seeds[K]>): ReturnType<Seeds[K]>;
-}
-/**
- * Type definition for a factory builder function that can work with different database types.
- * Builders are responsible for creating individual database records with default values and relationships.
- *
- * @template Attrs - The attributes/input type for the builder
- * @template Factory - The factory instance type
- * @template Result - The type of object returned by the builder
- * @template DB - The database connection type (Kysely, Knex, etc.)
- *
- * @param attrs - Partial attributes to override defaults
- * @param factory - The factory instance for creating related records
- * @param db - The database connection
- * @returns The created record or a promise resolving to it
- *
- * @example
- * ```typescript
- * const userBuilder: MixedFactoryBuilder<UserAttrs, Factory, User, Kysely<DB>> =
- *   async (attrs, factory, db) => {
- *     return {
- *       id: faker.string.uuid(),
- *       name: faker.person.fullName(),
- *       email: faker.internet.email(),
- *       ...attrs
- *     };
- *   };
- * ```
- */
-type MixedFactoryBuilder<Attrs = any, Factory = any, Result = any, DB = any> = (attrs: Attrs, factory: Factory, db: DB) => Result | Promise<Result>;
-/**
- * Type definition for a factory seed function used to create complex test scenarios.
- * Seeds typically create multiple related records to set up a complete test environment.
- *
- * @template Attrs - The attributes/input type for the seed
- * @template Factory - The factory instance type
- * @template Result - The type of object returned by the seed
- * @template DB - The database connection type (Kysely, Knex, etc.)
- *
- * @param context - Object containing attrs, factory, and db
- * @param context.attrs - Configuration attributes for the seed
- * @param context.factory - The factory instance for creating records
- * @param context.db - The database connection
- * @returns A promise resolving to the seed result
- *
- * @example
- * ```typescript
- * const userWithPostsSeed: FactorySeed<{ postCount?: number }, Factory, User, DB> =
- *   async ({ attrs, factory, db }) => {
- *     const user = await factory.insert('user', attrs);
- *     const postCount = attrs.postCount || 3;
- *
- *     for (let i = 0; i < postCount; i++) {
- *       await factory.insert('post', { userId: user.id });
- *     }
- *
- *     return user;
- *   };
- * ```
- */
-type FactorySeed<Attrs = any, Factory = any, Result = any, DB = any> = (context: {
-  attrs: Attrs;
-  factory: Factory;
-  db: DB;
-}) => Promise<Result>;
-/**
- * Helper type to extract the Attrs type from a FactorySeed function.
- * Used internally by Factory implementations to correctly type the seed method parameters.
- */
-type ExtractSeedAttrs<T> = T extends ((context: {
-  attrs: infer A;
-  factory: any;
-  db: any;
-}) => any) ? A : never;
-//# sourceMappingURL=Factory.d.ts.map
-//#endregion
-export { ExtractSeedAttrs, Factory, FactorySeed, MixedFactoryBuilder };
-//# sourceMappingURL=Factory-C15SSK8_.d.mts.map

package/dist/Factory-C15SSK8_.d.mts.map

@@ -1 +0,0 @@
-{"version":3,"file":"Factory-C15SSK8_.d.mts","names":[],"sources":["../src/Factory.ts"],"sourcesContent":[],"mappings":";;;;;;AA2BA;;;;;;;;;;;;;;;;;;;;;;;AAiD6B,uBAjDP,OAiDO,CAAA,iBAhDX,MAgDW,CAAA,MAAA,EAAA,GAAA,CAAA,EAAA,cA/Cd,MA+Cc,CAAA,MAAA,EAAA,GAAA,CAAA,CAAA,CAAA;EAAQ;;;;;;;;;;;;;;;;EAavB,OAAA,UAAA,CAAA,aA1CkB,WA0ClB,CAAA,CAAA,MAAA,EA1CuC,IA0CvC,CAAA,EA1C8C,IA0C9C;EA8BF;;;;;;EAK0C,SAAW,MAAA,CAAA,UAAA,MApEhC,QAoEgC,CAAA,CAAA,WAAA,EAnElD,CAmEkD,EAAA,KAAA,CAAA,EAlEvD,UAkEuD,CAlE5C,QAkE4C,CAlEnC,CAkEmC,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,EAjE7D,OAiE6D,CAjErD,OAiEqD,CAjE7C,UAiE6C,CAjElC,QAiEkC,CAjEzB,CAiEyB,CAAA,CAAA,CAAA,CAAA;EAAM;AAAP;AAgChE;;;;;EAKsD,SAAe,UAAA,CAAA,UAAA,MA7FhC,QA6FgC,CAAA,CAAA,KAAA,EAAA,MAAA,EAAA,WAAA,EA3FtD,CA2FsD,EAAA,KAAA,CAAA,EAzFhE,UAyFgE,CAzFrD,QAyFqD,CAzF5C,CAyF4C,CAAA,CAAA,CAAA,CAAA,CAAA,GAAA,CAAA,CAAA,GAAA,EAAA,MAAA,EAAA,KAAA,EAtFzD,YAsFyD,EAAA,GArF3D,OAqF2D,CArFnD,UAqFmD,CArFxC,QAqFwC,CArF/B,CAqF+B,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,EApFjE,OAoFiE,CApFzD,OAoFyD,CApFjD,UAoFiD,CApFtC,QAoFsC,CApF7B,CAoF6B,CAAA,CAAA,CAAA,EAAA,CAAA;EAAM;AAAP;AAMpE;;;;AAKI;gCAtF2B,iBACnB,WACF,iBAAiB,MAAM,MAC7B,WAAW,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KA8BT,kFAKA,gBAAgB,aAAa,OAAO,SAAS,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAgCrD;SAKW;WAAgB;MAAa;MAAS,QAAQ;;;;;KAMzD,sBAAsB;;;;aAK/B"}

package/dist/KyselyFactory-BFqVIn_0.cjs

@@ -1,246 +0,0 @@
-const require_Factory = require('./Factory-BhjUOBWN.cjs');
-const require_faker = require('./faker-B14IEMIN.cjs');
-
-//#region src/KyselyFactory.ts
-/**
-* Factory implementation for Kysely ORM, providing test data creation utilities.
-* Extends the base Factory class with Kysely-specific database operations.
-*
-* @template DB - The database schema type
-* @template Builders - Record of builder functions for creating entities
-* @template Seeds - Record of seed functions for complex test scenarios
-*
-* @example
-* ```typescript
-* // Define your database schema
-* interface Database {
-*   users: UsersTable;
-*   posts: PostsTable;
-* }
-*
-* // Create builders
-* const builders = {
-*   user: KyselyFactory.createBuilder<Database, 'users'>('users', ({ attrs, faker }) => ({
-*     id: faker.string.uuid(),
-*     name: faker.person.fullName(),
-*     email: faker.internet.email(),
-*     ...attrs
-*   })),
-*   post: KyselyFactory.createBuilder<Database, 'posts'>('posts', ({ attrs }) => ({
-*     title: 'Test Post',
-*     content: 'Test content',
-*     ...attrs
-*   }))
-* };
-*
-* // Create factory instance
-* const factory = new KyselyFactory(builders, seeds, db);
-*
-* // Use in tests
-* const user = await factory.insert('user', { name: 'John Doe' });
-* ```
-*/
-var KyselyFactory = class extends require_Factory.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: KyselyFactory.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 require_Factory.Factory.createSeed(seedFn);
-	}
-	/**
-	* Creates a new KyselyFactory instance.
-	*
-	* @param builders - Record of builder functions for creating individual entities
-	* @param seeds - Record of seed functions for creating complex test scenarios
-	* @param db - Kysely database instance or controlled transaction
-	*/
-	constructor(builders, seeds, db) {
-		super();
-		this.builders = builders;
-		this.seeds = seeds;
-		this.db = db;
-	}
-	/**
-	* Creates a typed builder function for a specific database table.
-	* This is a utility method that helps create builders with proper type inference for Kysely.
-	*
-	* @template DB - The database schema type
-	* @template TableName - The name of the table (must be a key of DB)
-	* @template Attrs - The attributes type for the builder (defaults to Partial<Insertable>)
-	* @template Factory - The factory instance type
-	* @template Result - The result type (defaults to Selectable of the table)
-	*
-	* @param table - The name of the database table
-	* @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 = KyselyFactory.createBuilder<DB, 'users'>('users',
-	*   ({ 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 = KyselyFactory.createBuilder<DB, 'leaveTypes'>('leaveTypes',
-	*   ({ 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 = KyselyFactory.createBuilder<DB, 'addresses'>('addresses',
-	*   ({ attrs }) => ({
-	*     street: '123 Main St',
-	*     city: 'Anytown',
-	*     ...attrs
-	*   }),
-	*   false // Don't auto-insert
-	* );
-	* ```
-	*/
-	static createBuilder(table, 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
-				};
-			}
-			if (autoInsert !== false) {
-				const result = await db.insertInto(table).values(data).returningAll().executeTakeFirst();
-				if (!result) throw new Error(`Failed to insert into ${table}`);
-				return result;
-			} else return {
-				table,
-				data
-			};
-		};
-	}
-	/**
-	* Inserts a single record into the database using the specified builder.
-	* The builder function is responsible for generating the record data with defaults
-	* and the factory handles the actual database insertion.
-	*
-	* @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
-	* @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'
-	* });
-	*
-	* // Use the inserted record
-	* const post = await factory.insert('post', {
-	*   userId: user.id,
-	*   title: 'My First Post'
-	* });
-	* ```
-	*/
-	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, require_faker.faker);
-		if (result && typeof result === "object" && "table" in result && "data" in result) {
-			const inserted = await this.db.insertInto(result.table).values(result.data).returningAll().executeTakeFirst();
-			return inserted;
-		}
-		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 promises = [];
-		for (let i = 0; i < count; i++) {
-			const newAttrs = typeof attrs === "function" ? await attrs(i, require_faker.faker) : attrs;
-			promises.push(this.insert(builderName, newAttrs));
-		}
-		return Promise.all(promises);
-	}
-	/**
-	* 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
-	* const company = await factory.seed('companyWithDepartments', {
-	*   departmentCount: 3,
-	*   employeesPerDepartment: 10
-	* });
-	* expect(company.departments).toHaveLength(3);
-	* ```
-	*/
-	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
-Object.defineProperty(exports, 'KyselyFactory', {
-  enumerable: true,
-  get: function () {
-    return KyselyFactory;
-  }
-});
-//# sourceMappingURL=KyselyFactory-BFqVIn_0.cjs.map

package/dist/KyselyFactory-BFqVIn_0.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"KyselyFactory-BFqVIn_0.cjs","names":["Factory","seedFn: Seed","builders: Builders","seeds: Seeds","db: Kysely<DB> | ControlledTransaction<DB, []>","table: TableName","defaults?: (context: {\n\t\t\tattrs: Attrs;\n\t\t\tfactory: Factory;\n\t\t\tdb: Kysely<DB>;\n\t\t\tfaker: FakerFactory;\n\t\t}) =>\n\t\t\t| Partial<Insertable<DB[TableName]>>\n\t\t\t| Promise<Partial<Insertable<DB[TableName]>>>","autoInsert?: boolean","attrs: Attrs","factory: Factory","db: Kysely<DB>","fakerInstance: FakerFactory","data: Partial<Insertable<DB[TableName]>>","builderName: K","attrs?: Parameters<Builders[K]>[0]","faker","count: number","attrs?: any","promises: Promise<any>[]","seedName: K","attrs?: ExtractSeedAttrs<Seeds[K]>"],"sources":["../src/KyselyFactory.ts"],"sourcesContent":["import type {\n\tControlledTransaction,\n\tInsertable,\n\tKysely,\n\tSelectable,\n} from 'kysely';\nimport { type ExtractSeedAttrs, Factory, type FactorySeed } from './Factory';\nimport { type FakerFactory, faker } from './faker';\n\n/**\n * Factory implementation for Kysely ORM, providing test data creation utilities.\n * Extends the base Factory class with Kysely-specific database operations.\n *\n * @template DB - The database schema type\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 database schema\n * interface Database {\n *   users: UsersTable;\n *   posts: PostsTable;\n * }\n *\n * // Create builders\n * const builders = {\n *   user: KyselyFactory.createBuilder<Database, 'users'>('users', ({ attrs, faker }) => ({\n *     id: faker.string.uuid(),\n *     name: faker.person.fullName(),\n *     email: faker.internet.email(),\n *     ...attrs\n *   })),\n *   post: KyselyFactory.createBuilder<Database, 'posts'>('posts', ({ attrs }) => ({\n *     title: 'Test Post',\n *     content: 'Test content',\n *     ...attrs\n *   }))\n * };\n *\n * // Create factory instance\n * const factory = new KyselyFactory(builders, seeds, db);\n *\n * // Use in tests\n * const user = await factory.insert('user', { name: 'John Doe' });\n * ```\n */\nexport class KyselyFactory<\n\tDB,\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: KyselyFactory.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 new KyselyFactory 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 - Kysely database instance or controlled transaction\n\t */\n\tconstructor(\n\t\tprivate builders: Builders,\n\t\tprivate seeds: Seeds,\n\t\tprivate db: Kysely<DB> | ControlledTransaction<DB, []>,\n\t) {\n\t\tsuper();\n\t}\n\n\t/**\n\t * Creates a typed builder function for a specific database table.\n\t * This is a utility method that helps create builders with proper type inference for Kysely.\n\t *\n\t * @template DB - The database schema type\n\t * @template TableName - The name of the table (must be a key of DB)\n\t * @template Attrs - The attributes type for the builder (defaults to Partial<Insertable>)\n\t * @template Factory - The factory instance type\n\t * @template Result - The result type (defaults to Selectable of the table)\n\t *\n\t * @param table - The name of the database table\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 = KyselyFactory.createBuilder<DB, 'users'>('users',\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 = KyselyFactory.createBuilder<DB, 'leaveTypes'>('leaveTypes',\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 = KyselyFactory.createBuilder<DB, 'addresses'>('addresses',\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 */\n\tstatic createBuilder<\n\t\tDB,\n\t\tTableName extends keyof DB & string,\n\t\tAttrs extends Partial<Insertable<DB[TableName]>> = Partial<\n\t\t\tInsertable<DB[TableName]>\n\t\t>,\n\t\tFactory = any,\n\t\tResult = Selectable<DB[TableName]>,\n\t>(\n\t\ttable: TableName,\n\t\tdefaults?: (context: {\n\t\t\tattrs: Attrs;\n\t\t\tfactory: Factory;\n\t\t\tdb: Kysely<DB>;\n\t\t\tfaker: FakerFactory;\n\t\t}) =>\n\t\t\t| Partial<Insertable<DB[TableName]>>\n\t\t\t| Promise<Partial<Insertable<DB[TableName]>>>,\n\t\tautoInsert?: boolean,\n\t): (\n\t\tattrs: Attrs,\n\t\tfactory: Factory,\n\t\tdb: Kysely<DB>,\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: Kysely<DB>,\n\t\t\tfakerInstance: FakerFactory,\n\t\t) => {\n\t\t\t// Start with attributes\n\t\t\tlet data: Partial<Insertable<DB[TableName]>> = { ...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// 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\tconst result = await db\n\t\t\t\t\t.insertInto(table)\n\t\t\t\t\t.values(data as Insertable<DB[TableName]>)\n\t\t\t\t\t.returningAll()\n\t\t\t\t\t.executeTakeFirst();\n\n\t\t\t\tif (!result) {\n\t\t\t\t\tthrow new Error(`Failed to insert into ${table}`);\n\t\t\t\t}\n\n\t\t\t\treturn result as Result;\n\t\t\t} else {\n\t\t\t\t// Return object for factory to handle insertion\n\t\t\t\treturn { table, data } as any;\n\t\t\t}\n\t\t};\n\t}\n\n\t/**\n\t * Inserts a single record into the database using the specified builder.\n\t * The builder function is responsible for generating the record data with defaults\n\t * and the factory handles the actual database insertion.\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\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 * // Use the inserted record\n\t * const post = await factory.insert('post', {\n\t *   userId: user.id,\n\t *   title: 'My First Post'\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// For Kysely, we expect the builder to return an object with table and data properties\n\t\t// or to handle the insertion itself and return the inserted record\n\t\tif (\n\t\t\tresult &&\n\t\t\ttypeof result === 'object' &&\n\t\t\t'table' in result &&\n\t\t\t'data' in result\n\t\t) {\n\t\t\t// If the builder returns {table: string, data: object}, we insert it\n\t\t\tconst inserted = await this.db\n\t\t\t\t.insertInto(result.table)\n\t\t\t\t.values(result.data)\n\t\t\t\t.returningAll()\n\t\t\t\t.executeTakeFirst();\n\n\t\t\treturn inserted as any;\n\t\t}\n\n\t\t// Otherwise, assume the builder handled the insertion itself\n\t\treturn result;\n\t}\n\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 * @template K - The builder name (must be a key of Builders)\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, faker) => ({\n\t *   title: `Post ${idx + 1}`,\n\t *   content: faker.lorem.paragraph(),\n\t *   publishedAt: faker.date.past()\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: (\n\t\t\tidx: number,\n\t\t\tfaker: FakerFactory,\n\t\t) => Parameters<Builders[K]>[0] | Promise<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 promises: Promise<any>[] = [];\n\n\t\tfor (let i = 0; i < count; i++) {\n\t\t\tconst newAttrs =\n\t\t\t\ttypeof attrs === 'function' ? await attrs(i, faker) : attrs;\n\t\t\tpromises.push(this.insert(builderName, newAttrs));\n\t\t}\n\n\t\treturn Promise.all(promises);\n\t}\n\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\n\t * const company = await factory.seed('companyWithDepartments', {\n\t *   departmentCount: 3,\n\t *   employeesPerDepartment: 10\n\t * });\n\t * expect(company.departments).toHaveLength(3);\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":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA+CA,IAAa,gBAAb,cAIUA,wBAAyB;;;;;;;;;;;;;;;;;;;;;;CAsBlC,OAAgB,WAAqCC,QAAoB;AACxE,SAAO,wBAAQ,WAAW,OAAO;CACjC;;;;;;;;CASD,YACSC,UACAC,OACAC,IACP;AACD,SAAO;EAJC;EACA;EACA;CAGR;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiDD,OAAO,cASNC,OACAC,UAQAC,YAMoB;AACpB,SAAO,OACNC,OACAC,SACAC,IACAC,kBACI;GAEJ,IAAIC,OAA2C,EAAE,GAAG,MAAO;AAG3D,OAAI,UAAU;IACb,MAAM,gBAAgB,MAAM,SAAS;KACpC;KACA;KACA;KACA,OAAO;IACP,EAAC;AACF,WAAO;KAAE,GAAG;KAAe,GAAG;IAAM;GACpC;AAGD,OAAI,eAAe,OAAO;IAEzB,MAAM,SAAS,MAAM,GACnB,WAAW,MAAM,CACjB,OAAO,KAAkC,CACzC,cAAc,CACd,kBAAkB;AAEpB,SAAK,OACJ,OAAM,IAAI,OAAO,wBAAwB,MAAM;AAGhD,WAAO;GACP,MAEA,QAAO;IAAE;IAAO;GAAM;EAEvB;CACD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+BD,MAAM,OACLC,aACAC,OAC4C;AAC5C,QAAM,eAAe,KAAK,UACzB,OAAM,IAAI,OACR,WACA,YACA;EAIH,MAAM,SAAS,MAAM,KAAK,SAAS,aAClC,SAAS,CAAE,GACX,MACA,KAAK,IACLC,oBACA;AAID,MACC,iBACO,WAAW,YAClB,WAAW,UACX,UAAU,QACT;GAED,MAAM,WAAW,MAAM,KAAK,GAC1B,WAAW,OAAO,MAAM,CACxB,OAAO,OAAO,KAAK,CACnB,cAAc,CACd,kBAAkB;AAEpB,UAAO;EACP;AAGD,SAAO;CACP;CA8CD,MAAM,WACLC,OACAH,aACAI,OAC8C;AAC9C,QAAM,eAAe,KAAK,UACzB,OAAM,IAAI,OACR,WACA,YACA;EAIH,MAAMC,WAA2B,CAAE;AAEnC,OAAK,IAAI,IAAI,GAAG,IAAI,OAAO,KAAK;GAC/B,MAAM,kBACE,UAAU,aAAa,MAAM,MAAM,GAAGH,oBAAM,GAAG;AACvD,YAAS,KAAK,KAAK,OAAO,aAAa,SAAS,CAAC;EACjD;AAED,SAAO,QAAQ,IAAI,SAAS;CAC5B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+BD,KACCI,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/KyselyFactory-C9Snz24z.d.mts

@@ -1,228 +0,0 @@
-import { FakerFactory } from "./faker-B6bmbGCM.mjs";
-import { ExtractSeedAttrs, Factory, FactorySeed } from "./Factory-C15SSK8_.mjs";
-import { ControlledTransaction, Insertable, Kysely, Selectable } from "kysely";
-
-//#region src/KyselyFactory.d.ts
-
-/**
- * Factory implementation for Kysely ORM, providing test data creation utilities.
- * Extends the base Factory class with Kysely-specific database operations.
- *
- * @template DB - The database schema type
- * @template Builders - Record of builder functions for creating entities
- * @template Seeds - Record of seed functions for complex test scenarios
- *
- * @example
- * ```typescript
- * // Define your database schema
- * interface Database {
- *   users: UsersTable;
- *   posts: PostsTable;
- * }
- *
- * // Create builders
- * const builders = {
- *   user: KyselyFactory.createBuilder<Database, 'users'>('users', ({ attrs, faker }) => ({
- *     id: faker.string.uuid(),
- *     name: faker.person.fullName(),
- *     email: faker.internet.email(),
- *     ...attrs
- *   })),
- *   post: KyselyFactory.createBuilder<Database, 'posts'>('posts', ({ attrs }) => ({
- *     title: 'Test Post',
- *     content: 'Test content',
- *     ...attrs
- *   }))
- * };
- *
- * // Create factory instance
- * const factory = new KyselyFactory(builders, seeds, db);
- *
- * // Use in tests
- * const user = await factory.insert('user', { name: 'John Doe' });
- * ```
- */
-declare class KyselyFactory<DB, 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: KyselyFactory.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 new KyselyFactory instance.
-   *
-   * @param builders - Record of builder functions for creating individual entities
-   * @param seeds - Record of seed functions for creating complex test scenarios
-   * @param db - Kysely database instance or controlled transaction
-   */
-  constructor(builders: Builders, seeds: Seeds, db: Kysely<DB> | ControlledTransaction<DB, []>);
-  /**
-   * Creates a typed builder function for a specific database table.
-   * This is a utility method that helps create builders with proper type inference for Kysely.
-   *
-   * @template DB - The database schema type
-   * @template TableName - The name of the table (must be a key of DB)
-   * @template Attrs - The attributes type for the builder (defaults to Partial<Insertable>)
-   * @template Factory - The factory instance type
-   * @template Result - The result type (defaults to Selectable of the table)
-   *
-   * @param table - The name of the database table
-   * @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 = KyselyFactory.createBuilder<DB, 'users'>('users',
-   *   ({ 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 = KyselyFactory.createBuilder<DB, 'leaveTypes'>('leaveTypes',
-   *   ({ 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 = KyselyFactory.createBuilder<DB, 'addresses'>('addresses',
-   *   ({ attrs }) => ({
-   *     street: '123 Main St',
-   *     city: 'Anytown',
-   *     ...attrs
-   *   }),
-   *   false // Don't auto-insert
-   * );
-   * ```
-   */
-  static createBuilder<DB, TableName extends keyof DB & string, Attrs extends Partial<Insertable<DB[TableName]>> = Partial<Insertable<DB[TableName]>>, Factory = any, Result = Selectable<DB[TableName]>>(table: TableName, defaults?: (context: {
-    attrs: Attrs;
-    factory: Factory;
-    db: Kysely<DB>;
-    faker: FakerFactory;
-  }) => Partial<Insertable<DB[TableName]>> | Promise<Partial<Insertable<DB[TableName]>>>, autoInsert?: boolean): (attrs: Attrs, factory: Factory, db: Kysely<DB>, faker: FakerFactory) => Promise<Result>;
-  /**
-   * Inserts a single record into the database using the specified builder.
-   * The builder function is responsible for generating the record data with defaults
-   * and the factory handles the actual database insertion.
-   *
-   * @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
-   * @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'
-   * });
-   *
-   * // Use the inserted record
-   * const post = await factory.insert('post', {
-   *   userId: user.id,
-   *   title: 'My First Post'
-   * });
-   * ```
-   */
-  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.
-   *
-   * @template K - The builder name (must be a key of Builders)
-   * @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, faker) => ({
-   *   title: `Post ${idx + 1}`,
-   *   content: faker.lorem.paragraph(),
-   *   publishedAt: faker.date.past()
-   * }));
-   *
-   * // 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<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
-   * const company = await factory.seed('companyWithDepartments', {
-   *   departmentCount: 3,
-   *   employeesPerDepartment: 10
-   * });
-   * expect(company.departments).toHaveLength(3);
-   * ```
-   */
-  seed<K extends keyof Seeds>(seedName: K, attrs?: ExtractSeedAttrs<Seeds[K]>): ReturnType<Seeds[K]>;
-}
-//# sourceMappingURL=KyselyFactory.d.ts.map
-//#endregion
-export { KyselyFactory };
-//# sourceMappingURL=KyselyFactory-C9Snz24z.d.mts.map

package/dist/KyselyFactory-C9Snz24z.d.mts.map

@@ -1 +0,0 @@
-{"version":3,"file":"KyselyFactory-C9Snz24z.d.mts","names":[],"sources":["../src/KyselyFactory.ts"],"sourcesContent":[],"mappings":";;;;;;;;AA+CA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA4GK,cA5GQ,aA4GR,CAAA,EAAA,EAAA,iBA1Ga,MA0Gb,CAAA,MAAA,EAAA,GAAA,CAAA,EAAA,cAzGU,MAyGV,CAAA,MAAA,EAAA,GAAA,CAAA,CAAA,SAxGK,OAwGL,CAxGa,QAwGb,EAxGuB,KAwGvB,CAAA,CAAA;EAAO,QACoB,QAAA;EAAE,QAAC,KAAA;EAAS,QAAvB,EAAA;EAAU;;;;;;;;;;;;;;;;;;;;;EAwJf,OACK,UAAA,CAAA,aA5OoB,WA4OpB,CAAA,CAAA,MAAA,EA5OyC,IA4OzC,CAAA,EA5OgD,IA4OhD;EAAQ;;;;;;;EAClB,WACuB,CAAA,QAAA,EAlOd,QAkOc,EAAA,KAAA,EAjOjB,KAiOiB,EAAA,EAAA,EAhOpB,MAgOoB,CAhOb,EAgOa,CAAA,GAhOP,qBAgOO,CAhOe,EAgOf,EAAA,EAAA,CAAA;EAAQ;;;;;;;;;;;;;;;;;;;;;;;AApQzB;;;;;;;;;;;;;;;;;;;;;;;;mDA0FS,2BACV,QAAQ,WAAW,GAAG,eAAe,QAClD,WAAW,GAAG,sCAGN,WAAW,GAAG,oBAEhB;WAEC;aACE;QACL,OAAO;WACJ;QAEL,QAAQ,WAAW,GAAG,eACtB,QAAQ,QAAQ,WAAW,GAAG,8CAG1B,gBACE,aACL,OAAO,YACJ,iBACH,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;yBAuEgB,uBACf,WACL,WAAW,SAAS,SAC1B,QAAQ,QAAQ,WAAW,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;6BAqEN,sCAEnB,WACL,WAAW,SAAS,SAC1B,QAAQ,QAAQ,WAAW,SAAS;6BACN,sCAEnB,+BAGL,iBACH,WAAW,SAAS,SAAS,QAAQ,WAAW,SAAS,UAC5D,QAAQ,QAAQ,WAAW,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;uBAsDlB,iBACV,WACF,iBAAiB,MAAM,MAC7B,WAAW,MAAM"}