fix(db): let the move to Postgres change nothing silently

The move stripped NUL from a plugin's own text, merging keys that were
distinct, and turned a plugin's values into another type (text in a BLOB
column into bytea, numbers in an untyped column into text). Its checksum
was built from the converted values, so both passed as verified.

A plugin's data now moves exactly as the Postgres plugin store would
hand it back, or not at all: a NUL, a value of another storage class
than its column, or an integer past 2^53 refuses the move before
anything is written, listing plugin, table, row and column. A column
left open by SQLite's affinity takes the kind its values need, so text
in a BLOB column stays text.

TREK's own text holding a NUL from an older install is refused by
default too. --drop-nul drops it, lists every changed value in the
summary, and names a unique key that dropping a NUL broke.

Every table's checksum is now built from the values read from SQLite,
so a conversion that changes a value fails the verification.
This commit is contained in:
Maurice
2026-11-17 23:28:01 +01:00
parent 6040b60e86
commit bc6728678b
10 changed files with 655 additions and 97 deletions
@@ -1,14 +1,16 @@
/**
* MOVEVAL-001..010: how a SQLite value becomes the value a Postgres column of
* the move's target takes, the text both sides are compared in, and the
* order-free table checksum (src/db/engine/postgres/sqlite-move/values.ts).
* MOVEVAL-001..014: how a SQLite value becomes the value a Postgres column of
* the move's target takes, under TREK's rules and under a plugin's, the text
* both sides are compared in, and the order-free table checksum
* (src/db/engine/postgres/sqlite-move/values.ts).
*/
import {
beyondSafeInteger,
canonicalFromPostgres,
canonicalFromSent,
canonicalFromSource,
columnKind,
convertValue,
PLUGIN_RULES,
stableJson,
TableChecksum,
type ColumnKind,
@@ -19,6 +21,7 @@ import path from 'node:path';
import { describe, expect, it } from 'vitest';
const ok = (value: unknown) => ({ ok: true, value });
const DROP_NUL = { exact: false, dropNul: true };
describe('columnKind', () => {
it('MOVEVAL-001: knows every column type the Postgres baseline uses', () => {
@@ -80,11 +83,15 @@ describe('convertValue', () => {
expect(convertValue('', 'float')).toMatchObject({ ok: false });
});
it('MOVEVAL-005: text takes strings and numbers, drops a NUL as every write does, and refuses a BLOB', () => {
it('MOVEVAL-005: text takes strings and numbers, refuses a NUL unless told to drop it, and refuses a BLOB', () => {
expect(convertValue('Lisboa', 'text')).toEqual(ok('Lisboa'));
expect(convertValue(7n, 'text')).toEqual(ok('7'));
expect(convertValue(2.5, 'text')).toEqual(ok('2.5'));
expect(convertValue('a\u0000b\u0000', 'text')).toEqual(ok('ab'));
expect(convertValue('a\u0000b\u0000', 'text')).toEqual({
ok: false,
reason: 'the text "a\\u0000b\\u0000" holds a NUL character (U+0000), which Postgres text cannot hold',
});
expect(convertValue('a\u0000b\u0000', 'text', DROP_NUL)).toEqual({ ok: true, value: 'ab', droppedNul: true });
// The six characters of an escape are text like any other.
expect(convertValue('a\\u0000b', 'text')).toEqual(ok('a\\u0000b'));
expect(convertValue(new Uint8Array([0]), 'text')).toMatchObject({
@@ -97,15 +104,25 @@ describe('convertValue', () => {
});
});
it('MOVEVAL-006: JSON must parse, and loses the NUL characters it escapes', () => {
it('MOVEVAL-006: JSON must parse, and loses the NUL characters it escapes only when told to', () => {
expect(convertValue('{"a":1}', 'json')).toEqual(ok('{"a":1}'));
expect(convertValue(5n, 'json')).toEqual(ok('5'));
expect(convertValue('{broken', 'json')).toMatchObject({
ok: false,
reason: expect.stringMatching(/is not valid JSON/),
});
expect(convertValue('"\\u0000"', 'json')).toEqual(ok('""'));
expect(convertValue('{"a\\u0000":["x\\u0000y",1]}', 'json')).toEqual(ok('{"a":["xy",1]}'));
expect(convertValue('"\\u0000"', 'json')).toMatchObject({
ok: false,
reason: expect.stringMatching(/holds a NUL character \(U\+0000\), .* \(escaped as \\u0000\)$/),
});
expect(convertValue('"\\u0000"', 'json', DROP_NUL)).toEqual({ ok: true, value: '""', droppedNul: true });
expect(convertValue('{"a\\u0000":["x\\u0000y",1]}', 'json', DROP_NUL)).toEqual({
ok: true,
value: '{"a":["xy",1]}',
droppedNul: true,
});
// An escaped backslash followed by u0000 holds no NUL, and stays exactly as it is.
expect(convertValue('"\\\\u0000"', 'json', DROP_NUL)).toEqual(ok('"\\\\u0000"'));
// A raw NUL is not valid JSON in the first place.
expect(convertValue('"\u0000"', 'json')).toMatchObject({ ok: false, reason: expect.stringMatching(/valid JSON/) });
expect(convertValue(new Uint8Array([1]), 'json')).toMatchObject({
@@ -130,24 +147,33 @@ describe('convertValue', () => {
});
describe('the compared text', () => {
const cases: Array<[ColumnKind, Parameters<typeof canonicalFromSent>[0], string]> = [
['integer', '-12', '-12'],
const cases: Array<[ColumnKind, Parameters<typeof canonicalFromSource>[0], string]> = [
['integer', ' -12 ', '-12'],
['integer', 9007199254740993n, '9007199254740993'],
['integer', 42, '42'],
['float', 0.30000000000000004, '0.30000000000000004'],
['float', 1e21, '1e+21'],
['float', 12n, '12'],
['float', '3.5e2', '350'],
['text', 'São Paulo', 'São Paulo'],
['text', 7n, '7'],
['json', '{"b":1,"a":[2,{"d":1,"c":0}]}', '{"a": [2, {"c": 0, "d": 1}], "b": 1}'],
['bytes', Buffer.from([0, 171]), '\\x00ab'],
['json', 5n, '5'],
['bytes', new Uint8Array([0, 171]), '\\x00ab'],
];
it.each(cases)('MOVEVAL-009: %s values compare equal as sent and as Postgres prints them', (kind, sent, printed) => {
expect(canonicalFromSent(sent, kind)).toBe(canonicalFromPostgres(printed, kind));
expect(canonicalFromSent(null, kind)).toBeNull();
expect(canonicalFromPostgres(null, kind)).toBeNull();
});
it.each(cases)(
'MOVEVAL-009: %s values compare equal as read from SQLite and as Postgres prints them',
(kind, read, printed) => {
expect(canonicalFromSource(read, kind)).toBe(canonicalFromPostgres(printed, kind));
expect(canonicalFromSource(null, kind)).toBeNull();
expect(canonicalFromPostgres(null, kind)).toBeNull();
},
);
it('MOVEVAL-009b: text sent for a BLOB compares as its bytes, and a float as Postgres spells it', () => {
expect(canonicalFromSent('ab', 'bytes')).toBe('6162');
expect(canonicalFromPostgres('1e+20', 'float')).toBe(canonicalFromSent(1e20, 'float'));
it('MOVEVAL-009b: text read for a BLOB compares as its bytes, and a float as Postgres spells it', () => {
expect(canonicalFromSource('ab', 'bytes')).toBe('6162');
expect(canonicalFromPostgres('1e+20', 'float')).toBe(canonicalFromSource(1e20, 'float'));
expect(canonicalFromPostgres('plain', 'bytes')).toBe('plain');
expect(stableJson('{"z":null,"y":true}')).toBe('{"y":true,"z":null}');
});
@@ -176,3 +202,63 @@ describe('the compared text', () => {
expect(sum([['null']])).not.toBe(sum([[null]]));
});
});
describe("a plugin's values (PLUGIN_RULES)", () => {
const exact = (value: Parameters<typeof convertValue>[0], kind: ColumnKind) =>
convertValue(value, kind, PLUGIN_RULES);
const changed =
/is stored as .*, but the column holds .* on Postgres, so the plugin would read it back as another type/;
it('MOVEVAL-011: a value keeps its storage class and its bytes, as the Postgres plugin store hands it back', () => {
expect(exact(42n, 'integer')).toEqual(ok('42'));
expect(exact(1.5, 'float')).toEqual(ok(1.5));
expect(exact(3n, 'float')).toEqual(ok(3));
expect(exact('{"a":1}', 'text')).toEqual(ok('{"a":1}'));
expect(exact(new Uint8Array([0, 1]), 'bytes')).toEqual(ok(Buffer.from([0, 1])));
expect(exact(null, 'text')).toEqual(ok(null));
});
it('MOVEVAL-012: a value that would come back as another type is refused, not converted', () => {
expect(exact(1.5, 'text')).toEqual({
ok: false,
reason:
'the value 1.5 is stored as a REAL, but the column holds text on Postgres, ' +
'so the plugin would read it back as another type',
});
expect(exact(5n, 'text')).toMatchObject({ ok: false, reason: expect.stringMatching(changed) });
expect(exact('{"a":1}', 'bytes')).toMatchObject({ ok: false, reason: expect.stringMatching(changed) });
expect(exact(' 7', 'integer')).toMatchObject({ ok: false, reason: expect.stringMatching(changed) });
expect(exact(2.5, 'integer')).toMatchObject({ ok: false, reason: expect.stringMatching(changed) });
expect(exact('2.5', 'float')).toMatchObject({ ok: false, reason: expect.stringMatching(changed) });
expect(exact(new Uint8Array([1]), 'text')).toMatchObject({ ok: false, reason: expect.stringMatching(changed) });
expect(exact(9007199254740993n, 'integer')).toMatchObject({
ok: false,
reason: expect.stringMatching(/beyond 2\^53, which the Postgres plugin store refuses to read/),
});
expect(exact(-9007199254740993n, 'float')).toMatchObject({
ok: false,
reason: expect.stringMatching(/more digits than a double holds/),
});
});
it('MOVEVAL-013: a NUL in a plugin value is refused, never dropped, whatever the operator asked for', () => {
expect(exact('team\u0000a', 'text')).toEqual({
ok: false,
reason: 'the text "team\\u0000a" holds a NUL character (U+0000), which Postgres text cannot hold',
});
expect(convertValue('team\u0000a', 'text', { exact: true, dropNul: true })).toMatchObject({ ok: false });
});
it('MOVEVAL-014: the compared text comes from the SQLite value, so a value that changed on the way does not match', () => {
// What Postgres would print had the NUL been dropped, or the type changed, on the way.
expect(canonicalFromSource('team\u0000a', 'text', PLUGIN_RULES)).not.toBe(canonicalFromPostgres('teama', 'text'));
expect(canonicalFromSource('team\u0000a', 'text', { exact: true, dropNul: true })).not.toBe('teama');
expect(canonicalFromSource(new Uint8Array([0x61]), 'text', PLUGIN_RULES)).not.toBe(
canonicalFromPostgres('a', 'text'),
);
expect(canonicalFromSource(5n, 'bytes')).not.toBe(canonicalFromPostgres('\\x35', 'bytes'));
// The one change allowed is the one the operator asked for on TREK's own data.
expect(canonicalFromSource('team\u0000a', 'text', DROP_NUL)).toBe(canonicalFromPostgres('teama', 'text'));
expect(canonicalFromSource('{"k\\u0000":1}', 'json', DROP_NUL)).toBe(canonicalFromPostgres('{"k": 1}', 'json'));
});
});