@geekmidas/testkit 0.0.6 → 0.0.7

package/dist/ObjectionFactory-89p-FFEw.mjs

@@ -0,0 +1,178 @@
+import { Factory } from "./Factory-z2m01hMj.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: (attrs) => User.fromJson({
+*     id: faker.string.uuid(),
+*     name: faker.person.fullName(),
+*     email: faker.internet.email(),
+*     ...attrs
+*   }),
+*   post: (attrs) => Post.fromJson({
+*     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
+	* @returns The same seed function with proper typing
+	*/
+	static createSeed(seedFn) {
+		return Factory.createSeed(seedFn);
+	}
+	/**
+	* 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.
+	*
+	* @param factory - 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(factory, attrs = {}) {
+		if (!(factory in this.builders)) throw new Error(`Factory "${factory}" does not exist. Make sure it is correct and registered in src/test/setup.ts`);
+		return this.builders[factory](attrs, {}, this.db).then((record) => {
+			return record.$query(this.db).insertGraph(record).execute();
+		});
+	}
+	/**
+	* 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(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" ? attrs(i) : attrs;
+			records.push(this.builders[builderName](newAttrs, {}, this.db).then((record) => record.$query(this.db).insertGraph(record).execute()));
+		}
+		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.
+	*
+	* @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, this, this.db);
+	}
+};
+
+//#endregion
+export { ObjectionFactory };

package/dist/ObjectionFactory-C47B03Ot.cjs

@@ -0,0 +1,183 @@
+const require_Factory = require('./Factory-WMhTNZ9S.cjs');
+
+//#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: (attrs) => User.fromJson({
+*     id: faker.string.uuid(),
+*     name: faker.person.fullName(),
+*     email: faker.internet.email(),
+*     ...attrs
+*   }),
+*   post: (attrs) => Post.fromJson({
+*     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 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
+	* @returns The same seed function with proper typing
+	*/
+	static createSeed(seedFn) {
+		return require_Factory.Factory.createSeed(seedFn);
+	}
+	/**
+	* 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.
+	*
+	* @param factory - 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(factory, attrs = {}) {
+		if (!(factory in this.builders)) throw new Error(`Factory "${factory}" does not exist. Make sure it is correct and registered in src/test/setup.ts`);
+		return this.builders[factory](attrs, {}, this.db).then((record) => {
+			return record.$query(this.db).insertGraph(record).execute();
+		});
+	}
+	/**
+	* 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(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" ? attrs(i) : attrs;
+			records.push(this.builders[builderName](newAttrs, {}, this.db).then((record) => record.$query(this.db).insertGraph(record).execute()));
+		}
+		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.
+	*
+	* @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, this, this.db);
+	}
+};
+
+//#endregion
+Object.defineProperty(exports, 'ObjectionFactory', {
+  enumerable: true,
+  get: function () {
+    return ObjectionFactory;
+  }
+});

package/dist/ObjectionFactory.cjs

@@ -1,4 +1,4 @@
-require('./Factory-DREHoms3.cjs');
-const require_ObjectionFactory = require('./ObjectionFactory-BlkzSEqo.cjs');
+require('./Factory-WMhTNZ9S.cjs');
+const require_ObjectionFactory = require('./ObjectionFactory-C47B03Ot.cjs');
 
 exports.ObjectionFactory = require_ObjectionFactory.ObjectionFactory;

package/dist/ObjectionFactory.mjs

@@ -1,4 +1,4 @@
-import "./Factory-DlzMkMzb.mjs";
-import { ObjectionFactory } from "./ObjectionFactory-ChuX8sZN.mjs";
+import "./Factory-z2m01hMj.mjs";
+import { ObjectionFactory } from "./ObjectionFactory-89p-FFEw.mjs";
 
 export { ObjectionFactory };

package/dist/PostgresKyselyMigrator-Bs31emFd.cjs

@@ -0,0 +1,87 @@
+const require_chunk = require('./chunk-CUT6urMc.cjs');
+const require_PostgresMigrator = require('./PostgresMigrator-BtAWdLss.cjs');
+const kysely = require_chunk.__toESM(require("kysely"));
+
+//#region src/PostgresKyselyMigrator.ts
+/**
+* Default logger instance for migration operations.
+*/
+const logger = console;
+/**
+* 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();
+* ```
+*/
+var PostgresKyselyMigrator = class extends require_PostgresMigrator.PostgresMigrator {
+	/**
+	* 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
+	*/
+	constructor(options) {
+		super(options.uri);
+		this.options = options;
+	}
+	/**
+	* 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
+	*/
+	async migrate() {
+		const migrator = new kysely.Migrator({
+			db: this.options.db,
+			provider: this.options.provider
+		});
+		const migrations = await migrator.migrateToLatest();
+		if (migrations.error) {
+			logger.error(migrations.error, `Failed to apply migrations`);
+			throw migrations.error;
+		}
+		await this.options.db.destroy();
+		logger.log(`Applied ${migrations.results?.length} migrations successfully`);
+	}
+};
+
+//#endregion
+Object.defineProperty(exports, 'PostgresKyselyMigrator', {
+  enumerable: true,
+  get: function () {
+    return PostgresKyselyMigrator;
+  }
+});

package/dist/PostgresKyselyMigrator-ChIpZFYB.mjs

@@ -0,0 +1,81 @@
+import { PostgresMigrator } from "./PostgresMigrator-BzqksJcW.mjs";
+import { Migrator } from "kysely";
+
+//#region src/PostgresKyselyMigrator.ts
+/**
+* Default logger instance for migration operations.
+*/
+const logger = console;
+/**
+* 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();
+* ```
+*/
+var PostgresKyselyMigrator = class extends PostgresMigrator {
+	/**
+	* 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
+	*/
+	constructor(options) {
+		super(options.uri);
+		this.options = options;
+	}
+	/**
+	* 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
+	*/
+	async migrate() {
+		const migrator = new Migrator({
+			db: this.options.db,
+			provider: this.options.provider
+		});
+		const migrations = await migrator.migrateToLatest();
+		if (migrations.error) {
+			logger.error(migrations.error, `Failed to apply migrations`);
+			throw migrations.error;
+		}
+		await this.options.db.destroy();
+		logger.log(`Applied ${migrations.results?.length} migrations successfully`);
+	}
+};
+
+//#endregion
+export { PostgresKyselyMigrator };

package/dist/PostgresKyselyMigrator.cjs

@@ -1,4 +1,4 @@
-require('./PostgresMigrator-Bz-tnjB6.cjs');
-const require_PostgresKyselyMigrator = require('./PostgresKyselyMigrator-JTY2LfwD.cjs');
+require('./PostgresMigrator-BtAWdLss.cjs');
+const require_PostgresKyselyMigrator = require('./PostgresKyselyMigrator-Bs31emFd.cjs');
 
 exports.PostgresKyselyMigrator = require_PostgresKyselyMigrator.PostgresKyselyMigrator;

package/dist/PostgresKyselyMigrator.mjs

@@ -1,4 +1,4 @@
-import "./PostgresMigrator-CEoRKTdq.mjs";
-import { PostgresKyselyMigrator } from "./PostgresKyselyMigrator-D8fm35-s.mjs";
+import "./PostgresMigrator-BzqksJcW.mjs";
+import { PostgresKyselyMigrator } from "./PostgresKyselyMigrator-ChIpZFYB.mjs";
 
 export { PostgresKyselyMigrator };