@jterrazz/test 5.3.2 → 6.0.0

package/dist/mock-of.cjs

@@ -0,0 +1,59 @@
+//#region \0rolldown/runtime.js
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+	if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
+		key = keys[i];
+		if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
+			get: ((k) => from[k]).bind(null, key),
+			enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+		});
+	}
+	return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
+	value: mod,
+	enumerable: true
+}) : target, mod));
+//#endregion
+let mockdate = require("mockdate");
+mockdate = __toESM(mockdate, 1);
+let vitest_mock_extended = require("vitest-mock-extended");
+//#region src/mocking/mock-of-date.ts
+/**
+* Freeze or reset the global Date for deterministic time-dependent tests.
+* Wraps the `mockdate` package.
+*/
+const mockOfDate = mockdate.default;
+//#endregion
+//#region src/mocking/mock-of.ts
+/**
+* Create a deep mock proxy for a given type.
+* Wraps `vitest-mock-extended`'s `mockDeep` for convenient port mocking.
+*/
+const mockOf = vitest_mock_extended.mockDeep;
+//#endregion
+Object.defineProperty(exports, "__toESM", {
+	enumerable: true,
+	get: function() {
+		return __toESM;
+	}
+});
+Object.defineProperty(exports, "mockOf", {
+	enumerable: true,
+	get: function() {
+		return mockOf;
+	}
+});
+Object.defineProperty(exports, "mockOfDate", {
+	enumerable: true,
+	get: function() {
+		return mockOfDate;
+	}
+});
+
+//# sourceMappingURL=mock-of.cjs.map

package/dist/mock-of.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock-of.cjs","names":["MockDatePackage","mockDeep"],"sources":["../src/mocking/mock-of-date.ts","../src/mocking/mock-of.ts"],"sourcesContent":["import MockDatePackage from 'mockdate';\n\n/** Interface for freezing and resetting the global Date in tests. */\nexport interface MockDatePort {\n    /** Restore the real Date object. */\n    reset: () => void;\n    /** Freeze `Date.now()` and `new Date()` to the given value. */\n    set: (date: Date | number | string) => void;\n}\n\n/**\n * Freeze or reset the global Date for deterministic time-dependent tests.\n * Wraps the `mockdate` package.\n */\nexport const mockOfDate: MockDatePort = MockDatePackage;\n","import { type DeepMockProxy, mockDeep } from 'vitest-mock-extended';\n\n/** Factory signature that creates a deep mock proxy for any interface. */\nexport type MockPort = <T>() => DeepMockProxy<T>;\n\n/**\n * Create a deep mock proxy for a given type.\n * Wraps `vitest-mock-extended`'s `mockDeep` for convenient port mocking.\n */\nexport const mockOf: MockPort = mockDeep;\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAcA,MAAa,aAA2BA,SAAAA;;;;;;;ACLxC,MAAa,SAAmBC,qBAAAA"}

package/dist/mock-of.d.cts

@@ -0,0 +1,27 @@
+import { DeepMockProxy } from "vitest-mock-extended";
+
+//#region src/mocking/mock-of-date.d.ts
+/** Interface for freezing and resetting the global Date in tests. */
+interface MockDatePort {
+  /** Restore the real Date object. */
+  reset: () => void;
+  /** Freeze `Date.now()` and `new Date()` to the given value. */
+  set: (date: Date | number | string) => void;
+}
+/**
+ * Freeze or reset the global Date for deterministic time-dependent tests.
+ * Wraps the `mockdate` package.
+ */
+declare const mockOfDate: MockDatePort;
+//#endregion
+//#region src/mocking/mock-of.d.ts
+/** Factory signature that creates a deep mock proxy for any interface. */
+type MockPort = <T>() => DeepMockProxy<T>;
+/**
+ * Create a deep mock proxy for a given type.
+ * Wraps `vitest-mock-extended`'s `mockDeep` for convenient port mocking.
+ */
+declare const mockOf: MockPort;
+//#endregion
+export { mockOfDate as i, mockOf as n, MockDatePort as r, MockPort as t };
+//# sourceMappingURL=mock-of.d.cts.map

package/dist/mock-of.d.ts

@@ -0,0 +1,27 @@
+import { DeepMockProxy } from "vitest-mock-extended";
+
+//#region src/mocking/mock-of-date.d.ts
+/** Interface for freezing and resetting the global Date in tests. */
+interface MockDatePort {
+  /** Restore the real Date object. */
+  reset: () => void;
+  /** Freeze `Date.now()` and `new Date()` to the given value. */
+  set: (date: Date | number | string) => void;
+}
+/**
+ * Freeze or reset the global Date for deterministic time-dependent tests.
+ * Wraps the `mockdate` package.
+ */
+declare const mockOfDate: MockDatePort;
+//#endregion
+//#region src/mocking/mock-of.d.ts
+/** Factory signature that creates a deep mock proxy for any interface. */
+type MockPort = <T>() => DeepMockProxy<T>;
+/**
+ * Create a deep mock proxy for a given type.
+ * Wraps `vitest-mock-extended`'s `mockDeep` for convenient port mocking.
+ */
+declare const mockOf: MockPort;
+//#endregion
+export { mockOfDate as i, mockOf as n, MockDatePort as r, MockPort as t };
+//# sourceMappingURL=mock-of.d.ts.map

package/dist/mock-of.js

@@ -0,0 +1,19 @@
+import MockDatePackage from "mockdate";
+import { mockDeep } from "vitest-mock-extended";
+//#region src/mocking/mock-of-date.ts
+/**
+* Freeze or reset the global Date for deterministic time-dependent tests.
+* Wraps the `mockdate` package.
+*/
+const mockOfDate = MockDatePackage;
+//#endregion
+//#region src/mocking/mock-of.ts
+/**
+* Create a deep mock proxy for a given type.
+* Wraps `vitest-mock-extended`'s `mockDeep` for convenient port mocking.
+*/
+const mockOf = mockDeep;
+//#endregion
+export { mockOfDate as n, mockOf as t };
+
+//# sourceMappingURL=mock-of.js.map

package/dist/mock-of.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock-of.js","names":[],"sources":["../src/mocking/mock-of-date.ts","../src/mocking/mock-of.ts"],"sourcesContent":["import MockDatePackage from 'mockdate';\n\n/** Interface for freezing and resetting the global Date in tests. */\nexport interface MockDatePort {\n    /** Restore the real Date object. */\n    reset: () => void;\n    /** Freeze `Date.now()` and `new Date()` to the given value. */\n    set: (date: Date | number | string) => void;\n}\n\n/**\n * Freeze or reset the global Date for deterministic time-dependent tests.\n * Wraps the `mockdate` package.\n */\nexport const mockOfDate: MockDatePort = MockDatePackage;\n","import { type DeepMockProxy, mockDeep } from 'vitest-mock-extended';\n\n/** Factory signature that creates a deep mock proxy for any interface. */\nexport type MockPort = <T>() => DeepMockProxy<T>;\n\n/**\n * Create a deep mock proxy for a given type.\n * Wraps `vitest-mock-extended`'s `mockDeep` for convenient port mocking.\n */\nexport const mockOf: MockPort = mockDeep;\n"],"mappings":";;;;;;;AAcA,MAAa,aAA2B;;;;;;;ACLxC,MAAa,SAAmB"}

package/dist/mock.cjs

@@ -0,0 +1,4 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_mock_of = require("./mock-of.cjs");
+exports.mockOf = require_mock_of.mockOf;
+exports.mockOfDate = require_mock_of.mockOfDate;

package/dist/mock.d.cts

@@ -0,0 +1,2 @@
+import { i as mockOfDate, n as mockOf, r as MockDatePort, t as MockPort } from "./mock-of.cjs";
+export { type MockDatePort, type MockPort, mockOf, mockOfDate };

package/dist/mock.d.ts

@@ -0,0 +1,2 @@
+import { i as mockOfDate, n as mockOf, r as MockDatePort, t as MockPort } from "./mock-of.js";
+export { type MockDatePort, type MockPort, mockOf, mockOfDate };

package/dist/mock.js

@@ -0,0 +1,2 @@
+import { n as mockOfDate, t as mockOf } from "./mock-of.js";
+export { mockOf, mockOfDate };

package/dist/redis.adapter.cjs

@@ -0,0 +1,214 @@
+require("./mock-of.cjs");
+let node_fs = require("node:fs");
+let node_path = require("node:path");
+let pg = require("pg");
+//#region src/adapters/postgres.adapter.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 pg.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 = [(0, node_path.resolve)(composeDir, `${this.composeName}/init.sql`), (0, node_path.resolve)(composeDir, "postgres/init.sql")];
+		for (const initPath of initPaths) if ((0, node_fs.existsSync)(initPath)) {
+			const sql = (0, node_fs.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 pg.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/adapters/redis.adapter.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
+Object.defineProperty(exports, "postgres", {
+	enumerable: true,
+	get: function() {
+		return postgres;
+	}
+});
+Object.defineProperty(exports, "redis", {
+	enumerable: true,
+	get: function() {
+		return redis;
+	}
+});
+
+//# sourceMappingURL=redis.adapter.cjs.map

package/dist/redis.adapter.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"redis.adapter.cjs","names":["Client"],"sources":["../src/adapters/postgres.adapter.ts","../src/adapters/redis.adapter.ts"],"sourcesContent":["import { existsSync, readFileSync } from 'node:fs';\nimport { resolve } from 'node:path';\nimport { Client } from 'pg';\n\nimport type { DatabasePort } from '../ports/database.port.js';\nimport type { IsolationStrategy } from '../ports/isolation.port.js';\nimport type { ServiceHandle } from '../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 '../ports/database.port.js';\nimport type { IsolationStrategy } from '../ports/isolation.port.js';\nimport type { ServiceHandle } from '../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"],"mappings":"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"}

package/dist/redis.adapter.d.cts

@@ -0,0 +1,155 @@
+//#region src/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/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/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/adapters/postgres.adapter.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/adapters/redis.adapter.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
+export { ServiceHandle as a, postgres as i, redis as n, IsolationStrategy as o, PostgresOptions as r, DatabasePort as s, RedisOptions as t };
+//# sourceMappingURL=redis.adapter.d.cts.map