@voltro/database 0.69.0 → 0.70.0

package/dist/sql.d.ts

@@ -1754,6 +1754,27 @@ export declare interface MigrationPlan {
     readonly fromFingerprint: string;
     /** Post-state fingerprint (what the DB will look like after apply). */
     readonly toFingerprint: string;
+    /**
+     * Where the two fingerprints part when the plan is EMPTY. `fromFingerprint`
+     * hashes the whole live introspection; `toFingerprint` hashes the declaration;
+     * a plan of zero operations says the schemas agree — and the hashes can still
+     * differ. Then this names the tables on which they do:
+     *
+     *   `outsideDiff` — live tables the diff never compares: framework-owned
+     *   (`cluster_*`, an undeclared `_voltro_*`), soft-drop snapshots, a name in
+     *   `VOLTRO_DB_IGNORE_TABLES`, the old name of a rename. In the live hash, in
+     *   no declaration.
+     *   `diffEquivalent` — tables on both sides the diff planned nothing for whose
+     *   live and declared snapshots hash apart anyway: a detail introspection
+     *   reports differently from how it was declared.
+     *
+     * Both empty means the hashes agree table for table. A reader who meets two
+     * different hashes over `0 operations` is otherwise left to guess what moved.
+     */
+    readonly fingerprintDivergence: {
+        readonly outsideDiff: ReadonlyArray<string>;
+        readonly diffEquivalent: ReadonlyArray<string>;
+    };
     /** Count summaries by class — what `voltro db plan` prints. */
     readonly summary: {
         readonly safe: number;