codex-multi-auth 1.2.0 → 1.2.1

package/dist/lib/storage/import-export.js

@@ -0,0 +1,108 @@
+import { existsSync, promises as fs } from "node:fs";
+import { dirname } from "node:path";
+const EXPORT_RENAME_MAX_ATTEMPTS = 4;
+const EXPORT_RENAME_BASE_DELAY_MS = 25;
+async function renameExportFileWithRetry(sourcePath, destinationPath) {
+    for (let attempt = 0; attempt < EXPORT_RENAME_MAX_ATTEMPTS; attempt += 1) {
+        try {
+            await fs.rename(sourcePath, destinationPath);
+            return;
+        }
+        catch (error) {
+            const code = error.code;
+            const canRetry = (code === "EPERM" || code === "EBUSY" || code === "EAGAIN") &&
+                attempt + 1 < EXPORT_RENAME_MAX_ATTEMPTS;
+            if (!canRetry) {
+                throw error;
+            }
+            await new Promise((resolve) => setTimeout(resolve, EXPORT_RENAME_BASE_DELAY_MS * 2 ** attempt));
+        }
+    }
+}
+export async function exportAccountsToFile(params) {
+    if (!params.force && existsSync(params.resolvedPath)) {
+        throw new Error(`File already exists: ${params.resolvedPath}`);
+    }
+    if (!params.storage || params.storage.accounts.length === 0) {
+        throw new Error("No accounts to export");
+    }
+    await fs.mkdir(dirname(params.resolvedPath), { recursive: true });
+    await params.beforeCommit?.(params.resolvedPath);
+    if (!params.force && existsSync(params.resolvedPath)) {
+        throw new Error(`File already exists: ${params.resolvedPath}`);
+    }
+    const content = JSON.stringify({
+        version: params.storage.version,
+        accounts: params.storage.accounts,
+        activeIndex: params.storage.activeIndex,
+        activeIndexByFamily: params.storage.activeIndexByFamily,
+    }, null, 2);
+    const uniqueSuffix = `${Date.now()}.${Math.random().toString(36).slice(2, 8)}`;
+    const tempPath = `${params.resolvedPath}.${uniqueSuffix}.tmp`;
+    try {
+        await fs.writeFile(tempPath, content, {
+            encoding: "utf-8",
+            mode: 0o600,
+        });
+        await renameExportFileWithRetry(tempPath, params.resolvedPath);
+    }
+    catch (error) {
+        try {
+            await fs.unlink(tempPath);
+        }
+        catch {
+            // Ignore cleanup failures for staged export files.
+        }
+        throw error;
+    }
+    params.logInfo("Exported accounts", {
+        path: params.resolvedPath,
+        count: params.storage.accounts.length,
+    });
+}
+export async function readImportFile(params) {
+    if (!existsSync(params.resolvedPath)) {
+        throw new Error(`Import file not found: ${params.resolvedPath}`);
+    }
+    const content = await fs.readFile(params.resolvedPath, "utf-8");
+    let imported;
+    try {
+        imported = JSON.parse(content);
+    }
+    catch {
+        throw new Error(`Invalid JSON in import file: ${params.resolvedPath}`);
+    }
+    const normalized = params.normalizeAccountStorage(imported);
+    if (!normalized) {
+        throw new Error("Invalid account storage format");
+    }
+    return normalized;
+}
+export function mergeImportedAccounts(params) {
+    const existingAccounts = params.existing?.accounts ?? [];
+    const existingActiveIndex = params.existing?.activeIndex ?? 0;
+    const merged = [...existingAccounts, ...params.imported.accounts];
+    if (merged.length > params.maxAccounts) {
+        const deduped = params.deduplicateAccounts(merged);
+        if (deduped.length > params.maxAccounts) {
+            throw new Error(`Import would exceed maximum of ${params.maxAccounts} accounts (would have ${deduped.length})`);
+        }
+    }
+    const deduplicatedAccounts = params.deduplicateAccounts(merged);
+    const deduplicatedExistingAccounts = params.deduplicateAccounts(existingAccounts);
+    const newStorage = {
+        version: 3,
+        accounts: deduplicatedAccounts,
+        activeIndex: existingActiveIndex,
+        activeIndexByFamily: params.existing?.activeIndexByFamily,
+    };
+    const importedCount = deduplicatedAccounts.length - deduplicatedExistingAccounts.length;
+    const skippedCount = params.imported.accounts.length - importedCount;
+    return {
+        newStorage,
+        imported: importedCount,
+        total: deduplicatedAccounts.length,
+        skipped: skippedCount,
+    };
+}
+//# sourceMappingURL=import-export.js.map

package/dist/lib/storage/import-export.js.map

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

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

@@ -0,0 +1,16 @@
+export declare function latestValidSnapshot<TSnapshot extends {
+    valid: boolean;
+    mtimeMs?: number;
+}>(snapshots: TSnapshot[]): TSnapshot | undefined;
+export declare function buildMetadataSection<TSnapshot extends {
+    path: string;
+    valid: boolean;
+    mtimeMs?: number;
+}>(storagePath: string, snapshots: TSnapshot[]): {
+    storagePath: string;
+    latestValidPath?: string;
+    snapshotCount: number;
+    validSnapshotCount: number;
+    snapshots: TSnapshot[];
+};
+//# sourceMappingURL=metadata-section.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"metadata-section.d.ts","sourceRoot":"","sources":["../../../lib/storage/metadata-section.ts"],"names":[],"mappings":"AAAA,wBAAgB,mBAAmB,CAClC,SAAS,SAAS;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,EACrD,SAAS,EAAE,SAAS,EAAE,GAAG,SAAS,GAAG,SAAS,CAI/C;AAED,wBAAgB,oBAAoB,CACnC,SAAS,SAAS;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,EAEpE,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,SAAS,EAAE,GACpB;IACF,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,aAAa,EAAE,MAAM,CAAC;IACtB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,SAAS,EAAE,SAAS,EAAE,CAAC;CACvB,CASA"}

package/dist/lib/storage/metadata-section.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=metadata-section.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"metadata-section.js","sourceRoot":"","sources":["../../../lib/storage/metadata-section.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,mBAAmB,CAEjC,SAAsB;IACvB,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,CAGnC,WAAmB,EACnB,SAAsB;IAQtB,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/named-backup-entry.d.ts

@@ -0,0 +1,15 @@
+export declare function exportNamedBackupEntry(params: {
+    name: string;
+    options?: {
+        force?: boolean;
+    };
+    exportNamedBackupFile: (name: string, deps: {
+        getStoragePath: () => string;
+        exportAccounts: (filePath: string, force?: boolean, beforeCommit?: (resolvedPath: string) => Promise<void> | void) => Promise<void>;
+    }, options?: {
+        force?: boolean;
+    }) => Promise<string>;
+    getStoragePath: () => string;
+    exportAccounts: (filePath: string, force?: boolean, beforeCommit?: (resolvedPath: string) => Promise<void> | void) => Promise<void>;
+}): Promise<string>;
+//# sourceMappingURL=named-backup-entry.d.ts.map

package/dist/lib/storage/named-backup-entry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"named-backup-entry.d.ts","sourceRoot":"","sources":["../../../lib/storage/named-backup-entry.ts"],"names":[],"mappings":"AAAA,wBAAsB,sBAAsB,CAAC,MAAM,EAAE;IACpD,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IAC9B,qBAAqB,EAAE,CACtB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE;QACL,cAAc,EAAE,MAAM,MAAM,CAAC;QAC7B,cAAc,EAAE,CACf,QAAQ,EAAE,MAAM,EAChB,KAAK,CAAC,EAAE,OAAO,EACf,YAAY,CAAC,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,KACzD,OAAO,CAAC,IAAI,CAAC,CAAC;KACnB,EACD,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,KACzB,OAAO,CAAC,MAAM,CAAC,CAAC;IACrB,cAAc,EAAE,MAAM,MAAM,CAAC;IAC7B,cAAc,EAAE,CACf,QAAQ,EAAE,MAAM,EAChB,KAAK,CAAC,EAAE,OAAO,EACf,YAAY,CAAC,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,KACzD,OAAO,CAAC,IAAI,CAAC,CAAC;CACnB,GAAG,OAAO,CAAC,MAAM,CAAC,CASlB"}

package/dist/lib/storage/named-backup-entry.js

@@ -0,0 +1,7 @@
+export async function exportNamedBackupEntry(params) {
+    return params.exportNamedBackupFile(params.name, {
+        getStoragePath: params.getStoragePath,
+        exportAccounts: params.exportAccounts,
+    }, params.options);
+}
+//# sourceMappingURL=named-backup-entry.js.map

package/dist/lib/storage/named-backup-entry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"named-backup-entry.js","sourceRoot":"","sources":["../../../lib/storage/named-backup-entry.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,MAqB5C;IACA,OAAO,MAAM,CAAC,qBAAqB,CAClC,MAAM,CAAC,IAAI,EACX;QACC,cAAc,EAAE,MAAM,CAAC,cAAc;QACrC,cAAc,EAAE,MAAM,CAAC,cAAc;KACrC,EACD,MAAM,CAAC,OAAO,CACd,CAAC;AACH,CAAC"}

package/dist/lib/storage/named-backups-entry.d.ts

@@ -0,0 +1,19 @@
+import type { NamedBackupSummary } from "../storage.js";
+export declare function getNamedBackupsEntry(params: {
+    getStoragePath: () => string;
+    collectNamedBackups: (storagePath: string, deps: {
+        loadAccountsFromPath: (path: string) => Promise<{
+            normalized: {
+                accounts: unknown[];
+            } | null;
+        }>;
+        logDebug: (message: string, details: Record<string, unknown>) => void;
+    }) => Promise<NamedBackupSummary[]>;
+    loadAccountsFromPath: (path: string) => Promise<{
+        normalized: {
+            accounts: unknown[];
+        } | null;
+    }>;
+    logDebug: (message: string, details: Record<string, unknown>) => void;
+}): Promise<NamedBackupSummary[]>;
+//# sourceMappingURL=named-backups-entry.d.ts.map

package/dist/lib/storage/named-backups-entry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"named-backups-entry.d.ts","sourceRoot":"","sources":["../../../lib/storage/named-backups-entry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAExD,wBAAsB,oBAAoB,CAAC,MAAM,EAAE;IAClD,cAAc,EAAE,MAAM,MAAM,CAAC;IAC7B,mBAAmB,EAAE,CACpB,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE;QACL,oBAAoB,EAAE,CACrB,IAAI,EAAE,MAAM,KACR,OAAO,CAAC;YAAE,UAAU,EAAE;gBAAE,QAAQ,EAAE,OAAO,EAAE,CAAA;aAAE,GAAG,IAAI,CAAA;SAAE,CAAC,CAAC;QAC7D,QAAQ,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;KACtE,KACG,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAAC;IACnC,oBAAoB,EAAE,CACrB,IAAI,EAAE,MAAM,KACR,OAAO,CAAC;QAAE,UAAU,EAAE;YAAE,QAAQ,EAAE,OAAO,EAAE,CAAA;SAAE,GAAG,IAAI,CAAA;KAAE,CAAC,CAAC;IAC7D,QAAQ,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;CACtE,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAKhC"}

package/dist/lib/storage/named-backups-entry.js

@@ -0,0 +1,7 @@
+export async function getNamedBackupsEntry(params) {
+    return params.collectNamedBackups(params.getStoragePath(), {
+        loadAccountsFromPath: params.loadAccountsFromPath,
+        logDebug: params.logDebug,
+    });
+}
+//# sourceMappingURL=named-backups-entry.js.map

package/dist/lib/storage/named-backups-entry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"named-backups-entry.js","sourceRoot":"","sources":["../../../lib/storage/named-backups-entry.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,MAe1C;IACA,OAAO,MAAM,CAAC,mBAAmB,CAAC,MAAM,CAAC,cAAc,EAAE,EAAE;QAC1D,oBAAoB,EAAE,MAAM,CAAC,oBAAoB;QACjD,QAAQ,EAAE,MAAM,CAAC,QAAQ;KACzB,CAAC,CAAC;AACJ,CAAC"}

package/dist/lib/storage/named-backups.d.ts

@@ -0,0 +1,15 @@
+export interface NamedBackupSummary {
+    path: string;
+    fileName: string;
+    accountCount: number;
+    mtimeMs: number;
+}
+export declare function collectNamedBackups(storagePath: string, deps: {
+    loadAccountsFromPath: (path: string) => Promise<{
+        normalized: {
+            accounts: unknown[];
+        } | null;
+    }>;
+    logDebug: (message: string, details: Record<string, unknown>) => void;
+}): Promise<NamedBackupSummary[]>;
+//# sourceMappingURL=named-backups.d.ts.map

package/dist/lib/storage/named-backups.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"named-backups.d.ts","sourceRoot":"","sources":["../../../lib/storage/named-backups.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,kBAAkB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;CAChB;AAED,wBAAsB,mBAAmB,CACxC,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE;IACL,oBAAoB,EAAE,CACrB,IAAI,EAAE,MAAM,KACR,OAAO,CAAC;QAAE,UAAU,EAAE;YAAE,QAAQ,EAAE,OAAO,EAAE,CAAA;SAAE,GAAG,IAAI,CAAA;KAAE,CAAC,CAAC;IAC7D,QAAQ,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;CACtE,GACC,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAiE/B"}

package/dist/lib/storage/named-backups.js

@@ -0,0 +1,68 @@
+import { promises as fs } from "node:fs";
+import { join } from "node:path";
+import { getNamedBackupRoot } from "../named-backup-export.js";
+export async function collectNamedBackups(storagePath, deps) {
+    const backupRoot = getNamedBackupRoot(storagePath);
+    let entries;
+    try {
+        entries = await fs.readdir(backupRoot, {
+            withFileTypes: true,
+            encoding: "utf8",
+        });
+    }
+    catch (error) {
+        const code = error.code;
+        if (code === "ENOENT")
+            return [];
+        throw error;
+    }
+    const candidates = [];
+    for (const entry of entries) {
+        if (!entry.isFile())
+            continue;
+        if (!entry.name.toLowerCase().endsWith(".json"))
+            continue;
+        const candidatePath = join(backupRoot, entry.name);
+        try {
+            const statsBefore = await fs.stat(candidatePath);
+            const { normalized } = await deps.loadAccountsFromPath(candidatePath);
+            if (!normalized || normalized.accounts.length === 0)
+                continue;
+            const statsAfter = await fs.stat(candidatePath).catch(() => null);
+            if (statsAfter && statsAfter.mtimeMs !== statsBefore.mtimeMs) {
+                deps.logDebug("backup file changed between stat and load, mtime may be stale", {
+                    candidatePath,
+                    fileName: entry.name,
+                    beforeMtimeMs: statsBefore.mtimeMs,
+                    afterMtimeMs: statsAfter.mtimeMs,
+                });
+            }
+            candidates.push({
+                path: candidatePath,
+                fileName: entry.name,
+                accountCount: normalized.accounts.length,
+                mtimeMs: statsBefore.mtimeMs,
+            });
+        }
+        catch (error) {
+            deps.logDebug("Skipping named backup candidate after loadAccountsFromPath/fs.stat failure", {
+                candidatePath,
+                fileName: entry.name,
+                error: error instanceof Error
+                    ? {
+                        message: error.message,
+                        stack: error.stack,
+                    }
+                    : String(error),
+            });
+        }
+    }
+    candidates.sort((left, right) => {
+        const mtimeDelta = right.mtimeMs - left.mtimeMs;
+        if (mtimeDelta !== 0)
+            return mtimeDelta;
+        return left.fileName.localeCompare(right.fileName);
+    });
+    return candidates;
+}
+//# sourceMappingURL=named-backups.js.map

package/dist/lib/storage/named-backups.js.map

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

package/dist/lib/storage/path-state.d.ts

@@ -0,0 +1,9 @@
+export type StoragePathState = {
+    currentStoragePath: string | null;
+    currentLegacyProjectStoragePath: string | null;
+    currentLegacyWorktreeStoragePath: string | null;
+    currentProjectRoot: string | null;
+};
+export declare function getStoragePathState(): StoragePathState;
+export declare function setStoragePathState(state: StoragePathState): void;
+//# sourceMappingURL=path-state.d.ts.map

package/dist/lib/storage/path-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-state.d.ts","sourceRoot":"","sources":["../../../lib/storage/path-state.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,gBAAgB,GAAG;IAC9B,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,+BAA+B,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/C,gCAAgC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChD,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;CAClC,CAAC;AAWF,wBAAgB,mBAAmB,IAAI,gBAAgB,CAMtD;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,gBAAgB,GAAG,IAAI,CAGjE"}

package/dist/lib/storage/path-state.js

@@ -0,0 +1,20 @@
+import { AsyncLocalStorage } from "node:async_hooks";
+const storagePathStateContext = new AsyncLocalStorage();
+let currentStorageState = {
+    currentStoragePath: null,
+    currentLegacyProjectStoragePath: null,
+    currentLegacyWorktreeStoragePath: null,
+    currentProjectRoot: null,
+};
+export function getStoragePathState() {
+    // Keep the last synchronously assigned state as a fallback until enterWith()
+    // has propagated through the current async chain. This is intentionally a
+    // best-effort bridge for immediate reads; callers should still set state
+    // before spawning child work and treat AsyncLocalStorage as the source of truth.
+    return storagePathStateContext.getStore() ?? currentStorageState;
+}
+export function setStoragePathState(state) {
+    currentStorageState = state;
+    storagePathStateContext.enterWith(state);
+}
+//# sourceMappingURL=path-state.js.map

package/dist/lib/storage/path-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-state.js","sourceRoot":"","sources":["../../../lib/storage/path-state.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AASrD,MAAM,uBAAuB,GAAG,IAAI,iBAAiB,EAAoB,CAAC;AAE1E,IAAI,mBAAmB,GAAqB;IAC3C,kBAAkB,EAAE,IAAI;IACxB,+BAA+B,EAAE,IAAI;IACrC,gCAAgC,EAAE,IAAI;IACtC,kBAAkB,EAAE,IAAI;CACxB,CAAC;AAEF,MAAM,UAAU,mBAAmB;IAClC,6EAA6E;IAC7E,0EAA0E;IAC1E,yEAAyE;IACzE,iFAAiF;IACjF,OAAO,uBAAuB,CAAC,QAAQ,EAAE,IAAI,mBAAmB,CAAC;AAClE,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,KAAuB;IAC1D,mBAAmB,GAAG,KAAK,CAAC;IAC5B,uBAAuB,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;AAC1C,CAAC"}

package/dist/lib/storage/project-migration.d.ts

@@ -0,0 +1,10 @@
+import type { AccountStorageV3 } from "../storage.js";
+export declare function loadNormalizedStorageFromPath(path: string, label: string, deps: {
+    loadAccountsFromPath: (path: string) => Promise<{
+        normalized: AccountStorageV3 | null;
+        schemaErrors: string[];
+    }>;
+    logWarn: (message: string, details: Record<string, unknown>) => void;
+}): Promise<AccountStorageV3 | null>;
+export declare function mergeStorageForMigration(current: AccountStorageV3 | null, incoming: AccountStorageV3, normalizeAccountStorage: (value: unknown) => AccountStorageV3 | null): AccountStorageV3;
+//# sourceMappingURL=project-migration.d.ts.map

package/dist/lib/storage/project-migration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-migration.d.ts","sourceRoot":"","sources":["../../../lib/storage/project-migration.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEtD,wBAAsB,6BAA6B,CAClD,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,IAAI,EAAE;IACL,oBAAoB,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;QAC/C,UAAU,EAAE,gBAAgB,GAAG,IAAI,CAAC;QACpC,YAAY,EAAE,MAAM,EAAE,CAAC;KACvB,CAAC,CAAC;IACH,OAAO,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;CACrE,GACC,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAoBlC;AAED,wBAAgB,wBAAwB,CACvC,OAAO,EAAE,gBAAgB,GAAG,IAAI,EAChC,QAAQ,EAAE,gBAAgB,EAC1B,uBAAuB,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,gBAAgB,GAAG,IAAI,GAClE,gBAAgB,CAelB"}

package/dist/lib/storage/project-migration.js

@@ -0,0 +1,38 @@
+export async function loadNormalizedStorageFromPath(path, label, deps) {
+    try {
+        const { normalized, schemaErrors } = await deps.loadAccountsFromPath(path);
+        if (schemaErrors.length > 0) {
+            deps.logWarn(`${label} schema validation warnings`, {
+                path,
+                errors: schemaErrors.slice(0, 5),
+            });
+        }
+        return normalized;
+    }
+    catch (error) {
+        const code = error.code;
+        if (code !== "ENOENT") {
+            deps.logWarn(`Failed to load ${label}`, {
+                path,
+                error: String(error),
+            });
+        }
+        return null;
+    }
+}
+export function mergeStorageForMigration(current, incoming, normalizeAccountStorage) {
+    if (!current) {
+        return incoming;
+    }
+    const merged = normalizeAccountStorage({
+        version: 3,
+        activeIndex: current.activeIndex,
+        activeIndexByFamily: current.activeIndexByFamily,
+        accounts: [...current.accounts, ...incoming.accounts],
+    });
+    if (!merged) {
+        return current;
+    }
+    return merged;
+}
+//# sourceMappingURL=project-migration.js.map

package/dist/lib/storage/project-migration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-migration.js","sourceRoot":"","sources":["../../../lib/storage/project-migration.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,KAAK,UAAU,6BAA6B,CAClD,IAAY,EACZ,KAAa,EACb,IAMC;IAED,IAAI,CAAC;QACJ,MAAM,EAAE,UAAU,EAAE,YAAY,EAAE,GAAG,MAAM,IAAI,CAAC,oBAAoB,CAAC,IAAI,CAAC,CAAC;QAC3E,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC7B,IAAI,CAAC,OAAO,CAAC,GAAG,KAAK,6BAA6B,EAAE;gBACnD,IAAI;gBACJ,MAAM,EAAE,YAAY,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;aAChC,CAAC,CAAC;QACJ,CAAC;QACD,OAAO,UAAU,CAAC;IACnB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,MAAM,IAAI,GAAI,KAA+B,CAAC,IAAI,CAAC;QACnD,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;YACvB,IAAI,CAAC,OAAO,CAAC,kBAAkB,KAAK,EAAE,EAAE;gBACvC,IAAI;gBACJ,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC;aACpB,CAAC,CAAC;QACJ,CAAC;QACD,OAAO,IAAI,CAAC;IACb,CAAC;AACF,CAAC;AAED,MAAM,UAAU,wBAAwB,CACvC,OAAgC,EAChC,QAA0B,EAC1B,uBAAoE;IAEpE,IAAI,CAAC,OAAO,EAAE,CAAC;QACd,OAAO,QAAQ,CAAC;IACjB,CAAC;IAED,MAAM,MAAM,GAAG,uBAAuB,CAAC;QACtC,OAAO,EAAE,CAAC;QACV,WAAW,EAAE,OAAO,CAAC,WAAW;QAChC,mBAAmB,EAAE,OAAO,CAAC,mBAAmB;QAChD,QAAQ,EAAE,CAAC,GAAG,OAAO,CAAC,QAAQ,EAAE,GAAG,QAAQ,CAAC,QAAQ,CAAC;KACrD,CAAC,CAAC;IACH,IAAI,CAAC,MAAM,EAAE,CAAC;QACb,OAAO,OAAO,CAAC;IAChB,CAAC;IACD,OAAO,MAAM,CAAC;AACf,CAAC"}

package/dist/lib/storage/record-utils.d.ts

@@ -0,0 +1,3 @@
+export declare function isRecord(value: unknown): value is Record<string, unknown>;
+export declare function clampIndex(index: number, length: number): number;
+//# sourceMappingURL=record-utils.d.ts.map

package/dist/lib/storage/record-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"record-utils.d.ts","sourceRoot":"","sources":["../../../lib/storage/record-utils.ts"],"names":[],"mappings":"AAAA,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEzE;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAGhE"}

package/dist/lib/storage/record-utils.js

@@ -0,0 +1,9 @@
+export function isRecord(value) {
+    return !!value && typeof value === "object" && !Array.isArray(value);
+}
+export function clampIndex(index, length) {
+    if (length <= 0)
+        return 0;
+    return Math.max(0, Math.min(index, length - 1));
+}
+//# sourceMappingURL=record-utils.js.map

package/dist/lib/storage/record-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"record-utils.js","sourceRoot":"","sources":["../../../lib/storage/record-utils.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,QAAQ,CAAC,KAAc;IACtC,OAAO,CAAC,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AACtE,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,KAAa,EAAE,MAAc;IACvD,IAAI,MAAM,IAAI,CAAC;QAAE,OAAO,CAAC,CAAC;IAC1B,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC;AACjD,CAAC"}

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

@@ -0,0 +1,7 @@
+import type { BackupMetadata, RestoreAssessment } from "../storage.js";
+export declare function buildRestoreAssessment(params: {
+    storagePath: string;
+    backupMetadata: BackupMetadata;
+    hasResetMarker: boolean;
+}): RestoreAssessment;
+//# sourceMappingURL=restore-assessment.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"restore-assessment.d.ts","sourceRoot":"","sources":["../../../lib/storage/restore-assessment.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAUvE,wBAAgB,sBAAsB,CAAC,MAAM,EAAE;IAC9C,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,cAAc,CAAC;IAC/B,cAAc,EAAE,OAAO,CAAC;CACxB,GAAG,iBAAiB,CAwCpB"}

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

@@ -0,0 +1,42 @@
+function findLatestSnapshot(backupMetadata) {
+    return backupMetadata.accounts.latestValidPath
+        ? backupMetadata.accounts.snapshots.find((snapshot) => snapshot.path === backupMetadata.accounts.latestValidPath)
+        : undefined;
+}
+export function buildRestoreAssessment(params) {
+    const { storagePath, backupMetadata, hasResetMarker } = params;
+    if (hasResetMarker) {
+        return {
+            storagePath,
+            restoreEligible: false,
+            restoreReason: "intentional-reset",
+            backupMetadata,
+        };
+    }
+    const primarySnapshot = backupMetadata.accounts.snapshots.find((snapshot) => snapshot.kind === "accounts-primary");
+    if (!primarySnapshot?.exists) {
+        return {
+            storagePath,
+            restoreEligible: true,
+            restoreReason: "missing-storage",
+            latestSnapshot: findLatestSnapshot(backupMetadata),
+            backupMetadata,
+        };
+    }
+    if (primarySnapshot.valid && primarySnapshot.accountCount === 0) {
+        return {
+            storagePath,
+            restoreEligible: true,
+            restoreReason: "empty-storage",
+            latestSnapshot: primarySnapshot,
+            backupMetadata,
+        };
+    }
+    return {
+        storagePath,
+        restoreEligible: false,
+        latestSnapshot: findLatestSnapshot(backupMetadata),
+        backupMetadata,
+    };
+}
+//# sourceMappingURL=restore-assessment.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"restore-assessment.js","sourceRoot":"","sources":["../../../lib/storage/restore-assessment.ts"],"names":[],"mappings":"AAEA,SAAS,kBAAkB,CAAC,cAA8B;IACzD,OAAO,cAAc,CAAC,QAAQ,CAAC,eAAe;QAC7C,CAAC,CAAC,cAAc,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,CACtC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,KAAK,cAAc,CAAC,QAAQ,CAAC,eAAe,CACvE;QACF,CAAC,CAAC,SAAS,CAAC;AACd,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,MAItC;IACA,MAAM,EAAE,WAAW,EAAE,cAAc,EAAE,cAAc,EAAE,GAAG,MAAM,CAAC;IAC/D,IAAI,cAAc,EAAE,CAAC;QACpB,OAAO;YACN,WAAW;YACX,eAAe,EAAE,KAAK;YACtB,aAAa,EAAE,mBAAmB;YAClC,cAAc;SACd,CAAC;IACH,CAAC;IAED,MAAM,eAAe,GAAG,cAAc,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,CAC7D,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,KAAK,kBAAkB,CAClD,CAAC;IACF,IAAI,CAAC,eAAe,EAAE,MAAM,EAAE,CAAC;QAC9B,OAAO;YACN,WAAW;YACX,eAAe,EAAE,IAAI;YACrB,aAAa,EAAE,iBAAiB;YAChC,cAAc,EAAE,kBAAkB,CAAC,cAAc,CAAC;YAClD,cAAc;SACd,CAAC;IACH,CAAC;IAED,IAAI,eAAe,CAAC,KAAK,IAAI,eAAe,CAAC,YAAY,KAAK,CAAC,EAAE,CAAC;QACjE,OAAO;YACN,WAAW;YACX,eAAe,EAAE,IAAI;YACrB,aAAa,EAAE,eAAe;YAC9B,cAAc,EAAE,eAAe;YAC/B,cAAc;SACd,CAAC;IACH,CAAC;IAED,OAAO;QACN,WAAW;QACX,eAAe,EAAE,KAAK;QACtB,cAAc,EAAE,kBAAkB,CAAC,cAAc,CAAC;QAClD,cAAc;KACd,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,24 @@
+import type { AccountStorageV3 } from "../storage.js";
+export declare function restoreAccountsFromBackupEntry(params: {
+    path: string;
+    options?: {
+        persist?: boolean;
+    };
+    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>;
+    getNamedBackupRoot: (storagePath: string) => string;
+    getStoragePath: () => string;
+    realpath: (path: string) => Promise<string>;
+    loadAccountsFromPath: (path: string) => Promise<{
+        normalized: AccountStorageV3 | null;
+    }>;
+    saveAccounts: (storage: AccountStorageV3) => Promise<void>;
+}): Promise<AccountStorageV3>;
+//# sourceMappingURL=restore-backup-entry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"restore-backup-entry.d.ts","sourceRoot":"","sources":["../../../lib/storage/restore-backup-entry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEtD,wBAAsB,8BAA8B,CAAC,MAAM,EAAE;IAC5D,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IAChC,6BAA6B,EAAE,CAC9B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE;QACR,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,UAAU,EAAE,MAAM,CAAC;QACnB,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;QAC5C,oBAAoB,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;YAC/C,UAAU,EAAE,gBAAgB,GAAG,IAAI,CAAC;SACpC,CAAC,CAAC;QACH,YAAY,EAAE,CAAC,OAAO,EAAE,gBAAgB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;KAC3D,KACG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAC/B,kBAAkB,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,MAAM,CAAC;IACpD,cAAc,EAAE,MAAM,MAAM,CAAC;IAC7B,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAC5C,oBAAoB,EAAE,CACrB,IAAI,EAAE,MAAM,KACR,OAAO,CAAC;QAAE,UAAU,EAAE,gBAAgB,GAAG,IAAI,CAAA;KAAE,CAAC,CAAC;IACtD,YAAY,EAAE,CAAC,OAAO,EAAE,gBAAgB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3D,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAQ5B"}

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

@@ -0,0 +1,10 @@
+export async function restoreAccountsFromBackupEntry(params) {
+    return params.restoreAccountsFromBackupPath(params.path, {
+        persist: params.options?.persist,
+        backupRoot: params.getNamedBackupRoot(params.getStoragePath()),
+        realpath: params.realpath,
+        loadAccountsFromPath: params.loadAccountsFromPath,
+        saveAccounts: params.saveAccounts,
+    });
+}
+//# sourceMappingURL=restore-backup-entry.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"restore-backup-entry.js","sourceRoot":"","sources":["../../../lib/storage/restore-backup-entry.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,KAAK,UAAU,8BAA8B,CAAC,MAsBpD;IACA,OAAO,MAAM,CAAC,6BAA6B,CAAC,MAAM,CAAC,IAAI,EAAE;QACxD,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,OAAO;QAChC,UAAU,EAAE,MAAM,CAAC,kBAAkB,CAAC,MAAM,CAAC,cAAc,EAAE,CAAC;QAC9D,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,oBAAoB,EAAE,MAAM,CAAC,oBAAoB;QACjD,YAAY,EAAE,MAAM,CAAC,YAAY;KACjC,CAAC,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,10 @@
+import type { AccountStorageV3 } from "../storage.js";
+type RestoreReason = "empty-storage" | "intentional-reset" | "missing-storage";
+type AccountStorageWithMetadata = AccountStorageV3 & {
+    restoreEligible?: boolean;
+    restoreReason?: RestoreReason;
+};
+export declare function createEmptyStorageWithRestoreMetadata(restoreEligible: boolean, restoreReason: RestoreReason): AccountStorageWithMetadata;
+export declare function withRestoreMetadata(storage: AccountStorageV3, restoreEligible: boolean, restoreReason: RestoreReason): AccountStorageWithMetadata;
+export {};
+//# sourceMappingURL=restore-metadata.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"restore-metadata.d.ts","sourceRoot":"","sources":["../../../lib/storage/restore-metadata.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEtD,KAAK,aAAa,GAAG,eAAe,GAAG,mBAAmB,GAAG,iBAAiB,CAAC;AAE/E,KAAK,0BAA0B,GAAG,gBAAgB,GAAG;IACpD,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,aAAa,CAAC,EAAE,aAAa,CAAC;CAC9B,CAAC;AAEF,wBAAgB,qCAAqC,CACpD,eAAe,EAAE,OAAO,EACxB,aAAa,EAAE,aAAa,GAC1B,0BAA0B,CAS5B;AAED,wBAAgB,mBAAmB,CAClC,OAAO,EAAE,gBAAgB,EACzB,eAAe,EAAE,OAAO,EACxB,aAAa,EAAE,aAAa,GAC1B,0BAA0B,CAM5B"}

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

@@ -0,0 +1,18 @@
+export function createEmptyStorageWithRestoreMetadata(restoreEligible, restoreReason) {
+    return {
+        version: 3,
+        accounts: [],
+        activeIndex: 0,
+        activeIndexByFamily: {},
+        restoreEligible,
+        restoreReason,
+    };
+}
+export function withRestoreMetadata(storage, restoreEligible, restoreReason) {
+    return {
+        ...storage,
+        restoreEligible,
+        restoreReason,
+    };
+}
+//# sourceMappingURL=restore-metadata.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"restore-metadata.js","sourceRoot":"","sources":["../../../lib/storage/restore-metadata.ts"],"names":[],"mappings":"AASA,MAAM,UAAU,qCAAqC,CACpD,eAAwB,EACxB,aAA4B;IAE5B,OAAO;QACN,OAAO,EAAE,CAAC;QACV,QAAQ,EAAE,EAAE;QACZ,WAAW,EAAE,CAAC;QACd,mBAAmB,EAAE,EAAE;QACvB,eAAe;QACf,aAAa;KACb,CAAC;AACH,CAAC;AAED,MAAM,UAAU,mBAAmB,CAClC,OAAyB,EACzB,eAAwB,EACxB,aAA4B;IAE5B,OAAO;QACN,GAAG,OAAO;QACV,eAAe;QACf,aAAa;KACb,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,14 @@
+import type { AccountStorageV3 } from "../storage.js";
+export interface RestoreAccountsFromBackupDeps {
+    realpath: typeof import("node:fs").promises.realpath;
+    getNamedBackupRoot: (storagePath: string) => string;
+    getStoragePath: () => string;
+    loadAccountsFromPath: (path: string) => Promise<{
+        normalized: AccountStorageV3 | null;
+    }>;
+    saveAccounts: (storage: AccountStorageV3) => Promise<void>;
+}
+export declare function restoreAccountsFromBackupFile(path: string, deps: RestoreAccountsFromBackupDeps, options?: {
+    persist?: boolean;
+}): Promise<AccountStorageV3>;
+//# sourceMappingURL=restore.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"restore.d.ts","sourceRoot":"","sources":["../../../lib/storage/restore.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEtD,MAAM,WAAW,6BAA6B;IAC7C,QAAQ,EAAE,cAAc,SAAS,EAAE,QAAQ,CAAC,QAAQ,CAAC;IACrD,kBAAkB,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,MAAM,CAAC;IACpD,cAAc,EAAE,MAAM,MAAM,CAAC;IAC7B,oBAAoB,EAAE,CACrB,IAAI,EAAE,MAAM,KACR,OAAO,CAAC;QAAE,UAAU,EAAE,gBAAgB,GAAG,IAAI,CAAA;KAAE,CAAC,CAAC;IACtD,YAAY,EAAE,CAAC,OAAO,EAAE,gBAAgB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3D;AAED,wBAAsB,6BAA6B,CAClD,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,6BAA6B,EACnC,OAAO,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,GAC7B,OAAO,CAAC,gBAAgB,CAAC,CAqD3B"}