@supatype/cli 0.1.0-alpha.10

package/dist/postgres-ctl.js

@@ -0,0 +1,137 @@
+/**
+ * postgres-ctl — wrappers around pg_ctl, initdb, and pg_isready for managing
+ * a native Postgres installation.
+ */
+import { spawnSync } from "node:child_process";
+import { existsSync, mkdirSync } from "node:fs";
+import { dirname, join } from "node:path";
+/**
+ * Native Postgres bundles are built with prefix /usr/local/supatype-pg; dyld/ld
+ * must load libpq and friends from the extracted lib/ next to bin/.
+ */
+export function pgSpawnEnv(pgBinDir, platform = process.platform) {
+    const libDir = join(dirname(pgBinDir), "lib");
+    const env = { ...process.env };
+    if (platform === "darwin") {
+        const prev = env.DYLD_LIBRARY_PATH ?? "";
+        env.DYLD_LIBRARY_PATH = prev ? `${libDir}:${prev}` : libDir;
+    }
+    else if (platform === "linux") {
+        const prev = env.LD_LIBRARY_PATH ?? "";
+        env.LD_LIBRARY_PATH = prev ? `${libDir}:${prev}` : libDir;
+    }
+    return env;
+}
+// ---------------------------------------------------------------------------
+// initdb
+// ---------------------------------------------------------------------------
+/**
+ * Initialise a Postgres data directory.
+ * Does nothing if the data directory already contains a PG_VERSION file.
+ */
+export function initdb(opts) {
+    const pgVersionFile = join(opts.dataDir, "PG_VERSION");
+    if (existsSync(pgVersionFile))
+        return; // Already initialised.
+    mkdirSync(opts.dataDir, { recursive: true });
+    const bin = pgBin(opts.pgBinDir, "initdb");
+    const result = spawnSync(bin, ["-D", opts.dataDir, "--username", "postgres", "--auth", "trust"], {
+        stdio: "inherit",
+        encoding: "utf8",
+        env: pgSpawnEnv(opts.pgBinDir),
+    });
+    if (result.status !== 0) {
+        throw new Error(`initdb failed (exit ${result.status})`);
+    }
+}
+// ---------------------------------------------------------------------------
+// start / stop
+// ---------------------------------------------------------------------------
+/**
+ * Start Postgres using pg_ctl.
+ * Returns immediately once pg_ctl has handed off to the server process.
+ */
+export function start(opts) {
+    const bin = pgBin(opts.pgBinDir, "pg_ctl");
+    const logPath = opts.logPath ?? join(opts.dataDir, "postgres.log");
+    const args = [
+        "start",
+        "-D", opts.dataDir,
+        "-l", logPath,
+        "-o", `-p ${opts.port}`,
+        "--wait",
+    ];
+    const result = spawnSync(bin, args, {
+        stdio: "inherit",
+        encoding: "utf8",
+        env: pgSpawnEnv(opts.pgBinDir),
+    });
+    if (result.status !== 0) {
+        throw new Error(`pg_ctl start failed (exit ${result.status})`);
+    }
+}
+/**
+ * Stop Postgres using pg_ctl (fast mode).
+ */
+export function stop(opts) {
+    const bin = pgBin(opts.pgBinDir, "pg_ctl");
+    const result = spawnSync(bin, ["stop", "-D", opts.dataDir, "-m", "fast", "--wait"], {
+        stdio: "inherit",
+        encoding: "utf8",
+        env: pgSpawnEnv(opts.pgBinDir),
+    });
+    // Ignore exit code — Postgres may already be stopped.
+    void result;
+}
+// ---------------------------------------------------------------------------
+// waitReady
+// ---------------------------------------------------------------------------
+/**
+ * Wait until Postgres is accepting connections.
+ * Polls pg_isready every 200ms up to timeoutMs.
+ * Throws if the timeout is exceeded.
+ */
+export async function waitReady(opts, timeoutMs = 10_000) {
+    const bin = pgBin(opts.pgBinDir, "pg_isready");
+    const deadline = Date.now() + timeoutMs;
+    while (Date.now() < deadline) {
+        const result = spawnSync(bin, ["-p", String(opts.port), "-q"], {
+            encoding: "utf8",
+            env: pgSpawnEnv(opts.pgBinDir),
+        });
+        if (result.status === 0)
+            return;
+        await sleep(200);
+    }
+    throw new Error(`Postgres did not become ready within ${timeoutMs}ms on port ${opts.port}`);
+}
+// ---------------------------------------------------------------------------
+// Port check
+// ---------------------------------------------------------------------------
+/**
+ * Returns true if a TCP listener is already bound to port on 127.0.0.1.
+ */
+export async function isPortInUse(port) {
+    const { createServer } = await import("node:net");
+    return new Promise((resolve) => {
+        const server = createServer();
+        server.once("error", (err) => {
+            resolve(err.code === "EADDRINUSE");
+        });
+        server.once("listening", () => {
+            server.close(() => resolve(false));
+        });
+        server.listen(port, "127.0.0.1");
+    });
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+/** Returns the full path to a Postgres binary, appending .exe on Windows. */
+function pgBin(binDir, name) {
+    return join(binDir, process.platform === "win32" ? `${name}.exe` : name);
+}
+//# sourceMappingURL=postgres-ctl.js.map

package/dist/postgres-ctl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"postgres-ctl.js","sourceRoot":"","sources":["../src/postgres-ctl.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAA;AAC9C,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,SAAS,CAAA;AAC/C,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAazC;;;GAGG;AACH,MAAM,UAAU,UAAU,CACxB,QAAgB,EAChB,WAA4B,OAAO,CAAC,QAAQ;IAE5C,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,KAAK,CAAC,CAAA;IAC7C,MAAM,GAAG,GAAG,EAAE,GAAG,OAAO,CAAC,GAAG,EAAuB,CAAA;IACnD,IAAI,QAAQ,KAAK,QAAQ,EAAE,CAAC;QAC1B,MAAM,IAAI,GAAG,GAAG,CAAC,iBAAiB,IAAI,EAAE,CAAA;QACxC,GAAG,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC,MAAM,CAAA;IAC7D,CAAC;SAAM,IAAI,QAAQ,KAAK,OAAO,EAAE,CAAC;QAChC,MAAM,IAAI,GAAG,GAAG,CAAC,eAAe,IAAI,EAAE,CAAA;QACtC,GAAG,CAAC,eAAe,GAAG,IAAI,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC,MAAM,CAAA;IAC3D,CAAC;IACD,OAAO,GAAG,CAAA;AACZ,CAAC;AAED,8EAA8E;AAC9E,SAAS;AACT,8EAA8E;AAE9E;;;GAGG;AACH,MAAM,UAAU,MAAM,CAAC,IAAe;IACpC,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,YAAY,CAAC,CAAA;IACtD,IAAI,UAAU,CAAC,aAAa,CAAC;QAAE,OAAM,CAAC,uBAAuB;IAE7D,SAAS,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;IAE5C,MAAM,GAAG,GAAG,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAA;IAC1C,MAAM,MAAM,GAAG,SAAS,CAAC,GAAG,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,QAAQ,EAAE,OAAO,CAAC,EAAE;QAC/F,KAAK,EAAE,SAAS;QAChB,QAAQ,EAAE,MAAM;QAChB,GAAG,EAAE,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC;KAC/B,CAAC,CAAA;IAEF,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CAAC,uBAAuB,MAAM,CAAC,MAAM,GAAG,CAAC,CAAA;IAC1D,CAAC;AACH,CAAC;AAED,8EAA8E;AAC9E,eAAe;AACf,8EAA8E;AAE9E;;;GAGG;AACH,MAAM,UAAU,KAAK,CAAC,IAAe;IACnC,MAAM,GAAG,GAAG,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAA;IAC1C,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,cAAc,CAAC,CAAA;IAElE,MAAM,IAAI,GAAG;QACX,OAAO;QACP,IAAI,EAAE,IAAI,CAAC,OAAO;QAClB,IAAI,EAAE,OAAO;QACb,IAAI,EAAE,MAAM,IAAI,CAAC,IAAI,EAAE;QACvB,QAAQ;KACT,CAAA;IAED,MAAM,MAAM,GAAG,SAAS,CAAC,GAAG,EAAE,IAAI,EAAE;QAClC,KAAK,EAAE,SAAS;QAChB,QAAQ,EAAE,MAAM;QAChB,GAAG,EAAE,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC;KAC/B,CAAC,CAAA;IACF,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CAAC,6BAA6B,MAAM,CAAC,MAAM,GAAG,CAAC,CAAA;IAChE,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,IAAI,CAAC,IAAe;IAClC,MAAM,GAAG,GAAG,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAA;IAC1C,MAAM,MAAM,GAAG,SAAS,CAAC,GAAG,EAAE,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE;QAClF,KAAK,EAAE,SAAS;QAChB,QAAQ,EAAE,MAAM;QAChB,GAAG,EAAE,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC;KAC/B,CAAC,CAAA;IACF,sDAAsD;IACtD,KAAK,MAAM,CAAA;AACb,CAAC;AAED,8EAA8E;AAC9E,YAAY;AACZ,8EAA8E;AAE9E;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,IAAe,EAAE,SAAS,GAAG,MAAM;IACjE,MAAM,GAAG,GAAG,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAA;IAC9C,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAA;IAEvC,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,QAAQ,EAAE,CAAC;QAC7B,MAAM,MAAM,GAAG,SAAS,CAAC,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,EAAE;YAC7D,QAAQ,EAAE,MAAM;YAChB,GAAG,EAAE,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC;SAC/B,CAAC,CAAA;QACF,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;YAAE,OAAM;QAE/B,MAAM,KAAK,CAAC,GAAG,CAAC,CAAA;IAClB,CAAC;IAED,MAAM,IAAI,KAAK,CACb,wCAAwC,SAAS,cAAc,IAAI,CAAC,IAAI,EAAE,CAC3E,CAAA;AACH,CAAC;AAED,8EAA8E;AAC9E,aAAa;AACb,8EAA8E;AAE9E;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,IAAY;IAC5C,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC,CAAA;IACjD,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,MAAM,MAAM,GAAG,YAAY,EAAE,CAAA;QAC7B,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,GAA0B,EAAE,EAAE;YAClD,OAAO,CAAC,GAAG,CAAC,IAAI,KAAK,YAAY,CAAC,CAAA;QACpC,CAAC,CAAC,CAAA;QACF,MAAM,CAAC,IAAI,CAAC,WAAW,EAAE,GAAG,EAAE;YAC5B,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAA;QACpC,CAAC,CAAC,CAAA;QACF,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,WAAW,CAAC,CAAA;IAClC,CAAC,CAAC,CAAA;AACJ,CAAC;AAED,8EAA8E;AAC9E,UAAU;AACV,8EAA8E;AAE9E,SAAS,KAAK,CAAC,EAAU;IACvB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAA;AAC1D,CAAC;AAED,6EAA6E;AAC7E,SAAS,KAAK,CAAC,MAAc,EAAE,IAAY;IACzC,OAAO,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAA;AAC1E,CAAC"}

package/dist/process-manager.d.ts

@@ -0,0 +1,49 @@
+/**
+ * ProcessManager — spawn a child process, write its PID, stream logs with a
+ * colored prefix, and restart on crash with exponential backoff.
+ */
+export interface ProcessOptions {
+    /** Human-readable label (used in log prefix and PID filename). */
+    label: string;
+    /** Directory to write {label}.pid to. */
+    pidDir: string;
+    /** ANSI colour prefix string (e.g. "\x1b[36m"). Pass "" for no colour. */
+    colour?: string;
+    /** Working directory for the spawned process. Defaults to process.cwd(). */
+    cwd?: string;
+    /** Environment variables to merge with process.env. */
+    env?: Record<string, string>;
+    /** Initial restart backoff in ms. Doubles each crash up to maxBackoffMs. */
+    initialBackoffMs?: number;
+    /** Maximum restart backoff cap in ms. */
+    maxBackoffMs?: number;
+    /** Called when the process exits cleanly (code 0). */
+    onExit?: () => void;
+    /** Use shell to spawn (required for pnpm/npm/yarn .cmd shims on Windows). */
+    shell?: boolean;
+    /** When set (TUI mode), receive log lines instead of writing to stdout/stderr. */
+    onLine?: (line: string, stream: "stdout" | "stderr") => void;
+    /** Return false to drop a line before logging. */
+    shouldLogLine?: (line: string) => boolean;
+}
+export declare class ProcessManager {
+    private readonly bin;
+    private readonly args;
+    private child;
+    private stopped;
+    private backoffMs;
+    private opts;
+    /** Skip immediate duplicate lines (npm prints script banners to both streams). */
+    private lastLoggedLine;
+    constructor(bin: string, args: string[], opts: ProcessOptions);
+    /** Start the process. Returns immediately — the process runs in the background. */
+    start(): void;
+    /** Stop the process and clear the PID file. */
+    stop(): Promise<void>;
+    private spawn;
+    private writePid;
+    private clearPid;
+}
+/** Read a PID from a file (returns null if not found or stale). */
+export declare function readPid(pidDir: string, label: string): number | null;
+//# sourceMappingURL=process-manager.d.ts.map

package/dist/process-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-manager.d.ts","sourceRoot":"","sources":["../src/process-manager.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAQH,MAAM,WAAW,cAAc;IAC7B,kEAAkE;IAClE,KAAK,EAAE,MAAM,CAAA;IACb,yCAAyC;IACzC,MAAM,EAAE,MAAM,CAAA;IACd,0EAA0E;IAC1E,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,4EAA4E;IAC5E,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,uDAAuD;IACvD,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC5B,4EAA4E;IAC5E,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,yCAAyC;IACzC,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,sDAAsD;IACtD,MAAM,CAAC,EAAE,MAAM,IAAI,CAAA;IACnB,6EAA6E;IAC7E,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,kFAAkF;IAClF,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,GAAG,QAAQ,KAAK,IAAI,CAAA;IAC5D,kDAAkD;IAClD,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAA;CAC1C;AAID,qBAAa,cAAc;IAiBvB,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,IAAI;IAjBvB,OAAO,CAAC,KAAK,CAA4B;IACzC,OAAO,CAAC,OAAO,CAAQ;IACvB,OAAO,CAAC,SAAS,CAAQ;IACzB,OAAO,CAAC,IAAI,CAQX;IACD,kFAAkF;IAClF,OAAO,CAAC,cAAc,CAAK;gBAGR,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,EAAE,EAC/B,IAAI,EAAE,cAAc;IAgBtB,mFAAmF;IACnF,KAAK,IAAI,IAAI;IAKb,+CAA+C;IACzC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAgC3B,OAAO,CAAC,KAAK;IAkFb,OAAO,CAAC,QAAQ;YASF,QAAQ;CAOvB;AAED,mEAAmE;AACnE,wBAAgB,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAMpE"}

package/dist/process-manager.js

@@ -0,0 +1,177 @@
+/**
+ * ProcessManager — spawn a child process, write its PID, stream logs with a
+ * colored prefix, and restart on crash with exponential backoff.
+ */
+import { spawn, spawnSync } from "node:child_process";
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { unlink } from "node:fs/promises";
+import { join } from "node:path";
+import { enhanceProcessOptions } from "./dev-session.js";
+const RESET = "\x1b[0m";
+export class ProcessManager {
+    bin;
+    args;
+    child = null;
+    stopped = false;
+    backoffMs;
+    opts;
+    /** Skip immediate duplicate lines (npm prints script banners to both streams). */
+    lastLoggedLine = "";
+    constructor(bin, args, opts) {
+        this.bin = bin;
+        this.args = args;
+        const merged = enhanceProcessOptions(opts.label, opts);
+        this.opts = {
+            colour: "\x1b[36m",
+            cwd: process.cwd(),
+            env: {},
+            initialBackoffMs: 1_000,
+            maxBackoffMs: 30_000,
+            onExit: () => { },
+            shell: false,
+            ...merged,
+        };
+        this.backoffMs = this.opts.initialBackoffMs;
+    }
+    /** Start the process. Returns immediately — the process runs in the background. */
+    start() {
+        this.stopped = false;
+        this.spawn();
+    }
+    /** Stop the process and clear the PID file. */
+    async stop() {
+        this.stopped = true;
+        if (!this.child || this.child.killed) {
+            await this.clearPid();
+            return;
+        }
+        const pid = this.child.pid;
+        if (process.platform === "win32" && this.opts.shell && pid) {
+            spawnSync("taskkill", ["/pid", String(pid), "/T", "/F"], { stdio: "ignore" });
+            this.child = null;
+            await this.clearPid();
+            return;
+        }
+        if (!this.child.killed) {
+            this.child.kill("SIGTERM");
+            // Give it 5s to exit gracefully, then SIGKILL.
+            await new Promise((resolve) => {
+                const timeout = setTimeout(() => {
+                    this.child?.kill("SIGKILL");
+                    resolve();
+                }, 5_000);
+                this.child.once("exit", () => {
+                    clearTimeout(timeout);
+                    resolve();
+                });
+            });
+        }
+        await this.clearPid();
+    }
+    spawn() {
+        if (this.stopped)
+            return;
+        const env = { ...process.env, ...this.opts.env };
+        this.child = spawn(this.bin, this.args, {
+            env,
+            cwd: this.opts.cwd,
+            stdio: "pipe",
+            ...(this.opts.shell ? { shell: true } : {}),
+        });
+        const pid = this.child.pid;
+        if (pid)
+            this.writePid(pid);
+        const prefix = this.opts.colour
+            ? `${this.opts.colour}[${this.opts.label}]${RESET} `
+            : `[${this.opts.label}] `;
+        const logLine = (line, stream) => {
+            if (!line)
+                return;
+            if (this.opts.shouldLogLine && !this.opts.shouldLogLine(line))
+                return;
+            if (this.opts.onLine) {
+                if (line !== this.lastLoggedLine) {
+                    this.lastLoggedLine = line;
+                    this.opts.onLine(line, stream === process.stderr ? "stderr" : "stdout");
+                }
+                return;
+            }
+            if (line === this.lastLoggedLine)
+                return;
+            this.lastLoggedLine = line;
+            stream.write(prefix + line + "\n");
+        };
+        this.child.stdout?.on("data", (chunk) => {
+            for (const line of chunk.toString().split("\n")) {
+                logLine(line, process.stdout);
+            }
+        });
+        this.child.stderr?.on("data", (chunk) => {
+            for (const line of chunk.toString().split("\n")) {
+                logLine(line, process.stderr);
+            }
+        });
+        this.child.once("error", (err) => {
+            if (this.stopped)
+                return;
+            const message = `${prefix}failed to start: ${err.message}\n`;
+            if (this.opts.onLine) {
+                this.opts.onLine(`failed to start: ${err.message}`, "stderr");
+            }
+            else {
+                process.stderr.write(message);
+            }
+            setTimeout(() => {
+                this.backoffMs = Math.min(this.backoffMs * 2, this.opts.maxBackoffMs);
+                this.spawn();
+            }, this.backoffMs);
+        });
+        this.child.once("exit", (code, signal) => {
+            if (this.stopped)
+                return;
+            if (code === 0) {
+                this.opts.onExit();
+                return;
+            }
+            const reason = signal ? `signal ${signal}` : `code ${code}`;
+            const restartMsg = `${prefix}process exited (${reason}), restarting in ${this.backoffMs}ms\n`;
+            if (this.opts.onLine) {
+                this.opts.onLine(`process exited (${reason}), restarting in ${this.backoffMs}ms`, "stderr");
+            }
+            else {
+                process.stderr.write(restartMsg);
+            }
+            setTimeout(() => {
+                this.backoffMs = Math.min(this.backoffMs * 2, this.opts.maxBackoffMs);
+                this.spawn();
+            }, this.backoffMs);
+        });
+    }
+    writePid(pid) {
+        try {
+            mkdirSync(this.opts.pidDir, { recursive: true });
+            writeFileSync(join(this.opts.pidDir, `${this.opts.label}.pid`), String(pid));
+        }
+        catch {
+            // Non-fatal — PID tracking is best-effort.
+        }
+    }
+    async clearPid() {
+        try {
+            await unlink(join(this.opts.pidDir, `${this.opts.label}.pid`));
+        }
+        catch {
+            // Ignore — file may already be gone.
+        }
+    }
+}
+/** Read a PID from a file (returns null if not found or stale). */
+export function readPid(pidDir, label) {
+    const pidFile = join(pidDir, `${label}.pid`);
+    if (!existsSync(pidFile))
+        return null;
+    const raw = readFileSync(pidFile, "utf8").trim();
+    const pid = Number(raw);
+    return Number.isFinite(pid) && pid > 0 ? pid : null;
+}
+//# sourceMappingURL=process-manager.js.map

package/dist/process-manager.js.map

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

package/dist/project-config.d.ts

@@ -0,0 +1,238 @@
+import type { ComponentVersions } from "./components.js";
+export interface SupatypeProjectConfig {
+    /**
+     * Runtime stack for local dev and `supatype update`.
+     * "native" = host binaries (default). "docker" = self-host Compose stack.
+     * Falls back to `database.provider` when omitted (deprecated).
+     */
+    provider?: "native" | "docker";
+    supatype?: {
+        /**
+         * Base directory for Supatype project assets (schema, functions, etc).
+         * "." means the current working directory (default).
+         */
+        root?: string;
+    };
+    project: {
+        /** Project name — used for per-project state dirs and logging. */
+        name: string;
+        /** Cloud project reference (set by `supatype link`). */
+        ref?: string;
+    };
+    database: {
+        /**
+         * Database backend.
+         * "native" = supatype manages a native Postgres binary (downloaded from CDN).
+         * "docker" = supatype runs supatype/postgres via Docker (includes all extensions).
+         */
+        provider: "native" | "docker";
+        /**
+         * Directory where Postgres stores its data files (provider=native).
+         * Defaults to ~/.supatype/projects/{name}/data when omitted.
+         */
+        data_dir?: string;
+        /**
+         * Docker image to use (provider=docker).
+         * Defaults to supatype/postgres:latest.
+         * Override in supatype.local.config.ts for local builds.
+         */
+        image?: string;
+    };
+    server: {
+        /**
+         * Server mode.
+         * "dev"        = no TLS, permissive CORS, Vite HMR proxy
+         * "standalone" = ACME TLS (Let's Encrypt)
+         * "managed"    = cloud-managed, HMAC tenant verification
+         */
+        mode: "dev" | "standalone" | "managed";
+        /** Port supatype-server listens on (default: 54321). */
+        port?: number;
+        /** Port PostgREST listens on in local dev (default: 3001). */
+        postgrestPort?: number;
+        /** Domain for ACME TLS certificate (mode=standalone). */
+        domain?: string;
+    };
+    app: {
+        /**
+         * How the root path "/" is handled by supatype-server.
+         * "none"   = 404
+         * "static" = serve files from static_dir
+         * "proxy"  = reverse-proxy to upstream
+         */
+        mode: "none" | "static" | "proxy";
+        /** Directory to serve static files from (mode=static). */
+        static_dir?: string;
+        /** Upstream URL to proxy to (mode=proxy). */
+        upstream?: string;
+        /**
+         * Vite dev server base URL for HMR (`/_vite/*`) when `server.mode` is dev.
+         * Example: `http://127.0.0.1:5173`. Sets `SUPATYPE_VITE_DEV_URL` for supatype-server.
+         * When omitted, dev still falls back to `SUPATYPE_APP_UPSTREAM` for non-proxy app modes.
+         */
+        vite_dev_url?: string;
+        /**
+         * package.json script name for `supatype dev` to run when mode is proxy.
+         * Default: `"start"`. Ignored for static/none modes.
+         */
+        start?: string;
+    };
+    /**
+     * Optional pins for engine, server, postgres, and deno.
+     * Omitted = resolve latest from CDN at runtime (native) or use Docker :latest.
+     * When set, native binaries cache under ~/.supatype/cache/{component}/{version}/
+     * and Docker image tags are synced to `.env` on `supatype dev` / `supatype push`.
+     * Use **`"local"`** with the matching **`overrides.*`** entry for contributor builds.
+     */
+    versions?: Partial<ComponentVersions>;
+    /**
+     * Override component binaries with local build paths.
+     * Intended for supatype contributors testing local changes.
+     * Cannot be combined with a linked cloud project (`project.ref`, `.supatype/cloud.json`, or `.supatype/linked.json`; hard error in `resolveBinary`).
+     */
+    overrides?: {
+        /** Path to local engine binary. */
+        engine?: string;
+        /** Path to local supatype-server binary. */
+        server?: string;
+        /** Path to a directory containing a local Postgres installation. */
+        postgres_dir?: string;
+        /** Path to a local deno binary. */
+        deno?: string;
+        /** Path to the @supatype/studio package directory (starts Vite dev server). */
+        studio?: string;
+        /** Path to a local PostgREST binary. */
+        postgrest?: string;
+    };
+    email?: {
+        /**
+         * Email delivery provider.
+         * "console" = log to stdout (default for dev)
+         * "smtp"    = SMTP (set `smtp` below and/or GOTRUE_SMTP_* in `.env`)
+         * "resend"  = Resend API (requires RESEND_API_KEY, RESEND_FROM)
+         * "ses"     = AWS SES v2 (ambient credentials, requires SES_FROM)
+         */
+        provider: "console" | "smtp" | "resend" | "ses";
+        /**
+         * SMTP settings for provider=smtp (merged into process env as GOTRUE_SMTP_*).
+         * Omitted keys can still be set via `.env` / shell.
+         */
+        smtp?: {
+            host?: string;
+            port?: number;
+            user?: string;
+            pass?: string;
+            admin_email?: string;
+            sender_name?: string;
+        };
+        /** Resend API key (provider=resend, or set RESEND_API_KEY env var). */
+        resend_api_key?: string;
+        /** From address for Resend (provider=resend, or set RESEND_FROM env var). */
+        resend_from?: string;
+        /** From address for SES (provider=ses, or set SES_FROM env var). */
+        ses_from?: string;
+        /**
+         * When true, `supatype dev` enables the GoTrue send-email HTTP hook pointing at this
+         * server's POST `/internal/v0hooks/send-email` (signed delivery, dev-only secret).
+         * Override `GOTRUE_HOOK_SEND_EMAIL_*` in `.env` if needed.
+         */
+        send_email_hook?: boolean;
+        /**
+         * Override hook target URL when `send_email_hook` is true (e.g. HTTPS tunnel or Edge URL).
+         * Default: `http://127.0.0.1:<serverPort>/internal/v0hooks/send-email`.
+         */
+        send_email_hook_uri?: string;
+        /**
+         * Standard Webhooks v1 secrets for the send-email hook (`v1,whsec_...`, pipe-separated for rotation).
+         * Default in dev: a fixed local secret; override for team-shared dev or CI.
+         */
+        send_email_hook_secrets?: string;
+    };
+    storage?: {
+        /**
+         * Storage backend.
+         * "local" = files on disk (LocalStoragePath required)
+         * "s3"    = AWS S3 or compatible (ambient credentials)
+         */
+        provider: "local" | "s3";
+        /** Local directory to store objects in (provider=local). */
+        local_path?: string;
+    };
+    schema?: {
+        /** Path (or glob) to the schema entry point. Defaults to "schema/index.ts". */
+        path?: string;
+        /** Postgres schema name. Defaults to "public". */
+        pg_schema?: string;
+    };
+    functions?: {
+        /** Path to edge functions directory, relative to `supatype.root` when not absolute. */
+        path?: string;
+    };
+    output?: {
+        /** Path for generated TypeScript types. */
+        types?: string;
+        /** Path for generated client helpers. */
+        client?: string;
+    };
+    /**
+     * App build configuration for `supatype deploy`.
+     * Separate from `app` which controls how supatype-server serves at runtime.
+     */
+    build?: {
+        /** Framework name. Auto-detected from package.json when omitted. */
+        framework?: "nextjs" | "astro" | "vite" | "remix-spa" | "sveltekit" | "nuxt" | "static";
+        /** Path to the app directory. Defaults to cwd. */
+        directory?: string;
+        /** Build command. Inferred from framework when omitted. */
+        buildCommand?: string;
+        /** Build output directory. Inferred from framework when omitted. */
+        outputDirectory?: string;
+        /** Enable SPA fallback routing. */
+        spa?: boolean;
+        /** Environment variables injected at build time. */
+        env?: Record<string, string>;
+        /** Custom response headers for the deployed static site. */
+        headers?: Record<string, string>;
+    };
+    /**
+     * Optional Postgres URL for CLI commands that talk to the DB (`push`, `migrate`, …).
+     * When omitted, `DATABASE_URL` from the environment is used, then a local default DSN.
+     */
+    connection?: string;
+    /** Studio admin panel access (Gap Appendices task 47). */
+    admin?: {
+        /** JWT `app_metadata.role` values allowed to use Studio. Default: admin, supatype_admin */
+        roles?: string[];
+    };
+}
+/**
+ * Merge each top-level section from `override` on top of `base`.
+ * Within each section, override values win. New optional sections in override are added.
+ */
+export declare function mergeProjectConfig(base: SupatypeProjectConfig, override: Partial<SupatypeProjectConfig>): SupatypeProjectConfig;
+export declare function validateProjectConfig(raw: unknown, filename: string): SupatypeProjectConfig;
+/** Schema entry path (with fallback). */
+export declare function schemaPathFromProject(cfg: SupatypeProjectConfig, cwd: string): string;
+/** Resolve project root for schema/functions defaults. */
+export declare function projectRootFromConfig(cfg: SupatypeProjectConfig, cwd: string): string;
+/** Candidate functions directories in lookup order. */
+export declare function functionsPathCandidatesFromProject(cfg: SupatypeProjectConfig, cwd: string): string[];
+/** Preferred default functions path (used when creating new functions). */
+export declare function preferredFunctionsPathFromProject(cfg: SupatypeProjectConfig, cwd: string): string;
+/**
+ * Derive the supatype-server base URL from the project config.
+ * Returns undefined if the mode is "managed" (cloud controls the URL).
+ */
+export declare function serverBaseUrl(cfg: SupatypeProjectConfig): string | undefined;
+/** Resolved runtime provider (`config.provider` ?? `database.provider` ?? native). */
+export declare function resolveRuntimeProvider(cfg: SupatypeProjectConfig): "native" | "docker";
+/** Kong gateway port when `provider: docker` (self-host compose dev). */
+export declare const COMPOSE_DEV_KONG_PORT = 18473;
+/** The local Postgres DSN derived from project name (dev default). */
+export declare function localDSN(cfg: SupatypeProjectConfig): string;
+/**
+ * Resolve the database connection string.
+ * Prefers optional `connection` in config, then `DATABASE_URL` env, then a local default DSN.
+ */
+export declare function connectionString(cfg: SupatypeProjectConfig): string;
+//# sourceMappingURL=project-config.d.ts.map

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

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