@tekki-forge/runtime-api 0.1.0

package/dist/backup.d.ts

@@ -0,0 +1,142 @@
+/**
+ * Database backups: a compressed plain-SQL pg_dump plus a manifest (and the list of uploaded files),
+ * stored in a local folder or object storage. Used by `forge backup` and by the scheduled
+ * `forge.backup` job when the jobs plugin runs a worker. Node built-ins only.
+ */
+export interface PgConnection {
+    host: string;
+    port: number;
+    user: string;
+    password: string;
+    database: string;
+    sslmode?: string;
+    schema?: string;
+}
+export declare function parseDatabaseUrl(url: string): PgConnection;
+/** Where pg_dump/psql run: on this machine, or inside a PostgreSQL container (docker exec / docker compose exec). */
+export type PgExec = {
+    kind: "local";
+} | {
+    kind: "docker";
+    container: string;
+} | {
+    kind: "compose";
+    service: string;
+    cwd: string;
+};
+export interface PgCommand {
+    command: string;
+    args: string[];
+    /** Extra environment (the password never appears in arguments). */
+    env: Record<string, string>;
+    cwd?: string;
+}
+/**
+ * Build the command line for a PostgreSQL client tool. Inside a container the tool connects over the
+ * local socket as the database user (trusted in the official image), so no password is passed at all.
+ */
+export declare function pgCommand(tool: "pg_dump" | "psql", exec: PgExec, conn: PgConnection, args: string[]): PgCommand;
+/** FORGE_PG_CONTAINER=<name> runs the tools in that container (docker exec), otherwise on this machine. */
+export declare function defaultPgExec(env?: NodeJS.ProcessEnv): PgExec;
+/** pg_dump arguments: plain SQL that drops and recreates every object, without owners or grants (portable). */
+export declare function pgDumpArgs(conn: PgConnection): string[];
+/** psql arguments for a restore: stop at the first error, all or nothing. */
+export declare function restoreArgs(): string[];
+/** Run a query through psql and return its unaligned output. */
+export declare function psqlQuery(exec: PgExec, conn: PgConnection, sql: string): Promise<string>;
+/** Major version of a local client tool, or null when it is not installed. */
+export declare function localToolMajor(tool: "pg_dump" | "psql"): Promise<number | null>;
+export interface BackupStore {
+    /** Human-readable location, e.g. "/srv/backups" or "s3://bucket/backups/". */
+    readonly location: string;
+    put(name: string, file: string, source: string): Promise<void>;
+    /** Copy a stored file to a local path. */
+    fetch(name: string, file: string, target: string): Promise<void>;
+    /** Names of the stored backups (those with a manifest). */
+    list(): Promise<string[]>;
+    remove(name: string): Promise<void>;
+}
+export declare function localBackupStore(dir: string): BackupStore;
+export interface FileEntry {
+    key: string;
+    name: string;
+    size: number;
+    mimeType: string;
+    entity: string;
+    field: string;
+    recordId: string | null;
+    status: string;
+}
+export interface BackupManifest {
+    format: 1;
+    app: string;
+    name: string;
+    createdAt: string;
+    database: {
+        host: string;
+        port: number;
+        database: string;
+        schema?: string;
+    };
+    dump: {
+        file: string;
+        bytes: number;
+        sha256: string;
+        tool: string;
+    };
+    /** Uploaded files referenced by the database (the objects themselves stay in their storage). */
+    files: {
+        count: number;
+        bytes: number;
+        storage: string | null;
+        items: FileEntry[];
+    };
+}
+/** "<slug>-20261001T030000Z" — sortable, safe as a folder or object prefix. */
+export declare function backupName(slug: string, at?: Date): string;
+/** Backups to delete so that the `keep` most recent remain (only names Forge created are considered). */
+export declare function backupsToPrune(names: string[], keep: number): string[];
+export interface CreateBackupOptions {
+    databaseUrl: string;
+    store: BackupStore;
+    exec?: PgExec;
+    app: {
+        name: string;
+        slug: string;
+    };
+    /** Uploaded files to list in the manifest (storage plugin's File table). */
+    files?: () => Promise<FileEntry[]>;
+    /** Where uploaded objects live, for the manifest (e.g. "s3://bucket"). */
+    fileStorage?: string | null;
+    /** Delete older backups so this many remain. */
+    keep?: number;
+    name?: string;
+    log?: (line: string) => void;
+}
+export declare function createBackup(o: CreateBackupOptions): Promise<{
+    manifest: BackupManifest;
+    pruned: string[];
+}>;
+export declare function readManifest(store: BackupStore, name: string): Promise<BackupManifest>;
+/** Manifests of every stored backup, newest first. */
+export declare function listBackups(store: BackupStore): Promise<BackupManifest[]>;
+/** Uploaded files listed in the storage plugin's `files` table (empty without the plugin), read through psql. */
+export declare function filesFromDatabase(exec: PgExec, conn: PgConnection): Promise<FileEntry[]>;
+/** The same list through Prisma (worker side). */
+export declare function filesFromPrisma(prisma: any): Promise<FileEntry[]>;
+/** Tables of the target database with their (estimated) row counts — what a restore overwrites. */
+export declare function databaseTables(exec: PgExec, conn: PgConnection): Promise<{
+    table: string;
+    rows: number;
+}[]>;
+/** Replace the database's contents with a backup (one transaction; the dump drops and recreates its objects). */
+export declare function restoreBackup(o: {
+    databaseUrl: string;
+    store: BackupStore;
+    name: string;
+    exec?: PgExec;
+    log?: (line: string) => void;
+}): Promise<BackupManifest>;
+export declare function formatBytes(n: number): string;
+/** A database URL that points at a non-local host or a production environment. */
+export declare function looksLikeProduction(conn: PgConnection, env?: NodeJS.ProcessEnv): boolean;

package/dist/backup.js

@@ -0,0 +1,280 @@
+import { spawn } from "node:child_process";
+import { createHash } from "node:crypto";
+import { createReadStream, createWriteStream, existsSync } from "node:fs";
+import { mkdir, mkdtemp, readdir, readFile, rm, stat, writeFile } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import { join, resolve } from "node:path";
+import { pipeline } from "node:stream/promises";
+import { createGunzip, createGzip } from "node:zlib";
+export function parseDatabaseUrl(url) {
+    let u;
+    try {
+        u = new URL(url);
+    }
+    catch {
+        throw new Error("DATABASE_URL is not a valid postgresql:// URL");
+    }
+    if (u.protocol !== "postgresql:" && u.protocol !== "postgres:")
+        throw new Error("DATABASE_URL must be a postgresql:// URL");
+    const database = decodeURIComponent(u.pathname.replace(/^\//, ""));
+    if (!database)
+        throw new Error("DATABASE_URL has no database name");
+    return {
+        host: u.hostname || "localhost",
+        port: Number(u.port || 5432),
+        user: decodeURIComponent(u.username || "postgres"),
+        password: decodeURIComponent(u.password),
+        database,
+        ...(u.searchParams.get("sslmode") ? { sslmode: u.searchParams.get("sslmode") } : {}),
+        ...(u.searchParams.get("schema") ? { schema: u.searchParams.get("schema") } : {}),
+    };
+}
+/**
+ * Build the command line for a PostgreSQL client tool. Inside a container the tool connects over the
+ * local socket as the database user (trusted in the official image), so no password is passed at all.
+ */
+export function pgCommand(tool, exec, conn, args) {
+    if (exec.kind === "local") {
+        const env = {};
+        if (conn.password)
+            env.PGPASSWORD = conn.password;
+        if (conn.sslmode)
+            env.PGSSLMODE = conn.sslmode;
+        return { command: tool, args: ["-h", conn.host, "-p", String(conn.port), "-U", conn.user, "-d", conn.database, ...args], env };
+    }
+    const inner = [tool, "-U", conn.user, "-d", conn.database, ...args];
+    if (exec.kind === "docker")
+        return { command: "docker", args: ["exec", "-i", exec.container, ...inner], env: {} };
+    return { command: "docker", args: ["compose", "exec", "-T", exec.service, ...inner], env: {}, cwd: exec.cwd };
+}
+/** FORGE_PG_CONTAINER=<name> runs the tools in that container (docker exec), otherwise on this machine. */
+export function defaultPgExec(env = process.env) {
+    return env.FORGE_PG_CONTAINER ? { kind: "docker", container: env.FORGE_PG_CONTAINER } : { kind: "local" };
+}
+/** pg_dump arguments: plain SQL that drops and recreates every object, without owners or grants (portable). */
+export function pgDumpArgs(conn) {
+    return ["--format=plain", "--no-owner", "--no-privileges", "--clean", "--if-exists", ...(conn.schema ? [`--schema=${conn.schema}`] : [])];
+}
+/** psql arguments for a restore: stop at the first error, all or nothing. */
+export function restoreArgs() {
+    return ["-v", "ON_ERROR_STOP=1", "--single-transaction", "--quiet", "-f", "-"];
+}
+function spawnTool(cmd, stdio) {
+    return new Promise((resolvePromise, reject) => {
+        const child = spawn(cmd.command, cmd.args, { cwd: cmd.cwd, env: { ...process.env, ...cmd.env }, stdio: ["pipe", stdio.stdout ? "pipe" : "pipe", "pipe"] });
+        let out = "";
+        let err = "";
+        child.stderr.on("data", (d) => (err += d));
+        if (!stdio.stdout)
+            child.stdout.on("data", (d) => (out += d));
+        const streams = [];
+        if (stdio.stdout)
+            streams.push(pipeline(child.stdout, stdio.stdout));
+        if (stdio.stdin)
+            streams.push(pipeline(stdio.stdin, child.stdin));
+        else
+            child.stdin.end();
+        child.on("error", (e) => reject(e.code === "ENOENT" ? new Error(`${cmd.command} not found — install the PostgreSQL client tools or use the database container`) : e));
+        child.on("close", (code) => {
+            Promise.all(streams).then(() => (code === 0 ? resolvePromise(out) : reject(new Error(`${cmd.command} ${cmd.args.slice(0, 4).join(" ")} … exited with code ${code}${err ? `: ${err.trim().split("\n").slice(-5).join("\n")}` : ""}`))), (e) => reject(code === 0 ? e : new Error(`${cmd.command} exited with code ${code}${err ? `: ${err.trim().split("\n").slice(-5).join("\n")}` : ""}`)));
+        });
+    });
+}
+/** Run a query through psql and return its unaligned output. */
+export function psqlQuery(exec, conn, sql) {
+    return spawnTool(pgCommand("psql", exec, conn, ["-X", "-A", "-t", "-v", "ON_ERROR_STOP=1", "-c", sql]), {});
+}
+/** Major version of a local client tool, or null when it is not installed. */
+export async function localToolMajor(tool) {
+    try {
+        const out = await spawnTool({ command: tool, args: ["--version"], env: {} }, {});
+        const m = /(\d+)(?:\.\d+)?/.exec(out);
+        return m ? Number(m[1]) : null;
+    }
+    catch {
+        return null;
+    }
+}
+const SAFE_NAME = /^[A-Za-z0-9][A-Za-z0-9._-]{0,120}$/;
+function assertName(name) {
+    if (!SAFE_NAME.test(name))
+        throw new Error(`Invalid backup name "${name}"`);
+}
+export function localBackupStore(dir) {
+    const root = resolve(dir);
+    return {
+        location: root,
+        async put(name, file, source) {
+            assertName(name);
+            await mkdir(join(root, name), { recursive: true });
+            await pipeline(createReadStream(source), createWriteStream(join(root, name, file)));
+        },
+        async fetch(name, file, target) {
+            assertName(name);
+            const p = join(root, name, file);
+            if (!existsSync(p))
+                throw new Error(`Backup "${name}" has no ${file} in ${root}`);
+            await pipeline(createReadStream(p), createWriteStream(target));
+        },
+        async list() {
+            if (!existsSync(root))
+                return [];
+            const entries = await readdir(root, { withFileTypes: true });
+            return entries.filter((e) => e.isDirectory() && SAFE_NAME.test(e.name) && existsSync(join(root, e.name, "manifest.json"))).map((e) => e.name);
+        },
+        async remove(name) {
+            assertName(name);
+            await rm(join(root, name), { recursive: true, force: true });
+        },
+    };
+}
+/** "<slug>-20261001T030000Z" — sortable, safe as a folder or object prefix. */
+export function backupName(slug, at = new Date()) {
+    const ts = at.toISOString().replace(/[-:]/g, "").replace(/\.\d+Z$/, "Z");
+    return `${slug}-${ts}`;
+}
+const STAMP = /-(\d{8}T\d{6}Z)$/;
+/** Backups to delete so that the `keep` most recent remain (only names Forge created are considered). */
+export function backupsToPrune(names, keep) {
+    if (!Number.isInteger(keep) || keep < 1)
+        throw new Error("keep must be a positive integer");
+    const ours = names.filter((n) => STAMP.test(n)).sort((a, b) => STAMP.exec(b)[1].localeCompare(STAMP.exec(a)[1]) || b.localeCompare(a));
+    return ours.slice(keep);
+}
+async function sha256File(path) {
+    const hash = createHash("sha256");
+    await pipeline(createReadStream(path), hash);
+    return hash.digest("hex");
+}
+export async function createBackup(o) {
+    const conn = parseDatabaseUrl(o.databaseUrl);
+    const exec = o.exec ?? defaultPgExec();
+    const name = o.name ?? backupName(o.app.slug);
+    assertName(name);
+    const dir = await mkdtemp(join(tmpdir(), "forge-backup-"));
+    try {
+        const dumpPath = join(dir, "database.sql.gz");
+        o.log?.(`Dumping ${conn.database} on ${conn.host}:${conn.port}…`);
+        const gzip = createGzip({ level: 6 });
+        const out = createWriteStream(dumpPath);
+        const piped = pipeline(gzip, out);
+        await spawnTool(pgCommand("pg_dump", exec, conn, pgDumpArgs(conn)), { stdout: gzip });
+        await piped;
+        const files = o.files ? await o.files() : [];
+        const manifest = {
+            format: 1,
+            app: o.app.name,
+            name,
+            createdAt: new Date().toISOString(),
+            database: { host: conn.host, port: conn.port, database: conn.database, ...(conn.schema ? { schema: conn.schema } : {}) },
+            dump: { file: "database.sql.gz", bytes: (await stat(dumpPath)).size, sha256: await sha256File(dumpPath), tool: exec.kind === "local" ? "pg_dump" : `pg_dump (${exec.kind === "docker" ? exec.container : exec.service} container)` },
+            files: { count: files.length, bytes: files.reduce((s, f) => s + (f.size ?? 0), 0), storage: o.fileStorage ?? null, items: files },
+        };
+        const manifestPath = join(dir, "manifest.json");
+        await writeFile(manifestPath, JSON.stringify(manifest, null, 2) + "\n");
+        // The dump first, the manifest last: a backup without a manifest is incomplete and never listed.
+        await o.store.put(name, "database.sql.gz", dumpPath);
+        await o.store.put(name, "manifest.json", manifestPath);
+        o.log?.(`Saved ${name} (${formatBytes(manifest.dump.bytes)}) to ${o.store.location}`);
+        const pruned = o.keep ? backupsToPrune(await o.store.list(), o.keep) : [];
+        for (const old of pruned) {
+            await o.store.remove(old);
+            o.log?.(`Removed old backup ${old}`);
+        }
+        return { manifest, pruned };
+    }
+    finally {
+        await rm(dir, { recursive: true, force: true });
+    }
+}
+export async function readManifest(store, name) {
+    assertName(name);
+    const dir = await mkdtemp(join(tmpdir(), "forge-backup-"));
+    try {
+        await store.fetch(name, "manifest.json", join(dir, "manifest.json"));
+        return JSON.parse(await readFile(join(dir, "manifest.json"), "utf8"));
+    }
+    finally {
+        await rm(dir, { recursive: true, force: true });
+    }
+}
+/** Manifests of every stored backup, newest first. */
+export async function listBackups(store) {
+    const out = [];
+    for (const name of await store.list()) {
+        try {
+            out.push(await readManifest(store, name));
+        }
+        catch {
+            // unreadable manifest: skip
+        }
+    }
+    return out.sort((a, b) => b.createdAt.localeCompare(a.createdAt));
+}
+/** Uploaded files listed in the storage plugin's `files` table (empty without the plugin), read through psql. */
+export async function filesFromDatabase(exec, conn) {
+    const exists = (await psqlQuery(exec, conn, "select to_regclass('files') is not null")).trim();
+    if (exists !== "t")
+        return [];
+    const out = await psqlQuery(exec, conn, "select coalesce(json_agg(json_build_object('key', key, 'name', name, 'size', size, 'mimeType', mime_type, 'entity', entity, 'field', field, 'recordId', record_id, 'status', status) order by created_at), '[]') from files where status <> 'deleted'");
+    return JSON.parse(out.trim() || "[]");
+}
+/** The same list through Prisma (worker side). */
+export async function filesFromPrisma(prisma) {
+    if (!prisma.file)
+        return [];
+    const rows = await prisma.file.findMany({
+        where: { status: { not: "deleted" } },
+        orderBy: { createdAt: "asc" },
+        select: { key: true, name: true, size: true, mimeType: true, entity: true, field: true, recordId: true, status: true },
+    });
+    return rows;
+}
+/** Tables of the target database with their (estimated) row counts — what a restore overwrites. */
+export async function databaseTables(exec, conn) {
+    const out = await psqlQuery(exec, conn, "select schemaname || '.' || relname, n_live_tup from pg_stat_user_tables order by 1");
+    return out
+        .split("\n")
+        .filter(Boolean)
+        .map((l) => {
+        const [table, rows] = l.split("|");
+        return { table: table, rows: Number(rows) };
+    });
+}
+/** Replace the database's contents with a backup (one transaction; the dump drops and recreates its objects). */
+export async function restoreBackup(o) {
+    const conn = parseDatabaseUrl(o.databaseUrl);
+    const manifest = await readManifest(o.store, o.name);
+    const dir = await mkdtemp(join(tmpdir(), "forge-restore-"));
+    try {
+        const dumpPath = join(dir, manifest.dump.file);
+        await o.store.fetch(o.name, manifest.dump.file, dumpPath);
+        if ((await sha256File(dumpPath)) !== manifest.dump.sha256)
+            throw new Error(`Backup ${o.name} is corrupted (checksum mismatch) — nothing was changed`);
+        o.log?.(`Restoring ${o.name} into ${conn.database} on ${conn.host}:${conn.port}…`);
+        await spawnTool(pgCommand("psql", o.exec ?? defaultPgExec(), conn, restoreArgs()), { stdin: createReadStream(dumpPath).pipe(createGunzip()) });
+        return manifest;
+    }
+    finally {
+        await rm(dir, { recursive: true, force: true });
+    }
+}
+export function formatBytes(n) {
+    if (n < 1024)
+        return `${n} B`;
+    const units = ["KB", "MB", "GB", "TB"];
+    let v = n / 1024;
+    let i = 0;
+    while (v >= 1024 && i < units.length - 1) {
+        v /= 1024;
+        i++;
+    }
+    return `${v.toFixed(v < 10 ? 1 : 0)} ${units[i]}`;
+}
+/** A database URL that points at a non-local host or a production environment. */
+export function looksLikeProduction(conn, env = process.env) {
+    if (env.NODE_ENV === "production" || env.FORGE_ENV === "production")
+        return true;
+    return !["localhost", "127.0.0.1", "::1", "[::1]", "postgres", "db", "host.docker.internal"].includes(conn.host);
+}
+//# sourceMappingURL=backup.js.map

package/dist/backup.js.map

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

package/dist/bootstrap.d.ts

@@ -0,0 +1,57 @@
+import "reflect-metadata";
+import { type DynamicModule, type INestApplication, type LogLevel, type Type } from "@nestjs/common";
+import type { JobDefinition } from "./jobs.js";
+import type { AppIR } from "@tekki-forge/compiler";
+import type { ForgeApiPlugin, ForgeWorkerPlugin, PluginContext } from "./plugin.js";
+import { ForgeService, type ForgeServiceOptions } from "./service.js";
+export interface ForgeApiOptions extends ForgeServiceOptions {
+    /** Plugin runtimes, generated into apps/api/src/.generated/plugins.ts. */
+    plugins?: ForgeApiPlugin[];
+    /** Job definitions from apps/api/src/jobs (generated registry). */
+    jobs?: JobDefinition[];
+    /** Generated OpenAPI document served at `<prefix>/openapi.json` and `<prefix>/docs`. */
+    openapi?: Record<string, unknown>;
+    /** Allowed browser origins for direct (non-proxied) API calls. */
+    cors?: string[];
+    /** Extra Nest modules contributed by the application or plugins. */
+    imports?: DynamicModule["imports"];
+    logger?: LogLevel[] | false;
+}
+export declare function forgeModule(service: ForgeService, imports?: DynamicModule["imports"], pluginControllers?: Type[]): DynamicModule;
+export interface ForgeApi {
+    app: INestApplication;
+    service: ForgeService;
+    plugins: {
+        runtime: ForgeApiPlugin;
+        ctx: PluginContext;
+    }[];
+}
+/** Instantiate the service and run every plugin's setup (shared by the API server and the worker). */
+export declare function setupForge(options: ForgeApiOptions): Promise<{
+    service: ForgeService;
+    plugins: {
+        runtime: ForgeApiPlugin;
+        ctx: PluginContext;
+    }[];
+}>;
+/**
+ * `backups: { schedule }` in forge.config.ts: a cron job run by the jobs plugin's worker. It needs pg_dump
+ * (postgresql-client, installed in the generated API image) and stores to S3 when the storage plugin uses
+ * S3, else to FORGE_BACKUP_DIR (default ./backups — mount a volume there).
+ */
+export declare function backupJob(app: AppIR, service: ForgeService): JobDefinition;
+export declare function createForgeApi(options: ForgeApiOptions): Promise<INestApplication>;
+export declare function createForge(options: ForgeApiOptions): Promise<ForgeApi>;
+export declare function startForgeApi(options: ForgeApiOptions & {
+    port?: number;
+    host?: string;
+}): Promise<INestApplication>;
+/**
+ * Background worker process: same setup as the API (plugins, file store, mail) but no HTTP server.
+ * Started by apps/api/src/worker.ts.
+ */
+export declare function startForgeWorker(options: ForgeApiOptions & {
+    workerPlugins: ForgeWorkerPlugin[];
+}): Promise<{
+    stop(): Promise<void>;
+}>;