@tickernelz/wardmote-db 0.0.0 → 2026.1108.2

package/dist/client-disconnect-replay.test.js

@@ -0,0 +1,182 @@
+import net from "node:net";
+import { sql } from "drizzle-orm";
+import { describe, expect, it } from "vitest";
+import { closeRegisteredClients, createDb } from "./client.js";
+/** A wire peer that receives the statement, then loses its acknowledgement. */
+async function startDisconnectingServer() {
+    const sockets = new Set();
+    let receivedEffects = 0;
+    const extendedExecutions = [];
+    const ready = Buffer.from([0x5a, 0, 0, 0, 5, 0x49]);
+    const authOk = Buffer.from([0x52, 0, 0, 0, 8, 0, 0, 0, 0]);
+    const parseComplete = Buffer.from([0x31, 0, 0, 0, 4]);
+    const bindComplete = Buffer.from([0x32, 0, 0, 0, 4]);
+    const emptyRowDescription = Buffer.from([0x54, 0, 0, 0, 6, 0, 0]);
+    const commandComplete = Buffer.from([0x43, 0, 0, 0, 0x0d, ...Buffer.from("SELECT 0\0")]);
+    const server = net.createServer((socket) => {
+        sockets.add(socket);
+        socket.on("close", () => sockets.delete(socket));
+        socket.on("error", () => { });
+        let greeted = false;
+        let pending = Buffer.alloc(0);
+        const statements = new Map();
+        const portals = new Map();
+        socket.on("data", (chunk) => {
+            pending = Buffer.concat([pending, chunk]);
+            while (pending.length >= (greeted ? 5 : 4)) {
+                const size = greeted ? pending.readUInt32BE(1) + 1 : pending.readUInt32BE(0);
+                if (pending.length < size)
+                    return;
+                const message = pending.subarray(0, size);
+                pending = pending.subarray(size);
+                if (!greeted) {
+                    greeted = true;
+                    socket.write(Buffer.concat([authOk, ready]));
+                }
+                else if (message[0] === 0x51) { // Simple Query
+                    const statement = message.subarray(5, -1).toString();
+                    if (statement.includes("disconnect_effect")) {
+                        receivedEffects += 1;
+                        // The whole statement reached the peer. Its outcome is now
+                        // ambiguous to the client, even though the error says "write".
+                        socket.destroy();
+                        return;
+                    }
+                    socket.write(Buffer.concat([commandComplete, ready]));
+                }
+                else if (message[0] === 0x50) { // Parse
+                    const nameEnd = message.indexOf(0, 5);
+                    const textEnd = message.indexOf(0, nameEnd + 1);
+                    const name = message.toString("utf8", 5, nameEnd);
+                    const text = message.toString("utf8", nameEnd + 1, textEnd);
+                    const count = message.readUInt16BE(textEnd + 1);
+                    const parameterTypes = Array.from({ length: count }, (_, index) => message.readUInt32BE(textEnd + 3 + index * 4) || 23); // int4 for this fixture's integer parameters.
+                    statements.set(name, { text, parameterTypes });
+                    socket.write(parseComplete);
+                }
+                else if (message[0] === 0x44) { // Describe statement
+                    const name = message.toString("utf8", 6, message.length - 1);
+                    const statement = statements.get(name);
+                    const description = Buffer.alloc(7 + statement.parameterTypes.length * 4);
+                    description[0] = 0x74; // ParameterDescription
+                    description.writeUInt32BE(description.length - 1, 1);
+                    description.writeUInt16BE(statement.parameterTypes.length, 5);
+                    statement.parameterTypes.forEach((type, index) => description.writeUInt32BE(type, 7 + index * 4));
+                    socket.write(Buffer.concat([description, emptyRowDescription]));
+                }
+                else if (message[0] === 0x42) { // Bind
+                    const portalEnd = message.indexOf(0, 5);
+                    const nameEnd = message.indexOf(0, portalEnd + 1);
+                    const portal = message.toString("utf8", 5, portalEnd);
+                    const name = message.toString("utf8", portalEnd + 1, nameEnd);
+                    let offset = nameEnd + 3 + message.readUInt16BE(nameEnd + 1) * 2;
+                    const count = message.readUInt16BE(offset);
+                    offset += 2;
+                    const parameters = [];
+                    for (let index = 0; index < count; index++) {
+                        const length = message.readInt32BE(offset);
+                        offset += 4;
+                        parameters.push(length === -1 ? null : message.toString("utf8", offset, offset + length));
+                        if (length !== -1)
+                            offset += length;
+                    }
+                    portals.set(portal, { statement: statements.get(name).text, prepared: name.length > 0, parameters });
+                    socket.write(bindComplete);
+                }
+                else if (message[0] === 0x45) { // Execute: Parse/Describe alone cannot execute an effect.
+                    const execution = portals.get(message.toString("utf8", 5, message.indexOf(0, 5)));
+                    extendedExecutions.push(execution);
+                    if (execution.statement.includes("disconnect_effect")) {
+                        receivedEffects += 1;
+                        socket.destroy();
+                        return;
+                    }
+                    socket.write(commandComplete);
+                }
+                else if (message[0] === 0x53) { // Sync
+                    socket.write(ready);
+                }
+            }
+        });
+    });
+    await new Promise((resolve) => server.listen(0, "127.0.0.1", resolve));
+    const port = server.address().port;
+    return {
+        url: `postgres://test:test@127.0.0.1:${port}/test`,
+        receivedEffects: () => receivedEffects,
+        extendedExecutions: () => extendedExecutions,
+        close: async () => {
+            for (const socket of sockets)
+                socket.destroy();
+            await new Promise((resolve) => server.close(() => resolve()));
+        },
+    };
+}
+describe("database connection loss after statement delivery", () => {
+    it.each(["drizzle", "prepared"])("does not replay a parameterized mutation (%s)", async (surface) => {
+        const peer = await startDisconnectingServer();
+        try {
+            // Keep the default client settings. Drizzle uses unsafe(), which selects
+            // unnamed statements; tagged client queries use named prepared statements.
+            const db = createDb(peer.url, { maxConnections: 1, connectTimeoutSeconds: 2 });
+            const client = db.$client;
+            const pending = surface === "drizzle"
+                ? db.execute(sql `insert into disconnect_effect(value) values (${42})`)
+                : client `insert into disconnect_effect(value) values (${42})`;
+            const error = await pending.then(() => null, (failure) => failure);
+            expect(error).toBeInstanceOf(Error);
+            const driverError = error instanceof Error && error.cause ? error.cause : error;
+            expect(driverError).toMatchObject({
+                code: "CONNECTION_CLOSED",
+                message: expect.stringContaining("write CONNECTION_CLOSED"),
+            });
+            expect(peer.receivedEffects()).toBe(1);
+            expect(peer.extendedExecutions().filter((execution) => execution.statement.includes("disconnect_effect")))
+                .toEqual([{ statement: "insert into disconnect_effect(value) values ($1)", prepared: surface === "prepared", parameters: ["42"] }]);
+            const freshQuery = surface === "drizzle" ? db.execute(sql `select ${7}`) : client `select ${7}`;
+            await expect(freshQuery).resolves.toBeDefined();
+            expect(peer.extendedExecutions().at(-1))
+                .toEqual({ statement: "select $1", prepared: surface === "prepared", parameters: ["7"] });
+            expect(peer.receivedEffects()).toBe(1);
+        }
+        finally {
+            await peer.close();
+            await closeRegisteredClients(peer.url);
+        }
+    });
+    for (const statement of [
+        "insert into disconnect_effect default values",
+        "select disconnect_effect()",
+        "with effect as (insert into disconnect_effect default values returning *) select * from effect",
+    ]) {
+        it.each(["rows", "values"])(`does not replay ${statement} (%s)`, async (shape) => {
+            const peer = await startDisconnectingServer();
+            try {
+                const db = createDb(peer.url, { maxConnections: 1, connectTimeoutSeconds: 2, prepare: false });
+                const client = db.$client;
+                const pending = shape === "rows"
+                    ? db.execute(sql.raw(statement))
+                    : client.unsafe(statement).values();
+                // This is the real postgres.js error, not a mock that invents a
+                // distinct "read CONNECTION_CLOSED" shape for an in-flight query.
+                const error = await pending.then(() => null, (failure) => failure);
+                expect(error).toBeInstanceOf(Error);
+                const driverError = error instanceof Error && error.cause ? error.cause : error;
+                expect(driverError).toMatchObject({
+                    code: "CONNECTION_CLOSED",
+                    message: expect.stringContaining("write CONNECTION_CLOSED"),
+                });
+                expect(peer.receivedEffects()).toBe(1);
+                // Failing the ambiguous statement must not poison the pool. A new
+                // operation can reconnect, without resubmitting the failed effect.
+                await expect(db.execute(sql `select 0`)).resolves.toBeDefined();
+                expect(peer.receivedEffects()).toBe(1);
+            }
+            finally {
+                await peer.close();
+                await closeRegisteredClients(peer.url);
+            }
+        });
+    }
+});
+//# sourceMappingURL=client-disconnect-replay.test.js.map

package/dist/client-disconnect-replay.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-disconnect-replay.test.js","sourceRoot":"","sources":["../src/client-disconnect-replay.test.ts"],"names":[],"mappings":"AAAA,OAAO,GAAG,MAAM,UAAU,CAAC;AAC3B,OAAO,EAAE,GAAG,EAAE,MAAM,aAAa,CAAC;AAElC,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,sBAAsB,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE/D,+EAA+E;AAC/E,KAAK,UAAU,wBAAwB;IACrC,MAAM,OAAO,GAAG,IAAI,GAAG,EAAc,CAAC;IACtC,IAAI,eAAe,GAAG,CAAC,CAAC;IACxB,MAAM,kBAAkB,GAAsF,EAAE,CAAC;IACjH,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC;IACpD,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAC3D,MAAM,aAAa,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACtD,MAAM,YAAY,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACrD,MAAM,mBAAmB,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAClE,MAAM,eAAe,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,IAAI,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IACzF,MAAM,MAAM,GAAG,GAAG,CAAC,YAAY,CAAC,CAAC,MAAM,EAAE,EAAE;QACzC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACpB,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;QACjD,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QAC7B,IAAI,OAAO,GAAG,KAAK,CAAC;QACpB,IAAI,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAC9B,MAAM,UAAU,GAAG,IAAI,GAAG,EAAsD,CAAC;QACjF,MAAM,OAAO,GAAG,IAAI,GAAG,EAAsF,CAAC;QAC9G,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE;YAC1B,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC;YAC1C,OAAO,OAAO,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC3C,MAAM,IAAI,GAAG,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;gBAC7E,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI;oBAAE,OAAO;gBAClC,MAAM,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;gBAC1C,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;gBACjC,IAAI,CAAC,OAAO,EAAE,CAAC;oBACb,OAAO,GAAG,IAAI,CAAC;oBACf,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;gBAC/C,CAAC;qBAAM,IAAI,OAAO,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,eAAe;oBAC/C,MAAM,SAAS,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC;oBACrD,IAAI,SAAS,CAAC,QAAQ,CAAC,mBAAmB,CAAC,EAAE,CAAC;wBAC5C,eAAe,IAAI,CAAC,CAAC;wBACrB,2DAA2D;wBAC3D,+DAA+D;wBAC/D,MAAM,CAAC,OAAO,EAAE,CAAC;wBACjB,OAAO;oBACT,CAAC;oBACD,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,eAAe,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;gBACxD,CAAC;qBAAM,IAAI,OAAO,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,QAAQ;oBACxC,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;oBACtC,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,CAAC,CAAC;oBAChD,MAAM,IAAI,GAAG,OAAO,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,OAAO,CAAC,CAAC;oBAClD,MAAM,IAAI,GAAG,OAAO,CAAC,QAAQ,CAAC,MAAM,EAAE,OAAO,GAAG,CAAC,EAAE,OAAO,CAAC,CAAC;oBAC5D,MAAM,KAAK,GAAG,OAAO,CAAC,YAAY,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC;oBAChD,MAAM,cAAc,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,CAChE,OAAO,CAAC,YAAY,CAAC,OAAO,GAAG,CAAC,GAAG,KAAK,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,8CAA8C;oBACtG,UAAU,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,cAAc,EAAE,CAAC,CAAC;oBAC/C,MAAM,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;gBAC9B,CAAC;qBAAM,IAAI,OAAO,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,qBAAqB;oBACrD,MAAM,IAAI,GAAG,OAAO,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;oBAC7D,MAAM,SAAS,GAAG,UAAU,CAAC,GAAG,CAAC,IAAI,CAAE,CAAC;oBACxC,MAAM,WAAW,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,GAAG,SAAS,CAAC,cAAc,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;oBAC1E,WAAW,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,uBAAuB;oBAC9C,WAAW,CAAC,aAAa,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;oBACrD,WAAW,CAAC,aAAa,CAAC,SAAS,CAAC,cAAc,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;oBAC9D,SAAS,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,WAAW,CAAC,aAAa,CAAC,IAAI,EAAE,CAAC,GAAG,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC;oBAClG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,mBAAmB,CAAC,CAAC,CAAC,CAAC;gBAClE,CAAC;qBAAM,IAAI,OAAO,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,OAAO;oBACvC,MAAM,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;oBACxC,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,EAAE,SAAS,GAAG,CAAC,CAAC,CAAC;oBAClD,MAAM,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,SAAS,CAAC,CAAC;oBACtD,MAAM,IAAI,GAAG,OAAO,CAAC,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,CAAC,EAAE,OAAO,CAAC,CAAC;oBAC9D,IAAI,MAAM,GAAG,OAAO,GAAG,CAAC,GAAG,OAAO,CAAC,YAAY,CAAC,OAAO,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC;oBACjE,MAAM,KAAK,GAAG,OAAO,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;oBAC3C,MAAM,IAAI,CAAC,CAAC;oBACZ,MAAM,UAAU,GAAyB,EAAE,CAAC;oBAC5C,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC;wBAC3C,MAAM,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;wBAC3C,MAAM,IAAI,CAAC,CAAC;wBACZ,UAAU,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC;wBAC1F,IAAI,MAAM,KAAK,CAAC,CAAC;4BAAE,MAAM,IAAI,MAAM,CAAC;oBACtC,CAAC;oBACD,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,UAAU,CAAC,GAAG,CAAC,IAAI,CAAE,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC;oBACtG,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;gBAC7B,CAAC;qBAAM,IAAI,OAAO,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,0DAA0D;oBAC1F,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAE,CAAC;oBACnF,kBAAkB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;oBACnC,IAAI,SAAS,CAAC,SAAS,CAAC,QAAQ,CAAC,mBAAmB,CAAC,EAAE,CAAC;wBACtD,eAAe,IAAI,CAAC,CAAC;wBACrB,MAAM,CAAC,OAAO,EAAE,CAAC;wBACjB,OAAO;oBACT,CAAC;oBACD,MAAM,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;gBAChC,CAAC;qBAAM,IAAI,OAAO,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,OAAO;oBACvC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;gBACtB,CAAC;YACH,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IACH,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,WAAW,EAAE,OAAO,CAAC,CAAC,CAAC;IAC7E,MAAM,IAAI,GAAI,MAAM,CAAC,OAAO,EAAsB,CAAC,IAAI,CAAC;IACxD,OAAO;QACL,GAAG,EAAE,kCAAkC,IAAI,OAAO;QAClD,eAAe,EAAE,GAAG,EAAE,CAAC,eAAe;QACtC,kBAAkB,EAAE,GAAG,EAAE,CAAC,kBAAkB;QAC5C,KAAK,EAAE,KAAK,IAAI,EAAE;YAChB,KAAK,MAAM,MAAM,IAAI,OAAO;gBAAE,MAAM,CAAC,OAAO,EAAE,CAAC;YAC/C,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;QACtE,CAAC;KACF,CAAC;AACJ,CAAC;AAED,QAAQ,CAAC,mDAAmD,EAAE,GAAG,EAAE;IACjE,EAAE,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,UAAU,CAAU,CAAC,CAAC,+CAA+C,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;QAC3G,MAAM,IAAI,GAAG,MAAM,wBAAwB,EAAE,CAAC;QAC9C,IAAI,CAAC;YACH,yEAAyE;YACzE,2EAA2E;YAC3E,MAAM,EAAE,GAAG,QAAQ,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,cAAc,EAAE,CAAC,EAAE,qBAAqB,EAAE,CAAC,EAAE,CAAC,CAAC;YAC/E,MAAM,MAAM,GAAG,EAAE,CAAC,OAAO,CAAC;YAC1B,MAAM,OAAO,GAAG,OAAO,KAAK,SAAS;gBACnC,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,GAAG,CAAA,gDAAgD,EAAE,GAAG,CAAC;gBACtE,CAAC,CAAC,MAAM,CAAA,gDAAgD,EAAE,GAAG,CAAC;YAChE,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,EAAE,CAAC,OAAgB,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC;YAC5E,MAAM,CAAC,KAAK,CAAC,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;YACpC,MAAM,WAAW,GAAG,KAAK,YAAY,KAAK,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC;YAChF,MAAM,CAAC,WAAW,CAAC,CAAC,aAAa,CAAC;gBAChC,IAAI,EAAE,mBAAmB;gBACzB,OAAO,EAAE,MAAM,CAAC,gBAAgB,CAAC,yBAAyB,CAAC;aAC5D,CAAC,CAAC;YACH,MAAM,CAAC,IAAI,CAAC,eAAe,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YACvC,MAAM,CAAC,IAAI,CAAC,kBAAkB,EAAE,CAAC,MAAM,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,SAAS,CAAC,QAAQ,CAAC,mBAAmB,CAAC,CAAC,CAAC;iBACvG,OAAO,CAAC,CAAC,EAAE,SAAS,EAAE,kDAAkD,EAAE,QAAQ,EAAE,OAAO,KAAK,UAAU,EAAE,UAAU,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;YAEtI,MAAM,UAAU,GAAG,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,GAAG,CAAA,UAAU,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,CAAA,UAAU,CAAC,EAAE,CAAC;YAC9F,MAAM,MAAM,CAAC,UAAU,CAAC,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC;YAChD,MAAM,CAAC,IAAI,CAAC,kBAAkB,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;iBACrC,OAAO,CAAC,EAAE,SAAS,EAAE,WAAW,EAAE,QAAQ,EAAE,OAAO,KAAK,UAAU,EAAE,UAAU,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAC5F,MAAM,CAAC,IAAI,CAAC,eAAe,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACzC,CAAC;gBAAS,CAAC;YACT,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC;YACnB,MAAM,sBAAsB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACzC,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,KAAK,MAAM,SAAS,IAAI;QACtB,8CAA8C;QAC9C,4BAA4B;QAC5B,gGAAgG;KACjG,EAAE,CAAC;QACF,EAAE,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,QAAQ,CAAU,CAAC,CAAC,mBAAmB,SAAS,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;YACxF,MAAM,IAAI,GAAG,MAAM,wBAAwB,EAAE,CAAC;YAC9C,IAAI,CAAC;gBACH,MAAM,EAAE,GAAG,QAAQ,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,cAAc,EAAE,CAAC,EAAE,qBAAqB,EAAE,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;gBAC/F,MAAM,MAAM,GAAI,EAAkC,CAAC,OAAO,CAAC;gBAC3D,MAAM,OAAO,GAAG,KAAK,KAAK,MAAM;oBAC9B,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;oBAChC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,MAAM,EAAE,CAAC;gBACtC,gEAAgE;gBAChE,kEAAkE;gBAClE,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,EAAE,CAAC,OAAgB,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC;gBAC5E,MAAM,CAAC,KAAK,CAAC,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;gBACpC,MAAM,WAAW,GAAG,KAAK,YAAY,KAAK,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC;gBAChF,MAAM,CAAC,WAAW,CAAC,CAAC,aAAa,CAAC;oBAChC,IAAI,EAAE,mBAAmB;oBACzB,OAAO,EAAE,MAAM,CAAC,gBAAgB,CAAC,yBAAyB,CAAC;iBAC5D,CAAC,CAAC;gBACH,MAAM,CAAC,IAAI,CAAC,eAAe,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;gBAEvC,kEAAkE;gBAClE,mEAAmE;gBACnE,MAAM,MAAM,CAAC,EAAE,CAAC,OAAO,CAAC,GAAG,CAAA,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC;gBAC/D,MAAM,CAAC,IAAI,CAAC,eAAe,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YACzC,CAAC;oBAAS,CAAC;gBACT,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC;gBACnB,MAAM,sBAAsB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACzC,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;AACH,CAAC,CAAC,CAAC"}

package/dist/client-options.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=client-options.test.d.ts.map

package/dist/client-options.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-options.test.d.ts","sourceRoot":"","sources":["../src/client-options.test.ts"],"names":[],"mappings":""}

package/dist/client-options.test.js

@@ -0,0 +1,88 @@
+import { describe, expect, it } from "vitest";
+import { DEFAULT_DATABASE_APPLICATION_NAME, DEFAULT_DATABASE_IDLE_TIMEOUT_SECONDS, databaseClientOptionsFromEnv, postgresJsOptions, resolveDatabaseClientOptions, } from "./client.js";
+describe("databaseClientOptionsFromEnv", () => {
+    it("returns no options when nothing is set, preserving driver defaults", () => {
+        expect(databaseClientOptionsFromEnv({})).toEqual({});
+        expect(postgresJsOptions(databaseClientOptionsFromEnv({}))).toEqual({});
+    });
+    it("ignores empty values", () => {
+        expect(databaseClientOptionsFromEnv({
+            DATABASE_PREPARED_STATEMENTS: "",
+            DATABASE_POOL_MAX: "",
+        })).toEqual({});
+    });
+    it("parses prepared-statement toggles", () => {
+        expect(databaseClientOptionsFromEnv({ DATABASE_PREPARED_STATEMENTS: "false" })).toEqual({ prepare: false });
+        expect(databaseClientOptionsFromEnv({ DATABASE_PREPARED_STATEMENTS: "0" })).toEqual({ prepare: false });
+        expect(databaseClientOptionsFromEnv({ DATABASE_PREPARED_STATEMENTS: "true" })).toEqual({ prepare: true });
+        expect(databaseClientOptionsFromEnv({ DATABASE_PREPARED_STATEMENTS: "TRUE" })).toEqual({ prepare: true });
+    });
+    it("parses pool and timeout settings", () => {
+        expect(databaseClientOptionsFromEnv({
+            DATABASE_POOL_MAX: "25",
+            DATABASE_IDLE_TIMEOUT_SECONDS: "60",
+            DATABASE_CONNECT_TIMEOUT_SECONDS: "10",
+            DATABASE_MAX_LIFETIME_SECONDS: "1800",
+            DATABASE_APPLICATION_NAME: " paperclip-web ",
+        })).toEqual({
+            maxConnections: 25,
+            idleTimeoutSeconds: 60,
+            connectTimeoutSeconds: 10,
+            maxLifetimeSeconds: 1800,
+            applicationName: "paperclip-web",
+        });
+    });
+    it("accepts DATABASE_IDLE_TIMEOUT_SECONDS=0 as an explicit opt-out of idle reaping", () => {
+        expect(databaseClientOptionsFromEnv({ DATABASE_IDLE_TIMEOUT_SECONDS: "0" })).toEqual({ idleTimeoutSeconds: 0 });
+    });
+    it("rejects malformed values instead of silently ignoring them", () => {
+        expect(() => databaseClientOptionsFromEnv({ DATABASE_PREPARED_STATEMENTS: "maybe" })).toThrow(/DATABASE_PREPARED_STATEMENTS/);
+        expect(() => databaseClientOptionsFromEnv({ DATABASE_POOL_MAX: "0" })).toThrow(/DATABASE_POOL_MAX/);
+        expect(() => databaseClientOptionsFromEnv({ DATABASE_POOL_MAX: "-3" })).toThrow(/DATABASE_POOL_MAX/);
+        expect(() => databaseClientOptionsFromEnv({ DATABASE_CONNECT_TIMEOUT_SECONDS: "1.5" })).toThrow(/DATABASE_CONNECT_TIMEOUT_SECONDS/);
+        expect(() => databaseClientOptionsFromEnv({ DATABASE_IDLE_TIMEOUT_SECONDS: "-1" })).toThrow(/DATABASE_IDLE_TIMEOUT_SECONDS/);
+        expect(() => databaseClientOptionsFromEnv({ DATABASE_IDLE_TIMEOUT_SECONDS: "abc" })).toThrow(/DATABASE_IDLE_TIMEOUT_SECONDS/);
+        expect(() => databaseClientOptionsFromEnv({ DATABASE_MAX_LIFETIME_SECONDS: "0" })).toThrow(/DATABASE_MAX_LIFETIME_SECONDS/);
+        expect(() => databaseClientOptionsFromEnv({ DATABASE_MAX_LIFETIME_SECONDS: "NaN" })).toThrow(/DATABASE_MAX_LIFETIME_SECONDS/);
+    });
+    it("maps to postgres.js option names", () => {
+        expect(postgresJsOptions({
+            prepare: false,
+            maxConnections: 25,
+            idleTimeoutSeconds: 60,
+            connectTimeoutSeconds: 10,
+            maxLifetimeSeconds: 1800,
+            applicationName: "paperclip-web",
+        })).toEqual({
+            prepare: false,
+            max: 25,
+            idle_timeout: 60,
+            connect_timeout: 10,
+            max_lifetime: 1800,
+            connection: { application_name: "paperclip-web" },
+        });
+    });
+});
+describe("resolveDatabaseClientOptions", () => {
+    it("reaps idle connections and names the pool when the environment sets nothing", () => {
+        expect(resolveDatabaseClientOptions({})).toEqual({
+            idleTimeoutSeconds: DEFAULT_DATABASE_IDLE_TIMEOUT_SECONDS,
+            applicationName: DEFAULT_DATABASE_APPLICATION_NAME,
+        });
+        expect(postgresJsOptions(resolveDatabaseClientOptions(databaseClientOptionsFromEnv({})))).toEqual({
+            idle_timeout: DEFAULT_DATABASE_IDLE_TIMEOUT_SECONDS,
+            connection: { application_name: DEFAULT_DATABASE_APPLICATION_NAME },
+        });
+    });
+    it("keeps every explicit value, including an idle timeout of 0", () => {
+        expect(resolveDatabaseClientOptions({
+            maxConnections: 3,
+            idleTimeoutSeconds: 0,
+            applicationName: "paperclip-cli",
+        })).toEqual({ maxConnections: 3, idleTimeoutSeconds: 0, applicationName: "paperclip-cli" });
+        expect(postgresJsOptions(resolveDatabaseClientOptions({ idleTimeoutSeconds: 0 }))).toMatchObject({
+            idle_timeout: 0,
+        });
+    });
+});
+//# sourceMappingURL=client-options.test.js.map

package/dist/client-options.test.js.map

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

package/dist/client-teardown-registry.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=client-teardown-registry.test.d.ts.map

package/dist/client-teardown-registry.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-teardown-registry.test.d.ts","sourceRoot":"","sources":["../src/client-teardown-registry.test.ts"],"names":[],"mappings":""}

package/dist/client-teardown-registry.test.js

@@ -0,0 +1,100 @@
+import net from "node:net";
+import { afterEach, describe, expect, it } from "vitest";
+import { closeRegisteredClients, createDb } from "./client.js";
+/**
+ * A fake wire-protocol server. It speaks just enough of the startup and
+ * query flow to hand a postgres.js client an open connection: it replies to
+ * the startup message with `AuthenticationOk` plus `ReadyForQuery`, then
+ * replies to any later message with an empty result set plus
+ * `ReadyForQuery`. No real query needs to succeed for this test.
+ */
+function startFakePostgresServer() {
+    const backendSockets = [];
+    const authOk = Buffer.from([0x52, 0, 0, 0, 8, 0, 0, 0, 0]);
+    const readyForQuery = Buffer.from([0x5a, 0, 0, 0, 5, 0x49]);
+    const emptyQueryReply = Buffer.concat([
+        Buffer.from([0x31, 0, 0, 0, 4]), // ParseComplete
+        Buffer.from([0x32, 0, 0, 0, 4]), // BindComplete
+        Buffer.from([0x54, 0, 0, 0, 6, 0, 0]), // RowDescription, zero fields
+        Buffer.from([0x43, 0, 0, 0, 0x0d, 0x53, 0x45, 0x4c, 0x45, 0x43, 0x54, 0x20, 0x30, 0]), // CommandComplete "SELECT 0"
+    ]);
+    const server = net.createServer((socket) => {
+        backendSockets.push(socket);
+        let greeted = false;
+        socket.on("data", () => {
+            if (!greeted) {
+                greeted = true;
+                socket.write(Buffer.concat([authOk, readyForQuery]));
+                return;
+            }
+            socket.write(Buffer.concat([emptyQueryReply, readyForQuery]));
+        });
+        socket.on("error", () => { });
+    });
+    return new Promise((resolve) => {
+        server.listen(0, "127.0.0.1", () => {
+            const port = server.address().port;
+            resolve({ server, port, backendSockets });
+        });
+    });
+}
+describe("closeRegisteredClients", () => {
+    let server = null;
+    afterEach(async () => {
+        if (server)
+            await new Promise((resolve) => server.close(resolve));
+        server = null;
+    });
+    it("ends a reserved connection before its backend dies, so no query can reach a null socket", async () => {
+        const started = await startFakePostgresServer();
+        server = started.server;
+        const url = `postgres://test:test@127.0.0.1:${started.port}/test`;
+        const db = createDb(url, { connectTimeoutSeconds: 5 });
+        // `sql.reserve()` pins one physical connection. Drizzle `db.transaction()`
+        // reaches the same surface through `sql.begin()`, so this stands in for a
+        // suite that left a transaction connection open.
+        const reserved = await db.$client.reserve();
+        // The driver calls this only after it has fully processed a connection
+        // close: its socket reference cleared and any in-flight query failed.
+        // Waiting for it, instead of a fixed number of ticks, is what the
+        // historical crash reproduction does — it is real observed state from
+        // the driver, not a guess at timing.
+        const driverProcessedClose = new Promise((resolve) => {
+            db.$client.options.onclose = () => resolve();
+        });
+        // This is the order our fixture owns: end every registered client for
+        // this host and port before a caller stops the cluster it points at.
+        await closeRegisteredClients(url);
+        // Simulate the cluster stop that follows in the real fixture. Before the
+        // fix, killing the backend here while a client still held the reserved
+        // connection open crashed the process on a later deferred write.
+        for (const socket of started.backendSockets)
+            socket.destroy();
+        await driverProcessedClose;
+        // A query sent only after the driver finished processing the close still
+        // buffers its frame for a deferred flush one tick later. If the fix let
+        // the reserved connection outlive the backend, that flush reaches a
+        // cleared socket reference and throws from inside the timer callback —
+        // this specific promise then never settles, because nothing on that
+        // path ever calls its resolve or reject. This test's own timeout (the
+        // suite default) is what turns that hang into a reported failure,
+        // alongside the unhandled exception the crash raises separately.
+        const settled = await reserved `select 1`.catch((error) => error);
+        expect(settled).toBeInstanceOf(Error);
+        // Let the deferred flush actually run. If it still fires against a null
+        // socket, it surfaces here as an unhandled error and fails this test
+        // file — the exact signature the fix protects against.
+        await new Promise((resolve) => setImmediate(() => setImmediate(resolve)));
+    });
+    it("does nothing when no client is registered for a host and port", async () => {
+        await expect(closeRegisteredClients("postgres://test:test@127.0.0.1:1/test")).resolves.toBeUndefined();
+    });
+    it("does not throw when createDb receives a URL that new URL() cannot parse", async () => {
+        let db;
+        expect(() => {
+            db = createDb("", { connectTimeoutSeconds: 1 });
+        }).not.toThrow();
+        await db?.$client.end({ timeout: 0 }).catch(() => { });
+    });
+});
+//# sourceMappingURL=client-teardown-registry.test.js.map

package/dist/client-teardown-registry.test.js.map

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

package/dist/client.d.ts

@@ -0,0 +1,112 @@
+import postgres from "postgres";
+import * as schema from "./schema/index.js";
+/**
+ * Ends every live client `createDb` handed out for the given URL's host and
+ * port, then forgets them. Call this before stopping a Postgres cluster: a
+ * client that outlives the cluster it points at can crash the process (a
+ * reserved connection's deferred write firing after the socket is gone).
+ * Swallows individual `end()` errors so one bad client cannot block the rest.
+ */
+export declare function closeRegisteredClients(url: string): Promise<void>;
+export type MigrationState = {
+    status: "upToDate";
+    tableCount: number;
+    availableMigrations: string[];
+    appliedMigrations: string[];
+    journalEntryCount: number;
+} | {
+    status: "needsMigrations";
+    tableCount: number;
+    availableMigrations: string[];
+    appliedMigrations: string[];
+    pendingMigrations: string[];
+    journalEntryCount: number;
+    reason: "no-migration-journal-empty-db" | "no-migration-journal-non-empty-db" | "pending-migrations";
+};
+export interface DatabaseClientOptions {
+    /**
+     * postgres.js `prepare`. Set false when connecting through a
+     * transaction-mode pooler (pgbouncer / Neon `-pooler` endpoints /
+     * Supabase Supavisor transaction ports) so the client does not rely on
+     * session-scoped prepared statements. Defaults to the driver default
+     * (enabled), preserving existing behavior on direct connections.
+     */
+    prepare?: boolean;
+    /** postgres.js `max` — connection pool size (driver default: 10). */
+    maxConnections?: number;
+    /** postgres.js `idle_timeout` in seconds (driver default: disabled). */
+    idleTimeoutSeconds?: number;
+    /** postgres.js `connect_timeout` in seconds (driver default: 30). */
+    connectTimeoutSeconds?: number;
+    /**
+     * postgres.js `max_lifetime` in seconds. Bounds how long one pooled
+     * connection is reused before the client replaces it (driver default: a
+     * random value between 30 and 60 minutes).
+     */
+    maxLifetimeSeconds?: number;
+    /**
+     * postgres.js `connection.application_name`, shown in
+     * `pg_stat_activity.application_name`. Lets an operator tell Paperclip's
+     * pool apart from other clients of the same database (driver default:
+     * `postgres.js`).
+     */
+    applicationName?: string;
+}
+/**
+ * Idle pooled connections close after this many seconds unless
+ * `DATABASE_IDLE_TIMEOUT_SECONDS` says otherwise. The driver default keeps an
+ * idle connection open forever, so a process that stops issuing queries still
+ * holds every backend it ever opened. Set `DATABASE_IDLE_TIMEOUT_SECONDS=0`
+ * to restore the driver default.
+ */
+export declare const DEFAULT_DATABASE_IDLE_TIMEOUT_SECONDS = 60;
+/** `application_name` reported to PostgreSQL unless `DATABASE_APPLICATION_NAME` overrides it. */
+export declare const DEFAULT_DATABASE_APPLICATION_NAME = "paperclip";
+/**
+ * Database client tuning from the environment, so hosted deployments can
+ * adapt to their connection topology (pooled endpoints, network latency)
+ * without editing source. Every variable is optional. This function returns
+ * only the values the environment sets; `resolveDatabaseClientOptions` adds
+ * Paperclip's own defaults on top, and the driver defaults apply to the rest
+ * — self-hosted setups need none of these.
+ */
+export declare function databaseClientOptionsFromEnv(env?: NodeJS.ProcessEnv): DatabaseClientOptions;
+/**
+ * Fills in Paperclip's defaults for the options the caller left unset: idle
+ * connections are reaped after `DEFAULT_DATABASE_IDLE_TIMEOUT_SECONDS`, and the
+ * pool identifies itself as `DEFAULT_DATABASE_APPLICATION_NAME`. Everything
+ * else stays at the driver default. An explicit value (including
+ * `idleTimeoutSeconds: 0`) always wins over the default.
+ */
+export declare function resolveDatabaseClientOptions(options: DatabaseClientOptions): DatabaseClientOptions;
+export declare function postgresJsOptions(options: DatabaseClientOptions): Record<string, unknown>;
+export declare function withDedicatedDbConnection<T>(db: Db, action: (dedicated: Db) => Promise<T>): Promise<T>;
+export declare function createDb(url: string, options?: DatabaseClientOptions): import("drizzle-orm/postgres-js").PostgresJsDatabase<typeof schema> & {
+    $client: postgres.Sql<{}>;
+};
+export declare function getPostgresDataDirectory(url: string): Promise<string | null>;
+export type MigrationHistoryReconcileResult = {
+    repairedMigrations: string[];
+    remainingMigrations: string[];
+};
+export declare function reconcilePendingMigrationHistory(url: string): Promise<MigrationHistoryReconcileResult>;
+export declare function inspectMigrations(url: string): Promise<MigrationState>;
+export declare function applyPendingMigrations(url: string): Promise<void>;
+export type MigrationBootstrapResult = {
+    migrated: true;
+    reason: "migrated-empty-db";
+    tableCount: 0;
+} | {
+    migrated: false;
+    reason: "already-migrated";
+    tableCount: number;
+} | {
+    migrated: false;
+    reason: "not-empty-no-migration-journal";
+    tableCount: number;
+};
+export declare function migratePostgresIfEmpty(url: string): Promise<MigrationBootstrapResult>;
+export declare function ensurePostgresDatabase(url: string, databaseName: string): Promise<"created" | "exists">;
+export declare function resetPostgresDatabase(url: string, databaseName: string): Promise<"reset">;
+export type Db = ReturnType<typeof createDb>;
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

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