From fbf40fb8f528f003fa535fadc908b6799abaac8f Mon Sep 17 00:00:00 2001 From: Andras Schmelczer Date: Tue, 22 Sep 2026 20:41:56 +0100 Subject: [PATCH] Add comments --- .../database/migrations/20241207143519_bootstrap.sql | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/sync-server/src/app_state/database/migrations/20241207143519_bootstrap.sql b/sync-server/src/app_state/database/migrations/20241207143519_bootstrap.sql index 847ce041..f243d1e0 100644 --- a/sync-server/src/app_state/database/migrations/20241207143519_bootstrap.sql +++ b/sync-server/src/app_state/database/migrations/20241207143519_bootstrap.sql @@ -1,7 +1,17 @@ CREATE TABLE events ( + -- Numeric position in the vault's history: orders events, serves as + -- vault_update_id/file_manifest_id, parent IDs, and page cursors event_id INTEGER PRIMARY KEY AUTOINCREMENT CHECK(event_id <= 9007199254740991), -- JavaScript’s Number.MAX_SAFE_INTEGER + -- Server-minted random identity of this event's incarnation, minted once + -- per INSERT. Unlike request_id it is never reproduced by a resubmitted + -- request, so the history checkpoint `event_id:event_token` fails whenever + -- a restored backup reuses a numeric ID or a client resubmits the same + -- request UUID against a different history event_token TEXT, + -- Client-chosen idempotency key, stable across retries so the server can + -- deduplicate a replayed request request_id TEXT NOT NULL UNIQUE, + -- Hash of the request payload that carried this event request_fingerprint BLOB NOT NULL );