@zmeel/db 0.1.0

package/dist/backup-lib.test.js

@@ -0,0 +1,146 @@
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { afterEach, describe, expect, it } from "vitest";
+import postgres from "postgres";
+import { createBufferedTextFileWriter, runDatabaseBackup, runDatabaseRestore } from "./backup-lib.js";
+import { ensurePostgresDatabase } from "./client.js";
+import { getEmbeddedPostgresTestSupport, startEmbeddedPostgresTestDatabase, } from "./test-embedded-postgres.js";
+const cleanups = [];
+const embeddedPostgresSupport = await getEmbeddedPostgresTestSupport();
+const describeEmbeddedPostgres = embeddedPostgresSupport.supported ? describe : describe.skip;
+function createTempDir(prefix) {
+    const dir = fs.mkdtempSync(path.join(os.tmpdir(), prefix));
+    cleanups.push(() => {
+        fs.rmSync(dir, { recursive: true, force: true });
+    });
+    return dir;
+}
+async function createTempDatabase() {
+    const db = await startEmbeddedPostgresTestDatabase("zmeel-db-backup-");
+    cleanups.push(db.cleanup);
+    return db.connectionString;
+}
+async function createSiblingDatabase(connectionString, databaseName) {
+    const adminUrl = new URL(connectionString);
+    adminUrl.pathname = "/postgres";
+    await ensurePostgresDatabase(adminUrl.toString(), databaseName);
+    const targetUrl = new URL(connectionString);
+    targetUrl.pathname = `/${databaseName}`;
+    return targetUrl.toString();
+}
+afterEach(async () => {
+    while (cleanups.length > 0) {
+        const cleanup = cleanups.pop();
+        await cleanup?.();
+    }
+});
+if (!embeddedPostgresSupport.supported) {
+    console.warn(`Skipping embedded Postgres backup tests on this host: ${embeddedPostgresSupport.reason ?? "unsupported environment"}`);
+}
+describe("createBufferedTextFileWriter", () => {
+    it("preserves line boundaries across buffered flushes", async () => {
+        const tempDir = createTempDir("zmeel-buffered-writer-");
+        const outputPath = path.join(tempDir, "backup.sql");
+        const writer = createBufferedTextFileWriter(outputPath, 16);
+        const lines = [
+            "-- header",
+            "BEGIN;",
+            "",
+            "INSERT INTO test VALUES (1);",
+            "-- footer",
+        ];
+        for (const line of lines) {
+            writer.emit(line);
+        }
+        await writer.close();
+        expect(fs.readFileSync(outputPath, "utf8")).toBe(lines.join("\n"));
+    });
+});
+describeEmbeddedPostgres("runDatabaseBackup", () => {
+    it("backs up and restores large table payloads without materializing one giant string", async () => {
+        const sourceConnectionString = await createTempDatabase();
+        const restoreConnectionString = await createSiblingDatabase(sourceConnectionString, "zmeel_restore_target");
+        const backupDir = createTempDir("zmeel-db-backup-output-");
+        const sourceSql = postgres(sourceConnectionString, { max: 1, onnotice: () => { } });
+        const restoreSql = postgres(restoreConnectionString, { max: 1, onnotice: () => { } });
+        try {
+            await sourceSql.unsafe(`
+          CREATE TYPE "public"."backup_test_state" AS ENUM ('pending', 'done');
+        `);
+            await sourceSql.unsafe(`
+          CREATE TABLE "public"."backup_test_records" (
+            "id" serial PRIMARY KEY,
+            "title" text NOT NULL,
+            "payload" text NOT NULL,
+            "state" "public"."backup_test_state" NOT NULL,
+            "metadata" jsonb,
+            "created_at" timestamptz NOT NULL DEFAULT now()
+          );
+        `);
+            const payload = "x".repeat(8192);
+            for (let index = 0; index < 160; index += 1) {
+                const createdAt = new Date(Date.UTC(2026, 0, 1, 0, 0, index));
+                await sourceSql `
+            INSERT INTO "public"."backup_test_records" (
+              "title",
+              "payload",
+              "state",
+              "metadata",
+              "created_at"
+            )
+            VALUES (
+              ${`row-${index}`},
+              ${payload},
+              ${index % 2 === 0 ? "pending" : "done"}::"public"."backup_test_state",
+              ${JSON.stringify({ index, even: index % 2 === 0 })}::jsonb,
+              ${createdAt}
+            )
+          `;
+            }
+            const result = await runDatabaseBackup({
+                connectionString: sourceConnectionString,
+                backupDir,
+                retentionDays: 7,
+                filenamePrefix: "zmeel-test",
+            });
+            expect(result.backupFile).toMatch(/zmeel-test-.*\.sql$/);
+            expect(result.sizeBytes).toBeGreaterThan(1024 * 1024);
+            expect(fs.existsSync(result.backupFile)).toBe(true);
+            await runDatabaseRestore({
+                connectionString: restoreConnectionString,
+                backupFile: result.backupFile,
+            });
+            const counts = await restoreSql.unsafe(`
+          SELECT count(*)::int AS count
+          FROM "public"."backup_test_records"
+        `);
+            expect(counts[0]?.count).toBe(160);
+            const sampleRows = await restoreSql.unsafe(`
+          SELECT "title", "payload", "state"::text AS "state", "metadata"
+          FROM "public"."backup_test_records"
+          WHERE "title" IN ('row-0', 'row-159')
+          ORDER BY "title"
+        `);
+            expect(sampleRows).toEqual([
+                {
+                    title: "row-0",
+                    payload,
+                    state: "pending",
+                    metadata: { index: 0, even: true },
+                },
+                {
+                    title: "row-159",
+                    payload,
+                    state: "done",
+                    metadata: { index: 159, even: false },
+                },
+            ]);
+        }
+        finally {
+            await sourceSql.end();
+            await restoreSql.end();
+        }
+    }, 60_000);
+});
+//# sourceMappingURL=backup-lib.test.js.map

package/dist/backup-lib.test.js.map

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

package/dist/backup.d.ts

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

package/dist/backup.d.ts.map

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

package/dist/backup.js

@@ -0,0 +1,103 @@
+import { existsSync, readFileSync } from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { formatDatabaseBackupResult, runDatabaseBackup } from "./backup-lib.js";
+function expandHomePrefix(value) {
+    if (value === "~")
+        return os.homedir();
+    if (value.startsWith("~/"))
+        return path.resolve(os.homedir(), value.slice(2));
+    return value;
+}
+function resolvezmeelHomeDir() {
+    const envHome = process.env.ZMEEL_HOME?.trim();
+    if (envHome)
+        return path.resolve(expandHomePrefix(envHome));
+    return path.resolve(os.homedir(), ".zmeel");
+}
+function resolvezmeelInstanceId() {
+    const raw = process.env.ZMEEL_INSTANCE_ID?.trim() || "default";
+    if (!/^[a-zA-Z0-9_-]+$/.test(raw)) {
+        throw new Error(`Invalid ZMEEL_INSTANCE_ID '${raw}'.`);
+    }
+    return raw;
+}
+function resolveDefaultConfigPath() {
+    return path.resolve(resolvezmeelHomeDir(), "instances", resolvezmeelInstanceId(), "config.json");
+}
+function readConfig(configPath) {
+    if (!existsSync(configPath))
+        return null;
+    try {
+        const parsed = JSON.parse(readFileSync(configPath, "utf8"));
+        return typeof parsed === "object" && parsed ? parsed : null;
+    }
+    catch {
+        return null;
+    }
+}
+function asPositiveInt(value) {
+    if (typeof value !== "number" || !Number.isFinite(value))
+        return null;
+    const rounded = Math.trunc(value);
+    return rounded > 0 ? rounded : null;
+}
+function resolveEmbeddedPort(config) {
+    return asPositiveInt(config?.database?.embeddedPostgresPort) ?? 54329;
+}
+function resolveConnectionString(config) {
+    const envUrl = process.env.DATABASE_URL?.trim();
+    if (envUrl)
+        return envUrl;
+    if (config?.database?.mode === "postgres" && typeof config.database.connectionString === "string") {
+        const trimmed = config.database.connectionString.trim();
+        if (trimmed)
+            return trimmed;
+    }
+    const port = resolveEmbeddedPort(config);
+    return `postgres://zmeel:zmeel@127.0.0.1:${port}/zmeel`;
+}
+function resolveDefaultBackupDir() {
+    return path.resolve(resolvezmeelHomeDir(), "instances", resolvezmeelInstanceId(), "data", "backups");
+}
+function resolveBackupDir(config) {
+    const raw = config?.database?.backup?.dir;
+    if (typeof raw === "string" && raw.trim().length > 0) {
+        return path.resolve(expandHomePrefix(raw.trim()));
+    }
+    return resolveDefaultBackupDir();
+}
+function resolveRetentionDays(config) {
+    return asPositiveInt(config?.database?.backup?.retentionDays) ?? 30;
+}
+async function main() {
+    const configPath = resolveDefaultConfigPath();
+    const config = readConfig(configPath);
+    const connectionString = resolveConnectionString(config);
+    const backupDir = resolveBackupDir(config);
+    const retentionDays = resolveRetentionDays(config);
+    console.log(`Config path: ${configPath}`);
+    console.log(`Backing up database to: ${backupDir}`);
+    console.log(`Retention window: ${retentionDays} day(s)`);
+    try {
+        const result = await runDatabaseBackup({
+            connectionString,
+            backupDir,
+            retentionDays,
+            filenamePrefix: "zmeel",
+        });
+        console.log(`Backup saved: ${formatDatabaseBackupResult(result)}`);
+    }
+    catch (err) {
+        console.error("Backup failed.");
+        if (err instanceof Error) {
+            console.error(err.message);
+        }
+        else {
+            console.error(String(err));
+        }
+        process.exit(1);
+    }
+}
+await main();
+//# 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/check-migration-numbering.d.ts

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

package/dist/check-migration-numbering.d.ts.map

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

package/dist/check-migration-numbering.js

@@ -0,0 +1,64 @@
+import { readdir, readFile } from "node:fs/promises";
+import { fileURLToPath } from "node:url";
+const migrationsDir = fileURLToPath(new URL("./migrations", import.meta.url));
+const journalPath = fileURLToPath(new URL("./migrations/meta/_journal.json", import.meta.url));
+function migrationNumber(value) {
+    const match = value.match(/^(\d{4})_/);
+    return match ? match[1] : null;
+}
+function ensureNoDuplicates(values, label) {
+    const seen = new Map();
+    for (const value of values) {
+        const number = migrationNumber(value);
+        if (!number) {
+            throw new Error(`${label} entry does not start with a 4-digit migration number: ${value}`);
+        }
+        const existing = seen.get(number);
+        if (existing) {
+            throw new Error(`Duplicate migration number ${number} in ${label}: ${existing}, ${value}`);
+        }
+        seen.set(number, value);
+    }
+}
+function ensureStrictlyOrdered(values, label) {
+    const sorted = [...values].sort();
+    for (let index = 0; index < values.length; index += 1) {
+        if (values[index] !== sorted[index]) {
+            throw new Error(`${label} are out of order at position ${index}: expected ${sorted[index]}, found ${values[index]}`);
+        }
+    }
+}
+function ensureJournalMatchesFiles(migrationFiles, journalTags) {
+    const journalFiles = journalTags.map((tag) => `${tag}.sql`);
+    if (journalFiles.length !== migrationFiles.length) {
+        throw new Error(`Migration journal/file count mismatch: journal has ${journalFiles.length}, files have ${migrationFiles.length}`);
+    }
+    for (let index = 0; index < migrationFiles.length; index += 1) {
+        const migrationFile = migrationFiles[index];
+        const journalFile = journalFiles[index];
+        if (migrationFile !== journalFile) {
+            throw new Error(`Migration journal/file order mismatch at position ${index}: journal has ${journalFile}, files have ${migrationFile}`);
+        }
+    }
+}
+async function main() {
+    const migrationFiles = (await readdir(migrationsDir))
+        .filter((entry) => entry.endsWith(".sql"))
+        .sort();
+    ensureNoDuplicates(migrationFiles, "migration files");
+    ensureStrictlyOrdered(migrationFiles, "migration files");
+    const rawJournal = await readFile(journalPath, "utf8");
+    const journal = JSON.parse(rawJournal);
+    const journalTags = (journal.entries ?? [])
+        .map((entry, index) => {
+        if (typeof entry.tag !== "string" || entry.tag.length === 0) {
+            throw new Error(`Migration journal entry ${index} is missing a tag`);
+        }
+        return entry.tag;
+    });
+    ensureNoDuplicates(journalTags, "migration journal");
+    ensureStrictlyOrdered(journalTags, "migration journal");
+    ensureJournalMatchesFiles(migrationFiles, journalTags);
+}
+await main();
+//# sourceMappingURL=check-migration-numbering.js.map

package/dist/check-migration-numbering.js.map

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

package/dist/client.d.ts

@@ -0,0 +1,43 @@
+import postgres from "postgres";
+import * as schema from "./schema/index.js";
+export type MigrationState = {
+    status: "upToDate";
+    tableCount: number;
+    availableMigrations: string[];
+    appliedMigrations: string[];
+} | {
+    status: "needsMigrations";
+    tableCount: number;
+    availableMigrations: string[];
+    appliedMigrations: string[];
+    pendingMigrations: string[];
+    reason: "no-migration-journal-empty-db" | "no-migration-journal-non-empty-db" | "pending-migrations";
+};
+export declare function createDb(url: string): import("drizzle-orm/postgres-js").PostgresJsDatabase<typeof schema> & {
+    $client: postgres.Sql<{}>;
+};
+export declare function getPostgresDataDirectory(url: string): Promise<string | null>;
+export type MigrationHistoryReconcileResult = {
+    repairedMigrations: string[];
+    remainingMigrations: string[];
+};
+export declare function reconcilePendingMigrationHistory(url: string): Promise<MigrationHistoryReconcileResult>;
+export declare function inspectMigrations(url: string): Promise<MigrationState>;
+export declare function applyPendingMigrations(url: string): Promise<void>;
+export type MigrationBootstrapResult = {
+    migrated: true;
+    reason: "migrated-empty-db";
+    tableCount: 0;
+} | {
+    migrated: false;
+    reason: "already-migrated";
+    tableCount: number;
+} | {
+    migrated: false;
+    reason: "not-empty-no-migration-journal";
+    tableCount: number;
+};
+export declare function migratePostgresIfEmpty(url: string): Promise<MigrationBootstrapResult>;
+export declare function ensurePostgresDatabase(url: string, databaseName: string): Promise<"created" | "exists">;
+export type Db = ReturnType<typeof createDb>;
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAKA,OAAO,QAAQ,MAAM,UAAU,CAAC;AAChC,OAAO,KAAK,MAAM,MAAM,mBAAmB,CAAC;AA8B5C,MAAM,MAAM,cAAc,GACtB;IAAE,MAAM,EAAE,UAAU,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,mBAAmB,EAAE,MAAM,EAAE,CAAC;IAAC,iBAAiB,EAAE,MAAM,EAAE,CAAA;CAAE,GACtG;IACE,MAAM,EAAE,iBAAiB,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,mBAAmB,EAAE,MAAM,EAAE,CAAC;IAC9B,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,MAAM,EAAE,+BAA+B,GAAG,mCAAmC,GAAG,oBAAoB,CAAC;CACtG,CAAC;AAEN,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM;;EAGnC;AAED,wBAAsB,wBAAwB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAalF;AA+ZD,MAAM,MAAM,+BAA+B,GAAG;IAC5C,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,mBAAmB,EAAE,MAAM,EAAE,CAAC;CAC/B,CAAC;AAEF,wBAAsB,gCAAgC,CACpD,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,+BAA+B,CAAC,CA2F1C;AAqBD,wBAAsB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CA0D5E;AAED,wBAAsB,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA0DvE;AAED,MAAM,MAAM,wBAAwB,GAChC;IAAE,QAAQ,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,mBAAmB,CAAC;IAAC,UAAU,EAAE,CAAC,CAAA;CAAE,GAC9D;IAAE,QAAQ,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,kBAAkB,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GACnE;IAAE,QAAQ,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,gCAAgC,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC;AAEtF,wBAAsB,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,wBAAwB,CAAC,CA8B3F;AAED,wBAAsB,sBAAsB,CAC1C,GAAG,EAAE,MAAM,EACX,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,SAAS,GAAG,QAAQ,CAAC,CAiB/B;AAED,MAAM,MAAM,EAAE,GAAG,UAAU,CAAC,OAAO,QAAQ,CAAC,CAAC"}