@shivaedev/local-postgres 0.10.0 → 0.12.0

package/dist/server/assertLocalDatabase.js

@@ -1,5 +1,5 @@
 import { Effect } from "effect";
-import { LocalPostgresError } from "#LocalPostgresError.ts";
+import { LocalPostgresError } from "#server/LocalPostgresError.ts";
 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) });

package/dist/server/assertLocalDatabase.js.map

@@ -1 +1 @@
-{"version":3,"file":"assertLocalDatabase.js","sourceRoot":"","sources":["../../src/server/assertLocalDatabase.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAE5D,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"}
+{"version":3,"file":"assertLocalDatabase.js","sourceRoot":"","sources":["../../src/server/assertLocalDatabase.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AAEnE,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"}

package/dist/server/dockerEnvironment.d.ts

@@ -0,0 +1,10 @@
+import { Config } from "effect";
+export type DockerEnvironment = Readonly<{
+    "DOCKER_CONTEXT"?: string | undefined;
+    "DOCKER_HOST"?: string | undefined;
+}>;
+export declare const dockerEnvironment: Config.Config<{
+    DOCKER_CONTEXT: string;
+    DOCKER_HOST: string;
+}>;
+//# sourceMappingURL=dockerEnvironment.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dockerEnvironment.d.ts","sourceRoot":"","sources":["../../src/server/dockerEnvironment.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC,MAAM,MAAM,iBAAiB,GAAG,QAAQ,CAAC;IAAE,gBAAgB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAAC,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAAC,CAAC;AAExH,eAAO,MAAM,iBAAiB;;;EAG5B,CAAC"}

package/dist/server/dockerEnvironment.js

@@ -0,0 +1,6 @@
+import { Config } from "effect";
+export const dockerEnvironment = Config.all({
+    "DOCKER_CONTEXT": Config.String("DOCKER_CONTEXT").pipe(Config.withDefault("")),
+    "DOCKER_HOST": Config.String("DOCKER_HOST").pipe(Config.withDefault("")),
+});
+//# sourceMappingURL=dockerEnvironment.js.map

package/dist/server/dockerEnvironment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dockerEnvironment.js","sourceRoot":"","sources":["../../src/server/dockerEnvironment.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAIhC,MAAM,CAAC,MAAM,iBAAiB,GAAG,MAAM,CAAC,GAAG,CAAC;IAC3C,gBAAgB,EAAE,MAAM,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;IAC9E,aAAa,EAAE,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;CACxE,CAAC,CAAC"}

package/dist/server/localPostgres.d.ts

@@ -1,15 +1,15 @@
 import { Effect } from "effect";
-import { LocalPostgresError } from "#LocalPostgresError.ts";
-import { type DockerEnvironment } from "#localDocker.ts";
-import { PostgresVersionMismatch } from "#PostgresVersionMismatch.ts";
+import type { DockerEnvironment } from "#server/dockerEnvironment.ts";
+import { LocalPostgresError } from "#server/LocalPostgresError.ts";
+import { PostgresVersionMismatch } from "#server/PostgresVersionMismatch.ts";
 export declare const LOCAL_SERVER = "postgresql://postgres:postgres@127.0.0.1:55432";
 export interface ReadinessOptions {
     readonly attempts?: number;
     readonly delayMillis?: number;
 }
 export declare function localPostgres(environment: DockerEnvironment, { attempts, delayMillis }?: ReadinessOptions): {
-    prepareDatabases: (values: readonly string[]) => Effect.Effect<undefined, LocalPostgresError | import("./PostgresCommandError.ts").PostgresCommandError | import("#localConnections.ts").PostgresSettingError | PostgresVersionMismatch, import("effect/process/ChildProcessSpawner").ChildProcessSpawner>;
+    prepareDatabases: (values: readonly string[]) => Effect.Effect<undefined, LocalPostgresError | import("./PostgresCommandError.ts").PostgresCommandError | import("./PostgresSettingError.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>;
+    startPostgres: (connection?: any) => Effect.Effect<void, LocalPostgresError | import("./PostgresCommandError.ts").PostgresCommandError | import("./PostgresSettingError.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":"AAAA,OAAO,EAAE,MAAM,EAAY,MAAM,QAAQ,CAAC;AAG1C,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,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;;;;EAuDzH"}
+{"version":3,"file":"localPostgres.d.ts","sourceRoot":"","sources":["../../src/server/localPostgres.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAY,MAAM,QAAQ,CAAC;AAO1C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACtE,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AACnE,OAAO,EAAE,uBAAuB,EAAE,MAAM,oCAAoC,CAAC;AAE7E,eAAO,MAAM,YAAY,mDAAmD,CAAC;AAE7E,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;;;;EAuDzH"}

package/dist/server/localPostgres.js

@@ -1,12 +1,11 @@
 import { Effect, Schedule } from "effect";
-import { assertLocalDatabase } from "#assertLocalDatabase.ts";
-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";
+import { docker } from "#server/adapters/docker.ts";
+import { ensureConnections } from "#server/adapters/ensureConnections.ts";
+import { startContainer } from "#server/adapters/localContainer.ts";
+import { localSql } from "#server/adapters/localSql.ts";
+import { assertLocalDatabase } from "#server/assertLocalDatabase.ts";
+import { LocalPostgresError } from "#server/LocalPostgresError.ts";
+import { PostgresVersionMismatch } from "#server/PostgresVersionMismatch.ts";
 export const LOCAL_SERVER = "postgresql://postgres:postgres@127.0.0.1:55432";
 export function localPostgres(environment, { attempts = 30, delayMillis = 1000 } = {}) {
     function localDocker(args, options) {
@@ -58,12 +57,4 @@ export function localPostgres(environment, { attempts = 30, delayMillis = 1000 }
     });
     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 } = yield* 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":"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"}

package/dist/server/migrateAppPostgres.d.ts

@@ -0,0 +1,6 @@
+import { Effect, FileSystem, Path } from "effect";
+import type { AppPostgresInstance } from "#server/appPostgres.ts";
+import { PostgresBinaries } from "#server/PostgresBinaries.ts";
+export declare const backupAppPostgres: (instance: AppPostgresInstance) => Effect.Effect<string, import("effect/PlatformError").PlatformError | import("./PostgresCommandError.ts").PostgresCommandError, import("effect/process/ChildProcessSpawner").ChildProcessSpawner | FileSystem.FileSystem | Path.Path | PostgresBinaries>;
+export declare function migrateAppPostgres<A, E, R>(instance: AppPostgresInstance, migration: Effect.Effect<A, E, R>): Effect.Effect<A, E | import("effect/PlatformError").PlatformError | import("./PostgresCommandError.ts").PostgresCommandError, R | import("effect/process/ChildProcessSpawner").ChildProcessSpawner | FileSystem.FileSystem | Path.Path | PostgresBinaries>;
+//# sourceMappingURL=migrateAppPostgres.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"migrateAppPostgres.d.ts","sourceRoot":"","sources":["../../src/server/migrateAppPostgres.ts"],"names":[],"mappings":"AAAA,OAAO,EAAS,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAEzD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAClE,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAE/D,eAAO,MAAM,iBAAiB,4RAyB5B,CAAC;AAEH,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,QAAQ,EAAE,mBAAmB,EAAE,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,8PAE3G"}

package/dist/server/migrateAppPostgres.js

@@ -0,0 +1,31 @@
+import { Clock, Effect, FileSystem, Path } from "effect";
+import { runCommand } from "#server/adapters/runCommand.ts";
+import { PostgresBinaries } from "#server/PostgresBinaries.ts";
+export const backupAppPostgres = Effect.fn("LocalPostgres.backupAppPostgres")(function* (instance) {
+    const fs = yield* FileSystem.FileSystem;
+    const path = yield* Path.Path;
+    const binaries = yield* PostgresBinaries;
+    const directory = path.join(instance.dataDirectory, "backups");
+    yield* fs.makeDirectory(directory, { mode: 0o700, recursive: true });
+    const timestamp = yield* Clock.currentTimeMillis;
+    const backup = yield* Effect.scoped(Effect.gen(function* () {
+        const staging = yield* fs.makeTempDirectoryScoped({ directory, prefix: `backup-${timestamp}-` });
+        const file = path.join(staging, "dump.partial");
+        yield* runCommand(binaries.pgDump, ["--format=custom", "--file", file, "--dbname", instance.connectionUrl]);
+        const completed = `${staging}.dump`;
+        yield* fs.rename(file, completed);
+        return completed;
+    }));
+    const files = (yield* fs.readDirectory(directory))
+        .filter((name) => /^backup-\d+-.+\.dump$/u.test(name))
+        .sort()
+        .reverse();
+    for (const file of files.slice(instance.backupsToKeep)) {
+        yield* fs.remove(path.join(directory, file));
+    }
+    return backup;
+});
+export function migrateAppPostgres(instance, migration) {
+    return backupAppPostgres(instance).pipe(Effect.andThen(migration));
+}
+//# sourceMappingURL=migrateAppPostgres.js.map

package/dist/server/migrateAppPostgres.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrateAppPostgres.js","sourceRoot":"","sources":["../../src/server/migrateAppPostgres.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AACzD,OAAO,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAC;AAE5D,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAE/D,MAAM,CAAC,MAAM,iBAAiB,GAAG,MAAM,CAAC,EAAE,CAAC,iCAAiC,CAAC,CAAC,QAAQ,CAAC,EAAE,QAA6B;IACrH,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC,UAAU,CAAC,UAAU,CAAC;IACxC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;IAC9B,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,gBAAgB,CAAC;IACzC,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,aAAa,EAAE,SAAS,CAAC,CAAC;IAC/D,KAAK,CAAC,CAAC,EAAE,CAAC,aAAa,CAAC,SAAS,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACrE,MAAM,SAAS,GAAG,KAAK,CAAC,CAAC,KAAK,CAAC,iBAAiB,CAAC;IACjD,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,MAAM,CAAC,MAAM,CAClC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;QACnB,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,EAAE,CAAC,uBAAuB,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,SAAS,GAAG,EAAE,CAAC,CAAC;QACjG,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC;QAChD,KAAK,CAAC,CAAC,UAAU,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,iBAAiB,EAAE,QAAQ,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,CAAC,aAAa,CAAC,CAAC,CAAC;QAC5G,MAAM,SAAS,GAAG,GAAG,OAAO,OAAO,CAAC;QACpC,KAAK,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;QAClC,OAAO,SAAS,CAAC;IAClB,CAAC,CAAC,CACF,CAAC;IACF,MAAM,KAAK,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC;SAChD,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,wBAAwB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;SACrD,IAAI,EAAE;SACN,OAAO,EAAE,CAAC;IACZ,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC;QACxD,KAAK,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC,CAAC;IAC9C,CAAC;IACD,OAAO,MAAM,CAAC;AACf,CAAC,CAAC,CAAC;AAEH,MAAM,UAAU,kBAAkB,CAAU,QAA6B,EAAE,SAAiC;IAC3G,OAAO,iBAAiB,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC;AACpE,CAAC"}

package/dist/server/prepareAppPostgresData.d.ts

@@ -0,0 +1,6 @@
+import { Effect, FileSystem, Path } from "effect";
+import { AppPostgresVersionMismatch } from "#server/AppPostgresVersionMismatch.ts";
+import { LocalPostgresError } from "#server/LocalPostgresError.ts";
+import { PostgresBinaries } from "#server/PostgresBinaries.ts";
+export declare const prepareAppPostgresData: (dataDirectory: string) => Effect.Effect<undefined, AppPostgresVersionMismatch | LocalPostgresError | import("effect/PlatformError").PlatformError | import("./PostgresCommandError.ts").PostgresCommandError, import("effect/process/ChildProcessSpawner").ChildProcessSpawner | FileSystem.FileSystem | Path.Path | PostgresBinaries>;
+//# sourceMappingURL=prepareAppPostgresData.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"prepareAppPostgresData.d.ts","sourceRoot":"","sources":["../../src/server/prepareAppPostgresData.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAClD,OAAO,EAAE,0BAA0B,EAAE,MAAM,uCAAuC,CAAC;AAEnF,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AACnE,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAE/D,eAAO,MAAM,sBAAsB,yUA4BjC,CAAC"}

package/dist/server/prepareAppPostgresData.js

@@ -0,0 +1,35 @@
+import { Effect, FileSystem, Path } from "effect";
+import { AppPostgresVersionMismatch } from "#server/AppPostgresVersionMismatch.ts";
+import { runCommand } from "#server/adapters/runCommand.ts";
+import { LocalPostgresError } from "#server/LocalPostgresError.ts";
+import { PostgresBinaries } from "#server/PostgresBinaries.ts";
+export const prepareAppPostgresData = Effect.fn("LocalPostgres.prepareAppPostgresData")(function* (dataDirectory) {
+    const binaries = yield* PostgresBinaries;
+    const fs = yield* FileSystem.FileSystem;
+    const path = yield* Path.Path;
+    const version = yield* runCommand(binaries.postgres, ["--version"]);
+    const expectedMajor = /\b(?<major>\d+)\./u.exec(version)?.groups?.major;
+    if (!expectedMajor) {
+        return yield* new LocalPostgresError({ message: `Cannot read PostgreSQL major version from ${version}.` });
+    }
+    const versionFile = path.join(dataDirectory, "PG_VERSION");
+    if (yield* fs.exists(versionFile)) {
+        const observedMajor = (yield* fs.readFileString(versionFile)).trim();
+        if (observedMajor !== expectedMajor) {
+            return yield* new AppPostgresVersionMismatch({ dataDirectory, expectedMajor, observedMajor });
+        }
+        return;
+    }
+    yield* fs.makeDirectory(dataDirectory, { recursive: true });
+    yield* runCommand(binaries.initdb, [
+        "--pgdata",
+        dataDirectory,
+        "--username",
+        "postgres",
+        "--auth-local=trust",
+        "--auth-host=reject",
+        "--encoding=UTF8",
+        "--locale=C",
+    ]);
+});
+//# sourceMappingURL=prepareAppPostgresData.js.map

package/dist/server/prepareAppPostgresData.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prepareAppPostgresData.js","sourceRoot":"","sources":["../../src/server/prepareAppPostgresData.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAClD,OAAO,EAAE,0BAA0B,EAAE,MAAM,uCAAuC,CAAC;AACnF,OAAO,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAC;AAC5D,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AACnE,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAE/D,MAAM,CAAC,MAAM,sBAAsB,GAAG,MAAM,CAAC,EAAE,CAAC,sCAAsC,CAAC,CAAC,QAAQ,CAAC,EAAE,aAAqB;IACvH,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,gBAAgB,CAAC;IACzC,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC,UAAU,CAAC,UAAU,CAAC;IACxC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;IAC9B,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,UAAU,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC;IACpE,MAAM,aAAa,GAAG,oBAAoB,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC;IACxE,IAAI,CAAC,aAAa,EAAE,CAAC;QACpB,OAAO,KAAK,CAAC,CAAC,IAAI,kBAAkB,CAAC,EAAE,OAAO,EAAE,6CAA6C,OAAO,GAAG,EAAE,CAAC,CAAC;IAC5G,CAAC;IACD,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,YAAY,CAAC,CAAC;IAC3D,IAAI,KAAK,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,WAAW,CAAC,EAAE,CAAC;QACnC,MAAM,aAAa,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,cAAc,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QACrE,IAAI,aAAa,KAAK,aAAa,EAAE,CAAC;YACrC,OAAO,KAAK,CAAC,CAAC,IAAI,0BAA0B,CAAC,EAAE,aAAa,EAAE,aAAa,EAAE,aAAa,EAAE,CAAC,CAAC;QAC/F,CAAC;QACD,OAAO;IACR,CAAC;IACD,KAAK,CAAC,CAAC,EAAE,CAAC,aAAa,CAAC,aAAa,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC5D,KAAK,CAAC,CAAC,UAAU,CAAC,QAAQ,CAAC,MAAM,EAAE;QAClC,UAAU;QACV,aAAa;QACb,YAAY;QACZ,UAAU;QACV,oBAAoB;QACpB,oBAAoB;QACpB,iBAAiB;QACjB,YAAY;KACZ,CAAC,CAAC;AACJ,CAAC,CAAC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shivaedev/local-postgres",
-  "version": "0.10.0",
+  "version": "0.12.0",
   "description": "Repeatable local PostgreSQL preparation with one shared persistent service",
   "homepage": "https://github.com/ShivaeDev/platform/tree/main/packages/local-postgres#readme",
   "bugs": {
@@ -17,9 +17,9 @@
   "imports": {
     "#test/*": "./src/test-support/*",
     "#*.ts": {
-      "source": "./src/server/*.ts",
-      "types": "./dist/server/*.d.ts",
-      "default": "./dist/server/*.js"
+      "source": "./src/*.ts",
+      "types": "./dist/*.d.ts",
+      "default": "./dist/*.js"
     }
   },
   "exports": {
@@ -41,8 +41,8 @@
   ],
   "devDependencies": {
     "@effect/platform-node": "4.0.6",
-    "@shivaedev/quality": "0.56.0",
-    "@shivaedev/test-story": "0.34.0",
+    "@shivaedev/quality": "0.57.1",
+    "@shivaedev/test-story": "0.36.0",
     "@types/node": "24.19.2",
     "effect": "4.0.6",
     "typescript": "7.0.2",

package/src/server/AppPostgresVersionMismatch.ts

@@ -0,0 +1,11 @@
+import { Schema } from "effect";
+
+export class AppPostgresVersionMismatch extends Schema.TaggedError<AppPostgresVersionMismatch>()("AppPostgresVersionMismatch", {
+	dataDirectory: Schema.String,
+	expectedMajor: Schema.String,
+	observedMajor: Schema.String,
+}) {
+	override get message() {
+		return `PostgreSQL ${this.expectedMajor} cannot open ${this.dataDirectory}: its data belongs to PostgreSQL ${this.observedMajor}.`;
+	}
+}

package/src/server/PostgresBinaries.ts

@@ -0,0 +1,9 @@
+import { Context } from "effect";
+
+export interface PostgresExecutables {
+	readonly initdb: string;
+	readonly pgDump: string;
+	readonly postgres: string;
+}
+
+export class PostgresBinaries extends Context.Service<PostgresBinaries, PostgresExecutables>()("@shivaedev/local-postgres/PostgresBinaries") {}

package/src/server/PostgresSettingError.ts

@@ -0,0 +1,11 @@
+import { Schema } from "effect";
+
+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.";
+	}
+}

package/src/server/{clientConnection.ts → adapters/clientConnection.ts}

@@ -1,6 +1,6 @@
 import { Effect } from "effect";
-import { LocalPostgresError } from "#LocalPostgresError.ts";
-import type { CommandOptions } from "#runCommand.ts";
+import { LocalPostgresError } from "#server/LocalPostgresError.ts";
+import type { CommandOptions } from "./runCommand.ts";
 
 export const clientConnection = Effect.fn("LocalPostgres.clientConnection")(function* (value: URL, options: CommandOptions = {}) {
 	const url = new URL(value);

package/src/server/{localDocker.ts → adapters/docker.ts}

@@ -1,8 +1,7 @@
 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 }>;
+import type { DockerEnvironment } from "#server/dockerEnvironment.ts";
+import { LocalPostgresError } from "#server/LocalPostgresError.ts";
+import { type CommandOptions, runCommand } from "./runCommand.ts";
 
 export const docker = Effect.fn("LocalPostgres.docker")(function* (
 	environment: DockerEnvironment,

package/src/server/{localConnections.ts → adapters/ensureConnections.ts}

@@ -1,20 +1,11 @@
-import { Effect, Schema } from "effect";
+import { Effect } 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 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.";
-	}
-}
+import { LocalPostgresError } from "#server/LocalPostgresError.ts";
+import type { PostgresCommandError } from "#server/PostgresCommandError.ts";
+import { PostgresSettingError } from "#server/PostgresSettingError.ts";
+import type { PostgresVersionMismatch } from "#server/PostgresVersionMismatch.ts";
+import type { docker as localDocker } from "./docker.ts";
+import { POSTGRES_IMAGE } from "./localContainer.ts";
 
 type Query = (query: string) => Effect.Effect<string, LocalPostgresError | PostgresCommandError, ChildProcessSpawner.ChildProcessSpawner>;
 

package/src/server/adapters/hostPostgresBinaries.ts

@@ -0,0 +1,27 @@
+import { Effect, Layer, Path } from "effect";
+import { missingCommand, runCommand } from "#server/adapters/runCommand.ts";
+import { PostgresBinaries, type PostgresExecutables } from "#server/PostgresBinaries.ts";
+
+export function hostPostgresBinaries(directory?: string) {
+	return Layer.effect(
+		PostgresBinaries,
+		Effect.gen(function* () {
+			const path = yield* Path.Path;
+			const bin =
+				directory
+				?? (yield* runCommand("postgres", ["--version"]).pipe(
+					Effect.as(""),
+					Effect.catchTag("PostgresCommandError", (error) => (missingCommand(error) ? runCommand("pg_config", ["--bindir"]) : Effect.fail(error))),
+				));
+			const executables: PostgresExecutables = {
+				initdb: bin ? path.join(bin, "initdb") : "initdb",
+				pgDump: bin ? path.join(bin, "pg_dump") : "pg_dump",
+				postgres: bin ? path.join(bin, "postgres") : "postgres",
+			};
+			for (const command of Object.values(executables)) {
+				yield* runCommand(command, ["--version"]);
+			}
+			return executables;
+		}),
+	);
+}

package/src/server/{localContainer.ts → adapters/localContainer.ts}

@@ -1,9 +1,9 @@
 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";
+import { LocalPostgresError } from "#server/LocalPostgresError.ts";
+import { PostgresCommandError } from "#server/PostgresCommandError.ts";
+import { clientConnection } from "./clientConnection.ts";
+import type { docker as runDocker } from "./docker.ts";
+import type { CommandOptions } from "./runCommand.ts";
 
 export const POSTGRES_IMAGE = "postgres:18.6-alpine@sha256:77f585114c32fbca283dc835b0596f4e52b51b4c6662d7810b2f4084f60a1873";
 const CONTAINER = "development-postgres";

package/src/server/adapters/localSql.ts

@@ -0,0 +1,20 @@
+import { Effect } from "effect";
+import { assertLocalDatabase } from "#server/assertLocalDatabase.ts";
+import { LocalPostgresError } from "#server/LocalPostgresError.ts";
+import { clientConnection } from "./clientConnection.ts";
+import type { docker } from "./docker.ts";
+import { sqlInContainer } from "./localContainer.ts";
+import { type CommandOptions, missingCommand, runCommand } from "./runCommand.ts";
+
+export function localSql(localDocker: (args: readonly string[], options?: CommandOptions) => ReturnType<typeof docker>) {
+	return Effect.fn("LocalPostgres.sql")(function* (value: string | URL, query: string) {
+		const parsed = yield* Effect.try({ catch: () => new LocalPostgresError({ message: "Invalid local database URL." }), try: () => new URL(value) });
+		const { url, options } = yield* 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),
+			),
+		);
+	});
+}

package/src/server/{runCommand.ts → adapters/runCommand.ts}

@@ -1,6 +1,6 @@
 import { Effect, PlatformError, Stream } from "effect";
 import { ChildProcess, ChildProcessSpawner } from "effect/process";
-import { PostgresCommandError } from "#PostgresCommandError.ts";
+import { PostgresCommandError } from "#server/PostgresCommandError.ts";
 
 export type CommandOptions = Pick<ChildProcess.CommandOptions, "env" | "extendEnv">;
 

package/src/server/appPostgres.ts

@@ -0,0 +1,80 @@
+import { Deferred, Effect, FileSystem, Path, Stream } from "effect";
+import { ChildProcess, ChildProcessSpawner } from "effect/process";
+import { LocalPostgresError } from "#server/LocalPostgresError.ts";
+import { PostgresBinaries } from "#server/PostgresBinaries.ts";
+import { PostgresCommandError } from "#server/PostgresCommandError.ts";
+import { prepareAppPostgresData } from "#server/prepareAppPostgresData.ts";
+
+export interface AppPostgresOptions {
+	readonly backupsToKeep?: number;
+	readonly dataDirectory: string;
+}
+
+export interface AppPostgresInstance {
+	readonly backupsToKeep: number;
+	readonly connectionUrl: string;
+	readonly dataDirectory: string;
+	readonly socketDirectory: string;
+}
+
+export const appPostgres = Effect.fn("LocalPostgres.appPostgres")(function* ({ dataDirectory, backupsToKeep = 5 }: AppPostgresOptions) {
+	if (!Number.isSafeInteger(backupsToKeep) || backupsToKeep < 1) {
+		return yield* new LocalPostgresError({ message: "backupsToKeep must be a positive integer." });
+	}
+	const fs = yield* FileSystem.FileSystem;
+	const path = yield* Path.Path;
+	const binaries = yield* PostgresBinaries;
+	const spawner = yield* ChildProcessSpawner.ChildProcessSpawner;
+	const directory = path.resolve(dataDirectory);
+	yield* prepareAppPostgresData(directory);
+	const socketDirectory = yield* fs.makeTempDirectoryScoped({ prefix: "app-postgres-" });
+	yield* fs.chmod(socketDirectory, 0o700);
+	const child = yield* spawner.spawn(
+		ChildProcess.make(
+			binaries.postgres,
+			[
+				"-D",
+				directory,
+				"-h",
+				"",
+				"-k",
+				socketDirectory,
+				"-c",
+				"unix_socket_permissions=0700",
+				"-c",
+				"logging_collector=off",
+				"-c",
+				"log_destination=stderr",
+				"-c",
+				"lc_messages=C",
+			],
+			{ env: { "LC_ALL": "C" }, extendEnv: true, killSignal: "SIGINT", stdin: "ignore", stdout: "ignore" },
+		),
+	);
+	const ready = yield* Deferred.make<void>();
+	let diagnostics = "";
+	yield* child.stderr.pipe(
+		Stream.decodeText,
+		Stream.splitLines,
+		Stream.runForEach((line) => {
+			diagnostics = line;
+			return line.includes("database system is ready to accept connections") ? Deferred.succeed(ready, undefined) : Effect.void;
+		}),
+		Effect.forkScoped,
+	);
+	yield* Effect.raceFirst(
+		Deferred.await(ready),
+		Effect.flatMap(child.exitCode, (code) =>
+			Effect.fail(
+				new PostgresCommandError({
+					command: binaries.postgres,
+					exitCode: Number(code),
+					message: diagnostics || "PostgreSQL exited before becoming ready.",
+				}),
+			),
+		),
+	).pipe(Effect.timeout("30 seconds"));
+	const connection = new URL("postgresql://postgres@localhost/postgres");
+	connection.searchParams.set("host", socketDirectory);
+	return { backupsToKeep, connectionUrl: connection.toString(), dataDirectory: directory, socketDirectory } satisfies AppPostgresInstance;
+});

package/src/server/assertLocalDatabase.ts

@@ -1,5 +1,5 @@
 import { Effect } from "effect";
-import { LocalPostgresError } from "#LocalPostgresError.ts";
+import { LocalPostgresError } from "#server/LocalPostgresError.ts";
 
 export const assertLocalDatabase = Effect.fn("LocalPostgres.assertLocalDatabase")(function* (value: string, names: readonly string[]) {
 	const message = `Use a local database on 127.0.0.1:55432 named ${names.join(" or ")}.`;

package/src/server/dockerEnvironment.ts

@@ -0,0 +1,8 @@
+import { Config } from "effect";
+
+export type DockerEnvironment = Readonly<{ "DOCKER_CONTEXT"?: string | undefined; "DOCKER_HOST"?: string | undefined }>;
+
+export const dockerEnvironment = Config.all({
+	"DOCKER_CONTEXT": Config.String("DOCKER_CONTEXT").pipe(Config.withDefault("")),
+	"DOCKER_HOST": Config.String("DOCKER_HOST").pipe(Config.withDefault("")),
+});

package/src/server/localPostgres.ts

@@ -1,12 +1,13 @@
 import { Effect, Schedule } from "effect";
-import { assertLocalDatabase } from "#assertLocalDatabase.ts";
-import { clientConnection } from "#clientConnection.ts";
-import { LocalPostgresError } from "#LocalPostgresError.ts";
-import { ensureConnections } from "#localConnections.ts";
-import { sqlInContainer, startContainer } from "#localContainer.ts";
-import { type DockerEnvironment, docker } from "#localDocker.ts";
-import { PostgresVersionMismatch } from "#PostgresVersionMismatch.ts";
-import { type CommandOptions, missingCommand, runCommand } from "#runCommand.ts";
+import { docker } from "#server/adapters/docker.ts";
+import { ensureConnections } from "#server/adapters/ensureConnections.ts";
+import { startContainer } from "#server/adapters/localContainer.ts";
+import { localSql } from "#server/adapters/localSql.ts";
+import type { CommandOptions } from "#server/adapters/runCommand.ts";
+import { assertLocalDatabase } from "#server/assertLocalDatabase.ts";
+import type { DockerEnvironment } from "#server/dockerEnvironment.ts";
+import { LocalPostgresError } from "#server/LocalPostgresError.ts";
+import { PostgresVersionMismatch } from "#server/PostgresVersionMismatch.ts";
 
 export const LOCAL_SERVER = "postgresql://postgres:postgres@127.0.0.1:55432";
 
@@ -71,16 +72,3 @@ export function localPostgres(environment: DockerEnvironment, { attempts = 30, d
 	});
 	return { prepareDatabases, sql, startPostgres };
 }
-
-function localSql(localDocker: (args: readonly string[], options?: CommandOptions) => ReturnType<typeof docker>) {
-	return Effect.fn("LocalPostgres.sql")(function* (value: string | URL, query: string) {
-		const parsed = yield* Effect.try({ catch: () => new LocalPostgresError({ message: "Invalid local database URL." }), try: () => new URL(value) });
-		const { url, options } = yield* 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),
-			),
-		);
-	});
-}

package/src/server/migrateAppPostgres.ts

@@ -0,0 +1,35 @@
+import { Clock, Effect, FileSystem, Path } from "effect";
+import { runCommand } from "#server/adapters/runCommand.ts";
+import type { AppPostgresInstance } from "#server/appPostgres.ts";
+import { PostgresBinaries } from "#server/PostgresBinaries.ts";
+
+export const backupAppPostgres = Effect.fn("LocalPostgres.backupAppPostgres")(function* (instance: AppPostgresInstance) {
+	const fs = yield* FileSystem.FileSystem;
+	const path = yield* Path.Path;
+	const binaries = yield* PostgresBinaries;
+	const directory = path.join(instance.dataDirectory, "backups");
+	yield* fs.makeDirectory(directory, { mode: 0o700, recursive: true });
+	const timestamp = yield* Clock.currentTimeMillis;
+	const backup = yield* Effect.scoped(
+		Effect.gen(function* () {
+			const staging = yield* fs.makeTempDirectoryScoped({ directory, prefix: `backup-${timestamp}-` });
+			const file = path.join(staging, "dump.partial");
+			yield* runCommand(binaries.pgDump, ["--format=custom", "--file", file, "--dbname", instance.connectionUrl]);
+			const completed = `${staging}.dump`;
+			yield* fs.rename(file, completed);
+			return completed;
+		}),
+	);
+	const files = (yield* fs.readDirectory(directory))
+		.filter((name) => /^backup-\d+-.+\.dump$/u.test(name))
+		.sort()
+		.reverse();
+	for (const file of files.slice(instance.backupsToKeep)) {
+		yield* fs.remove(path.join(directory, file));
+	}
+	return backup;
+});
+
+export function migrateAppPostgres<A, E, R>(instance: AppPostgresInstance, migration: Effect.Effect<A, E, R>) {
+	return backupAppPostgres(instance).pipe(Effect.andThen(migration));
+}