codex-multi-auth 1.2.0 → 1.2.1

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"}

package/dist/lib/storage/error-hints.js

@@ -0,0 +1,36 @@
+import { StorageError } from "../errors.js";
+function extractErrorCode(error) {
+    const err = error;
+    return err?.code || "UNKNOWN";
+}
+/**
+ * Format a user-facing hint for storage persistence failures based on errno code.
+ */
+export function formatStorageErrorHint(error, path) {
+    const code = extractErrorCode(error);
+    const isWindows = process.platform === "win32";
+    switch (code) {
+        case "EACCES":
+        case "EPERM":
+            return isWindows
+                ? `Permission denied writing to ${path}. Check antivirus exclusions for this folder. Ensure you have write permissions.`
+                : `Permission denied writing to ${path}. Check folder permissions. Try: chmod 755 ~/.codex`;
+        case "EBUSY":
+            return `File is locked at ${path}. The file may be open in another program. Close any editors or processes accessing it.`;
+        case "ENOENT":
+            return `Path does not exist: ${path}. Create the parent folder and try again.`;
+        case "ENOSPC":
+            return `Disk is full. Free up space and try again. Path: ${path}`;
+        default:
+            return isWindows
+                ? `Failed to write to ${path}. Check folder permissions and ensure path contains no special characters.`
+                : `Failed to write to ${path}. Check folder permissions and disk space.`;
+    }
+}
+/**
+ * Wrap an arbitrary storage failure in a StorageError with a derived hint.
+ */
+export function toStorageError(message, error, path) {
+    return new StorageError(message, extractErrorCode(error), path, formatStorageErrorHint(error, path), error instanceof Error ? error : undefined);
+}
+//# sourceMappingURL=error-hints.js.map

package/dist/lib/storage/error-hints.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-hints.js","sourceRoot":"","sources":["../../../lib/storage/error-hints.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE5C,SAAS,gBAAgB,CAAC,KAAc;IACvC,MAAM,GAAG,GAAG,KAA8B,CAAC;IAC3C,OAAO,GAAG,EAAE,IAAI,IAAI,SAAS,CAAC;AAC/B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,sBAAsB,CAAC,KAAc,EAAE,IAAY;IAClE,MAAM,IAAI,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC;IACrC,MAAM,SAAS,GAAG,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC;IAE/C,QAAQ,IAAI,EAAE,CAAC;QACd,KAAK,QAAQ,CAAC;QACd,KAAK,OAAO;YACX,OAAO,SAAS;gBACf,CAAC,CAAC,gCAAgC,IAAI,kFAAkF;gBACxH,CAAC,CAAC,gCAAgC,IAAI,qDAAqD,CAAC;QAC9F,KAAK,OAAO;YACX,OAAO,qBAAqB,IAAI,yFAAyF,CAAC;QAC3H,KAAK,QAAQ;YACZ,OAAO,wBAAwB,IAAI,2CAA2C,CAAC;QAChF,KAAK,QAAQ;YACZ,OAAO,oDAAoD,IAAI,EAAE,CAAC;QACnE;YACC,OAAO,SAAS;gBACf,CAAC,CAAC,sBAAsB,IAAI,4EAA4E;gBACxG,CAAC,CAAC,sBAAsB,IAAI,4CAA4C,CAAC;IAC5E,CAAC;AACF,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAC7B,OAAe,EACf,KAAc,EACd,IAAY;IAEZ,OAAO,IAAI,YAAY,CACtB,OAAO,EACP,gBAAgB,CAAC,KAAK,CAAC,EACvB,IAAI,EACJ,sBAAsB,CAAC,KAAK,EAAE,IAAI,CAAC,EACnC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAC1C,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,6 @@
+import { ACCOUNTS_BACKUP_SUFFIX, ACCOUNTS_WAL_SUFFIX, getAccountsBackupPath, getAccountsBackupPathAtIndex, getAccountsWalPath, getIntentionalResetMarkerPath, RESET_MARKER_SUFFIX } from "./backup-paths.js";
+export { ACCOUNTS_BACKUP_SUFFIX, ACCOUNTS_WAL_SUFFIX, getAccountsBackupPath, getAccountsBackupPathAtIndex, getAccountsWalPath, getIntentionalResetMarkerPath, RESET_MARKER_SUFFIX, };
+export declare function getAccountsBackupRecoveryCandidates(path: string): string[];
+export declare function getFlaggedAccountsPath(storagePath: string, fileName: string): string;
+export declare function getLegacyFlaggedAccountsPath(storagePath: string, legacyFileName: string): string;
+//# sourceMappingURL=file-paths.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"file-paths.d.ts","sourceRoot":"","sources":["../../../lib/storage/file-paths.ts"],"names":[],"mappings":"AACA,OAAO,EACN,sBAAsB,EACtB,mBAAmB,EACnB,qBAAqB,EACrB,4BAA4B,EAE5B,kBAAkB,EAClB,6BAA6B,EAC7B,mBAAmB,EACnB,MAAM,mBAAmB,CAAC;AAI3B,OAAO,EACN,sBAAsB,EACtB,mBAAmB,EACnB,qBAAqB,EACrB,4BAA4B,EAC5B,kBAAkB,EAClB,6BAA6B,EAC7B,mBAAmB,GACnB,CAAC;AAEF,wBAAgB,mCAAmC,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAE1E;AAED,wBAAgB,sBAAsB,CACrC,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,GACd,MAAM,CAER;AAMD,wBAAgB,4BAA4B,CAC3C,WAAW,EAAE,MAAM,EACnB,cAAc,EAAE,MAAM,GACpB,MAAM,CAER"}

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

@@ -0,0 +1,17 @@
+import { dirname, join } from "node:path";
+import { ACCOUNTS_BACKUP_SUFFIX, ACCOUNTS_WAL_SUFFIX, getAccountsBackupPath, getAccountsBackupPathAtIndex, getAccountsBackupRecoveryCandidates as getBackupRecoveryCandidates, getAccountsWalPath, getIntentionalResetMarkerPath, RESET_MARKER_SUFFIX, } from "./backup-paths.js";
+const ACCOUNTS_BACKUP_HISTORY_DEPTH = 3;
+export { ACCOUNTS_BACKUP_SUFFIX, ACCOUNTS_WAL_SUFFIX, getAccountsBackupPath, getAccountsBackupPathAtIndex, getAccountsWalPath, getIntentionalResetMarkerPath, RESET_MARKER_SUFFIX, };
+export function getAccountsBackupRecoveryCandidates(path) {
+    return getBackupRecoveryCandidates(path, ACCOUNTS_BACKUP_HISTORY_DEPTH);
+}
+export function getFlaggedAccountsPath(storagePath, fileName) {
+    return buildSiblingStoragePath(storagePath, fileName);
+}
+function buildSiblingStoragePath(storagePath, fileName) {
+    return join(dirname(storagePath), fileName);
+}
+export function getLegacyFlaggedAccountsPath(storagePath, legacyFileName) {
+    return buildSiblingStoragePath(storagePath, legacyFileName);
+}
+//# sourceMappingURL=file-paths.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"file-paths.js","sourceRoot":"","sources":["../../../lib/storage/file-paths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EACN,sBAAsB,EACtB,mBAAmB,EACnB,qBAAqB,EACrB,4BAA4B,EAC5B,mCAAmC,IAAI,2BAA2B,EAClE,kBAAkB,EAClB,6BAA6B,EAC7B,mBAAmB,GACnB,MAAM,mBAAmB,CAAC;AAE3B,MAAM,6BAA6B,GAAG,CAAC,CAAC;AAExC,OAAO,EACN,sBAAsB,EACtB,mBAAmB,EACnB,qBAAqB,EACrB,4BAA4B,EAC5B,kBAAkB,EAClB,6BAA6B,EAC7B,mBAAmB,GACnB,CAAC;AAEF,MAAM,UAAU,mCAAmC,CAAC,IAAY;IAC/D,OAAO,2BAA2B,CAAC,IAAI,EAAE,6BAA6B,CAAC,CAAC;AACzE,CAAC;AAED,MAAM,UAAU,sBAAsB,CACrC,WAAmB,EACnB,QAAgB;IAEhB,OAAO,uBAAuB,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;AACvD,CAAC;AAED,SAAS,uBAAuB,CAAC,WAAmB,EAAE,QAAgB;IACrE,OAAO,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,QAAQ,CAAC,CAAC;AAC7C,CAAC;AAED,MAAM,UAAU,4BAA4B,CAC3C,WAAmB,EACnB,cAAsB;IAEtB,OAAO,uBAAuB,CAAC,WAAW,EAAE,cAAc,CAAC,CAAC;AAC7D,CAAC"}

package/dist/lib/storage/fixture-guards.d.ts

@@ -0,0 +1,4 @@
+import type { AccountMetadataV3, AccountStorageV3 } from "../storage.js";
+export declare function looksLikeSyntheticFixtureAccount(account: AccountMetadataV3): boolean;
+export declare function looksLikeSyntheticFixtureStorage(storage: AccountStorageV3 | null): boolean;
+//# sourceMappingURL=fixture-guards.d.ts.map

package/dist/lib/storage/fixture-guards.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fixture-guards.d.ts","sourceRoot":"","sources":["../../../lib/storage/fixture-guards.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEzE,wBAAgB,gCAAgC,CAC/C,OAAO,EAAE,iBAAiB,GACxB,OAAO,CAwBT;AAED,wBAAgB,gCAAgC,CAC/C,OAAO,EAAE,gBAAgB,GAAG,IAAI,GAC9B,OAAO,CAKT"}

package/dist/lib/storage/fixture-guards.js

@@ -0,0 +1,27 @@
+export function looksLikeSyntheticFixtureAccount(account) {
+    const email = typeof account.email === "string" ? account.email.trim().toLowerCase() : "";
+    const refreshToken = typeof account.refreshToken === "string"
+        ? account.refreshToken.trim().toLowerCase()
+        : "";
+    const accountId = typeof account.accountId === "string"
+        ? account.accountId.trim().toLowerCase()
+        : "";
+    if (!/^account\d+@example\.com$/.test(email)) {
+        return false;
+    }
+    const hasSyntheticRefreshToken = refreshToken.startsWith("fake_refresh") ||
+        /^fake_refresh_token_\d+(_for_testing_only)?$/.test(refreshToken);
+    if (!hasSyntheticRefreshToken) {
+        return false;
+    }
+    if (accountId.length === 0) {
+        return true;
+    }
+    return /^acc(_|-)?\d+$/.test(accountId);
+}
+export function looksLikeSyntheticFixtureStorage(storage) {
+    if (!storage || storage.accounts.length === 0)
+        return false;
+    return storage.accounts.every((account) => looksLikeSyntheticFixtureAccount(account));
+}
+//# sourceMappingURL=fixture-guards.js.map

package/dist/lib/storage/fixture-guards.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fixture-guards.js","sourceRoot":"","sources":["../../../lib/storage/fixture-guards.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,gCAAgC,CAC/C,OAA0B;IAE1B,MAAM,KAAK,GACV,OAAO,OAAO,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAC7E,MAAM,YAAY,GACjB,OAAO,OAAO,CAAC,YAAY,KAAK,QAAQ;QACvC,CAAC,CAAC,OAAO,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE;QAC3C,CAAC,CAAC,EAAE,CAAC;IACP,MAAM,SAAS,GACd,OAAO,OAAO,CAAC,SAAS,KAAK,QAAQ;QACpC,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE;QACxC,CAAC,CAAC,EAAE,CAAC;IACP,IAAI,CAAC,2BAA2B,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QAC9C,OAAO,KAAK,CAAC;IACd,CAAC;IACD,MAAM,wBAAwB,GAC7B,YAAY,CAAC,UAAU,CAAC,cAAc,CAAC;QACvC,8CAA8C,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IACnE,IAAI,CAAC,wBAAwB,EAAE,CAAC;QAC/B,OAAO,KAAK,CAAC;IACd,CAAC;IACD,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5B,OAAO,IAAI,CAAC;IACb,CAAC;IACD,OAAO,gBAAgB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;AACzC,CAAC;AAED,MAAM,UAAU,gCAAgC,CAC/C,OAAgC;IAEhC,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAC5D,OAAO,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,EAAE,CACzC,gCAAgC,CAAC,OAAO,CAAC,CACzC,CAAC;AACH,CAAC"}

package/dist/lib/storage/flagged-entry.d.ts

@@ -0,0 +1,15 @@
+export { saveFlaggedAccountsEntry } from "./flagged-save-entry.js";
+export declare function clearFlaggedAccountsEntry(params: {
+    path: string;
+    withStorageLock: <T>(fn: () => Promise<T>) => Promise<T>;
+    markerPath: string;
+    getBackupPaths: () => Promise<string[]>;
+    clearFlaggedAccountsOnDisk: (args: {
+        path: string;
+        markerPath: string;
+        backupPaths: string[];
+        logError: (message: string, details: Record<string, unknown>) => void;
+    }) => Promise<void>;
+    logError: (message: string, details: Record<string, unknown>) => void;
+}): Promise<void>;
+//# sourceMappingURL=flagged-entry.d.ts.map

package/dist/lib/storage/flagged-entry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flagged-entry.d.ts","sourceRoot":"","sources":["../../../lib/storage/flagged-entry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AAEnE,wBAAsB,yBAAyB,CAAC,MAAM,EAAE;IACvD,IAAI,EAAE,MAAM,CAAC;IACb,eAAe,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;IACzD,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACxC,0BAA0B,EAAE,CAAC,IAAI,EAAE;QAClC,IAAI,EAAE,MAAM,CAAC;QACb,UAAU,EAAE,MAAM,CAAC;QACnB,WAAW,EAAE,MAAM,EAAE,CAAC;QACtB,QAAQ,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;KACtE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACpB,QAAQ,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;CACtE,GAAG,OAAO,CAAC,IAAI,CAAC,CAShB"}

package/dist/lib/storage/flagged-entry.js

@@ -0,0 +1,12 @@
+export { saveFlaggedAccountsEntry } from "./flagged-save-entry.js";
+export async function clearFlaggedAccountsEntry(params) {
+    return params.withStorageLock(async () => {
+        await params.clearFlaggedAccountsOnDisk({
+            path: params.path,
+            markerPath: params.markerPath,
+            backupPaths: await params.getBackupPaths(),
+            logError: params.logError,
+        });
+    });
+}
+//# sourceMappingURL=flagged-entry.js.map

package/dist/lib/storage/flagged-entry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"flagged-entry.js","sourceRoot":"","sources":["../../../lib/storage/flagged-entry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AAEnE,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAAC,MAY/C;IACA,OAAO,MAAM,CAAC,eAAe,CAAC,KAAK,IAAI,EAAE;QACxC,MAAM,MAAM,CAAC,0BAA0B,CAAC;YACvC,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,UAAU,EAAE,MAAM,CAAC,UAAU;YAC7B,WAAW,EAAE,MAAM,MAAM,CAAC,cAAc,EAAE;YAC1C,QAAQ,EAAE,MAAM,CAAC,QAAQ;SACzB,CAAC,CAAC;IACJ,CAAC,CAAC,CAAC;AACJ,CAAC"}

package/dist/lib/storage/flagged-load-entry.d.ts

@@ -0,0 +1,20 @@
+import type { FlaggedAccountStorageV1 } from "../storage.js";
+export declare function loadFlaggedAccountsEntry(params: {
+    getFlaggedAccountsPath: () => string;
+    getLegacyFlaggedAccountsPath: () => string;
+    getIntentionalResetMarkerPath: (path: string) => string;
+    normalizeFlaggedStorage: (data: unknown) => FlaggedAccountStorageV1;
+    saveFlaggedAccounts: (storage: FlaggedAccountStorageV1) => Promise<void>;
+    loadFlaggedAccountsState: (args: {
+        path: string;
+        legacyPath: string;
+        resetMarkerPath: string;
+        normalizeFlaggedStorage: (data: unknown) => FlaggedAccountStorageV1;
+        saveFlaggedAccounts: (storage: FlaggedAccountStorageV1) => Promise<void>;
+        logError: (message: string, details: Record<string, unknown>) => void;
+        logInfo: (message: string, details: Record<string, unknown>) => void;
+    }) => Promise<FlaggedAccountStorageV1>;
+    logError: (message: string, details: Record<string, unknown>) => void;
+    logInfo: (message: string, details: Record<string, unknown>) => void;
+}): Promise<FlaggedAccountStorageV1>;
+//# sourceMappingURL=flagged-load-entry.d.ts.map

package/dist/lib/storage/flagged-load-entry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flagged-load-entry.d.ts","sourceRoot":"","sources":["../../../lib/storage/flagged-load-entry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AAE7D,wBAAsB,wBAAwB,CAAC,MAAM,EAAE;IACtD,sBAAsB,EAAE,MAAM,MAAM,CAAC;IACrC,4BAA4B,EAAE,MAAM,MAAM,CAAC;IAC3C,6BAA6B,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;IACxD,uBAAuB,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,uBAAuB,CAAC;IACpE,mBAAmB,EAAE,CAAC,OAAO,EAAE,uBAAuB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACzE,wBAAwB,EAAE,CAAC,IAAI,EAAE;QAChC,IAAI,EAAE,MAAM,CAAC;QACb,UAAU,EAAE,MAAM,CAAC;QACnB,eAAe,EAAE,MAAM,CAAC;QACxB,uBAAuB,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,uBAAuB,CAAC;QACpE,mBAAmB,EAAE,CAAC,OAAO,EAAE,uBAAuB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;QACzE,QAAQ,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;QACtE,OAAO,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;KACrE,KAAK,OAAO,CAAC,uBAAuB,CAAC,CAAC;IACvC,QAAQ,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;IACtE,OAAO,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;CACrE,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAWnC"}

package/dist/lib/storage/flagged-load-entry.js

@@ -0,0 +1,13 @@
+export async function loadFlaggedAccountsEntry(params) {
+    const path = params.getFlaggedAccountsPath();
+    return params.loadFlaggedAccountsState({
+        path,
+        legacyPath: params.getLegacyFlaggedAccountsPath(),
+        resetMarkerPath: params.getIntentionalResetMarkerPath(path),
+        normalizeFlaggedStorage: params.normalizeFlaggedStorage,
+        saveFlaggedAccounts: params.saveFlaggedAccounts,
+        logError: params.logError,
+        logInfo: params.logInfo,
+    });
+}
+//# sourceMappingURL=flagged-load-entry.js.map