@shivaedev/local-postgres 0.7.0 → 0.8.0

package/dist/server/localDocker.js

@@ -1,16 +1,17 @@
-import { execFileSync } from "node:child_process";
-export function docker(environment, args, options = { encoding: "utf8" }) {
+import { Effect } from "effect";
+import { LocalPostgresError } from "#LocalPostgresError.ts";
+import { runCommand } from "#runCommand.ts";
+export const docker = Effect.fn("LocalPostgres.docker")(function* (environment, args, options = {}) {
     const context = environment.DOCKER_CONTEXT;
     const host = environment.DOCKER_HOST;
+    const settings = { ...options, env: { ...environment, ...options.env }, extendEnv: true };
     const endpoint = (!context && host)
-        || execFileSync("docker", ["context", "inspect", ...(context ? [context] : []), "--format", "{{.Endpoints.docker.Host}}"], {
-            encoding: "utf8",
-        }).trim();
-    const url = new URL(endpoint);
+        || (yield* runCommand("docker", ["context", "inspect", ...(context ? [context] : []), "--format", "{{.Endpoints.docker.Host}}"], settings));
+    const url = yield* Effect.try({ catch: () => new LocalPostgresError({ message: "Invalid Docker endpoint." }), try: () => new URL(endpoint) });
     if (!((["unix:", "npipe:"].includes(url.protocol) && ["", "localhost"].includes(url.hostname))
         || (url.protocol === "tcp:" && ["localhost", "127.0.0.1", "[::1]"].includes(url.hostname)))) {
-        throw new Error("Local database setup requires a local Docker endpoint; remote contexts are refused.");
+        return yield* new LocalPostgresError({ message: "Local database setup requires a local Docker endpoint; remote contexts are refused." });
     }
-    return execFileSync("docker", args, options);
-}
+    return yield* runCommand("docker", args, settings);
+});
 //# sourceMappingURL=localDocker.js.map

package/dist/server/localDocker.js.map

@@ -1 +1 @@
-{"version":3,"file":"localDocker.js","sourceRoot":"","sources":["../../src/server/localDocker.ts"],"names":[],"mappings":"AAAA,OAAO,EAA8C,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAI9F,MAAM,UAAU,MAAM,CACrB,WAA8B,EAC9B,IAAuB,EACvB,OAAO,GAA0C,EAAE,QAAQ,EAAE,MAAM,EAAE;IAErE,MAAM,OAAO,GAAG,WAAW,CAAC,cAAc,CAAC;IAC3C,MAAM,IAAI,GAAG,WAAW,CAAC,WAAW,CAAC;IACrC,MAAM,QAAQ,GACb,CAAC,CAAC,OAAO,IAAI,IAAI,CAAC;WACf,YAAY,CAAC,QAAQ,EAAE,CAAC,SAAS,EAAE,SAAS,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,UAAU,EAAE,4BAA4B,CAAC,EAAE;YAC1H,QAAQ,EAAE,MAAM;SAChB,CAAC,CAAC,IAAI,EAAE,CAAC;IACX,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,CAAC;IAC9B,IACC,CAAC,CACA,CAAC,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,EAAE,WAAW,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;WACrF,CAAC,GAAG,CAAC,QAAQ,KAAK,MAAM,IAAI,CAAC,WAAW,EAAE,WAAW,EAAE,OAAO,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAC1F,EACA,CAAC;QACF,MAAM,IAAI,KAAK,CAAC,qFAAqF,CAAC,CAAC;IACxG,CAAC;IACD,OAAO,YAAY,CAAC,QAAQ,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;AAC9C,CAAC"}
+{"version":3,"file":"localDocker.js","sourceRoot":"","sources":["../../src/server/localDocker.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,EAAuB,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAIjE,MAAM,CAAC,MAAM,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC,sBAAsB,CAAC,CAAC,QAAQ,CAAC,EAChE,WAA8B,EAC9B,IAAuB,EACvB,OAAO,GAAmB,EAAE;IAE5B,MAAM,OAAO,GAAG,WAAW,CAAC,cAAc,CAAC;IAC3C,MAAM,IAAI,GAAG,WAAW,CAAC,WAAW,CAAC;IACrC,MAAM,QAAQ,GAAG,EAAE,GAAG,OAAO,EAAE,GAAG,EAAE,EAAE,GAAG,WAAW,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;IAC1F,MAAM,QAAQ,GACb,CAAC,CAAC,OAAO,IAAI,IAAI,CAAC;WACf,CAAC,KAAK,CAAC,CAAC,UAAU,CAAC,QAAQ,EAAE,CAAC,SAAS,EAAE,SAAS,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,UAAU,EAAE,4BAA4B,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC;IAC7I,MAAM,GAAG,GAAG,KAAK,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,IAAI,kBAAkB,CAAC,EAAE,OAAO,EAAE,0BAA0B,EAAE,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IAC9I,IACC,CAAC,CACA,CAAC,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,EAAE,WAAW,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;WACrF,CAAC,GAAG,CAAC,QAAQ,KAAK,MAAM,IAAI,CAAC,WAAW,EAAE,WAAW,EAAE,OAAO,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAC1F,EACA,CAAC;QACF,OAAO,KAAK,CAAC,CAAC,IAAI,kBAAkB,CAAC,EAAE,OAAO,EAAE,qFAAqF,EAAE,CAAC,CAAC;IAC1I,CAAC;IACD,OAAO,KAAK,CAAC,CAAC,UAAU,CAAC,QAAQ,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC;AACpD,CAAC,CAAC,CAAC"}

package/dist/server/localPostgres.d.ts

@@ -1,13 +1,16 @@
-import { type DockerEnvironment } from "./localDocker.ts";
+import { Effect } from "effect";
+import { LocalPostgresError } from "#LocalPostgresError.ts";
+import { type DockerEnvironment } from "#localDocker.ts";
+import { PostgresVersionMismatch } from "#PostgresVersionMismatch.ts";
 export declare const LOCAL_SERVER = "postgresql://postgres:postgres@127.0.0.1:55432";
-export declare function assertLocalDatabase(value: string, names: readonly string[]): import("url").URL;
+export declare const assertLocalDatabase: (value: string, names: readonly string[]) => Effect.Effect<import("url").URL, LocalPostgresError, never>;
 export interface ReadinessOptions {
     readonly attempts?: number;
     readonly delayMillis?: number;
 }
 export declare function localPostgres(environment: DockerEnvironment, { attempts, delayMillis }?: ReadinessOptions): {
-    prepareDatabases: (values: readonly string[]) => void;
-    sql: (value: string | URL, query: string) => string;
-    startPostgres: (connection?: string) => void;
+    prepareDatabases: (values: readonly string[]) => Effect.Effect<undefined, LocalPostgresError | import("./PostgresCommandError.ts").PostgresCommandError | import("#localConnections.ts").PostgresSettingError | PostgresVersionMismatch, import("effect/process/ChildProcessSpawner").ChildProcessSpawner>;
+    sql: (value: string | URL, query: string) => Effect.Effect<string, LocalPostgresError | import("./PostgresCommandError.ts").PostgresCommandError, import("effect/process/ChildProcessSpawner").ChildProcessSpawner>;
+    startPostgres: (connection?: any) => Effect.Effect<void, LocalPostgresError | import("./PostgresCommandError.ts").PostgresCommandError | import("#localConnections.ts").PostgresSettingError | PostgresVersionMismatch, import("effect/process/ChildProcessSpawner").ChildProcessSpawner>;
 };
 //# sourceMappingURL=localPostgres.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"localPostgres.d.ts","sourceRoot":"","sources":["../../src/server/localPostgres.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,iBAAiB,EAAU,MAAM,kBAAkB,CAAC;AAGlE,eAAO,MAAM,YAAY,mDAAmD,CAAC;AAE7E,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,MAAM,EAAE,qBAY1E;AAQD,MAAM,WAAW,gBAAgB;IAChC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,wBAAgB,aAAa,CAAC,WAAW,EAAE,iBAAiB,EAAE,EAAE,QAAa,EAAE,WAAkB,EAAE,GAAE,gBAAqB;+BAmEvF,SAAS,MAAM,EAAE;iBA/D/B,MAAM,GAAG,GAAG,SAAS,MAAM;;EAmF/C"}
+{"version":3,"file":"localPostgres.d.ts","sourceRoot":"","sources":["../../src/server/localPostgres.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAY,MAAM,QAAQ,CAAC;AAE1C,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAG5D,OAAO,EAAE,KAAK,iBAAiB,EAAU,MAAM,iBAAiB,CAAC;AACjE,OAAO,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AAGtE,eAAO,MAAM,YAAY,mDAAmD,CAAC;AAE7E,eAAO,MAAM,mBAAmB,0GAY9B,CAAC;AAEH,MAAM,WAAW,gBAAgB;IAChC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,wBAAgB,aAAa,CAAC,WAAW,EAAE,iBAAiB,EAAE,EAAE,QAAa,EAAE,WAAkB,EAAE,GAAE,gBAAqB;;;;EAqDzH"}

package/dist/server/localPostgres.js

@@ -1,108 +1,77 @@
-import { execFileSync } from "node:child_process";
-import { env } from "node:process";
-import { ensureConnections } from "./localConnections.js";
-import { sqlInContainer, startContainer } from "./localContainer.js";
-import { docker } from "./localDocker.js";
-import { PostgresVersionMismatch } from "./PostgresVersionMismatch.js";
+import { Effect, Schedule } from "effect";
+import { clientConnection } from "#clientConnection.ts";
+import { LocalPostgresError } from "#LocalPostgresError.ts";
+import { ensureConnections } from "#localConnections.ts";
+import { sqlInContainer, startContainer } from "#localContainer.ts";
+import { docker } from "#localDocker.ts";
+import { PostgresVersionMismatch } from "#PostgresVersionMismatch.ts";
+import { missingCommand, runCommand } from "#runCommand.ts";
 export const LOCAL_SERVER = "postgresql://postgres:postgres@127.0.0.1:55432";
-export function assertLocalDatabase(value, names) {
-    const url = new URL(value);
-    const name = url.pathname.slice(1);
+export const assertLocalDatabase = Effect.fn("LocalPostgres.assertLocalDatabase")(function* (value, names) {
+    const message = `Use a local database on 127.0.0.1:55432 named ${names.join(" or ")}.`;
+    const url = yield* Effect.try({ catch: () => new LocalPostgresError({ message }), try: () => new URL(value) });
     if (!(["postgres:", "postgresql:"].includes(url.protocol) && ["localhost", "127.0.0.1"].includes(url.hostname))
         || url.port !== "55432"
         || ["host", "hostaddr", "port", "dbname", "service"].some((key) => url.searchParams.has(key))
-        || !names.includes(name)) {
-        throw new Error(`Use a local database on 127.0.0.1:55432 named ${names.join(" or ")}.`);
+        || !names.includes(url.pathname.slice(1))) {
+        return yield* new LocalPostgresError({ message });
     }
     return url;
-}
-function clientEnvironment(url) {
-    // libpq treats + literally in URI passwords.
-    const password = new URLSearchParams(url.search.replaceAll("+", "%2B")).getAll("password").at(-1) ?? decodeURIComponent(url.password);
-    return { ...env, ...(password && { "PGPASSWORD": password }) };
-}
+});
 export function localPostgres(environment, { attempts = 30, delayMillis = 1000 } = {}) {
-    function localDocker(args, options = { encoding: "utf8" }) {
+    function localDocker(args, options) {
         return docker(environment, args, options);
     }
-    function sql(value, query) {
-        const url = new URL(value);
-        assertLocalDatabase(url.toString(), [url.pathname.slice(1)]);
-        const childEnvironment = clientEnvironment(url);
-        url.password = "";
-        url.searchParams.delete("password");
-        for (const key of ["schema", "connection_limit", "pool_timeout", "pgbouncer"]) {
-            url.searchParams.delete(key);
-        }
-        const args = ["-X", "--set", "ON_ERROR_STOP=1", "-At", "-c", query];
-        if (!url.searchParams.has("connect_timeout")) {
-            url.searchParams.set("connect_timeout", "3");
-        }
-        const options = {
-            encoding: "utf8",
-            env: childEnvironment,
-            stdio: ["ignore", "pipe", "pipe"],
-        };
-        try {
-            return execFileSync("psql", [...args, "--dbname", url.toString()], options).trim();
-        }
-        catch (error) {
-            if (error instanceof Error && "code" in error && error.code === "ENOENT") {
-                return sqlInContainer(localDocker, url, args, options);
-            }
-            throw new Error(error instanceof Error && "stderr" in error ? String(error.stderr) : "PostgreSQL query failed.", { cause: error });
-        }
-    }
-    function startPostgres(connection = LOCAL_SERVER) {
-        const server = new URL(connection);
+    const sql = localSql(localDocker);
+    const startPostgres = Effect.fn("LocalPostgres.startPostgres")(function* (connection = LOCAL_SERVER) {
+        const server = yield* Effect.try({
+            catch: () => new LocalPostgresError({ message: "Invalid local database URL." }),
+            try: () => new URL(connection),
+        });
         server.pathname = "/postgres";
-        assertLocalDatabase(server.toString(), ["postgres"]);
+        yield* assertLocalDatabase(server.toString(), ["postgres"]);
         function waitForVersion() {
-            for (let attempt = 0; attempt < attempts; attempt += 1) {
-                try {
-                    return sql(server, "SHOW server_version");
-                }
-                catch {
-                    Atomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, delayMillis);
-                }
-            }
-            return undefined;
+            return sql(server, "SHOW server_version").pipe(Effect.retry({ schedule: Schedule.spaced(delayMillis), times: attempts - 1 }));
         }
         function confirmVersion(observed) {
-            if (observed !== "18.6") {
-                throw new PostgresVersionMismatch(observed);
-            }
-        }
-        let version;
-        try {
-            version = sql(server, "SHOW server_version");
+            return observed === "18.6" ? Effect.void : Effect.fail(new PostgresVersionMismatch({ expectedVersion: "18.6", observedVersion: observed }));
         }
-        catch {
-            startContainer(localDocker);
-            version = waitForVersion();
-        }
-        confirmVersion(version);
-        ensureConnections(localDocker, (query) => sql(server, query), () => confirmVersion(waitForVersion()));
-    }
-    function prepareDatabases(values) {
+        const version = yield* sql(server, "SHOW server_version").pipe(Effect.catchTag("PostgresCommandError", () => Effect.andThen(startContainer(localDocker), waitForVersion)));
+        yield* confirmVersion(version);
+        yield* ensureConnections(localDocker, (query) => sql(server, query), () => Effect.flatMap(waitForVersion(), confirmVersion));
+    });
+    const prepareDatabases = Effect.fn("LocalPostgres.prepareDatabases")(function* (values) {
+        const urls = [];
         for (const value of values) {
-            const name = new URL(value).pathname.slice(1);
-            assertLocalDatabase(value, [name]);
+            const parsed = yield* Effect.try({
+                catch: () => new LocalPostgresError({ message: "Invalid local database URL." }),
+                try: () => new URL(value),
+            });
+            const name = parsed.pathname.slice(1);
+            const url = yield* assertLocalDatabase(value, [name]);
             if (!/^[a-z][a-z0-9_]{0,62}$/u.test(name)) {
-                throw new Error("Invalid local database name.");
+                return yield* new LocalPostgresError({ message: "Invalid local database name." });
             }
+            urls.push(url);
         }
-        startPostgres(values[0]);
-        for (const value of values) {
-            const url = new URL(value);
+        yield* startPostgres(values[0]);
+        for (const url of urls) {
             const name = url.pathname.slice(1);
             const server = new URL(url);
             server.pathname = "/postgres";
-            if (!sql(server, `SELECT 1 FROM pg_database WHERE datname = '${name}'`)) {
-                sql(server, `CREATE DATABASE "${name}"`);
+            if (!(yield* sql(server, `SELECT 1 FROM pg_database WHERE datname = '${name}'`))) {
+                yield* sql(server, `CREATE DATABASE "${name}"`);
             }
         }
-    }
+    });
     return { prepareDatabases, sql, startPostgres };
 }
+function localSql(localDocker) {
+    return Effect.fn("LocalPostgres.sql")(function* (value, query) {
+        const parsed = yield* Effect.try({ catch: () => new LocalPostgresError({ message: "Invalid local database URL." }), try: () => new URL(value) });
+        const { url, options } = clientConnection(yield* assertLocalDatabase(parsed.toString(), [parsed.pathname.slice(1)]));
+        const args = ["-X", "--set", "ON_ERROR_STOP=1", "-At", "-c", query];
+        return yield* runCommand("psql", [...args, "--dbname", url.toString()], options).pipe(Effect.catchTag("PostgresCommandError", (error) => missingCommand(error) ? sqlInContainer(localDocker, url, args, options) : Effect.fail(error)));
+    });
+}
 //# sourceMappingURL=localPostgres.js.map

package/dist/server/localPostgres.js.map

@@ -1 +1 @@
-{"version":3,"file":"localPostgres.js","sourceRoot":"","sources":["../../src/server/localPostgres.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"localPostgres.js","sourceRoot":"","sources":["../../src/server/localPostgres.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AAC1C,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpE,OAAO,EAA0B,MAAM,EAAE,MAAM,iBAAiB,CAAC;AACjE,OAAO,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AACtE,OAAO,EAAuB,cAAc,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAEjF,MAAM,CAAC,MAAM,YAAY,GAAG,gDAAgD,CAAC;AAE7E,MAAM,CAAC,MAAM,mBAAmB,GAAG,MAAM,CAAC,EAAE,CAAC,mCAAmC,CAAC,CAAC,QAAQ,CAAC,EAAE,KAAa,EAAE,KAAwB;IACnI,MAAM,OAAO,GAAG,iDAAiD,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC;IACvF,MAAM,GAAG,GAAG,KAAK,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,IAAI,kBAAkB,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,IAAI,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAC/G,IACC,CAAC,CAAC,CAAC,WAAW,EAAE,aAAa,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;WACxG,GAAG,CAAC,IAAI,KAAK,OAAO;WACpB,CAAC,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;WAC1F,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EACxC,CAAC;QACF,OAAO,KAAK,CAAC,CAAC,IAAI,kBAAkB,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC;IACnD,CAAC;IACD,OAAO,GAAG,CAAC;AACZ,CAAC,CAAC,CAAC;AAOH,MAAM,UAAU,aAAa,CAAC,WAA8B,EAAE,EAAE,QAAQ,GAAG,EAAE,EAAE,WAAW,GAAG,IAAI,EAAE,GAAqB,EAAE;IACzH,SAAS,WAAW,CAAC,IAAuB,EAAE,OAAwB;QACrE,OAAO,MAAM,CAAC,WAAW,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IAC3C,CAAC;IACD,MAAM,GAAG,GAAG,QAAQ,CAAC,WAAW,CAAC,CAAC;IAClC,MAAM,aAAa,GAAG,MAAM,CAAC,EAAE,CAAC,6BAA6B,CAAC,CAAC,QAAQ,CAAC,EAAE,UAAU,GAAG,YAAY;QAClG,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;YAChC,KAAK,EAAE,GAAG,EAAE,CAAC,IAAI,kBAAkB,CAAC,EAAE,OAAO,EAAE,6BAA6B,EAAE,CAAC;YAC/E,GAAG,EAAE,GAAG,EAAE,CAAC,IAAI,GAAG,CAAC,UAAU,CAAC;SAC9B,CAAC,CAAC;QACH,MAAM,CAAC,QAAQ,GAAG,WAAW,CAAC;QAC9B,KAAK,CAAC,CAAC,mBAAmB,CAAC,MAAM,CAAC,QAAQ,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC;QAC5D,SAAS,cAAc;YACtB,OAAO,GAAG,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,WAAW,CAAC,EAAE,KAAK,EAAE,QAAQ,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;QAC/H,CAAC;QACD,SAAS,cAAc,CAAC,QAAgB;YACvC,OAAO,QAAQ,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,uBAAuB,CAAC,EAAE,eAAe,EAAE,MAAM,EAAE,eAAe,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC;QAC7I,CAAC;QACD,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,GAAG,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC,IAAI,CAC7D,MAAM,CAAC,QAAQ,CAAC,sBAAsB,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,cAAc,CAAC,WAAW,CAAC,EAAE,cAAc,CAAC,CAAC,CAC1G,CAAC;QACF,KAAK,CAAC,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;QAC/B,KAAK,CAAC,CAAC,iBAAiB,CACvB,WAAW,EACX,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,EAC7B,GAAG,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,cAAc,EAAE,EAAE,cAAc,CAAC,CACtD,CAAC;IACH,CAAC,CAAC,CAAC;IACH,MAAM,gBAAgB,GAAG,MAAM,CAAC,EAAE,CAAC,gCAAgC,CAAC,CAAC,QAAQ,CAAC,EAAE,MAAyB;QACxG,MAAM,IAAI,GAAU,EAAE,CAAC;QACvB,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC5B,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;gBAChC,KAAK,EAAE,GAAG,EAAE,CAAC,IAAI,kBAAkB,CAAC,EAAE,OAAO,EAAE,6BAA6B,EAAE,CAAC;gBAC/E,GAAG,EAAE,GAAG,EAAE,CAAC,IAAI,GAAG,CAAC,KAAK,CAAC;aACzB,CAAC,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YACtC,MAAM,GAAG,GAAG,KAAK,CAAC,CAAC,mBAAmB,CAAC,KAAK,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;YACtD,IAAI,CAAC,yBAAyB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC3C,OAAO,KAAK,CAAC,CAAC,IAAI,kBAAkB,CAAC,EAAE,OAAO,EAAE,8BAA8B,EAAE,CAAC,CAAC;YACnF,CAAC;YACD,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAChB,CAAC;QACD,KAAK,CAAC,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;QAChC,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACxB,MAAM,IAAI,GAAG,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YACnC,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;YAC5B,MAAM,CAAC,QAAQ,GAAG,WAAW,CAAC;YAC9B,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,MAAM,EAAE,8CAA8C,IAAI,GAAG,CAAC,CAAC,EAAE,CAAC;gBAClF,KAAK,CAAC,CAAC,GAAG,CAAC,MAAM,EAAE,oBAAoB,IAAI,GAAG,CAAC,CAAC;YACjD,CAAC;QACF,CAAC;IACF,CAAC,CAAC,CAAC;IACH,OAAO,EAAE,gBAAgB,EAAE,GAAG,EAAE,aAAa,EAAE,CAAC;AACjD,CAAC;AAED,SAAS,QAAQ,CAAC,WAA6F;IAC9G,OAAO,MAAM,CAAC,EAAE,CAAC,mBAAmB,CAAC,CAAC,QAAQ,CAAC,EAAE,KAAmB,EAAE,KAAa;QAClF,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,IAAI,kBAAkB,CAAC,EAAE,OAAO,EAAE,6BAA6B,EAAE,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,IAAI,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACjJ,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC,mBAAmB,CAAC,MAAM,CAAC,QAAQ,EAAE,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACrH,MAAM,IAAI,GAAG,CAAC,IAAI,EAAE,OAAO,EAAE,iBAAiB,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;QACpE,OAAO,KAAK,CAAC,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC,GAAG,IAAI,EAAE,UAAU,EAAE,GAAG,CAAC,QAAQ,EAAE,CAAC,EAAE,OAAO,CAAC,CAAC,IAAI,CACpF,MAAM,CAAC,QAAQ,CAAC,sBAAsB,EAAE,CAAC,KAAK,EAAE,EAAE,CACjD,cAAc,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,WAAW,EAAE,GAAG,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAC5F,CACD,CAAC;IACH,CAAC,CAAC,CAAC;AACJ,CAAC"}

package/dist/server/runCommand.d.ts

@@ -0,0 +1,7 @@
+import { Effect } from "effect";
+import { ChildProcess, ChildProcessSpawner } from "effect/process";
+import { PostgresCommandError } from "#PostgresCommandError.ts";
+export type CommandOptions = Pick<ChildProcess.CommandOptions, "env" | "extendEnv">;
+export declare const runCommand: (command: string, args: readonly string[], options?: CommandOptions | undefined) => Effect.Effect<string, PostgresCommandError, ChildProcessSpawner.ChildProcessSpawner>;
+export declare function missingCommand(error: PostgresCommandError): boolean;
+//# sourceMappingURL=runCommand.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"runCommand.d.ts","sourceRoot":"","sources":["../../src/server/runCommand.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAyB,MAAM,QAAQ,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAEhE,MAAM,MAAM,cAAc,GAAG,IAAI,CAAC,YAAY,CAAC,cAAc,EAAE,KAAK,GAAG,WAAW,CAAC,CAAC;AAEpF,eAAO,MAAM,UAAU,0KAoBrB,CAAC;AAEH,wBAAgB,cAAc,CAAC,KAAK,EAAE,oBAAoB,WAEzD"}

package/dist/server/runCommand.js

@@ -0,0 +1,23 @@
+import { Effect, PlatformError, Stream } from "effect";
+import { ChildProcess, ChildProcessSpawner } from "effect/process";
+import { PostgresCommandError } from "#PostgresCommandError.ts";
+export const runCommand = Effect.fn("LocalPostgres.runCommand")(function* (command, args, options = {}) {
+    const label = command === "docker" ? `docker ${args[0] ?? ""}`.trim() : command;
+    return yield* Effect.scoped(Effect.gen(function* () {
+        const spawner = yield* ChildProcessSpawner.ChildProcessSpawner;
+        const child = yield* spawner.spawn(ChildProcess.make(command, args, { ...options, stdin: "ignore" }));
+        const [stdout, stderr, code] = yield* Effect.all([Stream.mkString(Stream.decodeText(child.stdout)), Stream.mkString(Stream.decodeText(child.stderr)), child.exitCode], { concurrency: "unbounded" });
+        if (code !== 0) {
+            return yield* new PostgresCommandError({
+                command: label,
+                exitCode: Number(code),
+                message: stderr.trim() || `${command} exited with code ${code}.`,
+            });
+        }
+        return stdout.trim();
+    })).pipe(Effect.catchTag("PlatformError", (cause) => Effect.fail(new PostgresCommandError({ cause, command: label, message: cause.message }))));
+});
+export function missingCommand(error) {
+    return error.cause instanceof PlatformError.PlatformError && error.cause.reason._tag === "NotFound";
+}
+//# sourceMappingURL=runCommand.js.map

package/dist/server/runCommand.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runCommand.js","sourceRoot":"","sources":["../../src/server/runCommand.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAIhE,MAAM,CAAC,MAAM,UAAU,GAAG,MAAM,CAAC,EAAE,CAAC,0BAA0B,CAAC,CAAC,QAAQ,CAAC,EAAE,OAAe,EAAE,IAAuB,EAAE,OAAO,GAAmB,EAAE;IAChJ,MAAM,KAAK,GAAG,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,UAAU,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;IAChF,OAAO,KAAK,CAAC,CAAC,MAAM,CAAC,MAAM,CAC1B,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;QACnB,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,mBAAmB,CAAC,mBAAmB,CAAC;QAC/D,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE,GAAG,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC;QACtG,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,GAAG,KAAK,CAAC,CAAC,MAAM,CAAC,GAAG,CAC/C,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,EAAE,KAAK,CAAC,QAAQ,CAAC,EACpH,EAAE,WAAW,EAAE,WAAW,EAAE,CAC5B,CAAC;QACF,IAAI,IAAI,KAAK,CAAC,EAAE,CAAC;YAChB,OAAO,KAAK,CAAC,CAAC,IAAI,oBAAoB,CAAC;gBACtC,OAAO,EAAE,KAAK;gBACd,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC;gBACtB,OAAO,EAAE,MAAM,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,qBAAqB,IAAI,GAAG;aAChE,CAAC,CAAC;QACJ,CAAC;QACD,OAAO,MAAM,CAAC,IAAI,EAAE,CAAC;IACtB,CAAC,CAAC,CACF,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,eAAe,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,oBAAoB,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;AAC/I,CAAC,CAAC,CAAC;AAEH,MAAM,UAAU,cAAc,CAAC,KAA2B;IACzD,OAAO,KAAK,CAAC,KAAK,YAAY,aAAa,CAAC,aAAa,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,KAAK,UAAU,CAAC;AACrG,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shivaedev/local-postgres",
-  "version": "0.7.0",
+  "version": "0.8.0",
   "description": "Repeatable local PostgreSQL preparation with one shared persistent service",
   "homepage": "https://github.com/ShivaeDev/platform/tree/main/packages/local-postgres#readme",
   "bugs": {
@@ -40,13 +40,17 @@
     "README.md"
   ],
   "devDependencies": {
-    "@shivaedev/quality": "0.35.0",
-    "@shivaedev/test-story": "0.18.2",
+    "@effect/platform-node": "4.0.6",
+    "@shivaedev/quality": "0.48.2",
+    "@shivaedev/test-story": "0.28.0",
     "@types/node": "24.19.2",
-    "effect": "4.0.5",
+    "effect": "4.0.6",
     "typescript": "7.0.2",
     "vitest": "5.0.5"
   },
+  "peerDependencies": {
+    "effect": "4.0.6"
+  },
   "engines": {
     "node": ">=24"
   },

package/src/server/LocalPostgresError.ts

@@ -0,0 +1,5 @@
+import { Schema } from "effect";
+
+export class LocalPostgresError extends Schema.TaggedError<LocalPostgresError>()("LocalPostgresError", {
+	message: Schema.String,
+}) {}

package/src/server/PostgresCommandError.ts

@@ -0,0 +1,8 @@
+import { Schema } from "effect";
+
+export class PostgresCommandError extends Schema.TaggedError<PostgresCommandError>()("PostgresCommandError", {
+	cause: Schema.optional(Schema.Unknown),
+	command: Schema.String,
+	exitCode: Schema.optional(Schema.Number),
+	message: Schema.String,
+}) {}

package/src/server/PostgresVersionMismatch.ts

@@ -1,10 +1,10 @@
-export class PostgresVersionMismatch extends Error {
-	readonly _tag = "PostgresVersionMismatch";
-	readonly expectedVersion = "18.6";
-	readonly observedVersion: string | undefined;
+import { Schema } from "effect";
 
-	constructor(observedVersion: string | undefined) {
-		super("Expected local PostgreSQL 18.6. Check the existing service; setup never removes containers or data.");
-		this.observedVersion = observedVersion;
+export class PostgresVersionMismatch extends Schema.TaggedError<PostgresVersionMismatch>()("PostgresVersionMismatch", {
+	expectedVersion: Schema.Literal("18.6"),
+	observedVersion: Schema.String,
+}) {
+	override get message() {
+		return "Expected local PostgreSQL 18.6. Check the existing service; setup never removes containers or data.";
 	}
 }

package/src/server/clientConnection.ts

@@ -0,0 +1,15 @@
+import type { CommandOptions } from "#runCommand.ts";
+
+export function clientConnection(value: URL, options: CommandOptions = {}) {
+	const url = new URL(value);
+	// libpq treats + literally in URI passwords.
+	const password = new URLSearchParams(url.search.replaceAll("+", "%2B")).getAll("password").at(-1) ?? decodeURIComponent(url.password);
+	url.password = "";
+	for (const key of ["password", "schema", "connection_limit", "pool_timeout", "pgbouncer"]) {
+		url.searchParams.delete(key);
+	}
+	if (!url.searchParams.has("connect_timeout")) {
+		url.searchParams.set("connect_timeout", "3");
+	}
+	return { options: { ...options, env: { ...options.env, ...(password && { "PGPASSWORD": password }) }, extendEnv: true }, url };
+}

package/src/server/localConnections.ts

@@ -1,35 +1,46 @@
-import { POSTGRES_IMAGE } from "./localContainer.ts";
+import { Effect, Schema } from "effect";
+import type { ChildProcessSpawner } from "effect/process";
+import { LocalPostgresError } from "#LocalPostgresError.ts";
+import { POSTGRES_IMAGE } from "#localContainer.ts";
+import type { docker as localDocker } from "#localDocker.ts";
+import type { PostgresCommandError } from "#PostgresCommandError.ts";
+import type { PostgresVersionMismatch } from "#PostgresVersionMismatch.ts";
 
-export class PostgresSettingError extends Error {
-	readonly _tag = "PostgresSettingError";
-	readonly container = "development-postgres";
-	readonly setting = "max_connections";
-
-	constructor(message: string, options: ErrorOptions) {
-		super(message, options);
-		this.name = "PostgresSettingError";
+export class PostgresSettingError extends Schema.TaggedError<PostgresSettingError>()("PostgresSettingError", {
+	cause: Schema.Unknown,
+	container: Schema.Literal("development-postgres"),
+	setting: Schema.Literal("max_connections"),
+}) {
+	override get message() {
+		return "Could not set max_connections to at least 500 in container development-postgres.";
 	}
 }
 
-export function ensureConnections(docker: (args: readonly string[]) => string, sql: (query: string) => string, ready: () => void) {
-	try {
-		const current = Number(sql("SHOW max_connections"));
+type Query = (query: string) => Effect.Effect<string, LocalPostgresError | PostgresCommandError, ChildProcessSpawner.ChildProcessSpawner>;
+
+export const ensureConnections = Effect.fn("LocalPostgres.ensureConnections")(function* (
+	docker: (args: readonly string[]) => ReturnType<typeof localDocker>,
+	sql: Query,
+	ready: () => Effect.Effect<void, LocalPostgresError | PostgresCommandError | PostgresVersionMismatch, ChildProcessSpawner.ChildProcessSpawner>,
+) {
+	yield* Effect.gen(function* () {
+		const current = Number(yield* sql("SHOW max_connections"));
 		if (!Number.isInteger(current) || current <= 0) {
-			throw new Error("PostgreSQL returned an invalid max_connections value.");
+			return yield* new LocalPostgresError({ message: "PostgreSQL returned an invalid max_connections value." });
 		}
 		if (current >= 500) {
 			return;
 		}
-		if (docker(["inspect", "--format", "{{.Config.Image}}", "development-postgres"]).trim() !== POSTGRES_IMAGE) {
-			throw new Error("The shared PostgreSQL container uses a different image. Preserve its data and upgrade it explicitly.");
+		if ((yield* docker(["inspect", "--format", "{{.Config.Image}}", "development-postgres"])) !== POSTGRES_IMAGE) {
+			return yield* new LocalPostgresError({
+				message: "The shared PostgreSQL container uses a different image. Preserve its data and upgrade it explicitly.",
+			});
 		}
-		sql("ALTER SYSTEM SET max_connections = 500");
-		docker(["restart", "development-postgres"]);
-		ready();
-		if (!(Number(sql("SHOW max_connections")) >= 500)) {
-			throw new Error("PostgreSQL did not apply max_connections after restarting.");
+		yield* sql("ALTER SYSTEM SET max_connections = 500");
+		yield* docker(["restart", "development-postgres"]);
+		yield* ready();
+		if (!(Number(yield* sql("SHOW max_connections")) >= 500)) {
+			return yield* new LocalPostgresError({ message: "PostgreSQL did not apply max_connections after restarting." });
 		}
-	} catch (cause) {
-		throw new PostgresSettingError("Could not set max_connections to at least 500 in container development-postgres.", { cause });
-	}
-}
+	}).pipe(Effect.mapError((cause) => new PostgresSettingError({ cause, container: "development-postgres", setting: "max_connections" })));
+});

package/src/server/localContainer.ts

@@ -1,51 +1,47 @@
-import type { ExecFileSyncOptionsWithStringEncoding } from "node:child_process";
-import { env } from "node:process";
+import { Effect } from "effect";
+import { clientConnection } from "#clientConnection.ts";
+import { LocalPostgresError } from "#LocalPostgresError.ts";
+import type { docker as runDocker } from "#localDocker.ts";
+import { PostgresCommandError } from "#PostgresCommandError.ts";
+import type { CommandOptions } from "#runCommand.ts";
 
 export const POSTGRES_IMAGE = "postgres:18.6-alpine@sha256:77f585114c32fbca283dc835b0596f4e52b51b4c6662d7810b2f4084f60a1873";
 const CONTAINER = "development-postgres";
-type Docker = (args: readonly string[], options?: ExecFileSyncOptionsWithStringEncoding) => string;
+type Docker = (args: readonly string[], options?: CommandOptions) => ReturnType<typeof runDocker>;
 
-export function sqlInContainer(docker: Docker, url: URL, args: readonly string[], options: ExecFileSyncOptionsWithStringEncoding) {
-	const id = docker(["ps", "--filter", "publish=55432", "--format", "{{.ID}}"], options).trim();
+export const sqlInContainer = Effect.fn("LocalPostgres.sqlInContainer")(function* (
+	docker: Docker,
+	url: URL,
+	args: readonly string[],
+	options: CommandOptions,
+) {
+	const id = yield* docker(["ps", "--filter", "publish=55432", "--format", "{{.ID}}"], options);
 	if (!id || id.includes("\n")) {
-		throw new Error("Install psql or start the shared PostgreSQL service with Docker.");
+		return yield* new PostgresCommandError({ command: "psql", message: "Install psql or start the shared PostgreSQL service with Docker." });
 	}
-	if (docker(["inspect", "--format", "{{.Config.Image}}", id], options).trim() !== POSTGRES_IMAGE) {
-		throw new Error("The shared PostgreSQL image differs from the pinned baseline. Upgrade explicitly, preserving data.");
+	if ((yield* docker(["inspect", "--format", "{{.Config.Image}}", id], options)) !== POSTGRES_IMAGE) {
+		return yield* new LocalPostgresError({
+			message: "The shared PostgreSQL image differs from the pinned baseline. Upgrade explicitly, preserving data.",
+		});
 	}
-	// libpq treats + literally in URI passwords.
-	const password = new URLSearchParams(url.search.replaceAll("+", "%2B")).getAll("password").at(-1) ?? decodeURIComponent(url.password);
-	const inside = new URL(url);
+	const { url: inside, options: settings } = clientConnection(url, options);
 	inside.hostname = "127.0.0.1";
 	inside.port = "5432";
-	inside.password = "";
-	inside.searchParams.delete("password");
-	try {
-		return docker(["exec", "--env", "PGPASSWORD", id, "psql", ...args, "--dbname", inside.toString()], {
-			...options,
-			env: { ...env, ...options.env, ...(password && { "PGPASSWORD": password }) },
-		}).trim();
-	} catch (error) {
-		throw new Error(error instanceof Error && "stderr" in error ? String(error.stderr) : "PostgreSQL query failed.", { cause: error });
-	}
-}
+	return yield* docker(["exec", "--env", "PGPASSWORD", id, "psql", ...args, "--dbname", inside.toString()], settings);
+});
 
-export function startContainer(docker: Docker) {
-	docker(["info"]);
-	let existing: boolean;
-	try {
-		docker(["container", "inspect", CONTAINER]);
-		existing = true;
-	} catch {
-		existing = false;
-	}
+export const startContainer = Effect.fn("LocalPostgres.startContainer")(function* (docker: Docker) {
+	yield* docker(["info"]);
+	const existing = yield* docker(["container", "ls", "--all", "--filter", `name=^/${CONTAINER}$`, "--format", "{{.ID}}"]);
 	if (existing) {
-		if (docker(["inspect", "--format", "{{.Config.Image}}", CONTAINER]).trim() !== POSTGRES_IMAGE) {
-			throw new Error("The shared PostgreSQL container uses a different image. Preserve its volume and upgrade it explicitly.");
+		if ((yield* docker(["inspect", "--format", "{{.Config.Image}}", CONTAINER])) !== POSTGRES_IMAGE) {
+			return yield* new LocalPostgresError({
+				message: "The shared PostgreSQL container uses a different image. Preserve its volume and upgrade it explicitly.",
+			});
 		}
-		docker(["start", CONTAINER]);
+		yield* docker(["start", CONTAINER]);
 	} else {
-		docker([
+		yield* docker([
 			"run",
 			"--detach",
 			"--name",
@@ -61,4 +57,4 @@ export function startContainer(docker: Docker) {
 			POSTGRES_IMAGE,
 		]);
 	}
-}
+});

package/src/server/localDocker.ts

@@ -1,27 +1,28 @@
-import { type ExecFileSyncOptionsWithStringEncoding, execFileSync } from "node:child_process";
+import { Effect } from "effect";
+import { LocalPostgresError } from "#LocalPostgresError.ts";
+import { type CommandOptions, runCommand } from "#runCommand.ts";
 
 export type DockerEnvironment = Readonly<{ "DOCKER_CONTEXT"?: string | undefined; "DOCKER_HOST"?: string | undefined }>;
 
-export function docker(
+export const docker = Effect.fn("LocalPostgres.docker")(function* (
 	environment: DockerEnvironment,
 	args: readonly string[],
-	options: ExecFileSyncOptionsWithStringEncoding = { encoding: "utf8" },
+	options: CommandOptions = {},
 ) {
 	const context = environment.DOCKER_CONTEXT;
 	const host = environment.DOCKER_HOST;
+	const settings = { ...options, env: { ...environment, ...options.env }, extendEnv: true };
 	const endpoint =
 		(!context && host)
-		|| execFileSync("docker", ["context", "inspect", ...(context ? [context] : []), "--format", "{{.Endpoints.docker.Host}}"], {
-			encoding: "utf8",
-		}).trim();
-	const url = new URL(endpoint);
+		|| (yield* runCommand("docker", ["context", "inspect", ...(context ? [context] : []), "--format", "{{.Endpoints.docker.Host}}"], settings));
+	const url = yield* Effect.try({ catch: () => new LocalPostgresError({ message: "Invalid Docker endpoint." }), try: () => new URL(endpoint) });
 	if (
 		!(
 			(["unix:", "npipe:"].includes(url.protocol) && ["", "localhost"].includes(url.hostname))
 			|| (url.protocol === "tcp:" && ["localhost", "127.0.0.1", "[::1]"].includes(url.hostname))
 		)
 	) {
-		throw new Error("Local database setup requires a local Docker endpoint; remote contexts are refused.");
+		return yield* new LocalPostgresError({ message: "Local database setup requires a local Docker endpoint; remote contexts are refused." });
 	}
-	return execFileSync("docker", args, options);
-}
+	return yield* runCommand("docker", args, settings);
+});