codex-multi-auth 1.2.0 → 1.2.2

package/dist/lib/storage/account-port.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"account-port.d.ts","sourceRoot":"","sources":["../../../lib/storage/account-port.ts"],"names":[],"mappings":"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"}

package/dist/lib/storage/account-port.js

@@ -0,0 +1,43 @@
+export async function exportAccountsSnapshot(params) {
+    const storage = params.transactionState?.active &&
+        params.transactionState.storagePath === params.currentStoragePath
+        ? params.transactionState.snapshot
+        : params.transactionState?.active
+            ? await params.readCurrentStorageUnlocked()
+            : await params.readCurrentStorage();
+    await params.exportAccountsToFile({
+        resolvedPath: params.resolvedPath,
+        force: params.force,
+        storage,
+        beforeCommit: params.beforeCommit,
+        logInfo: params.logInfo,
+    });
+}
+export async function importAccountsSnapshot(params) {
+    const normalized = await params.readImportFile({
+        resolvedPath: params.resolvedPath,
+        normalizeAccountStorage: params.normalizeAccountStorage,
+    });
+    const result = await params.withAccountStorageTransaction(async (existing, persist) => {
+        const merged = params.mergeImportedAccounts({
+            existing,
+            imported: normalized,
+            maxAccounts: params.maxAccounts,
+            deduplicateAccounts: params.deduplicateAccounts,
+        });
+        await persist(merged.newStorage);
+        return {
+            imported: merged.imported,
+            total: merged.total,
+            skipped: merged.skipped,
+        };
+    });
+    params.logInfo("Imported accounts", {
+        path: params.resolvedPath,
+        imported: result.imported,
+        skipped: result.skipped,
+        total: result.total,
+    });
+    return result;
+}
+//# sourceMappingURL=account-port.js.map

package/dist/lib/storage/account-port.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"account-port.js","sourceRoot":"","sources":["../../../lib/storage/account-port.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,MAsB5C;IACA,MAAM,OAAO,GACZ,MAAM,CAAC,gBAAgB,EAAE,MAAM;QAC/B,MAAM,CAAC,gBAAgB,CAAC,WAAW,KAAK,MAAM,CAAC,kBAAkB;QAChE,CAAC,CAAC,MAAM,CAAC,gBAAgB,CAAC,QAAQ;QAClC,CAAC,CAAC,MAAM,CAAC,gBAAgB,EAAE,MAAM;YAChC,CAAC,CAAC,MAAM,MAAM,CAAC,0BAA0B,EAAE;YAC3C,CAAC,CAAC,MAAM,MAAM,CAAC,kBAAkB,EAAE,CAAC;IAEvC,MAAM,MAAM,CAAC,oBAAoB,CAAC;QACjC,YAAY,EAAE,MAAM,CAAC,YAAY;QACjC,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,OAAO;QACP,YAAY,EAAE,MAAM,CAAC,YAAY;QACjC,OAAO,EAAE,MAAM,CAAC,OAAO;KACvB,CAAC,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,MA+B5C;IACA,MAAM,UAAU,GAAG,MAAM,MAAM,CAAC,cAAc,CAAC;QAC9C,YAAY,EAAE,MAAM,CAAC,YAAY;QACjC,uBAAuB,EAAE,MAAM,CAAC,uBAAuB;KACvD,CAAC,CAAC;IAEH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,6BAA6B,CACxD,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE;QAC3B,MAAM,MAAM,GAAG,MAAM,CAAC,qBAAqB,CAAC;YAC3C,QAAQ;YACR,QAAQ,EAAE,UAAU;YACpB,WAAW,EAAE,MAAM,CAAC,WAAW;YAC/B,mBAAmB,EAAE,MAAM,CAAC,mBAAmB;SAC/C,CAAC,CAAC;QACH,MAAM,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QACjC,OAAO;YACN,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,OAAO,EAAE,MAAM,CAAC,OAAO;SACvB,CAAC;IACH,CAAC,CACD,CAAC;IAEF,MAAM,CAAC,OAAO,CAAC,mBAAmB,EAAE;QACnC,IAAI,EAAE,MAAM,CAAC,YAAY;QACzB,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,KAAK,EAAE,MAAM,CAAC,KAAK;KACnB,CAAC,CAAC;IACH,OAAO,MAAM,CAAC;AACf,CAAC"}

package/dist/lib/storage/account-save-entry.d.ts

@@ -0,0 +1,7 @@
+import type { AccountStorageV3 } from "../storage.js";
+export declare function saveAccountsEntry(params: {
+    storage: AccountStorageV3;
+    withStorageLock: <T>(fn: () => Promise<T>) => Promise<T>;
+    saveUnlocked: (storage: AccountStorageV3) => Promise<void>;
+}): Promise<void>;
+//# sourceMappingURL=account-save-entry.d.ts.map

package/dist/lib/storage/account-save-entry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"account-save-entry.d.ts","sourceRoot":"","sources":["../../../lib/storage/account-save-entry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEtD,wBAAsB,iBAAiB,CAAC,MAAM,EAAE;IAC/C,OAAO,EAAE,gBAAgB,CAAC;IAC1B,eAAe,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;IACzD,YAAY,EAAE,CAAC,OAAO,EAAE,gBAAgB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3D,GAAG,OAAO,CAAC,IAAI,CAAC,CAIhB"}

package/dist/lib/storage/account-save-entry.js

@@ -0,0 +1,6 @@
+export async function saveAccountsEntry(params) {
+    return params.withStorageLock(async () => {
+        await params.saveUnlocked(params.storage);
+    });
+}
+//# sourceMappingURL=account-save-entry.js.map

package/dist/lib/storage/account-save-entry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"account-save-entry.js","sourceRoot":"","sources":["../../../lib/storage/account-save-entry.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,MAIvC;IACA,OAAO,MAAM,CAAC,eAAe,CAAC,KAAK,IAAI,EAAE;QACxC,MAAM,MAAM,CAAC,YAAY,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAC3C,CAAC,CAAC,CAAC;AACJ,CAAC"}

package/dist/lib/storage/account-save.d.ts

@@ -0,0 +1,30 @@
+import type { AccountStorageV3 } from "../storage.js";
+export declare function saveAccountsToDisk(storage: AccountStorageV3, params: {
+    path: string;
+    resetMarkerPath: string;
+    walPath: string;
+    storageBackupEnabled: boolean;
+    ensureDirectory: () => Promise<void>;
+    ensureGitignore: () => Promise<void>;
+    looksLikeSyntheticFixtureStorage: (storage: AccountStorageV3 | null) => boolean;
+    loadExistingStorage: () => Promise<AccountStorageV3 | null>;
+    createSyntheticFixtureError: () => Error;
+    createRotatingAccountsBackup: (path: string) => Promise<void>;
+    computeSha256: (value: string) => string;
+    writeJournal: (content: string, path: string) => Promise<void>;
+    writeTemp: (tempPath: string, content: string) => Promise<void>;
+    statTemp: (tempPath: string) => Promise<{
+        size: number;
+    }>;
+    renameTempToPath: (tempPath: string) => Promise<void>;
+    cleanupResetMarker: () => Promise<void>;
+    cleanupWal: () => Promise<void>;
+    cleanupTemp: (tempPath: string) => Promise<void>;
+    onSaved: () => void;
+    logWarn: (message: string, details: Record<string, unknown>) => void;
+    logError: (message: string, details: Record<string, unknown>) => void;
+    createStorageError: (error: unknown) => Error;
+    backupPath: string;
+    createTempPath: () => string;
+}): Promise<void>;
+//# sourceMappingURL=account-save.d.ts.map

package/dist/lib/storage/account-save.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"account-save.d.ts","sourceRoot":"","sources":["../../../lib/storage/account-save.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEtD,wBAAsB,kBAAkB,CACvC,OAAO,EAAE,gBAAgB,EACzB,MAAM,EAAE;IACP,IAAI,EAAE,MAAM,CAAC;IACb,eAAe,EAAE,MAAM,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,oBAAoB,EAAE,OAAO,CAAC;IAC9B,eAAe,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACrC,eAAe,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACrC,gCAAgC,EAAE,CACjC,OAAO,EAAE,gBAAgB,GAAG,IAAI,KAC5B,OAAO,CAAC;IACb,mBAAmB,EAAE,MAAM,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAC;IAC5D,2BAA2B,EAAE,MAAM,KAAK,CAAC;IACzC,4BAA4B,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9D,aAAa,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;IACzC,YAAY,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/D,SAAS,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAChE,QAAQ,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC1D,gBAAgB,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACtD,kBAAkB,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACxC,UAAU,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAChC,WAAW,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACjD,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,OAAO,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;IACrE,QAAQ,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;IACtE,kBAAkB,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,KAAK,CAAC;IAC9C,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,MAAM,CAAC;CAC7B,GACC,OAAO,CAAC,IAAI,CAAC,CAoDf"}

package/dist/lib/storage/account-save.js

@@ -0,0 +1,49 @@
+export async function saveAccountsToDisk(storage, params) {
+    const tempPath = params.createTempPath();
+    try {
+        await params.ensureDirectory();
+        await params.ensureGitignore();
+        if (params.looksLikeSyntheticFixtureStorage(storage)) {
+            const existing = await params.loadExistingStorage();
+            if (existing &&
+                existing.accounts.length > 0 &&
+                !params.looksLikeSyntheticFixtureStorage(existing)) {
+                throw params.createSyntheticFixtureError();
+            }
+        }
+        if (params.storageBackupEnabled) {
+            try {
+                await params.createRotatingAccountsBackup(params.path);
+            }
+            catch (backupError) {
+                params.logWarn("Failed to create account storage backup", {
+                    path: params.path,
+                    backupPath: params.backupPath,
+                    error: String(backupError),
+                });
+            }
+        }
+        const content = JSON.stringify(storage, null, 2);
+        await params.writeJournal(content, params.path);
+        await params.writeTemp(tempPath, content);
+        const stats = await params.statTemp(tempPath);
+        if (stats.size === 0) {
+            throw Object.assign(new Error("File written but size is 0"), {
+                code: "EEMPTY",
+            });
+        }
+        await params.renameTempToPath(tempPath);
+        await params.cleanupResetMarker();
+        params.onSaved();
+        await params.cleanupWal();
+    }
+    catch (error) {
+        await params.cleanupTemp(tempPath);
+        params.logError("Failed to save accounts", {
+            path: params.path,
+            error: String(error),
+        });
+        throw params.createStorageError(error);
+    }
+}
+//# sourceMappingURL=account-save.js.map

package/dist/lib/storage/account-save.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"account-save.js","sourceRoot":"","sources":["../../../lib/storage/account-save.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACvC,OAAyB,EACzB,MA2BC;IAED,MAAM,QAAQ,GAAG,MAAM,CAAC,cAAc,EAAE,CAAC;IACzC,IAAI,CAAC;QACJ,MAAM,MAAM,CAAC,eAAe,EAAE,CAAC;QAC/B,MAAM,MAAM,CAAC,eAAe,EAAE,CAAC;QAE/B,IAAI,MAAM,CAAC,gCAAgC,CAAC,OAAO,CAAC,EAAE,CAAC;YACtD,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,mBAAmB,EAAE,CAAC;YACpD,IACC,QAAQ;gBACR,QAAQ,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC;gBAC5B,CAAC,MAAM,CAAC,gCAAgC,CAAC,QAAQ,CAAC,EACjD,CAAC;gBACF,MAAM,MAAM,CAAC,2BAA2B,EAAE,CAAC;YAC5C,CAAC;QACF,CAAC;QAED,IAAI,MAAM,CAAC,oBAAoB,EAAE,CAAC;YACjC,IAAI,CAAC;gBACJ,MAAM,MAAM,CAAC,4BAA4B,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YACxD,CAAC;YAAC,OAAO,WAAW,EAAE,CAAC;gBACtB,MAAM,CAAC,OAAO,CAAC,yCAAyC,EAAE;oBACzD,IAAI,EAAE,MAAM,CAAC,IAAI;oBACjB,UAAU,EAAE,MAAM,CAAC,UAAU;oBAC7B,KAAK,EAAE,MAAM,CAAC,WAAW,CAAC;iBAC1B,CAAC,CAAC;YACJ,CAAC;QACF,CAAC;QAED,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QACjD,MAAM,MAAM,CAAC,YAAY,CAAC,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;QAChD,MAAM,MAAM,CAAC,SAAS,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAE1C,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QAC9C,IAAI,KAAK,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;YACtB,MAAM,MAAM,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,4BAA4B,CAAC,EAAE;gBAC5D,IAAI,EAAE,QAAQ;aACd,CAAC,CAAC;QACJ,CAAC;QAED,MAAM,MAAM,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAC;QACxC,MAAM,MAAM,CAAC,kBAAkB,EAAE,CAAC;QAClC,MAAM,CAAC,OAAO,EAAE,CAAC;QACjB,MAAM,MAAM,CAAC,UAAU,EAAE,CAAC;IAC3B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,MAAM,MAAM,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;QACnC,MAAM,CAAC,QAAQ,CAAC,yBAAyB,EAAE;YAC1C,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC;SACpB,CAAC,CAAC;QACH,MAAM,MAAM,CAAC,kBAAkB,CAAC,KAAK,CAAC,CAAC;IACxC,CAAC;AACF,CAAC"}

package/dist/lib/storage/account-snapshot.d.ts

@@ -0,0 +1,25 @@
+import type { BackupSnapshotMetadata, SnapshotStats } from "./backup-metadata.js";
+/**
+ * Read size and mtime metadata for a backup candidate when it exists.
+ */
+export declare function statSnapshot(path: string, deps: {
+    stat: typeof import("node:fs").promises.stat;
+    logWarn: (message: string, meta: Record<string, unknown>) => void;
+}): Promise<SnapshotStats>;
+/**
+ * Build backup metadata for an account snapshot, treating ENOENT load races as invalid snapshots
+ * that were present when the initial stat succeeded.
+ */
+export declare function describeAccountSnapshot(path: string, kind: BackupSnapshotMetadata["kind"], deps: {
+    index?: number;
+    statSnapshot: (path: string) => Promise<SnapshotStats>;
+    loadAccountsFromPath: (path: string) => Promise<{
+        normalized: {
+            accounts: unknown[];
+        } | null;
+        schemaErrors: string[];
+        storedVersion?: unknown;
+    }>;
+    logWarn: (message: string, meta: Record<string, unknown>) => void;
+}): Promise<BackupSnapshotMetadata>;
+//# sourceMappingURL=account-snapshot.d.ts.map

package/dist/lib/storage/account-snapshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"account-snapshot.d.ts","sourceRoot":"","sources":["../../../lib/storage/account-snapshot.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAElF;;GAEG;AACH,wBAAsB,YAAY,CACjC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE;IACL,IAAI,EAAE,cAAc,SAAS,EAAE,QAAQ,CAAC,IAAI,CAAC;IAC7C,OAAO,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;CAClE,GACC,OAAO,CAAC,aAAa,CAAC,CAqBxB;AAED;;;GAGG;AACH,wBAAsB,uBAAuB,CAC5C,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,sBAAsB,CAAC,MAAM,CAAC,EACpC,IAAI,EAAE;IACL,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,aAAa,CAAC,CAAC;IACvD,oBAAoB,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;QAC/C,UAAU,EAAE;YAAE,QAAQ,EAAE,OAAO,EAAE,CAAA;SAAE,GAAG,IAAI,CAAC;QAC3C,YAAY,EAAE,MAAM,EAAE,CAAC;QACvB,aAAa,CAAC,EAAE,OAAO,CAAC;KACxB,CAAC,CAAC;IACH,OAAO,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;CAClE,GACC,OAAO,CAAC,sBAAsB,CAAC,CAkDjC"}

package/dist/lib/storage/account-snapshot.js

@@ -0,0 +1,78 @@
+/**
+ * Read size and mtime metadata for a backup candidate when it exists.
+ */
+export async function statSnapshot(path, deps) {
+    try {
+        const stats = await deps.stat(path);
+        return { exists: true, bytes: stats.size, mtimeMs: stats.mtimeMs };
+    }
+    catch (error) {
+        const code = error.code;
+        if (code === "EBUSY" || code === "EPERM") {
+            deps.logWarn("Backup candidate is locked", {
+                path,
+                error: String(error),
+            });
+            return { exists: true };
+        }
+        if (code !== "ENOENT") {
+            deps.logWarn("Failed to stat backup candidate", {
+                path,
+                error: String(error),
+            });
+        }
+        return { exists: false };
+    }
+}
+/**
+ * Build backup metadata for an account snapshot, treating ENOENT load races as invalid snapshots
+ * that were present when the initial stat succeeded.
+ */
+export async function describeAccountSnapshot(path, kind, deps) {
+    const stats = await deps.statSnapshot(path);
+    if (!stats.exists) {
+        return { kind, path, index: deps.index, exists: false, valid: false };
+    }
+    try {
+        const { normalized, schemaErrors, storedVersion } = await deps.loadAccountsFromPath(path);
+        let resolvedStats = stats;
+        for (let attempt = 0; attempt < 2 &&
+            (resolvedStats.bytes === undefined || resolvedStats.mtimeMs === undefined); attempt += 1) {
+            const refreshedStats = await deps.statSnapshot(path);
+            if (refreshedStats.exists) {
+                resolvedStats = refreshedStats;
+            }
+        }
+        return {
+            kind,
+            path,
+            index: deps.index,
+            exists: true,
+            valid: !!normalized,
+            bytes: resolvedStats.bytes ?? 0,
+            mtimeMs: resolvedStats.mtimeMs ?? 0,
+            version: typeof storedVersion === "number" ? storedVersion : undefined,
+            accountCount: normalized?.accounts.length,
+            schemaErrors: schemaErrors.length > 0 ? schemaErrors : undefined,
+        };
+    }
+    catch (error) {
+        const code = error.code;
+        if (code !== "ENOENT") {
+            deps.logWarn("Failed to inspect account snapshot", {
+                path,
+                error: String(error),
+            });
+        }
+        return {
+            kind,
+            path,
+            index: deps.index,
+            exists: true,
+            valid: false,
+            bytes: stats.bytes,
+            mtimeMs: stats.mtimeMs,
+        };
+    }
+}
+//# sourceMappingURL=account-snapshot.js.map

package/dist/lib/storage/account-snapshot.js.map

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

package/dist/lib/storage/backup-metadata-builder.d.ts

@@ -0,0 +1,32 @@
+import type { BackupMetadata } from "../storage.js";
+type Snapshot = {
+    kind: "accounts-primary" | "accounts-wal" | "accounts-backup" | "accounts-backup-history" | "accounts-discovered-backup" | "flagged-primary" | "flagged-backup" | "flagged-backup-history" | "flagged-discovered-backup";
+    path: string;
+    index?: number;
+    exists: boolean;
+    valid: boolean;
+    bytes?: number;
+    mtimeMs?: number;
+    version?: number;
+    accountCount?: number;
+    flaggedCount?: number;
+    schemaErrors?: string[];
+};
+export declare function buildBackupMetadata(params: {
+    storagePath: string;
+    flaggedPath: string;
+    walPath: string;
+    getAccountsBackupRecoveryCandidatesWithDiscovery: (path: string) => Promise<string[]>;
+    describeAccountSnapshot: (path: string, kind: "accounts-primary" | "accounts-backup" | "accounts-backup-history" | "accounts-discovered-backup", index?: number) => Promise<Snapshot>;
+    describeAccountsWalSnapshot: (path: string) => Promise<Snapshot>;
+    describeFlaggedSnapshot: (path: string, kind: "flagged-primary" | "flagged-backup" | "flagged-backup-history" | "flagged-discovered-backup", index?: number) => Promise<Snapshot>;
+    buildMetadataSection: (storagePath: string, snapshots: Snapshot[]) => {
+        storagePath: string;
+        latestValidPath?: string;
+        snapshotCount: number;
+        validSnapshotCount: number;
+        snapshots: Snapshot[];
+    };
+}): Promise<BackupMetadata>;
+export {};
+//# sourceMappingURL=backup-metadata-builder.d.ts.map

package/dist/lib/storage/backup-metadata-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backup-metadata-builder.d.ts","sourceRoot":"","sources":["../../../lib/storage/backup-metadata-builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAEpD,KAAK,QAAQ,GAAG;IACf,IAAI,EACD,kBAAkB,GAClB,cAAc,GACd,iBAAiB,GACjB,yBAAyB,GACzB,4BAA4B,GAC5B,iBAAiB,GACjB,gBAAgB,GAChB,wBAAwB,GACxB,2BAA2B,CAAC;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACxB,CAAC;AAyDF,wBAAsB,mBAAmB,CAAC,MAAM,EAAE;IACjD,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,gDAAgD,EAAE,CACjD,IAAI,EAAE,MAAM,KACR,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACvB,uBAAuB,EAAE,CACxB,IAAI,EAAE,MAAM,EACZ,IAAI,EACD,kBAAkB,GAClB,iBAAiB,GACjB,yBAAyB,GACzB,4BAA4B,EAC/B,KAAK,CAAC,EAAE,MAAM,KACV,OAAO,CAAC,QAAQ,CAAC,CAAC;IACvB,2BAA2B,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;IACjE,uBAAuB,EAAE,CACxB,IAAI,EAAE,MAAM,EACZ,IAAI,EACD,iBAAiB,GACjB,gBAAgB,GAChB,wBAAwB,GACxB,2BAA2B,EAC9B,KAAK,CAAC,EAAE,MAAM,KACV,OAAO,CAAC,QAAQ,CAAC,CAAC;IACvB,oBAAoB,EAAE,CACrB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,QAAQ,EAAE,KACjB;QACJ,WAAW,EAAE,MAAM,CAAC;QACpB,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,aAAa,EAAE,MAAM,CAAC;QACtB,kBAAkB,EAAE,MAAM,CAAC;QAC3B,SAAS,EAAE,QAAQ,EAAE,CAAC;KACtB,CAAC;CACF,GAAG,OAAO,CAAC,cAAc,CAAC,CA2D1B"}

package/dist/lib/storage/backup-metadata-builder.js

@@ -0,0 +1,77 @@
+const ACCOUNT_BACKUP_PREFERRED_KINDS = new Set([
+    "accounts-discovered-backup",
+    "accounts-backup-history",
+    "accounts-backup",
+]);
+const ACCOUNT_SNAPSHOT_PRIORITY = new Map([
+    ["accounts-discovered-backup", 4],
+    ["accounts-backup-history", 3],
+    ["accounts-backup", 2],
+    ["accounts-wal", 1],
+    ["accounts-primary", 0],
+]);
+function newestValidSnapshot(snapshots, options) {
+    return snapshots
+        .filter((snapshot) => snapshot.valid &&
+        (!options?.kinds || options.kinds.has(snapshot.kind)))
+        .sort((left, right) => {
+        const rightPriority = options?.priorities?.get(right.kind) ?? 0;
+        const leftPriority = options?.priorities?.get(left.kind) ?? 0;
+        if (rightPriority !== leftPriority) {
+            return rightPriority - leftPriority;
+        }
+        return (right.mtimeMs ?? 0) - (left.mtimeMs ?? 0);
+    })[0];
+}
+function selectLatestValidAccountPath(snapshots) {
+    return (newestValidSnapshot(snapshots, {
+        kinds: ACCOUNT_BACKUP_PREFERRED_KINDS,
+        priorities: ACCOUNT_SNAPSHOT_PRIORITY,
+    })?.path ??
+        newestValidSnapshot(snapshots, {
+            kinds: new Set(["accounts-wal"]),
+            priorities: ACCOUNT_SNAPSHOT_PRIORITY,
+        })?.path ??
+        newestValidSnapshot(snapshots, {
+            priorities: ACCOUNT_SNAPSHOT_PRIORITY,
+        })?.path);
+}
+export async function buildBackupMetadata(params) {
+    const { storagePath, flaggedPath, walPath, getAccountsBackupRecoveryCandidatesWithDiscovery, describeAccountSnapshot, describeAccountsWalSnapshot, describeFlaggedSnapshot, buildMetadataSection, } = params;
+    const accountCandidates = await getAccountsBackupRecoveryCandidatesWithDiscovery(storagePath);
+    const accountSnapshots = [
+        await describeAccountSnapshot(storagePath, "accounts-primary"),
+        await describeAccountsWalSnapshot(walPath),
+    ];
+    for (const [index, candidate] of accountCandidates.entries()) {
+        const kind = candidate === `${storagePath}.bak`
+            ? "accounts-backup"
+            : candidate.startsWith(`${storagePath}.bak.`)
+                ? "accounts-backup-history"
+                : "accounts-discovered-backup";
+        accountSnapshots.push(await describeAccountSnapshot(candidate, kind, index));
+    }
+    const flaggedCandidates = await getAccountsBackupRecoveryCandidatesWithDiscovery(flaggedPath);
+    const flaggedSnapshots = [
+        await describeFlaggedSnapshot(flaggedPath, "flagged-primary"),
+    ];
+    for (const [index, candidate] of flaggedCandidates.entries()) {
+        const kind = candidate === `${flaggedPath}.bak`
+            ? "flagged-backup"
+            : candidate.startsWith(`${flaggedPath}.bak.`)
+                ? "flagged-backup-history"
+                : "flagged-discovered-backup";
+        flaggedSnapshots.push(await describeFlaggedSnapshot(candidate, kind, index));
+    }
+    const accountsMetadata = buildMetadataSection(storagePath, accountSnapshots);
+    const flaggedMetadata = buildMetadataSection(flaggedPath, flaggedSnapshots);
+    return {
+        accounts: {
+            ...accountsMetadata,
+            latestValidPath: selectLatestValidAccountPath(accountSnapshots) ??
+                accountsMetadata.latestValidPath,
+        },
+        flaggedAccounts: flaggedMetadata,
+    };
+}
+//# sourceMappingURL=backup-metadata-builder.js.map

package/dist/lib/storage/backup-metadata-builder.js.map

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

package/dist/lib/storage/backup-metadata.d.ts

@@ -0,0 +1,29 @@
+export type BackupSnapshotKind = "accounts-primary" | "accounts-wal" | "accounts-backup" | "accounts-backup-history" | "accounts-discovered-backup" | "flagged-primary" | "flagged-backup" | "flagged-backup-history" | "flagged-discovered-backup";
+export type BackupSnapshotMetadata = {
+    kind: BackupSnapshotKind;
+    path: string;
+    index?: number;
+    exists: boolean;
+    valid: boolean;
+    bytes?: number;
+    mtimeMs?: number;
+    version?: number;
+    accountCount?: number;
+    flaggedCount?: number;
+    schemaErrors?: string[];
+};
+export type BackupMetadataSection = {
+    storagePath: string;
+    latestValidPath?: string;
+    snapshotCount: number;
+    validSnapshotCount: number;
+    snapshots: BackupSnapshotMetadata[];
+};
+export declare function latestValidSnapshot(snapshots: BackupSnapshotMetadata[]): BackupSnapshotMetadata | undefined;
+export declare function buildMetadataSection(storagePath: string, snapshots: BackupSnapshotMetadata[]): BackupMetadataSection;
+export type SnapshotStats = {
+    exists: boolean;
+    bytes?: number;
+    mtimeMs?: number;
+};
+//# sourceMappingURL=backup-metadata.d.ts.map

package/dist/lib/storage/backup-metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backup-metadata.d.ts","sourceRoot":"","sources":["../../../lib/storage/backup-metadata.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,kBAAkB,GAC3B,kBAAkB,GAClB,cAAc,GACd,iBAAiB,GACjB,yBAAyB,GACzB,4BAA4B,GAC5B,iBAAiB,GACjB,gBAAgB,GAChB,wBAAwB,GACxB,2BAA2B,CAAC;AAE/B,MAAM,MAAM,sBAAsB,GAAG;IACpC,IAAI,EAAE,kBAAkB,CAAC;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IACnC,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,aAAa,EAAE,MAAM,CAAC;IACtB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,SAAS,EAAE,sBAAsB,EAAE,CAAC;CACpC,CAAC;AAEF,wBAAgB,mBAAmB,CAClC,SAAS,EAAE,sBAAsB,EAAE,GACjC,sBAAsB,GAAG,SAAS,CAIpC;AAED,wBAAgB,oBAAoB,CACnC,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,sBAAsB,EAAE,GACjC,qBAAqB,CASvB;AAED,MAAM,MAAM,aAAa,GAAG;IAC3B,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC"}

package/dist/lib/storage/backup-metadata.js

@@ -0,0 +1,16 @@
+export function latestValidSnapshot(snapshots) {
+    return snapshots
+        .filter((snapshot) => snapshot.valid)
+        .sort((left, right) => (right.mtimeMs ?? 0) - (left.mtimeMs ?? 0))[0];
+}
+export function buildMetadataSection(storagePath, snapshots) {
+    const latestValid = latestValidSnapshot(snapshots);
+    return {
+        storagePath,
+        latestValidPath: latestValid?.path,
+        snapshotCount: snapshots.length,
+        validSnapshotCount: snapshots.filter((snapshot) => snapshot.valid).length,
+        snapshots,
+    };
+}
+//# sourceMappingURL=backup-metadata.js.map

package/dist/lib/storage/backup-metadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"backup-metadata.js","sourceRoot":"","sources":["../../../lib/storage/backup-metadata.ts"],"names":[],"mappings":"AAiCA,MAAM,UAAU,mBAAmB,CAClC,SAAmC;IAEnC,OAAO,SAAS;SACd,MAAM,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC;SACpC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,IAAI,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACxE,CAAC;AAED,MAAM,UAAU,oBAAoB,CACnC,WAAmB,EACnB,SAAmC;IAEnC,MAAM,WAAW,GAAG,mBAAmB,CAAC,SAAS,CAAC,CAAC;IACnD,OAAO;QACN,WAAW;QACX,eAAe,EAAE,WAAW,EAAE,IAAI;QAClC,aAAa,EAAE,SAAS,CAAC,MAAM;QAC/B,kBAAkB,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,MAAM;QACzE,SAAS;KACT,CAAC;AACH,CAAC"}

package/dist/lib/storage/backup-paths.d.ts

@@ -0,0 +1,10 @@
+declare const ACCOUNTS_BACKUP_SUFFIX = ".bak";
+declare const ACCOUNTS_WAL_SUFFIX = ".wal";
+declare const RESET_MARKER_SUFFIX = ".reset-intent";
+export declare function getAccountsBackupPath(path: string): string;
+export declare function getAccountsBackupPathAtIndex(path: string, index: number): string;
+export declare function getAccountsBackupRecoveryCandidates(path: string, depth: number): string[];
+export declare function getAccountsWalPath(path: string): string;
+export declare function getIntentionalResetMarkerPath(path: string): string;
+export { ACCOUNTS_BACKUP_SUFFIX, ACCOUNTS_WAL_SUFFIX, RESET_MARKER_SUFFIX };
+//# sourceMappingURL=backup-paths.d.ts.map

package/dist/lib/storage/backup-paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backup-paths.d.ts","sourceRoot":"","sources":["../../../lib/storage/backup-paths.ts"],"names":[],"mappings":"AAAA,QAAA,MAAM,sBAAsB,SAAS,CAAC;AACtC,QAAA,MAAM,mBAAmB,SAAS,CAAC;AACnC,QAAA,MAAM,mBAAmB,kBAAkB,CAAC;AAE5C,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE1D;AAED,wBAAgB,4BAA4B,CAC3C,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,GACX,MAAM,CAKR;AAED,wBAAgB,mCAAmC,CAClD,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,GACX,MAAM,EAAE,CAMV;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED,wBAAgB,6BAA6B,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAElE;AAED,OAAO,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,CAAC"}

package/dist/lib/storage/backup-paths.js

@@ -0,0 +1,27 @@
+const ACCOUNTS_BACKUP_SUFFIX = ".bak";
+const ACCOUNTS_WAL_SUFFIX = ".wal";
+const RESET_MARKER_SUFFIX = ".reset-intent";
+export function getAccountsBackupPath(path) {
+    return `${path}${ACCOUNTS_BACKUP_SUFFIX}`;
+}
+export function getAccountsBackupPathAtIndex(path, index) {
+    if (index <= 0) {
+        return getAccountsBackupPath(path);
+    }
+    return `${path}${ACCOUNTS_BACKUP_SUFFIX}.${index}`;
+}
+export function getAccountsBackupRecoveryCandidates(path, depth) {
+    const candidates = [];
+    for (let i = 0; i < depth; i += 1) {
+        candidates.push(getAccountsBackupPathAtIndex(path, i));
+    }
+    return candidates;
+}
+export function getAccountsWalPath(path) {
+    return `${path}${ACCOUNTS_WAL_SUFFIX}`;
+}
+export function getIntentionalResetMarkerPath(path) {
+    return `${path}${RESET_MARKER_SUFFIX}`;
+}
+export { ACCOUNTS_BACKUP_SUFFIX, ACCOUNTS_WAL_SUFFIX, RESET_MARKER_SUFFIX };
+//# sourceMappingURL=backup-paths.js.map

package/dist/lib/storage/backup-paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"backup-paths.js","sourceRoot":"","sources":["../../../lib/storage/backup-paths.ts"],"names":[],"mappings":"AAAA,MAAM,sBAAsB,GAAG,MAAM,CAAC;AACtC,MAAM,mBAAmB,GAAG,MAAM,CAAC;AACnC,MAAM,mBAAmB,GAAG,eAAe,CAAC;AAE5C,MAAM,UAAU,qBAAqB,CAAC,IAAY;IACjD,OAAO,GAAG,IAAI,GAAG,sBAAsB,EAAE,CAAC;AAC3C,CAAC;AAED,MAAM,UAAU,4BAA4B,CAC3C,IAAY,EACZ,KAAa;IAEb,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;QAChB,OAAO,qBAAqB,CAAC,IAAI,CAAC,CAAC;IACpC,CAAC;IACD,OAAO,GAAG,IAAI,GAAG,sBAAsB,IAAI,KAAK,EAAE,CAAC;AACpD,CAAC;AAED,MAAM,UAAU,mCAAmC,CAClD,IAAY,EACZ,KAAa;IAEb,MAAM,UAAU,GAAa,EAAE,CAAC;IAChC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QACnC,UAAU,CAAC,IAAI,CAAC,4BAA4B,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IACxD,CAAC;IACD,OAAO,UAAU,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,IAAY;IAC9C,OAAO,GAAG,IAAI,GAAG,mBAAmB,EAAE,CAAC;AACxC,CAAC;AAED,MAAM,UAAU,6BAA6B,CAAC,IAAY;IACzD,OAAO,GAAG,IAAI,GAAG,mBAAmB,EAAE,CAAC;AACxC,CAAC;AAED,OAAO,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,CAAC"}

package/dist/lib/storage/backup-restore.d.ts

@@ -0,0 +1,11 @@
+import type { AccountStorageV3 } from "../storage.js";
+export declare function restoreAccountsFromBackupPath(path: string, options: {
+    persist?: boolean;
+    backupRoot: string;
+    realpath: (path: string) => Promise<string>;
+    loadAccountsFromPath: (path: string) => Promise<{
+        normalized: AccountStorageV3 | null;
+    }>;
+    saveAccounts: (storage: AccountStorageV3) => Promise<void>;
+}): Promise<AccountStorageV3>;
+//# sourceMappingURL=backup-restore.d.ts.map

package/dist/lib/storage/backup-restore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backup-restore.d.ts","sourceRoot":"","sources":["../../../lib/storage/backup-restore.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEtD,wBAAsB,6BAA6B,CAClD,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE;IACR,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAC5C,oBAAoB,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;QAC/C,UAAU,EAAE,gBAAgB,GAAG,IAAI,CAAC;KACpC,CAAC,CAAC;IACH,YAAY,EAAE,CAAC,OAAO,EAAE,gBAAgB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3D,GACC,OAAO,CAAC,gBAAgB,CAAC,CAwD3B"}

package/dist/lib/storage/backup-restore.js

@@ -0,0 +1,52 @@
+import { isAbsolute, relative } from "node:path";
+export async function restoreAccountsFromBackupPath(path, options) {
+    let resolvedBackupRoot;
+    try {
+        resolvedBackupRoot = await options.realpath(options.backupRoot);
+    }
+    catch (error) {
+        const code = error.code;
+        if (code === "ENOENT") {
+            throw new Error(`Backup root does not exist: ${options.backupRoot}`);
+        }
+        throw error;
+    }
+    let resolvedBackupPath;
+    try {
+        resolvedBackupPath = await options.realpath(path);
+    }
+    catch (error) {
+        const code = error.code;
+        if (code === "ENOENT") {
+            throw new Error(`Backup file no longer exists: ${path}`);
+        }
+        throw error;
+    }
+    const relativePath = relative(resolvedBackupRoot, resolvedBackupPath);
+    const isInsideBackupRoot = relativePath.length > 0 &&
+        !relativePath.startsWith("..") &&
+        !isAbsolute(relativePath);
+    if (!isInsideBackupRoot) {
+        throw new Error(`Backup path must stay inside ${resolvedBackupRoot}: ${path}`);
+    }
+    const { normalized } = await (async () => {
+        try {
+            return await options.loadAccountsFromPath(resolvedBackupPath);
+        }
+        catch (error) {
+            const code = error.code;
+            if (code === "ENOENT") {
+                throw new Error(`Backup file no longer exists: ${path}`);
+            }
+            throw error;
+        }
+    })();
+    if (!normalized || normalized.accounts.length === 0) {
+        throw new Error(`Backup does not contain any accounts: ${resolvedBackupPath}`);
+    }
+    if (options.persist !== false) {
+        await options.saveAccounts(normalized);
+    }
+    return normalized;
+}
+//# sourceMappingURL=backup-restore.js.map

package/dist/lib/storage/backup-restore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"backup-restore.js","sourceRoot":"","sources":["../../../lib/storage/backup-restore.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAGjD,MAAM,CAAC,KAAK,UAAU,6BAA6B,CAClD,IAAY,EACZ,OAQC;IAED,IAAI,kBAA0B,CAAC;IAC/B,IAAI,CAAC;QACJ,kBAAkB,GAAG,MAAM,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IACjE,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,MAAM,IAAI,GAAI,KAA+B,CAAC,IAAI,CAAC;QACnD,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;YACvB,MAAM,IAAI,KAAK,CAAC,+BAA+B,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;QACtE,CAAC;QACD,MAAM,KAAK,CAAC;IACb,CAAC;IAED,IAAI,kBAA0B,CAAC;IAC/B,IAAI,CAAC;QACJ,kBAAkB,GAAG,MAAM,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IACnD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,MAAM,IAAI,GAAI,KAA+B,CAAC,IAAI,CAAC;QACnD,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;YACvB,MAAM,IAAI,KAAK,CAAC,iCAAiC,IAAI,EAAE,CAAC,CAAC;QAC1D,CAAC;QACD,MAAM,KAAK,CAAC;IACb,CAAC;IAED,MAAM,YAAY,GAAG,QAAQ,CAAC,kBAAkB,EAAE,kBAAkB,CAAC,CAAC;IACtE,MAAM,kBAAkB,GACvB,YAAY,CAAC,MAAM,GAAG,CAAC;QACvB,CAAC,YAAY,CAAC,UAAU,CAAC,IAAI,CAAC;QAC9B,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC;IAC3B,IAAI,CAAC,kBAAkB,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CACd,gCAAgC,kBAAkB,KAAK,IAAI,EAAE,CAC7D,CAAC;IACH,CAAC;IAED,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,CAAC,KAAK,IAAI,EAAE;QACxC,IAAI,CAAC;YACJ,OAAO,MAAM,OAAO,CAAC,oBAAoB,CAAC,kBAAkB,CAAC,CAAC;QAC/D,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,MAAM,IAAI,GAAI,KAA+B,CAAC,IAAI,CAAC;YACnD,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;gBACvB,MAAM,IAAI,KAAK,CAAC,iCAAiC,IAAI,EAAE,CAAC,CAAC;YAC1D,CAAC;YACD,MAAM,KAAK,CAAC;QACb,CAAC;IACF,CAAC,CAAC,EAAE,CAAC;IAEL,IAAI,CAAC,UAAU,IAAI,UAAU,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACrD,MAAM,IAAI,KAAK,CACd,yCAAyC,kBAAkB,EAAE,CAC7D,CAAC;IACH,CAAC;IAED,IAAI,OAAO,CAAC,OAAO,KAAK,KAAK,EAAE,CAAC;QAC/B,MAAM,OAAO,CAAC,YAAY,CAAC,UAAU,CAAC,CAAC;IACxC,CAAC;IACD,OAAO,UAAU,CAAC;AACnB,CAAC"}

package/dist/lib/storage/cache-artifacts.d.ts

@@ -0,0 +1,2 @@
+export declare function isCacheLikeBackupArtifactName(entryName: string): boolean;
+//# sourceMappingURL=cache-artifacts.d.ts.map

package/dist/lib/storage/cache-artifacts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache-artifacts.d.ts","sourceRoot":"","sources":["../../../lib/storage/cache-artifacts.ts"],"names":[],"mappings":"AAAA,wBAAgB,6BAA6B,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAExE"}

package/dist/lib/storage/cache-artifacts.js

@@ -0,0 +1,4 @@
+export function isCacheLikeBackupArtifactName(entryName) {
+    return entryName.toLowerCase().includes(".cache");
+}
+//# sourceMappingURL=cache-artifacts.js.map

package/dist/lib/storage/cache-artifacts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache-artifacts.js","sourceRoot":"","sources":["../../../lib/storage/cache-artifacts.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,6BAA6B,CAAC,SAAiB;IAC9D,OAAO,SAAS,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;AACnD,CAAC"}

package/dist/lib/storage/error-hints.d.ts

@@ -0,0 +1,10 @@
+import { StorageError } from "../errors.js";
+/**
+ * Format a user-facing hint for storage persistence failures based on errno code.
+ */
+export declare function formatStorageErrorHint(error: unknown, path: string): string;
+/**
+ * Wrap an arbitrary storage failure in a StorageError with a derived hint.
+ */
+export declare function toStorageError(message: string, error: unknown, path: string): StorageError;
+//# sourceMappingURL=error-hints.d.ts.map

package/dist/lib/storage/error-hints.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-hints.d.ts","sourceRoot":"","sources":["../../../lib/storage/error-hints.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAO5C;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAqB3E;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC7B,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,OAAO,EACd,IAAI,EAAE,MAAM,GACV,YAAY,CAQd"}