/**
 * Full-store snapshots taken before an in-place repair or migration of the
 * project `cleo.db`.
 *
 * The repairs that run while a domain binds (the T12346 legacy-lineage
 * rebuild, the T12535 twin collapses) are synchronous and run before any
 * caller sees the handle, so they cannot use the async, debounced snapshot
 * gate (`snapshot-gate.ts`): a `routine` request inside the debounce window
 * would be skipped, and a skipped snapshot is exactly the case a repair must
 * never proceed under. They take one unconditional `VACUUM INTO` instead,
 * the same primitive the gate's snapshots use.
 *
 * {@link writeMigrationSnapshot} additionally registers the snapshot as a
 * `migration` system backup (`.cleo/backups/sqlite/cleo.db.<backupId>` plus a
 * `<backupId>.meta.json` sidecar), so `cleo backup list` shows it and the
 * per-type rotation applies, and checks the free space BEFORE writing: the
 * snapshot costs the whole store.
 *
 * @module
 * @task T12346
 * @task T12535
 */
import type { DatabaseSync } from 'node:sqlite';
/**
 * Write a `VACUUM INTO` snapshot of the whole database next to it, under
 * `<dir of dbPath>/backups/cleo-pre-<label>-<timestamp>.db`.
 *
 * Throws when the snapshot cannot be written, so the caller never repairs
 * without it. Must run outside a transaction (`VACUUM INTO` requires it).
 *
 * @param nativeDb - Connection on the database to snapshot.
 * @param dbPath - Path of that database file (locates the backup directory).
 * @param label - Short kebab-case tag naming the repair.
 * @returns The snapshot's absolute path.
 * @task T12346
 */
export declare function writePreRepairSnapshot(nativeDb: DatabaseSync, dbPath: string, label: string): string;
/** Where a migration snapshot goes and what it costs. */
export interface MigrationSnapshotPlan {
    /** `.cleo/backups/sqlite/` of the store. */
    readonly backupDir: string;
    /** System-backup id (`migration-YYYYMMDD-HHmmss[-n]`). */
    readonly backupId: string;
    /** Absolute path the snapshot file will have. */
    readonly snapshotPath: string;
    /** Bytes the snapshot needs, plus headroom. */
    readonly requiredBytes: number;
    /** Bytes free on the backup filesystem, or `null` when it cannot be measured. */
    readonly availableBytes: number | null;
}
/**
 * Plan a migration snapshot without writing anything: its path and id, the
 * space it needs (live pages × page size, plus headroom) and the space free.
 *
 * @param nativeDb - Connection on the store.
 * @param dbPath - Path of the store file.
 * @returns The plan.
 * @task T12535
 */
export declare function planMigrationSnapshot(nativeDb: DatabaseSync, dbPath: string): MigrationSnapshotPlan;
/**
 * Take a planned migration snapshot: check the space, create the backup
 * directory, `VACUUM INTO` the snapshot, write its sidecar, rotate the
 * `migration` type.
 *
 * Throws, before writing anything, when the free space is below
 * {@link MigrationSnapshotPlan.requiredBytes} or the backup directory cannot
 * be created. Must run outside a transaction.
 *
 * @param nativeDb - Connection on the store.
 * @param plan - From {@link planMigrationSnapshot}.
 * @param note - Shown by `cleo backup list`.
 * @param options - `pinnedReason`: pin the snapshot (never rotated) and say why.
 * @returns The snapshot's absolute path.
 * @task T12535
 */
export declare function writeMigrationSnapshot(nativeDb: DatabaseSync, plan: MigrationSnapshotPlan, note: string, options?: {
    readonly pinnedReason?: string;
}): string;
//# sourceMappingURL=pre-repair-snapshot.d.ts.map