skill-home 0.2.0 → 0.3.0

package/dist/fetch/backup.js

@@ -0,0 +1,292 @@
+// 备份导出／导入恢复：HELP SM8-3「备份与导出(数据资产)」＋ SM8-4「导入与恢复(迁移)」的落点。
+//
+// 与老家的关系（`docs/plugins/plugin-home-ilife/t707-备份取舍.md` 有完整对账）：形状照 `ops.py` 那套
+// （`backups/` 同库目录、`home_backup_<时间戳>.zip`、保留 N 份、覆盖前二次备份），但有三处**有意不同**：
+//   1. **不做照片**：本包 src 零读 `HOME_PHOTOS_DIR`（`docs/env.md:12` 已登记的实况），故 zip 只装库 ＋ 清单；
+//   2. **快照用 `VACUUM INTO`**：老家直接 `zf.write(DB_PATH)`，而本包库开 WAL（`db.ts:66`），
+//      照抄会把未落主库的 WAL 内容漏掉——`VACUUM INTO` 出的是包含 WAL 的一致快照；
+//   3. **不做 JSON 导入**：SM8-4 的「冲突预览 → 跳过／合并／覆盖」是老家的物品级合并，本票只做
+//      **整库恢复**（`import` 收 `.zip` 备份），物品级合并留作后续票（见该文档「遗留」）。
+// 三条都在票面「留给执行者判断取舍」的范围内，理由与代价写在上面的文档里。
+import { existsSync, mkdirSync, readFileSync, readdirSync, statSync, unlinkSync, writeFileSync } from 'node:fs';
+import { basename, dirname, isAbsolute, join, resolve } from 'node:path';
+import { closeHomeDb, openHomeDb } from './db.js';
+import { HomeFetchError, HomePolicyError } from './errors.js';
+import { dbFilename, resolveDbDir, resolveDbPath } from './paths.js';
+import { loadHomeConfig } from '../config.js';
+import { zipRead, zipWrite } from './archive.js';
+/** 备份目录名的默认值：＝改造前的代码常量 `BACKUP_DIR_NAME`（配置项 `backup.dir` 空串即用它）。 */
+export const DEFAULT_BACKUP_DIR_NAME = 'backups'; // 老家 ops.py:26 同值
+const BACKUP_KEEP_N = 5; // 老家 ops.py:25 同值
+const BACKUP_PREFIX = 'home_backup_';
+const EXPORT_SCHEMA_VERSION = 1;
+function p2(n, w = 2) { return String(n).padStart(w, '0'); }
+function stamp(d = new Date()) {
+    return p2(d.getFullYear(), 4) + p2(d.getMonth() + 1) + p2(d.getDate()) + '_' +
+        p2(d.getHours()) + p2(d.getMinutes()) + p2(d.getSeconds()) + '_' + p2(d.getMilliseconds(), 3);
+}
+function nowStr(d = new Date()) {
+    return p2(d.getFullYear(), 4) + '-' + p2(d.getMonth() + 1) + '-' + p2(d.getDate()) + ' ' +
+        p2(d.getHours()) + ':' + p2(d.getMinutes()) + ':' + p2(d.getSeconds());
+}
+/** 从备份文件名解析时间（毫秒与老家六位微秒两种后缀都认）。 */
+function parseStamp(name) {
+    const m = /^home_backup_(\d{4})(\d{2})(\d{2})_(\d{2})(\d{2})(\d{2})(?:_(\d{1,6}))?\.zip$/.exec(name);
+    if (!m)
+        return null;
+    const ms = m[7] ? Number(m[7].slice(0, 3).padEnd(3, '0')) : 0;
+    return new Date(Number(m[1]), Number(m[2]) - 1, Number(m[3]), Number(m[4]), Number(m[5]), Number(m[6]), ms);
+}
+function daysBetween(from, to = new Date()) {
+    return Math.floor((to.getTime() - from.getTime()) / 86400000);
+}
+/** 备份目录名：配置 `backup.dir`，空串＝默认（`backups`）。 */
+export function backupDirName() {
+    const dir = loadHomeConfig().values.backup.dir;
+    return dir === '' ? DEFAULT_BACKUP_DIR_NAME : dir;
+}
+/** 备份目录（库目录下 `backups/`）——设置页「备份目录」那一项的取值口；只算路径，不建目录。 */
+export function resolveBackupDir() {
+    return join(resolveDbDir(), backupDirName());
+}
+function backupFiles(dir) {
+    if (!existsSync(dir))
+        return [];
+    return readdirSync(dir).filter((f) => f.startsWith(BACKUP_PREFIX) && f.endsWith('.zip')).sort();
+}
+function readHistory(dir) {
+    return backupFiles(dir).map((f) => {
+        const st = statSync(join(dir, f));
+        return { file: f, size: st.size, created_at: nowStr(st.mtime), days_ago: daysBetween(st.mtime) };
+    });
+}
+function daysSinceLast(dir) {
+    const files = backupFiles(dir);
+    if (!files.length)
+        return null;
+    const t = parseStamp(files[files.length - 1]);
+    return t ? daysBetween(t) : null;
+}
+function pruneBackups(dir, keepN) {
+    const files = backupFiles(dir);
+    for (const old of files.slice(0, Math.max(0, files.length - keepN))) {
+        try {
+            unlinkSync(join(dir, old));
+        }
+        catch { /* 删不掉不挡本次备份，历史里仍在 */ }
+    }
+}
+function esc1(s) { return s.replace(/'/g, "''"); }
+/** 备份：库快照（含 WAL）＋ 清单打包成 zip，保留 N 份、删最旧；返回回执载荷。 */
+export function createBackup(opts = {}) {
+    const keepN = opts.keepN ?? BACKUP_KEEP_N;
+    if (!Number.isInteger(keepN) || keepN <= 0)
+        throw new HomePolicyError('POLICY_BAD_INPUT', 'keep_n 须为正整数');
+    const dbPath = resolveDbPath();
+    if (!existsSync(dbPath))
+        throw new HomeFetchError('HOME_DB_MISSING', '库不存在，无可备份：' + dbPath);
+    const dir = resolveBackupDir();
+    mkdirSync(dir, { recursive: true });
+    const base = stamp();
+    let target = join(dir, BACKUP_PREFIX + base + '.zip');
+    for (let i = 1; existsSync(target); i++)
+        target = join(dir, BACKUP_PREFIX + base + '_' + i + '.zip');
+    let dbBytes;
+    let items = 0;
+    const snap = join(dir, '.snapshot-' + base + '.db');
+    try {
+        const handle = openHomeDb(dbPath);
+        try {
+            handle.db.exec("VACUUM INTO '" + esc1(snap) + "'");
+            items = Number(handle.db.prepare('SELECT count(*) AS c FROM items').get().c);
+        }
+        finally {
+            closeHomeDb(handle);
+        }
+        dbBytes = readFileSync(snap);
+    }
+    catch (e) {
+        throw new HomeFetchError('HOME_DB_UNREADABLE', '备份快照失败：' + e.message, { cause: e });
+    }
+    finally {
+        try {
+            if (existsSync(snap))
+                unlinkSync(snap);
+        }
+        catch { /* 临时件删不掉不挡备份 */ }
+    }
+    const created = nowStr();
+    const dbName = dbFilename();
+    const manifest = { schema_version: EXPORT_SCHEMA_VERSION, created_at: created, db_filename: dbName, items };
+    const entries = [
+        { name: dbName, data: dbBytes },
+        { name: 'manifest.json', data: Buffer.from(JSON.stringify(manifest, null, 1) + '\n', 'utf8') },
+    ];
+    try {
+        writeFileSync(target, zipWrite(entries));
+    }
+    catch (e) {
+        throw new HomeFetchError('HOME_DB_UNREADABLE', '备份写盘失败：' + target + '（' + e.message + '）', { cause: e });
+    }
+    pruneBackups(dir, keepN);
+    return {
+        status: 'ok', keep_n: keepN, file: target, size: statSync(target).size, created_at: created,
+        items, history: readHistory(dir), days_since_last: daysSinceLast(dir),
+    };
+}
+/** 备份历史：现读盘，不缓存（面板／回执要的是当前真状态）。 */
+export function listBackups(opts = {}) {
+    const keepN = opts.keepN ?? BACKUP_KEEP_N;
+    const dir = resolveBackupDir();
+    const history = readHistory(dir);
+    return { status: 'ok', dir, keep_n: keepN, count: history.length, history, days_since_last: daysSinceLast(dir) };
+}
+function resolveBackupFile(file, dir) {
+    const abs = isAbsolute(file) ? file : join(dir, file);
+    const base = basename(abs);
+    if (!base.startsWith(BACKUP_PREFIX) || !base.endsWith('.zip')) {
+        throw new HomePolicyError('POLICY_BAD_INPUT', '备份文件名不合规（须 ' + BACKUP_PREFIX + '*.zip）：' + base);
+    }
+    if (!existsSync(abs))
+        throw new HomePolicyError('POLICY_BAD_INPUT', '备份文件不存在：' + abs);
+    return abs;
+}
+function countItems(dbPath) {
+    if (!existsSync(dbPath))
+        return 0;
+    const handle = openHomeDb(dbPath);
+    try {
+        return Number(handle.db.prepare('SELECT count(*) AS c FROM items').get().c);
+    }
+    finally {
+        closeHomeDb(handle);
+    }
+}
+/**
+ * 导入恢复：拿备份里的 `home.db` 覆盖当前库；覆盖前先自备份一次（数据安全优先于便捷）。
+ * `dryRun`＝预告支（SM8-4「文件选择(预告式)→ 校验 → 冲突预览 → 确认导入」的中间那一步）：只校验＋报数，不落盘。
+ */
+export function restoreBackup(file, opts = {}) {
+    if (!file)
+        throw new HomePolicyError('POLICY_BAD_INPUT', '导入恢复须给 file（备份文件名或绝对路径）');
+    const src = resolveBackupFile(file, resolveBackupDir());
+    let entries;
+    let dbBytes;
+    try {
+        entries = zipRead(readFileSync(src));
+        const dbName = dbFilename();
+        const hit = entries.find((e) => e.name === dbName);
+        if (!hit)
+            throw new Error('备份内未找到 ' + dbName);
+        dbBytes = hit.data;
+    }
+    catch (e) {
+        throw new HomePolicyError('POLICY_BAD_INPUT', '备份文件无效：' + src + '（' + e.message + '）');
+    }
+    const dbPath = resolveDbPath();
+    if (opts.dryRun) {
+        const mf = entries.find((e) => e.name === 'manifest.json');
+        let inBackup = null;
+        if (mf) {
+            try {
+                const j = JSON.parse(mf.data.toString('utf8'));
+                if (typeof j.items === 'number')
+                    inBackup = j.items;
+            }
+            catch { /* 清单坏就报 null，不谎报件数 */ }
+        }
+        const cur = countItems(dbPath);
+        return {
+            status: 'ok', dry_run: true, restored_from: src, items_in_backup: inBackup, items_current: cur,
+            message: '预告通过：这份备份' + (inBackup === null ? '（件数未知）' : '含 ' + inBackup + ' 件') +
+                '，当前库 ' + cur + ' 件；恢复会**整库覆盖**（恢复前自动自备份）。确认请给 confirm:true',
+        };
+    }
+    const safety = createBackup(opts);
+    // 覆盖前清掉 WAL／SHM：留着旧 WAL 会把刚恢复的库再改写坏。
+    for (const side of ['-wal', '-shm']) {
+        try {
+            if (existsSync(dbPath + side))
+                unlinkSync(dbPath + side);
+        }
+        catch { /* 清不掉则下面写入会大声失败 */ }
+    }
+    try {
+        writeFileSync(dbPath, dbBytes);
+    }
+    catch (e) {
+        throw new HomeFetchError('HOME_DB_UNREADABLE', '写回数据库失败：' + dbPath + '（' + e.message + '）', { cause: e });
+    }
+    let itemsTotal = 0;
+    try {
+        itemsTotal = countItems(dbPath);
+    }
+    catch (e) {
+        throw new HomeFetchError('HOME_DB_UNREADABLE', '恢复后库不可读：' + dbPath + '（' + e.message + '）', { cause: e });
+    }
+    return {
+        status: 'ok', restored_from: src, safety_backup: safety.file,
+        before_items: safety.items, items_total: itemsTotal,
+        message: '已从备份恢复：' + basename(src) + '（恢复前已自备份）',
+    };
+}
+function csvCell(v) {
+    if (v === null || v === undefined)
+        return '';
+    const s = String(v);
+    return /[",\n\r]/.test(s) ? '"' + s.replace(/"/g, '""') + '"' : s;
+}
+const CSV_COLS = [
+    'id', 'name', 'category', 'owner', 'purchase_price', 'remark',
+    'location', 'quantity', 'location_status', 'purchase_date', 'expiration_date',
+];
+/** 导出：JSON＝全表可迁移；CSV＝物品 ⋈ 位置便携（列与老家 ops.py:620 逐列相同）。 */
+export function exportData(opts = {}) {
+    const format = String(opts.format ?? 'json').toLowerCase();
+    if (format !== 'json' && format !== 'csv') {
+        throw new HomePolicyError('POLICY_BAD_INPUT', '不支持的格式：' + opts.format + '（只认 json／csv）');
+    }
+    const dbPath = resolveDbPath();
+    if (!existsSync(dbPath))
+        throw new HomeFetchError('HOME_DB_MISSING', '库不存在，无可导出：' + dbPath);
+    let text = '';
+    let rows = 0;
+    const handle = openHomeDb(dbPath);
+    try {
+        if (format === 'json') {
+            const items = handle.db.prepare('SELECT * FROM items').all();
+            const data = {
+                schema_version: EXPORT_SCHEMA_VERSION,
+                exported_at: nowStr(),
+                items,
+                item_locations: handle.db.prepare('SELECT * FROM item_locations').all(),
+                item_tags: handle.db.prepare('SELECT * FROM item_tags').all(),
+                categories: handle.db.prepare('SELECT * FROM categories').all(),
+            };
+            rows = items.length;
+            text = JSON.stringify(data, null, 1) + '\n';
+        }
+        else {
+            const rs = handle.db.prepare('SELECT i.id, i.name, i.category, i.owner, i.purchase_price, i.remark, ' +
+                'l.location, l.quantity, l.location_status, l.purchase_date, l.expiration_date ' +
+                'FROM items i LEFT JOIN item_locations l ON l.item_id = i.id ORDER BY i.id').all();
+            rows = rs.length;
+            text = [CSV_COLS.join(','), ...rs.map((r) => CSV_COLS.map((c) => csvCell(r[c])).join(','))].join('\n') + '\n';
+        }
+    }
+    finally {
+        closeHomeDb(handle);
+    }
+    const out = opts.output
+        ? resolve(opts.output)
+        : join(resolveBackupDir(), 'home_export_' + stamp().replace(/_\d{3}$/, '') + (format === 'json' ? '.json' : '.csv'));
+    try {
+        mkdirSync(dirname(out), { recursive: true });
+        writeFileSync(out, text, 'utf8');
+    }
+    catch (e) {
+        throw new HomeFetchError('HOME_DB_UNREADABLE', '导出写盘失败：' + out + '（' + e.message + '）', { cause: e });
+    }
+    return { status: 'ok', file: out, format, size: Buffer.byteLength(text, 'utf8'), rows };
+}
+//# sourceMappingURL=backup.js.map

package/dist/fetch/backup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"backup.js","sourceRoot":"","sources":["../../src/fetch/backup.ts"],"names":[],"mappings":"AAAA,0DAA0D;AAC1D,EAAE;AACF,8EAA8E;AAC9E,yEAAyE;AACzE,qFAAqF;AACrF,6EAA6E;AAC7E,0DAA0D;AAC1D,6DAA6D;AAC7D,4DAA4D;AAC5D,uCAAuC;AACvC,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,WAAW,EAAE,QAAQ,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAChH,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzE,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9D,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AACrE,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAiB,MAAM,cAAc,CAAC;AAEhE,qEAAqE;AACrE,MAAM,CAAC,MAAM,uBAAuB,GAAG,SAAS,CAAC,CAAG,kBAAkB;AACtE,MAAM,aAAa,GAAG,CAAC,CAAC,CAAa,kBAAkB;AACvD,MAAM,aAAa,GAAG,cAAc,CAAC;AACrC,MAAM,qBAAqB,GAAG,CAAC,CAAC;AA0DhC,SAAS,EAAE,CAAC,CAAS,EAAE,CAAC,GAAG,CAAC,IAAY,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC;AAE5E,SAAS,KAAK,CAAC,CAAC,GAAG,IAAI,IAAI,EAAE;IAC3B,OAAO,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,GAAG,GAAG;QAC1E,EAAE,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC,GAAG,GAAG,GAAG,EAAE,CAAC,CAAC,CAAC,eAAe,EAAE,EAAE,CAAC,CAAC,CAAC;AAClG,CAAC;AAED,SAAS,MAAM,CAAC,CAAC,GAAG,IAAI,IAAI,EAAE;IAC5B,OAAO,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC,GAAG,GAAG,GAAG,EAAE,CAAC,CAAC,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,GAAG,GAAG,GAAG,EAAE,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,GAAG,GAAG;QACtF,EAAE,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,GAAG,GAAG,GAAG,EAAE,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC,GAAG,GAAG,GAAG,EAAE,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC;AAC3E,CAAC;AAED,mCAAmC;AACnC,SAAS,UAAU,CAAC,IAAY;IAC9B,MAAM,CAAC,GAAG,+EAA+E,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACrG,IAAI,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IACpB,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9D,OAAO,IAAI,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AAC9G,CAAC;AAED,SAAS,WAAW,CAAC,IAAU,EAAE,EAAE,GAAG,IAAI,IAAI,EAAE;IAC9C,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC,GAAG,QAAQ,CAAC,CAAC;AAChE,CAAC;AAED,8CAA8C;AAC9C,MAAM,UAAU,aAAa;IAC3B,MAAM,GAAG,GAAG,cAAc,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC;IAC/C,OAAO,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC,uBAAuB,CAAC,CAAC,CAAC,GAAG,CAAC;AACpD,CAAC;AAED,yDAAyD;AACzD,MAAM,UAAU,gBAAgB;IAC9B,OAAO,IAAI,CAAC,YAAY,EAAE,EAAE,aAAa,EAAE,CAAC,CAAC;AAC/C,CAAC;AAED,SAAS,WAAW,CAAC,GAAW;IAC9B,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,EAAE,CAAC;IAChC,OAAO,WAAW,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;AAClG,CAAC;AAED,SAAS,WAAW,CAAC,GAAW;IAC9B,OAAO,WAAW,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QAChC,MAAM,EAAE,GAAG,QAAQ,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC;QAClC,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,UAAU,EAAE,MAAM,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,QAAQ,EAAE,WAAW,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC;IACnG,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,aAAa,CAAC,GAAW;IAChC,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;IAC/B,IAAI,CAAC,KAAK,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IAC/B,MAAM,CAAC,GAAG,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC;IAC9C,OAAO,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AACnC,CAAC;AAED,SAAS,YAAY,CAAC,GAAW,EAAE,KAAa;IAC9C,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;IAC/B,KAAK,MAAM,GAAG,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,KAAK,CAAC,CAAC,EAAE,CAAC;QACpE,IAAI,CAAC;YAAC,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC,CAAC,qBAAqB,CAAC,CAAC;IACrE,CAAC;AACH,CAAC;AAED,SAAS,IAAI,CAAC,CAAS,IAAY,OAAO,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;AAElE,kDAAkD;AAClD,MAAM,UAAU,YAAY,CAAC,OAA2B,EAAE;IACxD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,aAAa,CAAC;IAC1C,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC;QAAE,MAAM,IAAI,eAAe,CAAC,kBAAkB,EAAE,cAAc,CAAC,CAAC;IAC1G,MAAM,MAAM,GAAG,aAAa,EAAE,CAAC;IAC/B,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC;QAAE,MAAM,IAAI,cAAc,CAAC,iBAAiB,EAAE,YAAY,GAAG,MAAM,CAAC,CAAC;IAC5F,MAAM,GAAG,GAAG,gBAAgB,EAAE,CAAC;IAC/B,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACpC,MAAM,IAAI,GAAG,KAAK,EAAE,CAAC;IACrB,IAAI,MAAM,GAAG,IAAI,CAAC,GAAG,EAAE,aAAa,GAAG,IAAI,GAAG,MAAM,CAAC,CAAC;IACtD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE;QAAE,MAAM,GAAG,IAAI,CAAC,GAAG,EAAE,aAAa,GAAG,IAAI,GAAG,GAAG,GAAG,CAAC,GAAG,MAAM,CAAC,CAAC;IAErG,IAAI,OAAe,CAAC;IACpB,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE,YAAY,GAAG,IAAI,GAAG,KAAK,CAAC,CAAC;IACpD,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC;QAClC,IAAI,CAAC;YACH,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,CAAC;YACnD,KAAK,GAAG,MAAM,CAAE,MAAM,CAAC,EAAE,CAAC,OAAO,CAAC,iCAAiC,CAAC,CAAC,GAAG,EAAoB,CAAC,CAAC,CAAC,CAAC;QAClG,CAAC;gBAAS,CAAC;YAAC,WAAW,CAAC,MAAM,CAAC,CAAC;QAAC,CAAC;QAClC,OAAO,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;IAC/B,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,MAAM,IAAI,cAAc,CAAC,oBAAoB,EAAE,SAAS,GAAI,CAAW,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC;IACjG,CAAC;YAAS,CAAC;QACT,IAAI,CAAC;YAAC,IAAI,UAAU,CAAC,IAAI,CAAC;gBAAE,UAAU,CAAC,IAAI,CAAC,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC,CAAC,gBAAgB,CAAC,CAAC;IAC5E,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC;IACzB,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;IAC5B,MAAM,QAAQ,GAAG,EAAE,cAAc,EAAE,qBAAqB,EAAE,UAAU,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;IAC5G,MAAM,OAAO,GAAe;QAC1B,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE;QAC/B,EAAE,IAAI,EAAE,eAAe,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,MAAM,CAAC,EAAE;KAC/F,CAAC;IACF,IAAI,CAAC;QAAC,aAAa,CAAC,MAAM,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;IAAC,CAAC;IACjD,OAAO,CAAC,EAAE,CAAC;QAAC,MAAM,IAAI,cAAc,CAAC,oBAAoB,EAAE,SAAS,GAAG,MAAM,GAAG,GAAG,GAAI,CAAW,CAAC,OAAO,GAAG,GAAG,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC;IAAC,CAAC;IAElI,YAAY,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IACzB,OAAO;QACL,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO;QAC3F,KAAK,EAAE,OAAO,EAAE,WAAW,CAAC,GAAG,CAAC,EAAE,eAAe,EAAE,aAAa,CAAC,GAAG,CAAC;KACtE,CAAC;AACJ,CAAC;AAED,mCAAmC;AACnC,MAAM,UAAU,WAAW,CAAC,OAA2B,EAAE;IACvD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,aAAa,CAAC;IAC1C,MAAM,GAAG,GAAG,gBAAgB,EAAE,CAAC;IAC/B,MAAM,OAAO,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;IACjC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC,MAAM,EAAE,OAAO,EAAE,eAAe,EAAE,aAAa,CAAC,GAAG,CAAC,EAAE,CAAC;AACnH,CAAC;AAED,SAAS,iBAAiB,CAAC,IAAY,EAAE,GAAW;IAClD,MAAM,GAAG,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IACtD,MAAM,IAAI,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC;IAC3B,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QAC9D,MAAM,IAAI,eAAe,CAAC,kBAAkB,EAAE,aAAa,GAAG,aAAa,GAAG,SAAS,GAAG,IAAI,CAAC,CAAC;IAClG,CAAC;IACD,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,MAAM,IAAI,eAAe,CAAC,kBAAkB,EAAE,UAAU,GAAG,GAAG,CAAC,CAAC;IACtF,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,UAAU,CAAC,MAAc;IAChC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC;QAAE,OAAO,CAAC,CAAC;IAClC,MAAM,MAAM,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC;IAClC,IAAI,CAAC;QAAC,OAAO,MAAM,CAAE,MAAM,CAAC,EAAE,CAAC,OAAO,CAAC,iCAAiC,CAAC,CAAC,GAAG,EAAoB,CAAC,CAAC,CAAC,CAAC;IAAC,CAAC;YAC/F,CAAC;QAAC,WAAW,CAAC,MAAM,CAAC,CAAC;IAAC,CAAC;AAClC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,IAAY,EAAE,OAA6C,EAAE;IACzF,IAAI,CAAC,IAAI;QAAE,MAAM,IAAI,eAAe,CAAC,kBAAkB,EAAE,yBAAyB,CAAC,CAAC;IACpF,MAAM,GAAG,GAAG,iBAAiB,CAAC,IAAI,EAAE,gBAAgB,EAAE,CAAC,CAAC;IACxD,IAAI,OAAmB,CAAC;IACxB,IAAI,OAAe,CAAC;IACpB,IAAI,CAAC;QACH,OAAO,GAAG,OAAO,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC;QACrC,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;QAC5B,MAAM,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC;QACnD,IAAI,CAAC,GAAG;YAAE,MAAM,IAAI,KAAK,CAAC,SAAS,GAAG,MAAM,CAAC,CAAC;QAC9C,OAAO,GAAG,GAAG,CAAC,IAAI,CAAC;IACrB,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,MAAM,IAAI,eAAe,CAAC,kBAAkB,EAAE,SAAS,GAAG,GAAG,GAAG,GAAG,GAAI,CAAW,CAAC,OAAO,GAAG,GAAG,CAAC,CAAC;IACpG,CAAC;IAED,MAAM,MAAM,GAAG,aAAa,EAAE,CAAC;IAC/B,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;QAChB,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,eAAe,CAAC,CAAC;QAC3D,IAAI,QAAQ,GAAkB,IAAI,CAAC;QACnC,IAAI,EAAE,EAAE,CAAC;YACP,IAAI,CAAC;gBACH,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAuB,CAAC;gBACrE,IAAI,OAAO,CAAC,CAAC,KAAK,KAAK,QAAQ;oBAAE,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC;YACtD,CAAC;YAAC,MAAM,CAAC,CAAC,sBAAsB,CAAC,CAAC;QACpC,CAAC;QACD,MAAM,GAAG,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC;QAC/B,OAAO;YACL,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,aAAa,EAAE,GAAG,EAAE,eAAe,EAAE,QAAQ,EAAE,aAAa,EAAE,GAAG;YAC9F,OAAO,EAAE,WAAW,GAAG,CAAC,QAAQ,KAAK,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,GAAG,QAAQ,GAAG,IAAI,CAAC;gBAC5E,OAAO,GAAG,GAAG,GAAG,4CAA4C;SAC/D,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;IAClC,qCAAqC;IACrC,KAAK,MAAM,IAAI,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC;QACpC,IAAI,CAAC;YAAC,IAAI,UAAU,CAAC,MAAM,GAAG,IAAI,CAAC;gBAAE,UAAU,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC,CAAC,mBAAmB,CAAC,CAAC;IACjG,CAAC;IACD,IAAI,CAAC;QAAC,aAAa,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAAC,CAAC;IACvC,OAAO,CAAC,EAAE,CAAC;QAAC,MAAM,IAAI,cAAc,CAAC,oBAAoB,EAAE,UAAU,GAAG,MAAM,GAAG,GAAG,GAAI,CAAW,CAAC,OAAO,GAAG,GAAG,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC;IAAC,CAAC;IAEnI,IAAI,UAAU,GAAG,CAAC,CAAC;IACnB,IAAI,CAAC;QAAC,UAAU,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC;IAAC,CAAC;IACxC,OAAO,CAAC,EAAE,CAAC;QACT,MAAM,IAAI,cAAc,CAAC,oBAAoB,EAAE,UAAU,GAAG,MAAM,GAAG,GAAG,GAAI,CAAW,CAAC,OAAO,GAAG,GAAG,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC;IACvH,CAAC;IACD,OAAO;QACL,MAAM,EAAE,IAAI,EAAE,aAAa,EAAE,GAAG,EAAE,aAAa,EAAE,MAAM,CAAC,IAAI;QAC5D,YAAY,EAAE,MAAM,CAAC,KAAK,EAAE,WAAW,EAAE,UAAU;QACnD,OAAO,EAAE,SAAS,GAAG,QAAQ,CAAC,GAAG,CAAC,GAAG,WAAW;KACjD,CAAC;AACJ,CAAC;AAED,SAAS,OAAO,CAAC,CAAU;IACzB,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,SAAS;QAAE,OAAO,EAAE,CAAC;IAC7C,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;IACpB,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;AACpE,CAAC;AAED,MAAM,QAAQ,GAAG;IACf,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,gBAAgB,EAAE,QAAQ;IAC7D,UAAU,EAAE,UAAU,EAAE,iBAAiB,EAAE,eAAe,EAAE,iBAAiB;CAC9E,CAAC;AAEF,yDAAyD;AACzD,MAAM,UAAU,UAAU,CAAC,OAA6C,EAAE;IACxE,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC;IAC3D,IAAI,MAAM,KAAK,MAAM,IAAI,MAAM,KAAK,KAAK,EAAE,CAAC;QAC1C,MAAM,IAAI,eAAe,CAAC,kBAAkB,EAAE,SAAS,GAAG,IAAI,CAAC,MAAM,GAAG,eAAe,CAAC,CAAC;IAC3F,CAAC;IACD,MAAM,MAAM,GAAG,aAAa,EAAE,CAAC;IAC/B,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC;QAAE,MAAM,IAAI,cAAc,CAAC,iBAAiB,EAAE,YAAY,GAAG,MAAM,CAAC,CAAC;IAE5F,IAAI,IAAI,GAAG,EAAE,CAAC;IACd,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,MAAM,MAAM,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC;IAClC,IAAI,CAAC;QACH,IAAI,MAAM,KAAK,MAAM,EAAE,CAAC;YACtB,MAAM,KAAK,GAAG,MAAM,CAAC,EAAE,CAAC,OAAO,CAAC,qBAAqB,CAAC,CAAC,GAAG,EAAe,CAAC;YAC1E,MAAM,IAAI,GAAG;gBACX,cAAc,EAAE,qBAAqB;gBACrC,WAAW,EAAE,MAAM,EAAE;gBACrB,KAAK;gBACL,cAAc,EAAE,MAAM,CAAC,EAAE,CAAC,OAAO,CAAC,8BAA8B,CAAC,CAAC,GAAG,EAAE;gBACvE,SAAS,EAAE,MAAM,CAAC,EAAE,CAAC,OAAO,CAAC,yBAAyB,CAAC,CAAC,GAAG,EAAE;gBAC7D,UAAU,EAAE,MAAM,CAAC,EAAE,CAAC,OAAO,CAAC,0BAA0B,CAAC,CAAC,GAAG,EAAE;aAChE,CAAC;YACF,IAAI,GAAG,KAAK,CAAC,MAAM,CAAC;YACpB,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC;QAC9C,CAAC;aAAM,CAAC;YACN,MAAM,EAAE,GAAG,MAAM,CAAC,EAAE,CAAC,OAAO,CAC1B,wEAAwE;gBACxE,gFAAgF;gBAChF,2EAA2E,CAC5E,CAAC,GAAG,EAA+B,CAAC;YACrC,IAAI,GAAG,EAAE,CAAC,MAAM,CAAC;YACjB,IAAI,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;QAChH,CAAC;IACH,CAAC;YAAS,CAAC;QAAC,WAAW,CAAC,MAAM,CAAC,CAAC;IAAC,CAAC;IAElC,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM;QACrB,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC;QACtB,CAAC,CAAC,IAAI,CAAC,gBAAgB,EAAE,EAAE,cAAc,GAAG,KAAK,EAAE,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;IACvH,IAAI,CAAC;QACH,SAAS,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC7C,aAAa,CAAC,GAAG,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;IACnC,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,MAAM,IAAI,cAAc,CAAC,oBAAoB,EAAE,SAAS,GAAG,GAAG,GAAG,GAAG,GAAI,CAAW,CAAC,OAAO,GAAG,GAAG,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC;IACnH,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC;AAC1F,CAAC"}

package/dist/fetch/index.d.ts

@@ -1,6 +1,7 @@
 export { HomeFetchError, HomePolicyError } from './errors.js';
 export { SCHEMA_VERSION, openHomeDb, closeHomeDb, addItem, getItemById, listLocationsByItem, listTagsByItem, searchItems, updateItem, adjustQuantity, setLocationStatus, moveLocation, setItemTags, listAllTags, mergeTags, listCategories, getCategoryById, encryptPassword, decryptPassword, assertMasterKey, } from './db.js';
 export type { HomeItem, HomeLocation, HomeDb, SearchFilter } from './db.js';
-export { resolveDbDir, resolveDbPath, assertWritablePath, DB_FILENAME } from './paths.js';
+export { resolveDbDir, resolveDbPath, dbFilename, DEFAULT_DB_FILENAME } from './paths.js';
+export { resolveBackupDir, createBackup, listBackups, restoreBackup, exportData } from './backup.js';
 export { addInventoryRecord, listInventoryRecords, listLocationNodes, ensureLocationNode, listShopping, addShopping, checkShopping, missingItems, stockList, setThreshold, listPurchases, addPurchase, purchaseYearStats, listWarranties, addWarranty, addServiceEvent, listCerts, addCert, listAccounts, listMembers, addMember, listBorrows, addBorrow, statsOverview, highFreq, idleItems, expiringItems, } from './domains.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/fetch/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/fetch/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9D,OAAO,EACL,cAAc,EAAE,UAAU,EAAE,WAAW,EAAE,OAAO,EAAE,WAAW,EAC7D,mBAAmB,EAAE,cAAc,EAAE,WAAW,EAAE,UAAU,EAAE,cAAc,EAC5E,iBAAiB,EAAE,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,SAAS,EACpE,cAAc,EAAE,eAAe,EAAE,eAAe,EAAE,eAAe,EAAE,eAAe,GACnF,MAAM,SAAS,CAAC;AACjB,YAAY,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAC5E,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC1F,OAAO,EACL,kBAAkB,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,kBAAkB,EAC/E,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,YAAY,EAAE,SAAS,EAAE,YAAY,EAC/E,aAAa,EAAE,WAAW,EAAE,iBAAiB,EAAE,cAAc,EAAE,WAAW,EAAE,eAAe,EAC3F,SAAS,EAAE,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,SAAS,EAAE,WAAW,EAAE,SAAS,EAChF,aAAa,EAAE,QAAQ,EAAE,SAAS,EAAE,aAAa,GAClD,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/fetch/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9D,OAAO,EACL,cAAc,EAAE,UAAU,EAAE,WAAW,EAAE,OAAO,EAAE,WAAW,EAC7D,mBAAmB,EAAE,cAAc,EAAE,WAAW,EAAE,UAAU,EAAE,cAAc,EAC5E,iBAAiB,EAAE,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,SAAS,EACpE,cAAc,EAAE,eAAe,EAAE,eAAe,EAAE,eAAe,EAAE,eAAe,GACnF,MAAM,SAAS,CAAC;AACjB,YAAY,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAC5E,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAE1F,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACrG,OAAO,EACL,kBAAkB,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,kBAAkB,EAC/E,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,YAAY,EAAE,SAAS,EAAE,YAAY,EAC/E,aAAa,EAAE,WAAW,EAAE,iBAAiB,EAAE,cAAc,EAAE,WAAW,EAAE,eAAe,EAC3F,SAAS,EAAE,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,SAAS,EAAE,WAAW,EAAE,SAAS,EAChF,aAAa,EAAE,QAAQ,EAAE,SAAS,EAAE,aAAa,GAClD,MAAM,cAAc,CAAC"}

package/dist/fetch/index.js

@@ -1,5 +1,7 @@
 export { HomeFetchError, HomePolicyError } from './errors.js';
 export { SCHEMA_VERSION, openHomeDb, closeHomeDb, addItem, getItemById, listLocationsByItem, listTagsByItem, searchItems, updateItem, adjustQuantity, setLocationStatus, moveLocation, setItemTags, listAllTags, mergeTags, listCategories, getCategoryById, encryptPassword, decryptPassword, assertMasterKey, } from './db.js';
-export { resolveDbDir, resolveDbPath, assertWritablePath, DB_FILENAME } from './paths.js';
+export { resolveDbDir, resolveDbPath, dbFilename, DEFAULT_DB_FILENAME } from './paths.js';
+// #707：备份导出／导入恢复（HELP SM8-3／SM8-4）的落点。
+export { resolveBackupDir, createBackup, listBackups, restoreBackup, exportData } from './backup.js';
 export { addInventoryRecord, listInventoryRecords, listLocationNodes, ensureLocationNode, listShopping, addShopping, checkShopping, missingItems, stockList, setThreshold, listPurchases, addPurchase, purchaseYearStats, listWarranties, addWarranty, addServiceEvent, listCerts, addCert, listAccounts, listMembers, addMember, listBorrows, addBorrow, statsOverview, highFreq, idleItems, expiringItems, } from './domains.js';
 //# sourceMappingURL=index.js.map

package/dist/fetch/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/fetch/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9D,OAAO,EACL,cAAc,EAAE,UAAU,EAAE,WAAW,EAAE,OAAO,EAAE,WAAW,EAC7D,mBAAmB,EAAE,cAAc,EAAE,WAAW,EAAE,UAAU,EAAE,cAAc,EAC5E,iBAAiB,EAAE,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,SAAS,EACpE,cAAc,EAAE,eAAe,EAAE,eAAe,EAAE,eAAe,EAAE,eAAe,GACnF,MAAM,SAAS,CAAC;AAEjB,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC1F,OAAO,EACL,kBAAkB,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,kBAAkB,EAC/E,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,YAAY,EAAE,SAAS,EAAE,YAAY,EAC/E,aAAa,EAAE,WAAW,EAAE,iBAAiB,EAAE,cAAc,EAAE,WAAW,EAAE,eAAe,EAC3F,SAAS,EAAE,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,SAAS,EAAE,WAAW,EAAE,SAAS,EAChF,aAAa,EAAE,QAAQ,EAAE,SAAS,EAAE,aAAa,GAClD,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/fetch/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9D,OAAO,EACL,cAAc,EAAE,UAAU,EAAE,WAAW,EAAE,OAAO,EAAE,WAAW,EAC7D,mBAAmB,EAAE,cAAc,EAAE,WAAW,EAAE,UAAU,EAAE,cAAc,EAC5E,iBAAiB,EAAE,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,SAAS,EACpE,cAAc,EAAE,eAAe,EAAE,eAAe,EAAE,eAAe,EAAE,eAAe,GACnF,MAAM,SAAS,CAAC;AAEjB,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAC1F,uCAAuC;AACvC,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACrG,OAAO,EACL,kBAAkB,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,kBAAkB,EAC/E,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,YAAY,EAAE,SAAS,EAAE,YAAY,EAC/E,aAAa,EAAE,WAAW,EAAE,iBAAiB,EAAE,cAAc,EAAE,WAAW,EAAE,eAAe,EAC3F,SAAS,EAAE,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,SAAS,EAAE,WAAW,EAAE,SAAS,EAChF,aAAa,EAAE,QAAQ,EAAE,SAAS,EAAE,aAAa,GAClD,MAAM,cAAc,CAAC"}

package/dist/fetch/paths.d.ts

@@ -1,6 +1,8 @@
-export declare const DB_FILENAME = "home.db";
+/** 库文件名的默认值：＝改造前的代码常量 `DB_FILENAME`（配置项 `db.name` 空串即用它）。 */
+export declare const DEFAULT_DB_FILENAME = "home.db";
+/** 库文件名：配置 `db.name`，空串＝默认（`home.db`）。 */
+export declare function dbFilename(): string;
+/** 库目录：配置 `db.dir`，空串＝数据目录（`~/.ilife/data/`，`ILIFE_CONFIG_DIR` 可整体接管）。 */
 export declare function resolveDbDir(): string;
 export declare function resolveDbPath(filename?: string, dir?: string): string;
-/** 测试隔离守卫：非 tmp 路径写库须 HOME_FORCE_PROD=1（卡路里哨兵语义的居家版）。 */
-export declare function assertWritablePath(dbPath: string): void;
 //# sourceMappingURL=paths.d.ts.map

package/dist/fetch/paths.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/fetch/paths.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,WAAW,YAAY,CAAC;AAErC,wBAAgB,YAAY,IAAI,MAAM,CASrC;AAED,wBAAgB,aAAa,CAAC,QAAQ,SAAc,EAAE,GAAG,SAAiB,GAAG,MAAM,CAGlF;AAED,yDAAyD;AACzD,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAYvD"}
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/fetch/paths.ts"],"names":[],"mappings":"AAUA,6DAA6D;AAC7D,eAAO,MAAM,mBAAmB,YAAY,CAAC;AAE7C,0CAA0C;AAC1C,wBAAgB,UAAU,IAAI,MAAM,CAGnC;AAED,0EAA0E;AAC1E,wBAAgB,YAAY,IAAI,MAAM,CAGrC;AAED,wBAAgB,aAAa,CAAC,QAAQ,SAAe,EAAE,GAAG,SAAiB,GAAG,MAAM,CAGnF"}

package/dist/fetch/paths.js

@@ -1,31 +1,26 @@
-// DB 路径解析与隔离守卫：SKILLS_DB_PATH 必设，无默认值（铁律缺失阻断）。
-// 老家 home_manager/db.py Q6 fallback 链（D:/.db 等）TS 线有意不继承：拒绝隐式写生产。
+// 库路径解析：**配置文件的唯一真相**（#695；口径见「配置的存与生效口径裁定」#675 的解决评论）。
+// 改造前这里读 `SKILLS_DB_PATH`（无默认值、缺失即抛），并按 `HOME_FORCE_PROD=1` 守「非 tmp 不许写库」；
+// #695 按用户裁决把两个环境变量**一并删掉**：路径改从 `~/.ilife/home.yaml` 取，写库边界改由
+// 「测试基座强制 `ILIFE_CONFIG_DIR`」（`base-link-core` 的 `CONFIG_TEST_ISOLATION_MISSING`）承担——
+// 把「忘了配」从静默写真实库变成响亮失败。
+// 老家 home_manager/db.py Q6 fallback 链（D:/.db 等）TS 线仍有意不继承：拒绝隐式写生产。
 import { mkdirSync } from 'node:fs';
-import { tmpdir } from 'node:os';
-import { join, resolve } from 'node:path';
-export const DB_FILENAME = 'home.db';
+import { join } from 'node:path';
+import { loadHomeConfig } from '../config.js';
+/** 库文件名的默认值：＝改造前的代码常量 `DB_FILENAME`（配置项 `db.name` 空串即用它）。 */
+export const DEFAULT_DB_FILENAME = 'home.db';
+/** 库文件名：配置 `db.name`，空串＝默认（`home.db`）。 */
+export function dbFilename() {
+    const name = loadHomeConfig().values.db.name;
+    return name === '' ? DEFAULT_DB_FILENAME : name;
+}
+/** 库目录：配置 `db.dir`，空串＝数据目录（`~/.ilife/data/`，`ILIFE_CONFIG_DIR` 可整体接管）。 */
 export function resolveDbDir() {
-    const env = process.env.SKILLS_DB_PATH;
-    if (!env) {
-        throw new Error('[skill-home] SKILLS_DB_PATH 未设置：拒绝隐式落盘。' +
-            '生产请设置 SKILLS_DB_PATH；测试请传显式 tmp 路径。');
-    }
-    return env;
+    const dir = loadHomeConfig().values.db.dir;
+    return dir === '' ? loadHomeConfig().dataDir : dir;
 }
-export function resolveDbPath(filename = DB_FILENAME, dir = resolveDbDir()) {
+export function resolveDbPath(filename = dbFilename(), dir = resolveDbDir()) {
     mkdirSync(dir, { recursive: true });
     return join(dir, filename);
 }
-/** 测试隔离守卫：非 tmp 路径写库须 HOME_FORCE_PROD=1（卡路里哨兵语义的居家版）。 */
-export function assertWritablePath(dbPath) {
-    const forceProd = process.env.HOME_FORCE_PROD === '1';
-    const underTmp = resolve(dbPath).startsWith(resolve(tmpdir()));
-    if (!underTmp && !forceProd) {
-        throw new Error('[skill-home] 拒绝写入非 tmp 路径 ' + dbPath + '：测试隔离守卫。' +
-            '如确需生产写，请设置 HOME_FORCE_PROD=1（opt-in 可见）。');
-    }
-    if (!underTmp && forceProd) {
-        console.error('[skill-home] HOME_FORCE_PROD=1: 写入 ' + dbPath);
-    }
-}
 //# sourceMappingURL=paths.js.map

package/dist/fetch/paths.js.map

@@ -1 +1 @@
-{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../src/fetch/paths.ts"],"names":[],"mappings":"AAAA,+CAA+C;AAC/C,kEAAkE;AAClE,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpC,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAE1C,MAAM,CAAC,MAAM,WAAW,GAAG,SAAS,CAAC;AAErC,MAAM,UAAU,YAAY;IAC1B,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC;IACvC,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,MAAM,IAAI,KAAK,CACb,yCAAyC;YACvC,qCAAqC,CACxC,CAAC;IACJ,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,QAAQ,GAAG,WAAW,EAAE,GAAG,GAAG,YAAY,EAAE;IACxE,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACpC,OAAO,IAAI,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;AAC7B,CAAC;AAED,yDAAyD;AACzD,MAAM,UAAU,kBAAkB,CAAC,MAAc;IAC/C,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,KAAK,GAAG,CAAC;IACtD,MAAM,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IAC/D,IAAI,CAAC,QAAQ,IAAI,CAAC,SAAS,EAAE,CAAC;QAC5B,MAAM,IAAI,KAAK,CACb,4BAA4B,GAAG,MAAM,GAAG,UAAU;YAChD,0CAA0C,CAC7C,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,QAAQ,IAAI,SAAS,EAAE,CAAC;QAC3B,OAAO,CAAC,KAAK,CAAC,qCAAqC,GAAG,MAAM,CAAC,CAAC;IAChE,CAAC;AACH,CAAC"}
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../src/fetch/paths.ts"],"names":[],"mappings":"AAAA,wDAAwD;AACxD,2EAA2E;AAC3E,+DAA+D;AAC/D,sFAAsF;AACtF,uBAAuB;AACvB,mEAAmE;AACnE,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE9C,6DAA6D;AAC7D,MAAM,CAAC,MAAM,mBAAmB,GAAG,SAAS,CAAC;AAE7C,0CAA0C;AAC1C,MAAM,UAAU,UAAU;IACxB,MAAM,IAAI,GAAG,cAAc,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC;IAC7C,OAAO,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,IAAI,CAAC;AAClD,CAAC;AAED,0EAA0E;AAC1E,MAAM,UAAU,YAAY;IAC1B,MAAM,GAAG,GAAG,cAAc,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,GAAG,CAAC;IAC3C,OAAO,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC,cAAc,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC;AACrD,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,QAAQ,GAAG,UAAU,EAAE,EAAE,GAAG,GAAG,YAAY,EAAE;IACzE,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACpC,OAAO,IAAI,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;AAC7B,CAAC"}

package/dist/health.d.ts

@@ -0,0 +1,41 @@
+/** 报告里的三档判据（与面板侧镜像同值）。 */
+export type HealthStatus = 'red' | 'yellow' | 'green';
+export interface HealthItem {
+    readonly id: string;
+    readonly title: string;
+    readonly status: HealthStatus;
+    readonly message: string;
+    readonly action: string;
+    readonly source?: string;
+}
+export interface HomeHealthReport {
+    readonly skill: string;
+    readonly configPath: string;
+    readonly dataDir: string;
+    readonly items: readonly HealthItem[];
+}
+/** 库表数门槛：`src/fetch/db.ts` 的建表语句里那 16 张表齐了才算正常（少了报黄：还能用，但缺功能的表要重建）。 */
+export declare const DB_TABLE_THRESHOLD: 16;
+/** 只读解析结果：文件不在／读得出取值与「哪些键真在文件里」／读不出来（报文带行号与文件名）。 */
+export type ConfigRead = {
+    readonly kind: 'missing';
+} | {
+    readonly kind: 'ok';
+    readonly values: Record<string, Record<string, unknown>>;
+    readonly present: ReadonlySet<string>;
+} | {
+    readonly kind: 'bad';
+    readonly message: string;
+};
+/**
+ * 只读解析那份配置文件（与 `base-link-core` 的受限子集同一套校验，口径逐条对齐）：
+ * 剥 BOM、去 `\r`、空行与整行注释跳过、缩进只许 2 个空格且不许制表符、不支持列表、
+ * 一行须是「键: 值」、不许重复定义、顶层键冒号后没值即开一个组。
+ *
+ * 与 `loadConfig()` 的差别只有一处、也正是本件要的那一处：**文件不在时不落默认件**。
+ * 取值语义与它一致：文件里缺的项按默认值补。
+ */
+export declare function readHomeConfigReadOnly(): ConfigRead;
+/** 跑一次体检，返回整份报告。**只读**：任何一处都不落盘（只有写探针那一个文件，且当场删掉）。 */
+export declare function buildHomeHealthReport(): HomeHealthReport;
+//# sourceMappingURL=health.d.ts.map

package/dist/health.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"health.d.ts","sourceRoot":"","sources":["../src/health.ts"],"names":[],"mappings":"AA4BA,0BAA0B;AAC1B,MAAM,MAAM,YAAY,GAAG,KAAK,GAAG,QAAQ,GAAG,OAAO,CAAC;AAEtD,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,SAAS,UAAU,EAAE,CAAC;CACvC;AAED,uEAAuE;AACvE,eAAO,MAAM,kBAAkB,EAAG,EAAW,CAAC;AAiB9C,oDAAoD;AACpD,MAAM,MAAM,UAAU,GAClB;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAA;CAAE,GAC5B;IAAE,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC,MAAM,CAAC,CAAA;CAAE,GACxH;IAAE,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAEvD;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,IAAI,UAAU,CAYnD;AAsRD,sDAAsD;AACtD,wBAAgB,qBAAqB,IAAI,gBAAgB,CA4KxD"}