@waiaas/daemon 2.0.0-rc.1

package/dist/infrastructure/backup/backup-service.d.ts

@@ -0,0 +1,53 @@
+/**
+ * BackupService: pre-upgrade backup and restore for DB + config.toml.
+ *
+ * Creates backups at {dataDir}/backups/pre-upgrade-{version}-{timestamp}/
+ * and enforces a retention policy (default 5 most recent backups).
+ *
+ * Used by the upgrade flow to provide safe rollback capability.
+ */
+export declare class BackupService {
+    private readonly dataDir;
+    private readonly backupsDir;
+    constructor(dataDir: string);
+    /**
+     * Create a pre-upgrade backup of DB + config.toml.
+     *
+     * @param version - The version being upgraded from (e.g. "1.7.0")
+     * @returns The absolute path to the created backup directory
+     * @throws If DB file does not exist at {dataDir}/data/waiaas.db
+     */
+    createBackup(version: string): string;
+    /**
+     * Restore from the most recent backup.
+     *
+     * @returns The absolute path of the backup that was restored
+     * @throws If no backups are found
+     */
+    restoreLatest(): string;
+    /**
+     * Restore DB + config.toml from a specific backup directory.
+     *
+     * @param backupDir - Absolute path to the backup directory
+     * @throws If backupDir does not exist
+     */
+    restore(backupDir: string): void;
+    /**
+     * List all backup directories, sorted newest-first.
+     *
+     * @returns Array of absolute paths to backup directories, newest first
+     */
+    listBackups(): string[];
+    /**
+     * Remove old backups exceeding the keep limit.
+     *
+     * @param keep - Number of most recent backups to retain (default 5)
+     * @returns Number of backups deleted
+     */
+    pruneBackups(keep?: number): number;
+    /**
+     * Format a Date as YYYYMMDDHHmmss string.
+     */
+    private formatTimestamp;
+}
+//# sourceMappingURL=backup-service.d.ts.map

package/dist/infrastructure/backup/backup-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backup-service.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/backup/backup-service.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAYH,qBAAa,aAAa;IAGZ,OAAO,CAAC,QAAQ,CAAC,OAAO;IAFpC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;gBAEP,OAAO,EAAE,MAAM;IAI5C;;;;;;OAMG;IACH,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IAuCrC;;;;;OAKG;IACH,aAAa,IAAI,MAAM;IAWvB;;;;;OAKG;IACH,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAiChC;;;;OAIG;IACH,WAAW,IAAI,MAAM,EAAE;IAmBvB;;;;;OAKG;IACH,YAAY,CAAC,IAAI,SAAI,GAAG,MAAM;IAc9B;;OAEG;IACH,OAAO,CAAC,eAAe;CASxB"}

package/dist/infrastructure/backup/backup-service.js

@@ -0,0 +1,158 @@
+/**
+ * BackupService: pre-upgrade backup and restore for DB + config.toml.
+ *
+ * Creates backups at {dataDir}/backups/pre-upgrade-{version}-{timestamp}/
+ * and enforces a retention policy (default 5 most recent backups).
+ *
+ * Used by the upgrade flow to provide safe rollback capability.
+ */
+import { copyFileSync, existsSync, mkdirSync, readdirSync, rmSync, statSync, } from 'node:fs';
+import { join } from 'node:path';
+export class BackupService {
+    dataDir;
+    backupsDir;
+    constructor(dataDir) {
+        this.dataDir = dataDir;
+        this.backupsDir = join(dataDir, 'backups');
+    }
+    /**
+     * Create a pre-upgrade backup of DB + config.toml.
+     *
+     * @param version - The version being upgraded from (e.g. "1.7.0")
+     * @returns The absolute path to the created backup directory
+     * @throws If DB file does not exist at {dataDir}/data/waiaas.db
+     */
+    createBackup(version) {
+        const timestamp = this.formatTimestamp(new Date());
+        const backupName = `pre-upgrade-${version}-${timestamp}`;
+        const backupDir = join(this.backupsDir, backupName);
+        mkdirSync(backupDir, { recursive: true });
+        // Copy DB file (required)
+        const dbPath = join(this.dataDir, 'data', 'waiaas.db');
+        if (!existsSync(dbPath)) {
+            // Clean up empty backup dir before throwing
+            rmSync(backupDir, { recursive: true, force: true });
+            throw new Error(`Database file not found: ${dbPath}`);
+        }
+        copyFileSync(dbPath, join(backupDir, 'waiaas.db'));
+        // Copy WAL/SHM files if they exist
+        const walPath = join(this.dataDir, 'data', 'waiaas.db-wal');
+        if (existsSync(walPath)) {
+            copyFileSync(walPath, join(backupDir, 'waiaas.db-wal'));
+        }
+        const shmPath = join(this.dataDir, 'data', 'waiaas.db-shm');
+        if (existsSync(shmPath)) {
+            copyFileSync(shmPath, join(backupDir, 'waiaas.db-shm'));
+        }
+        // Copy config.toml if it exists (optional)
+        const configPath = join(this.dataDir, 'config.toml');
+        if (existsSync(configPath)) {
+            copyFileSync(configPath, join(backupDir, 'config.toml'));
+        }
+        // Apply retention policy
+        this.pruneBackups(5);
+        return backupDir;
+    }
+    /**
+     * Restore from the most recent backup.
+     *
+     * @returns The absolute path of the backup that was restored
+     * @throws If no backups are found
+     */
+    restoreLatest() {
+        const backups = this.listBackups();
+        if (backups.length === 0) {
+            throw new Error('No backups found');
+        }
+        const latestDir = backups[0];
+        this.restore(latestDir);
+        return latestDir;
+    }
+    /**
+     * Restore DB + config.toml from a specific backup directory.
+     *
+     * @param backupDir - Absolute path to the backup directory
+     * @throws If backupDir does not exist
+     */
+    restore(backupDir) {
+        if (!existsSync(backupDir)) {
+            throw new Error(`Backup directory not found: ${backupDir}`);
+        }
+        // Restore DB file
+        const backupDb = join(backupDir, 'waiaas.db');
+        if (existsSync(backupDb)) {
+            const targetDb = join(this.dataDir, 'data', 'waiaas.db');
+            // Ensure data directory exists
+            mkdirSync(join(this.dataDir, 'data'), { recursive: true });
+            copyFileSync(backupDb, targetDb);
+        }
+        // Restore WAL file if present in backup
+        const backupWal = join(backupDir, 'waiaas.db-wal');
+        if (existsSync(backupWal)) {
+            copyFileSync(backupWal, join(this.dataDir, 'data', 'waiaas.db-wal'));
+        }
+        // Restore SHM file if present in backup
+        const backupShm = join(backupDir, 'waiaas.db-shm');
+        if (existsSync(backupShm)) {
+            copyFileSync(backupShm, join(this.dataDir, 'data', 'waiaas.db-shm'));
+        }
+        // Restore config.toml if present in backup
+        const backupConfig = join(backupDir, 'config.toml');
+        if (existsSync(backupConfig)) {
+            copyFileSync(backupConfig, join(this.dataDir, 'config.toml'));
+        }
+    }
+    /**
+     * List all backup directories, sorted newest-first.
+     *
+     * @returns Array of absolute paths to backup directories, newest first
+     */
+    listBackups() {
+        if (!existsSync(this.backupsDir)) {
+            return [];
+        }
+        const entries = readdirSync(this.backupsDir);
+        return entries
+            .filter((name) => name.startsWith('pre-upgrade-'))
+            .filter((name) => {
+            try {
+                return statSync(join(this.backupsDir, name)).isDirectory();
+            }
+            catch {
+                return false;
+            }
+        })
+            .sort((a, b) => b.localeCompare(a)) // Descending (newest first)
+            .map((name) => join(this.backupsDir, name));
+    }
+    /**
+     * Remove old backups exceeding the keep limit.
+     *
+     * @param keep - Number of most recent backups to retain (default 5)
+     * @returns Number of backups deleted
+     */
+    pruneBackups(keep = 5) {
+        const backups = this.listBackups();
+        if (backups.length <= keep) {
+            return 0;
+        }
+        const toDelete = backups.slice(keep);
+        for (const dir of toDelete) {
+            rmSync(dir, { recursive: true, force: true });
+        }
+        return toDelete.length;
+    }
+    /**
+     * Format a Date as YYYYMMDDHHmmss string.
+     */
+    formatTimestamp(date) {
+        const y = date.getFullYear().toString();
+        const M = (date.getMonth() + 1).toString().padStart(2, '0');
+        const d = date.getDate().toString().padStart(2, '0');
+        const h = date.getHours().toString().padStart(2, '0');
+        const m = date.getMinutes().toString().padStart(2, '0');
+        const s = date.getSeconds().toString().padStart(2, '0');
+        return `${y}${M}${d}${h}${m}${s}`;
+    }
+}
+//# sourceMappingURL=backup-service.js.map

package/dist/infrastructure/backup/backup-service.js.map

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

package/dist/infrastructure/backup/index.d.ts

@@ -0,0 +1,2 @@
+export { BackupService } from './backup-service.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/infrastructure/backup/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/backup/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/infrastructure/backup/index.js

@@ -0,0 +1,2 @@
+export { BackupService } from './backup-service.js';
+//# sourceMappingURL=index.js.map

package/dist/infrastructure/backup/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/infrastructure/backup/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/infrastructure/config/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Config module barrel export.
+ *
+ * Re-exports config loader, schema, and type.
+ */
+export { loadConfig, DaemonConfigSchema, detectNestedSections, applyEnvOverrides, parseEnvValue } from './loader.js';
+export type { DaemonConfig } from './loader.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/infrastructure/config/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/config/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,UAAU,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACrH,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC"}

package/dist/infrastructure/config/index.js

@@ -0,0 +1,7 @@
+/**
+ * Config module barrel export.
+ *
+ * Re-exports config loader, schema, and type.
+ */
+export { loadConfig, DaemonConfigSchema, detectNestedSections, applyEnvOverrides, parseEnvValue } from './loader.js';
+//# sourceMappingURL=index.js.map

package/dist/infrastructure/config/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/infrastructure/config/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,UAAU,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC"}