@jterrazz/test 8.0.0 → 9.0.0

package/dist/sqlite.d.ts

@@ -1,209 +0,0 @@
-//#region src/spec/ports/database.port.d.ts
-/**
- * Abstract database interface for specification runners.
- * Implement this to plug in your database stack (e.g. Postgres, SQLite).
- */
-interface DatabasePort {
-  /** Execute raw SQL (for seeding test data). */
-  seed(sql: string): Promise<void>;
-  /** Query a table and return rows as arrays of values. */
-  query(table: string, columns: string[]): Promise<unknown[][]>;
-  /** Reset database to clean state between tests. */
-  reset(): Promise<void>;
-}
-//#endregion
-//#region src/spec/ports/isolation.port.d.ts
-/**
- * Strategy for isolating service state across parallel test workers.
- *
- * Each service handle provides an isolation strategy. The framework
- * calls `acquire()` once per vitest worker, `reset()` before each
- * `spec.run()`, and `release()` when the worker shuts down.
- *
- * Implement this interface to support new service types (e.g. MongoDB,
- * Elasticsearch, S3).
- */
-interface IsolationStrategy {
-  /**
-   * Create an isolated namespace for this worker.
-   * Called once when the worker starts — e.g. clone a template database,
-   * set a Redis key prefix.
-   *
-   * @param workerId - Unique identifier for this vitest worker.
-   */
-  acquire(workerId: string): Promise<void>;
-  /**
-   * Fast reset within the namespace between `spec.run()` calls.
-   * E.g. truncate tables (without dropping the database).
-   */
-  reset(): Promise<void>;
-  /**
-   * Tear down the isolated namespace.
-   * Called once when the worker shuts down — e.g. drop the cloned database.
-   */
-  release(): Promise<void>;
-}
-//#endregion
-//#region src/spec/ports/service.port.d.ts
-/**
- * A service handle — returned by factory functions like postgres(), redis().
- * Mutable: connectionString is populated after the orchestrator starts containers.
- */
-interface ServiceHandle {
-  /** Service type identifier. */
-  readonly type: string;
-  /** Compose service name (if linked). */
-  readonly composeName: null | string;
-  /** Default container port for this service type. */
-  readonly defaultPort: number;
-  /** Default Docker image for this service type. */
-  readonly defaultImage: string;
-  /** Environment variables to pass to the container. */
-  readonly environment: Record<string, string>;
-  /** Connection string — populated after start. */
-  connectionString: string;
-  /** Whether this service has been started. */
-  started: boolean;
-  /** Build the connection string from host and port. */
-  buildConnectionString(host: string, port: number): string;
-  /** Create a DatabasePort adapter (if this is a database). Returns null otherwise. */
-  createDatabaseAdapter(): DatabasePort | null;
-  /** Verify the service is ready and accepting connections. Throws with context if not. */
-  healthcheck(): Promise<void>;
-  /** Run initialization scripts (e.g., init.sql). Throws with SQL error context if it fails. */
-  initialize(composeDir: string): Promise<void>;
-  /** Reset state between tests (truncate tables, flush cache, etc.) */
-  reset(): Promise<void>;
-  /** Get the isolation strategy for parallel test execution. */
-  isolation(): IsolationStrategy;
-}
-//#endregion
-//#region src/services/postgres.d.ts
-interface PostgresOptions {
-  /** Map to a service in docker-compose.test.yaml. */
-  compose?: string;
-  /** Override image. */
-  image?: string;
-  /** Override environment variables. */
-  env?: Record<string, string>;
-}
-declare class PostgresHandle implements DatabasePort, ServiceHandle {
-  readonly type = "postgres";
-  readonly composeName: null | string;
-  readonly defaultPort = 5432;
-  readonly defaultImage: string;
-  readonly environment: Record<string, string>;
-  connectionString: string;
-  started: boolean;
-  private client;
-  private originalConnectionString;
-  private schema;
-  constructor(options?: PostgresOptions);
-  buildConnectionString(host: string, port: number): string;
-  createDatabaseAdapter(): DatabasePort;
-  healthcheck(): Promise<void>;
-  initialize(composeDir: string): Promise<void>;
-  private getClient;
-  seed(sql: string): Promise<void>;
-  reset(): Promise<void>;
-  query(table: string, columns: string[]): Promise<unknown[][]>;
-  isolation(): IsolationStrategy;
-}
-/**
- * Create a PostgreSQL service handle.
- *
- * @example
- * const db = postgres({ compose: "db" });
- * // After start: db.connectionString is populated
- */
-declare function postgres(options?: PostgresOptions): PostgresHandle;
-//#endregion
-//#region src/services/redis.d.ts
-interface RedisOptions {
-  /** Map to a service in docker-compose.test.yaml. */
-  compose?: string;
-  /** Override image. */
-  image?: string;
-}
-declare class RedisHandle implements ServiceHandle {
-  readonly type = "redis";
-  readonly composeName: null | string;
-  readonly defaultPort = 6379;
-  readonly defaultImage: string;
-  readonly environment: Record<string, string>;
-  connectionString: string;
-  started: boolean;
-  private dbIndex;
-  constructor(options?: RedisOptions);
-  buildConnectionString(host: string, port: number): string;
-  createDatabaseAdapter(): DatabasePort | null;
-  healthcheck(): Promise<void>;
-  initialize(): Promise<void>;
-  reset(): Promise<void>;
-  isolation(): IsolationStrategy;
-}
-/**
- * Create a Redis service handle.
- *
- * @example
- * const cache = redis({ compose: "cache" });
- * // After start: cache.connectionString is populated
- */
-declare function redis(options?: RedisOptions): RedisHandle;
-//#endregion
-//#region src/services/sqlite.d.ts
-interface SqliteOptions {
-  /**
-   * Path to a SQL file used to initialize the database schema.
-   * Mutually exclusive with `prismaSchema`.
-   */
-  init?: string;
-  /**
-   * Path to a Prisma schema directory or file.
-   * The adapter runs `prisma db push` to create the template.
-   * Mutually exclusive with `init`.
-   */
-  prismaSchema?: string;
-}
-declare class SqliteHandle implements DatabasePort, ServiceHandle {
-  readonly type = "sqlite";
-  readonly composeName: null;
-  readonly defaultPort = 0;
-  readonly defaultImage = "";
-  readonly environment: Record<string, string>;
-  connectionString: string;
-  started: boolean;
-  private db;
-  private templatePath;
-  private workerDbPath;
-  private initSql;
-  private prismaSchema;
-  constructor(options?: SqliteOptions);
-  buildConnectionString(): string;
-  createDatabaseAdapter(): DatabasePort;
-  healthcheck(): Promise<void>;
-  initialize(): Promise<void>;
-  private getDb;
-  private closeDb;
-  seed(sql: string): Promise<void>;
-  query(table: string, columns: string[]): Promise<unknown[][]>;
-  reset(): Promise<void>;
-  isolation(): IsolationStrategy;
-}
-/**
- * Create a SQLite service handle. Uses file-copy isolation for parallel tests.
- *
- * @example
- *   // With Prisma schema
- *   const db = sqlite({ prismaSchema: './prisma/schema' });
- *
- *   // With raw SQL init
- *   const db = sqlite({ init: './schema.sql' });
- *
- *   // Empty database
- *   const db = sqlite();
- */
-declare function sqlite(options?: SqliteOptions): SqliteHandle;
-//#endregion
-export { PostgresOptions as a, IsolationStrategy as c, redis as i, DatabasePort as l, sqlite as n, postgres as o, RedisOptions as r, ServiceHandle as s, SqliteOptions as t };
-//# sourceMappingURL=sqlite.d.ts.map

package/dist/sqlite.js

@@ -1,331 +0,0 @@
-import { resolve } from "node:path";
-import { copyFileSync, existsSync, readFileSync, unlinkSync } from "node:fs";
-import { Client } from "pg";
-import { tmpdir } from "node:os";
-import Database from "better-sqlite3";
-//#region src/services/postgres.ts
-var PostgresHandle = class {
-	type = "postgres";
-	composeName;
-	defaultPort = 5432;
-	defaultImage;
-	environment;
-	connectionString = "";
-	started = false;
-	client = null;
-	originalConnectionString = "";
-	schema = "public";
-	constructor(options = {}) {
-		this.composeName = options.compose ?? null;
-		this.defaultImage = options.image ?? "postgres:17";
-		this.environment = {
-			POSTGRES_DB: "test",
-			POSTGRES_PASSWORD: "test",
-			POSTGRES_USER: "test",
-			...options.env
-		};
-	}
-	buildConnectionString(host, port) {
-		return `postgresql://${this.environment.POSTGRES_USER ?? "test"}:${this.environment.POSTGRES_PASSWORD ?? "test"}@${host}:${port}/${this.environment.POSTGRES_DB ?? "test"}`;
-	}
-	createDatabaseAdapter() {
-		return this;
-	}
-	async healthcheck() {
-		if (!this.connectionString) throw new Error("postgres: cannot healthcheck — no connection string");
-		try {
-			const client = new Client({ connectionString: this.connectionString });
-			await client.connect();
-			await client.query("SELECT 1");
-			await client.end();
-		} catch (error) {
-			throw new Error(`postgres healthcheck failed: ${error.message || error.code || String(error)}`, { cause: error });
-		}
-	}
-	async initialize(composeDir) {
-		if (!this.composeName) return;
-		const initPaths = [resolve(composeDir, `${this.composeName}/init.sql`), resolve(composeDir, "postgres/init.sql")];
-		for (const initPath of initPaths) if (existsSync(initPath)) {
-			const sql = readFileSync(initPath, "utf8");
-			try {
-				await this.seed(sql);
-			} catch (error) {
-				throw new Error(`postgres init script failed (${initPath}):\n${error.message}`, { cause: error });
-			}
-			return;
-		}
-	}
-	async getClient() {
-		if (this.client) return this.client;
-		const client = new Client({ connectionString: this.connectionString });
-		client.on("error", () => {
-			this.client = null;
-		});
-		await client.connect();
-		this.client = client;
-		return client;
-	}
-	async seed(sql) {
-		await (await this.getClient()).query(sql);
-	}
-	async reset() {
-		const client = await this.getClient();
-		const result = await client.query(`
-            SELECT tablename FROM pg_tables
-            WHERE schemaname = '${this.schema}'
-            AND tablename NOT LIKE '_prisma%'
-        `);
-		for (const row of result.rows) await client.query(`TRUNCATE "${this.schema}"."${row.tablename}" CASCADE`);
-	}
-	async query(table, columns) {
-		const client = await this.getClient();
-		const columnList = columns.join(", ");
-		return (await client.query(`SELECT ${columnList} FROM "${this.schema}"."${table}" ORDER BY 1`)).rows.map((row) => columns.map((col) => row[col]));
-	}
-	isolation() {
-		return {
-			acquire: async (workerId) => {
-				const workerSchema = `worker_${workerId}`;
-				this.originalConnectionString = this.connectionString;
-				const client = await this.getClient();
-				await client.query(`DROP SCHEMA IF EXISTS "${workerSchema}" CASCADE`);
-				await client.query(`CREATE SCHEMA "${workerSchema}"`);
-				const tables = await client.query(`
-                    SELECT tablename FROM pg_tables
-                    WHERE schemaname = 'public'
-                    AND tablename NOT LIKE '_prisma%'
-                `);
-				for (const row of tables.rows) await client.query(`CREATE TABLE "${workerSchema}"."${row.tablename}" (LIKE "public"."${row.tablename}" INCLUDING ALL)`);
-				this.schema = workerSchema;
-				await client.query(`SET search_path TO "${workerSchema}", public`);
-				const url = new URL(this.connectionString);
-				url.searchParams.set("options", `-c search_path=${workerSchema},public`);
-				this.connectionString = url.toString();
-			},
-			reset: async () => {
-				await this.reset();
-			},
-			release: async () => {
-				const client = await this.getClient();
-				const workerSchema = this.schema;
-				this.schema = "public";
-				this.connectionString = this.originalConnectionString;
-				await client.query(`SET search_path TO public`);
-				await client.query(`DROP SCHEMA IF EXISTS "${workerSchema}" CASCADE`);
-			}
-		};
-	}
-};
-/**
-* Create a PostgreSQL service handle.
-*
-* @example
-* const db = postgres({ compose: "db" });
-* // After start: db.connectionString is populated
-*/
-function postgres(options = {}) {
-	return new PostgresHandle(options);
-}
-//#endregion
-//#region src/services/redis.ts
-var RedisHandle = class {
-	type = "redis";
-	composeName;
-	defaultPort = 6379;
-	defaultImage;
-	environment = {};
-	connectionString = "";
-	started = false;
-	dbIndex = 0;
-	constructor(options = {}) {
-		this.composeName = options.compose ?? null;
-		this.defaultImage = options.image ?? "redis:7";
-	}
-	buildConnectionString(host, port) {
-		return `redis://${host}:${port}`;
-	}
-	createDatabaseAdapter() {
-		return null;
-	}
-	async healthcheck() {
-		if (!this.connectionString) throw new Error("redis: cannot healthcheck — no connection string");
-		try {
-			const { createClient } = await import("redis");
-			const client = createClient({ url: this.connectionString });
-			await client.connect();
-			await client.ping();
-			await client.disconnect();
-		} catch (error) {
-			throw new Error(`redis healthcheck failed: ${error.message || error.code || String(error)}`, { cause: error });
-		}
-	}
-	async initialize() {}
-	async reset() {
-		const { createClient } = await import("redis");
-		const client = createClient({
-			url: this.connectionString,
-			database: this.dbIndex
-		});
-		await client.connect();
-		try {
-			await client.flushDb();
-		} finally {
-			await client.disconnect();
-		}
-	}
-	isolation() {
-		return {
-			acquire: async (workerId) => {
-				this.dbIndex = (Number.parseInt(workerId, 10) || 0) % 15 + 1;
-			},
-			reset: async () => {
-				await this.reset();
-			},
-			release: async () => {
-				await this.reset();
-				this.dbIndex = 0;
-			}
-		};
-	}
-};
-/**
-* Create a Redis service handle.
-*
-* @example
-* const cache = redis({ compose: "cache" });
-* // After start: cache.connectionString is populated
-*/
-function redis(options = {}) {
-	return new RedisHandle(options);
-}
-//#endregion
-//#region src/services/sqlite.ts
-var SqliteHandle = class {
-	type = "sqlite";
-	composeName = null;
-	defaultPort = 0;
-	defaultImage = "";
-	environment = {};
-	connectionString = "";
-	started = false;
-	db = null;
-	templatePath = "";
-	workerDbPath = "";
-	initSql;
-	prismaSchema;
-	constructor(options = {}) {
-		this.initSql = options.init ?? null;
-		this.prismaSchema = options.prismaSchema ?? null;
-	}
-	buildConnectionString() {
-		return `file:${this.workerDbPath || this.templatePath}`;
-	}
-	createDatabaseAdapter() {
-		return this;
-	}
-	async healthcheck() {}
-	async initialize() {
-		this.templatePath = resolve(tmpdir(), "jterrazz-test-sqlite-template.sqlite");
-		const lockPath = `${this.templatePath}.lock`;
-		if (existsSync(lockPath)) {
-			const start = Date.now();
-			while (existsSync(lockPath) && Date.now() - start < 3e4) await new Promise((r) => setTimeout(r, 100));
-		}
-		if (existsSync(this.templatePath)) {
-			this.connectionString = `file:${this.templatePath}`;
-			this.started = true;
-			return;
-		}
-		const { writeFileSync } = await import("node:fs");
-		writeFileSync(lockPath, process.pid.toString());
-		if (this.prismaSchema) {
-			const { execSync } = await import("node:child_process");
-			execSync("npx prisma db push --force-reset", {
-				env: {
-					...process.env,
-					DATABASE_URL: `file:${this.templatePath}`,
-					PRISMA_USER_CONSENT_FOR_DANGEROUS_AI_ACTION: "yes"
-				},
-				stdio: "pipe"
-			});
-			const tmpDb = new Database(this.templatePath);
-			tmpDb.pragma("wal_checkpoint(TRUNCATE)");
-			tmpDb.close();
-		} else if (this.initSql) {
-			const sql = readFileSync(this.initSql, "utf8");
-			const templateDb = new Database(this.templatePath);
-			templateDb.exec(sql);
-			templateDb.close();
-		} else new Database(this.templatePath).close();
-		try {
-			unlinkSync(lockPath);
-		} catch {}
-		this.connectionString = `file:${this.templatePath}`;
-		this.started = true;
-	}
-	getDb() {
-		const dbPath = this.workerDbPath || this.templatePath;
-		if (!this.db) {
-			this.db = new Database(dbPath);
-			this.db.pragma("journal_mode = WAL");
-		}
-		return this.db;
-	}
-	closeDb() {
-		if (this.db) {
-			this.db.close();
-			this.db = null;
-		}
-	}
-	async seed(sql) {
-		this.getDb().exec(sql);
-	}
-	async query(table, columns) {
-		const columnList = columns.join(", ");
-		return this.getDb().prepare(`SELECT ${columnList} FROM "${table}" ORDER BY 1`).all().map((row) => columns.map((col) => row[col]));
-	}
-	async reset() {
-		const db = this.getDb();
-		const tables = db.prepare(`SELECT name FROM sqlite_master WHERE type='table' AND name NOT LIKE '_prisma%' AND name != 'sqlite_sequence'`).all();
-		for (const { name } of tables) db.exec(`DELETE FROM "${name}"`);
-	}
-	isolation() {
-		return {
-			acquire: async (workerId) => {
-				this.closeDb();
-				this.workerDbPath = resolve(tmpdir(), `test-worker-${workerId}-${Date.now()}.sqlite`);
-				copyFileSync(this.templatePath, this.workerDbPath);
-				this.connectionString = `file:${this.workerDbPath}`;
-			},
-			reset: async () => {
-				await this.reset();
-			},
-			release: async () => {
-				this.closeDb();
-				if (this.workerDbPath && existsSync(this.workerDbPath)) unlinkSync(this.workerDbPath);
-				this.workerDbPath = "";
-				this.connectionString = `file:${this.templatePath}`;
-			}
-		};
-	}
-};
-/**
-* Create a SQLite service handle. Uses file-copy isolation for parallel tests.
-*
-* @example
-*   // With Prisma schema
-*   const db = sqlite({ prismaSchema: './prisma/schema' });
-*
-*   // With raw SQL init
-*   const db = sqlite({ init: './schema.sql' });
-*
-*   // Empty database
-*   const db = sqlite();
-*/
-function sqlite(options = {}) {
-	return new SqliteHandle(options);
-}
-//#endregion
-export { redis as n, postgres as r, sqlite as t };
-
-//# sourceMappingURL=sqlite.js.map

package/dist/sqlite.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"sqlite.js","names":[],"sources":["../src/services/postgres.ts","../src/services/redis.ts","../src/services/sqlite.ts"],"sourcesContent":["import { existsSync, readFileSync } from 'node:fs';\nimport { resolve } from 'node:path';\nimport { Client } from 'pg';\n\nimport type { DatabasePort } from '../spec/ports/database.port.js';\nimport type { IsolationStrategy } from '../spec/ports/isolation.port.js';\nimport type { ServiceHandle } from '../spec/ports/service.port.js';\n\nexport interface PostgresOptions {\n    /** Map to a service in docker-compose.test.yaml. */\n    compose?: string;\n    /** Override image. */\n    image?: string;\n    /** Override environment variables. */\n    env?: Record<string, string>;\n}\n\nexport class PostgresHandle implements DatabasePort, ServiceHandle {\n    readonly type = 'postgres';\n    readonly composeName: null | string;\n    readonly defaultPort = 5432;\n    readonly defaultImage: string;\n    readonly environment: Record<string, string>;\n\n    connectionString = '';\n    started = false;\n\n    private client: Client | null = null;\n    private originalConnectionString = '';\n    private schema = 'public';\n\n    constructor(options: PostgresOptions = {}) {\n        this.composeName = options.compose ?? null;\n        this.defaultImage = options.image ?? 'postgres:17';\n        this.environment = {\n            POSTGRES_DB: 'test',\n            POSTGRES_PASSWORD: 'test',\n            POSTGRES_USER: 'test',\n            ...options.env,\n        };\n    }\n\n    buildConnectionString(host: string, port: number): string {\n        const user = this.environment.POSTGRES_USER ?? 'test';\n        const password = this.environment.POSTGRES_PASSWORD ?? 'test';\n        const db = this.environment.POSTGRES_DB ?? 'test';\n        return `postgresql://${user}:${password}@${host}:${port}/${db}`;\n    }\n\n    createDatabaseAdapter(): DatabasePort {\n        return this;\n    }\n\n    async healthcheck(): Promise<void> {\n        if (!this.connectionString) {\n            throw new Error('postgres: cannot healthcheck — no connection string');\n        }\n\n        // Healthcheck uses a throwaway client (connection might not be established yet)\n        try {\n            const client = new Client({ connectionString: this.connectionString });\n            await client.connect();\n            await client.query('SELECT 1');\n            await client.end();\n        } catch (error: any) {\n            throw new Error(\n                `postgres healthcheck failed: ${error.message || error.code || String(error)}`,\n                { cause: error },\n            );\n        }\n    }\n\n    async initialize(composeDir: string): Promise<void> {\n        if (!this.composeName) {\n            return;\n        }\n\n        const initPaths = [\n            resolve(composeDir, `${this.composeName}/init.sql`),\n            resolve(composeDir, 'postgres/init.sql'),\n        ];\n\n        for (const initPath of initPaths) {\n            if (existsSync(initPath)) {\n                const sql = readFileSync(initPath, 'utf8');\n                try {\n                    await this.seed(sql);\n                } catch (error: any) {\n                    throw new Error(\n                        `postgres init script failed (${initPath}):\\n${error.message}`,\n                        {\n                            cause: error,\n                        },\n                    );\n                }\n                return;\n            }\n        }\n    }\n\n    private async getClient(): Promise<Client> {\n        if (this.client) {\n            return this.client;\n        }\n        const client = new Client({ connectionString: this.connectionString });\n        client.on('error', () => {\n            // Connection dropped (container stopped) — reset so next call reconnects\n            this.client = null;\n        });\n        await client.connect();\n        this.client = client;\n        return client;\n    }\n\n    async seed(sql: string): Promise<void> {\n        const client = await this.getClient();\n        await client.query(sql);\n    }\n\n    async reset(): Promise<void> {\n        const client = await this.getClient();\n        const result = await client.query(`\n            SELECT tablename FROM pg_tables\n            WHERE schemaname = '${this.schema}'\n            AND tablename NOT LIKE '_prisma%'\n        `);\n        for (const row of result.rows) {\n            await client.query(`TRUNCATE \"${this.schema}\".\"${row.tablename}\" CASCADE`);\n        }\n    }\n\n    async query(table: string, columns: string[]): Promise<unknown[][]> {\n        const client = await this.getClient();\n        const columnList = columns.join(', ');\n        const result = await client.query(\n            `SELECT ${columnList} FROM \"${this.schema}\".\"${table}\" ORDER BY 1`,\n        );\n        return result.rows.map((row: Record<string, unknown>) => columns.map((col) => row[col]));\n    }\n\n    isolation(): IsolationStrategy {\n        return {\n            acquire: async (workerId: string) => {\n                const workerSchema = `worker_${workerId}`;\n                this.originalConnectionString = this.connectionString;\n                const client = await this.getClient();\n\n                // Create schema by cloning all tables from public\n                await client.query(`DROP SCHEMA IF EXISTS \"${workerSchema}\" CASCADE`);\n                await client.query(`CREATE SCHEMA \"${workerSchema}\"`);\n\n                // Copy table structures (no data) from public\n                const tables = await client.query(`\n                    SELECT tablename FROM pg_tables\n                    WHERE schemaname = 'public'\n                    AND tablename NOT LIKE '_prisma%'\n                `);\n                for (const row of tables.rows) {\n                    await client.query(\n                        `CREATE TABLE \"${workerSchema}\".\"${row.tablename}\" (LIKE \"public\".\"${row.tablename}\" INCLUDING ALL)`,\n                    );\n                }\n\n                // Switch this handle to use the worker schema\n                this.schema = workerSchema;\n                await client.query(`SET search_path TO \"${workerSchema}\", public`);\n\n                // Update connectionString so app connections also use the worker schema\n                const url = new URL(this.connectionString);\n                url.searchParams.set('options', `-c search_path=${workerSchema},public`);\n                this.connectionString = url.toString();\n            },\n\n            reset: async () => {\n                await this.reset();\n            },\n\n            release: async () => {\n                const client = await this.getClient();\n                const workerSchema = this.schema;\n                this.schema = 'public';\n                this.connectionString = this.originalConnectionString;\n                await client.query(`SET search_path TO public`);\n                await client.query(`DROP SCHEMA IF EXISTS \"${workerSchema}\" CASCADE`);\n            },\n        };\n    }\n}\n\n/**\n * Create a PostgreSQL service handle.\n *\n * @example\n * const db = postgres({ compose: \"db\" });\n * // After start: db.connectionString is populated\n */\nexport function postgres(options: PostgresOptions = {}): PostgresHandle {\n    return new PostgresHandle(options);\n}\n","import type { DatabasePort } from '../spec/ports/database.port.js';\nimport type { IsolationStrategy } from '../spec/ports/isolation.port.js';\nimport type { ServiceHandle } from '../spec/ports/service.port.js';\n\nexport interface RedisOptions {\n    /** Map to a service in docker-compose.test.yaml. */\n    compose?: string;\n    /** Override image. */\n    image?: string;\n}\n\nexport class RedisHandle implements ServiceHandle {\n    readonly type = 'redis';\n    readonly composeName: null | string;\n    readonly defaultPort = 6379;\n    readonly defaultImage: string;\n    readonly environment: Record<string, string> = {};\n\n    connectionString = '';\n    started = false;\n\n    private dbIndex = 0;\n\n    constructor(options: RedisOptions = {}) {\n        this.composeName = options.compose ?? null;\n        this.defaultImage = options.image ?? 'redis:7';\n    }\n\n    buildConnectionString(host: string, port: number): string {\n        return `redis://${host}:${port}`;\n    }\n\n    createDatabaseAdapter(): DatabasePort | null {\n        return null;\n    }\n\n    async healthcheck(): Promise<void> {\n        if (!this.connectionString) {\n            throw new Error('redis: cannot healthcheck — no connection string');\n        }\n\n        try {\n            const { createClient } = await import('redis');\n            const client = createClient({ url: this.connectionString });\n            await client.connect();\n            await client.ping();\n            await client.disconnect();\n        } catch (error: any) {\n            throw new Error(\n                `redis healthcheck failed: ${error.message || error.code || String(error)}`,\n                {\n                    cause: error,\n                },\n            );\n        }\n    }\n\n    async initialize(): Promise<void> {\n        // Redis doesn't need initialization scripts\n    }\n\n    async reset(): Promise<void> {\n        const { createClient } = await import('redis');\n        const client = createClient({ url: this.connectionString, database: this.dbIndex });\n        await client.connect();\n        try {\n            await client.flushDb();\n        } finally {\n            await client.disconnect();\n        }\n    }\n\n    isolation(): IsolationStrategy {\n        return {\n            acquire: async (workerId: string) => {\n                // Use Redis database index 1-15 for workers (0 is default/shared)\n                const numericId = Number.parseInt(workerId, 10) || 0;\n                this.dbIndex = (numericId % 15) + 1;\n            },\n\n            reset: async () => {\n                await this.reset();\n            },\n\n            release: async () => {\n                await this.reset();\n                this.dbIndex = 0;\n            },\n        };\n    }\n}\n\n/**\n * Create a Redis service handle.\n *\n * @example\n * const cache = redis({ compose: \"cache\" });\n * // After start: cache.connectionString is populated\n */\nexport function redis(options: RedisOptions = {}): RedisHandle {\n    return new RedisHandle(options);\n}\n","import Database from 'better-sqlite3';\nimport { copyFileSync, existsSync, readFileSync, unlinkSync } from 'node:fs';\nimport { tmpdir } from 'node:os';\nimport { resolve } from 'node:path';\n\nimport type { DatabasePort } from '../spec/ports/database.port.js';\nimport type { IsolationStrategy } from '../spec/ports/isolation.port.js';\nimport type { ServiceHandle } from '../spec/ports/service.port.js';\n\nexport interface SqliteOptions {\n    /**\n     * Path to a SQL file used to initialize the database schema.\n     * Mutually exclusive with `prismaSchema`.\n     */\n    init?: string;\n    /**\n     * Path to a Prisma schema directory or file.\n     * The adapter runs `prisma db push` to create the template.\n     * Mutually exclusive with `init`.\n     */\n    prismaSchema?: string;\n}\n\nexport class SqliteHandle implements DatabasePort, ServiceHandle {\n    readonly type = 'sqlite';\n    readonly composeName = null;\n    readonly defaultPort = 0;\n    readonly defaultImage = '';\n    readonly environment: Record<string, string> = {};\n\n    connectionString = '';\n    started = false;\n\n    private db: Database.Database | null = null;\n    private templatePath = '';\n    private workerDbPath = '';\n    private initSql: null | string;\n    private prismaSchema: null | string;\n\n    constructor(options: SqliteOptions = {}) {\n        this.initSql = options.init ?? null;\n        this.prismaSchema = options.prismaSchema ?? null;\n    }\n\n    buildConnectionString(): string {\n        return `file:${this.workerDbPath || this.templatePath}`;\n    }\n\n    createDatabaseAdapter(): DatabasePort {\n        return this;\n    }\n\n    async healthcheck(): Promise<void> {\n        // SQLite is always ready — it's a file\n    }\n\n    async initialize(): Promise<void> {\n        // Each test run gets a fresh template; workers share it via lock\n        this.templatePath = resolve(tmpdir(), 'jterrazz-test-sqlite-template.sqlite');\n        const lockPath = `${this.templatePath}.lock`;\n\n        if (existsSync(lockPath)) {\n            // Another worker is creating it — wait for it\n            const start = Date.now();\n            while (existsSync(lockPath) && Date.now() - start < 30_000) {\n                await new Promise((r) => setTimeout(r, 100));\n            }\n        }\n\n        if (existsSync(this.templatePath)) {\n            this.connectionString = `file:${this.templatePath}`;\n            this.started = true;\n            return;\n        }\n\n        // Acquire lock\n        const { writeFileSync } = await import('node:fs');\n        writeFileSync(lockPath, process.pid.toString());\n\n        if (this.prismaSchema) {\n            // Use Prisma to create schema\n            const { execSync } = await import('node:child_process');\n            execSync('npx prisma db push --force-reset', {\n                env: {\n                    ...process.env,\n                    DATABASE_URL: `file:${this.templatePath}`,\n                    PRISMA_USER_CONSENT_FOR_DANGEROUS_AI_ACTION: 'yes',\n                },\n                stdio: 'pipe',\n            });\n\n            // Checkpoint WAL so the template is a single file (safe to copy)\n            const tmpDb = new Database(this.templatePath);\n            tmpDb.pragma('wal_checkpoint(TRUNCATE)');\n            tmpDb.close();\n        } else if (this.initSql) {\n            // Use raw SQL to create schema\n            const sql = readFileSync(this.initSql, 'utf8');\n            const templateDb = new Database(this.templatePath);\n            templateDb.exec(sql);\n            templateDb.close();\n        } else {\n            // Empty database — consumer will seed\n            const templateDb = new Database(this.templatePath);\n            templateDb.close();\n        }\n\n        // Release lock\n        try {\n            unlinkSync(lockPath);\n        } catch {\n            /* Ignore */\n        }\n\n        this.connectionString = `file:${this.templatePath}`;\n        this.started = true;\n    }\n\n    private getDb(): Database.Database {\n        const dbPath = this.workerDbPath || this.templatePath;\n        if (!this.db) {\n            this.db = new Database(dbPath);\n            this.db.pragma('journal_mode = WAL');\n        }\n        return this.db;\n    }\n\n    private closeDb(): void {\n        if (this.db) {\n            this.db.close();\n            this.db = null;\n        }\n    }\n\n    async seed(sql: string): Promise<void> {\n        this.getDb().exec(sql);\n    }\n\n    async query(table: string, columns: string[]): Promise<unknown[][]> {\n        const columnList = columns.join(', ');\n        const rows = this.getDb()\n            .prepare(`SELECT ${columnList} FROM \"${table}\" ORDER BY 1`)\n            .all() as Record<string, unknown>[];\n        return rows.map((row) => columns.map((col) => row[col]));\n    }\n\n    async reset(): Promise<void> {\n        const db = this.getDb();\n        const tables = db\n            .prepare(\n                `SELECT name FROM sqlite_master WHERE type='table' AND name NOT LIKE '_prisma%' AND name != 'sqlite_sequence'`,\n            )\n            .all() as { name: string }[];\n        for (const { name } of tables) {\n            db.exec(`DELETE FROM \"${name}\"`);\n        }\n    }\n\n    isolation(): IsolationStrategy {\n        return {\n            acquire: async (workerId: string) => {\n                this.closeDb();\n                this.workerDbPath = resolve(\n                    tmpdir(),\n                    `test-worker-${workerId}-${Date.now()}.sqlite`,\n                );\n                copyFileSync(this.templatePath, this.workerDbPath);\n                this.connectionString = `file:${this.workerDbPath}`;\n            },\n\n            reset: async () => {\n                await this.reset();\n            },\n\n            release: async () => {\n                this.closeDb();\n                if (this.workerDbPath && existsSync(this.workerDbPath)) {\n                    unlinkSync(this.workerDbPath);\n                }\n                this.workerDbPath = '';\n                this.connectionString = `file:${this.templatePath}`;\n            },\n        };\n    }\n}\n\n/**\n * Create a SQLite service handle. Uses file-copy isolation for parallel tests.\n *\n * @example\n *   // With Prisma schema\n *   const db = sqlite({ prismaSchema: './prisma/schema' });\n *\n *   // With raw SQL init\n *   const db = sqlite({ init: './schema.sql' });\n *\n *   // Empty database\n *   const db = sqlite();\n */\nexport function sqlite(options: SqliteOptions = {}): SqliteHandle {\n    return new SqliteHandle(options);\n}\n"],"mappings":"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"}

package/dist/types.d.cts

@@ -1,42 +0,0 @@
-//#region src/spec/intercept/types.d.ts
-/**
- * An intercept trigger describes which HTTP request to match.
- */
-interface InterceptTrigger {
-  /** Adapter name - must match the folder prefix in file-based intercepts. */
-  adapter: string;
-  /** HTTP method to match. */
-  method: string;
-  /** URL pattern to match (string for exact prefix, RegExp for pattern). */
-  url: RegExp | string;
-  /** Optional request body matcher - the handler only fires if this returns true. */
-  match?: (body: unknown) => boolean;
-  /**
-   * Transform raw JSON data into a provider-specific response envelope.
-   * Called when .intercept(trigger, 'adapter/file.json') loads a file.
-   */
-  wrap: (data: unknown) => InterceptResponse;
-}
-/**
- * An intercept response describes what to return when the trigger matches.
- */
-interface InterceptResponse {
-  /** HTTP status code (default: 200). */
-  status?: number;
-  /** Response body (will be JSON.stringified). */
-  body: unknown;
-  /** Response headers. */
-  headers?: Record<string, string>;
-  /** Delay in ms before responding (for timeout testing). */
-  delay?: number;
-}
-/**
- * A fully resolved intercept entry ready to be registered with MSW.
- */
-interface InterceptEntry {
-  trigger: InterceptTrigger;
-  response: InterceptResponse;
-}
-//#endregion
-export { InterceptResponse as n, InterceptTrigger as r, InterceptEntry as t };
-//# sourceMappingURL=types.d.cts.map

package/dist/types.d.ts

@@ -1,42 +0,0 @@
-//#region src/spec/intercept/types.d.ts
-/**
- * An intercept trigger describes which HTTP request to match.
- */
-interface InterceptTrigger {
-  /** Adapter name - must match the folder prefix in file-based intercepts. */
-  adapter: string;
-  /** HTTP method to match. */
-  method: string;
-  /** URL pattern to match (string for exact prefix, RegExp for pattern). */
-  url: RegExp | string;
-  /** Optional request body matcher - the handler only fires if this returns true. */
-  match?: (body: unknown) => boolean;
-  /**
-   * Transform raw JSON data into a provider-specific response envelope.
-   * Called when .intercept(trigger, 'adapter/file.json') loads a file.
-   */
-  wrap: (data: unknown) => InterceptResponse;
-}
-/**
- * An intercept response describes what to return when the trigger matches.
- */
-interface InterceptResponse {
-  /** HTTP status code (default: 200). */
-  status?: number;
-  /** Response body (will be JSON.stringified). */
-  body: unknown;
-  /** Response headers. */
-  headers?: Record<string, string>;
-  /** Delay in ms before responding (for timeout testing). */
-  delay?: number;
-}
-/**
- * A fully resolved intercept entry ready to be registered with MSW.
- */
-interface InterceptEntry {
-  trigger: InterceptTrigger;
-  response: InterceptResponse;
-}
-//#endregion
-export { InterceptResponse as n, InterceptTrigger as r, InterceptEntry as t };
-//# sourceMappingURL=types.d.ts.map