@shivaedev/sql 0.44.0 → 0.45.0

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## 0.45.0 - 2026-11-06
+
+### Breaking
+
+- Drop calls and imports of the removed `applyLowMemoryPostgres`. Move desired server values into the host's required `postgresSettings` declaration, typed by `PostgresSettings` from `@shivaedev/sql/postgresSettings.ts`.
+
 ## 0.44.0 - 2026-11-06
 
 ### Breaking

package/README.md

@@ -29,28 +29,13 @@ Migrations are ordinary Effects loaded by native Migrator. `migratePostgres` add
 
 The work has three parts: describe the model and provide its database once, choose repository operations per feature, and put each changed write inside the transaction that owns its commit.
 
-### Low-memory PostgreSQL hosts
+### PostgreSQL server settings
 
-`applyLowMemoryPostgres({ pointInTimeRecovery })` from `@shivaedev/sql/applyLowMemoryPostgres.ts` is an opt-in database-owner operation for small applications on Linux hosts that bill cgroup memory, including filesystem page cache. It uses the provided native `SqlClient` to write `ALTER SYSTEM` settings and request a reload. Run it once, outside a transaction, against the app's dedicated PostgreSQL instance with a role allowed to change these settings. It changes the whole instance, including every database on it. Keep it out of normal application startup and numbered migrations.
+Applications declare server settings through `postgresSettings` on server's [`appDatabase`](https://github.com/ShivaeDev/platform/tree/main/packages/server#postgresql-server-settings) and database-backed hosts. SQL owns the `PostgresSettings` type and `applyPostgresSettings` in `@shivaedev/sql/postgresSettings.ts`; the host runs the applier during database startup, before migrations, outside their transaction. Settings describe the cluster's current configuration, rather than numbered migration history. The declaration maps PostgreSQL setting names to string values, including PostgreSQL units; it has no preset or implicit settings.
 
-```ts
-import { Config, Effect } from "effect";
-import { applyLowMemoryPostgres } from "@shivaedev/sql/applyLowMemoryPostgres.ts";
-import { postgresLayer } from "@shivaedev/sql/postgresLayer.ts";
-
-const configure = Effect.gen(function* () {
-	const url = yield* Config.Redacted("DATABASE_URL");
-	yield* applyLowMemoryPostgres({ pointInTimeRecovery: false }).pipe(Effect.provide(postgresLayer(url)));
-}).pipe(Effect.scoped);
-```
-
-Restart PostgreSQL after this operation. `shared_buffers=32MB`, `max_connections=50` and `wal_buffers=4MB` take effect on restart. The reload settings are `jit=off`, `max_parallel_workers_per_gather=0`, `hash_mem_multiplier=1`, `autovacuum_max_workers=2`, `autovacuum_work_mem=32MB`, `idle_in_transaction_session_timeout=10min` and `wal_compression=zstd`. `idle_session_timeout=0` keeps idle LISTEN connections alive. Use PostgreSQL 18 with zstd support; older versions can require a restart for additional settings. Command-line `-c` settings override `ALTER SYSTEM`, so remove conflicting overrides. A failed operation can leave earlier settings written; correct the reported SQL error before restarting.
-
-Point-in-time recovery is an explicit per-app memory and storage choice. With `pointInTimeRecovery: false`, the preset disables WAL archiving with `archive_mode=off`; it leaves `archive_timeout` alone and needs no backup bucket or pgBackRest configuration. Remove the host's archive and backup jobs and bucket configuration as well. This choice gives up recovery to a time between backups. With `true`, retain the host's working WAL archiving, backup bucket and restore procedure; the preset sets `archive_timeout=300` seconds. It does not provision backups or enable archiving. A timeout of 60 seconds can force a 16 MB WAL segment each minute even when the app is idle.
-
-For PITR hosts, pgBackRest derives its process count from the CPU limit. Set a CPU limit of 2 or explicitly set `PGBACKREST_BACKUP_PROCESS_MAX=1` on the PostgreSQL service. Eight processes under a 32-vCPU limit exhausted a 477 MiB container in the reported Railway workload. Declare both CPU and memory limits in infrastructure as code: an omitted limit can be reset by the next plan. Keep enough headroom for backups, maintenance and the app's total connection budget across replicas and workers.
+The applier reads `pg_settings`, compares live values with the declaration, writes only differences with `ALTER SYSTEM SET`, and requests `pg_reload_conf()`. Equivalent numeric, memory and time units compare equally. A restart-only change logs its setting name and wanted value as pending; the live value remains until PostgreSQL restarts. These settings affect every database in the cluster, so apps sharing a cluster must agree on them.
 
-Pair this preset with server's [cache trim and connection lifetime](https://github.com/ShivaeDev/platform/tree/main/packages/server#low-memory-postgresql-hosts). Railway measurements supplied with this preset found billing within 0.2% of `memory.current`, shared memory around 45 MB instead of 175 MB, and small-app idle usage around 150–250 MB instead of 0.95 GB with preset, trim and connection recycling. Peaks returned within 5–10 minutes. These are workload observations, not memory limits or a promise for another app; measure your own cgroup before selecting a memory limit.
+`ALTER SYSTEM` requires a superuser for these server settings. On a non-superuser deployment, or when PostgreSQL refuses a value, startup warns with the setting name, live value and wanted value, then continues starting the app. Manage those settings through the database operator when the app cannot change them.
 
 ### One PostgreSQL pool per application
 

package/dist/adapters/makePostgresClient.d.ts

@@ -1,5 +1,5 @@
 import * as PgClient from "@effect/sql-pg/PgClient";
-import type * as PgConnection from "@effect/sql-pg/PgConnection";
+import * as PgConnection from "@effect/sql-pg/PgConnection";
 import * as PgPool from "@effect/sql-pg/PgPool";
 import { Effect } from "effect";
 import { SqlClient, Statement } from "effect/sql";

package/dist/adapters/makePostgresClient.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"makePostgresClient.d.ts","sourceRoot":"","sources":["../../src/adapters/makePostgresClient.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,yBAAyB,CAAC;AACpD,OAAO,KAAK,KAAK,YAAY,MAAM,6BAA6B,CAAC;AACjE,OAAO,KAAK,MAAM,MAAM,uBAAuB,CAAC;AAChD,OAAO,EAAE,MAAM,EAAqB,MAAM,QAAQ,CAAC;AACnD,OAAO,EAAE,SAAS,EAAsB,SAAS,EAAE,MAAM,YAAY,CAAC;AACtE,OAAO,EAAE,QAAQ,EAAgB,MAAM,qBAAqB,CAAC;AAI7D,eAAO,MAAM,kBAAkB;;;kBAuBf,OAAO;sBACH,MAAM;sBASN,MAAM,WAAW,MAAM;;4EAIzC,CAAC"}
+{"version":3,"file":"makePostgresClient.d.ts","sourceRoot":"","sources":["../../src/adapters/makePostgresClient.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,yBAAyB,CAAC;AACpD,OAAO,KAAK,YAAY,MAAM,6BAA6B,CAAC;AAC5D,OAAO,KAAK,MAAM,MAAM,uBAAuB,CAAC;AAChD,OAAO,EAAE,MAAM,EAAqB,MAAM,QAAQ,CAAC;AACnD,OAAO,EAAE,SAAS,EAAsB,SAAS,EAAE,MAAM,YAAY,CAAC;AACtE,OAAO,EAAE,QAAQ,EAAgB,MAAM,qBAAqB,CAAC;AAI7D,eAAO,MAAM,kBAAkB;;;kBA0Bf,OAAO;sBACH,MAAM;sBASN,MAAM,WAAW,MAAM;;4EAIzC,CAAC"}

package/dist/adapters/makePostgresClient.js

@@ -1,4 +1,5 @@
 import * as PgClient from "@effect/sql-pg/PgClient";
+import * as PgConnection from "@effect/sql-pg/PgConnection";
 import * as PgPool from "@effect/sql-pg/PgPool";
 import { Effect, Predicate, Stream } from "effect";
 import { SqlClient, Statement } from "effect/sql";
@@ -6,11 +7,11 @@ import { SqlError, UnknownError } from "effect/sql/SqlError";
 const json = Statement.custom("PgJson");
 export const makePostgresClient = Effect.fn("Sql.makePostgresClient")(function* (config) {
     const pool = yield* PgPool.PgPool;
-    const acquirer = Effect.map(pool.get, postgresConnection);
+    const acquirer = Effect.flatMap(pool.get, (connection) => postgresConnection.pipe(Effect.provideService(PgConnection.PgConnection, connection)));
     const client = yield* SqlClient.make({
         acquirer,
-        borrower: (use) => pool.use((connection) => use(postgresConnection(connection))),
-        commit,
+        borrower: (use) => pool.use((connection) => Effect.flatMap(postgresConnection.pipe(Effect.provideService(PgConnection.PgConnection, connection)), use)),
+        commit: (connection) => Effect.flatMap(connection.executeRaw("COMMIT", []), commitResult),
         compiler: PgClient.makeCompiler(config.transformQueryNames),
         driver: "pg",
         prepareTransactionControls: true,
@@ -21,7 +22,7 @@ export const makePostgresClient = Effect.fn("Sql.makePostgresClient")(function*
             ["server.address", config.host ?? "localhost"],
             ["server.port", config.port ?? 5432],
         ],
-        transactionAcquirer: Effect.map(pool.reserve, postgresConnection),
+        transactionAcquirer: Effect.flatMap(pool.reserve, (connection) => postgresConnection.pipe(Effect.provideService(PgConnection.PgConnection, connection))),
         transformRows: config.transformResultNames === undefined ? undefined : Statement.defaultTransforms(config.transformResultNames).array,
     });
     return Object.assign(client, {
@@ -40,7 +41,8 @@ export const makePostgresClient = Effect.fn("Sql.makePostgresClient")(function*
         poolStats: pool.stats,
     });
 });
-function postgresConnection(connection) {
+const postgresConnection = Effect.gen(function* () {
+    const connection = yield* PgConnection.PgConnection;
     function execute(sql, params, transformRows, prepare = true) {
         const rows = Effect.map(connection.query(sql, params, prepare), (result) => result.rows);
         return transformRows === undefined ? rows : Effect.map(rows, transformRows);
@@ -56,9 +58,9 @@ function postgresConnection(connection) {
         executeValues: (sql, params) => connection.queryValues(sql, params),
         executeValuesUnprepared: (sql, params) => connection.queryValues(sql, params, false),
     };
-}
-function commit(connection) {
-    return Effect.flatMap(connection.executeRaw("COMMIT", []), (result) => Predicate.hasProperty(result, "command") && result.command === "ROLLBACK"
+});
+function commitResult(result) {
+    return Predicate.hasProperty(result, "command") && result.command === "ROLLBACK"
         ? Effect.fail(new SqlError({
             reason: new UnknownError({
                 cause: new Error("COMMIT rolled back an aborted transaction"),
@@ -66,6 +68,6 @@ function commit(connection) {
                 operation: "commit",
             }),
         }))
-        : Effect.void);
+        : Effect.void;
 }
 //# sourceMappingURL=makePostgresClient.js.map

package/dist/adapters/makePostgresClient.js.map

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

package/dist/postgresSettings.d.ts

@@ -0,0 +1,5 @@
+import { Effect } from "effect";
+import { SqlClient } from "effect/sql";
+export type PostgresSettings = Readonly<Record<string, string>>;
+export declare const applyPostgresSettings: (settings: Readonly<Record<string, string>>) => Effect.Effect<void, never, SqlClient.SqlClient>;
+//# sourceMappingURL=postgresSettings.d.ts.map

package/dist/postgresSettings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"postgresSettings.d.ts","sourceRoot":"","sources":["../src/postgresSettings.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAU,MAAM,QAAQ,CAAC;AACxC,OAAO,EAAE,SAAS,EAAa,MAAM,YAAY,CAAC;AAElD,MAAM,MAAM,gBAAgB,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;AAUhE,eAAO,MAAM,qBAAqB,iGA4ChC,CAAC"}

package/dist/postgresSettings.js

@@ -0,0 +1,72 @@
+import { Effect, Schema } from "effect";
+import { SqlClient, SqlSchema } from "effect/sql";
+const Setting = Schema.Struct({
+    context: Schema.String,
+    pendingRestart: Schema.Boolean,
+    setting: Schema.String,
+    unit: Schema.NullOr(Schema.String),
+    vartype: Schema.String,
+}).pipe(Schema.encodeKeys({ pendingRestart: "pending_restart" }));
+export const applyPostgresSettings = Effect.fn("Sql.applyPostgresSettings")(function* (settings) {
+    const sql = (yield* SqlClient.SqlClient).withoutTransforms();
+    const read = SqlSchema.findAll({
+        execute: (name) => sql `select setting, unit, vartype, context, pending_restart from pg_settings where name = ${name}`,
+        Request: Schema.String,
+        Result: Setting,
+    });
+    const changed = [];
+    for (const [name, wanted] of Object.entries(settings)) {
+        let live = "unavailable";
+        yield* Effect.gen(function* () {
+            const [current] = yield* read(name);
+            if (current === undefined) {
+                return yield* Effect.logWarning("PostgreSQL setting is unknown", { live, setting: name, wanted });
+            }
+            live = `${current.setting}${current.unit === null ? "" : ` ${current.unit}`}`;
+            if (yield* settingMatches(current, wanted)) {
+                return;
+            }
+            yield* sql.unsafe(`ALTER SYSTEM SET "${name.replaceAll('"', '""')}" = '${wanted.replaceAll("'", "''")}'`).unprepared;
+            changed.push({ live, name, restart: current.context === "postmaster", wanted });
+        }).pipe(Effect.catch((error) => Effect.logWarning("Could not apply PostgreSQL setting", { error, live, setting: name, wanted })));
+    }
+    if (changed.length === 0) {
+        return;
+    }
+    yield* sql `select pg_reload_conf()`.pipe(Effect.andThen(Effect.forEach(changed, (change) => Effect.gen(function* () {
+        const [current] = yield* read(change.name);
+        // Reload signals are asynchronous; postmaster settings written above already require a restart.
+        if (current?.pendingRestart || change.restart) {
+            yield* Effect.logWarning("PostgreSQL setting pending restart", { setting: change.name, wanted: change.wanted });
+        }
+    }))), Effect.catch((error) => Effect.forEach(changed, ({ name, live, wanted }) => Effect.logWarning("Could not reload PostgreSQL setting", { error, live, setting: name, wanted }))));
+});
+const settingMatches = Effect.fnUntraced(function* (current, wanted) {
+    if (current.setting === wanted) {
+        return true;
+    }
+    const sql = yield* SqlClient.SqlClient;
+    let comparison = sql `${current.setting} = ${wanted}`;
+    if (current.vartype === "bool") {
+        comparison = sql `${current.setting}::boolean = ${wanted}::boolean`;
+    }
+    else if (["integer", "real"].includes(current.vartype)) {
+        if (/^[+-]?(?:\d+(?:\.\d*)?|\.\d+)(?:e[+-]?\d+)?$/iu.test(wanted.trim())) {
+            comparison = sql `${current.setting}::numeric = ${wanted}::numeric`;
+        }
+        else if (["B", "kB", "8kB", "MB"].includes(current.unit ?? "")) {
+            const unit = current.unit === "8kB" ? "8kB" : `1${current.unit}`;
+            comparison = sql `${current.setting}::numeric * pg_size_bytes(${unit}) = pg_size_bytes(${wanted})`;
+        }
+        else if (["us", "ms", "s", "min", "h", "d"].includes(current.unit ?? "")) {
+            comparison = sql `${current.setting}::numeric * extract(epoch from ${`1 ${current.unit}`}::interval) = extract(epoch from ${wanted}::interval)`;
+        }
+    }
+    const [row] = yield* SqlSchema.findAll({
+        execute: () => sql `select ${comparison} as matches`,
+        Request: Schema.Void,
+        Result: Schema.Struct({ matches: Schema.Boolean }),
+    })();
+    return row?.matches === true;
+});
+//# sourceMappingURL=postgresSettings.js.map

package/dist/postgresSettings.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shivaedev/sql",
-  "version": "0.44.0",
+  "version": "0.45.0",
   "description": "Schema-derived repositories over native Effect SQL",
   "keywords": [
     "effect"
@@ -50,12 +50,12 @@
     "@effect/platform-node": "4.1.0",
     "@effect/sql-pg": "4.1.0",
     "@effect/sql-sqlite-node": "4.1.0",
-    "@shivaedev/contract": "0.41.0",
-    "@shivaedev/jobs": "0.40.1",
-    "@shivaedev/quality": "0.67.0",
-    "@shivaedev/test-kits": "0.9.0",
-    "@shivaedev/test-sql": "0.24.2",
-    "@shivaedev/test-story": "0.43.0",
+    "@shivaedev/contract": "0.42.0",
+    "@shivaedev/jobs": "0.41.0",
+    "@shivaedev/quality": "0.69.1",
+    "@shivaedev/test-kits": "0.9.3",
+    "@shivaedev/test-sql": "0.24.3",
+    "@shivaedev/test-story": "0.44.2",
     "@types/node": "24.19.2",
     "effect": "4.1.0",
     "typescript": "7.0.2",

package/src/adapters/makePostgresClient.ts

@@ -1,5 +1,5 @@
 import * as PgClient from "@effect/sql-pg/PgClient";
-import type * as PgConnection from "@effect/sql-pg/PgConnection";
+import * as PgConnection from "@effect/sql-pg/PgConnection";
 import * as PgPool from "@effect/sql-pg/PgPool";
 import { Effect, Predicate, Stream } from "effect";
 import { SqlClient, type SqlConnection, Statement } from "effect/sql";
@@ -9,11 +9,12 @@ const json = Statement.custom<PgClient.PgCustom>("PgJson");
 
 export const makePostgresClient = Effect.fn("Sql.makePostgresClient")(function* (config: PgClient.PgClientConfig) {
 	const pool = yield* PgPool.PgPool;
-	const acquirer = Effect.map(pool.get, postgresConnection);
+	const acquirer = Effect.flatMap(pool.get, (connection) => postgresConnection.pipe(Effect.provideService(PgConnection.PgConnection, connection)));
 	const client = yield* SqlClient.make({
 		acquirer,
-		borrower: (use) => pool.use((connection) => use(postgresConnection(connection))),
-		commit,
+		borrower: (use) =>
+			pool.use((connection) => Effect.flatMap(postgresConnection.pipe(Effect.provideService(PgConnection.PgConnection, connection)), use)),
+		commit: (connection) => Effect.flatMap(connection.executeRaw("COMMIT", []), commitResult),
 		compiler: PgClient.makeCompiler(config.transformQueryNames),
 		driver: "pg",
 		prepareTransactionControls: true,
@@ -24,7 +25,9 @@ export const makePostgresClient = Effect.fn("Sql.makePostgresClient")(function*
 			["server.address", config.host ?? "localhost"],
 			["server.port", config.port ?? 5432],
 		],
-		transactionAcquirer: Effect.map(pool.reserve, postgresConnection),
+		transactionAcquirer: Effect.flatMap(pool.reserve, (connection) =>
+			postgresConnection.pipe(Effect.provideService(PgConnection.PgConnection, connection)),
+		),
 		transformRows: config.transformResultNames === undefined ? undefined : Statement.defaultTransforms(config.transformResultNames).array,
 	});
 	return Object.assign(client, {
@@ -46,7 +49,8 @@ export const makePostgresClient = Effect.fn("Sql.makePostgresClient")(function*
 	}) satisfies PgClient.PgClient;
 });
 
-function postgresConnection(connection: PgConnection.PgConnection): SqlConnection.Connection {
+const postgresConnection = Effect.gen(function* () {
+	const connection = yield* PgConnection.PgConnection;
 	function execute(sql: string, params: readonly unknown[], transformRows: Parameters<SqlConnection.Connection["execute"]>[2], prepare = true) {
 		const rows = Effect.map(connection.query(sql, params, prepare), (result) => result.rows);
 		return transformRows === undefined ? rows : Effect.map(rows, transformRows);
@@ -61,21 +65,19 @@ function postgresConnection(connection: PgConnection.PgConnection): SqlConnectio
 		executeUnprepared: (sql, params, transformRows) => execute(sql, params, transformRows, false),
 		executeValues: (sql, params) => connection.queryValues(sql, params),
 		executeValuesUnprepared: (sql, params) => connection.queryValues(sql, params, false),
-	};
-}
+	} satisfies SqlConnection.Connection;
+});
 
-function commit(connection: SqlConnection.Connection) {
-	return Effect.flatMap(connection.executeRaw("COMMIT", []), (result) =>
-		Predicate.hasProperty(result, "command") && result.command === "ROLLBACK"
-			? Effect.fail(
-					new SqlError({
-						reason: new UnknownError({
-							cause: new Error("COMMIT rolled back an aborted transaction"),
-							message: "PgClient: COMMIT rolled back an aborted transaction",
-							operation: "commit",
-						}),
+function commitResult(result: unknown) {
+	return Predicate.hasProperty(result, "command") && result.command === "ROLLBACK"
+		? Effect.fail(
+				new SqlError({
+					reason: new UnknownError({
+						cause: new Error("COMMIT rolled back an aborted transaction"),
+						message: "PgClient: COMMIT rolled back an aborted transaction",
+						operation: "commit",
 					}),
-				)
-			: Effect.void,
-	);
+				}),
+			)
+		: Effect.void;
 }

package/src/postgresSettings.ts

@@ -0,0 +1,84 @@
+import { Effect, Schema } from "effect";
+import { SqlClient, SqlSchema } from "effect/sql";
+
+export type PostgresSettings = Readonly<Record<string, string>>;
+
+const Setting = Schema.Struct({
+	context: Schema.String,
+	pendingRestart: Schema.Boolean,
+	setting: Schema.String,
+	unit: Schema.NullOr(Schema.String),
+	vartype: Schema.String,
+}).pipe(Schema.encodeKeys({ pendingRestart: "pending_restart" }));
+
+export const applyPostgresSettings = Effect.fn("Sql.applyPostgresSettings")(function* (settings: PostgresSettings) {
+	const sql = (yield* SqlClient.SqlClient).withoutTransforms();
+	const read = SqlSchema.findAll({
+		execute: (name) => sql`select setting, unit, vartype, context, pending_restart from pg_settings where name = ${name}`,
+		Request: Schema.String,
+		Result: Setting,
+	});
+	const changed: Array<{ name: string; live: string; wanted: string; restart: boolean }> = [];
+	for (const [name, wanted] of Object.entries(settings)) {
+		let live = "unavailable";
+		yield* Effect.gen(function* () {
+			const [current] = yield* read(name);
+			if (current === undefined) {
+				return yield* Effect.logWarning("PostgreSQL setting is unknown", { live, setting: name, wanted });
+			}
+			live = `${current.setting}${current.unit === null ? "" : ` ${current.unit}`}`;
+			if (yield* settingMatches(current, wanted)) {
+				return;
+			}
+			yield* sql.unsafe(`ALTER SYSTEM SET "${name.replaceAll('"', '""')}" = '${wanted.replaceAll("'", "''")}'`).unprepared;
+			changed.push({ live, name, restart: current.context === "postmaster", wanted });
+		}).pipe(Effect.catch((error) => Effect.logWarning("Could not apply PostgreSQL setting", { error, live, setting: name, wanted })));
+	}
+	if (changed.length === 0) {
+		return;
+	}
+	yield* sql`select pg_reload_conf()`.pipe(
+		Effect.andThen(
+			Effect.forEach(changed, (change) =>
+				Effect.gen(function* () {
+					const [current] = yield* read(change.name);
+					// Reload signals are asynchronous; postmaster settings written above already require a restart.
+					if (current?.pendingRestart || change.restart) {
+						yield* Effect.logWarning("PostgreSQL setting pending restart", { setting: change.name, wanted: change.wanted });
+					}
+				}),
+			),
+		),
+		Effect.catch((error) =>
+			Effect.forEach(changed, ({ name, live, wanted }) =>
+				Effect.logWarning("Could not reload PostgreSQL setting", { error, live, setting: name, wanted }),
+			),
+		),
+	);
+});
+
+const settingMatches = Effect.fnUntraced(function* (current: typeof Setting.Type, wanted: string) {
+	if (current.setting === wanted) {
+		return true;
+	}
+	const sql = yield* SqlClient.SqlClient;
+	let comparison = sql`${current.setting} = ${wanted}`;
+	if (current.vartype === "bool") {
+		comparison = sql`${current.setting}::boolean = ${wanted}::boolean`;
+	} else if (["integer", "real"].includes(current.vartype)) {
+		if (/^[+-]?(?:\d+(?:\.\d*)?|\.\d+)(?:e[+-]?\d+)?$/iu.test(wanted.trim())) {
+			comparison = sql`${current.setting}::numeric = ${wanted}::numeric`;
+		} else if (["B", "kB", "8kB", "MB"].includes(current.unit ?? "")) {
+			const unit = current.unit === "8kB" ? "8kB" : `1${current.unit}`;
+			comparison = sql`${current.setting}::numeric * pg_size_bytes(${unit}) = pg_size_bytes(${wanted})`;
+		} else if (["us", "ms", "s", "min", "h", "d"].includes(current.unit ?? "")) {
+			comparison = sql`${current.setting}::numeric * extract(epoch from ${`1 ${current.unit}`}::interval) = extract(epoch from ${wanted}::interval)`;
+		}
+	}
+	const [row] = yield* SqlSchema.findAll({
+		execute: () => sql`select ${comparison} as matches`,
+		Request: Schema.Void,
+		Result: Schema.Struct({ matches: Schema.Boolean }),
+	})();
+	return row?.matches === true;
+});

package/dist/applyLowMemoryPostgres.d.ts

@@ -1,7 +0,0 @@
-import { Effect } from "effect";
-import { SqlClient } from "effect/sql";
-export interface LowMemoryPostgresOptions {
-    readonly pointInTimeRecovery: boolean;
-}
-export declare const applyLowMemoryPostgres: (args_0: LowMemoryPostgresOptions) => Effect.Effect<void, import("effect/sql/SqlError").SqlError, SqlClient.SqlClient>;
-//# sourceMappingURL=applyLowMemoryPostgres.d.ts.map

package/dist/applyLowMemoryPostgres.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"applyLowMemoryPostgres.d.ts","sourceRoot":"","sources":["../src/applyLowMemoryPostgres.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAEvC,MAAM,WAAW,wBAAwB;IACxC,QAAQ,CAAC,mBAAmB,EAAE,OAAO,CAAC;CACtC;AAED,eAAO,MAAM,sBAAsB,wHAoBjC,CAAC"}

package/dist/applyLowMemoryPostgres.js

@@ -1,24 +0,0 @@
-import { Effect } from "effect";
-import { SqlClient } from "effect/sql";
-export const applyLowMemoryPostgres = Effect.fn("Sql.applyLowMemoryPostgres")(function* ({ pointInTimeRecovery }) {
-    const sql = yield* SqlClient.SqlClient;
-    const settings = {
-        "autovacuum_max_workers": "2",
-        "autovacuum_work_mem": "32MB",
-        "hash_mem_multiplier": "1",
-        "idle_in_transaction_session_timeout": "10min",
-        "idle_session_timeout": "0",
-        jit: "off",
-        "max_connections": "50",
-        "max_parallel_workers_per_gather": "0",
-        "shared_buffers": "32MB",
-        "wal_buffers": "4MB",
-        "wal_compression": "zstd",
-        ...(pointInTimeRecovery ? { "archive_timeout": "300" } : { "archive_mode": "off" }),
-    };
-    for (const [name, value] of Object.entries(settings)) {
-        yield* sql.unsafe(`ALTER SYSTEM SET ${name} = '${value}'`);
-    }
-    yield* sql `select pg_reload_conf()`;
-});
-//# sourceMappingURL=applyLowMemoryPostgres.js.map

package/dist/applyLowMemoryPostgres.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"applyLowMemoryPostgres.js","sourceRoot":"","sources":["../src/applyLowMemoryPostgres.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAMvC,MAAM,CAAC,MAAM,sBAAsB,GAAG,MAAM,CAAC,EAAE,CAAC,4BAA4B,CAAC,CAAC,QAAQ,CAAC,EAAE,EAAE,mBAAmB,EAA4B;IACzI,MAAM,GAAG,GAAG,KAAK,CAAC,CAAC,SAAS,CAAC,SAAS,CAAC;IACvC,MAAM,QAAQ,GAAG;QAChB,wBAAwB,EAAE,GAAG;QAC7B,qBAAqB,EAAE,MAAM;QAC7B,qBAAqB,EAAE,GAAG;QAC1B,qCAAqC,EAAE,OAAO;QAC9C,sBAAsB,EAAE,GAAG;QAC3B,GAAG,EAAE,KAAK;QACV,iBAAiB,EAAE,IAAI;QACvB,iCAAiC,EAAE,GAAG;QACtC,gBAAgB,EAAE,MAAM;QACxB,aAAa,EAAE,KAAK;QACpB,iBAAiB,EAAE,MAAM;QACzB,GAAG,CAAC,mBAAmB,CAAC,CAAC,CAAC,EAAE,iBAAiB,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,KAAK,EAAE,CAAC;KACnF,CAAC;IACF,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;QACtD,KAAK,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,oBAAoB,IAAI,OAAO,KAAK,GAAG,CAAC,CAAC;IAC5D,CAAC;IACD,KAAK,CAAC,CAAC,GAAG,CAAA,yBAAyB,CAAC;AACrC,CAAC,CAAC,CAAC"}

package/src/applyLowMemoryPostgres.ts

@@ -1,28 +0,0 @@
-import { Effect } from "effect";
-import { SqlClient } from "effect/sql";
-
-export interface LowMemoryPostgresOptions {
-	readonly pointInTimeRecovery: boolean;
-}
-
-export const applyLowMemoryPostgres = Effect.fn("Sql.applyLowMemoryPostgres")(function* ({ pointInTimeRecovery }: LowMemoryPostgresOptions) {
-	const sql = yield* SqlClient.SqlClient;
-	const settings = {
-		"autovacuum_max_workers": "2",
-		"autovacuum_work_mem": "32MB",
-		"hash_mem_multiplier": "1",
-		"idle_in_transaction_session_timeout": "10min",
-		"idle_session_timeout": "0",
-		jit: "off",
-		"max_connections": "50",
-		"max_parallel_workers_per_gather": "0",
-		"shared_buffers": "32MB",
-		"wal_buffers": "4MB",
-		"wal_compression": "zstd",
-		...(pointInTimeRecovery ? { "archive_timeout": "300" } : { "archive_mode": "off" }),
-	};
-	for (const [name, value] of Object.entries(settings)) {
-		yield* sql.unsafe(`ALTER SYSTEM SET ${name} = '${value}'`);
-	}
-	yield* sql`select pg_reload_conf()`;
-});