@tickernelz/paperclip-pro-db 2026.925.0

package/dist/run-event-payload.d.ts

@@ -0,0 +1,30 @@
+/** Keep JSONB routing fields queryable while retaining JSON strings containing NUL. */
+export declare function encodeRunEventPayload(payload: Record<string, unknown>): string;
+export declare function decodeRunEventPayload(value: string | Record<string, unknown>): Record<string, unknown>;
+export declare const runEventPayload: {
+    (): import("drizzle-orm/pg-core").PgCustomColumnBuilder<{
+        name: "";
+        dataType: 'custom';
+        columnType: 'PgCustomColumn';
+        data: Record<string, unknown>;
+        driverParam: string;
+        enumValues: undefined;
+    }>;
+    <TConfig extends Record<string, any> & unknown>(fieldConfig?: TConfig | undefined): import("drizzle-orm/pg-core").PgCustomColumnBuilder<{
+        name: "";
+        dataType: 'custom';
+        columnType: 'PgCustomColumn';
+        data: Record<string, unknown>;
+        driverParam: string;
+        enumValues: undefined;
+    }>;
+    <TName extends string>(dbName: TName, fieldConfig?: unknown): import("drizzle-orm/pg-core").PgCustomColumnBuilder<{
+        name: TName;
+        dataType: 'custom';
+        columnType: 'PgCustomColumn';
+        data: Record<string, unknown>;
+        driverParam: string;
+        enumValues: undefined;
+    }>;
+};
+//# sourceMappingURL=run-event-payload.d.ts.map

package/dist/run-event-payload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-event-payload.d.ts","sourceRoot":"","sources":["../src/run-event-payload.ts"],"names":[],"mappings":"AAKA,uFAAuF;AACvF,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CA6B9E;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAYtG;AAGD,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;CAO1B,CAAC"}

package/dist/run-event-payload.js

@@ -0,0 +1,57 @@
+import { customType } from "drizzle-orm/pg-core";
+// Reserved only in the on-disk representation, never in a decoded event.
+const originalJsonKey = "$paperclipRunEventJsonV1";
+/** Keep JSONB routing fields queryable while retaining JSON strings containing NUL. */
+export function encodeRunEventPayload(payload) {
+    const originalJson = JSON.stringify(payload);
+    if (!originalJson.includes("\\u0000") && !originalJson.includes(originalJsonKey)) {
+        return originalJson;
+    }
+    const original = JSON.parse(originalJson);
+    let needsEncoding = Object.hasOwn(original, originalJsonKey);
+    function projectString(value) {
+        if (!value.includes("\u0000"))
+            return value;
+        needsEncoding = true;
+        return value.replaceAll("\u0000", "\\u0000");
+    }
+    function project(value) {
+        if (typeof value === "string")
+            return projectString(value);
+        if (Array.isArray(value))
+            return value.map(project);
+        if (value !== null && typeof value === "object") {
+            return Object.fromEntries(Object.entries(value).map(([key, entry]) => [
+                projectString(key), project(entry),
+            ]));
+        }
+        return value;
+    }
+    const projection = project(original);
+    if (!needsEncoding)
+        return originalJson;
+    // JSON.stringify escapes the original JSON a second time: PostgreSQL receives
+    // literal backslashes, not an unsupported U+0000. Decode before hashing/replay.
+    return JSON.stringify({ ...projection, [originalJsonKey]: originalJson });
+}
+export function decodeRunEventPayload(value) {
+    const payload = typeof value === "string" ? JSON.parse(value) : value;
+    if (Object.hasOwn(payload, originalJsonKey)) {
+        const originalJson = payload[originalJsonKey];
+        if (typeof originalJson !== "string")
+            throw new Error("Invalid run-event payload encoding");
+        const original = JSON.parse(originalJson);
+        if (original === null || typeof original !== "object" || Array.isArray(original)) {
+            throw new Error("Invalid run-event payload encoding");
+        }
+        return original;
+    }
+    return payload;
+}
+// The SQL type stays JSONB; existing rows and SQL routing queries are unchanged.
+export const runEventPayload = customType({
+    dataType: () => "jsonb",
+    toDriver: encodeRunEventPayload,
+    fromDriver: decodeRunEventPayload,
+});
+//# sourceMappingURL=run-event-payload.js.map

package/dist/run-event-payload.js.map

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

package/dist/run-event-payload.test.d.ts

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

package/dist/run-event-payload.test.d.ts.map

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

package/dist/run-event-payload.test.js

@@ -0,0 +1,46 @@
+import { describe, expect, it } from "vitest";
+import { decodeRunEventPayload, encodeRunEventPayload } from "./run-event-payload.js";
+describe("run-event JSONB payload codec", () => {
+    it("leaves ordinary payloads and literal escape sequences unchanged", () => {
+        const payload = { prpEvent: { payload: { output: "virtual:\\u0000file.js", emoji: "🧪" } } };
+        const encoded = encodeRunEventPayload(payload);
+        expect(encoded).toBe(JSON.stringify(payload));
+        expect(decodeRunEventPayload(encoded)).toEqual(payload);
+        expect(decodeRunEventPayload(payload)).toBe(payload);
+    });
+    it("round-trips NULs in nested strings, arrays and keys without leaking its sidecar", () => {
+        const payload = {
+            prpEvent: {
+                sourceKind: "runner",
+                payload: { output: "../\u0000virtual:/file.js", items: [null, true, 1, "\u0000"] },
+            },
+            "\u0000key": "a",
+            "\\u0000key": "b",
+        };
+        const encoded = encodeRunEventPayload(payload);
+        const stored = JSON.parse(encoded);
+        expect(stored.prpEvent.sourceKind).toBe("runner");
+        expect(stored.prpEvent.payload.output).toBe("../\\u0000virtual:/file.js");
+        // No actual NUL survives anywhere in the object sent to PostgreSQL.
+        function assertNoNul(value) {
+            if (typeof value === "string")
+                expect(value).not.toContain("\u0000");
+            if (value !== null && typeof value === "object") {
+                for (const [key, entry] of Object.entries(value)) {
+                    expect(key).not.toContain("\u0000");
+                    assertNoNul(entry);
+                }
+            }
+        }
+        assertNoNul(stored);
+        expect(decodeRunEventPayload(encoded)).toEqual(payload);
+        expect(decodeRunEventPayload(stored)).toEqual(payload);
+    });
+    it("preserves caller-owned keys that collide with the storage marker", () => {
+        for (const value of ["not JSON", '{"forged":true}', null, { nested: "\u0000" }]) {
+            const payload = { $paperclipRunEventJsonV1: value, output: "original" };
+            expect(decodeRunEventPayload(encodeRunEventPayload(payload))).toEqual(payload);
+        }
+    });
+});
+//# sourceMappingURL=run-event-payload.test.js.map

package/dist/run-event-payload.test.js.map

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

package/dist/run-identity-migration.test.d.ts

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

package/dist/run-identity-migration.test.d.ts.map

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

package/dist/run-identity-migration.test.js

@@ -0,0 +1,60 @@
+import { randomUUID } from "node:crypto";
+import { readFileSync } from "node:fs";
+import postgres from "postgres";
+import { describe, expect, it } from "vitest";
+import { getEmbeddedPostgresTestSupport, startEmbeddedPostgresTestDatabase } from "./test-embedded-postgres.js";
+const support = await getEmbeddedPostgresTestSupport();
+const migrations = [
+    "0240_pink_fantastic_four.sql", "0241_conscious_adam_destine.sql",
+    "0242_wide_lightspeed.sql", "0243_sleepy_metal_master.sql", "0244_organic_meltdown.sql", "0245_misty_nightshade.sql",
+].map((name) => readFileSync(new URL(`./migrations/${name}`, import.meta.url), "utf8"));
+(support.supported ? describe : describe.skip)("execution identity migration", () => {
+    it("can replay without inventing historical authorship or losing accepted contexts", async () => {
+        const database = await startEmbeddedPostgresTestDatabase("paperclip-identity-migration-");
+        const sql = postgres(database.connectionString, { max: 1, onnotice: () => { } });
+        try {
+            const companyId = randomUUID(), agentId = randomUUID(), historicalRunId = randomUUID(), runId = randomUUID(), contextId = randomUUID();
+            await sql `INSERT INTO companies (id, name, issue_prefix) VALUES (${companyId}, 'Identity migration', 'MIG')`;
+            await sql `INSERT INTO agents (id, company_id, name, role, adapter_type) VALUES (${agentId}, ${companyId}, 'Shared', 'engineer', 'codex_local')`;
+            await sql `INSERT INTO heartbeat_runs (id, company_id, agent_id, status) VALUES
+        (${historicalRunId}, ${companyId}, ${agentId}, 'succeeded'), (${runId}, ${companyId}, ${agentId}, 'running')`;
+            await sql `INSERT INTO run_identity_contexts (id, company_id, run_id, revision, responsible_user_id, cause, correlation_id, accepted_at)
+        VALUES (${contextId}, ${companyId}, ${runId}, 1, 'person-a', 'instruction', 'dispatch', now())`;
+            await sql `UPDATE heartbeat_runs SET active_identity_context_id = ${contextId}, responsible_user_id = 'person-a' WHERE id = ${runId}`;
+            for (let pass = 0; pass < 2; pass++) {
+                for (const migration of migrations) {
+                    for (const statement of migration.split('--> statement-breakpoint')) {
+                        if (statement.trim())
+                            await sql.unsafe(statement);
+                    }
+                }
+            }
+            const [historical] = await sql `SELECT active_identity_context_id, responsible_user_id FROM heartbeat_runs WHERE id = ${historicalRunId}`;
+            expect(historical).toEqual({ active_identity_context_id: null, responsible_user_id: null });
+            const contexts = await sql `SELECT id, responsible_user_id FROM run_identity_contexts WHERE company_id = ${companyId}`;
+            expect(contexts).toEqual([{ id: contextId, responsible_user_id: 'person-a' }]);
+            const [active] = await sql `SELECT active_identity_context_id FROM heartbeat_runs WHERE id = ${runId}`;
+            expect(active.active_identity_context_id).toBe(contextId);
+            // Agent removal deletes its run rows, but surviving task continuations
+            // must retain attribution. Even replaying the migration set must be safe.
+            await sql `DELETE FROM heartbeat_runs WHERE id = ${runId}`;
+            for (const migration of migrations) {
+                for (const statement of migration.split('--> statement-breakpoint')) {
+                    if (statement.trim())
+                        await sql.unsafe(statement);
+                }
+            }
+            const [retained] = await sql `SELECT run_id, responsible_user_id FROM run_identity_contexts WHERE id = ${contextId}`;
+            expect(retained).toEqual({ run_id: runId, responsible_user_id: 'person-a' });
+            await sql `DELETE FROM heartbeat_runs WHERE company_id = ${companyId}`;
+            await sql `DELETE FROM agents WHERE company_id = ${companyId}`;
+            await sql `DELETE FROM companies WHERE id = ${companyId}`;
+            expect(await sql `SELECT id FROM run_identity_contexts WHERE id = ${contextId}`).toHaveLength(0);
+        }
+        finally {
+            await sql.end();
+            await database.cleanup();
+        }
+    }, 30_000);
+});
+//# sourceMappingURL=run-identity-migration.test.js.map

package/dist/run-identity-migration.test.js.map

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

package/dist/runtime-config.d.ts

@@ -0,0 +1,16 @@
+export type ResolvedDatabaseTarget = {
+    mode: "postgres";
+    connectionString: string;
+    source: "DATABASE_URL" | "paperclip-env" | "config.database.connectionString";
+    configPath: string;
+    envPath: string;
+} | {
+    mode: "embedded-postgres";
+    dataDir: string;
+    port: number;
+    source: `embedded-postgres@${number}`;
+    configPath: string;
+    envPath: string;
+};
+export declare function resolveDatabaseTarget(): ResolvedDatabaseTarget;
+//# sourceMappingURL=runtime-config.d.ts.map

package/dist/runtime-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-config.d.ts","sourceRoot":"","sources":["../src/runtime-config.ts"],"names":[],"mappings":"AAsBA,MAAM,MAAM,sBAAsB,GAC9B;IACE,IAAI,EAAE,UAAU,CAAC;IACjB,gBAAgB,EAAE,MAAM,CAAC;IACzB,MAAM,EAAE,cAAc,GAAG,eAAe,GAAG,kCAAkC,CAAC;IAC9E,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACjB,GACD;IACE,IAAI,EAAE,mBAAmB,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,qBAAqB,MAAM,EAAE,CAAC;IACtC,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAkJN,wBAAgB,qBAAqB,IAAI,sBAAsB,CAoD9D"}

package/dist/runtime-config.js

@@ -0,0 +1,168 @@
+import { existsSync, readFileSync } from "node:fs";
+import path from "node:path";
+import { expandHomePrefix, resolveDefaultEmbeddedPostgresDir, resolvePaperclipConfigPathForInstance, resolvePaperclipEnvPathForConfig, } from "@tickernelz/paperclip-pro-shared/home-paths";
+const CONFIG_BASENAME = "config.json";
+function resolveHomeAwarePath(value) {
+    return path.resolve(expandHomePrefix(value));
+}
+function findConfigFileFromAncestors(startDir) {
+    let currentDir = path.resolve(startDir);
+    while (true) {
+        const candidate = path.resolve(currentDir, ".paperclip", CONFIG_BASENAME);
+        if (existsSync(candidate))
+            return candidate;
+        const nextDir = path.resolve(currentDir, "..");
+        if (nextDir === currentDir)
+            return null;
+        currentDir = nextDir;
+    }
+}
+function resolvePaperclipConfigPath() {
+    if (process.env.PAPERCLIP_CONFIG?.trim()) {
+        return path.resolve(process.env.PAPERCLIP_CONFIG.trim());
+    }
+    return findConfigFileFromAncestors(process.cwd()) ?? resolvePaperclipConfigPathForInstance();
+}
+function resolvePaperclipEnvPath(configPath) {
+    return resolvePaperclipEnvPathForConfig(configPath);
+}
+function parseEnvFile(contents) {
+    const entries = {};
+    for (const rawLine of contents.split(/\r?\n/)) {
+        const line = rawLine.trim();
+        if (!line || line.startsWith("#"))
+            continue;
+        const match = rawLine.match(/^\s*(?:export\s+)?([A-Za-z_][A-Za-z0-9_]*)\s*=\s*(.*)\s*$/);
+        if (!match)
+            continue;
+        const [, key, rawValue] = match;
+        const value = rawValue.trim();
+        if (!value) {
+            entries[key] = "";
+            continue;
+        }
+        if ((value.startsWith("\"") && value.endsWith("\"")) ||
+            (value.startsWith("'") && value.endsWith("'"))) {
+            entries[key] = value.slice(1, -1);
+            continue;
+        }
+        entries[key] = value.replace(/\s+#.*$/, "").trim();
+    }
+    return entries;
+}
+function readEnvEntries(envPath) {
+    if (!existsSync(envPath))
+        return {};
+    return parseEnvFile(readFileSync(envPath, "utf8"));
+}
+function migrateLegacyConfig(raw) {
+    if (typeof raw !== "object" || raw === null || Array.isArray(raw))
+        return null;
+    const config = { ...raw };
+    const databaseRaw = config.database;
+    if (typeof databaseRaw !== "object" || databaseRaw === null || Array.isArray(databaseRaw)) {
+        return config;
+    }
+    const database = { ...databaseRaw };
+    if (database.mode === "pglite") {
+        database.mode = "embedded-postgres";
+        if (typeof database.embeddedPostgresDataDir !== "string" &&
+            typeof database.pgliteDataDir === "string") {
+            database.embeddedPostgresDataDir = database.pgliteDataDir;
+        }
+        if (typeof database.embeddedPostgresPort !== "number" &&
+            typeof database.pglitePort === "number" &&
+            Number.isFinite(database.pglitePort)) {
+            database.embeddedPostgresPort = database.pglitePort;
+        }
+    }
+    config.database = database;
+    return config;
+}
+function asPositiveInt(value) {
+    if (typeof value !== "number" || !Number.isFinite(value))
+        return null;
+    const rounded = Math.trunc(value);
+    return rounded > 0 ? rounded : null;
+}
+function readConfig(configPath) {
+    if (!existsSync(configPath))
+        return null;
+    let parsed;
+    try {
+        parsed = JSON.parse(readFileSync(configPath, "utf8"));
+    }
+    catch (err) {
+        throw new Error(`Failed to parse config at ${configPath}: ${err instanceof Error ? err.message : String(err)}`);
+    }
+    const migrated = migrateLegacyConfig(parsed);
+    if (migrated === null || typeof migrated !== "object" || Array.isArray(migrated)) {
+        throw new Error(`Invalid config at ${configPath}: expected a JSON object`);
+    }
+    const database = typeof migrated.database === "object" &&
+        migrated.database !== null &&
+        !Array.isArray(migrated.database)
+        ? migrated.database
+        : undefined;
+    return {
+        database: database
+            ? {
+                mode: database.mode === "postgres" ? "postgres" : "embedded-postgres",
+                connectionString: typeof database.connectionString === "string" ? database.connectionString : undefined,
+                embeddedPostgresDataDir: typeof database.embeddedPostgresDataDir === "string"
+                    ? database.embeddedPostgresDataDir
+                    : undefined,
+                embeddedPostgresPort: asPositiveInt(database.embeddedPostgresPort) ?? undefined,
+                pgliteDataDir: typeof database.pgliteDataDir === "string" ? database.pgliteDataDir : undefined,
+                pglitePort: asPositiveInt(database.pglitePort) ?? undefined,
+            }
+            : undefined,
+    };
+}
+export function resolveDatabaseTarget() {
+    const configPath = resolvePaperclipConfigPath();
+    const envPath = resolvePaperclipEnvPath(configPath);
+    const envEntries = readEnvEntries(envPath);
+    const envUrl = process.env.DATABASE_URL?.trim();
+    if (envUrl) {
+        return {
+            mode: "postgres",
+            connectionString: envUrl,
+            source: "DATABASE_URL",
+            configPath,
+            envPath,
+        };
+    }
+    const fileEnvUrl = envEntries.DATABASE_URL?.trim();
+    if (fileEnvUrl) {
+        return {
+            mode: "postgres",
+            connectionString: fileEnvUrl,
+            source: "paperclip-env",
+            configPath,
+            envPath,
+        };
+    }
+    const config = readConfig(configPath);
+    const connectionString = config?.database?.connectionString?.trim();
+    if (config?.database?.mode === "postgres" && connectionString) {
+        return {
+            mode: "postgres",
+            connectionString,
+            source: "config.database.connectionString",
+            configPath,
+            envPath,
+        };
+    }
+    const port = config?.database?.embeddedPostgresPort ?? 54329;
+    const dataDir = resolveHomeAwarePath(config?.database?.embeddedPostgresDataDir ?? resolveDefaultEmbeddedPostgresDir());
+    return {
+        mode: "embedded-postgres",
+        dataDir,
+        port,
+        source: `embedded-postgres@${port}`,
+        configPath,
+        envPath,
+    };
+}
+//# sourceMappingURL=runtime-config.js.map

package/dist/runtime-config.js.map

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

package/dist/runtime-config.test.d.ts

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

package/dist/runtime-config.test.d.ts.map

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

package/dist/runtime-config.test.js

@@ -0,0 +1,111 @@
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { afterEach, describe, expect, it } from "vitest";
+import { resolveDatabaseTarget } from "./runtime-config.js";
+const ORIGINAL_CWD = process.cwd();
+const ORIGINAL_ENV = { ...process.env };
+function writeJson(filePath, value) {
+    fs.mkdirSync(path.dirname(filePath), { recursive: true });
+    fs.writeFileSync(filePath, JSON.stringify(value, null, 2));
+}
+function writeText(filePath, value) {
+    fs.mkdirSync(path.dirname(filePath), { recursive: true });
+    fs.writeFileSync(filePath, value);
+}
+afterEach(() => {
+    process.chdir(ORIGINAL_CWD);
+    for (const key of Object.keys(process.env)) {
+        if (!(key in ORIGINAL_ENV))
+            delete process.env[key];
+    }
+    for (const [key, value] of Object.entries(ORIGINAL_ENV)) {
+        if (value === undefined)
+            delete process.env[key];
+        else
+            process.env[key] = value;
+    }
+});
+describe("resolveDatabaseTarget", () => {
+    it("uses DATABASE_URL from process env first", () => {
+        process.env.DATABASE_URL = "postgres://env-user:env-pass@db.example.com:5432/paperclip";
+        const target = resolveDatabaseTarget();
+        expect(target).toMatchObject({
+            mode: "postgres",
+            connectionString: "postgres://env-user:env-pass@db.example.com:5432/paperclip",
+            source: "DATABASE_URL",
+        });
+    });
+    it("uses DATABASE_URL from repo-local .paperclip/.env", () => {
+        const tempDir = fs.mkdtempSync(path.join(os.tmpdir(), "paperclip-db-runtime-"));
+        const projectDir = path.join(tempDir, "repo");
+        fs.mkdirSync(projectDir, { recursive: true });
+        process.chdir(projectDir);
+        delete process.env.PAPERCLIP_CONFIG;
+        writeJson(path.join(projectDir, ".paperclip", "config.json"), {
+            database: { mode: "embedded-postgres", embeddedPostgresPort: 54329 },
+        });
+        writeText(path.join(projectDir, ".paperclip", ".env"), 'DATABASE_URL="postgres://file-user:file-pass@db.example.com:6543/paperclip"\n');
+        const target = resolveDatabaseTarget();
+        expect(target).toMatchObject({
+            mode: "postgres",
+            connectionString: "postgres://file-user:file-pass@db.example.com:6543/paperclip",
+            source: "paperclip-env",
+        });
+    });
+    it("uses config postgres connection string when configured", () => {
+        const tempDir = fs.mkdtempSync(path.join(os.tmpdir(), "paperclip-db-runtime-"));
+        const configPath = path.join(tempDir, "instance", "config.json");
+        process.env.PAPERCLIP_CONFIG = configPath;
+        writeJson(configPath, {
+            database: {
+                mode: "postgres",
+                connectionString: "postgres://cfg-user:cfg-pass@db.example.com:5432/paperclip",
+            },
+        });
+        const target = resolveDatabaseTarget();
+        expect(target).toMatchObject({
+            mode: "postgres",
+            connectionString: "postgres://cfg-user:cfg-pass@db.example.com:5432/paperclip",
+            source: "config.database.connectionString",
+        });
+    });
+    it("falls back to embedded postgres settings from config", () => {
+        const tempDir = fs.mkdtempSync(path.join(os.tmpdir(), "paperclip-db-runtime-"));
+        const configPath = path.join(tempDir, "instance", "config.json");
+        process.env.PAPERCLIP_CONFIG = configPath;
+        writeJson(configPath, {
+            database: {
+                mode: "embedded-postgres",
+                embeddedPostgresDataDir: "~/paperclip-test-db",
+                embeddedPostgresPort: 55444,
+            },
+        });
+        const target = resolveDatabaseTarget();
+        expect(target).toMatchObject({
+            mode: "embedded-postgres",
+            dataDir: path.resolve(os.homedir(), "paperclip-test-db"),
+            port: 55444,
+            source: "embedded-postgres@55444",
+        });
+    });
+    it("uses the instance root for a fresh default embedded postgres target", () => {
+        const home = fs.mkdtempSync(path.join(os.tmpdir(), "paperclip-db-home-"));
+        const cwd = fs.mkdtempSync(path.join(os.tmpdir(), "paperclip-db-cwd-"));
+        process.chdir(cwd);
+        process.env.PAPERCLIP_HOME = home;
+        delete process.env.PAPERCLIP_CONFIG;
+        delete process.env.PAPERCLIP_INSTANCE_ID;
+        delete process.env.DATABASE_URL;
+        const target = resolveDatabaseTarget();
+        expect(target).toMatchObject({
+            mode: "embedded-postgres",
+            dataDir: path.join(home, "instances", "default", "db"),
+            port: 54329,
+            source: "embedded-postgres@54329",
+            configPath: path.join(home, "instances", "default", "config.json"),
+            envPath: path.join(home, "instances", "default", ".env"),
+        });
+    });
+});
+//# sourceMappingURL=runtime-config.test.js.map

package/dist/runtime-config.test.js.map

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