@wirecat/cli-core 0.593.0 → 0.595.0

package/dist/store/migrations.js

@@ -1,12 +1,14 @@
 import { CliError } from "@wirecat/cli-base";
 import { lockedOutNotice, recordClient, refusalAdvice, storeClients } from "./sqlite/clients.js";
 import { generatedMigrations } from "./sqlite/manifest.js";
+import { discardRollbackCopy, recordRollbackCopy, takeRollbackCopy, } from "./sqlite/rollback-copy.js";
 /**
  * Every migration is generated by drizzle-kit and numbered in `sqlite/manifest.ts`. Version 1 creates the whole
  * schema. **A migration that has reached anyone's file is never edited.** After it: forward-only and additive —
  * no `DROP` and no rebuild of a base table, a new column is nullable or has a default, and every `INSERT` in the
  * store names its columns — so an older `tg` keeps writing to a file a newer `max` has migrated. Only a breaking
- * change raises `minCompatible`, and that is a major version of this package. The search indexes are derived and
+ * change raises `minCompatible`, and that is a major version of this package; it names the base tables it changes
+ * (`tables`), which are copied aside before it runs (`sqlite/rollback-copy.ts`). The search indexes are derived and
  * may be dropped and rebuilt. Every version after the first gets a `version-N.test.ts` that opens a file at N-1.
  *
  * Times are epoch milliseconds: an integer sorts and ranges without a format to agree on.
@@ -31,18 +33,44 @@ const fileState = (database) => {
         .get();
     return { version: Number(row?.version ?? 0), minCompatible: Number(row?.min_compatible ?? 0) };
 };
+/** The tables every pending migration that raises `minCompatible` names; none for a new file or a foreign one. */
+const copyBeforeBreaking = (database, migrations, { ownTable, now }, options) => {
+    if (!hasTable(database, "schema_migrations"))
+        return undefined;
+    const file = fileState(database);
+    if (file.version === 0 || (ownTable !== null && !hasTable(database, ownTable)))
+        return undefined;
+    let floor = file.minCompatible;
+    const tables = [];
+    for (const migration of migrations) {
+        if (migration.version <= file.version || migration.minCompatible <= floor)
+            continue;
+        floor = migration.minCompatible;
+        for (const table of migration.tables ?? [])
+            tables.push(table);
+    }
+    if (floor === file.minCompatible)
+        return undefined;
+    return takeRollbackCopy(database, { from: file.version, to: latest(migrations), tables, at: now() }, options);
+};
 /**
  * Brings the file up to this version, or opens a newer one it can still write to, or refuses.
  * Inside `BEGIN IMMEDIATE`, so two processes opening an old file at once migrate it once. A migration
  * that fails names `store reset` when the app has one: without it the owner is stuck until a build that can migrate
  * the file. An app without that command (drive) passes no `command`, and the advice names none.
  */
-export const migrate = (database, { migrations = MIGRATIONS, now = Date.now, command, version, ownTable = OWN_TABLE, } = {}) => {
+export const migrate = (database, { migrations = MIGRATIONS, now = Date.now, command, version, ownTable = OWN_TABLE, rollback, } = {}) => {
     const ours = latest(migrations);
+    let copy = rollback ? copyBeforeBreaking(database, migrations, { ownTable, now }, rollback) : undefined;
     database.exec("BEGIN IMMEDIATE");
     try {
         database.exec(HISTORY);
         const file = fileState(database);
+        // Another process migrated the file between the copy and this transaction, and took its own.
+        if (copy && copy.from !== file.version) {
+            discardRollbackCopy(copy);
+            copy = undefined;
+        }
         if (file.version > 0 && ownTable !== null && !hasTable(database, ownTable)) {
             throw new CliError("configuration_error", `the message store was written by another, incompatible tool (schema ${file.version} by its own numbering, ` +
                 "with no meetings table) — this tool will not open or change it; move it aside to start a new store");
@@ -73,6 +101,8 @@ export const migrate = (database, { migrations = MIGRATIONS, now = Date.now, com
         }
         if (command && version)
             recordClient(database, { command, version, speaks: ours }, now());
+        if (copy)
+            recordRollbackCopy(database, copy, now());
         database.exec("COMMIT");
         return notice;
     }

package/dist/store/sqlite/crm.d.ts

@@ -6,7 +6,7 @@ import type { StoreContext } from "./open.js";
 /** What the store could not keep, and why: an item whose stage is not stored or whose field it refuses, or a pipeline. */
 export interface CrmSkipped {
     externalId: string;
-    reason: "crm.stage-unknown" | "crm.item-invalid" | "crm.pipeline-clash";
+    reason: "crm.stage-unknown" | "crm.item-invalid";
     message: string;
 }
 export interface CrmSaved {
@@ -39,6 +39,8 @@ export interface CrmCopies {
     }): Promise<number>;
     /** How many of the kind the account holds, not deleted; every contact it ever saved. */
     count(key: AccountKey, kind: CrmKind): Promise<number>;
+    /** The stored copy's `deal:<id>` or `lead:<id>`, deleted or not; `null` when the store holds none. */
+    refOf(key: AccountKey, kind: DealKind, externalId: string): Promise<string | null>;
 }
 /**
  * A contact's identity id: identities are unique per provider, and two portals of one CRM both have a contact 5.

package/dist/store/sqlite/crm.js

@@ -36,24 +36,14 @@ export const crmCopiesOver = (context, people) => {
     const pipelineOf = (accountId, kind, externalId) => database
         .prepare("SELECT * FROM pipelines WHERE account_id = ? AND kind = ? AND external_id = ?")
         .get(accountId, kind, externalId);
-    // Store version 52 keeps a pipeline's id unique per account, not per kind: a lead pipeline sharing a deal pipeline's
-    // id cannot be stored until a migration widens that key, so it is skipped and named, not written over the other.
-    const otherKindHolds = (accountId, kind, externalId) => database
-        .prepare("SELECT 1 FROM pipelines WHERE account_id = ? AND kind <> ? AND external_id = ?")
-        .get(accountId, kind, externalId) !== undefined;
+    /**
+     * One kind's whole list: a pipeline it lacks is marked deleted, one listed again comes back. An empty list marks
+     * nothing: a sign-in that lost its CRM rights lists no pipeline at all.
+     */
     const savePipelines = (key, kind, pipelines) => write(database, () => {
         const accountId = account(key);
         const at = now();
-        const skipped = [];
         for (const pipeline of pipelines) {
-            if (otherKindHolds(accountId, kind, pipeline.externalId)) {
-                skipped.push({
-                    externalId: pipeline.externalId,
-                    reason: "crm.pipeline-clash",
-                    message: `${kind} pipeline ${pipeline.externalId} has the id of a stored pipeline of the other kind`,
-                });
-                continue;
-            }
             const name = textOf(pipeline.name, 80) ?? pipeline.externalId;
             const held = pipelineOf(accountId, kind, pipeline.externalId);
             const id = held
@@ -62,13 +52,22 @@ export const crmCopiesOver = (context, people) => {
                     .prepare("INSERT INTO pipelines (account_id, external_id, kind, name, name_folded, created_at, updated_at) " +
                     "VALUES (?, ?, ?, ?, ?, ?, ?) RETURNING id")
                     .get(accountId, pipeline.externalId, kind, name, fold(name), at, at)?.id);
-            if (held && held.name !== name)
+            if (held && (held.name !== name || held.deleted_at != null))
                 database
-                    .prepare("UPDATE pipelines SET name = ?, name_folded = ?, updated_at = ? WHERE id = ?")
+                    .prepare("UPDATE pipelines SET name = ?, name_folded = ?, updated_at = ?, deleted_at = NULL WHERE id = ?")
                     .run(name, fold(name), at, id);
             saveStages(id, pipeline, at);
         }
-        return { saved: pipelines.length - skipped.length, skipped };
+        if (pipelines.length === 0)
+            return { saved: 0, skipped: [] };
+        const listed = new Set(pipelines.map(({ externalId }) => externalId));
+        const mark = database.prepare("UPDATE pipelines SET deleted_at = ?, updated_at = ? WHERE id = ?");
+        for (const row of database
+            .prepare("SELECT id, external_id FROM pipelines WHERE account_id = ? AND kind = ? AND deleted_at IS NULL")
+            .all(accountId, kind))
+            if (!listed.has(String(row.external_id)))
+                mark.run(at, at, Number(row.id));
+        return { saved: pipelines.length, skipped: [] };
     });
     /**
      * Stage names are unique in a pipeline, but a CRM may swap two, or give two stages one name: listed stages first
@@ -90,18 +89,23 @@ export const crmCopiesOver = (context, people) => {
         const listed = new Set(wanted.map(({ externalId }) => externalId));
         const taken = new Set(wanted.map(({ folded }) => folded));
         const rename = database.prepare("UPDATE pipeline_stages SET name_folded = ? WHERE id = ?");
+        const gone = database.prepare("UPDATE pipeline_stages SET deleted_at = ? WHERE id = ? AND deleted_at IS NULL");
         for (const row of held) {
-            if (row.external_id != null && listed.has(String(row.external_id)))
+            const kept = row.external_id != null && listed.has(String(row.external_id));
+            if (kept)
                 rename.run(`\u0000${row.id}`, Number(row.id));
             else if (taken.has(String(row.name_folded)))
                 rename.run(`${row.name_folded} (${row.external_id ?? row.id})`, Number(row.id));
+            if (!kept)
+                gone.run(at, Number(row.id));
         }
         const byId = new Map(held.map((row) => [String(row.external_id), row]));
         for (const stage of wanted) {
             const row = byId.get(stage.externalId);
             if (row)
                 database
-                    .prepare("UPDATE pipeline_stages SET name = ?, name_folded = ?, position = ?, outcome = ?, updated_at = ? WHERE id = ?")
+                    .prepare("UPDATE pipeline_stages SET name = ?, name_folded = ?, position = ?, outcome = ?, updated_at = ?, " +
+                    "deleted_at = NULL WHERE id = ?")
                     .run(stage.name, stage.folded, stage.position, stage.outcome, at, Number(row.id));
             else
                 database
@@ -151,7 +155,11 @@ export const crmCopiesOver = (context, people) => {
         const deal = kind === "lead" && item.deal
             ? database.prepare("SELECT id FROM deals WHERE account_id = ? AND external_id = ?").get(accountId, item.deal)
             : undefined;
-        const metadata = { ...(item.metadata ?? {}), ...(item.url ? { url: item.url } : {}) };
+        const metadata = {
+            ...(item.metadata ?? {}),
+            ...(item.url ? { url: item.url } : {}),
+            ...(item.closedReason && status !== "open" ? { closed_reason: textOf(item.closedReason, 2000) } : {}),
+        };
         const values = {
             title,
             organization: item.organization ? organizationIdOf(accountId, item.organization) : null,
@@ -314,5 +322,14 @@ export const crmCopiesOver = (context, people) => {
                 .prepare("SELECT count(*) AS n FROM identities WHERE provider = ? AND substr(external_id, 1, ?) = ?")
                 .get(key.provider, key.account.length + 1, `${key.account}/`)?.n)
             : stored(key, kind).length,
+        refOf: async (key, kind, externalId) => {
+            const accountId = findAccountPk(context, key);
+            const row = accountId === undefined
+                ? undefined
+                : database
+                    .prepare(`SELECT id FROM ${TABLES[kind]} WHERE account_id = ? AND external_id = ?`)
+                    .get(accountId, externalId);
+            return row ? `${kind}:${row.id}` : null;
+        },
     };
 };

package/dist/store/sqlite/deals.js

@@ -94,9 +94,11 @@ export const dealOperationsOver = (context) => {
             ? row.account_id == null
             : row.account_provider === scope.provider && row.account_external_id === scope.account);
     const kindOf = (kind) => (kind === undefined ? "deal" : oneOf(kind, DEAL_KINDS, "a kind"));
-    const pipelineRows = (kind, scope) => database
+    /** A pipeline the CRM deleted is left out, unless named by its reference: its deals still stand in it. */
+    const pipelineRows = (kind, scope, { deleted = false } = {}) => database
         .prepare("SELECT p.*, a.provider AS account_provider, a.external_id AS account_external_id FROM pipelines p " +
-        "LEFT JOIN accounts a ON a.id = p.account_id WHERE (? IS NULL OR p.kind = ?) ORDER BY p.name_folded, p.id")
+        "LEFT JOIN accounts a ON a.id = p.account_id WHERE (? IS NULL OR p.kind = ?) " +
+        `${deleted ? "" : "AND p.deleted_at IS NULL "}ORDER BY p.name_folded, p.id`)
         .all(kind ?? null, kind ?? null)
         .filter((row) => inScope(scope, row));
     const label = (row) => `pipeline:${row.id} (${row.name}${row.account_provider == null ? "" : `, ${row.account_provider}:${row.account_external_id}`})`;
@@ -104,7 +106,7 @@ export const dealOperationsOver = (context) => {
     const pipelineRow = (reference, kind, scope) => {
         const named = reference.trim();
         if (/^pipeline:\d+$/.test(named)) {
-            const row = pipelineRows(kind, scope).find((one) => `pipeline:${one.id}` === named);
+            const row = pipelineRows(kind, scope, { deleted: true }).find((one) => `pipeline:${one.id}` === named);
             if (!row)
                 throw new CliError("not_found", `no ${kind ?? ""} pipeline ${named}`, { reason: "pipeline.not-found" });
             return row;
@@ -267,7 +269,7 @@ export const dealOperationsOver = (context) => {
                 });
                 return made;
             });
-            return pipelinesOf(pipelineRows(pipelineKind).filter((row) => Number(row.id) === id))[0];
+            return pipelinesOf(pipelineRows(pipelineKind, undefined, { deleted: true }).filter((row) => Number(row.id) === id))[0];
         },
         pipelines: (filter = {}) => pipelinesOf(pipelineRows(filter.kind === undefined ? undefined : kindOf(filter.kind), filter.account)),
         pipeline: (reference, options = {}) => {

package/dist/store/sqlite/email-activity.d.ts

@@ -54,6 +54,10 @@ export interface MarkedEmail {
     changedAt: number;
     /** Sent to many: the bulk mailbox or a List-Id. */
     bulk: boolean;
+    /** Its own List-Id: a real mailing list, as opposed to List-Unsubscribe or Precedence alone. */
+    listed: boolean;
+    subject: string | null;
+    from: string | null;
     envelope: boolean;
     /** Stored from its first bytes, not whole yet. */
     partial: boolean;

package/dist/store/sqlite/email-activity.js

@@ -100,7 +100,8 @@ export const writtenTo = (database, addresses) => {
 };
 const MARKED = `
   SELECT e.id, e.external_id, t.external_id AS thread, coalesce(e.received_at, e.sent_at) AS at, e.created_at,
-    e.updated_at, coalesce(e.draft, 0) AS draft, json_extract(e.metadata, '$.partial') IS NOT NULL AS partial,
+    e.updated_at, e.subject, e.from_address, coalesce(e.draft, 0) AS draft,
+    coalesce(json_extract(e.headers, '$."list-id"'), json_extract(e.metadata, '$.listId')) IS NOT NULL AS listed, json_extract(e.metadata, '$.partial') IS NOT NULL AS partial,
     coalesce(json_extract(e.headers, '$."list-id"'), json_extract(e.metadata, '$.listId')) IS NOT NULL
       OR EXISTS (SELECT 1 FROM email_mailboxes m JOIN mailboxes b ON b.id = m.mailbox_id
         WHERE m.email_id = e.id AND b.kind = 'bulk') AS bulk,
@@ -117,6 +118,9 @@ const markedOf = (row) => ({
     storedAt: Number(row.created_at),
     changedAt: Number(row.updated_at),
     bulk: Boolean(row.bulk),
+    listed: Boolean(row.listed),
+    subject: row.subject === null || row.subject === undefined ? null : String(row.subject),
+    from: row.from_address === null || row.from_address === undefined ? null : String(row.from_address),
     envelope: Boolean(row.envelope),
     partial: Boolean(row.partial),
     draft: Boolean(row.draft),

package/dist/store/sqlite/manifest.d.ts

@@ -11,6 +11,8 @@ export interface ManifestEntry {
     name: string;
     version: number;
     minCompatible: number;
+    /** Required on a version that raises `minCompatible`: the base tables it changes (`Migration.tables`). */
+    tables?: string[];
 }
 /** One migration creates the whole schema; every later one is added as the next version. */
 export declare const MANIFEST: ManifestEntry[];

package/dist/store/sqlite/manifest.js

@@ -1,4 +1,33 @@
 import { GENERATED } from "./migrations.generated.js";
+import { isDerivedTable } from "./rollback-copy.js";
+const V31_TABLES = [
+    "accounts",
+    "account_identities",
+    "agent_actions",
+    "aliases",
+    "attachments",
+    "bot_updates",
+    "chats",
+    "documents",
+    "email_threads",
+    "emails",
+    "facts",
+    "links",
+    "mail_rules",
+    "mailboxes",
+    "meeting_series",
+    "meetings",
+    "memories",
+    "messages",
+    "notes",
+    "projects",
+    "proposed_actions",
+    "reminders",
+    "store_settings",
+    "sync_cursors",
+    "syncs",
+    "taggings",
+];
 /** One migration creates the whole schema; every later one is added as the next version. */
 export const MANIFEST = [
     { name: "20261010184427_initial", version: 1, minCompatible: 1 },
@@ -36,14 +65,24 @@ export const MANIFEST = [
     { name: "20261021224625_version-28-chat-state", version: 28, minCompatible: 1 },
     { name: "20261023105057_version-29-transcript-words", version: 29, minCompatible: 1 },
     { name: "20261023105101_version-29-transcript-words-triggers", version: 29, minCompatible: 1 },
-    { name: "20261025064253_version-30-reviewed-tag-consolidation", version: 30, minCompatible: 30 },
+    {
+        name: "20261025064253_version-30-reviewed-tag-consolidation",
+        version: 30,
+        minCompatible: 30,
+        tables: ["tags", "auto_tag_claims"],
+    },
     { name: "20261025064302_version-30-resolved-tag-view", version: 30, minCompatible: 30 },
-    { name: "20261025070402_version-31-drive-account", version: 31, minCompatible: 31 },
-    { name: "20261025071848_version-32-files", version: 32, minCompatible: 32 },
+    { name: "20261025070402_version-31-drive-account", version: 31, minCompatible: 31, tables: V31_TABLES },
+    {
+        name: "20261025071848_version-32-files",
+        version: 32,
+        minCompatible: 32,
+        tables: ["accounts", "documents", "identities", "store_settings"],
+    },
     { name: "20261025071850_version-32-files-data", version: 32, minCompatible: 32 },
     { name: "20261025072643_version-33-calendars", version: 33, minCompatible: 32 },
     { name: "20261025072644_version-33-calendars-triggers", version: 33, minCompatible: 32 },
-    { name: "20261025182500_version-34-vector-index", version: 34, minCompatible: 34 },
+    { name: "20261025182500_version-34-vector-index", version: 34, minCompatible: 34, tables: [] },
     { name: "20261025182501_version-34-vector-index-triggers", version: 34, minCompatible: 34 },
     { name: "20261027102259_version-35-calendar-neutral", version: 35, minCompatible: 34 },
     { name: "20261027102302_version-35-calendar-neutral-data", version: 35, minCompatible: 34 },
@@ -70,6 +109,7 @@ export const MANIFEST = [
     { name: "20261105144549_version-51-task-links", version: 51, minCompatible: 34 },
     { name: "20261106010504_version-52-deals", version: 52, minCompatible: 34 },
     { name: "20261106010507_version-52-deals-rules", version: 52, minCompatible: 34 },
+    { name: "20261106165009_version-53-crm-pipelines", version: 53, minCompatible: 34 },
 ];
 export const generatedMigrations = (manifest = MANIFEST, generated = GENERATED) => {
     const migrations = [];
@@ -82,12 +122,25 @@ export const generatedMigrations = (manifest = MANIFEST, generated = GENERATED)
         const last = migrations.at(-1);
         if (last && last.version !== entry.version && entry.minCompatible < last.minCompatible)
             throw new Error("migration minCompatible cannot decrease");
+        const derived = entry.tables?.filter(isDerivedTable) ?? [];
+        if (derived.length > 0)
+            throw new Error(`migration ${entry.version} names derived tables (${derived.join(", ")}); they are rebuilt, never copied`);
         if (last?.version !== entry.version) {
-            migrations.push({ version: entry.version, minCompatible: entry.minCompatible, statements: [...found.statements] });
+            if (last && entry.minCompatible > last.minCompatible && entry.tables === undefined)
+                throw new Error(`migration ${entry.version} raises minCompatible, so it names the base tables it changes (tables)`);
+            migrations.push({
+                version: entry.version,
+                minCompatible: entry.minCompatible,
+                statements: [...found.statements],
+                ...(entry.tables ? { tables: [...entry.tables] } : {}),
+            });
         }
         else if (last.minCompatible !== entry.minCompatible) {
             throw new Error(`the rows of version ${entry.version} disagree on minCompatible`);
         }
+        else if (entry.tables && JSON.stringify(entry.tables) !== JSON.stringify(last.tables)) {
+            throw new Error(`the rows of version ${entry.version} disagree on tables`);
+        }
         else {
             last.statements.push(...found.statements);
         }

package/dist/store/sqlite/migrations.generated.js

@@ -1033,5 +1033,14 @@ export const GENERATED = [
             "-- The default lead pipeline, so a lead can be recorded before the owner or an agent makes one.\nINSERT INTO pipelines (kind, name, name_folded, created_at, updated_at)\n  VALUES ('lead', 'Leads', 'leads', CAST(strftime('%s', 'now') AS INTEGER) * 1000, CAST(strftime('%s', 'now') AS INTEGER) * 1000);",
             "INSERT INTO pipeline_stages (pipeline_id, name, name_folded, position, outcome, created_at, updated_at)\n  SELECT p.id, v.name, v.name, v.position, v.outcome, p.created_at, p.created_at FROM pipelines p,\n    (SELECT 'new' AS name, 1 AS position, 'open' AS outcome UNION ALL SELECT 'contacted', 2, 'open'\n      UNION ALL SELECT 'qualified', 3, 'open' UNION ALL SELECT 'won', 4, 'won' UNION ALL SELECT 'lost', 5, 'lost') v\n  WHERE p.kind = 'lead' AND p.name_folded = 'leads' AND p.account_id IS NULL;"
         ]
+    },
+    {
+        "name": "20261106165009_version-53-crm-pipelines",
+        "statements": [
+            "ALTER TABLE `pipeline_stages` ADD `deleted_at` integer;",
+            "ALTER TABLE `pipelines` ADD `deleted_at` integer;",
+            "DROP INDEX IF EXISTS `pipelines_by_account_id_external_id`;",
+            "CREATE UNIQUE INDEX `pipelines_by_account_id_kind_external_id` ON `pipelines` (`account_id`,`kind`,`external_id`) WHERE account_id IS NOT NULL AND external_id IS NOT NULL;"
+        ]
     }
 ];

package/dist/store/sqlite/open-store.js

@@ -15,6 +15,7 @@ import { openSqlite } from "./open.js";
 import { movePaymentFacts } from "./payment-facts.js";
 import { loadProviders } from "./providers.js";
 import { assertReadCompatible } from "./read-compatibility.js";
+import { pruneRollbackCopies } from "./rollback-copy.js";
 import { stemsState } from "./stems.js";
 import { fillStems, followDefaultStemmers } from "./stems-fill.js";
 import { moveSuggestedLinks } from "./suggested-links.js";
@@ -53,9 +54,15 @@ export const openStoreContext = async ({ path, env, now = Date.now, command, ver
         if (readOnly)
             assertReadCompatible(database, command);
         else {
-            const notice = migrate(database, { now, command, ...(version ? { version } : {}) });
+            const notice = migrate(database, {
+                now,
+                command,
+                ...(version ? { version } : {}),
+                rollback: { store: file, warn },
+            });
             if (notice)
                 warn(notice);
+            pruneRollbackCopies(database, now());
             fillFiles(database, now);
             fillFolded(database);
             fillJoinKeys(database);

package/dist/store/sqlite/rollback-copy.d.ts

@@ -0,0 +1,49 @@
+import type { CacheDatabase } from "../driver.js";
+export declare const isDerivedTable: (name: string) => boolean;
+export interface RollbackCopyOptions {
+    /** The store's own path: the copy goes in `backups/` beside it. */
+    store: string;
+    freeBytes?: (dir: string) => number;
+    warn?: (line: string) => void;
+}
+export interface RollbackCopy {
+    path: string;
+    from: number;
+    to: number;
+}
+/**
+ * Outside the migration's transaction (SQLite cannot attach inside one), committed on its own, so a migration that
+ * fails leaves it whole. Never blocks the migration: no room, or any failure, is a warning and no copy.
+ */
+export declare const takeRollbackCopy: (database: CacheDatabase, { from, to, tables, at }: {
+    from: number;
+    to: number;
+    tables: string[];
+    at: number;
+}, { store, freeBytes, warn }: RollbackCopyOptions) => RollbackCopy | undefined;
+/** Inside the migration's transaction: a migration that fails never records its copy, so cleanup never takes it. */
+export declare const recordRollbackCopy: (database: CacheDatabase, copy: RollbackCopy, at: number) => void;
+export declare const discardRollbackCopy: (copy: RollbackCopy) => void;
+/**
+ * The day after: a copy recorded by a migration that committed, once the store is still at that version. Only the
+ * recorded file is deleted, never anything else in `backups/`.
+ */
+export declare const pruneRollbackCopies: (database: CacheDatabase, now: number) => void;
+export interface RollbackCopyMeta {
+    from: number;
+    to: number;
+    tables: string[];
+    createdAt: number;
+}
+export interface RollbackResult extends RollbackCopyMeta {
+    /** The schema the store was at before the rollback. */
+    was: number;
+    restored: {
+        table: string;
+        rows: number;
+    }[];
+    rebuilt: string[];
+    foreignKeyViolations: number;
+}
+/** Puts a rollback copy back into the store, in place. The caller makes sure nothing else has the store open. */
+export declare const rollBack: (database: CacheDatabase, path: string) => RollbackResult;