@shivaedev/test-sql 0.13.0 → 0.14.0

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## 0.14.0 - 2026-10-30
+
+### Added
+
+- A scoped PostgreSQL disconnect proxy supports disconnecting, refusing and stalling traffic, holding disconnect acknowledgements, observing open clients and dropping LISTEN notifications. Test kits can share the environment reader and empty PostgreSQL template.
+- Shared story answer readouts translate Effect failures into words for package test kits.
+
 ## 0.13.0 - 2026-10-30
 
 ### Added

package/README.md

@@ -249,6 +249,14 @@ With a PostgreSQL client in the current Context, the assertion compares names th
 
 The assertion uses the SQL `Model`'s selected database fields, including generated ids and excluding JSON-only fields. Supply an exact PostgreSQL type for every field: schemas such as `Schema.Number` do not determine whether storage is `integer`, `numeric` or `double precision`. It fails with a typed `ModelColumnMismatch` containing all detected missing, extra and wrongly typed column problems. The type map is checked against the model both by TypeScript and at runtime. This check covers names and types; it does not check defaults, nullability, constraints or application data transformations.
 
+### Database faults
+
+`disconnectProxy` from `@shivaedev/test-sql/server/disconnectProxy.ts` acquires a loopback TCP proxy in the current Effect scope. Give its `url` to the application database client. `disconnect()` cuts existing connections, `setReachable(false)` also refuses new connections, and `setResponsive(false)` stalls traffic until `setResponsive(true)` resumes it. Closing the scope destroys the sockets and closes the listener.
+
+For teardown stories, pass `{ holdDisconnects: true }`: `disconnecting` signals the first upstream disconnect, `allHeld` signals when every upstream has disconnected, and `release()` forwards the held acknowledgements. For LISTEN health stories, `{ dropNotifications: true }` filters PostgreSQL notifications while other SQL traffic continues; `dropped` signals a filtered notification.
+
+`@shivaedev/test-sql/server/emptyPostgres.ts` provides `databaseUrl` and `postgres`, an empty migration template selected by `PLATFORM_SQL_TEST_DATABASE_URL`. Use it with `withIsolatedDatabase` for kits that initialize their own schema. `environmentVariable(name)` from `@shivaedev/test-sql/server/adapters/environmentVariable.ts` reads an optional string through Effect Config when declaring a kit's `runIf`.
+
 ### API
 
 Import each name from the module that defines it. The package has no root entry. Every source module is available through its `.ts` subpath, including modules under `server/internal/`.

package/dist/server/adapters/environmentVariable.d.ts

@@ -0,0 +1,2 @@
+export declare function environmentVariable(name: string): string | undefined;
+//# sourceMappingURL=environmentVariable.d.ts.map

package/dist/server/adapters/environmentVariable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"environmentVariable.d.ts","sourceRoot":"","sources":["../../../src/server/adapters/environmentVariable.ts"],"names":[],"mappings":"AAEA,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAEpE"}

package/dist/server/adapters/environmentVariable.js

@@ -0,0 +1,5 @@
+import { Config, Effect, Option } from "effect";
+export function environmentVariable(name) {
+    return Option.getOrUndefined(Effect.runSync(Config.option(Config.String(name))));
+}
+//# sourceMappingURL=environmentVariable.js.map

package/dist/server/adapters/environmentVariable.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"environmentVariable.js","sourceRoot":"","sources":["../../../src/server/adapters/environmentVariable.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhD,MAAM,UAAU,mBAAmB,CAAC,IAAY;IAC/C,OAAO,MAAM,CAAC,cAAc,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;AAClF,CAAC"}

package/dist/server/adapters/notificationFilter.d.ts

@@ -0,0 +1,3 @@
+import { Transform } from "node:stream";
+export declare function notificationFilter(dropped: () => void): Transform;
+//# sourceMappingURL=notificationFilter.d.ts.map

package/dist/server/adapters/notificationFilter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notificationFilter.d.ts","sourceRoot":"","sources":["../../../src/server/adapters/notificationFilter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,IAAI,aAqBrD"}

package/dist/server/adapters/notificationFilter.js

@@ -0,0 +1,25 @@
+import { Transform } from "node:stream";
+export function notificationFilter(dropped) {
+    let pending = Buffer.alloc(0);
+    const filter = new Transform({
+        transform(chunk, _encoding, callback) {
+            pending = Buffer.concat([pending, chunk]);
+            while (pending.length >= 5) {
+                const length = pending.readInt32BE(1) + 1;
+                if (pending.length < length) {
+                    break;
+                }
+                if (pending[0] === 65) {
+                    dropped();
+                }
+                else {
+                    filter.push(pending.subarray(0, length));
+                }
+                pending = pending.subarray(length);
+            }
+            callback();
+        },
+    });
+    return filter;
+}
+//# sourceMappingURL=notificationFilter.js.map

package/dist/server/adapters/notificationFilter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"notificationFilter.js","sourceRoot":"","sources":["../../../src/server/adapters/notificationFilter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC,MAAM,UAAU,kBAAkB,CAAC,OAAmB;IACrD,IAAI,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAC9B,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;QAC5B,SAAS,CAAC,KAAa,EAAE,SAAS,EAAE,QAAQ;YAC3C,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC;YAC1C,OAAO,OAAO,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;gBAC5B,MAAM,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;gBAC1C,IAAI,OAAO,CAAC,MAAM,GAAG,MAAM,EAAE,CAAC;oBAC7B,MAAM;gBACP,CAAC;gBACD,IAAI,OAAO,CAAC,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC;oBACvB,OAAO,EAAE,CAAC;gBACX,CAAC;qBAAM,CAAC;oBACP,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;gBAC1C,CAAC;gBACD,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;YACpC,CAAC;YACD,QAAQ,EAAE,CAAC;QACZ,CAAC;KACD,CAAC,CAAC;IACH,OAAO,MAAM,CAAC;AACf,CAAC"}

package/dist/server/adapters/openDisconnectProxy.d.ts

@@ -0,0 +1,14 @@
+import type { DisconnectProxyOptions } from "#disconnectProxy.ts";
+export declare function openDisconnectProxy(destination: string, options: DisconnectProxyOptions): Promise<{
+    allHeld: Promise<void>;
+    close: () => Promise<void>;
+    disconnect: () => void;
+    disconnecting: Promise<void>;
+    dropped: Promise<void>;
+    openClients: () => number;
+    release: () => void;
+    setReachable: (value: boolean) => void;
+    setResponsive: (value: boolean) => void;
+    url: string;
+}>;
+//# sourceMappingURL=openDisconnectProxy.d.ts.map

package/dist/server/adapters/openDisconnectProxy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openDisconnectProxy.d.ts","sourceRoot":"","sources":["../../../src/server/adapters/openDisconnectProxy.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAGlE,wBAAsB,mBAAmB,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,sBAAsB;;;;;;;;0BAuFtE,OAAO;2BAMN,OAAO;;GAY/B"}

package/dist/server/adapters/openDisconnectProxy.js

@@ -0,0 +1,110 @@
+import { createConnection, createServer } from "node:net";
+import { notificationFilter } from "./notificationFilter.js";
+export async function openDisconnectProxy(destination, options) {
+    const target = new URL(destination);
+    const address = { host: target.hostname, port: Number(target.port || 5432) };
+    const sockets = new Set();
+    const clients = new Set();
+    const pending = new Set();
+    const disconnecting = Promise.withResolvers();
+    const allHeld = Promise.withResolvers();
+    const dropped = Promise.withResolvers();
+    let held = options.holdDisconnects === true;
+    let reachable = true;
+    let responsive = true;
+    let upstreams = 0;
+    function disconnect() {
+        for (const socket of sockets) {
+            socket.destroy();
+        }
+    }
+    function release() {
+        held = false;
+        for (const socket of pending) {
+            socket.end();
+        }
+    }
+    const server = createServer({ allowHalfOpen: true }, (client) => {
+        if (!reachable) {
+            client.destroy();
+            return;
+        }
+        const upstream = createConnection(address);
+        clients.add(client);
+        upstreams += 1;
+        for (const socket of [client, upstream]) {
+            sockets.add(socket);
+            socket.on("close", () => sockets.delete(socket));
+            socket.on("error", () => {
+                client.destroy();
+                upstream.destroy();
+            });
+        }
+        client.pipe(upstream, { end: false });
+        const incoming = options.dropNotifications === true ? upstream.pipe(notificationFilter(dropped.resolve)) : upstream;
+        incoming.pipe(client, { end: false });
+        client.on("end", () => {
+            clients.delete(client);
+            upstream.end();
+        });
+        client.on("close", () => clients.delete(client));
+        upstream.on("end", () => {
+            pending.add(client);
+            disconnecting.resolve();
+            if (pending.size === upstreams) {
+                allHeld.resolve();
+            }
+            if (!held) {
+                client.end();
+            }
+        });
+        if (!responsive) {
+            client.pause();
+            upstream.pause();
+        }
+    });
+    await new Promise((resolve, reject) => {
+        server.once("error", reject);
+        server.listen(0, "127.0.0.1", resolve);
+    });
+    const listening = server.address();
+    if (listening === null || typeof listening === "string") {
+        throw new Error("Expected a TCP listener");
+    }
+    target.hostname = "127.0.0.1";
+    target.port = String(listening.port);
+    if (options.dropNotifications === true) {
+        target.searchParams.set("sslmode", "disable");
+    }
+    return {
+        allHeld: allHeld.promise,
+        close: async () => {
+            disconnect();
+            await new Promise((resolve) => server.close(() => resolve()));
+        },
+        disconnect,
+        disconnecting: disconnecting.promise,
+        dropped: dropped.promise,
+        openClients: () => clients.size,
+        release,
+        setReachable: (value) => {
+            reachable = value;
+            if (!value) {
+                disconnect();
+            }
+        },
+        setResponsive: (value) => {
+            responsive = value;
+            for (const socket of sockets) {
+                if (value) {
+                    socket.resume();
+                }
+                else {
+                    socket.pause();
+                }
+            }
+        },
+        url: target.toString(),
+    };
+}
+//# sourceMappingURL=openDisconnectProxy.js.map

package/dist/server/adapters/openDisconnectProxy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openDisconnectProxy.js","sourceRoot":"","sources":["../../../src/server/adapters/openDisconnectProxy.ts"],"names":[],"mappings":"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"}

package/dist/server/disconnectProxy.d.ts

@@ -0,0 +1,18 @@
+import { Effect } from "effect";
+export interface DisconnectProxyOptions {
+    readonly dropNotifications?: boolean;
+    readonly holdDisconnects?: boolean;
+}
+export declare const disconnectProxy: (destination: string, options?: DisconnectProxyOptions | undefined) => Effect.Effect<{
+    allHeld: Promise<void>;
+    close: () => Promise<void>;
+    disconnect: () => void;
+    disconnecting: Promise<void>;
+    dropped: Promise<void>;
+    openClients: () => number;
+    release: () => void;
+    setReachable: (value: boolean) => void;
+    setResponsive: (value: boolean) => void;
+    url: string;
+}, never, import("effect/Scope").Scope>;
+//# sourceMappingURL=disconnectProxy.d.ts.map

package/dist/server/disconnectProxy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"disconnectProxy.d.ts","sourceRoot":"","sources":["../../src/server/disconnectProxy.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAGhC,MAAM,WAAW,sBAAsB;IACtC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,OAAO,CAAC;IACrC,QAAQ,CAAC,eAAe,CAAC,EAAE,OAAO,CAAC;CACnC;AAED,eAAO,MAAM,eAAe;;;;;;;;;;;uCAK1B,CAAC"}

package/dist/server/disconnectProxy.js

@@ -0,0 +1,6 @@
+import { Effect } from "effect";
+import { openDisconnectProxy } from "#adapters/openDisconnectProxy.ts";
+export const disconnectProxy = Effect.fnUntraced(function* (destination, options = {}) {
+    return yield* Effect.acquireRelease(Effect.promise(() => openDisconnectProxy(destination, options)), (proxy) => Effect.promise(proxy.close));
+});
+//# sourceMappingURL=disconnectProxy.js.map

package/dist/server/disconnectProxy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"disconnectProxy.js","sourceRoot":"","sources":["../../src/server/disconnectProxy.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAOvE,MAAM,CAAC,MAAM,eAAe,GAAG,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,WAAmB,EAAE,OAAO,GAA2B,EAAE;IACpH,OAAO,KAAK,CAAC,CAAC,MAAM,CAAC,cAAc,CAClC,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,mBAAmB,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC,EAC/D,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CACtC,CAAC;AACH,CAAC,CAAC,CAAC"}

package/dist/server/emptyPostgres.d.ts

@@ -0,0 +1,4 @@
+import { Migrator } from "effect/sql";
+export declare const databaseUrl: string | undefined;
+export declare const postgres: import("effect/Layer").Layer<import("@effect/sql-pg/PgClient").PgClient | import("./database.ts").PostgresTestDatabase | import("effect/reactivity/Reactivity").Reactivity | import("effect/sql/SqlClient").SqlClient, Migrator.MigrationError | import("effect/Schema").SchemaError | import("effect/sql/SqlError").SqlError, never>;
+//# sourceMappingURL=emptyPostgres.d.ts.map

package/dist/server/emptyPostgres.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"emptyPostgres.d.ts","sourceRoot":"","sources":["../../src/server/emptyPostgres.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAItC,eAAO,MAAM,WAAW,oBAAwD,CAAC;AACjF,eAAO,MAAM,QAAQ,uUAGnB,CAAC"}

package/dist/server/emptyPostgres.js

@@ -0,0 +1,10 @@
+import { Redacted } from "effect";
+import { Migrator } from "effect/sql";
+import { environmentVariable } from "#adapters/environmentVariable.ts";
+import { makePostgresTestLayer } from "#postgres.ts";
+export const databaseUrl = environmentVariable("PLATFORM_SQL_TEST_DATABASE_URL");
+export const postgres = makePostgresTestLayer({
+    migrations: { loader: Migrator.fromRecord({}), lockTimeout: "5 seconds" },
+    url: Redacted.make(databaseUrl ?? "postgresql://integration-tests-disabled"),
+});
+//# sourceMappingURL=emptyPostgres.js.map

package/dist/server/emptyPostgres.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"emptyPostgres.js","sourceRoot":"","sources":["../../src/server/emptyPostgres.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AAClC,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AACvE,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAErD,MAAM,CAAC,MAAM,WAAW,GAAG,mBAAmB,CAAC,gCAAgC,CAAC,CAAC;AACjF,MAAM,CAAC,MAAM,QAAQ,GAAG,qBAAqB,CAAC;IAC7C,UAAU,EAAE,EAAE,MAAM,EAAE,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,EAAE,WAAW,EAAE,WAAW,EAAE;IACzE,GAAG,EAAE,QAAQ,CAAC,IAAI,CAAC,WAAW,IAAI,yCAAyC,CAAC;CAC5E,CAAC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shivaedev/test-sql",
-  "version": "0.13.0",
+  "version": "0.14.0",
   "description": "PostgreSQL rollback and real-commit test isolation for Effect",
   "keywords": [
     "effect"
@@ -51,8 +51,8 @@
     "@shivaedev/jobs": "0.23.1",
     "@shivaedev/quality": "0.47.0",
     "@shivaedev/service": "0.6.0",
-    "@shivaedev/test": "0.11.0",
-    "@shivaedev/test-story": "0.25.1",
+    "@shivaedev/test": "0.12.0",
+    "@shivaedev/test-story": "0.26.0",
     "@types/node": "24.19.2",
     "effect": "4.0.6",
     "pg-boss": "12.38.0",

package/src/server/adapters/environmentVariable.ts

@@ -0,0 +1,5 @@
+import { Config, Effect, Option } from "effect";
+
+export function environmentVariable(name: string): string | undefined {
+	return Option.getOrUndefined(Effect.runSync(Config.option(Config.String(name))));
+}

package/src/server/adapters/notificationFilter.ts

@@ -0,0 +1,24 @@
+import { Transform } from "node:stream";
+
+export function notificationFilter(dropped: () => void) {
+	let pending = Buffer.alloc(0);
+	const filter = new Transform({
+		transform(chunk: Buffer, _encoding, callback) {
+			pending = Buffer.concat([pending, chunk]);
+			while (pending.length >= 5) {
+				const length = pending.readInt32BE(1) + 1;
+				if (pending.length < length) {
+					break;
+				}
+				if (pending[0] === 65) {
+					dropped();
+				} else {
+					filter.push(pending.subarray(0, length));
+				}
+				pending = pending.subarray(length);
+			}
+			callback();
+		},
+	});
+	return filter;
+}

package/src/server/adapters/openDisconnectProxy.ts

@@ -0,0 +1,110 @@
+import { createConnection, createServer, type Socket } from "node:net";
+import type { DisconnectProxyOptions } from "#disconnectProxy.ts";
+import { notificationFilter } from "./notificationFilter.ts";
+
+export async function openDisconnectProxy(destination: string, options: DisconnectProxyOptions) {
+	const target = new URL(destination);
+	const address = { host: target.hostname, port: Number(target.port || 5432) };
+	const sockets = new Set<Socket>();
+	const clients = new Set<Socket>();
+	const pending = new Set<Socket>();
+	const disconnecting = Promise.withResolvers<void>();
+	const allHeld = Promise.withResolvers<void>();
+	const dropped = Promise.withResolvers<void>();
+	let held = options.holdDisconnects === true;
+	let reachable = true;
+	let responsive = true;
+	let upstreams = 0;
+	function disconnect() {
+		for (const socket of sockets) {
+			socket.destroy();
+		}
+	}
+	function release() {
+		held = false;
+		for (const socket of pending) {
+			socket.end();
+		}
+	}
+	const server = createServer({ allowHalfOpen: true }, (client) => {
+		if (!reachable) {
+			client.destroy();
+			return;
+		}
+		const upstream = createConnection(address);
+		clients.add(client);
+		upstreams += 1;
+		for (const socket of [client, upstream]) {
+			sockets.add(socket);
+			socket.on("close", () => sockets.delete(socket));
+			socket.on("error", () => {
+				client.destroy();
+				upstream.destroy();
+			});
+		}
+		client.pipe(upstream, { end: false });
+		const incoming = options.dropNotifications === true ? upstream.pipe(notificationFilter(dropped.resolve)) : upstream;
+		incoming.pipe(client, { end: false });
+		client.on("end", () => {
+			clients.delete(client);
+			upstream.end();
+		});
+		client.on("close", () => clients.delete(client));
+		upstream.on("end", () => {
+			pending.add(client);
+			disconnecting.resolve();
+			if (pending.size === upstreams) {
+				allHeld.resolve();
+			}
+			if (!held) {
+				client.end();
+			}
+		});
+		if (!responsive) {
+			client.pause();
+			upstream.pause();
+		}
+	});
+	await new Promise<void>((resolve, reject) => {
+		server.once("error", reject);
+		server.listen(0, "127.0.0.1", resolve);
+	});
+	const listening = server.address();
+	if (listening === null || typeof listening === "string") {
+		throw new Error("Expected a TCP listener");
+	}
+	target.hostname = "127.0.0.1";
+	target.port = String(listening.port);
+	if (options.dropNotifications === true) {
+		target.searchParams.set("sslmode", "disable");
+	}
+	return {
+		allHeld: allHeld.promise,
+		close: async () => {
+			disconnect();
+			await new Promise<void>((resolve) => server.close(() => resolve()));
+		},
+		disconnect,
+		disconnecting: disconnecting.promise,
+		dropped: dropped.promise,
+		openClients: () => clients.size,
+		release,
+		setReachable: (value: boolean) => {
+			reachable = value;
+			if (!value) {
+				disconnect();
+			}
+		},
+		setResponsive: (value: boolean) => {
+			responsive = value;
+			for (const socket of sockets) {
+				if (value) {
+					socket.resume();
+				} else {
+					socket.pause();
+				}
+			}
+		},
+		url: target.toString(),
+	};
+}

package/src/server/disconnectProxy.ts

@@ -0,0 +1,14 @@
+import { Effect } from "effect";
+import { openDisconnectProxy } from "#adapters/openDisconnectProxy.ts";
+
+export interface DisconnectProxyOptions {
+	readonly dropNotifications?: boolean;
+	readonly holdDisconnects?: boolean;
+}
+
+export const disconnectProxy = Effect.fnUntraced(function* (destination: string, options: DisconnectProxyOptions = {}) {
+	return yield* Effect.acquireRelease(
+		Effect.promise(() => openDisconnectProxy(destination, options)),
+		(proxy) => Effect.promise(proxy.close),
+	);
+});

package/src/server/emptyPostgres.ts

@@ -0,0 +1,10 @@
+import { Redacted } from "effect";
+import { Migrator } from "effect/sql";
+import { environmentVariable } from "#adapters/environmentVariable.ts";
+import { makePostgresTestLayer } from "#postgres.ts";
+
+export const databaseUrl = environmentVariable("PLATFORM_SQL_TEST_DATABASE_URL");
+export const postgres = makePostgresTestLayer({
+	migrations: { loader: Migrator.fromRecord({}), lockTimeout: "5 seconds" },
+	url: Redacted.make(databaseUrl ?? "postgresql://integration-tests-disabled"),
+});