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

package/dist/PostgresMigrator.mjs

@@ -1,3 +1,176 @@
-import { PostgresMigrator } from "./PostgresMigrator-DVAY04qN.mjs";
+import pg from "pg";
+//#region src/PostgresMigrator.ts
+const { Client } = pg;
+/**
+* Creates a PostgreSQL client connected to the 'postgres' database.
+* Extracts connection details from the provided URI.
+*
+* @param uri - PostgreSQL connection URI
+* @returns Object containing the target database name and client instance
+*
+* @example
+* ```typescript
+* const { database, db } = await setupClient('postgresql://user:pass@localhost:5432/mydb');
+* // database = 'mydb'
+* // db = Client instance connected to 'postgres' database
+* ```
+*/
+async function setupClient(uri) {
+	const url = new URL(uri);
+	const db = new Client({
+		user: url.username,
+		password: url.password,
+		host: url.hostname,
+		port: parseInt(url.port, 10),
+		database: "postgres"
+	});
+	let database = url.pathname.slice(1);
+	if (database.includes("?")) database = database.substring(0, database.indexOf("?"));
+	return {
+		database,
+		db
+	};
+}
+/**
+* Default logger instance for migration operations.
+*/
+const logger = console;
+/**
+* Abstract base class for PostgreSQL database migration utilities.
+* Provides database creation, migration, and cleanup functionality for testing.
+* Subclasses must implement the migrate() method to define migration logic.
+*
+* @example
+* ```typescript
+* class MyMigrator extends PostgresMigrator {
+*   async migrate(): Promise<void> {
+*     // Run your migrations here
+*     await this.runMigrations();
+*   }
+* }
+*
+* // Use in tests
+* const migrator = new MyMigrator('postgresql://localhost:5432/test_db');
+* const cleanup = await migrator.start();
+*
+* // With afterCreate hook (e.g. run init script to create per-app users)
+* import { runInitScript } from '@geekmidas/testkit/postgres';
+*
+* const migrator = new MyMigrator(
+*   'postgresql://localhost:5432/test_db',
+*   async (uri) => {
+*     await runInitScript('docker/postgres/init.sh', uri, env);
+*   },
+* );
+* const cleanup = await migrator.start();
+*
+* // Run tests...
+*
+* // Clean up
+* await cleanup();
+* ```
+*/
+var PostgresMigrator = class PostgresMigrator {
+	uri;
+	afterCreate;
+	/**
+	* Creates a new PostgresMigrator instance.
+	*
+	* @param uri - PostgreSQL connection URI
+	* @param afterCreate - Optional hook called after database creation but before migrations
+	*/
+	constructor(uri, afterCreate) {
+		this.uri = uri;
+		this.afterCreate = afterCreate;
+	}
+	/**
+	* Creates a PostgreSQL database if it doesn't already exist.
+	* Connects to the 'postgres' database to check and create the target database.
+	*
+	* @param uri - PostgreSQL connection URI
+	* @returns Object indicating whether the database already existed
+	* @private
+	*/
+	static async create(uri) {
+		const { database, db } = await setupClient(uri);
+		try {
+			await db.connect();
+			const result = await db.query(`SELECT * FROM pg_catalog.pg_database WHERE datname = '${database}'`);
+			if (result.rowCount === 0) try {
+				await db.query(`CREATE DATABASE "${database}"`);
+			} catch (error) {
+				if (error?.code === "42P04" || error?.code === "23505" && error?.constraint === "pg_database_datname_index") return { alreadyExisted: true };
+				throw error;
+			}
+			return { alreadyExisted: result.rowCount ? result.rowCount > 0 : false };
+		} finally {
+			await db.end();
+		}
+	}
+	/**
+	* Drops a PostgreSQL database.
+	* Used for cleanup after tests are complete.
+	*
+	* @param uri - PostgreSQL connection URI
+	* @throws Error if database cannot be dropped
+	* @private
+	*/
+	static async drop(uri) {
+		const { database, db } = await setupClient(uri);
+		try {
+			await db.connect();
+			await db.query(`DROP DATABASE "${database}"`);
+		} finally {
+			await db.end();
+		}
+	}
+	/**
+	* Starts the migration process by creating the database and running migrations.
+	* Returns a cleanup function that drops the database — if this call created
+	* it.
+	*
+	* A database that was already there belongs to whoever made it, and the
+	* cleanup leaves it alone. `gkm test` provisions the test database before
+	* the suite starts, with an owner role that may migrate it but not drop it:
+	* dropping it was never the suite's to do, and failed there as a permission
+	* error on the way out of an otherwise green run.
+	*
+	* @returns Async cleanup function that drops the database if it created it
+	*
+	* @example
+	* ```typescript
+	* const migrator = new MyMigrator('postgresql://localhost:5432/test_db');
+	*
+	* // Start migrations and get cleanup function
+	* const cleanup = await migrator.start();
+	*
+	* try {
+	*   // Run your tests here
+	*   await runTests();
+	* } finally {
+	*   // Always clean up
+	*   await cleanup();
+	* }
+	* ```
+	*/
+	async start() {
+		const { database, db } = await setupClient(this.uri);
+		let created = false;
+		try {
+			const { alreadyExisted } = await PostgresMigrator.create(this.uri);
+			created = !alreadyExisted;
+			if (this.afterCreate) await this.afterCreate(this.uri);
+			await this.migrate();
+			logger.log(`Migrating database: ${database}`);
+		} finally {
+			await db.end();
+		}
+		return async () => {
+			if (created) await PostgresMigrator.drop(this.uri);
+		};
+	}
+};
+//#endregion
+export { PostgresMigrator };
 
-export { PostgresMigrator };
+//# sourceMappingURL=PostgresMigrator.mjs.map

package/dist/PostgresMigrator.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"PostgresMigrator.mjs","names":[],"sources":["../src/PostgresMigrator.ts"],"sourcesContent":["import pg from 'pg';\n\nconst { Client } = pg;\n\n/**\n * Creates a PostgreSQL client connected to the 'postgres' database.\n * Extracts connection details from the provided URI.\n *\n * @param uri - PostgreSQL connection URI\n * @returns Object containing the target database name and client instance\n *\n * @example\n * ```typescript\n * const { database, db } = await setupClient('postgresql://user:pass@localhost:5432/mydb');\n * // database = 'mydb'\n * // db = Client instance connected to 'postgres' database\n * ```\n */\nasync function setupClient(uri: string) {\n\tconst url = new URL(uri);\n\n\tconst db = new Client({\n\t\tuser: url.username,\n\t\tpassword: url.password,\n\t\thost: url.hostname,\n\t\tport: parseInt(url.port, 10),\n\t\tdatabase: 'postgres',\n\t});\n\n\tlet database = url.pathname.slice(1);\n\tif (database.includes('?')) {\n\t\tdatabase = database.substring(0, database.indexOf('?'));\n\t}\n\treturn { database, db };\n}\n\n/**\n * Default logger instance for migration operations.\n */\nconst logger = console;\n\n/**\n * Abstract base class for PostgreSQL database migration utilities.\n * Provides database creation, migration, and cleanup functionality for testing.\n * Subclasses must implement the migrate() method to define migration logic.\n *\n * @example\n * ```typescript\n * class MyMigrator extends PostgresMigrator {\n *   async migrate(): Promise<void> {\n *     // Run your migrations here\n *     await this.runMigrations();\n *   }\n * }\n *\n * // Use in tests\n * const migrator = new MyMigrator('postgresql://localhost:5432/test_db');\n * const cleanup = await migrator.start();\n *\n * // With afterCreate hook (e.g. run init script to create per-app users)\n * import { runInitScript } from '@geekmidas/testkit/postgres';\n *\n * const migrator = new MyMigrator(\n *   'postgresql://localhost:5432/test_db',\n *   async (uri) => {\n *     await runInitScript('docker/postgres/init.sh', uri, env);\n *   },\n * );\n * const cleanup = await migrator.start();\n *\n * // Run tests...\n *\n * // Clean up\n * await cleanup();\n * ```\n */\nexport abstract class PostgresMigrator {\n\t/**\n\t * Creates a new PostgresMigrator instance.\n\t *\n\t * @param uri - PostgreSQL connection URI\n\t * @param afterCreate - Optional hook called after database creation but before migrations\n\t */\n\tconstructor(\n\t\tprivate uri: string,\n\t\tprivate afterCreate?: (uri: string) => Promise<void>,\n\t) {}\n\n\t/**\n\t * Abstract method to be implemented by subclasses.\n\t * Should contain the migration logic for setting up database schema.\n\t *\n\t * @returns Promise that resolves when migrations are complete\n\t */\n\tabstract migrate(): Promise<void>;\n\n\t/**\n\t * Creates a PostgreSQL database if it doesn't already exist.\n\t * Connects to the 'postgres' database to check and create the target database.\n\t *\n\t * @param uri - PostgreSQL connection URI\n\t * @returns Object indicating whether the database already existed\n\t * @private\n\t */\n\tprivate static async create(\n\t\turi: string,\n\t): Promise<{ alreadyExisted: boolean }> {\n\t\tconst { database, db } = await setupClient(uri);\n\t\ttry {\n\t\t\tawait db.connect();\n\t\t\tconst result = await db.query(\n\t\t\t\t`SELECT * FROM pg_catalog.pg_database WHERE datname = '${database}'`,\n\t\t\t);\n\n\t\t\tif (result.rowCount === 0) {\n\t\t\t\ttry {\n\t\t\t\t\tawait db.query(`CREATE DATABASE \"${database}\"`);\n\t\t\t\t} catch (error: any) {\n\t\t\t\t\t// Another process created it between our check and our create. Postgres\n\t\t\t\t\t// reports that as 42P04 (duplicate_database) — or, when the two creates\n\t\t\t\t\t// race inside the catalog itself, as 23505 on pg_database's name index.\n\t\t\t\t\tif (\n\t\t\t\t\t\terror?.code === '42P04' ||\n\t\t\t\t\t\t(error?.code === '23505' &&\n\t\t\t\t\t\t\terror?.constraint === 'pg_database_datname_index')\n\t\t\t\t\t) {\n\t\t\t\t\t\treturn { alreadyExisted: true };\n\t\t\t\t\t}\n\t\t\t\t\tthrow error;\n\t\t\t\t}\n\t\t\t}\n\n\t\t\treturn {\n\t\t\t\talreadyExisted: result.rowCount ? result.rowCount > 0 : false,\n\t\t\t};\n\t\t} finally {\n\t\t\tawait db.end();\n\t\t}\n\t}\n\n\t/**\n\t * Drops a PostgreSQL database.\n\t * Used for cleanup after tests are complete.\n\t *\n\t * @param uri - PostgreSQL connection URI\n\t * @throws Error if database cannot be dropped\n\t * @private\n\t */\n\tprivate static async drop(uri: string): Promise<void> {\n\t\tconst { database, db } = await setupClient(uri);\n\t\ttry {\n\t\t\tawait db.connect();\n\t\t\tawait db.query(`DROP DATABASE \"${database}\"`);\n\t\t} finally {\n\t\t\tawait db.end();\n\t\t}\n\t}\n\n\t/**\n\t * Starts the migration process by creating the database and running migrations.\n\t * Returns a cleanup function that drops the database — if this call created\n\t * it.\n\t *\n\t * A database that was already there belongs to whoever made it, and the\n\t * cleanup leaves it alone. `gkm test` provisions the test database before\n\t * the suite starts, with an owner role that may migrate it but not drop it:\n\t * dropping it was never the suite's to do, and failed there as a permission\n\t * error on the way out of an otherwise green run.\n\t *\n\t * @returns Async cleanup function that drops the database if it created it\n\t *\n\t * @example\n\t * ```typescript\n\t * const migrator = new MyMigrator('postgresql://localhost:5432/test_db');\n\t *\n\t * // Start migrations and get cleanup function\n\t * const cleanup = await migrator.start();\n\t *\n\t * try {\n\t *   // Run your tests here\n\t *   await runTests();\n\t * } finally {\n\t *   // Always clean up\n\t *   await cleanup();\n\t * }\n\t * ```\n\t */\n\tasync start() {\n\t\tconst { database, db } = await setupClient(this.uri);\n\t\tlet created = false;\n\t\ttry {\n\t\t\tconst { alreadyExisted } = await PostgresMigrator.create(this.uri);\n\t\t\tcreated = !alreadyExisted;\n\t\t\tif (this.afterCreate) {\n\t\t\t\tawait this.afterCreate(this.uri);\n\t\t\t}\n\t\t\tawait this.migrate();\n\t\t\tlogger.log(`Migrating database: ${database}`);\n\t\t\t// Example: await db.query('CREATE TABLE example (id SERIAL PRIMARY KEY)');\n\t\t} finally {\n\t\t\tawait db.end();\n\t\t}\n\n\t\treturn async () => {\n\t\t\tif (created) await PostgresMigrator.drop(this.uri);\n\t\t};\n\t}\n}\n"],"mappings":";;AAEA,MAAM,EAAE,WAAW;;;;;;;;;;;;;;;AAgBnB,eAAe,YAAY,KAAa;CACvC,MAAM,MAAM,IAAI,IAAI,GAAG;CAEvB,MAAM,KAAK,IAAI,OAAO;EACrB,MAAM,IAAI;EACV,UAAU,IAAI;EACd,MAAM,IAAI;EACV,MAAM,SAAS,IAAI,MAAM,EAAE;EAC3B,UAAU;CACX,CAAC;CAED,IAAI,WAAW,IAAI,SAAS,MAAM,CAAC;CACnC,IAAI,SAAS,SAAS,GAAG,GACxB,WAAW,SAAS,UAAU,GAAG,SAAS,QAAQ,GAAG,CAAC;CAEvD,OAAO;EAAE;EAAU;CAAG;AACvB;;;;AAKA,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAqCf,IAAsB,mBAAtB,MAAsB,iBAAiB;CAQ7B;CACA;;;;;;;CAFT,YACC,KACA,aACC;EAFO,KAAA,MAAA;EACA,KAAA,cAAA;CACN;;;;;;;;;CAkBH,aAAqB,OACpB,KACuC;EACvC,MAAM,EAAE,UAAU,OAAO,MAAM,YAAY,GAAG;EAC9C,IAAI;GACH,MAAM,GAAG,QAAQ;GACjB,MAAM,SAAS,MAAM,GAAG,MACvB,yDAAyD,SAAS,EACnE;GAEA,IAAI,OAAO,aAAa,GACvB,IAAI;IACH,MAAM,GAAG,MAAM,oBAAoB,SAAS,EAAE;GAC/C,SAAS,OAAY;IAIpB,IACC,OAAO,SAAS,WACf,OAAO,SAAS,WAChB,OAAO,eAAe,6BAEvB,OAAO,EAAE,gBAAgB,KAAK;IAE/B,MAAM;GACP;GAGD,OAAO,EACN,gBAAgB,OAAO,WAAW,OAAO,WAAW,IAAI,MACzD;EACD,UAAU;GACT,MAAM,GAAG,IAAI;EACd;CACD;;;;;;;;;CAUA,aAAqB,KAAK,KAA4B;EACrD,MAAM,EAAE,UAAU,OAAO,MAAM,YAAY,GAAG;EAC9C,IAAI;GACH,MAAM,GAAG,QAAQ;GACjB,MAAM,GAAG,MAAM,kBAAkB,SAAS,EAAE;EAC7C,UAAU;GACT,MAAM,GAAG,IAAI;EACd;CACD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+BA,MAAM,QAAQ;EACb,MAAM,EAAE,UAAU,OAAO,MAAM,YAAY,KAAK,GAAG;EACnD,IAAI,UAAU;EACd,IAAI;GACH,MAAM,EAAE,mBAAmB,MAAM,iBAAiB,OAAO,KAAK,GAAG;GACjE,UAAU,CAAC;GACX,IAAI,KAAK,aACR,MAAM,KAAK,YAAY,KAAK,GAAG;GAEhC,MAAM,KAAK,QAAQ;GACnB,OAAO,IAAI,uBAAuB,UAAU;EAE7C,UAAU;GACT,MAAM,GAAG,IAAI;EACd;EAEA,OAAO,YAAY;GAClB,IAAI,SAAS,MAAM,iBAAiB,KAAK,KAAK,GAAG;EAClD;CACD;AACD"}

package/dist/PostgresObjectionMigrator.cjs

@@ -1,4 +1,119 @@
-require('./PostgresMigrator-M9jpzOvN.cjs');
-const require_PostgresObjectionMigrator = require('./PostgresObjectionMigrator-DSaPhwjY.cjs');
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_PostgresMigrator = require("./PostgresMigrator.cjs");
+//#region src/PostgresObjectionMigrator.ts
+/**
+* Default logger instance for migration operations.
+*/
+const logger = console;
+/**
+* PostgreSQL migrator implementation for Objection.js ORM with Knex.
+* Extends PostgresMigrator to provide Knex-specific migration functionality.
+* Automatically creates test databases and applies migrations for testing environments.
+*
+* @example
+* ```typescript
+* import knex from 'knex';
+* import { PostgresObjectionMigrator } from '@geekmidas/testkit';
+*
+* // Create Knex instance
+* const db = knex({
+*   client: 'pg',
+*   connection: uri,
+*   migrations: {
+*     directory: path.join(__dirname, 'migrations'),
+*     extension: 'ts'
+*   }
+* });
+*
+* // Create and use migrator
+* const migrator = new PostgresObjectionMigrator({
+*   uri: 'postgresql://localhost:5432/test_db',
+*   knex: db
+* });
+*
+* const cleanup = await migrator.start();
+* // Run tests...
+* await cleanup();
+* ```
+*/
+var PostgresObjectionMigrator = class extends require_PostgresMigrator.PostgresMigrator {
+	options;
+	/**
+	* Creates a new PostgresObjectionMigrator instance.
+	*
+	* @param options - Configuration options
+	* @param options.uri - PostgreSQL connection URI
+	* @param options.knex - Knex database instance configured with migrations
+	*/
+	constructor(options) {
+		super(options.uri);
+		this.options = options;
+	}
+	/**
+	* Executes Knex 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() {
+		try {
+			const [batchNo, migrations] = await this.options.knex.migrate.latest();
+			if (migrations.length > 0) {
+				logger.log(`Applied batch ${batchNo} with ${migrations.length} migrations:`);
+				migrations.forEach((migration) => {
+					logger.log(`  - ${migration}`);
+				});
+			} else logger.log("No pending migrations to apply");
+		} catch (error) {
+			logger.error("Failed to apply migrations:", error);
+			throw error;
+		} finally {
+			await this.options.knex.destroy();
+		}
+	}
+	/**
+	* Rolls back the last batch of migrations.
+	* Useful for testing migration rollback scenarios.
+	*
+	* @returns Promise that resolves when rollback is complete
+	*/
+	async rollback() {
+		try {
+			const [batchNo, migrations] = await this.options.knex.migrate.rollback();
+			if (migrations.length > 0) {
+				logger.log(`Rolled back batch ${batchNo} with ${migrations.length} migrations:`);
+				migrations.forEach((migration) => {
+					logger.log(`  - ${migration}`);
+				});
+			} else logger.log("No migrations to rollback");
+		} catch (error) {
+			logger.error("Failed to rollback migrations:", error);
+			throw error;
+		} finally {
+			await this.options.knex.destroy();
+		}
+	}
+	/**
+	* Gets the current migration status.
+	* Returns information about completed and pending migrations.
+	*
+	* @returns Promise with migration status information
+	*/
+	async status() {
+		try {
+			const completed = await this.options.knex.migrate.list();
+			const [, pending] = await this.options.knex.migrate.currentVersion();
+			return {
+				completed: Array.isArray(completed[0]) ? completed[0] : [],
+				pending: Array.isArray(pending) ? pending : []
+			};
+		} finally {
+			await this.options.knex.destroy();
+		}
+	}
+};
+//#endregion
+exports.PostgresObjectionMigrator = PostgresObjectionMigrator;
 
-exports.PostgresObjectionMigrator = require_PostgresObjectionMigrator.PostgresObjectionMigrator;
+//# sourceMappingURL=PostgresObjectionMigrator.cjs.map

package/dist/PostgresObjectionMigrator.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"PostgresObjectionMigrator.cjs","names":["PostgresMigrator"],"sources":["../src/PostgresObjectionMigrator.ts"],"sourcesContent":["import type { Knex } from 'knex';\nimport { PostgresMigrator } from './PostgresMigrator';\n\n/**\n * Default logger instance for migration operations.\n */\nconst logger = console;\n\n/**\n * PostgreSQL migrator implementation for Objection.js ORM with Knex.\n * Extends PostgresMigrator to provide Knex-specific migration functionality.\n * Automatically creates test databases and applies migrations for testing environments.\n *\n * @example\n * ```typescript\n * import knex from 'knex';\n * import { PostgresObjectionMigrator } from '@geekmidas/testkit';\n *\n * // Create Knex instance\n * const db = knex({\n *   client: 'pg',\n *   connection: uri,\n *   migrations: {\n *     directory: path.join(__dirname, 'migrations'),\n *     extension: 'ts'\n *   }\n * });\n *\n * // Create and use migrator\n * const migrator = new PostgresObjectionMigrator({\n *   uri: 'postgresql://localhost:5432/test_db',\n *   knex: db\n * });\n *\n * const cleanup = await migrator.start();\n * // Run tests...\n * await cleanup();\n * ```\n */\nexport class PostgresObjectionMigrator extends PostgresMigrator {\n\t/**\n\t * Creates a new PostgresObjectionMigrator instance.\n\t *\n\t * @param options - Configuration options\n\t * @param options.uri - PostgreSQL connection URI\n\t * @param options.knex - Knex database instance configured with migrations\n\t */\n\tconstructor(\n\t\tprivate options: {\n\t\t\turi: string;\n\t\t\tknex: Knex;\n\t\t},\n\t) {\n\t\tsuper(options.uri);\n\t}\n\n\t/**\n\t * Executes Knex migrations to the latest version.\n\t * Implements the abstract migrate() method from PostgresMigrator.\n\t *\n\t * @throws Error if migrations fail to apply\n\t * @returns Promise that resolves when all migrations are applied\n\t */\n\tasync migrate(): Promise<void> {\n\t\ttry {\n\t\t\t// Run migrations to latest\n\t\t\tconst [batchNo, migrations] = await this.options.knex.migrate.latest();\n\n\t\t\tif (migrations.length > 0) {\n\t\t\t\tlogger.log(\n\t\t\t\t\t`Applied batch ${batchNo} with ${migrations.length} migrations:`,\n\t\t\t\t);\n\t\t\t\tmigrations.forEach((migration: string) => {\n\t\t\t\t\tlogger.log(`  - ${migration}`);\n\t\t\t\t});\n\t\t\t} else {\n\t\t\t\tlogger.log('No pending migrations to apply');\n\t\t\t}\n\t\t} catch (error) {\n\t\t\tlogger.error('Failed to apply migrations:', error);\n\t\t\tthrow error;\n\t\t} finally {\n\t\t\t// Always destroy the connection pool\n\t\t\tawait this.options.knex.destroy();\n\t\t}\n\t}\n\n\t/**\n\t * Rolls back the last batch of migrations.\n\t * Useful for testing migration rollback scenarios.\n\t *\n\t * @returns Promise that resolves when rollback is complete\n\t */\n\tasync rollback(): Promise<void> {\n\t\ttry {\n\t\t\tconst [batchNo, migrations] = await this.options.knex.migrate.rollback();\n\n\t\t\tif (migrations.length > 0) {\n\t\t\t\tlogger.log(\n\t\t\t\t\t`Rolled back batch ${batchNo} with ${migrations.length} migrations:`,\n\t\t\t\t);\n\t\t\t\tmigrations.forEach((migration: string) => {\n\t\t\t\t\tlogger.log(`  - ${migration}`);\n\t\t\t\t});\n\t\t\t} else {\n\t\t\t\tlogger.log('No migrations to rollback');\n\t\t\t}\n\t\t} catch (error) {\n\t\t\tlogger.error('Failed to rollback migrations:', error);\n\t\t\tthrow error;\n\t\t} finally {\n\t\t\tawait this.options.knex.destroy();\n\t\t}\n\t}\n\n\t/**\n\t * Gets the current migration status.\n\t * Returns information about completed and pending migrations.\n\t *\n\t * @returns Promise with migration status information\n\t */\n\tasync status(): Promise<{\n\t\tcompleted: string[];\n\t\tpending: string[];\n\t}> {\n\t\ttry {\n\t\t\tconst completed = await this.options.knex.migrate.list();\n\t\t\tconst [, pending] = await this.options.knex.migrate.currentVersion();\n\n\t\t\treturn {\n\t\t\t\tcompleted: Array.isArray(completed[0]) ? completed[0] : [],\n\t\t\t\tpending: Array.isArray(pending) ? pending : [],\n\t\t\t};\n\t\t} finally {\n\t\t\tawait this.options.knex.destroy();\n\t\t}\n\t}\n}\n"],"mappings":";;;;;;AAMA,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAiCf,IAAa,4BAAb,cAA+CA,yBAAAA,iBAAiB;CAStD;;;;;;;;CADT,YACC,SAIC;EACD,MAAM,QAAQ,GAAG;EALT,KAAA,UAAA;CAMT;;;;;;;;CASA,MAAM,UAAyB;EAC9B,IAAI;GAEH,MAAM,CAAC,SAAS,cAAc,MAAM,KAAK,QAAQ,KAAK,QAAQ,OAAO;GAErE,IAAI,WAAW,SAAS,GAAG;IAC1B,OAAO,IACN,iBAAiB,QAAQ,QAAQ,WAAW,OAAO,aACpD;IACA,WAAW,SAAS,cAAsB;KACzC,OAAO,IAAI,OAAO,WAAW;IAC9B,CAAC;GACF,OACC,OAAO,IAAI,gCAAgC;EAE7C,SAAS,OAAO;GACf,OAAO,MAAM,+BAA+B,KAAK;GACjD,MAAM;EACP,UAAU;GAET,MAAM,KAAK,QAAQ,KAAK,QAAQ;EACjC;CACD;;;;;;;CAQA,MAAM,WAA0B;EAC/B,IAAI;GACH,MAAM,CAAC,SAAS,cAAc,MAAM,KAAK,QAAQ,KAAK,QAAQ,SAAS;GAEvE,IAAI,WAAW,SAAS,GAAG;IAC1B,OAAO,IACN,qBAAqB,QAAQ,QAAQ,WAAW,OAAO,aACxD;IACA,WAAW,SAAS,cAAsB;KACzC,OAAO,IAAI,OAAO,WAAW;IAC9B,CAAC;GACF,OACC,OAAO,IAAI,2BAA2B;EAExC,SAAS,OAAO;GACf,OAAO,MAAM,kCAAkC,KAAK;GACpD,MAAM;EACP,UAAU;GACT,MAAM,KAAK,QAAQ,KAAK,QAAQ;EACjC;CACD;;;;;;;CAQA,MAAM,SAGH;EACF,IAAI;GACH,MAAM,YAAY,MAAM,KAAK,QAAQ,KAAK,QAAQ,KAAK;GACvD,MAAM,GAAG,WAAW,MAAM,KAAK,QAAQ,KAAK,QAAQ,eAAe;GAEnE,OAAO;IACN,WAAW,MAAM,QAAQ,UAAU,EAAE,IAAI,UAAU,KAAK,CAAC;IACzD,SAAS,MAAM,QAAQ,OAAO,IAAI,UAAU,CAAC;GAC9C;EACD,UAAU;GACT,MAAM,KAAK,QAAQ,KAAK,QAAQ;EACjC;CACD;AACD"}

package/dist/PostgresObjectionMigrator.d.cts

@@ -1,3 +1,75 @@
-import "./PostgresMigrator-CeYy-eHF.cjs";
-import { PostgresObjectionMigrator } from "./PostgresObjectionMigrator-DHVC9h_P.cjs";
-export { PostgresObjectionMigrator };
+import { t as PostgresMigrator } from "./PostgresMigrator-CDPnnwMJ.cjs";
+import { Knex } from "knex";
+//#region src/PostgresObjectionMigrator.d.ts
+/**
+ * PostgreSQL migrator implementation for Objection.js ORM with Knex.
+ * Extends PostgresMigrator to provide Knex-specific migration functionality.
+ * Automatically creates test databases and applies migrations for testing environments.
+ *
+ * @example
+ * ```typescript
+ * import knex from 'knex';
+ * import { PostgresObjectionMigrator } from '@geekmidas/testkit';
+ *
+ * // Create Knex instance
+ * const db = knex({
+ *   client: 'pg',
+ *   connection: uri,
+ *   migrations: {
+ *     directory: path.join(__dirname, 'migrations'),
+ *     extension: 'ts'
+ *   }
+ * });
+ *
+ * // Create and use migrator
+ * const migrator = new PostgresObjectionMigrator({
+ *   uri: 'postgresql://localhost:5432/test_db',
+ *   knex: db
+ * });
+ *
+ * const cleanup = await migrator.start();
+ * // Run tests...
+ * await cleanup();
+ * ```
+ */
+export declare class PostgresObjectionMigrator extends PostgresMigrator {
+  private options;
+  /**
+   * Creates a new PostgresObjectionMigrator instance.
+   *
+   * @param options - Configuration options
+   * @param options.uri - PostgreSQL connection URI
+   * @param options.knex - Knex database instance configured with migrations
+   */
+  constructor(options: {
+    uri: string;
+    knex: Knex;
+  });
+  /**
+   * Executes Knex migrations to the latest version.
+   * Implements the abstract migrate() method from PostgresMigrator.
+   *
+   * @throws Error if migrations fail to apply
+   * @returns Promise that resolves when all migrations are applied
+   */
+  migrate(): Promise<void>;
+  /**
+   * Rolls back the last batch of migrations.
+   * Useful for testing migration rollback scenarios.
+   *
+   * @returns Promise that resolves when rollback is complete
+   */
+  rollback(): Promise<void>;
+  /**
+   * Gets the current migration status.
+   * Returns information about completed and pending migrations.
+   *
+   * @returns Promise with migration status information
+   */
+  status(): Promise<{
+    completed: string[];
+    pending: string[];
+  }>;
+}
+//#endregion
+//# sourceMappingURL=PostgresObjectionMigrator.d.cts.map

package/dist/PostgresObjectionMigrator.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PostgresObjectionMigrator.d.cts","names":[],"sources":["../src/PostgresObjectionMigrator.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qBAuCa,kCAAkC;UASrC;;;;;;;;EADT,YACS;IACP;IACA,MAAM;;;;;;;;;EAaF,WAAW;;;;;;;EA8BX,YAAY;;;;;;;EA4BZ,UAAU;IACf;IACA"}

package/dist/PostgresObjectionMigrator.d.mts

@@ -1,3 +1,75 @@
-import "./PostgresMigrator-C_QQ6q35.mjs";
-import { PostgresObjectionMigrator } from "./PostgresObjectionMigrator-1j6YIB1c.mjs";
-export { PostgresObjectionMigrator };
+import { t as PostgresMigrator } from "./PostgresMigrator-CDPnnwMJ.mjs";
+import { Knex } from "knex";
+//#region src/PostgresObjectionMigrator.d.ts
+/**
+ * PostgreSQL migrator implementation for Objection.js ORM with Knex.
+ * Extends PostgresMigrator to provide Knex-specific migration functionality.
+ * Automatically creates test databases and applies migrations for testing environments.
+ *
+ * @example
+ * ```typescript
+ * import knex from 'knex';
+ * import { PostgresObjectionMigrator } from '@geekmidas/testkit';
+ *
+ * // Create Knex instance
+ * const db = knex({
+ *   client: 'pg',
+ *   connection: uri,
+ *   migrations: {
+ *     directory: path.join(__dirname, 'migrations'),
+ *     extension: 'ts'
+ *   }
+ * });
+ *
+ * // Create and use migrator
+ * const migrator = new PostgresObjectionMigrator({
+ *   uri: 'postgresql://localhost:5432/test_db',
+ *   knex: db
+ * });
+ *
+ * const cleanup = await migrator.start();
+ * // Run tests...
+ * await cleanup();
+ * ```
+ */
+export declare class PostgresObjectionMigrator extends PostgresMigrator {
+  private options;
+  /**
+   * Creates a new PostgresObjectionMigrator instance.
+   *
+   * @param options - Configuration options
+   * @param options.uri - PostgreSQL connection URI
+   * @param options.knex - Knex database instance configured with migrations
+   */
+  constructor(options: {
+    uri: string;
+    knex: Knex;
+  });
+  /**
+   * Executes Knex migrations to the latest version.
+   * Implements the abstract migrate() method from PostgresMigrator.
+   *
+   * @throws Error if migrations fail to apply
+   * @returns Promise that resolves when all migrations are applied
+   */
+  migrate(): Promise<void>;
+  /**
+   * Rolls back the last batch of migrations.
+   * Useful for testing migration rollback scenarios.
+   *
+   * @returns Promise that resolves when rollback is complete
+   */
+  rollback(): Promise<void>;
+  /**
+   * Gets the current migration status.
+   * Returns information about completed and pending migrations.
+   *
+   * @returns Promise with migration status information
+   */
+  status(): Promise<{
+    completed: string[];
+    pending: string[];
+  }>;
+}
+//#endregion
+//# sourceMappingURL=PostgresObjectionMigrator.d.mts.map

package/dist/PostgresObjectionMigrator.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PostgresObjectionMigrator.d.mts","names":[],"sources":["../src/PostgresObjectionMigrator.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qBAuCa,kCAAkC;UASrC;;;;;;;;EADT,YACS;IACP;IACA,MAAM;;;;;;;;;EAaF,WAAW;;;;;;;EA8BX,YAAY;;;;;;;EA4BZ,UAAU;IACf;IACA"}

package/dist/PostgresObjectionMigrator.mjs

@@ -1,4 +1,118 @@
-import "./PostgresMigrator-DVAY04qN.mjs";
-import { PostgresObjectionMigrator } from "./PostgresObjectionMigrator-DjPKdUbm.mjs";
+import { PostgresMigrator } from "./PostgresMigrator.mjs";
+//#region src/PostgresObjectionMigrator.ts
+/**
+* Default logger instance for migration operations.
+*/
+const logger = console;
+/**
+* PostgreSQL migrator implementation for Objection.js ORM with Knex.
+* Extends PostgresMigrator to provide Knex-specific migration functionality.
+* Automatically creates test databases and applies migrations for testing environments.
+*
+* @example
+* ```typescript
+* import knex from 'knex';
+* import { PostgresObjectionMigrator } from '@geekmidas/testkit';
+*
+* // Create Knex instance
+* const db = knex({
+*   client: 'pg',
+*   connection: uri,
+*   migrations: {
+*     directory: path.join(__dirname, 'migrations'),
+*     extension: 'ts'
+*   }
+* });
+*
+* // Create and use migrator
+* const migrator = new PostgresObjectionMigrator({
+*   uri: 'postgresql://localhost:5432/test_db',
+*   knex: db
+* });
+*
+* const cleanup = await migrator.start();
+* // Run tests...
+* await cleanup();
+* ```
+*/
+var PostgresObjectionMigrator = class extends PostgresMigrator {
+	options;
+	/**
+	* Creates a new PostgresObjectionMigrator instance.
+	*
+	* @param options - Configuration options
+	* @param options.uri - PostgreSQL connection URI
+	* @param options.knex - Knex database instance configured with migrations
+	*/
+	constructor(options) {
+		super(options.uri);
+		this.options = options;
+	}
+	/**
+	* Executes Knex 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() {
+		try {
+			const [batchNo, migrations] = await this.options.knex.migrate.latest();
+			if (migrations.length > 0) {
+				logger.log(`Applied batch ${batchNo} with ${migrations.length} migrations:`);
+				migrations.forEach((migration) => {
+					logger.log(`  - ${migration}`);
+				});
+			} else logger.log("No pending migrations to apply");
+		} catch (error) {
+			logger.error("Failed to apply migrations:", error);
+			throw error;
+		} finally {
+			await this.options.knex.destroy();
+		}
+	}
+	/**
+	* Rolls back the last batch of migrations.
+	* Useful for testing migration rollback scenarios.
+	*
+	* @returns Promise that resolves when rollback is complete
+	*/
+	async rollback() {
+		try {
+			const [batchNo, migrations] = await this.options.knex.migrate.rollback();
+			if (migrations.length > 0) {
+				logger.log(`Rolled back batch ${batchNo} with ${migrations.length} migrations:`);
+				migrations.forEach((migration) => {
+					logger.log(`  - ${migration}`);
+				});
+			} else logger.log("No migrations to rollback");
+		} catch (error) {
+			logger.error("Failed to rollback migrations:", error);
+			throw error;
+		} finally {
+			await this.options.knex.destroy();
+		}
+	}
+	/**
+	* Gets the current migration status.
+	* Returns information about completed and pending migrations.
+	*
+	* @returns Promise with migration status information
+	*/
+	async status() {
+		try {
+			const completed = await this.options.knex.migrate.list();
+			const [, pending] = await this.options.knex.migrate.currentVersion();
+			return {
+				completed: Array.isArray(completed[0]) ? completed[0] : [],
+				pending: Array.isArray(pending) ? pending : []
+			};
+		} finally {
+			await this.options.knex.destroy();
+		}
+	}
+};
+//#endregion
+export { PostgresObjectionMigrator };
 
-export { PostgresObjectionMigrator };
+//# sourceMappingURL=PostgresObjectionMigrator.mjs.map

package/dist/PostgresObjectionMigrator.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"PostgresObjectionMigrator.mjs","names":[],"sources":["../src/PostgresObjectionMigrator.ts"],"sourcesContent":["import type { Knex } from 'knex';\nimport { PostgresMigrator } from './PostgresMigrator';\n\n/**\n * Default logger instance for migration operations.\n */\nconst logger = console;\n\n/**\n * PostgreSQL migrator implementation for Objection.js ORM with Knex.\n * Extends PostgresMigrator to provide Knex-specific migration functionality.\n * Automatically creates test databases and applies migrations for testing environments.\n *\n * @example\n * ```typescript\n * import knex from 'knex';\n * import { PostgresObjectionMigrator } from '@geekmidas/testkit';\n *\n * // Create Knex instance\n * const db = knex({\n *   client: 'pg',\n *   connection: uri,\n *   migrations: {\n *     directory: path.join(__dirname, 'migrations'),\n *     extension: 'ts'\n *   }\n * });\n *\n * // Create and use migrator\n * const migrator = new PostgresObjectionMigrator({\n *   uri: 'postgresql://localhost:5432/test_db',\n *   knex: db\n * });\n *\n * const cleanup = await migrator.start();\n * // Run tests...\n * await cleanup();\n * ```\n */\nexport class PostgresObjectionMigrator extends PostgresMigrator {\n\t/**\n\t * Creates a new PostgresObjectionMigrator instance.\n\t *\n\t * @param options - Configuration options\n\t * @param options.uri - PostgreSQL connection URI\n\t * @param options.knex - Knex database instance configured with migrations\n\t */\n\tconstructor(\n\t\tprivate options: {\n\t\t\turi: string;\n\t\t\tknex: Knex;\n\t\t},\n\t) {\n\t\tsuper(options.uri);\n\t}\n\n\t/**\n\t * Executes Knex migrations to the latest version.\n\t * Implements the abstract migrate() method from PostgresMigrator.\n\t *\n\t * @throws Error if migrations fail to apply\n\t * @returns Promise that resolves when all migrations are applied\n\t */\n\tasync migrate(): Promise<void> {\n\t\ttry {\n\t\t\t// Run migrations to latest\n\t\t\tconst [batchNo, migrations] = await this.options.knex.migrate.latest();\n\n\t\t\tif (migrations.length > 0) {\n\t\t\t\tlogger.log(\n\t\t\t\t\t`Applied batch ${batchNo} with ${migrations.length} migrations:`,\n\t\t\t\t);\n\t\t\t\tmigrations.forEach((migration: string) => {\n\t\t\t\t\tlogger.log(`  - ${migration}`);\n\t\t\t\t});\n\t\t\t} else {\n\t\t\t\tlogger.log('No pending migrations to apply');\n\t\t\t}\n\t\t} catch (error) {\n\t\t\tlogger.error('Failed to apply migrations:', error);\n\t\t\tthrow error;\n\t\t} finally {\n\t\t\t// Always destroy the connection pool\n\t\t\tawait this.options.knex.destroy();\n\t\t}\n\t}\n\n\t/**\n\t * Rolls back the last batch of migrations.\n\t * Useful for testing migration rollback scenarios.\n\t *\n\t * @returns Promise that resolves when rollback is complete\n\t */\n\tasync rollback(): Promise<void> {\n\t\ttry {\n\t\t\tconst [batchNo, migrations] = await this.options.knex.migrate.rollback();\n\n\t\t\tif (migrations.length > 0) {\n\t\t\t\tlogger.log(\n\t\t\t\t\t`Rolled back batch ${batchNo} with ${migrations.length} migrations:`,\n\t\t\t\t);\n\t\t\t\tmigrations.forEach((migration: string) => {\n\t\t\t\t\tlogger.log(`  - ${migration}`);\n\t\t\t\t});\n\t\t\t} else {\n\t\t\t\tlogger.log('No migrations to rollback');\n\t\t\t}\n\t\t} catch (error) {\n\t\t\tlogger.error('Failed to rollback migrations:', error);\n\t\t\tthrow error;\n\t\t} finally {\n\t\t\tawait this.options.knex.destroy();\n\t\t}\n\t}\n\n\t/**\n\t * Gets the current migration status.\n\t * Returns information about completed and pending migrations.\n\t *\n\t * @returns Promise with migration status information\n\t */\n\tasync status(): Promise<{\n\t\tcompleted: string[];\n\t\tpending: string[];\n\t}> {\n\t\ttry {\n\t\t\tconst completed = await this.options.knex.migrate.list();\n\t\t\tconst [, pending] = await this.options.knex.migrate.currentVersion();\n\n\t\t\treturn {\n\t\t\t\tcompleted: Array.isArray(completed[0]) ? completed[0] : [],\n\t\t\t\tpending: Array.isArray(pending) ? pending : [],\n\t\t\t};\n\t\t} finally {\n\t\t\tawait this.options.knex.destroy();\n\t\t}\n\t}\n}\n"],"mappings":";;;;;AAMA,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAiCf,IAAa,4BAAb,cAA+C,iBAAiB;CAStD;;;;;;;;CADT,YACC,SAIC;EACD,MAAM,QAAQ,GAAG;EALT,KAAA,UAAA;CAMT;;;;;;;;CASA,MAAM,UAAyB;EAC9B,IAAI;GAEH,MAAM,CAAC,SAAS,cAAc,MAAM,KAAK,QAAQ,KAAK,QAAQ,OAAO;GAErE,IAAI,WAAW,SAAS,GAAG;IAC1B,OAAO,IACN,iBAAiB,QAAQ,QAAQ,WAAW,OAAO,aACpD;IACA,WAAW,SAAS,cAAsB;KACzC,OAAO,IAAI,OAAO,WAAW;IAC9B,CAAC;GACF,OACC,OAAO,IAAI,gCAAgC;EAE7C,SAAS,OAAO;GACf,OAAO,MAAM,+BAA+B,KAAK;GACjD,MAAM;EACP,UAAU;GAET,MAAM,KAAK,QAAQ,KAAK,QAAQ;EACjC;CACD;;;;;;;CAQA,MAAM,WAA0B;EAC/B,IAAI;GACH,MAAM,CAAC,SAAS,cAAc,MAAM,KAAK,QAAQ,KAAK,QAAQ,SAAS;GAEvE,IAAI,WAAW,SAAS,GAAG;IAC1B,OAAO,IACN,qBAAqB,QAAQ,QAAQ,WAAW,OAAO,aACxD;IACA,WAAW,SAAS,cAAsB;KACzC,OAAO,IAAI,OAAO,WAAW;IAC9B,CAAC;GACF,OACC,OAAO,IAAI,2BAA2B;EAExC,SAAS,OAAO;GACf,OAAO,MAAM,kCAAkC,KAAK;GACpD,MAAM;EACP,UAAU;GACT,MAAM,KAAK,QAAQ,KAAK,QAAQ;EACjC;CACD;;;;;;;CAQA,MAAM,SAGH;EACF,IAAI;GACH,MAAM,YAAY,MAAM,KAAK,QAAQ,KAAK,QAAQ,KAAK;GACvD,MAAM,GAAG,WAAW,MAAM,KAAK,QAAQ,KAAK,QAAQ,eAAe;GAEnE,OAAO;IACN,WAAW,MAAM,QAAQ,UAAU,EAAE,IAAI,UAAU,KAAK,CAAC;IACzD,SAAS,MAAM,QAAQ,OAAO,IAAI,UAAU,CAAC;GAC9C;EACD,UAAU;GACT,MAAM,KAAK,QAAQ,KAAK,QAAQ;EACjC;CACD;AACD"}