@tickernelz/paperclip-pro-db 2026.925.0

package/dist/table-size-estimates.js

@@ -0,0 +1,153 @@
+export const TABLE_SIZE_ESTIMATE_SOURCE = {
+    collectedAt: "2026-07-06",
+    database: "default local dev embedded Postgres",
+    method: "SELECT count(*) in a read-only transaction",
+};
+export const TABLE_SIZE_ESTIMATE_FACTOR = 250;
+export const TABLE_SIZE_BUCKET_THRESHOLDS = {
+    largeRows: 1_000_000,
+    mediumRows: 100_000,
+};
+export const LOCAL_TABLE_ROW_COUNTS = [
+    { table: "agent_wakeup_requests", localRows: 52_791 },
+    { table: "activity_log", localRows: 22_930 },
+    { table: "issue_reference_mentions", localRows: 13_218 },
+    { table: "heartbeat_run_events", localRows: 10_833 },
+    { table: "issue_comments", localRows: 5_034 },
+    { table: "document_revisions", localRows: 3_906 },
+    { table: "heartbeat_runs", localRows: 3_620 },
+    { table: "workspace_operations", localRows: 3_600 },
+    { table: "environment_leases", localRows: 3_492 },
+    { table: "cost_events", localRows: 3_330 },
+    { table: "agent_task_sessions", localRows: 1_743 },
+    { table: "documents", localRows: 1_692 },
+    { table: "issue_documents", localRows: 1_678 },
+    { table: "issues", localRows: 1_609 },
+    { table: "secret_access_events", localRows: 933 },
+    { table: "issue_read_states", localRows: 608 },
+    { table: "issue_thread_interactions", localRows: 455 },
+    { table: "issue_relations", localRows: 445 },
+    { table: "execution_workspaces", localRows: 414 },
+    { table: "agent_config_revisions", localRows: 145 },
+    { table: "document_annotation_anchor_snapshots", localRows: 132 },
+    { table: "document_annotation_comments", localRows: 122 },
+    { table: "document_annotation_threads", localRows: 80 },
+    { table: "routine_revisions", localRows: 64 },
+    { table: "issue_tree_hold_members", localRows: 62 },
+    { table: "routine_runs", localRows: 52 },
+    { table: "issue_recovery_actions", localRows: 50 },
+    { table: "assets", localRows: 46 },
+    { table: "issue_attachments", localRows: 44 },
+    { table: "principal_permission_grants", localRows: 25 },
+    { table: "company_memberships", localRows: 19 },
+    { table: "agent_runtime_state", localRows: 18 },
+    { table: "agents", localRows: 18 },
+    { table: "routine_triggers", localRows: 16 },
+    { table: "company_skills", localRows: 15 },
+    { table: "routine_documents", localRows: 14 },
+    { table: "routines", localRows: 14 },
+    { table: "issue_inbox_archives", localRows: 13 },
+    { table: "issue_approvals", localRows: 12 },
+    { table: "company_secret_bindings", localRows: 11 },
+    { table: "issue_tree_holds", localRows: 10 },
+    { table: "approvals", localRows: 9 },
+    { table: "session", localRows: 9 },
+    { table: "issue_work_products", localRows: 7 },
+    { table: "company_skill_versions", localRows: 6 },
+    { table: "feedback_exports", localRows: 6 },
+    { table: "feedback_votes", localRows: 6 },
+    { table: "issue_execution_decisions", localRows: 6 },
+    { table: "company_secret_versions", localRows: 3 },
+    { table: "company_secrets", localRows: 3 },
+    { table: "projects", localRows: 3 },
+    { table: "approval_comments", localRows: 2 },
+    { table: "goals", localRows: 2 },
+    { table: "project_goals", localRows: 2 },
+    { table: "project_workspaces", localRows: 2 },
+    { table: "account", localRows: 1 },
+    { table: "companies", localRows: 1 },
+    { table: "environments", localRows: 1 },
+    { table: "instance_settings", localRows: 1 },
+    { table: "instance_user_roles", localRows: 1 },
+    { table: "user", localRows: 1 },
+    { table: "agent_api_keys", localRows: 0 },
+    { table: "agent_memberships", localRows: 0 },
+    { table: "board_api_keys", localRows: 0 },
+    { table: "budget_incidents", localRows: 0 },
+    { table: "budget_policies", localRows: 0 },
+    { table: "cli_auth_challenges", localRows: 0 },
+    { table: "company_logos", localRows: 0 },
+    { table: "company_secret_provider_configs", localRows: 0 },
+    { table: "company_skill_comments", localRows: 0 },
+    { table: "company_skill_stars", localRows: 0 },
+    { table: "company_user_sidebar_preferences", localRows: 0 },
+    { table: "environment_custom_image_setup_sessions", localRows: 0 },
+    { table: "environment_custom_image_templates", localRows: 0 },
+    { table: "external_object_mentions", localRows: 0 },
+    { table: "external_objects", localRows: 0 },
+    { table: "finance_events", localRows: 0 },
+    { table: "heartbeat_run_watchdog_decisions", localRows: 0 },
+    { table: "inbox_dismissals", localRows: 0 },
+    { table: "invites", localRows: 0 },
+    { table: "issue_labels", localRows: 0 },
+    { table: "issue_plan_decompositions", localRows: 0 },
+    { table: "issue_watchdogs", localRows: 0 },
+    { table: "join_requests", localRows: 0 },
+    { table: "labels", localRows: 0 },
+    { table: "pipeline_automation_executions", localRows: 0 },
+    { table: "pipeline_case_blockers", localRows: 0 },
+    { table: "pipeline_case_documents", localRows: 0 },
+    { table: "pipeline_case_events", localRows: 0 },
+    { table: "pipeline_case_issue_links", localRows: 0 },
+    { table: "pipeline_cases", localRows: 0 },
+    { table: "pipeline_documents", localRows: 0 },
+    { table: "pipeline_stages", localRows: 0 },
+    { table: "pipeline_transitions", localRows: 0 },
+    { table: "pipelines", localRows: 0 },
+    { table: "plugin_company_settings", localRows: 0 },
+    { table: "plugin_config", localRows: 0 },
+    { table: "plugin_database_namespaces", localRows: 0 },
+    { table: "plugin_entities", localRows: 0 },
+    { table: "plugin_job_runs", localRows: 0 },
+    { table: "plugin_jobs", localRows: 0 },
+    { table: "plugin_logs", localRows: 0 },
+    { table: "plugin_managed_resources", localRows: 0 },
+    { table: "plugin_migrations", localRows: 0 },
+    { table: "plugin_state", localRows: 0 },
+    { table: "plugin_webhook_deliveries", localRows: 0 },
+    { table: "plugins", localRows: 0 },
+    { table: "project_memberships", localRows: 0 },
+    { table: "user_secret_declarations", localRows: 0 },
+    { table: "user_secret_definitions", localRows: 0 },
+    { table: "user_sidebar_preferences", localRows: 0 },
+    { table: "verification", localRows: 0 },
+    { table: "workspace_runtime_services", localRows: 0 },
+];
+function bucketForEstimatedRows(estimatedRows) {
+    if (estimatedRows >= TABLE_SIZE_BUCKET_THRESHOLDS.largeRows)
+        return "large";
+    if (estimatedRows >= TABLE_SIZE_BUCKET_THRESHOLDS.mediumRows)
+        return "medium";
+    return "small";
+}
+export const TABLE_SIZE_ESTIMATES = LOCAL_TABLE_ROW_COUNTS.map(({ table, localRows }) => {
+    const estimatedRows = localRows * TABLE_SIZE_ESTIMATE_FACTOR;
+    return {
+        table,
+        localRows,
+        estimateFactor: TABLE_SIZE_ESTIMATE_FACTOR,
+        estimatedRows,
+        bucket: bucketForEstimatedRows(estimatedRows),
+    };
+});
+export const TABLE_SIZE_ESTIMATES_BY_TABLE = new Map(TABLE_SIZE_ESTIMATES.map((estimate) => [estimate.table, estimate]));
+export function getTableSizeEstimate(table) {
+    return TABLE_SIZE_ESTIMATES_BY_TABLE.get(table);
+}
+export function getTableSizeBucket(table) {
+    return getTableSizeEstimate(table)?.bucket ?? "small";
+}
+export function isKnownLargeTable(table) {
+    return getTableSizeBucket(table) === "large";
+}
+//# sourceMappingURL=table-size-estimates.js.map

package/dist/table-size-estimates.js.map

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

package/dist/test-embedded-postgres.d.ts

@@ -0,0 +1,37 @@
+export declare const EMBEDDED_POSTGRES_TEST_TIMEOUT_MS = 90000;
+type EmbeddedPostgresInstance = {
+    initialise(): Promise<void>;
+    start(): Promise<void>;
+    stop(): Promise<void>;
+};
+type EmbeddedPostgresCtor = new (opts: {
+    databaseDir: string;
+    user: string;
+    password: string;
+    port: number;
+    persistent: boolean;
+    initdbFlags?: string[];
+    onLog?: (message: unknown) => void;
+    onError?: (message: unknown) => void;
+}) => EmbeddedPostgresInstance;
+export type EmbeddedPostgresTestSupport = {
+    supported: boolean;
+    reason?: string;
+};
+export type EmbeddedPostgresTestDatabase = {
+    connectionString: string;
+    cleanup(): Promise<void>;
+};
+type EmbeddedPostgresCtorProvider = () => Promise<EmbeddedPostgresCtor>;
+export declare function __setEmbeddedPostgresCtorProviderForTests(provider: EmbeddedPostgresCtorProvider | null): void;
+declare function startEmbeddedPostgresWithRetry(tempDirPrefix: string): Promise<{
+    port: number;
+    dataDir: string;
+    instance: EmbeddedPostgresInstance;
+}>;
+export declare const __startEmbeddedPostgresWithRetryForTests: typeof startEmbeddedPostgresWithRetry;
+export declare const __embeddedPostgresStartMaxAttemptsForTests = 5;
+export declare function getEmbeddedPostgresTestSupport(): Promise<EmbeddedPostgresTestSupport>;
+export declare function startEmbeddedPostgresTestDatabase(tempDirPrefix: string): Promise<EmbeddedPostgresTestDatabase>;
+export {};
+//# sourceMappingURL=test-embedded-postgres.d.ts.map

package/dist/test-embedded-postgres.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-embedded-postgres.d.ts","sourceRoot":"","sources":["../src/test-embedded-postgres.ts"],"names":[],"mappings":"AAiBA,eAAO,MAAM,iCAAiC,QAAS,CAAC;AAExD,KAAK,wBAAwB,GAAG;IAC9B,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACvB,CAAC;AAEF,KAAK,oBAAoB,GAAG,KAAK,IAAI,EAAE;IACrC,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,OAAO,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;IACnC,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;CACtC,KAAK,wBAAwB,CAAC;AAE/B,MAAM,MAAM,2BAA2B,GAAG;IACxC,SAAS,EAAE,OAAO,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,4BAA4B,GAAG;IACzC,gBAAgB,EAAE,MAAM,CAAC;IACzB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B,CAAC;AAiBF,KAAK,4BAA4B,GAAG,MAAM,OAAO,CAAC,oBAAoB,CAAC,CAAC;AAaxE,wBAAgB,yCAAyC,CACvD,QAAQ,EAAE,4BAA4B,GAAG,IAAI,GAC5C,IAAI,CAEN;AAkID,iBAAe,8BAA8B,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC;IAC5E,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,wBAAwB,CAAC;CACpC,CAAC,CAyBD;AAKD,eAAO,MAAM,wCAAwC,uCAAiC,CAAC;AACvF,eAAO,MAAM,0CAA0C,IAAuC,CAAC;AAuB/F,wBAAsB,8BAA8B,IAAI,OAAO,CAAC,2BAA2B,CAAC,CAK3F;AAED,wBAAsB,iCAAiC,CACrD,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,4BAA4B,CAAC,CAiCvC"}

package/dist/test-embedded-postgres.js

@@ -0,0 +1,240 @@
+import fs from "node:fs";
+import net from "node:net";
+import os from "node:os";
+import path from "node:path";
+import { applyPendingMigrations, closeRegisteredClients, ensurePostgresDatabase } from "./client.js";
+import { createEmbeddedPostgresLogBuffer, formatEmbeddedPostgresError, } from "./embedded-postgres-error.js";
+import { prepareEmbeddedPostgresNativeRuntime } from "./embedded-postgres-native.js";
+// Time budget (ms) for a vitest test in the embedded-Postgres cost class: a
+// test that starts an embedded Postgres cluster and runs migrations. Measured
+// evidence: this cost class normally finishes in well under 10s. Under a
+// contended CI runner the same test took up to 4.9x longer. This budget
+// gives about 10x headroom over the clean time, so a contended run still
+// passes while a genuine hang still fails fast.
+export const EMBEDDED_POSTGRES_TEST_TIMEOUT_MS = 90_000;
+let embeddedPostgresSupportPromise = null;
+const DEFAULT_PAPERCLIP_EMBEDDED_POSTGRES_PORT = 54329;
+function getReservedTestPorts() {
+    const configuredPorts = [
+        DEFAULT_PAPERCLIP_EMBEDDED_POSTGRES_PORT,
+        Number.parseInt(process.env.PAPERCLIP_EMBEDDED_POSTGRES_PORT ?? "", 10),
+        ...String(process.env.PAPERCLIP_TEST_POSTGRES_RESERVED_PORTS ?? "")
+            .split(",")
+            .map((value) => Number.parseInt(value.trim(), 10)),
+    ];
+    return new Set(configuredPorts.filter((port) => Number.isInteger(port) && port > 0 && port <= 65535));
+}
+async function loadEmbeddedPostgresCtor() {
+    const mod = await import("embedded-postgres");
+    await prepareEmbeddedPostgresNativeRuntime();
+    return mod.default;
+}
+let embeddedPostgresCtorProvider = loadEmbeddedPostgresCtor;
+// Test seam. Replace the embedded-postgres constructor provider so a test can
+// simulate a failed start without the native runtime. Pass `null` to restore
+// the default provider. This module is test support only, so the seam is safe.
+export function __setEmbeddedPostgresCtorProviderForTests(provider) {
+    embeddedPostgresCtorProvider = provider ?? loadEmbeddedPostgresCtor;
+}
+async function getEmbeddedPostgresCtor() {
+    return await embeddedPostgresCtorProvider();
+}
+async function getAvailablePort() {
+    const reservedPorts = getReservedTestPorts();
+    for (let attempt = 0; attempt < 20; attempt += 1) {
+        const port = await new Promise((resolve, reject) => {
+            const server = net.createServer();
+            server.unref();
+            server.on("error", reject);
+            server.listen(0, "127.0.0.1", () => {
+                const address = server.address();
+                if (!address || typeof address === "string") {
+                    server.close(() => reject(new Error("Failed to allocate test port")));
+                    return;
+                }
+                const { port } = address;
+                server.close((error) => {
+                    if (error)
+                        reject(error);
+                    else
+                        resolve(port);
+                });
+            });
+        });
+        if (!reservedPorts.has(port))
+            return port;
+    }
+    throw new Error(`Failed to allocate embedded Postgres test port outside reserved Paperclip ports: ${[
+        ...reservedPorts,
+    ].join(", ")}`);
+}
+async function createEmbeddedPostgresTestInstance(tempDirPrefix) {
+    const dataDir = fs.mkdtempSync(path.join(os.tmpdir(), tempDirPrefix));
+    const port = await getAvailablePort();
+    const EmbeddedPostgres = await getEmbeddedPostgresCtor();
+    // Postgres writes the true reason for a failed start to its output, for
+    // example `could not bind IPv4 address "127.0.0.1": Address already in use`.
+    // The `start()` rejection carries an empty message, so we capture the output
+    // in a bounded buffer and surface it in the thrown error.
+    const logBuffer = createEmbeddedPostgresLogBuffer();
+    const instance = new EmbeddedPostgres({
+        databaseDir: dataDir,
+        user: "paperclip",
+        password: "paperclip",
+        port,
+        persistent: true,
+        initdbFlags: ["--encoding=UTF8", "--locale=C", "--lc-messages=C"],
+        onLog: (message) => logBuffer.append(message),
+        onError: (message) => logBuffer.append(message),
+    });
+    return { dataDir, port, instance, getRecentLogs: () => logBuffer.getRecentLogs() };
+}
+function cleanupEmbeddedPostgresTestDirs(dataDir) {
+    fs.rmSync(dataDir, { recursive: true, force: true });
+}
+// Upper bound (ms) on how long we wait for the embedded Postgres cluster to
+// stop gracefully before abandoning the wait and returning from the hook.
+const EMBEDDED_POSTGRES_STOP_TIMEOUT_MS = 5000;
+// `embedded-postgres@18.1.0-beta.16` exposes only `stop(): Promise<void>` — no
+// shutdown-mode argument. Internally it SIGINTs the postgres process (already
+// PostgreSQL "fast shutdown") and resolves *only* on the child's `exit` event,
+// with no time bound of its own. Under the loaded serial server shard a slow
+// shutdown checkpoint can push that past vitest's hookTimeout and hang the
+// afterAll hook. So we bound the graceful stop: if it overruns, we stop waiting
+// and return so the hook completes. The SIGINT has already been delivered, so
+// the abandoned process still exits on its own (and again when the runner exits).
+// Errors are swallowed, matching prior behavior.
+//
+// `cleanupFn` (data-dir reclaim) is chained on the raw `stop()` promise, not on
+// the timeout race, so the disposable data dir is removed *only after* `stop()`
+// actually settles — i.e. once the child Postgres process has exited. Removing
+// it on the timeout path would pull the data files out from under a still-running
+// cluster and provoke checkpoint / WAL I/O errors. In the fast path `cleanupFn`
+// has run by the time this resolves; in the timeout path it runs asynchronously
+// once the abandoned process finally exits.
+async function stopEmbeddedPostgresBounded(instance, cleanupFn) {
+    if (!instance) {
+        cleanupFn?.();
+        return;
+    }
+    let timer;
+    const stopped = instance
+        .stop()
+        .catch(() => {
+        // Swallow shutdown errors — the data dir is reclaimed regardless.
+    })
+        .finally(() => {
+        try {
+            cleanupFn?.();
+        }
+        catch {
+            // Best-effort reclaim; ignore removal errors.
+        }
+    });
+    try {
+        await Promise.race([
+            stopped,
+            new Promise((resolve) => {
+                timer = setTimeout(resolve, EMBEDDED_POSTGRES_STOP_TIMEOUT_MS);
+                timer.unref?.();
+            }),
+        ]);
+    }
+    finally {
+        if (timer)
+            clearTimeout(timer);
+    }
+}
+// Upper bound on start attempts. `getAvailablePort` uses a check-then-use probe:
+// it binds port 0, reads the assigned port, closes the probe, then Postgres binds
+// that port. Under load another process can take the port in that window, so the
+// bind fails with "Address already in use" and `start()` rejects. Each retry uses
+// a fresh port and a fresh data directory, so a transient collision clears.
+const EMBEDDED_POSTGRES_START_MAX_ATTEMPTS = 5;
+// Start one embedded Postgres cluster with a bounded retry. Each attempt gets a
+// fresh port and a fresh data directory. On a failed attempt we stop the cluster
+// and remove its data directory before the next attempt. After the last attempt
+// we throw with the real Postgres output so the failure is loud and diagnosable.
+async function startEmbeddedPostgresWithRetry(tempDirPrefix) {
+    let lastError = new Error("embedded Postgres startup failed");
+    for (let attempt = 1; attempt <= EMBEDDED_POSTGRES_START_MAX_ATTEMPTS; attempt += 1) {
+        const created = await createEmbeddedPostgresTestInstance(tempDirPrefix);
+        try {
+            await created.instance.initialise();
+            await created.instance.start();
+            return { port: created.port, dataDir: created.dataDir, instance: created.instance };
+        }
+        catch (error) {
+            lastError = formatEmbeddedPostgresError(error, {
+                fallbackMessage: "embedded Postgres startup failed",
+                recentLogs: created.getRecentLogs(),
+            });
+            // Stop the failed cluster and remove its data directory. The next attempt
+            // allocates a fresh port and a fresh data directory.
+            await stopEmbeddedPostgresBounded(created.instance, () => cleanupEmbeddedPostgresTestDirs(created.dataDir));
+        }
+    }
+    throw new Error(`Failed to start embedded PostgreSQL test database after ${EMBEDDED_POSTGRES_START_MAX_ATTEMPTS} attempts: ${lastError.message}`);
+}
+// Test-only accessors. Production callers use `startEmbeddedPostgresTestDatabase`
+// or `getEmbeddedPostgresTestSupport`. A test drives the bounded retry directly
+// so it does not need a real Postgres connection.
+export const __startEmbeddedPostgresWithRetryForTests = startEmbeddedPostgresWithRetry;
+export const __embeddedPostgresStartMaxAttemptsForTests = EMBEDDED_POSTGRES_START_MAX_ATTEMPTS;
+async function probeEmbeddedPostgresSupport() {
+    let started = null;
+    try {
+        started = await startEmbeddedPostgresWithRetry("paperclip-embedded-postgres-probe-");
+        return { supported: true };
+    }
+    catch (error) {
+        return {
+            supported: false,
+            reason: formatEmbeddedPostgresError(error, {
+                fallbackMessage: "embedded Postgres startup failed",
+            }).message,
+        };
+    }
+    finally {
+        if (started) {
+            const { dataDir, instance } = started;
+            await stopEmbeddedPostgresBounded(instance, () => cleanupEmbeddedPostgresTestDirs(dataDir));
+        }
+    }
+}
+export async function getEmbeddedPostgresTestSupport() {
+    if (!embeddedPostgresSupportPromise) {
+        embeddedPostgresSupportPromise = probeEmbeddedPostgresSupport();
+    }
+    return await embeddedPostgresSupportPromise;
+}
+export async function startEmbeddedPostgresTestDatabase(tempDirPrefix) {
+    // The bounded retry hardens the cluster start against the port race. It throws
+    // with the real Postgres output if every attempt fails.
+    const { port, dataDir, instance } = await startEmbeddedPostgresWithRetry(tempDirPrefix);
+    try {
+        const adminConnectionString = `postgres://paperclip:paperclip@127.0.0.1:${port}/postgres`;
+        await ensurePostgresDatabase(adminConnectionString, "paperclip");
+        const connectionString = `postgres://paperclip:paperclip@127.0.0.1:${port}/paperclip`;
+        await applyPendingMigrations(connectionString);
+        return {
+            connectionString,
+            cleanup: async () => {
+                // End every client a caller created against this cluster first. A
+                // client that still holds a reserved connection when the cluster
+                // stops can crash the process: the stop kills the backend socket,
+                // but a queued write on that connection still fires later and finds
+                // a null socket.
+                await closeRegisteredClients(connectionString);
+                await stopEmbeddedPostgresBounded(instance, () => cleanupEmbeddedPostgresTestDirs(dataDir));
+            },
+        };
+    }
+    catch (error) {
+        await stopEmbeddedPostgresBounded(instance, () => cleanupEmbeddedPostgresTestDirs(dataDir));
+        throw new Error(`Failed to start embedded PostgreSQL test database: ${formatEmbeddedPostgresError(error, {
+            fallbackMessage: "embedded Postgres startup failed",
+        }).message}`);
+    }
+}
+//# sourceMappingURL=test-embedded-postgres.js.map

package/dist/test-embedded-postgres.js.map

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

package/dist/test-embedded-postgres.test.d.ts

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

package/dist/test-embedded-postgres.test.d.ts.map

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

package/dist/test-embedded-postgres.test.js

@@ -0,0 +1,76 @@
+import fs from "node:fs";
+import { afterEach, describe, expect, it } from "vitest";
+import { __embeddedPostgresStartMaxAttemptsForTests as MAX_ATTEMPTS, __setEmbeddedPostgresCtorProviderForTests, __startEmbeddedPostgresWithRetryForTests as startWithRetry, } from "./test-embedded-postgres.js";
+const BIND_CONFLICT_LOG = 'could not bind IPv4 address "127.0.0.1": Address already in use';
+function makeFakeCtor(failFirst) {
+    const constructed = [];
+    let started = 0;
+    class FakeEmbeddedPostgres {
+        options;
+        constructor(options) {
+            this.options = options;
+            constructed.push(options);
+        }
+        async initialise() { }
+        async start() {
+            started += 1;
+            if (started <= failFirst) {
+                // Mirror the real failure: Postgres logs the reason, then `start()`
+                // rejects with an Error whose message is empty.
+                this.options.onLog?.(BIND_CONFLICT_LOG);
+                throw new Error();
+            }
+        }
+        async stop() { }
+    }
+    return { ctor: FakeEmbeddedPostgres, constructed };
+}
+describe("startEmbeddedPostgresWithRetry", () => {
+    afterEach(() => {
+        __setEmbeddedPostgresCtorProviderForTests(null);
+    });
+    it("recovers from a transient port conflict and returns on a later attempt", async () => {
+        const { ctor, constructed } = makeFakeCtor(2);
+        __setEmbeddedPostgresCtorProviderForTests(async () => ctor);
+        const started = await startWithRetry("paperclip-retry-recover-");
+        // The first two attempts fail, the third succeeds.
+        expect(constructed).toHaveLength(3);
+        // Each attempt uses a fresh data directory. The two failed directories are
+        // removed. The returned directory still exists.
+        const dataDirs = constructed.map((options) => options.databaseDir);
+        expect(new Set(dataDirs).size).toBe(3);
+        expect(fs.existsSync(dataDirs[0])).toBe(false);
+        expect(fs.existsSync(dataDirs[1])).toBe(false);
+        expect(started.dataDir).toBe(dataDirs[2]);
+        expect(fs.existsSync(started.dataDir)).toBe(true);
+        // Each attempt allocates a port.
+        for (const options of constructed) {
+            expect(Number.isInteger(options.port)).toBe(true);
+            expect(options.port).toBeGreaterThan(0);
+        }
+        // Clean up the returned attempt.
+        await started.instance.stop();
+        fs.rmSync(started.dataDir, { recursive: true, force: true });
+    });
+    it("throws with the real Postgres output after the attempt bound", async () => {
+        const { ctor, constructed } = makeFakeCtor(Number.POSITIVE_INFINITY);
+        __setEmbeddedPostgresCtorProviderForTests(async () => ctor);
+        await expect(startWithRetry("paperclip-retry-fail-")).rejects.toThrow(/after \d+ attempts/);
+        // The retry stops at the bound and does not loop forever.
+        expect(constructed).toHaveLength(MAX_ATTEMPTS);
+        // Every failed attempt removes its data directory.
+        for (const options of constructed) {
+            expect(fs.existsSync(options.databaseDir)).toBe(false);
+        }
+    });
+    it("keeps the real failure reason instead of a generic fallback", async () => {
+        const { ctor } = makeFakeCtor(Number.POSITIVE_INFINITY);
+        __setEmbeddedPostgresCtorProviderForTests(async () => ctor);
+        const error = await startWithRetry("paperclip-retry-reason-").catch((caught) => caught);
+        expect(error).toBeInstanceOf(Error);
+        // The thrown message carries the captured Postgres output, not only the
+        // generic "embedded Postgres startup failed" text.
+        expect(error.message).toContain("Address already in use");
+    });
+});
+//# sourceMappingURL=test-embedded-postgres.test.js.map

package/dist/test-embedded-postgres.test.js.map

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

package/dist/transient-write-retry.d.ts

@@ -0,0 +1,4 @@
+import type { Sql } from "postgres";
+export declare function isTransientWritePhaseError(error: unknown): boolean;
+export declare function withTransientWriteRetry<T extends Sql>(sql: T): T;
+//# sourceMappingURL=transient-write-retry.d.ts.map

package/dist/transient-write-retry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transient-write-retry.d.ts","sourceRoot":"","sources":["../src/transient-write-retry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAuBpC,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAMlE;AAMD,wBAAgB,uBAAuB,CAAC,CAAC,SAAS,GAAG,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,CAsDhE"}

package/dist/transient-write-retry.js

@@ -0,0 +1,79 @@
+/**
+ * Replays a query whose bytes never reached the server.
+ *
+ * Behind a connection pooler (Neon's PgBouncer), the server side of an idle
+ * connection can be recycled while the client still holds the socket. The
+ * next query then fails at the socket write — postgres.js reports it as
+ * `write CONNECTION_CLOSED <host>:<port>` with `code: "CONNECTION_CLOSED"`.
+ * Because the write itself failed, the server never saw the query, so
+ * replaying it on a fresh connection cannot double-execute anything — the
+ * replay is safe for reads and writes alike. Every other error, including a
+ * connection lost mid-query (where the server may have acted), propagates
+ * untouched.
+ *
+ * Drizzle routes every non-transactional query through the root client's
+ * `unsafe`; queries inside `db.transaction()` run on the scoped client
+ * `sql.begin()` hands out, which this wrapper deliberately does not touch —
+ * a transaction that loses its connection must abort, not replay.
+ */
+const TRANSIENT_WRITE_ATTEMPTS = 3;
+const TRANSIENT_WRITE_BACKOFF_MS = 50;
+export function isTransientWritePhaseError(error) {
+    return (error instanceof Error &&
+        error.code === "CONNECTION_CLOSED" &&
+        error.message.startsWith("write CONNECTION_CLOSED"));
+}
+export function withTransientWriteRetry(sql) {
+    const runWithRetry = async (execute) => {
+        for (let attempt = 0;; attempt++) {
+            try {
+                return await execute();
+            }
+            catch (error) {
+                if (attempt >= TRANSIENT_WRITE_ATTEMPTS - 1 || !isTransientWritePhaseError(error)) {
+                    throw error;
+                }
+                await new Promise((resolve) => setTimeout(resolve, TRANSIENT_WRITE_BACKOFF_MS * (attempt + 1)));
+            }
+        }
+    };
+    return new Proxy(sql, {
+        get(target, property, receiver) {
+            if (property !== "unsafe")
+                return Reflect.get(target, property, receiver);
+            const unsafe = target.unsafe.bind(target);
+            const retryingUnsafe = (query, parameters, ...rest) => {
+                if (rest.length > 0) {
+                    // An options argument selects driver surfaces this wrapper does not
+                    // model; leave those calls exactly as they were.
+                    return target.unsafe(query, parameters, ...rest);
+                }
+                // postgres.js queries execute lazily, exactly once, and `.values()`
+                // selects the row shape of that one execution rather than starting a
+                // second one. Mirror both halves: the execution starts when a consumer
+                // first settles the query, `.values()` marks the shape and returns the
+                // same pending query, and every later handler joins the same run. A
+                // shape chosen after the run started cannot change it — the same as
+                // the driver, and the reason a mutation can never execute twice here.
+                let started;
+                let wantsValues = false;
+                const runOnce = () => (started ??= runWithRetry(() => wantsValues
+                    ? unsafe(query, parameters).values()
+                    : Promise.resolve(unsafe(query, parameters))));
+                const pending = {
+                    then: (onFulfilled, onRejected) => runOnce().then(onFulfilled, onRejected),
+                    catch: (onRejected) => runOnce().catch(onRejected),
+                    finally: (onFinally) => runOnce().finally(onFinally),
+                    values: () => {
+                        if (!started)
+                            wantsValues = true;
+                        return pending;
+                    },
+                };
+                return pending;
+            };
+            return retryingUnsafe;
+        },
+    });
+}
+//# sourceMappingURL=transient-write-retry.js.map