@supatype/cli 0.1.0-alpha.6 → 0.1.0-alpha.7

package/dist/process-manager.d.ts

@@ -0,0 +1,41 @@
+/**
+ * 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;
+}
+export declare class ProcessManager {
+    private readonly bin;
+    private readonly args;
+    private child;
+    private stopped;
+    private backoffMs;
+    private opts;
+    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;AAOH,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;CACpB;AAID,qBAAa,cAAc;IAOvB,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,IAAI;IAPvB,OAAO,CAAC,KAAK,CAA4B;IACzC,OAAO,CAAC,OAAO,CAAQ;IACvB,OAAO,CAAC,SAAS,CAAQ;IACzB,OAAO,CAAC,IAAI,CAA0B;gBAGnB,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,EAAE,EAC/B,IAAI,EAAE,cAAc;IActB,mFAAmF;IACnF,KAAK,IAAI,IAAI;IAKb,+CAA+C;IACzC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAmB3B,OAAO,CAAC,KAAK;IA6Cb,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,120 @@
+/**
+ * ProcessManager — spawn a child process, write its PID, stream logs with a
+ * colored prefix, and restart on crash with exponential backoff.
+ */
+import { spawn } from "node:child_process";
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { unlink } from "node:fs/promises";
+import { join } from "node:path";
+const RESET = "\x1b[0m";
+export class ProcessManager {
+    bin;
+    args;
+    child = null;
+    stopped = false;
+    backoffMs;
+    opts;
+    constructor(bin, args, opts) {
+        this.bin = bin;
+        this.args = args;
+        this.opts = {
+            colour: "\x1b[36m",
+            cwd: process.cwd(),
+            env: {},
+            initialBackoffMs: 1_000,
+            maxBackoffMs: 30_000,
+            onExit: () => { },
+            ...opts,
+        };
+        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) {
+            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" });
+        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}] `;
+        this.child.stdout?.on("data", (chunk) => {
+            for (const line of chunk.toString().split("\n")) {
+                if (line)
+                    process.stdout.write(prefix + line + "\n");
+            }
+        });
+        this.child.stderr?.on("data", (chunk) => {
+            for (const line of chunk.toString().split("\n")) {
+                if (line)
+                    process.stderr.write(prefix + line + "\n");
+            }
+        });
+        this.child.once("exit", (code, signal) => {
+            if (this.stopped)
+                return;
+            if (code === 0) {
+                this.opts.onExit();
+                return;
+            }
+            const reason = signal ? `signal ${signal}` : `code ${code}`;
+            process.stderr.write(`${prefix}process exited (${reason}), restarting in ${this.backoffMs}ms\n`);
+            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,215 @@
+import type { ComponentVersions } from "./components.js";
+export interface SupatypeProjectConfig {
+    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:17-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;
+    };
+    /**
+     * Pinned binary versions per component. Use **`"local"`** with the matching **`overrides.*`**
+     * entry when testing a local build (Phase 10.7).
+     */
+    versions: 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;
+}
+/**
+ * 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;
+/** 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":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAA;AAMxD,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,EAAE;QACT;;;WAGG;QACH,IAAI,CAAC,EAAE,MAAM,CAAA;KACd,CAAA;IACD,OAAO,EAAE;QACP,kEAAkE;QAClE,IAAI,EAAE,MAAM,CAAA;QACZ,wDAAwD;QACxD,GAAG,CAAC,EAAE,MAAM,CAAA;KACb,CAAA;IACD,QAAQ,EAAE;QACR;;;;WAIG;QACH,QAAQ,EAAE,QAAQ,GAAG,QAAQ,CAAA;QAC7B;;;WAGG;QACH,QAAQ,CAAC,EAAE,MAAM,CAAA;QACjB;;;;WAIG;QACH,KAAK,CAAC,EAAE,MAAM,CAAA;KACf,CAAA;IACD,MAAM,EAAE;QACN;;;;;WAKG;QACH,IAAI,EAAE,KAAK,GAAG,YAAY,GAAG,SAAS,CAAA;QACtC,wDAAwD;QACxD,IAAI,CAAC,EAAE,MAAM,CAAA;QACb,8DAA8D;QAC9D,aAAa,CAAC,EAAE,MAAM,CAAA;QACtB,yDAAyD;QACzD,MAAM,CAAC,EAAE,MAAM,CAAA;KAChB,CAAA;IACD,GAAG,EAAE;QACH;;;;;WAKG;QACH,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAA;QACjC,0DAA0D;QAC1D,UAAU,CAAC,EAAE,MAAM,CAAA;QACnB,6CAA6C;QAC7C,QAAQ,CAAC,EAAE,MAAM,CAAA;QACjB;;;;WAIG;QACH,YAAY,CAAC,EAAE,MAAM,CAAA;KACtB,CAAA;IACD;;;OAGG;IACH,QAAQ,EAAE,iBAAiB,CAAA;IAC3B;;;;OAIG;IACH,SAAS,CAAC,EAAE;QACV,mCAAmC;QACnC,MAAM,CAAC,EAAE,MAAM,CAAA;QACf,4CAA4C;QAC5C,MAAM,CAAC,EAAE,MAAM,CAAA;QACf,oEAAoE;QACpE,YAAY,CAAC,EAAE,MAAM,CAAA;QACrB,mCAAmC;QACnC,IAAI,CAAC,EAAE,MAAM,CAAA;QACb,+EAA+E;QAC/E,MAAM,CAAC,EAAE,MAAM,CAAA;QACf,wCAAwC;QACxC,SAAS,CAAC,EAAE,MAAM,CAAA;KACnB,CAAA;IACD,KAAK,CAAC,EAAE;QACN;;;;;;WAMG;QACH,QAAQ,EAAE,SAAS,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAA;QAC/C;;;WAGG;QACH,IAAI,CAAC,EAAE;YACL,IAAI,CAAC,EAAE,MAAM,CAAA;YACb,IAAI,CAAC,EAAE,MAAM,CAAA;YACb,IAAI,CAAC,EAAE,MAAM,CAAA;YACb,IAAI,CAAC,EAAE,MAAM,CAAA;YACb,WAAW,CAAC,EAAE,MAAM,CAAA;YACpB,WAAW,CAAC,EAAE,MAAM,CAAA;SACrB,CAAA;QACD,uEAAuE;QACvE,cAAc,CAAC,EAAE,MAAM,CAAA;QACvB,6EAA6E;QAC7E,WAAW,CAAC,EAAE,MAAM,CAAA;QACpB,oEAAoE;QACpE,QAAQ,CAAC,EAAE,MAAM,CAAA;QACjB;;;;WAIG;QACH,eAAe,CAAC,EAAE,OAAO,CAAA;QACzB;;;WAGG;QACH,mBAAmB,CAAC,EAAE,MAAM,CAAA;QAC5B;;;WAGG;QACH,uBAAuB,CAAC,EAAE,MAAM,CAAA;KACjC,CAAA;IACD,OAAO,CAAC,EAAE;QACR;;;;WAIG;QACH,QAAQ,EAAE,OAAO,GAAG,IAAI,CAAA;QACxB,4DAA4D;QAC5D,UAAU,CAAC,EAAE,MAAM,CAAA;KACpB,CAAA;IACD,MAAM,CAAC,EAAE;QACP,+EAA+E;QAC/E,IAAI,CAAC,EAAE,MAAM,CAAA;QACb,kDAAkD;QAClD,SAAS,CAAC,EAAE,MAAM,CAAA;KACnB,CAAA;IACD,SAAS,CAAC,EAAE;QACV,uFAAuF;QACvF,IAAI,CAAC,EAAE,MAAM,CAAA;KACd,CAAA;IACD,MAAM,CAAC,EAAE;QACP,2CAA2C;QAC3C,KAAK,CAAC,EAAE,MAAM,CAAA;QACd,yCAAyC;QACzC,MAAM,CAAC,EAAE,MAAM,CAAA;KAChB,CAAA;IACD;;;OAGG;IACH,KAAK,CAAC,EAAE;QACN,oEAAoE;QACpE,SAAS,CAAC,EAAE,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,WAAW,GAAG,WAAW,GAAG,MAAM,GAAG,QAAQ,CAAA;QACvF,kDAAkD;QAClD,SAAS,CAAC,EAAE,MAAM,CAAA;QAClB,2DAA2D;QAC3D,YAAY,CAAC,EAAE,MAAM,CAAA;QACrB,oEAAoE;QACpE,eAAe,CAAC,EAAE,MAAM,CAAA;QACxB,mCAAmC;QACnC,GAAG,CAAC,EAAE,OAAO,CAAA;QACb,oDAAoD;QACpD,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;QAC5B,4DAA4D;QAC5D,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KACjC,CAAA;IACD;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAMD;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,qBAAqB,EAC3B,QAAQ,EAAE,OAAO,CAAC,qBAAqB,CAAC,GACvC,qBAAqB,CA2DvB;AAED,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,qBAAqB,CAwB3F;AAED,yCAAyC;AACzC,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,qBAAqB,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAErF;AAED,0DAA0D;AAC1D,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,qBAAqB,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAErF;AAED,uDAAuD;AACvD,wBAAgB,kCAAkC,CAAC,GAAG,EAAE,qBAAqB,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAOpG;AAED,2EAA2E;AAC3E,wBAAgB,iCAAiC,CAAC,GAAG,EAAE,qBAAqB,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAMjG;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,qBAAqB,GAAG,MAAM,GAAG,SAAS,CAW5E;AAED,sEAAsE;AACtE,wBAAgB,QAAQ,CAAC,GAAG,EAAE,qBAAqB,GAAG,MAAM,CAG3D;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,qBAAqB,GAAG,MAAM,CAEnE"}

package/dist/project-config.js

@@ -0,0 +1,145 @@
+import { existsSync } from "node:fs";
+import { resolve } from "node:path";
+// ---------------------------------------------------------------------------
+// Merge + validate
+// ---------------------------------------------------------------------------
+/**
+ * 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 function mergeProjectConfig(base, override) {
+    return {
+        ...(base.supatype !== undefined || override.supatype !== undefined
+            ? { supatype: { ...base.supatype, ...override.supatype } }
+            : {}),
+        project: { ...base.project, ...override.project },
+        database: { ...base.database, ...override.database },
+        server: { ...base.server, ...override.server },
+        app: { ...base.app, ...override.app },
+        versions: { ...base.versions, ...override.versions },
+        ...(base.overrides !== undefined || override.overrides !== undefined
+            ? {
+                overrides: {
+                    ...base.overrides,
+                    ...override.overrides,
+                },
+            }
+            : {}),
+        ...(base.email !== undefined || override.email !== undefined
+            ? (() => {
+                const b = base.email;
+                const o = override.email;
+                const mergedSmtp = b?.smtp !== undefined || o?.smtp !== undefined
+                    ? { ...(b?.smtp ?? {}), ...(o?.smtp ?? {}) }
+                    : undefined;
+                return {
+                    email: {
+                        ...b,
+                        ...o,
+                        ...(mergedSmtp !== undefined ? { smtp: mergedSmtp } : {}),
+                    },
+                };
+            })()
+            : {}),
+        ...(base.storage !== undefined || override.storage !== undefined
+            ? {
+                storage: {
+                    ...base.storage,
+                    ...override.storage,
+                },
+            }
+            : {}),
+        ...(base.schema !== undefined || override.schema !== undefined
+            ? { schema: { ...base.schema, ...override.schema } }
+            : {}),
+        ...(base.functions !== undefined || override.functions !== undefined
+            ? { functions: { ...base.functions, ...override.functions } }
+            : {}),
+        ...(base.output !== undefined || override.output !== undefined
+            ? { output: { ...base.output, ...override.output } }
+            : {}),
+        ...(base.build !== undefined || override.build !== undefined
+            ? { build: { ...base.build, ...override.build } }
+            : {}),
+        ...(base.connection !== undefined || override.connection !== undefined
+            ? { connection: override.connection ?? base.connection }
+            : {}),
+    };
+}
+export function validateProjectConfig(raw, filename) {
+    if (typeof raw !== "object" || raw === null) {
+        throw new Error(`${filename}: expected a config object at the root`);
+    }
+    const cfg = raw;
+    if (!cfg["project"] || typeof cfg["project"]["name"] !== "string") {
+        throw new Error(`${filename}: project.name is required`);
+    }
+    if (!cfg["database"]) {
+        throw new Error(`${filename}: database section is required`);
+    }
+    if (!cfg["server"]) {
+        throw new Error(`${filename}: server section is required`);
+    }
+    if (!cfg["app"]) {
+        throw new Error(`${filename}: app section is required`);
+    }
+    if (!cfg["versions"]) {
+        throw new Error(`${filename}: versions section is required`);
+    }
+    return raw;
+}
+/** Schema entry path (with fallback). */
+export function schemaPathFromProject(cfg, cwd) {
+    return resolve(projectRootFromConfig(cfg, cwd), cfg.schema?.path ?? "schema/index.ts");
+}
+/** Resolve project root for schema/functions defaults. */
+export function projectRootFromConfig(cfg, cwd) {
+    return resolve(cwd, cfg.supatype?.root ?? ".");
+}
+/** Candidate functions directories in lookup order. */
+export function functionsPathCandidatesFromProject(cfg, cwd) {
+    const root = projectRootFromConfig(cfg, cwd);
+    if (cfg.functions?.path) {
+        return [resolve(root, cfg.functions.path)];
+    }
+    // Prefer modern default, but keep legacy fallback for compatibility.
+    return [resolve(root, "functions"), resolve(root, "supatype/functions")];
+}
+/** Preferred default functions path (used when creating new functions). */
+export function preferredFunctionsPathFromProject(cfg, cwd) {
+    const candidates = functionsPathCandidatesFromProject(cfg, cwd);
+    for (const dir of candidates) {
+        if (existsSync(dir))
+            return dir;
+    }
+    return candidates[0] ?? resolve(projectRootFromConfig(cfg, cwd), "functions");
+}
+/**
+ * Derive the supatype-server base URL from the project config.
+ * Returns undefined if the mode is "managed" (cloud controls the URL).
+ */
+export function serverBaseUrl(cfg) {
+    const port = cfg.server.port ?? 54321;
+    switch (cfg.server.mode) {
+        case "dev":
+        case "standalone":
+            return cfg.server.domain
+                ? `https://${cfg.server.domain}`
+                : `http://localhost:${port}`;
+        case "managed":
+            return undefined;
+    }
+}
+/** The local Postgres DSN derived from project name (dev default). */
+export function localDSN(cfg) {
+    const port = 5432; // standard; per-project state dir isolates data dirs
+    return `postgres://postgres:postgres@127.0.0.1:${port}/${cfg.project.name}?sslmode=disable`;
+}
+/**
+ * Resolve the database connection string.
+ * Prefers optional `connection` in config, then `DATABASE_URL` env, then a local default DSN.
+ */
+export function connectionString(cfg) {
+    return cfg.connection ?? process.env["DATABASE_URL"] ?? localDSN(cfg);
+}
+//# sourceMappingURL=project-config.js.map

package/dist/project-config.js.map

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

package/dist/pull-utils.d.ts

@@ -9,6 +9,21 @@ export interface ColumnInfo {
     isUnique: boolean;
     hasDefault: boolean;
 }
+/** Engine `/introspect` column shape (see {@link IntrospectResult} in engine-client). */
+export interface IntrospectColumn {
+    name: string;
+    type: string;
+    nullable: boolean;
+    default?: string;
+    primaryKey?: boolean;
+    unique?: boolean;
+    references?: {
+        table: string;
+        column: string;
+    };
+}
+/** Map engine introspection JSON to {@link ColumnInfo} for {@link pgTypeToField}. */
+export declare function introspectColumnToColumnInfo(col: IntrospectColumn): ColumnInfo;
 /** Map a Postgres column type to the corresponding field.X() call string. */
 export declare function pgTypeToField(col: ColumnInfo): string;
 /** Convert snake_case table name to PascalCase model export name. */

package/dist/pull-utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pull-utils.d.ts","sourceRoot":"","sources":["../src/pull-utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,OAAO,CAAA;IACjB,SAAS,EAAE,OAAO,CAAA;IAClB,QAAQ,EAAE,OAAO,CAAA;IACjB,UAAU,EAAE,OAAO,CAAA;CACpB;AAED,6EAA6E;AAC7E,wBAAgB,aAAa,CAAC,GAAG,EAAE,UAAU,GAAG,MAAM,CAmCrD;AAED,qEAAqE;AACrE,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAI7C"}
+{"version":3,"file":"pull-utils.d.ts","sourceRoot":"","sources":["../src/pull-utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,OAAO,CAAA;IACjB,SAAS,EAAE,OAAO,CAAA;IAClB,QAAQ,EAAE,OAAO,CAAA;IACjB,UAAU,EAAE,OAAO,CAAA;CACpB;AAED,yFAAyF;AACzF,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,OAAO,CAAA;IACjB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,UAAU,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAA;CAC/C;AAED,qFAAqF;AACrF,wBAAgB,4BAA4B,CAAC,GAAG,EAAE,gBAAgB,GAAG,UAAU,CAU9E;AAED,6EAA6E;AAC7E,wBAAgB,aAAa,CAAC,GAAG,EAAE,UAAU,GAAG,MAAM,CAmCrD;AAED,qEAAqE;AACrE,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAI7C"}

package/dist/pull-utils.js

@@ -1,6 +1,18 @@
 /**
  * Utilities for the `pull` command — extracted for unit testability.
  */
+/** Map engine introspection JSON to {@link ColumnInfo} for {@link pgTypeToField}. */
+export function introspectColumnToColumnInfo(col) {
+    const def = col.default;
+    return {
+        name: col.name,
+        pgType: col.type,
+        nullable: col.nullable,
+        isPrimary: col.primaryKey ?? false,
+        isUnique: col.unique ?? false,
+        hasDefault: def !== undefined && def !== "",
+    };
+}
 /** Map a Postgres column type to the corresponding field.X() call string. */
 export function pgTypeToField(col) {
     const opts = { required: !col.nullable };

package/dist/pull-utils.js.map

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

package/dist/release-pins.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Release pins read from files under packages/cli/releases/.
+ * CI (deno-releases workflow) uses the same paths — bump only releases/deno/VERSION.
+ */
+/** Pinned Deno runtime for edge functions (also published to CDN under /deno/v{version}/). */
+export declare const DENO_RELEASE_PIN: string;
+//# sourceMappingURL=release-pins.d.ts.map

package/dist/release-pins.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"release-pins.d.ts","sourceRoot":"","sources":["../src/release-pins.ts"],"names":[],"mappings":"AAAA;;;GAGG;AA0BH,8FAA8F;AAC9F,eAAO,MAAM,gBAAgB,QAAiC,CAAA"}