@geekmidas/testkit 1.0.2 → 1.0.4

package/src/__tests__/initScript.spec.ts

@@ -0,0 +1,308 @@
+import { writeFileSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import pg from 'pg';
+import { afterAll, beforeAll, describe, expect, it } from 'vitest';
+import { parseInitScript, runInitScript } from '../initScript';
+
+describe('parseInitScript', () => {
+	it('should extract SQL from EOSQL heredoc blocks', () => {
+		const script = `#!/bin/bash
+set -e
+
+psql -v ON_ERROR_STOP=1 --username "$POSTGRES_USER" --dbname "$POSTGRES_DB" <<-EOSQL
+    CREATE USER api WITH PASSWORD '$API_DB_PASSWORD';
+    GRANT ALL ON SCHEMA public TO api;
+EOSQL
+`;
+
+		const blocks = parseInitScript(script, {
+			POSTGRES_USER: 'app',
+			POSTGRES_DB: 'mydb',
+			API_DB_PASSWORD: 'secret123',
+		});
+
+		expect(blocks).toHaveLength(1);
+		expect(blocks[0]).toContain("CREATE USER api WITH PASSWORD 'secret123'");
+		expect(blocks[0]).toContain('GRANT ALL ON SCHEMA public TO api');
+	});
+
+	it('should extract multiple heredoc blocks', () => {
+		const script = `#!/bin/bash
+set -e
+
+psql --username "$POSTGRES_USER" --dbname "$POSTGRES_DB" <<-EOSQL
+    CREATE USER api WITH PASSWORD '$API_DB_PASSWORD';
+EOSQL
+
+psql --username "$POSTGRES_USER" --dbname "$POSTGRES_DB" <<-EOSQL
+    CREATE USER auth WITH PASSWORD '$AUTH_DB_PASSWORD';
+    CREATE SCHEMA auth AUTHORIZATION auth;
+EOSQL
+
+echo "Done!"
+`;
+
+		const blocks = parseInitScript(script, {
+			POSTGRES_USER: 'app',
+			POSTGRES_DB: 'mydb',
+			API_DB_PASSWORD: 'apipass',
+			AUTH_DB_PASSWORD: 'authpass',
+		});
+
+		expect(blocks).toHaveLength(2);
+		expect(blocks[0]).toContain("CREATE USER api WITH PASSWORD 'apipass'");
+		expect(blocks[1]).toContain("CREATE USER auth WITH PASSWORD 'authpass'");
+		expect(blocks[1]).toContain('CREATE SCHEMA auth AUTHORIZATION auth');
+	});
+
+	it('should substitute $VAR_NAME syntax', () => {
+		const script = `psql <<-EOSQL
+    CREATE USER $APP_USER WITH PASSWORD '$APP_PASSWORD';
+EOSQL`;
+
+		const blocks = parseInitScript(script, {
+			APP_USER: 'myuser',
+			APP_PASSWORD: 'mypass',
+		});
+
+		expect(blocks[0]).toContain("CREATE USER myuser WITH PASSWORD 'mypass'");
+	});
+
+	it('should substitute ${VAR_NAME} syntax', () => {
+		const script = `psql <<-EOSQL
+    CREATE USER \${APP_USER} WITH PASSWORD '\${APP_PASSWORD}';
+EOSQL`;
+
+		const blocks = parseInitScript(script, {
+			APP_USER: 'myuser',
+			APP_PASSWORD: 'mypass',
+		});
+
+		expect(blocks[0]).toContain("CREATE USER myuser WITH PASSWORD 'mypass'");
+	});
+
+	it('should replace missing vars with empty string', () => {
+		const script = `psql <<-EOSQL
+    CREATE USER api WITH PASSWORD '$MISSING_VAR';
+EOSQL`;
+
+		const blocks = parseInitScript(script, {});
+
+		expect(blocks[0]).toContain("CREATE USER api WITH PASSWORD ''");
+	});
+
+	it('should return empty array for script with no heredocs', () => {
+		const script = `#!/bin/bash
+echo "Hello world"
+`;
+
+		const blocks = parseInitScript(script, {});
+
+		expect(blocks).toEqual([]);
+	});
+
+	it('should handle the full generated init.sh format', () => {
+		const script = `#!/bin/bash
+set -e
+
+# Auto-generated PostgreSQL init script
+# Creates per-app users with separate schemas in a single database
+# - api: uses public schema
+# - auth: uses auth schema (search_path=auth)
+
+# Create api user (uses public schema)
+echo "Creating user api..."
+psql -v ON_ERROR_STOP=1 --username "$POSTGRES_USER" --dbname "$POSTGRES_DB" <<-EOSQL
+    CREATE USER api WITH PASSWORD '$API_DB_PASSWORD';
+    GRANT ALL ON SCHEMA public TO api;
+    ALTER DEFAULT PRIVILEGES IN SCHEMA public GRANT ALL ON TABLES TO api;
+    ALTER DEFAULT PRIVILEGES IN SCHEMA public GRANT ALL ON SEQUENCES TO api;
+EOSQL
+
+
+# Create auth user with dedicated schema
+echo "Creating user auth with schema auth..."
+psql -v ON_ERROR_STOP=1 --username "$POSTGRES_USER" --dbname "$POSTGRES_DB" <<-EOSQL
+    CREATE USER auth WITH PASSWORD '$AUTH_DB_PASSWORD';
+    CREATE SCHEMA auth AUTHORIZATION auth;
+    ALTER USER auth SET search_path TO auth;
+    GRANT USAGE ON SCHEMA auth TO auth;
+    GRANT ALL ON ALL TABLES IN SCHEMA auth TO auth;
+    GRANT ALL ON ALL SEQUENCES IN SCHEMA auth TO auth;
+    ALTER DEFAULT PRIVILEGES IN SCHEMA auth GRANT ALL ON TABLES TO auth;
+    ALTER DEFAULT PRIVILEGES IN SCHEMA auth GRANT ALL ON SEQUENCES TO auth;
+EOSQL
+
+echo "Database initialization complete!"
+`;
+
+		const blocks = parseInitScript(script, {
+			POSTGRES_USER: 'app',
+			POSTGRES_DB: 'residentman_dev_test',
+			API_DB_PASSWORD: 'apipass123',
+			AUTH_DB_PASSWORD: 'authpass456',
+		});
+
+		expect(blocks).toHaveLength(2);
+
+		// API block
+		expect(blocks[0]).toContain("CREATE USER api WITH PASSWORD 'apipass123'");
+		expect(blocks[0]).toContain('GRANT ALL ON SCHEMA public TO api');
+		expect(blocks[0]).toContain('ALTER DEFAULT PRIVILEGES IN SCHEMA public');
+
+		// Auth block
+		expect(blocks[1]).toContain("CREATE USER auth WITH PASSWORD 'authpass456'");
+		expect(blocks[1]).toContain('CREATE SCHEMA auth AUTHORIZATION auth');
+		expect(blocks[1]).toContain('ALTER USER auth SET search_path TO auth');
+	});
+});
+
+const PG_CONFIG = {
+	host: 'localhost',
+	port: 5432,
+	user: 'geekmidas',
+	password: 'geekmidas',
+};
+
+/**
+ * Helper to run queries against the postgres admin database.
+ */
+async function adminQuery(...queries: string[]): Promise<void> {
+	const client = new pg.Client({ ...PG_CONFIG, database: 'postgres' });
+	try {
+		await client.connect();
+		for (const sql of queries) {
+			await client.query(sql);
+		}
+	} finally {
+		await client.end();
+	}
+}
+
+/**
+ * Force-drop a role by reassigning owned objects and revoking privileges first.
+ */
+async function forceDropRole(role: string): Promise<void> {
+	// Find all databases where this role might own objects
+	const client = new pg.Client({ ...PG_CONFIG, database: 'postgres' });
+	try {
+		await client.connect();
+		const result = await client.query(
+			"SELECT datname FROM pg_database WHERE datistemplate = false AND datname != 'postgres'",
+		);
+		for (const row of result.rows) {
+			const dbClient = new pg.Client({
+				...PG_CONFIG,
+				database: row.datname,
+			});
+			try {
+				await dbClient.connect();
+				await dbClient.query(`REASSIGN OWNED BY ${role} TO ${PG_CONFIG.user}`);
+				await dbClient.query(`DROP OWNED BY ${role}`);
+			} catch {
+				// Role might not exist in this database, ignore
+			} finally {
+				await dbClient.end();
+			}
+		}
+		await client.query(`DROP ROLE IF EXISTS ${role}`);
+	} finally {
+		await client.end();
+	}
+}
+
+describe('runInitScript', () => {
+	const dbName = `test_init_script_${Date.now()}`;
+	const dbUrl = `postgresql://${PG_CONFIG.user}:${PG_CONFIG.password}@${PG_CONFIG.host}:${PG_CONFIG.port}/${dbName}`;
+
+	beforeAll(async () => {
+		// Clean up stale state from previous failed runs
+		await forceDropRole('test_api');
+		await forceDropRole('test_auth');
+		await adminQuery(
+			`DROP DATABASE IF EXISTS "${dbName}"`,
+			`CREATE DATABASE "${dbName}"`,
+		);
+	});
+
+	afterAll(async () => {
+		// Drop the database first (removes object dependencies), then roles
+		await adminQuery(`DROP DATABASE IF EXISTS "${dbName}"`);
+		await forceDropRole('test_api');
+		await forceDropRole('test_auth');
+	});
+
+	it('should create users and schemas from init script', async () => {
+		// Write a test init script to a temp file
+		const scriptPath = join(tmpdir(), `init-${Date.now()}.sh`);
+		writeFileSync(
+			scriptPath,
+			`#!/bin/bash
+set -e
+
+psql -v ON_ERROR_STOP=1 --username "$POSTGRES_USER" --dbname "$POSTGRES_DB" <<-EOSQL
+    CREATE USER test_api WITH PASSWORD '$API_DB_PASSWORD';
+    GRANT ALL ON SCHEMA public TO test_api;
+    ALTER DEFAULT PRIVILEGES IN SCHEMA public GRANT ALL ON TABLES TO test_api;
+    ALTER DEFAULT PRIVILEGES IN SCHEMA public GRANT ALL ON SEQUENCES TO test_api;
+EOSQL
+
+psql -v ON_ERROR_STOP=1 --username "$POSTGRES_USER" --dbname "$POSTGRES_DB" <<-EOSQL
+    CREATE USER test_auth WITH PASSWORD '$AUTH_DB_PASSWORD';
+    CREATE SCHEMA IF NOT EXISTS test_auth AUTHORIZATION test_auth;
+    ALTER USER test_auth SET search_path TO test_auth;
+    GRANT USAGE ON SCHEMA test_auth TO test_auth;
+    GRANT ALL ON ALL TABLES IN SCHEMA test_auth TO test_auth;
+    GRANT ALL ON ALL SEQUENCES IN SCHEMA test_auth TO test_auth;
+    ALTER DEFAULT PRIVILEGES IN SCHEMA test_auth GRANT ALL ON TABLES TO test_auth;
+    ALTER DEFAULT PRIVILEGES IN SCHEMA test_auth GRANT ALL ON SEQUENCES TO test_auth;
+EOSQL
+
+echo "Done!"
+`,
+		);
+
+		// Run the init script against the test database
+		await runInitScript(scriptPath, dbUrl, {
+			POSTGRES_USER: PG_CONFIG.user,
+			POSTGRES_DB: dbName,
+			API_DB_PASSWORD: 'apipass',
+			AUTH_DB_PASSWORD: 'authpass',
+		});
+
+		// Verify: connect as test_api and check access to public schema
+		const apiClient = new pg.Client({
+			...PG_CONFIG,
+			user: 'test_api',
+			password: 'apipass',
+			database: dbName,
+		});
+		await apiClient.connect();
+		await apiClient.query(
+			'CREATE TABLE IF NOT EXISTS api_test_table (id serial PRIMARY KEY)',
+		);
+		const apiResult = await apiClient.query(
+			"SELECT table_name FROM information_schema.tables WHERE table_schema = 'public' AND table_name = 'api_test_table'",
+		);
+		expect(apiResult.rowCount).toBe(1);
+		await apiClient.end();
+
+		// Verify: connect as test_auth and check dedicated schema
+		const authClient = new pg.Client({
+			...PG_CONFIG,
+			user: 'test_auth',
+			password: 'authpass',
+			database: dbName,
+		});
+		await authClient.connect();
+		const schemaResult = await authClient.query(
+			"SELECT schema_name FROM information_schema.schemata WHERE schema_name = 'test_auth'",
+		);
+		expect(schemaResult.rowCount).toBe(1);
+		await authClient.query(
+			'CREATE TABLE IF NOT EXISTS test_auth.auth_test_table (id serial PRIMARY KEY)',
+		);
+		await authClient.end();
+	});
+});

package/src/initScript.ts

@@ -0,0 +1,119 @@
+import { readFileSync } from 'node:fs';
+import pg from 'pg';
+
+const { Client } = pg;
+
+/**
+ * Parse a shell init script (like docker/postgres/init.sh) and extract
+ * SQL blocks from heredoc sections (<<-EOSQL ... EOSQL).
+ *
+ * @param content - The shell script content
+ * @param env - Environment variables to substitute ($VAR_NAME references)
+ * @returns Array of SQL strings ready to execute
+ * @internal Exported for testing
+ */
+export function parseInitScript(
+	content: string,
+	env: Record<string, string>,
+): string[] {
+	const blocks: string[] = [];
+	const lines = content.split('\n');
+	let inHeredoc = false;
+	let currentBlock: string[] = [];
+
+	for (const line of lines) {
+		if (inHeredoc) {
+			// Check for heredoc terminator (EOSQL at start of line, with optional leading whitespace)
+			if (/^\s*EOSQL\s*$/.test(line)) {
+				const sql = substituteEnvVars(currentBlock.join('\n'), env);
+				blocks.push(sql);
+				currentBlock = [];
+				inHeredoc = false;
+			} else {
+				currentBlock.push(line);
+			}
+		} else if (
+			line.includes('<<-EOSQL') ||
+			line.includes('<< EOSQL') ||
+			line.includes('<<EOSQL')
+		) {
+			inHeredoc = true;
+			currentBlock = [];
+		}
+	}
+
+	return blocks;
+}
+
+/**
+ * Replace shell variable references ($VAR_NAME and ${VAR_NAME})
+ * with values from the provided env object.
+ */
+function substituteEnvVars(sql: string, env: Record<string, string>): string {
+	// Replace ${VAR_NAME} syntax
+	let result = sql.replace(/\$\{(\w+)\}/g, (_, name) => env[name] ?? '');
+	// Replace $VAR_NAME syntax (word boundary after)
+	result = result.replace(/\$(\w+)/g, (_, name) => env[name] ?? '');
+	return result;
+}
+
+/**
+ * Read a postgres init script, parse out the SQL blocks,
+ * substitute environment variables, and execute against a database.
+ *
+ * This is intended to run `docker/postgres/init.sh` against a test database
+ * so that per-app users and schemas are created (matching what Docker does
+ * on first volume initialization).
+ *
+ * Uses `CREATE ... IF NOT EXISTS` and `DO $$ ... END $$` wrappers where
+ * needed so the script is idempotent.
+ *
+ * @param scriptPath - Path to the init.sh file
+ * @param databaseUrl - PostgreSQL connection URL (should point to the test database)
+ *
+ * @example
+ * ```typescript
+ * // In your globalSetup.ts
+ * import { runInitScript } from '@geekmidas/testkit/postgres';
+ * import { Credentials } from '@geekmidas/envkit/credentials';
+ *
+ * const cleanup = await migrator.start();
+ *
+ * // Create per-app users in the test database
+ * await runInitScript('docker/postgres/init.sh', Credentials.DATABASE_URL, {
+ *   ...process.env,
+ *   ...Credentials,
+ * });
+ * ```
+ */
+export async function runInitScript(
+	scriptPath: string,
+	databaseUrl: string,
+	env?: Record<string, string>,
+): Promise<void> {
+	const content = readFileSync(scriptPath, 'utf-8');
+	const resolvedEnv = env ?? ({ ...process.env } as Record<string, string>);
+	const blocks = parseInitScript(content, resolvedEnv);
+
+	if (blocks.length === 0) {
+		return;
+	}
+
+	const url = new URL(databaseUrl);
+	const client = new Client({
+		user: url.username,
+		password: decodeURIComponent(url.password),
+		host: url.hostname,
+		port: parseInt(url.port, 10),
+		database: url.pathname.slice(1),
+	});
+
+	try {
+		await client.connect();
+		for (const sql of blocks) {
+			await client.query(sql);
+		}
+	} finally {
+		await client.end();
+	}
+}

package/dist/PostgresKyselyMigrator-B4pScubb.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"PostgresKyselyMigrator-B4pScubb.mjs","names":["options: {\n\t\t\turi: string;\n\t\t\tdb: Kysely<any>;\n\t\t\tprovider: MigrationProvider;\n\t\t}"],"sources":["../src/PostgresKyselyMigrator.ts"],"sourcesContent":["import { type Kysely, type MigrationProvider, Migrator } from 'kysely';\nimport { PostgresMigrator } from './PostgresMigrator';\n\n/**\n * Default logger instance for migration operations.\n */\nconst logger = console;\n\n/**\n * PostgreSQL migrator implementation for Kysely ORM.\n * Extends PostgresMigrator to provide Kysely-specific migration functionality.\n * Automatically creates test databases and applies migrations for testing environments.\n *\n * @example\n * ```typescript\n * import { FileMigrationProvider } from 'kysely';\n * import { PostgresKyselyMigrator } from '@geekmidas/testkit';\n *\n * // Create migration provider\n * const provider = new FileMigrationProvider({\n *   fs: require('fs'),\n *   path: require('path'),\n *   migrationFolder: path.join(__dirname, 'migrations')\n * });\n *\n * // Create Kysely instance\n * const db = new Kysely<Database>({\n *   dialect: new PostgresDialect({\n *     pool: new Pool({ connectionString: uri })\n *   })\n * });\n *\n * // Create and use migrator\n * const migrator = new PostgresKyselyMigrator({\n *   uri: 'postgresql://localhost:5432/test_db',\n *   db,\n *   provider\n * });\n *\n * const cleanup = await migrator.start();\n * // Run tests...\n * await cleanup();\n * ```\n */\nexport class PostgresKyselyMigrator extends PostgresMigrator {\n\t/**\n\t * Creates a new PostgresKyselyMigrator instance.\n\t *\n\t * @param options - Configuration options\n\t * @param options.uri - PostgreSQL connection URI\n\t * @param options.db - Kysely database instance\n\t * @param options.provider - Migration provider for locating migration files\n\t */\n\tconstructor(\n\t\tprivate options: {\n\t\t\turi: string;\n\t\t\tdb: Kysely<any>;\n\t\t\tprovider: MigrationProvider;\n\t\t},\n\t) {\n\t\tsuper(options.uri);\n\t}\n\n\t/**\n\t * Executes Kysely 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\tconst migrator = new Migrator({\n\t\t\tdb: this.options.db,\n\t\t\tprovider: this.options.provider,\n\t\t});\n\t\tconst migrations = await migrator.migrateToLatest();\n\n\t\tif (migrations.error) {\n\t\t\tlogger.error(migrations.error, `Failed to apply migrations`);\n\t\t\tthrow migrations.error;\n\t\t}\n\n\t\tawait this.options.db.destroy();\n\n\t\tlogger.log(`Applied ${migrations.results?.length} migrations successfully`);\n\t}\n}\n"],"mappings":";;;;;;;AAMA,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAsCf,IAAa,yBAAb,cAA4C,iBAAiB;;;;;;;;;CAS5D,YACSA,SAKP;AACD,QAAM,QAAQ,IAAI;EANV;CAOR;;;;;;;;CASD,MAAM,UAAyB;EAC9B,MAAM,WAAW,IAAI,SAAS;GAC7B,IAAI,KAAK,QAAQ;GACjB,UAAU,KAAK,QAAQ;EACvB;EACD,MAAM,aAAa,MAAM,SAAS,iBAAiB;AAEnD,MAAI,WAAW,OAAO;AACrB,UAAO,MAAM,WAAW,QAAQ,4BAA4B;AAC5D,SAAM,WAAW;EACjB;AAED,QAAM,KAAK,QAAQ,GAAG,SAAS;AAE/B,SAAO,KAAK,UAAU,WAAW,SAAS,OAAO,0BAA0B;CAC3E;AACD"}

package/dist/PostgresKyselyMigrator-C7ljZYvq.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"PostgresKyselyMigrator-C7ljZYvq.cjs","names":["PostgresMigrator","options: {\n\t\t\turi: string;\n\t\t\tdb: Kysely<any>;\n\t\t\tprovider: MigrationProvider;\n\t\t}","Migrator"],"sources":["../src/PostgresKyselyMigrator.ts"],"sourcesContent":["import { type Kysely, type MigrationProvider, Migrator } from 'kysely';\nimport { PostgresMigrator } from './PostgresMigrator';\n\n/**\n * Default logger instance for migration operations.\n */\nconst logger = console;\n\n/**\n * PostgreSQL migrator implementation for Kysely ORM.\n * Extends PostgresMigrator to provide Kysely-specific migration functionality.\n * Automatically creates test databases and applies migrations for testing environments.\n *\n * @example\n * ```typescript\n * import { FileMigrationProvider } from 'kysely';\n * import { PostgresKyselyMigrator } from '@geekmidas/testkit';\n *\n * // Create migration provider\n * const provider = new FileMigrationProvider({\n *   fs: require('fs'),\n *   path: require('path'),\n *   migrationFolder: path.join(__dirname, 'migrations')\n * });\n *\n * // Create Kysely instance\n * const db = new Kysely<Database>({\n *   dialect: new PostgresDialect({\n *     pool: new Pool({ connectionString: uri })\n *   })\n * });\n *\n * // Create and use migrator\n * const migrator = new PostgresKyselyMigrator({\n *   uri: 'postgresql://localhost:5432/test_db',\n *   db,\n *   provider\n * });\n *\n * const cleanup = await migrator.start();\n * // Run tests...\n * await cleanup();\n * ```\n */\nexport class PostgresKyselyMigrator extends PostgresMigrator {\n\t/**\n\t * Creates a new PostgresKyselyMigrator instance.\n\t *\n\t * @param options - Configuration options\n\t * @param options.uri - PostgreSQL connection URI\n\t * @param options.db - Kysely database instance\n\t * @param options.provider - Migration provider for locating migration files\n\t */\n\tconstructor(\n\t\tprivate options: {\n\t\t\turi: string;\n\t\t\tdb: Kysely<any>;\n\t\t\tprovider: MigrationProvider;\n\t\t},\n\t) {\n\t\tsuper(options.uri);\n\t}\n\n\t/**\n\t * Executes Kysely 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\tconst migrator = new Migrator({\n\t\t\tdb: this.options.db,\n\t\t\tprovider: this.options.provider,\n\t\t});\n\t\tconst migrations = await migrator.migrateToLatest();\n\n\t\tif (migrations.error) {\n\t\t\tlogger.error(migrations.error, `Failed to apply migrations`);\n\t\t\tthrow migrations.error;\n\t\t}\n\n\t\tawait this.options.db.destroy();\n\n\t\tlogger.log(`Applied ${migrations.results?.length} migrations successfully`);\n\t}\n}\n"],"mappings":";;;;;;;;AAMA,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAsCf,IAAa,yBAAb,cAA4CA,0CAAiB;;;;;;;;;CAS5D,YACSC,SAKP;AACD,QAAM,QAAQ,IAAI;EANV;CAOR;;;;;;;;CASD,MAAM,UAAyB;EAC9B,MAAM,WAAW,IAAIC,gBAAS;GAC7B,IAAI,KAAK,QAAQ;GACjB,UAAU,KAAK,QAAQ;EACvB;EACD,MAAM,aAAa,MAAM,SAAS,iBAAiB;AAEnD,MAAI,WAAW,OAAO;AACrB,UAAO,MAAM,WAAW,QAAQ,4BAA4B;AAC5D,SAAM,WAAW;EACjB;AAED,QAAM,KAAK,QAAQ,GAAG,SAAS;AAE/B,SAAO,KAAK,UAAU,WAAW,SAAS,OAAO,0BAA0B;CAC3E;AACD"}

package/dist/PostgresKyselyMigrator-CBltSOq5.d.cts.map

@@ -1 +0,0 @@
-{"version":3,"file":"PostgresKyselyMigrator-CBltSOq5.d.cts","names":[],"sources":["../src/PostgresKyselyMigrator.ts"],"sourcesContent":[],"mappings":";;;;;;;AA4CA;;;;;;AAA4D;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAA/C,sBAAA,SAA+B,gBAAA;;;;;;;;;;;;QAYrC;cACM;;;;;;;;;aAaK"}

package/dist/PostgresKyselyMigrator-DrVWncqd.d.mts.map

@@ -1 +0,0 @@
-{"version":3,"file":"PostgresKyselyMigrator-DrVWncqd.d.mts","names":[],"sources":["../src/PostgresKyselyMigrator.ts"],"sourcesContent":[],"mappings":";;;;;;;AA4CA;;;;;;AAA4D;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAA/C,sBAAA,SAA+B,gBAAA;;;;;;;;;;;;QAYrC;cACM;;;;;;;;;aAaK"}

package/dist/PostgresMigrator-Bres0U6E.d.cts.map

@@ -1 +0,0 @@
-{"version":3,"file":"PostgresMigrator-Bres0U6E.d.cts","names":[],"sources":["../src/PostgresMigrator.ts"],"sourcesContent":[],"mappings":";;AAiEA;;;;;AA8FY;;;;;;;;;;;;;;;;;;uBA9FU,gBAAA;;;;;;;;;;;;;;sBAcD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;WAgFT,cAAA"}

package/dist/PostgresMigrator-CHiBYEg_.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"PostgresMigrator-CHiBYEg_.cjs","names":["uri: string","error: any"],"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 * // 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 */\n\tconstructor(private uri: string) {}\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// 42P04 = duplicate_database — another process created it between our check and create\n\t\t\t\t\tif (error?.code === '42P04') {\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 will drop the database when called.\n\t *\n\t * @returns Async cleanup function that drops the created database\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\ttry {\n\t\t\tawait PostgresMigrator.create(this.uri);\n\t\t\t// Implement migration logic here\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\tawait PostgresMigrator.drop(this.uri);\n\t\t};\n\t}\n}\n"],"mappings":";;;;AAEA,MAAM,EAAE,QAAQ,GAAG;;;;;;;;;;;;;;;AAgBnB,eAAe,YAAYA,KAAa;CACvC,MAAM,MAAM,IAAI,IAAI;CAEpB,MAAM,KAAK,IAAI,OAAO;EACrB,MAAM,IAAI;EACV,UAAU,IAAI;EACd,MAAM,IAAI;EACV,MAAM,SAAS,IAAI,MAAM,GAAG;EAC5B,UAAU;CACV;CAED,IAAI,WAAW,IAAI,SAAS,MAAM,EAAE;AACpC,KAAI,SAAS,SAAS,IAAI,CACzB,YAAW,SAAS,UAAU,GAAG,SAAS,QAAQ,IAAI,CAAC;AAExD,QAAO;EAAE;EAAU;CAAI;AACvB;;;;AAKD,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;AA0Bf,IAAsB,mBAAtB,MAAsB,iBAAiB;;;;;;CAMtC,YAAoBA,KAAa;EAAb;CAAe;;;;;;;;;CAkBnC,aAAqB,OACpBA,KACuC;EACvC,MAAM,EAAE,UAAU,IAAI,GAAG,MAAM,YAAY,IAAI;AAC/C,MAAI;AACH,SAAM,GAAG,SAAS;GAClB,MAAM,SAAS,MAAM,GAAG,OACtB,wDAAwD,SAAS,GAClE;AAED,OAAI,OAAO,aAAa,EACvB,KAAI;AACH,UAAM,GAAG,OAAO,mBAAmB,SAAS,GAAG;GAC/C,SAAQC,OAAY;AAEpB,QAAI,OAAO,SAAS,QACnB,QAAO,EAAE,gBAAgB,KAAM;AAEhC,UAAM;GACN;AAGF,UAAO,EACN,gBAAgB,OAAO,WAAW,OAAO,WAAW,IAAI,MACxD;EACD,UAAS;AACT,SAAM,GAAG,KAAK;EACd;CACD;;;;;;;;;CAUD,aAAqB,KAAKD,KAA4B;EACrD,MAAM,EAAE,UAAU,IAAI,GAAG,MAAM,YAAY,IAAI;AAC/C,MAAI;AACH,SAAM,GAAG,SAAS;AAClB,SAAM,GAAG,OAAO,iBAAiB,SAAS,GAAG;EAC7C,UAAS;AACT,SAAM,GAAG,KAAK;EACd;CACD;;;;;;;;;;;;;;;;;;;;;;;CAwBD,MAAM,QAAQ;EACb,MAAM,EAAE,UAAU,IAAI,GAAG,MAAM,YAAY,KAAK,IAAI;AACpD,MAAI;AACH,SAAM,iBAAiB,OAAO,KAAK,IAAI;AAEvC,SAAM,KAAK,SAAS;AACpB,UAAO,KAAK,sBAAsB,SAAS,EAAE;EAE7C,UAAS;AACT,SAAM,GAAG,KAAK;EACd;AAED,SAAO,YAAY;AAClB,SAAM,iBAAiB,KAAK,KAAK,IAAI;EACrC;CACD;AACD"}

package/dist/PostgresMigrator-DcP1o-T6.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"PostgresMigrator-DcP1o-T6.mjs","names":["uri: string","error: any"],"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 * // 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 */\n\tconstructor(private uri: string) {}\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// 42P04 = duplicate_database — another process created it between our check and create\n\t\t\t\t\tif (error?.code === '42P04') {\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 will drop the database when called.\n\t *\n\t * @returns Async cleanup function that drops the created database\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\ttry {\n\t\t\tawait PostgresMigrator.create(this.uri);\n\t\t\t// Implement migration logic here\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\tawait PostgresMigrator.drop(this.uri);\n\t\t};\n\t}\n}\n"],"mappings":";;;AAEA,MAAM,EAAE,QAAQ,GAAG;;;;;;;;;;;;;;;AAgBnB,eAAe,YAAYA,KAAa;CACvC,MAAM,MAAM,IAAI,IAAI;CAEpB,MAAM,KAAK,IAAI,OAAO;EACrB,MAAM,IAAI;EACV,UAAU,IAAI;EACd,MAAM,IAAI;EACV,MAAM,SAAS,IAAI,MAAM,GAAG;EAC5B,UAAU;CACV;CAED,IAAI,WAAW,IAAI,SAAS,MAAM,EAAE;AACpC,KAAI,SAAS,SAAS,IAAI,CACzB,YAAW,SAAS,UAAU,GAAG,SAAS,QAAQ,IAAI,CAAC;AAExD,QAAO;EAAE;EAAU;CAAI;AACvB;;;;AAKD,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;AA0Bf,IAAsB,mBAAtB,MAAsB,iBAAiB;;;;;;CAMtC,YAAoBA,KAAa;EAAb;CAAe;;;;;;;;;CAkBnC,aAAqB,OACpBA,KACuC;EACvC,MAAM,EAAE,UAAU,IAAI,GAAG,MAAM,YAAY,IAAI;AAC/C,MAAI;AACH,SAAM,GAAG,SAAS;GAClB,MAAM,SAAS,MAAM,GAAG,OACtB,wDAAwD,SAAS,GAClE;AAED,OAAI,OAAO,aAAa,EACvB,KAAI;AACH,UAAM,GAAG,OAAO,mBAAmB,SAAS,GAAG;GAC/C,SAAQC,OAAY;AAEpB,QAAI,OAAO,SAAS,QACnB,QAAO,EAAE,gBAAgB,KAAM;AAEhC,UAAM;GACN;AAGF,UAAO,EACN,gBAAgB,OAAO,WAAW,OAAO,WAAW,IAAI,MACxD;EACD,UAAS;AACT,SAAM,GAAG,KAAK;EACd;CACD;;;;;;;;;CAUD,aAAqB,KAAKD,KAA4B;EACrD,MAAM,EAAE,UAAU,IAAI,GAAG,MAAM,YAAY,IAAI;AAC/C,MAAI;AACH,SAAM,GAAG,SAAS;AAClB,SAAM,GAAG,OAAO,iBAAiB,SAAS,GAAG;EAC7C,UAAS;AACT,SAAM,GAAG,KAAK;EACd;CACD;;;;;;;;;;;;;;;;;;;;;;;CAwBD,MAAM,QAAQ;EACb,MAAM,EAAE,UAAU,IAAI,GAAG,MAAM,YAAY,KAAK,IAAI;AACpD,MAAI;AACH,SAAM,iBAAiB,OAAO,KAAK,IAAI;AAEvC,SAAM,KAAK,SAAS;AACpB,UAAO,KAAK,sBAAsB,SAAS,EAAE;EAE7C,UAAS;AACT,SAAM,GAAG,KAAK;EACd;AAED,SAAO,YAAY;AAClB,SAAM,iBAAiB,KAAK,KAAK,IAAI;EACrC;CACD;AACD"}

package/dist/PostgresMigrator-S-YYosAC.d.mts.map

@@ -1 +0,0 @@
-{"version":3,"file":"PostgresMigrator-S-YYosAC.d.mts","names":[],"sources":["../src/PostgresMigrator.ts"],"sourcesContent":[],"mappings":";;AAiEA;;;;;AA8FY;;;;;;;;;;;;;;;;;;uBA9FU,gBAAA;;;;;;;;;;;;;;sBAcD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;WAgFT,cAAA"}