@geekmidas/testkit 10.0.0-alpha.3 → 10.0.0-alpha.30

package/dist/KyselyFactory.cjs

@@ -1,5 +1,238 @@
-require('./Factory-BhjUOBWN.cjs');
-require('./faker-B14IEMIN.cjs');
-const require_KyselyFactory = require('./KyselyFactory-BFqVIn_0.cjs');
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_Factory = require("./Factory.cjs");
+const require_faker = require("./faker.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 {
+	builders;
+	seeds;
+	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(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) data = {
+				...await defaults({
+					attrs,
+					factory,
+					db,
+					faker: fakerInstance
+				}),
+				...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) return await this.db.insertInto(result.table).values(result.data).returningAll().executeTakeFirst();
+		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
+exports.KyselyFactory = KyselyFactory;
 
-exports.KyselyFactory = require_KyselyFactory.KyselyFactory;
+//# sourceMappingURL=KyselyFactory.cjs.map

package/dist/KyselyFactory.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"KyselyFactory.cjs","names":["Factory","faker"],"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,gBAAAA,QAAyB;CAkCzB;CACA;CACA;;;;;;;;;;;;;;;;;;;;;;CAdT,OAAgB,WAAqC,QAAoB;EACxE,OAAOA,gBAAAA,QAAQ,WAAW,MAAM;CACjC;;;;;;;;CASA,YACC,UACA,OACA,IACC;EACD,MAAM;EAJE,KAAA,WAAA;EACA,KAAA,QAAA;EACA,KAAA,KAAA;CAGT;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiDA,OAAO,cASN,OACA,UAQA,YAMoB;EACpB,OAAO,OACN,OACA,SACA,IACA,kBACI;GAEJ,IAAI,OAA2C,EAAE,GAAG,MAAM;GAG1D,IAAI,UAOH,OAAO;IAAE,GAAG,MANgB,SAAS;KACpC;KACA;KACA;KACA,OAAO;IACR,CAAC;IAC0B,GAAG;GAAK;GAIpC,IAAI,eAAe,OAAO;IAEzB,MAAM,SAAS,MAAM,GACnB,WAAW,KAAK,CAAC,CACjB,OAAO,IAAiC,CAAC,CACzC,aAAa,CAAC,CACd,iBAAiB;IAEnB,IAAI,CAAC,QACJ,MAAM,IAAI,MAAM,yBAAyB,OAAO;IAGjD,OAAO;GACR,OAEC,OAAO;IAAE;IAAO;GAAK;EAEvB;CACD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+BA,MAAM,OACL,aACA,OAC4C;EAC5C,IAAI,EAAE,eAAe,KAAK,WACzB,MAAM,IAAI,MACT,YACC,YACA,8EACF;EAGD,MAAM,SAAS,MAAM,KAAK,SAAS,YAAY,CAC9C,SAAS,CAAC,GACV,MACA,KAAK,IACLC,cAAAA,KACD;EAIA,IACC,UACA,OAAO,WAAW,YAClB,WAAW,UACX,UAAU,QASV,OAAO,MANgB,KAAK,GAC1B,WAAW,OAAO,KAAK,CAAC,CACxB,OAAO,OAAO,IAAI,CAAC,CACnB,aAAa,CAAC,CACd,iBAAiB;EAMpB,OAAO;CACR;CA8CA,MAAM,WACL,OACA,aACA,OAC8C;EAC9C,IAAI,EAAE,eAAe,KAAK,WACzB,MAAM,IAAI,MACT,YACC,YACA,iGACF;EAGD,MAAM,WAA2B,CAAC;EAElC,KAAK,IAAI,IAAI,GAAG,IAAI,OAAO,KAAK;GAC/B,MAAM,WACL,OAAO,UAAU,aAAa,MAAM,MAAM,GAAGA,cAAAA,KAAK,IAAI;GACvD,SAAS,KAAK,KAAK,OAAO,aAAa,QAAQ,CAAC;EACjD;EAEA,OAAO,QAAQ,IAAI,QAAQ;CAC5B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+BA,KACC,UACA,OACuB;EACvB,IAAI,EAAE,YAAY,KAAK,QACtB,MAAM,IAAI,MACT,SACC,SACA,iGACF;EAGD,OAAO,KAAK,MAAM,SAAS,CAAC;GAC3B,OAAO,SAAS,CAAC;GACjB,SAAS;GACT,IAAI,KAAK;EACV,CAAC;CACF;AACD"}

package/dist/KyselyFactory.d.cts

@@ -1,4 +1,224 @@
-import "./faker-Cg76aFNO.cjs";
-import "./Factory-BOX312yd.cjs";
-import { KyselyFactory } from "./KyselyFactory-Dy5zzV4B.cjs";
-export { KyselyFactory };
+import { FakerFactory } from "./faker.cjs";
+import { ExtractSeedAttrs, FactorySeed } from "./Factory.cjs";
+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' });
+ * ```
+ */
+export 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]>;
+}
+//#endregion
+//# sourceMappingURL=KyselyFactory.d.cts.map

package/dist/KyselyFactory.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"KyselyFactory.d.cts","names":[],"sources":["../src/KyselyFactory.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qBA+Ca,cACZ,IACA,iBAAiB,qBACjB,cAAc,6BACL,QAAQ,UAAU;UAkClB;UACA;UACA;;;;;;;;;;;;;;;;;;;;;;SAdO,WAAW,aAAa,aAAa,QAAQ,OAAO;;;;;;;;EAWpE,YACS,UAAU,UACV,OAAO,OACP,IAAI,OAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;SAoDzC,cACN,IACA,wBAAwB,aACxB,cAAc,QAAQ,WAAW,GAAG,eAAe,QAClD,WAAW,GAAG,cAEf,eACA,SAAS,WAAW,GAAG,aAEvB,OAAO,WACP,YAAY;IACX,OAAO;IACP,SAAS;IACT,IAAI,OAAO;IACX,OAAO;QAEL,QAAQ,WAAW,GAAG,eACtB,QAAQ,QAAQ,WAAW,GAAG,eACjC,wBAEA,OAAO,OACP,SAAS,SACT,IAAI,OAAO,KACX,OAAO,iBACH,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAuEP,OAAO,gBAAgB,UAC5B,aAAa,GACb,QAAQ,WAAW,SAAS,SAC1B,QAAQ,QAAQ,WAAW,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAqEjC,WAAW,gBAAgB,UAChC,eACA,aAAa,GACb,QAAQ,WAAW,SAAS,SAC1B,QAAQ,QAAQ,WAAW,SAAS;EACjC,WAAW,gBAAgB,UAChC,eACA,aAAa,GACb,QACC,aACA,OAAO,iBACH,WAAW,SAAS,SAAS,QAAQ,WAAW,SAAS,UAC5D,QAAQ,QAAQ,WAAW,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAsDvC,KAAK,gBAAgB,OACpB,UAAU,GACV,QAAQ,iBAAiB,MAAM,MAC7B,WAAW,MAAM"}