@fidelios/db 0.0.1

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 resolveFideliOSHomeDir() {
+    const envHome = process.env.FIDELIOS_HOME?.trim();
+    if (envHome)
+        return path.resolve(expandHomePrefix(envHome));
+    return path.resolve(os.homedir(), ".fidelios");
+}
+function resolveFideliOSInstanceId() {
+    const raw = process.env.FIDELIOS_INSTANCE_ID?.trim() || "default";
+    if (!/^[a-zA-Z0-9_-]+$/.test(raw)) {
+        throw new Error(`Invalid FIDELIOS_INSTANCE_ID '${raw}'.`);
+    }
+    return raw;
+}
+function resolveDefaultConfigPath() {
+    return path.resolve(resolveFideliOSHomeDir(), "instances", resolveFideliOSInstanceId(), "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://paperclip:paperclip@127.0.0.1:${port}/paperclip`;
+}
+function resolveDefaultBackupDir() {
+    return path.resolve(resolveFideliOSHomeDir(), "instances", resolveFideliOSInstanceId(), "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: "fidelios",
+        });
+        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/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"}