@geekmidas/testkit 0.0.6 → 0.0.8

package/dist/VitestTransactionIsolator-DcOz0LZF.cjs

@@ -0,0 +1,129 @@
+
+//#region src/VitestTransactionIsolator.ts
+/**
+* PostgreSQL transaction isolation levels.
+* Controls the visibility of concurrent transactions.
+*
+* @see https://www.postgresql.org/docs/current/transaction-iso.html
+*/
+let IsolationLevel = /* @__PURE__ */ function(IsolationLevel$1) {
+	/**
+	* Lowest isolation level. Allows dirty reads.
+	* Not recommended for testing.
+	*/
+	IsolationLevel$1["READ_UNCOMMITTED"] = "READ UNCOMMITTED";
+	/**
+	* Default PostgreSQL isolation level.
+	* Prevents dirty reads but allows non-repeatable reads.
+	*/
+	IsolationLevel$1["READ_COMMITTED"] = "READ COMMITTED";
+	/**
+	* Prevents dirty reads and non-repeatable reads.
+	* Recommended for most test scenarios.
+	*/
+	IsolationLevel$1["REPEATABLE_READ"] = "REPEATABLE READ";
+	/**
+	* Highest isolation level. Prevents all phenomena.
+	* May cause performance overhead in tests.
+	*/
+	IsolationLevel$1["SERIALIZABLE"] = "SERIALIZABLE";
+	return IsolationLevel$1;
+}({});
+/**
+* Abstract base class for implementing database transaction isolation in Vitest tests.
+* Provides automatic transaction rollback after each test to maintain test isolation.
+* Subclasses must implement the transact() method for their specific database driver.
+*
+* @template Connection - The database connection type
+* @template Transaction - The transaction type
+*
+* @example
+* ```typescript
+* // Implement for your database driver
+* class MyDatabaseIsolator extends VitestPostgresTransactionIsolator<MyDB, MyTx> {
+*   async transact(conn: MyDB, level: IsolationLevel, fn: (tx: MyTx) => Promise<void>) {
+*     await conn.transaction(level, fn);
+*   }
+* }
+*
+* // Use in tests
+* const isolator = new MyDatabaseIsolator(test);
+* const isolatedTest = isolator.wrapVitestWithTransaction(db);
+*
+* isolatedTest('should create user', async ({ trx }) => {
+*   await trx.insert('users', { name: 'Test' });
+*   // Data is automatically rolled back after test
+* });
+* ```
+*/
+var VitestPostgresTransactionIsolator = class {
+	/**
+	* Creates a new VitestPostgresTransactionIsolator instance.
+	*
+	* @param api - The Vitest test API (usually the `test` export from vitest)
+	*/
+	constructor(api) {
+		this.api = api;
+	}
+	/**
+	* Creates a wrapped version of Vitest's test API that provides transaction isolation.
+	* Each test will run within a database transaction that is automatically rolled back.
+	*
+	* @param conn - The database connection to use
+	* @param setup - Optional setup function to run within the transaction before each test
+	* @param level - The transaction isolation level (defaults to REPEATABLE_READ)
+	* @returns A wrapped test API with transaction support
+	*
+	* @example
+	* ```typescript
+	* const isolatedTest = isolator.wrapVitestWithTransaction(db, async (trx) => {
+	*   // Optional setup: create common test data
+	*   await trx.insert('settings', { key: 'test', value: 'true' });
+	* });
+	*
+	* isolatedTest('test with transaction', async ({ trx }) => {
+	*   const user = await trx.insert('users', { name: 'Test' });
+	*   expect(user).toBeDefined();
+	* });
+	* ```
+	*/
+	wrapVitestWithTransaction(conn, setup, level = IsolationLevel.REPEATABLE_READ) {
+		return this.api.extend({ trx: async ({}, use) => {
+			class TestRollback extends Error {
+				constructor() {
+					super("Test rollback");
+					this.name = "TestRollback";
+				}
+			}
+			let testError;
+			try {
+				await this.transact(conn, level, async (transaction) => {
+					try {
+						await setup?.(transaction);
+						await use(transaction);
+					} catch (error) {
+						testError = error;
+					}
+					throw new TestRollback();
+				});
+			} catch (error) {
+				if (!(error instanceof TestRollback)) throw error;
+				if (testError) throw testError;
+			}
+		} });
+	}
+};
+
+//#endregion
+Object.defineProperty(exports, 'IsolationLevel', {
+  enumerable: true,
+  get: function () {
+    return IsolationLevel;
+  }
+});
+Object.defineProperty(exports, 'VitestPostgresTransactionIsolator', {
+  enumerable: true,
+  get: function () {
+    return VitestPostgresTransactionIsolator;
+  }
+});

package/dist/VitestTransactionIsolator-kFL36T8x.mjs

@@ -0,0 +1,117 @@
+//#region src/VitestTransactionIsolator.ts
+/**
+* PostgreSQL transaction isolation levels.
+* Controls the visibility of concurrent transactions.
+*
+* @see https://www.postgresql.org/docs/current/transaction-iso.html
+*/
+let IsolationLevel = /* @__PURE__ */ function(IsolationLevel$1) {
+	/**
+	* Lowest isolation level. Allows dirty reads.
+	* Not recommended for testing.
+	*/
+	IsolationLevel$1["READ_UNCOMMITTED"] = "READ UNCOMMITTED";
+	/**
+	* Default PostgreSQL isolation level.
+	* Prevents dirty reads but allows non-repeatable reads.
+	*/
+	IsolationLevel$1["READ_COMMITTED"] = "READ COMMITTED";
+	/**
+	* Prevents dirty reads and non-repeatable reads.
+	* Recommended for most test scenarios.
+	*/
+	IsolationLevel$1["REPEATABLE_READ"] = "REPEATABLE READ";
+	/**
+	* Highest isolation level. Prevents all phenomena.
+	* May cause performance overhead in tests.
+	*/
+	IsolationLevel$1["SERIALIZABLE"] = "SERIALIZABLE";
+	return IsolationLevel$1;
+}({});
+/**
+* Abstract base class for implementing database transaction isolation in Vitest tests.
+* Provides automatic transaction rollback after each test to maintain test isolation.
+* Subclasses must implement the transact() method for their specific database driver.
+*
+* @template Connection - The database connection type
+* @template Transaction - The transaction type
+*
+* @example
+* ```typescript
+* // Implement for your database driver
+* class MyDatabaseIsolator extends VitestPostgresTransactionIsolator<MyDB, MyTx> {
+*   async transact(conn: MyDB, level: IsolationLevel, fn: (tx: MyTx) => Promise<void>) {
+*     await conn.transaction(level, fn);
+*   }
+* }
+*
+* // Use in tests
+* const isolator = new MyDatabaseIsolator(test);
+* const isolatedTest = isolator.wrapVitestWithTransaction(db);
+*
+* isolatedTest('should create user', async ({ trx }) => {
+*   await trx.insert('users', { name: 'Test' });
+*   // Data is automatically rolled back after test
+* });
+* ```
+*/
+var VitestPostgresTransactionIsolator = class {
+	/**
+	* Creates a new VitestPostgresTransactionIsolator instance.
+	*
+	* @param api - The Vitest test API (usually the `test` export from vitest)
+	*/
+	constructor(api) {
+		this.api = api;
+	}
+	/**
+	* Creates a wrapped version of Vitest's test API that provides transaction isolation.
+	* Each test will run within a database transaction that is automatically rolled back.
+	*
+	* @param conn - The database connection to use
+	* @param setup - Optional setup function to run within the transaction before each test
+	* @param level - The transaction isolation level (defaults to REPEATABLE_READ)
+	* @returns A wrapped test API with transaction support
+	*
+	* @example
+	* ```typescript
+	* const isolatedTest = isolator.wrapVitestWithTransaction(db, async (trx) => {
+	*   // Optional setup: create common test data
+	*   await trx.insert('settings', { key: 'test', value: 'true' });
+	* });
+	*
+	* isolatedTest('test with transaction', async ({ trx }) => {
+	*   const user = await trx.insert('users', { name: 'Test' });
+	*   expect(user).toBeDefined();
+	* });
+	* ```
+	*/
+	wrapVitestWithTransaction(conn, setup, level = IsolationLevel.REPEATABLE_READ) {
+		return this.api.extend({ trx: async ({}, use) => {
+			class TestRollback extends Error {
+				constructor() {
+					super("Test rollback");
+					this.name = "TestRollback";
+				}
+			}
+			let testError;
+			try {
+				await this.transact(conn, level, async (transaction) => {
+					try {
+						await setup?.(transaction);
+						await use(transaction);
+					} catch (error) {
+						testError = error;
+					}
+					throw new TestRollback();
+				});
+			} catch (error) {
+				if (!(error instanceof TestRollback)) throw error;
+				if (testError) throw testError;
+			}
+		} });
+	}
+};
+
+//#endregion
+export { IsolationLevel, VitestPostgresTransactionIsolator };

package/dist/VitestTransactionIsolator.cjs

@@ -1,4 +1,4 @@
-const require_VitestTransactionIsolator = require('./VitestTransactionIsolator-BK9UsrKt.cjs');
+const require_VitestTransactionIsolator = require('./VitestTransactionIsolator-DcOz0LZF.cjs');
 
 exports.IsolationLevel = require_VitestTransactionIsolator.IsolationLevel;
 exports.VitestPostgresTransactionIsolator = require_VitestTransactionIsolator.VitestPostgresTransactionIsolator;

package/dist/VitestTransactionIsolator.mjs

@@ -1,3 +1,3 @@
-import { IsolationLevel, VitestPostgresTransactionIsolator } from "./VitestTransactionIsolator-e-R3p_X8.mjs";
+import { IsolationLevel, VitestPostgresTransactionIsolator } from "./VitestTransactionIsolator-kFL36T8x.mjs";
 
 export { IsolationLevel, VitestPostgresTransactionIsolator };

package/dist/__tests__/Factory.spec.cjs

@@ -1,5 +1,5 @@
 const require_chunk = require('../chunk-CUT6urMc.cjs');
-const require_Factory = require('../Factory-DREHoms3.cjs');
+const require_Factory = require('../Factory-WMhTNZ9S.cjs');
 const vitest = require_chunk.__toESM(require("vitest"));
 
 //#region src/__tests__/Factory.spec.ts

package/dist/__tests__/Factory.spec.mjs

@@ -1,4 +1,4 @@
-import { Factory } from "../Factory-DlzMkMzb.mjs";
+import { Factory } from "../Factory-z2m01hMj.mjs";
 import { beforeEach, describe, expect, it } from "vitest";
 
 //#region src/__tests__/Factory.spec.ts

package/dist/__tests__/KyselyFactory.spec.cjs

@@ -1,14 +1,14 @@
 const require_chunk = require('../chunk-CUT6urMc.cjs');
-require('../Factory-DREHoms3.cjs');
-require('../faker-caz-8zt8.cjs');
-const require_KyselyFactory = require('../KyselyFactory-BX7Kv2uP.cjs');
-require('../PostgresMigrator-Bz-tnjB6.cjs');
-require('../PostgresKyselyMigrator-JTY2LfwD.cjs');
-require('../VitestTransactionIsolator-BK9UsrKt.cjs');
-require('../VitestKyselyTransactionIsolator-jF6Ohyu_.cjs');
-const require_helpers = require('../helpers-DOtYCEvZ.cjs');
-const require_kysely = require('../kysely-DL3C2eM4.cjs');
-const require_helpers$1 = require('../helpers-B2CfbaTC.cjs');
+require('../Factory-WMhTNZ9S.cjs');
+require('../faker-SMN4ira4.cjs');
+const require_KyselyFactory = require('../KyselyFactory-Bdq1s1Go.cjs');
+require('../PostgresMigrator-BtAWdLss.cjs');
+require('../PostgresKyselyMigrator-Bs31emFd.cjs');
+require('../VitestTransactionIsolator-DcOz0LZF.cjs');
+require('../VitestKyselyTransactionIsolator-YWnSJiIH.cjs');
+const require_helpers = require('../helpers-H4hO5SZR.cjs');
+const require_kysely = require('../kysely-B-GOhABm.cjs');
+const require_helpers$1 = require('../helpers-Bnm3Jy9X.cjs');
 const pg = require_chunk.__toESM(require("pg"));
 const vitest = require_chunk.__toESM(require("vitest"));
 

package/dist/__tests__/KyselyFactory.spec.mjs

@@ -1,13 +1,13 @@
-import "../Factory-DlzMkMzb.mjs";
-import "../faker-BwaXA_RF.mjs";
-import { KyselyFactory } from "../KyselyFactory-pOMOFQWE.mjs";
-import "../PostgresMigrator-CEoRKTdq.mjs";
-import "../PostgresKyselyMigrator-D8fm35-s.mjs";
-import "../VitestTransactionIsolator-e-R3p_X8.mjs";
-import "../VitestKyselyTransactionIsolator-D-qpeVKO.mjs";
-import { createKyselyDb } from "../helpers-DN4sJO4i.mjs";
-import { wrapVitestKyselyTransaction } from "../kysely-C1-aHdnU.mjs";
-import { TEST_DATABASE_CONFIG, createTestTables } from "../helpers-Rf5F71r9.mjs";
+import "../Factory-z2m01hMj.mjs";
+import "../faker-CxKkEeYi.mjs";
+import { KyselyFactory } from "../KyselyFactory-ELiHgHVv.mjs";
+import "../PostgresMigrator-BzqksJcW.mjs";
+import "../PostgresKyselyMigrator-ChIpZFYB.mjs";
+import "../VitestTransactionIsolator-kFL36T8x.mjs";
+import "../VitestKyselyTransactionIsolator-AfxPJEwR.mjs";
+import { createKyselyDb } from "../helpers-CKMlwSYT.mjs";
+import { wrapVitestKyselyTransaction } from "../kysely-CqfoKVXs.mjs";
+import { TEST_DATABASE_CONFIG, createTestTables } from "../helpers-CukcFAU9.mjs";
 import pg from "pg";
 import { describe, expect, it } from "vitest";
 

package/dist/__tests__/ObjectionFactory.spec.cjs

@@ -1,7 +1,7 @@
 const require_chunk = require('../chunk-CUT6urMc.cjs');
-require('../Factory-DREHoms3.cjs');
-const require_ObjectionFactory = require('../ObjectionFactory-BlkzSEqo.cjs');
-const require_helpers = require('../helpers-B2CfbaTC.cjs');
+require('../Factory-WMhTNZ9S.cjs');
+const require_ObjectionFactory = require('../ObjectionFactory-C47B03Ot.cjs');
+const require_helpers = require('../helpers-Bnm3Jy9X.cjs');
 const vitest = require_chunk.__toESM(require("vitest"));
 const objection = require_chunk.__toESM(require("objection"));
 

package/dist/__tests__/ObjectionFactory.spec.mjs

@@ -1,6 +1,6 @@
-import "../Factory-DlzMkMzb.mjs";
-import { ObjectionFactory } from "../ObjectionFactory-ChuX8sZN.mjs";
-import { setupKnexTest } from "../helpers-Rf5F71r9.mjs";
+import "../Factory-z2m01hMj.mjs";
+import { ObjectionFactory } from "../ObjectionFactory-89p-FFEw.mjs";
+import { setupKnexTest } from "../helpers-CukcFAU9.mjs";
 import { afterAll, beforeAll, describe, expect, it } from "vitest";
 import { Model } from "objection";
 

package/dist/__tests__/PostgresMigrator.spec.cjs

@@ -1,6 +1,6 @@
 const require_chunk = require('../chunk-CUT6urMc.cjs');
-const require_PostgresMigrator = require('../PostgresMigrator-Bz-tnjB6.cjs');
-const require_helpers = require('../helpers-B2CfbaTC.cjs');
+const require_PostgresMigrator = require('../PostgresMigrator-BtAWdLss.cjs');
+const require_helpers = require('../helpers-Bnm3Jy9X.cjs');
 const pg = require_chunk.__toESM(require("pg"));
 const vitest = require_chunk.__toESM(require("vitest"));
 

package/dist/__tests__/PostgresMigrator.spec.mjs

@@ -1,5 +1,5 @@
-import { PostgresMigrator } from "../PostgresMigrator-CEoRKTdq.mjs";
-import { createTestDatabase } from "../helpers-Rf5F71r9.mjs";
+import { PostgresMigrator } from "../PostgresMigrator-BzqksJcW.mjs";
+import { createTestDatabase } from "../helpers-CukcFAU9.mjs";
 import { Client } from "pg";
 import { afterAll, afterEach, beforeAll, beforeEach, describe, expect, it, vi } from "vitest";
 

package/dist/__tests__/faker.spec.cjs

@@ -1,5 +1,5 @@
 const require_chunk = require('../chunk-CUT6urMc.cjs');
-const require_faker = require('../faker-caz-8zt8.cjs');
+const require_faker = require('../faker-SMN4ira4.cjs');
 const vitest = require_chunk.__toESM(require("vitest"));
 
 //#region src/__tests__/faker.spec.ts

package/dist/__tests__/faker.spec.mjs

@@ -1,4 +1,4 @@
-import { faker } from "../faker-BwaXA_RF.mjs";
+import { faker } from "../faker-CxKkEeYi.mjs";
 import { beforeEach, describe, expect, it } from "vitest";
 
 //#region src/__tests__/faker.spec.ts

package/dist/__tests__/integration.spec.cjs

@@ -1,14 +1,14 @@
 const require_chunk = require('../chunk-CUT6urMc.cjs');
-require('../Factory-DREHoms3.cjs');
-require('../faker-caz-8zt8.cjs');
-const require_KyselyFactory = require('../KyselyFactory-BX7Kv2uP.cjs');
-require('../PostgresMigrator-Bz-tnjB6.cjs');
-require('../PostgresKyselyMigrator-JTY2LfwD.cjs');
-require('../VitestTransactionIsolator-BK9UsrKt.cjs');
-require('../VitestKyselyTransactionIsolator-jF6Ohyu_.cjs');
-const require_helpers = require('../helpers-DOtYCEvZ.cjs');
-const require_kysely = require('../kysely-DL3C2eM4.cjs');
-const require_helpers$1 = require('../helpers-B2CfbaTC.cjs');
+require('../Factory-WMhTNZ9S.cjs');
+require('../faker-SMN4ira4.cjs');
+const require_KyselyFactory = require('../KyselyFactory-Bdq1s1Go.cjs');
+require('../PostgresMigrator-BtAWdLss.cjs');
+require('../PostgresKyselyMigrator-Bs31emFd.cjs');
+require('../VitestTransactionIsolator-DcOz0LZF.cjs');
+require('../VitestKyselyTransactionIsolator-YWnSJiIH.cjs');
+const require_helpers = require('../helpers-H4hO5SZR.cjs');
+const require_kysely = require('../kysely-B-GOhABm.cjs');
+const require_helpers$1 = require('../helpers-Bnm3Jy9X.cjs');
 const vitest = require_chunk.__toESM(require("vitest"));
 
 //#region src/__tests__/integration.spec.ts

package/dist/__tests__/integration.spec.mjs

@@ -1,13 +1,13 @@
-import "../Factory-DlzMkMzb.mjs";
-import "../faker-BwaXA_RF.mjs";
-import { KyselyFactory } from "../KyselyFactory-pOMOFQWE.mjs";
-import "../PostgresMigrator-CEoRKTdq.mjs";
-import "../PostgresKyselyMigrator-D8fm35-s.mjs";
-import "../VitestTransactionIsolator-e-R3p_X8.mjs";
-import "../VitestKyselyTransactionIsolator-D-qpeVKO.mjs";
-import { createKyselyDb } from "../helpers-DN4sJO4i.mjs";
-import { wrapVitestKyselyTransaction } from "../kysely-C1-aHdnU.mjs";
-import { TEST_DATABASE_CONFIG, createTestTables } from "../helpers-Rf5F71r9.mjs";
+import "../Factory-z2m01hMj.mjs";
+import "../faker-CxKkEeYi.mjs";
+import { KyselyFactory } from "../KyselyFactory-ELiHgHVv.mjs";
+import "../PostgresMigrator-BzqksJcW.mjs";
+import "../PostgresKyselyMigrator-ChIpZFYB.mjs";
+import "../VitestTransactionIsolator-kFL36T8x.mjs";
+import "../VitestKyselyTransactionIsolator-AfxPJEwR.mjs";
+import { createKyselyDb } from "../helpers-CKMlwSYT.mjs";
+import { wrapVitestKyselyTransaction } from "../kysely-CqfoKVXs.mjs";
+import { TEST_DATABASE_CONFIG, createTestTables } from "../helpers-CukcFAU9.mjs";
 import { beforeAll, describe, expect, it } from "vitest";
 
 //#region src/__tests__/integration.spec.ts

package/dist/example.cjs

@@ -1,6 +1,6 @@
-require('./Factory-DREHoms3.cjs');
-require('./faker-caz-8zt8.cjs');
-const require_KyselyFactory = require('./KyselyFactory-BX7Kv2uP.cjs');
+require('./Factory-WMhTNZ9S.cjs');
+require('./faker-SMN4ira4.cjs');
+const require_KyselyFactory = require('./KyselyFactory-Bdq1s1Go.cjs');
 
 //#region src/example.ts
 const userBuilder = require_KyselyFactory.KyselyFactory.createBuilder({

package/dist/example.mjs

@@ -1,6 +1,6 @@
-import "./Factory-DlzMkMzb.mjs";
-import "./faker-BwaXA_RF.mjs";
-import { KyselyFactory } from "./KyselyFactory-pOMOFQWE.mjs";
+import "./Factory-z2m01hMj.mjs";
+import "./faker-CxKkEeYi.mjs";
+import { KyselyFactory } from "./KyselyFactory-ELiHgHVv.mjs";
 
 //#region src/example.ts
 const userBuilder = KyselyFactory.createBuilder({